@kosdev-code/kos-api-levels 0.1.0-dev.5797

package/deprecation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Emits a one-time console warning in non-production environments when a
+ * deprecated API is used.
+ *
+ * @param apiName - The name of the deprecated API (e.g. `@kosSubscribe`)
+ * @param serviceId - The service the API belongs to (e.g. `core.subscribe`)
+ * @param deprecatedAtLevel - The API level at which this API was deprecated
+ * @param replacement - The recommended replacement (e.g. `@kosTopicHandler`)
+ * @param removeAtLevel - The API level at which this API will be removed
+ */
+export declare function warnDeprecated(apiName: string, serviceId: string, deprecatedAtLevel: number, replacement: string, removeAtLevel: number): void;
+//# sourceMappingURL=deprecation.d.ts.map

package/deprecation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../../../packages/sdk/kos-api-levels/src/deprecation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,IAAI,CAUN"}

package/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=new Set;function d(e,t,n,i,l){typeof process<"u"&&process.env.NODE_ENV==="production"||c.has(e)||(c.add(e),console.warn(`[KOS] "${e}" is deprecated since ${t} level ${n}. Use "${i}" instead. Will be removed at level ${l}.`))}const u={};function p(e){Object.assign(u,e)}function a(){return u}function r(e){return a()[e]??0}function g(e,t){return r(e)>=t}function v(e,t){const n=r(e);if(n<t){const i=n===0?"not registered":String(n);throw new Error(`[KOS] API level requirement not met for "${e}": required ${t}, actual ${i}`)}}function f(){return a()}function L(e){const t={};let n=!0;for(const[i,l]of Object.entries(e)){if(l===void 0)continue;const o=r(i),s=o>=l;t[i]={required:l,actual:o,ok:s},s||(n=!1)}return{satisfied:n,details:t}}function k(e){const t=r("ddk.compat"),n=r("ddk.compat.min-plugin");if(e.pluginRequiresDdkLevel>t){const i=t===0?"not registered":String(t);return{ok:!1,reason:"too-new-plugin",message:`[KOS] Plugin requires DDK level ${e.pluginRequiresDdkLevel}, but host provides level ${i}.`}}return n>0&&e.pluginLevel<n?{ok:!1,reason:"too-old-plugin",message:`[KOS] Plugin level ${e.pluginLevel} is below the host's minimum accepted plugin level ${n}.`}:{ok:!0,reason:"ok"}}exports.checkApiLevels=L;exports.checkCompatibility=k;exports.getAllApiLevels=f;exports.getApiLevel=r;exports.hasApiLevel=g;exports.registerApiLevels=p;exports.requireApiLevel=v;exports.warnDeprecated=d;
+//# sourceMappingURL=index.cjs.map

package/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../../packages/sdk/kos-api-levels/src/deprecation.ts","../../../../packages/sdk/kos-api-levels/src/registry.ts","../../../../packages/sdk/kos-api-levels/src/runtime.ts"],"sourcesContent":["const _warned = new Set<string>();\n\n/**\n * Emits a one-time console warning in non-production environments when a\n * deprecated API is used.\n *\n * @param apiName - The name of the deprecated API (e.g. `@kosSubscribe`)\n * @param serviceId - The service the API belongs to (e.g. `core.subscribe`)\n * @param deprecatedAtLevel - The API level at which this API was deprecated\n * @param replacement - The recommended replacement (e.g. `@kosTopicHandler`)\n * @param removeAtLevel - The API level at which this API will be removed\n */\nexport function warnDeprecated(\n  apiName: string,\n  serviceId: string,\n  deprecatedAtLevel: number,\n  replacement: string,\n  removeAtLevel: number\n): void {\n  if (typeof process !== 'undefined' && process.env['NODE_ENV'] === 'production') {\n    return;\n  }\n  if (_warned.has(apiName)) return;\n  _warned.add(apiName);\n  console.warn(\n    `[KOS] \"${apiName}\" is deprecated since ${serviceId} level ${deprecatedAtLevel}. ` +\n      `Use \"${replacement}\" instead. Will be removed at level ${removeAtLevel}.`\n  );\n}\n","import type { ApiLevelMap } from './types';\n\nconst _registry: ApiLevelMap = {};\n\n/**\n * Registers API levels for an SDK package. Each SDK package calls this on\n * import to populate the in-memory registry. Works in browser and Node.js.\n *\n * Phase 1: called manually from each package's index.ts.\n * Phase 2: generated automatically by the JSDoc scanner at build time.\n */\nexport function registerApiLevels(levels: ApiLevelMap): void {\n  Object.assign(_registry, levels);\n}\n\nexport function getRegistry(): Readonly<ApiLevelMap> {\n  return _registry;\n}\n","import type { ServiceId, ApiLevelMap, CheckResult, PluginCompatRequirements, CompatResult } from './types';\nimport { getRegistry } from './registry';\n\n/**\n * Returns the current API level for a service.\n * Returns 0 if the service has not been registered.\n */\nexport function getApiLevel(service: ServiceId): number {\n  return getRegistry()[service] ?? 0;\n}\n\n/**\n * Returns true if the registered level for a service meets the minimum requirement.\n */\nexport function hasApiLevel(service: ServiceId, minLevel: number): boolean {\n  return getApiLevel(service) >= minLevel;\n}\n\n/**\n * Throws if the registered level for a service does not meet the minimum requirement.\n */\nexport function requireApiLevel(service: ServiceId, minLevel: number): void {\n  const actual = getApiLevel(service);\n  if (actual < minLevel) {\n    const actualLabel = actual === 0 ? 'not registered' : String(actual);\n    throw new Error(\n      `[KOS] API level requirement not met for \"${service}\": required ${minLevel}, actual ${actualLabel}`\n    );\n  }\n}\n\n/**\n * Returns all registered API levels. Useful for diagnostics and logging.\n */\nexport function getAllApiLevels(): Readonly<ApiLevelMap> {\n  return getRegistry();\n}\n\n/**\n * Checks multiple service requirements in a single call.\n */\nexport function checkApiLevels(requirements: Partial<ApiLevelMap>): CheckResult {\n  const details: CheckResult['details'] = {};\n  let satisfied = true;\n\n  for (const [service, required] of Object.entries(requirements)) {\n    if (required === undefined) continue;\n    const actual = getApiLevel(service);\n    const ok = actual >= required;\n    details[service] = { required, actual, ok };\n    if (!ok) satisfied = false;\n  }\n\n  return { satisfied, details };\n}\n\n/**\n * Checks whether a DDK plugin is compatible with the current DDK host.\n *\n * The DDK host registers two services at startup:\n * - `ddk.compat`            — the current DDK API level (what it provides)\n * - `ddk.compat.min-plugin` — the oldest plugin level this host still accepts\n *\n * A plugin passes its own requirements:\n * - `pluginRequiresDdkLevel` — minimum DDK level the plugin needs\n * - `pluginLevel`            — the API level of the plugin itself\n *\n * Both directions are checked:\n * - Plugin too new for host: `pluginRequiresDdkLevel > ddk.compat`\n * - Plugin too old for host: `pluginLevel < ddk.compat.min-plugin`\n */\nexport function checkCompatibility(requirements: PluginCompatRequirements): CompatResult {\n  const ddkLevel = getApiLevel('ddk.compat');\n  const minPluginLevel = getApiLevel('ddk.compat.min-plugin');\n\n  if (requirements.pluginRequiresDdkLevel > ddkLevel) {\n    const ddkLabel = ddkLevel === 0 ? 'not registered' : String(ddkLevel);\n    return {\n      ok: false,\n      reason: 'too-new-plugin',\n      message:\n        `[KOS] Plugin requires DDK level ${requirements.pluginRequiresDdkLevel}, ` +\n        `but host provides level ${ddkLabel}.`,\n    };\n  }\n\n  if (minPluginLevel > 0 && requirements.pluginLevel < minPluginLevel) {\n    return {\n      ok: false,\n      reason: 'too-old-plugin',\n      message:\n        `[KOS] Plugin level ${requirements.pluginLevel} is below the host's minimum ` +\n        `accepted plugin level ${minPluginLevel}.`,\n    };\n  }\n\n  return { ok: true, reason: 'ok' };\n}\n"],"names":["_warned","warnDeprecated","apiName","serviceId","deprecatedAtLevel","replacement","removeAtLevel","_registry","registerApiLevels","levels","getRegistry","getApiLevel","service","hasApiLevel","minLevel","requireApiLevel","actual","actualLabel","getAllApiLevels","checkApiLevels","requirements","details","satisfied","required","ok","checkCompatibility","ddkLevel","minPluginLevel","ddkLabel"],"mappings":"gFAAA,MAAMA,MAAc,IAYb,SAASC,EACdC,EACAC,EACAC,EACAC,EACAC,EACM,CACF,OAAO,QAAY,KAAe,QAAQ,IAAI,WAAgB,cAG9DN,EAAQ,IAAIE,CAAO,IACvBF,EAAQ,IAAIE,CAAO,EACnB,QAAQ,KACN,UAAUA,CAAO,yBAAyBC,CAAS,UAAUC,CAAiB,UACpEC,CAAW,uCAAuCC,CAAa,GAAA,EAE7E,CC1BA,MAAMC,EAAyB,CAAA,EASxB,SAASC,EAAkBC,EAA2B,CAC3D,OAAO,OAAOF,EAAWE,CAAM,CACjC,CAEO,SAASC,GAAqC,CACnD,OAAOH,CACT,CCVO,SAASI,EAAYC,EAA4B,CACtD,OAAOF,EAAA,EAAcE,CAAO,GAAK,CACnC,CAKO,SAASC,EAAYD,EAAoBE,EAA2B,CACzE,OAAOH,EAAYC,CAAO,GAAKE,CACjC,CAKO,SAASC,EAAgBH,EAAoBE,EAAwB,CAC1E,MAAME,EAASL,EAAYC,CAAO,EAClC,GAAII,EAASF,EAAU,CACrB,MAAMG,EAAcD,IAAW,EAAI,iBAAmB,OAAOA,CAAM,EACnE,MAAM,IAAI,MACR,4CAA4CJ,CAAO,eAAeE,CAAQ,YAAYG,CAAW,EAAA,CAErG,CACF,CAKO,SAASC,GAAyC,CACvD,OAAOR,EAAA,CACT,CAKO,SAASS,EAAeC,EAAiD,CAC9E,MAAMC,EAAkC,CAAA,EACxC,IAAIC,EAAY,GAEhB,SAAW,CAACV,EAASW,CAAQ,IAAK,OAAO,QAAQH,CAAY,EAAG,CAC9D,GAAIG,IAAa,OAAW,SAC5B,MAAMP,EAASL,EAAYC,CAAO,EAC5BY,EAAKR,GAAUO,EACrBF,EAAQT,CAAO,EAAI,CAAE,SAAAW,EAAU,OAAAP,EAAQ,GAAAQ,CAAA,EAClCA,IAAIF,EAAY,GACvB,CAEA,MAAO,CAAE,UAAAA,EAAW,QAAAD,CAAA,CACtB,CAiBO,SAASI,EAAmBL,EAAsD,CACvF,MAAMM,EAAWf,EAAY,YAAY,EACnCgB,EAAiBhB,EAAY,uBAAuB,EAE1D,GAAIS,EAAa,uBAAyBM,EAAU,CAClD,MAAME,EAAWF,IAAa,EAAI,iBAAmB,OAAOA,CAAQ,EACpE,MAAO,CACL,GAAI,GACJ,OAAQ,iBACR,QACE,mCAAmCN,EAAa,sBAAsB,6BAC3CQ,CAAQ,GAAA,CAEzC,CAEA,OAAID,EAAiB,GAAKP,EAAa,YAAcO,EAC5C,CACL,GAAI,GACJ,OAAQ,iBACR,QACE,sBAAsBP,EAAa,WAAW,sDACrBO,CAAc,GAAA,EAItC,CAAE,GAAI,GAAM,OAAQ,IAAA,CAC7B"}

package/index.d.ts

@@ -0,0 +1,5 @@
+export { warnDeprecated } from './deprecation';
+export { registerApiLevels } from './registry';
+export { checkApiLevels, checkCompatibility, getAllApiLevels, getApiLevel, hasApiLevel, requireApiLevel, } from './runtime';
+export type { ApiLevelMap, CheckResult, CompatResult, CompatReason, PluginCompatRequirements, ServiceId, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/sdk/kos-api-levels/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,SAAS,GACV,MAAM,SAAS,CAAC"}

package/index.js

@@ -0,0 +1,69 @@
+const u = /* @__PURE__ */ new Set();
+function d(e, n, t, i, r) {
+  typeof process < "u" && process.env.NODE_ENV === "production" || u.has(e) || (u.add(e), console.warn(
+    `[KOS] "${e}" is deprecated since ${n} level ${t}. Use "${i}" instead. Will be removed at level ${r}.`
+  ));
+}
+const c = {};
+function f(e) {
+  Object.assign(c, e);
+}
+function a() {
+  return c;
+}
+function o(e) {
+  return a()[e] ?? 0;
+}
+function g(e, n) {
+  return o(e) >= n;
+}
+function p(e, n) {
+  const t = o(e);
+  if (t < n) {
+    const i = t === 0 ? "not registered" : String(t);
+    throw new Error(
+      `[KOS] API level requirement not met for "${e}": required ${n}, actual ${i}`
+    );
+  }
+}
+function v() {
+  return a();
+}
+function k(e) {
+  const n = {};
+  let t = !0;
+  for (const [i, r] of Object.entries(e)) {
+    if (r === void 0)
+      continue;
+    const l = o(i), s = l >= r;
+    n[i] = { required: r, actual: l, ok: s }, s || (t = !1);
+  }
+  return { satisfied: t, details: n };
+}
+function L(e) {
+  const n = o("ddk.compat"), t = o("ddk.compat.min-plugin");
+  if (e.pluginRequiresDdkLevel > n) {
+    const i = n === 0 ? "not registered" : String(n);
+    return {
+      ok: !1,
+      reason: "too-new-plugin",
+      message: `[KOS] Plugin requires DDK level ${e.pluginRequiresDdkLevel}, but host provides level ${i}.`
+    };
+  }
+  return t > 0 && e.pluginLevel < t ? {
+    ok: !1,
+    reason: "too-old-plugin",
+    message: `[KOS] Plugin level ${e.pluginLevel} is below the host's minimum accepted plugin level ${t}.`
+  } : { ok: !0, reason: "ok" };
+}
+export {
+  k as checkApiLevels,
+  L as checkCompatibility,
+  v as getAllApiLevels,
+  o as getApiLevel,
+  g as hasApiLevel,
+  f as registerApiLevels,
+  p as requireApiLevel,
+  d as warnDeprecated
+};
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../packages/sdk/kos-api-levels/src/deprecation.ts","../../../../packages/sdk/kos-api-levels/src/registry.ts","../../../../packages/sdk/kos-api-levels/src/runtime.ts"],"sourcesContent":["const _warned = new Set<string>();\n\n/**\n * Emits a one-time console warning in non-production environments when a\n * deprecated API is used.\n *\n * @param apiName - The name of the deprecated API (e.g. `@kosSubscribe`)\n * @param serviceId - The service the API belongs to (e.g. `core.subscribe`)\n * @param deprecatedAtLevel - The API level at which this API was deprecated\n * @param replacement - The recommended replacement (e.g. `@kosTopicHandler`)\n * @param removeAtLevel - The API level at which this API will be removed\n */\nexport function warnDeprecated(\n  apiName: string,\n  serviceId: string,\n  deprecatedAtLevel: number,\n  replacement: string,\n  removeAtLevel: number\n): void {\n  if (typeof process !== 'undefined' && process.env['NODE_ENV'] === 'production') {\n    return;\n  }\n  if (_warned.has(apiName)) return;\n  _warned.add(apiName);\n  console.warn(\n    `[KOS] \"${apiName}\" is deprecated since ${serviceId} level ${deprecatedAtLevel}. ` +\n      `Use \"${replacement}\" instead. Will be removed at level ${removeAtLevel}.`\n  );\n}\n","import type { ApiLevelMap } from './types';\n\nconst _registry: ApiLevelMap = {};\n\n/**\n * Registers API levels for an SDK package. Each SDK package calls this on\n * import to populate the in-memory registry. Works in browser and Node.js.\n *\n * Phase 1: called manually from each package's index.ts.\n * Phase 2: generated automatically by the JSDoc scanner at build time.\n */\nexport function registerApiLevels(levels: ApiLevelMap): void {\n  Object.assign(_registry, levels);\n}\n\nexport function getRegistry(): Readonly<ApiLevelMap> {\n  return _registry;\n}\n","import type { ServiceId, ApiLevelMap, CheckResult, PluginCompatRequirements, CompatResult } from './types';\nimport { getRegistry } from './registry';\n\n/**\n * Returns the current API level for a service.\n * Returns 0 if the service has not been registered.\n */\nexport function getApiLevel(service: ServiceId): number {\n  return getRegistry()[service] ?? 0;\n}\n\n/**\n * Returns true if the registered level for a service meets the minimum requirement.\n */\nexport function hasApiLevel(service: ServiceId, minLevel: number): boolean {\n  return getApiLevel(service) >= minLevel;\n}\n\n/**\n * Throws if the registered level for a service does not meet the minimum requirement.\n */\nexport function requireApiLevel(service: ServiceId, minLevel: number): void {\n  const actual = getApiLevel(service);\n  if (actual < minLevel) {\n    const actualLabel = actual === 0 ? 'not registered' : String(actual);\n    throw new Error(\n      `[KOS] API level requirement not met for \"${service}\": required ${minLevel}, actual ${actualLabel}`\n    );\n  }\n}\n\n/**\n * Returns all registered API levels. Useful for diagnostics and logging.\n */\nexport function getAllApiLevels(): Readonly<ApiLevelMap> {\n  return getRegistry();\n}\n\n/**\n * Checks multiple service requirements in a single call.\n */\nexport function checkApiLevels(requirements: Partial<ApiLevelMap>): CheckResult {\n  const details: CheckResult['details'] = {};\n  let satisfied = true;\n\n  for (const [service, required] of Object.entries(requirements)) {\n    if (required === undefined) continue;\n    const actual = getApiLevel(service);\n    const ok = actual >= required;\n    details[service] = { required, actual, ok };\n    if (!ok) satisfied = false;\n  }\n\n  return { satisfied, details };\n}\n\n/**\n * Checks whether a DDK plugin is compatible with the current DDK host.\n *\n * The DDK host registers two services at startup:\n * - `ddk.compat`            — the current DDK API level (what it provides)\n * - `ddk.compat.min-plugin` — the oldest plugin level this host still accepts\n *\n * A plugin passes its own requirements:\n * - `pluginRequiresDdkLevel` — minimum DDK level the plugin needs\n * - `pluginLevel`            — the API level of the plugin itself\n *\n * Both directions are checked:\n * - Plugin too new for host: `pluginRequiresDdkLevel > ddk.compat`\n * - Plugin too old for host: `pluginLevel < ddk.compat.min-plugin`\n */\nexport function checkCompatibility(requirements: PluginCompatRequirements): CompatResult {\n  const ddkLevel = getApiLevel('ddk.compat');\n  const minPluginLevel = getApiLevel('ddk.compat.min-plugin');\n\n  if (requirements.pluginRequiresDdkLevel > ddkLevel) {\n    const ddkLabel = ddkLevel === 0 ? 'not registered' : String(ddkLevel);\n    return {\n      ok: false,\n      reason: 'too-new-plugin',\n      message:\n        `[KOS] Plugin requires DDK level ${requirements.pluginRequiresDdkLevel}, ` +\n        `but host provides level ${ddkLabel}.`,\n    };\n  }\n\n  if (minPluginLevel > 0 && requirements.pluginLevel < minPluginLevel) {\n    return {\n      ok: false,\n      reason: 'too-old-plugin',\n      message:\n        `[KOS] Plugin level ${requirements.pluginLevel} is below the host's minimum ` +\n        `accepted plugin level ${minPluginLevel}.`,\n    };\n  }\n\n  return { ok: true, reason: 'ok' };\n}\n"],"names":["_warned","warnDeprecated","apiName","serviceId","deprecatedAtLevel","replacement","removeAtLevel","_registry","registerApiLevels","levels","getRegistry","getApiLevel","service","hasApiLevel","minLevel","requireApiLevel","actual","actualLabel","getAllApiLevels","checkApiLevels","requirements","details","satisfied","required","ok","checkCompatibility","ddkLevel","minPluginLevel","ddkLabel"],"mappings":"AAAA,MAAMA,wBAAc,IAAA;AAYb,SAASC,EACdC,GACAC,GACAC,GACAC,GACAC,GACM;AACN,EAAI,OAAO,UAAY,OAAe,QAAQ,IAAI,aAAgB,gBAG9DN,EAAQ,IAAIE,CAAO,MACvBF,EAAQ,IAAIE,CAAO,GACnB,QAAQ;AAAA,IACN,UAAUA,CAAO,yBAAyBC,CAAS,UAAUC,CAAiB,UACpEC,CAAW,uCAAuCC,CAAa;AAAA,EAAA;AAE7E;AC1BA,MAAMC,IAAyB,CAAA;AASxB,SAASC,EAAkBC,GAA2B;AAC3D,SAAO,OAAOF,GAAWE,CAAM;AACjC;AAEO,SAASC,IAAqC;AACnD,SAAOH;AACT;ACVO,SAASI,EAAYC,GAA4B;AACtD,SAAOF,EAAA,EAAcE,CAAO,KAAK;AACnC;AAKO,SAASC,EAAYD,GAAoBE,GAA2B;AACzE,SAAOH,EAAYC,CAAO,KAAKE;AACjC;AAKO,SAASC,EAAgBH,GAAoBE,GAAwB;AAC1E,QAAME,IAASL,EAAYC,CAAO;AAClC,MAAII,IAASF,GAAU;AACrB,UAAMG,IAAcD,MAAW,IAAI,mBAAmB,OAAOA,CAAM;AACnE,UAAM,IAAI;AAAA,MACR,4CAA4CJ,CAAO,eAAeE,CAAQ,YAAYG,CAAW;AAAA,IAAA;AAAA,EAErG;AACF;AAKO,SAASC,IAAyC;AACvD,SAAOR,EAAA;AACT;AAKO,SAASS,EAAeC,GAAiD;AAC9E,QAAMC,IAAkC,CAAA;AACxC,MAAIC,IAAY;AAEhB,aAAW,CAACV,GAASW,CAAQ,KAAK,OAAO,QAAQH,CAAY,GAAG;AAC9D,QAAIG,MAAa;AAAW;AAC5B,UAAMP,IAASL,EAAYC,CAAO,GAC5BY,IAAKR,KAAUO;AACrB,IAAAF,EAAQT,CAAO,IAAI,EAAE,UAAAW,GAAU,QAAAP,GAAQ,IAAAQ,EAAA,GAClCA,MAAIF,IAAY;AAAA,EACvB;AAEA,SAAO,EAAE,WAAAA,GAAW,SAAAD,EAAA;AACtB;AAiBO,SAASI,EAAmBL,GAAsD;AACvF,QAAMM,IAAWf,EAAY,YAAY,GACnCgB,IAAiBhB,EAAY,uBAAuB;AAE1D,MAAIS,EAAa,yBAAyBM,GAAU;AAClD,UAAME,IAAWF,MAAa,IAAI,mBAAmB,OAAOA,CAAQ;AACpE,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,QAAQ;AAAA,MACR,SACE,mCAAmCN,EAAa,sBAAsB,6BAC3CQ,CAAQ;AAAA,IAAA;AAAA,EAEzC;AAEA,SAAID,IAAiB,KAAKP,EAAa,cAAcO,IAC5C;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,SACE,sBAAsBP,EAAa,WAAW,sDACrBO,CAAc;AAAA,EAAA,IAItC,EAAE,IAAI,IAAM,QAAQ,KAAA;AAC7B;"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@kosdev-code/kos-api-levels",
+  "version": "0.1.0-dev.5797",
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "require": {
+        "types": "./index.d.cts",
+        "default": "./index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "kos": {
+    "build": {
+      "gitHash": "bf103bc72ca8e841f32e61351ce311eb8be4a681"
+    }
+  }
+}

package/registry.d.ts

@@ -0,0 +1,12 @@
+import { ApiLevelMap } from './types';
+
+/**
+ * Registers API levels for an SDK package. Each SDK package calls this on
+ * import to populate the in-memory registry. Works in browser and Node.js.
+ *
+ * Phase 1: called manually from each package's index.ts.
+ * Phase 2: generated automatically by the JSDoc scanner at build time.
+ */
+export declare function registerApiLevels(levels: ApiLevelMap): void;
+export declare function getRegistry(): Readonly<ApiLevelMap>;
+//# sourceMappingURL=registry.d.ts.map

package/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../packages/sdk/kos-api-levels/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAE3D;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,CAEnD"}

package/runtime.d.ts

@@ -0,0 +1,40 @@
+import { ServiceId, ApiLevelMap, CheckResult, PluginCompatRequirements, CompatResult } from './types';
+
+/**
+ * Returns the current API level for a service.
+ * Returns 0 if the service has not been registered.
+ */
+export declare function getApiLevel(service: ServiceId): number;
+/**
+ * Returns true if the registered level for a service meets the minimum requirement.
+ */
+export declare function hasApiLevel(service: ServiceId, minLevel: number): boolean;
+/**
+ * Throws if the registered level for a service does not meet the minimum requirement.
+ */
+export declare function requireApiLevel(service: ServiceId, minLevel: number): void;
+/**
+ * Returns all registered API levels. Useful for diagnostics and logging.
+ */
+export declare function getAllApiLevels(): Readonly<ApiLevelMap>;
+/**
+ * Checks multiple service requirements in a single call.
+ */
+export declare function checkApiLevels(requirements: Partial<ApiLevelMap>): CheckResult;
+/**
+ * Checks whether a DDK plugin is compatible with the current DDK host.
+ *
+ * The DDK host registers two services at startup:
+ * - `ddk.compat`            — the current DDK API level (what it provides)
+ * - `ddk.compat.min-plugin` — the oldest plugin level this host still accepts
+ *
+ * A plugin passes its own requirements:
+ * - `pluginRequiresDdkLevel` — minimum DDK level the plugin needs
+ * - `pluginLevel`            — the API level of the plugin itself
+ *
+ * Both directions are checked:
+ * - Plugin too new for host: `pluginRequiresDdkLevel > ddk.compat`
+ * - Plugin too old for host: `pluginLevel < ddk.compat.min-plugin`
+ */
+export declare function checkCompatibility(requirements: PluginCompatRequirements): CompatResult;
+//# sourceMappingURL=runtime.d.ts.map

package/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../packages/sdk/kos-api-levels/src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG3G;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ1E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAAC,WAAW,CAAC,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAa9E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,wBAAwB,GAAG,YAAY,CA0BvF"}

package/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * An API level identifier string.
+ *
+ * For SDK packages this is the npm package name:
+ *   `kos-ui-sdk`, `kos-dispense-sdk`
+ *
+ * For DDK compatibility this is a well-known service ID:
+ *   `ddk.compat`, `ddk.compat.min-plugin`
+ *
+ * Per-service IDs (`core.topic-handler`, `dispense.nozzle`, etc.) exist in
+ * the scanner catalog (`generated/catalog.json`) for changelog and documentation
+ * purposes but are NOT registered at runtime.
+ */
+export type ServiceId = string;
+/**
+ * Map of service IDs to their current API level integers.
+ */
+export type ApiLevelMap = Record<ServiceId, number>;
+/**
+ * Result of a batch API level check.
+ */
+export interface CheckResult {
+    /** True if all requirements are satisfied. */
+    satisfied: boolean;
+    /** Per-service breakdown of required vs actual levels. */
+    details: Record<string, {
+        required: number;
+        actual: number;
+        ok: boolean;
+    }>;
+}
+/**
+ * Requirements declared by a plugin when entering a DDK host.
+ * The plugin states the DDK API level it was written against and its own plugin-level.
+ */
+export interface PluginCompatRequirements {
+    /**
+     * The DDK API level this plugin requires from the host.
+     * The host must satisfy: `ddk.compat >= pluginRequiresDdkLevel`.
+     */
+    pluginRequiresDdkLevel: number;
+    /**
+     * The API level of this plugin itself.
+     * The host must satisfy: `ddk.compat.min-plugin <= pluginLevel`.
+     */
+    pluginLevel: number;
+}
+/**
+ * Result of a DDK plugin/host compatibility check.
+ *
+ * - `ok` — plugin and host are compatible
+ * - `too-old-plugin` — this plugin is too old for the current DDK host
+ *   (host's minimum accepted plugin level is higher than the plugin's level)
+ * - `too-new-plugin` — this plugin requires a newer DDK than the host provides
+ */
+export type CompatReason = "ok" | "too-old-plugin" | "too-new-plugin";
+export interface CompatResult {
+    ok: boolean;
+    reason: CompatReason;
+    /**
+     * Human-readable description of the incompatibility, if any.
+     */
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/sdk/kos-api-levels/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}