@ham2k/extension-tools 0.11.0 → 0.13.0

package/h2kext.mjs

@@ -37,14 +37,29 @@ import yazl from "yazl"
 /// tuner, passband and antennas, the keying calls, what `readRadio` reports of
 /// them, and the scene's host-fed `radio` values; 8 adds the Developer
 /// panel's `target: 'developer'` settings and leaves a settings panel with
-/// nothing to show out of the Settings list.
-export const H2KEXT_API_VERSION = 8
+/// 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; 10 adds the DX cluster connection — the
+/// `requiresCluster*` grants, the `host.cluster*` calls and the `cluster`
+/// hook category.
+export const H2KEXT_API_VERSION = 10
 
 /// 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
 /// when it tried to connect.
 export const WEB_SOCKETS_API_VERSION = 2
 
+/// The first API that calls `chasing` hooks. A manifest promising one under an
+/// older api is refused: an older app would install it and ignore the
+/// program, and for an extension that does nothing else, install a bundle
+/// 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 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.
@@ -147,6 +162,8 @@ SHARED_MODULES_BY_API[5] = SHARED_MODULES_BY_API[4]
 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]
 
 /// 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
@@ -336,6 +353,18 @@ export function validateManifest(manifest, { source = MANIFEST_ENTRY, forceName
     }
   }
 
+  if (Array.isArray(manifest.hooks) && manifest.hooks.includes("chasing") && Number.isInteger(manifest.api) && manifest.api < CHASING_API_VERSION) {
+    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`,
+    )
+  }
+
   // 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.11.0",
+  "version": "0.13.0",
   "description": "Build and package extensions for the Ham2K Logger",
   "keywords": [
     "ham2k",