@ham2k/extension-tools 0.12.0 → 0.14.0

package/h2kext.mjs

@@ -39,8 +39,11 @@ import yazl from "yazl"
 /// panel's `target: 'developer'` settings and leaves a settings panel with
 /// nothing to show out of the Settings list; 9 hands `ctx.getQsos`'s QSOs
 /// frozen, from the one copy of the log every extension shares, and adds the
-/// `chasing` hook category.
-export const H2KEXT_API_VERSION = 9
+/// `chasing` hook category; 10 adds the DX cluster connection — the
+/// `requiresCluster*` grants, the `host.cluster*` calls and the `cluster`
+/// hook category; 11 adds `n1mm-history:` data-file urls, and
+/// `host.sendRadioRaw` with its `requiresRadioRaw` grant.
+export const H2KEXT_API_VERSION = 11
 
 /// The first API with `host.webSocket`. A manifest declaring `webSockets`
 /// under an older one is refused: an older app would install it and fail only
@@ -53,6 +56,16 @@ export const WEB_SOCKETS_API_VERSION = 2
 /// that silently does nothing.
 export const CHASING_API_VERSION = 9
 
+/// The first API with the DX cluster calls. A manifest declaring a
+/// `requiresCluster*` grant or a `cluster` hook under an older one is
+/// refused: an older app would install it and refuse every call it makes.
+export const CLUSTER_API_VERSION = 10
+
+/// The first API with `host.sendRadioRaw`. A manifest declaring
+/// `requiresRadioRaw` under an older one is refused: an older app would
+/// install it and refuse every raw command it sends.
+export const RADIO_RAW_API_VERSION = 11
+
 /// The first API with timers. The build points a bundle's bare `setTimeout`
 /// and friends at the SDK's only from here on: an older app's kernel hands an
 /// extension no timers, and a bundle declaring less says it runs there.
@@ -156,6 +169,8 @@ SHARED_MODULES_BY_API[6] = SHARED_MODULES_BY_API[5]
 SHARED_MODULES_BY_API[7] = SHARED_MODULES_BY_API[6]
 SHARED_MODULES_BY_API[8] = SHARED_MODULES_BY_API[7]
 SHARED_MODULES_BY_API[9] = SHARED_MODULES_BY_API[8]
+SHARED_MODULES_BY_API[10] = SHARED_MODULES_BY_API[9]
+SHARED_MODULES_BY_API[11] = SHARED_MODULES_BY_API[10]
 
 /// What a scaffolded extension declares on day one: the eight modules the SDK
 /// barrel itself reaches, so a project that has written no code yet still
@@ -349,6 +364,17 @@ export function validateManifest(manifest, { source = MANIFEST_ENTRY, forceName
     say(`'chasing' needs 'api' ${CHASING_API_VERSION} or later — an app older than that would install this and never ask it what a contact claims`)
   }
 
+  const clusterGrant = ["requiresClusterRead", "requiresClusterSpot", "requiresClusterCommand"].find((grant) => manifest[grant] === true)
+  const clusterHook = Array.isArray(manifest.hooks) && manifest.hooks.includes("cluster")
+  if ((clusterGrant || clusterHook) && Number.isInteger(manifest.api) && manifest.api < CLUSTER_API_VERSION) {
+    say(
+      `'${clusterGrant ?? "cluster"}' needs 'api' ${CLUSTER_API_VERSION} or later — an app older than that would install this and refuse every cluster call it makes`,
+    )
+  }
+  if (manifest.requiresRadioRaw === true && Number.isInteger(manifest.api) && manifest.api < RADIO_RAW_API_VERSION) {
+    say(`'requiresRadioRaw' needs 'api' ${RADIO_RAW_API_VERSION} or later — an app older than that would install this and refuse every raw command it sends`)
+  }
+
   // An extension with no category is CORE to the host: always enabled, and
   // never listed in the Extensions panel. That is a status the app grants its
   // own extensions, not one a distributed bundle may claim for itself — a user

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ham2k/extension-tools",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Build and package extensions for the Ham2K Logger",
   "keywords": [
     "ham2k",