2a:null 2b:["$","title",null,{"children":"Require Utilities | Maic López Sáenz | Observable"}] 30:T6d8,async function requireCheck(packageName, version = null) { let hasVersionParam = version !== null if (hasVersionParam) { // Convert to string, in case a number is provided version = '' + version } // First character is skipped in case of '@' for scoped packages let separatorIndex = packageName.indexOf('@', 1) let hasPackageNameVersion = separatorIndex >= 0 if (hasPackageNameVersion) { version = packageName.substring(separatorIndex+1) packageName = packageName.substring(0, separatorIndex) } let packageUrl = `https://registry.npmjs.org/${packageName}/latest` let metadata = await fetch(packageUrl).then(response => { if (response.ok) { return response.json() } return null }).catch(() => "errorCatched") let errorNote = null if (metadata === "errorCatched") { errorNote = 'Error fetching package data!' } else if (metadata === null) { errorNote = 'No package found!' } else if (metadata.version === undefined) { errorNote = 'No version found in metadata!' } else if (!hasVersionParam && !hasPackageNameVersion) { errorNote = 'No version provided!' } else if (hasVersionParam && hasPackageNameVersion) { errorNote = 'Ambiguous version provided!' } if (errorNote !== null) { return htl.html` require-check: 🛑 ${packageName} ${errorNote}` } let latestVersion = metadata.version let isUpToDate = latestVersion == version if (isUpToDate) { return htl.html`require-check: ✅ ${packageName}@${version}` } else { return htl.html` require-check: 🔶 ${packageName}@${version} Latest: ${latestVersion}` } }31:[] 2e:{"id":"5f873a68e0937bff","slug":"require-utilities","title":"Require Utilities","thumbnail":"5baf784ad6ed838be7cb5ab10c0ca198df95247ece8b13ce50ada8757c612197","access_level":"public","create_time":"$D2022-04-29T16:04:04.849Z","update_time":"$D2023-08-10T20:59:27.819Z","view_time":null,"first_public_time":"$D2022-04-29T16:41:44.488Z","fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"f15bd58f0c95f3c8","login":"lopsae","name":"Maic López Sáenz","avatar_url":"https://avatars-next.observableusercontent.com/0893731e3547c49619042dd456ec0027d4e8c2f1359fc3c07859cb1fc2eb1ea4","tier":"starter_2024"},"version":306,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"4770505bbf3a462a","login":"lopsae","name":"Maic López Sáenz","avatar_url":"https://avatars-next.observableusercontent.com/0893731e3547c49619042dd456ec0027d4e8c2f1359fc3c07859cb1fc2eb1ea4","tier":null}],"members":[{"type":"individual","id":"4770505bbf3a462a","login":"lopsae","name":"Maic López Sáenz","avatar_url":"https://avatars-next.observableusercontent.com/0893731e3547c49619042dd456ec0027d4e8c2f1359fc3c07859cb1fc2eb1ea4","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":true,"trashed":false,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"title":"Require Utilities","cells":[{"id":0,"value":"# Require Utilities\n\nUtilities to check the latest version available of a npm package.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":46,"value":"### Import\n${await makeImportStatement(['requireCheck'], true)}\n\nLatest pinned name: `${await getCurrentStableName()}`\n
\nVersion-pin: `${version}-(${await getCurrentStableVersion()})`","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":49,"value":"version = '1.1.2'\n// 1.1.2 (306) - Dependency updates, no functional changes\n// 1.1.1 (300) - Update to live notebook, dependency updates, no functional changes\n// 1.1.0 (285) - Errors display different emoji and more errors are handled\n// 1.0.0 (188) - First stable version\n// 0.9.0 (182) - For development","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":55,"value":"---\n### `requireCheck(packageName, version)`\n\nOutputs an `html` cell indicating if the given `version` is the latest available for the given npm `packageName`.\n\nThe package version can be provided through the `version` parameter, or within `packageName` in the usual `'package@version'` format.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":59,"value":"$30","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":67,"value":"### Examples","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":123,"value":"> With a `version` that matches the latest, a green check ✅ is displayed:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":203,"value":"requireCheck('ruler-and-compass@1.1.0')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":127,"value":"requireCheck('ruler-and-compass', '1.1.0')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":117,"value":"> With a `version` different that the latest, a warning 🔶 is displayed:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":120,"value":"requireCheck('ruler-and-compass@0.0.1')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":195,"value":"requireCheck('ruler-and-compass', '0.0.2')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":206,"value":"---\n### Error cases","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":98,"value":"> Without a `version` parameter and no version within `packageName`:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":101,"value":"requireCheck('ruler-and-compass')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":134,"value":"> With a `packageName` that does not exist, an error 🛑 is displayed:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":137,"value":"requireCheck('does-not-exist', '1')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":228,"value":"requireCheck('does-not-exist@2')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":230,"value":"> Providing both a `version` parameter and a version within `packageName`:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":225,"value":"requireCheck('ruler-and-compass@3', '4')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":245,"value":"> **TODO:** For an package that does not exist, Ambiviguous version error should take precedence:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":248,"value":"requireCheck('does-not-exist@3', '4')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":6,"value":"---\n### Colophon","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined"},{"id":15,"value":"styles","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":10,"value":"import {styles} from '@lopsae/styles@159'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":25,"value":"importCheck('@lopsae/styles@159')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":18,"value":"import {importCheck, makeImportStatement, getCurrentStableVersion, getCurrentStableName} from '@lopsae/import-utilities@552'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":22,"value":"importCheck('@lopsae/import-utilities', 552)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"}],"files":"$W31","stdlib":"1","titling":"auto"}} 2f:"$2e:body"