@soulcraft/sdk 3.1.0 → 3.2.0

package/dist/client/index.d.ts

@@ -32,6 +32,7 @@
  */
 export { createSoulcraftProxy } from './namespace-proxy.js';
 export type { NamespaceTransport } from './namespace-proxy.js';
+export { createVenueProxy } from '../venue/proxy.js';
 export { HttpNamespaceTransport, PostMessageNamespaceTransport, HttpRpcTransport, PostMessageRpcTransport, } from '../transports/http-namespace.js';
 export type { HttpNamespaceTransportOptions } from '../transports/http-namespace.js';
 export { WsTransport } from '../transports/ws.js';

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAGpF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAChG,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAC5F,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,WAAW,GACZ,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGpD,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAGpF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAChG,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAC5F,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,WAAW,GACZ,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/client/index.js

@@ -32,6 +32,8 @@
  */
 // ── Namespace proxy factory ─────────────────────────────────────────────────
 export { createSoulcraftProxy } from './namespace-proxy.js';
+// ── Venue proxy factory ────────────────────────────────────────────────────
+export { createVenueProxy } from '../venue/proxy.js';
 // ── Namespace-aware transports ──────────────────────────────────────────────
 export { HttpNamespaceTransport, PostMessageNamespaceTransport, HttpRpcTransport, PostMessageRpcTransport, } from '../transports/http-namespace.js';
 // ── Real-time transports ────────────────────────────────────────────────────

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,+EAA+E;AAC/E,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AAGxC,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAgChG,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,8EAA8E;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,+EAA+E;AAC/E,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AAGxC,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAgChG,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/modules/kits/index.d.ts

@@ -2,38 +2,69 @@
  * @module kits
  * @description Factory for sdk.kits.* — the Soulcraft kit registry module.
  *
- * Provides read-only access to kit configurations from the `@soulcraft/kits`
- * package. The package is an optional peer dependency loaded lazily via
- * `createRequire` so that the SDK compiles and runs without it installed;
- * calls gracefully return `null` / empty array when it is absent.
+ * Supports two operating modes:
  *
- * The factory accepts an optional `bundledRegistry` override (used in tests)
- * to inject a mock registry without needing the real package.
+ * **Registry mode** (recommended) — fetches kits from the Forge Kit Registry
+ * (`forge.soulcraft.com`) over HTTP. Archives (.sck) are downloaded, unpacked
+ * to a local disk cache, and served as local filesystem paths. ETag-based
+ * revalidation minimizes network traffic. Set `registryUrl` to enable.
  *
- * @example
+ * **Bundled mode** (legacy) — loads kits from the `@soulcraft/kits` npm
+ * package via `createRequire()`. This is the backwards-compatible default
+ * that products use today. Will be removed once all products migrate to
+ * registry mode.
+ *
+ * The factory returns the same `KitsModule` interface regardless of mode.
+ * Callers never need to know which backing store is active.
+ *
+ * @example Registry mode (production)
  * ```typescript
  * import { createKitsModule } from '@soulcraft/sdk/server'
  *
+ * const kits = createKitsModule({
+ *   registryUrl: process.env.FORGE_REGISTRY_URL,  // 'https://forge.soulcraft.com'
+ *   cachePath: '/home/app/.soulcraft/kits-cache',
+ * })
+ * const kit = await kits.load('wicks-and-whiskers')
+ * ```
+ *
+ * @example Bundled mode (legacy, no registryUrl)
+ * ```typescript
  * const kits = createKitsModule()
  * const kit = await kits.load('wicks-and-whiskers')
- * console.log(kit?.name) // "Wicks & Whiskers"
  * ```
  */
 import type { KitsModule, CreateKitsModuleOptions } from './types.js';
 /**
  * Create the `sdk.kits.*` module.
  *
- * @param options - Optional overrides, primarily for testing.
- * @returns A `KitsModule` backed by the `@soulcraft/kits` registry.
+ * The mode is determined by the options:
+ * - `bundledRegistry` set → static in-memory registry (for tests)
+ * - `registryUrl` set → HTTP-based registry mode (production)
+ * - Neither set → legacy bundled mode via `@soulcraft/kits` package
  *
- * @example
+ * @param options - Configuration for the kits module.
+ * @returns A `KitsModule` instance.
+ *
+ * @example Registry mode (production)
+ * ```typescript
+ * const kits = createKitsModule({
+ *   registryUrl: 'https://forge.soulcraft.com',
+ *   cachePath: '/home/app/.soulcraft/kits-cache',
+ * })
+ * ```
+ *
+ * @example Bundled mode (legacy — no options needed)
  * ```typescript
- * // In production:
  * const kits = createKitsModule()
+ * ```
  *
- * // In tests — inject a mock registry to avoid the peer dep:
+ * @example Test mode — inject mock kits
+ * ```typescript
  * const kits = createKitsModule({
- *   bundledRegistry: { 'test-kit': { id: 'test-kit', name: 'Test Kit', ... } }
+ *   bundledRegistry: {
+ *     'test-kit': { id: 'test-kit', name: 'Test Kit', version: '1.0.0', ... }
+ *   }
  * })
  * ```
  */

package/dist/modules/kits/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/kits/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAsB,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAgDzF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAoClF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/kits/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMH,OAAO,KAAK,EAEV,UAAU,EACV,uBAAuB,EAExB,MAAM,YAAY,CAAA;AA2YnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAoBlF"}

package/dist/modules/kits/index.js

@@ -2,31 +2,51 @@
  * @module kits
  * @description Factory for sdk.kits.* — the Soulcraft kit registry module.
  *
- * Provides read-only access to kit configurations from the `@soulcraft/kits`
- * package. The package is an optional peer dependency loaded lazily via
- * `createRequire` so that the SDK compiles and runs without it installed;
- * calls gracefully return `null` / empty array when it is absent.
+ * Supports two operating modes:
  *
- * The factory accepts an optional `bundledRegistry` override (used in tests)
- * to inject a mock registry without needing the real package.
+ * **Registry mode** (recommended) — fetches kits from the Forge Kit Registry
+ * (`forge.soulcraft.com`) over HTTP. Archives (.sck) are downloaded, unpacked
+ * to a local disk cache, and served as local filesystem paths. ETag-based
+ * revalidation minimizes network traffic. Set `registryUrl` to enable.
  *
- * @example
+ * **Bundled mode** (legacy) — loads kits from the `@soulcraft/kits` npm
+ * package via `createRequire()`. This is the backwards-compatible default
+ * that products use today. Will be removed once all products migrate to
+ * registry mode.
+ *
+ * The factory returns the same `KitsModule` interface regardless of mode.
+ * Callers never need to know which backing store is active.
+ *
+ * @example Registry mode (production)
  * ```typescript
  * import { createKitsModule } from '@soulcraft/sdk/server'
  *
+ * const kits = createKitsModule({
+ *   registryUrl: process.env.FORGE_REGISTRY_URL,  // 'https://forge.soulcraft.com'
+ *   cachePath: '/home/app/.soulcraft/kits-cache',
+ * })
+ * const kit = await kits.load('wicks-and-whiskers')
+ * ```
+ *
+ * @example Bundled mode (legacy, no registryUrl)
+ * ```typescript
  * const kits = createKitsModule()
  * const kit = await kits.load('wicks-and-whiskers')
- * console.log(kit?.name) // "Wicks & Whiskers"
  * ```
  */
 import { createRequire } from 'node:module';
-// createRequire enables CJS-style require() inside an ESM module — the only
-// reliable way to conditionally load optional peer dependencies in Node/Bun ESM.
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync, readdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+// ─────────────────────────────────────────────────────────────────────────────
+// Bundled mode — load from @soulcraft/kits npm package (legacy)
+// ─────────────────────────────────────────────────────────────────────────────
 const _require = createRequire(import.meta.url);
+/** Module-level cache — loaded once per process. */
 let _kitsPackage = undefined;
 /**
- * Lazily load the `@soulcraft/kits` optional peer dependency.
- * Returns `null` when the package is not installed; callers degrade gracefully.
+ * @description Lazily load the `@soulcraft/kits` optional peer dependency.
+ * Returns `null` when the package is not installed.
  */
 function _loadKitsPackage() {
     if (_kitsPackage !== undefined)
@@ -40,36 +60,20 @@ function _loadKitsPackage() {
     return _kitsPackage;
 }
 /**
- * Load the kit registry from the installed `@soulcraft/kits` package.
- * Returns `null` when the package is not installed.
+ * @description Get the bundled registry from the @soulcraft/kits package.
+ * @returns The kit registry, or null if the package is absent.
  */
 function _getBundledRegistry() {
     return _loadKitsPackage()?.kitRegistry ?? null;
 }
-// ─────────────────────────────────────────────────────────────────────────────
-// Factory
-// ─────────────────────────────────────────────────────────────────────────────
 /**
- * Create the `sdk.kits.*` module.
- *
- * @param options - Optional overrides, primarily for testing.
- * @returns A `KitsModule` backed by the `@soulcraft/kits` registry.
- *
- * @example
- * ```typescript
- * // In production:
- * const kits = createKitsModule()
+ * @description Create a KitsModule backed by the @soulcraft/kits npm package.
+ * This is the legacy mode, retained for backwards compatibility.
  *
- * // In tests — inject a mock registry to avoid the peer dep:
- * const kits = createKitsModule({
- *   bundledRegistry: { 'test-kit': { id: 'test-kit', name: 'Test Kit', ... } }
- * })
- * ```
+ * @param getRegistry - Function that returns the bundled registry (or null).
+ * @returns A KitsModule that reads from the installed npm package.
  */
-export function createKitsModule(options = {}) {
-    const getRegistry = options.bundledRegistry !== undefined
-        ? () => options.bundledRegistry ?? null
-        : _getBundledRegistry;
+function _createBundledKitsModule(getRegistry) {
     return {
         async load(kitId) {
             const registry = getRegistry();
@@ -103,4 +107,324 @@ export function createKitsModule(options = {}) {
         },
     };
 }
+// ─────────────────────────────────────────────────────────────────────────────
+// Registry mode — fetch from Forge Kit Registry over HTTP
+// ─────────────────────────────────────────────────────────────────────────────
+/** Default cache freshness: 5 minutes. */
+const DEFAULT_CACHE_TTL_MS = 300_000;
+/** Default local cache directory: ~/.soulcraft/kits-cache */
+const DEFAULT_CACHE_PATH = join(homedir(), '.soulcraft', 'kits-cache');
+/**
+ * @description Read the cache metadata file for a kit.
+ * @param cachePath - Root cache directory.
+ * @param kitId - Kit identifier.
+ * @returns Parsed CacheMeta, or null if missing or invalid.
+ */
+function _readCacheMeta(cachePath, kitId) {
+    const metaPath = join(cachePath, kitId, '_cache-meta.json');
+    if (!existsSync(metaPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(metaPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * @description Write cache metadata for a kit.
+ * @param cachePath - Root cache directory.
+ * @param kitId - Kit identifier.
+ * @param meta - Metadata to persist.
+ */
+function _writeCacheMeta(cachePath, kitId, meta) {
+    const metaPath = join(cachePath, kitId, '_cache-meta.json');
+    mkdirSync(join(cachePath, kitId), { recursive: true });
+    writeFileSync(metaPath, JSON.stringify(meta, null, 2));
+}
+/**
+ * @description Read a cached kit manifest from disk.
+ * @param cachePath - Root cache directory.
+ * @param kitId - Kit identifier.
+ * @returns Parsed manifest, or null if kit.json is missing.
+ */
+function _readCachedManifest(cachePath, kitId) {
+    const kitJsonPath = join(cachePath, kitId, 'kit.json');
+    if (!existsSync(kitJsonPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(kitJsonPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * @description Unpack a .sck (ZIP) archive buffer to a target directory.
+ *
+ * Uses dynamic import of `fflate` to avoid adding it as a hard SDK dependency.
+ * All Soulcraft products have fflate installed (Venue uses it for .sca archives,
+ * the registry uses it for .sck archives). If fflate is unavailable, the unpack
+ * fails with an actionable error message.
+ *
+ * @param buffer - The .sck archive as a Uint8Array.
+ * @param targetDir - Directory to extract into.
+ */
+async function _unpackArchive(buffer, targetDir) {
+    // Dynamic import avoids a hard dependency on fflate in the SDK package.json.
+    // The type assertion is safe because we only call unzipSync which is stable API.
+    let unzipSync;
+    try {
+        const fflate = await Function('return import("fflate")')();
+        unzipSync = fflate.unzipSync;
+    }
+    catch {
+        throw new Error('[sdk.kits] Cannot unpack .sck archive: fflate is not installed. ' +
+            'Run: bun add fflate (or npm install fflate)');
+    }
+    const files = unzipSync(buffer);
+    for (const [relPath, content] of Object.entries(files)) {
+        const fullPath = join(targetDir, relPath);
+        const dir = join(fullPath, '..');
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(fullPath, content);
+    }
+}
+/**
+ * @description Create a KitsModule backed by the Forge Kit Registry.
+ *
+ * Downloads .sck archives over HTTP, unpacks them to a local disk cache,
+ * and serves filesystem paths from the cache. Uses ETag-based revalidation
+ * to minimize bandwidth.
+ *
+ * @param registryUrl - Base URL of the registry (e.g. 'https://forge.soulcraft.com').
+ * @param cachePath - Absolute path to the local cache directory.
+ * @param cacheTtlMs - Cache freshness duration in milliseconds.
+ * @returns A KitsModule that fetches kits from the registry.
+ */
+function _createRegistryKitsModule(registryUrl, cachePath, cacheTtlMs) {
+    /** In-memory manifest cache — avoids disk reads on repeated calls. */
+    const memCache = new Map();
+    /** Strip trailing slash from registry URL for consistent URL building. */
+    const baseUrl = registryUrl.replace(/\/+$/, '');
+    mkdirSync(cachePath, { recursive: true });
+    /**
+     * @description Ensure a kit is available in the local cache.
+     *
+     * Cache flow:
+     * 1. Check in-memory cache → if within TTL, return immediately.
+     * 2. Check disk cache meta → if within TTL, load manifest from disk.
+     * 3. Send HEAD with If-None-Match → if 304, refresh TTL and return cached.
+     * 4. GET /api/kits/:id/archive → download, unpack, write cache meta.
+     *
+     * @param kitId - Kit identifier.
+     * @returns CachedKitEntry, or null if the kit doesn't exist.
+     */
+    async function ensureCached(kitId) {
+        const now = Date.now();
+        // 1. In-memory cache hit within TTL
+        const mem = memCache.get(kitId);
+        if (mem && (now - mem.fetchedAt) < cacheTtlMs) {
+            return mem;
+        }
+        // 2. Disk cache hit within TTL
+        const diskMeta = _readCacheMeta(cachePath, kitId);
+        if (diskMeta && (now - new Date(diskMeta.fetchedAt).getTime()) < cacheTtlMs) {
+            const manifest = _readCachedManifest(cachePath, kitId);
+            if (manifest) {
+                const entry = {
+                    manifest,
+                    etag: diskMeta.etag,
+                    localPath: join(cachePath, kitId),
+                    fetchedAt: new Date(diskMeta.fetchedAt).getTime()
+                };
+                memCache.set(kitId, entry);
+                return entry;
+            }
+        }
+        // 3. Revalidate with ETag (conditional GET on archive endpoint)
+        const existingEtag = diskMeta?.etag || mem?.etag || null;
+        try {
+            const archiveUrl = `${baseUrl}/api/kits/${encodeURIComponent(kitId)}/archive`;
+            const headers = {};
+            if (existingEtag) {
+                headers['If-None-Match'] = existingEtag;
+            }
+            const response = await fetch(archiveUrl, { headers });
+            // 304 Not Modified — cache is still valid
+            if (response.status === 304) {
+                const manifest = _readCachedManifest(cachePath, kitId) || mem?.manifest || null;
+                if (manifest) {
+                    const entry = {
+                        manifest,
+                        etag: existingEtag,
+                        localPath: join(cachePath, kitId),
+                        fetchedAt: now
+                    };
+                    memCache.set(kitId, entry);
+                    _writeCacheMeta(cachePath, kitId, {
+                        etag: existingEtag,
+                        fetchedAt: new Date(now).toISOString(),
+                        version: manifest.version
+                    });
+                    return entry;
+                }
+            }
+            // 404 — kit doesn't exist
+            if (response.status === 404) {
+                memCache.delete(kitId);
+                return null;
+            }
+            // 200 — download and unpack
+            if (response.ok) {
+                const buffer = new Uint8Array(await response.arrayBuffer());
+                const etag = response.headers.get('etag');
+                const kitDir = join(cachePath, kitId);
+                // Clear existing cache for this kit (preserve _cache-meta.json)
+                if (existsSync(kitDir)) {
+                    rmSync(kitDir, { recursive: true, force: true });
+                }
+                await _unpackArchive(buffer, kitDir);
+                const manifest = _readCachedManifest(cachePath, kitId);
+                if (!manifest) {
+                    console.error(`[sdk.kits] Downloaded archive for "${kitId}" has no kit.json`);
+                    return null;
+                }
+                const entry = {
+                    manifest,
+                    etag,
+                    localPath: kitDir,
+                    fetchedAt: now
+                };
+                memCache.set(kitId, entry);
+                _writeCacheMeta(cachePath, kitId, {
+                    etag,
+                    fetchedAt: new Date(now).toISOString(),
+                    version: manifest.version
+                });
+                return entry;
+            }
+            // Other errors — log and fall through to cached data
+            console.error(`[sdk.kits] Registry returned ${response.status} for "${kitId}"`);
+        }
+        catch (err) {
+            // Network error — use stale cache if available
+            console.error(`[sdk.kits] Failed to reach registry for "${kitId}":`, err);
+        }
+        // Stale cache fallback — return whatever we have
+        if (mem)
+            return mem;
+        const manifest = _readCachedManifest(cachePath, kitId);
+        if (manifest) {
+            const entry = {
+                manifest,
+                etag: diskMeta?.etag ?? null,
+                localPath: join(cachePath, kitId),
+                fetchedAt: diskMeta ? new Date(diskMeta.fetchedAt).getTime() : 0
+            };
+            memCache.set(kitId, entry);
+            return entry;
+        }
+        return null;
+    }
+    return {
+        async load(kitId) {
+            const entry = await ensureCached(kitId);
+            return entry?.manifest ?? null;
+        },
+        async list() {
+            try {
+                const response = await fetch(`${baseUrl}/api/kits`);
+                if (!response.ok)
+                    return [];
+                const data = await response.json();
+                return data.kits ?? [];
+            }
+            catch {
+                // Offline fallback — read manifests from all cached kit directories
+                if (!existsSync(cachePath))
+                    return [];
+                const dirs = readdirSync(cachePath, { withFileTypes: true })
+                    .filter(d => d.isDirectory() && !d.name.startsWith('.') && !d.name.startsWith('_'));
+                const results = [];
+                for (const dir of dirs) {
+                    const manifest = _readCachedManifest(cachePath, dir.name);
+                    if (manifest)
+                        results.push(manifest);
+                }
+                return results;
+            }
+        },
+        async resolveFilesPath(kitId, product) {
+            const entry = await ensureCached(kitId);
+            if (!entry)
+                return null;
+            const filesDir = join(entry.localPath, product, 'files');
+            return existsSync(filesDir) ? filesDir : null;
+        },
+        async resolveSkillsPath(kitId) {
+            const entry = await ensureCached(kitId);
+            if (!entry)
+                return null;
+            const skillsDir = join(entry.localPath, 'skills');
+            return existsSync(skillsDir) ? skillsDir : null;
+        },
+        async resolveKitsRoot() {
+            return cachePath;
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create the `sdk.kits.*` module.
+ *
+ * The mode is determined by the options:
+ * - `bundledRegistry` set → static in-memory registry (for tests)
+ * - `registryUrl` set → HTTP-based registry mode (production)
+ * - Neither set → legacy bundled mode via `@soulcraft/kits` package
+ *
+ * @param options - Configuration for the kits module.
+ * @returns A `KitsModule` instance.
+ *
+ * @example Registry mode (production)
+ * ```typescript
+ * const kits = createKitsModule({
+ *   registryUrl: 'https://forge.soulcraft.com',
+ *   cachePath: '/home/app/.soulcraft/kits-cache',
+ * })
+ * ```
+ *
+ * @example Bundled mode (legacy — no options needed)
+ * ```typescript
+ * const kits = createKitsModule()
+ * ```
+ *
+ * @example Test mode — inject mock kits
+ * ```typescript
+ * const kits = createKitsModule({
+ *   bundledRegistry: {
+ *     'test-kit': { id: 'test-kit', name: 'Test Kit', version: '1.0.0', ... }
+ *   }
+ * })
+ * ```
+ */
+export function createKitsModule(options = {}) {
+    // Test mode — static in-memory registry takes highest precedence
+    if (options.bundledRegistry !== undefined) {
+        const getRegistry = () => options.bundledRegistry ?? null;
+        return _createBundledKitsModule(getRegistry);
+    }
+    // Registry mode — fetch from Forge Kit Registry over HTTP
+    if (options.registryUrl) {
+        const cachePath = options.cachePath
+            ? resolve(options.cachePath)
+            : DEFAULT_CACHE_PATH;
+        const cacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+        return _createRegistryKitsModule(options.registryUrl, cachePath, cacheTtlMs);
+    }
+    // Bundled mode (legacy) — load from @soulcraft/kits npm package
+    return _createBundledKitsModule(_getBundledRegistry);
+}
 //# sourceMappingURL=index.js.map

package/dist/modules/kits/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/kits/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,4EAA4E;AAC5E,iFAAiF;AACjF,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAgB/C,IAAI,YAAY,GAAmC,SAAS,CAAA;AAE5D;;;GAGG;AACH,SAAS,gBAAgB;IACvB,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,YAAY,CAAA;IACnD,IAAI,CAAC;QACH,YAAY,GAAG,QAAQ,CAAC,iBAAiB,CAAgB,CAAA;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,GAAG,IAAI,CAAA;IACrB,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB;IAC1B,OAAO,gBAAgB,EAAE,EAAE,WAAW,IAAI,IAAI,CAAA;AAChD,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,KAAK,SAAS;QACvD,CAAC,CAAC,GAA8C,EAAE,CAAC,OAAO,CAAC,eAAe,IAAI,IAAI;QAClF,CAAC,CAAC,mBAAmB,CAAA;IAEvB,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAa;YACtB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;YAC9B,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAA;YAC1B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAA;QAChC,CAAC;QAED,KAAK,CAAC,IAAI;YACR,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;YAC9B,IAAI,CAAC,QAAQ;gBAAE,OAAO,EAAE,CAAA;YACxB,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAChC,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,OAA6B;YACjE,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAA;YAC9B,IAAI,CAAC,GAAG,EAAE,mBAAmB;gBAAE,OAAO,IAAI,CAAA;YAC1C,OAAO,GAAG,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAChD,CAAC;QAED,KAAK,CAAC,iBAAiB,CAAC,KAAa;YACnC,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAA;YAC9B,IAAI,CAAC,GAAG,EAAE,oBAAoB;gBAAE,OAAO,IAAI,CAAA;YAC3C,OAAO,GAAG,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAA;QACxC,CAAC;QAED,KAAK,CAAC,eAAe;YACnB,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAA;YAC9B,IAAI,CAAC,GAAG,EAAE,eAAe;gBAAE,OAAO,IAAI,CAAA;YACtC,OAAO,GAAG,CAAC,eAAe,EAAE,CAAA;QAC9B,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/kits/index.ts"],"names":[],"mappings":"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"}