@soulcraft/sdk 1.2.0 → 1.4.0

package/dist/client/index.d.ts

@@ -3,9 +3,10 @@
  * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
  * for kit apps running in a browser context to connect to a Soulcraft product backend.
  *
- * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), and
- * SSE (server-push) transports. Cookie-based and Bearer token auth. The Brainy proxy
- * factory for creating a fully-typed `sdk.brainy` API surface over any transport.
+ * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), SSE
+ * (server-push), and PostMessage (WebContainer iframe ↔ parent frame) transports.
+ * Cookie-based and Bearer token auth. The Brainy proxy factory for creating a
+ * fully-typed `sdk.brainy` API surface over any transport.
  *
  * This entry point has no server-only dependencies — it is safe to bundle for the
  * browser. The trade-off is that it cannot create Brainy instances directly.
@@ -53,6 +54,8 @@
 export { HttpTransport } from '../transports/http.js';
 export { WsTransport } from '../transports/ws.js';
 export { SseTransport } from '../transports/sse.js';
+export { PostMessageTransport } from '../transports/postmessage.js';
+export type { PostMessageRequest, PostMessageResponse } from '../transports/postmessage.js';
 export type { SDKTransport } from '../transports/transport.js';
 export { createBrainyProxy } from '../modules/brainy/proxy.js';
 export { joinHallRoom } from '../modules/hall/browser.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,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

@@ -3,9 +3,10 @@
  * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
  * for kit apps running in a browser context to connect to a Soulcraft product backend.
  *
- * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), and
- * SSE (server-push) transports. Cookie-based and Bearer token auth. The Brainy proxy
- * factory for creating a fully-typed `sdk.brainy` API surface over any transport.
+ * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), SSE
+ * (server-push), and PostMessage (WebContainer iframe ↔ parent frame) transports.
+ * Cookie-based and Bearer token auth. The Brainy proxy factory for creating a
+ * fully-typed `sdk.brainy` API surface over any transport.
  *
  * This entry point has no server-only dependencies — it is safe to bundle for the
  * browser. The trade-off is that it cannot create Brainy instances directly.
@@ -54,6 +55,7 @@
 export { HttpTransport } from '../transports/http.js';
 export { WsTransport } from '../transports/ws.js';
 export { SseTransport } from '../transports/sse.js';
+export { PostMessageTransport } from '../transports/postmessage.js';
 // ── Proxy factory ─────────────────────────────────────────────────────────────
 export { createBrainyProxy } from '../modules/brainy/proxy.js';
 // ── Hall room client (browser WebRTC) ─────────────────────────────────────────

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAoBzD,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAInE,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAoBzD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/modules/license/index.js

@@ -32,8 +32,8 @@
 // ─────────────────────────────────────────────────────────────────────────────
 /** Default heartbeat interval: 4 hours. */
 const DEFAULT_CHECK_INTERVAL_MS = 4 * 60 * 60 * 1000;
-/** Portal license validation endpoint. */
-const PORTAL_LICENSE_URL = 'https://portal.soulcraft.com/api/license/validate';
+/** Portal license validation endpoint (routed via soulcraft.com hosting). */
+const PORTAL_LICENSE_URL = 'https://soulcraft.com/api/license/validate-sdk';
 /**
  * Validate the license key against Portal.
  * Reads `SOULCRAFT_LICENSE_KEY` from the environment.

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/license/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/license/index.ts"],"names":[],"mappings":"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"}

package/dist/server/from-license.d.ts

@@ -0,0 +1,213 @@
+/**
+ * @module server/from-license
+ * @description License-driven server SDK factory.
+ *
+ * `createServerSDK.fromLicense({ product })` is the recommended production entry point
+ * for product backends. It replaces the manual environment-variable wiring required by
+ * `createSDK()` with a single boot-time call to Portal:
+ *
+ * ```
+ * SOULCRAFT_LICENSE_KEY=SC-XXXX-XXXX-XXXX   ← only secret needed
+ * ```
+ *
+ * At startup the factory:
+ * 1. Reads `SOULCRAFT_LICENSE_KEY` from the environment.
+ * 2. POSTs `POST https://soulcraft.com/api/license/activate` with the key and product name.
+ * 3. Receives a config bundle (`anthropicApiKey`, `portalCreditSecret`, `hallSecret`, etc.).
+ * 4. Injects the bundle values into `process.env` so all SDK module factories pick them
+ *    up automatically — no factory API changes required.
+ * 5. Writes the bundle to `.soulcraft-config.json` in the working directory for offline
+ *    restarts (e.g. if Portal is temporarily unreachable after a product restart).
+ * 6. Schedules a background re-validation every 4 hours to pick up rotated secrets.
+ *
+ * The returned `ServerSDK` object is long-lived (one per process). Its `createSDK(brain)`
+ * method returns a per-request `SoulcraftSDK`, identical to calling `createSDK({ brain })`
+ * directly, but with all secrets already wired from the bundle.
+ *
+ * ## Backward compatibility
+ *
+ * `createSDK()` is unchanged — products that manage their own env vars continue to work
+ * exactly as before. `fromLicense()` is additive.
+ *
+ * ## Offline / degraded start
+ *
+ * If Portal is unreachable on first boot, the factory falls back to a cached bundle from
+ * `.soulcraft-config.json`. If no cache exists either, it throws — a product cannot start
+ * in production without a resolved config bundle.
+ *
+ * @example Academy startup
+ * ```typescript
+ * import { createServerSDK, BrainyInstancePool } from '@soulcraft/sdk/server'
+ *
+ * const server = await createServerSDK.fromLicense({ product: 'academy' })
+ *
+ * const pool = new BrainyInstancePool({
+ *   storage: 'mmap-filesystem',
+ *   dataPath: '/mnt/brainy-data',
+ *   strategy: 'per-user',
+ * })
+ *
+ * // Per-request:
+ * app.get('/api/brainy', requireAuth, async (c) => {
+ *   const brain = await pool.forUser(user.emailHash, 'main')
+ *   const sdk = server.createSDK(brain)
+ *   const items = await sdk.brainy.find({ query: 'candle inventory' })
+ *   return c.json({ items })
+ * })
+ *
+ * // On shutdown:
+ * process.on('SIGTERM', () => server.shutdown())
+ * ```
+ */
+import type { Brainy } from '@soulcraft/brainy';
+import type { HallModule } from '../modules/hall/types.js';
+import type { SoulcraftSDK, SoulcraftProduct } from '../types.js';
+/**
+ * Config bundle returned by the Portal `licenseActivate` endpoint.
+ * Only non-null fields are included in the response.
+ */
+export interface LicenseConfigBundle {
+    /** Anthropic API key for `sdk.ai.*` calls. */
+    anthropicApiKey?: string;
+    /** Shared secret for the Portal credit API (`sdk.billing.*`). */
+    portalCreditSecret?: string;
+    /** WebSocket URL of the Hall server (e.g. `wss://hall.soulcraft.com`). */
+    hallUrl?: string;
+    /** Per-product shared secret for Hall authentication. */
+    hallSecret?: string;
+    /** Stripe secret key for `sdk.billing.*` Stripe operations. */
+    stripeSecretKey?: string;
+    /** Stripe webhook signing secret. */
+    stripeWebhookSecret?: string;
+    /** Workshop deploy bearer token secret. */
+    workshopDeploySecret?: string;
+    /** Academy publish bearer token secret. */
+    academyPublishSecret?: string;
+    /** Venue RPC capability token secret. */
+    venueRpcSecret?: string;
+    /** Postmark server token for email notifications. */
+    postmarkToken?: string;
+    /** From-address for Postmark email. */
+    postmarkFromEmail?: string;
+    /** Twilio account SID for SMS notifications. */
+    twilioSid?: string;
+    /** Twilio auth token for SMS notifications. */
+    twilioToken?: string;
+    /** Twilio from-number for SMS. */
+    twilioFromNumber?: string;
+    /** Firebase service account key (base64-encoded JSON) for Firestore billing. */
+    firebaseServiceAccountKey?: string;
+}
+/**
+ * Options for `createServerSDK.fromLicense()`.
+ */
+export interface FromLicenseOptions {
+    /**
+     * The Soulcraft product name.
+     * Used to retrieve the correct per-product secrets (e.g. Hall secret, deploy secret)
+     * from the Portal config bundle.
+     *
+     * @example `'workshop'` | `'venue'` | `'academy'`
+     */
+    product: SoulcraftProduct;
+    /**
+     * Override the license key.
+     * When not provided, `SOULCRAFT_LICENSE_KEY` is read from the environment.
+     */
+    licenseKey?: string;
+}
+/**
+ * A long-lived server SDK object returned by `createServerSDK.fromLicense()`.
+ *
+ * Wraps the Portal config bundle and exposes `createSDK(brain)` for per-request SDK
+ * construction. The Hall module (if configured) is available as `server.hall`.
+ */
+export interface ServerSDK {
+    /**
+     * Create a per-request `SoulcraftSDK` wrapping a live Brainy instance.
+     *
+     * All secrets are already injected from the license bundle — pass the resolved
+     * Brainy instance and the SDK is ready to use.
+     *
+     * @param brain - A Brainy instance from a `BrainyInstancePool`.
+     * @returns A fully assembled `SoulcraftSDK`.
+     */
+    createSDK(brain: Brainy): SoulcraftSDK;
+    /**
+     * The Hall module, connected to the Hall server at startup.
+     * Present only when the license bundle includes `hallSecret` and `hallUrl`.
+     */
+    readonly hall: HallModule | undefined;
+    /**
+     * The resolved license config bundle.
+     * Contains all secrets injected into the environment at startup.
+     */
+    readonly config: LicenseConfigBundle;
+    /**
+     * The product tier from the license response.
+     * `'free'` | `'pro'` | `'enterprise'` | `'internal'`
+     */
+    readonly tier: string;
+    /**
+     * Gracefully shut down the server SDK.
+     *
+     * Stops the background re-validation timer and disconnects the Hall module.
+     */
+    shutdown(): void;
+}
+/**
+ * Activate the SDK from a Soulcraft license key.
+ *
+ * Calls Portal's `licenseActivate` endpoint, injects the returned config bundle
+ * into `process.env`, and returns a `ServerSDK` ready for per-request use.
+ *
+ * Falls back to a cached bundle (`.soulcraft-config.json`) if Portal is unreachable.
+ * Throws if neither Portal nor a valid cache is available.
+ *
+ * @param options - Product name and optional license key override.
+ * @returns A `ServerSDK` instance, fully wired from the license bundle.
+ *
+ * @throws {Error} If the license key is invalid, expired, or Portal is unreachable with no cache.
+ *
+ * @example
+ * ```typescript
+ * const server = await createServerSDK.fromLicense({ product: 'academy' })
+ * const pool = new BrainyInstancePool({ storage: 'mmap-filesystem', dataPath: '/mnt/brainy-data', strategy: 'per-user' })
+ *
+ * app.use(requireAuth)
+ * app.get('/api/brainy', async (c) => {
+ *   const brain = await pool.forUser(c.get('user').emailHash, 'main')
+ *   const sdk = server.createSDK(brain)
+ *   return c.json(await sdk.brainy.find({ query: c.req.query('q') ?? '' }))
+ * })
+ *
+ * process.on('SIGTERM', () => server.shutdown())
+ * ```
+ */
+declare function fromLicense(options: FromLicenseOptions): Promise<ServerSDK>;
+/**
+ * Server SDK factory namespace.
+ *
+ * The primary entry point is `createServerSDK.fromLicense({ product })`.
+ * For lower-level control (custom Brainy instance, no license key), use
+ * `createSDK({ brain })` directly.
+ *
+ * @example
+ * ```typescript
+ * import { createServerSDK, BrainyInstancePool } from '@soulcraft/sdk/server'
+ *
+ * const server = await createServerSDK.fromLicense({ product: 'workshop' })
+ * const pool = new BrainyInstancePool({ storage: 'mmap-filesystem', dataPath: '/mnt/data', strategy: 'per-user' })
+ *
+ * app.get('/api/brainy', requireAuth, async (c) => {
+ *   const brain = await pool.forUser(c.get('user').emailHash, 'main')
+ *   const sdk = server.createSDK(brain)
+ *   return c.json(await sdk.brainy.find({ query: c.req.query('q') ?? '' }))
+ * })
+ * ```
+ */
+export declare const createServerSDK: {
+    fromLicense: typeof fromLicense;
+};
+export {};
+//# sourceMappingURL=from-license.d.ts.map

package/dist/server/from-license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-license.d.ts","sourceRoot":"","sources":["../../src/server/from-license.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAmBjE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gFAAgF;IAChF,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC;AAmBD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,OAAO,EAAE,gBAAgB,CAAA;IAEzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAA;IAEtC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAA;IAErC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IAEpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,QAAQ,IAAI,IAAI,CAAA;CACjB;AAuGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAe,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CA4G1E;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe;;CAE3B,CAAA"}

package/dist/server/from-license.js

@@ -0,0 +1,305 @@
+/**
+ * @module server/from-license
+ * @description License-driven server SDK factory.
+ *
+ * `createServerSDK.fromLicense({ product })` is the recommended production entry point
+ * for product backends. It replaces the manual environment-variable wiring required by
+ * `createSDK()` with a single boot-time call to Portal:
+ *
+ * ```
+ * SOULCRAFT_LICENSE_KEY=SC-XXXX-XXXX-XXXX   ← only secret needed
+ * ```
+ *
+ * At startup the factory:
+ * 1. Reads `SOULCRAFT_LICENSE_KEY` from the environment.
+ * 2. POSTs `POST https://soulcraft.com/api/license/activate` with the key and product name.
+ * 3. Receives a config bundle (`anthropicApiKey`, `portalCreditSecret`, `hallSecret`, etc.).
+ * 4. Injects the bundle values into `process.env` so all SDK module factories pick them
+ *    up automatically — no factory API changes required.
+ * 5. Writes the bundle to `.soulcraft-config.json` in the working directory for offline
+ *    restarts (e.g. if Portal is temporarily unreachable after a product restart).
+ * 6. Schedules a background re-validation every 4 hours to pick up rotated secrets.
+ *
+ * The returned `ServerSDK` object is long-lived (one per process). Its `createSDK(brain)`
+ * method returns a per-request `SoulcraftSDK`, identical to calling `createSDK({ brain })`
+ * directly, but with all secrets already wired from the bundle.
+ *
+ * ## Backward compatibility
+ *
+ * `createSDK()` is unchanged — products that manage their own env vars continue to work
+ * exactly as before. `fromLicense()` is additive.
+ *
+ * ## Offline / degraded start
+ *
+ * If Portal is unreachable on first boot, the factory falls back to a cached bundle from
+ * `.soulcraft-config.json`. If no cache exists either, it throws — a product cannot start
+ * in production without a resolved config bundle.
+ *
+ * @example Academy startup
+ * ```typescript
+ * import { createServerSDK, BrainyInstancePool } from '@soulcraft/sdk/server'
+ *
+ * const server = await createServerSDK.fromLicense({ product: 'academy' })
+ *
+ * const pool = new BrainyInstancePool({
+ *   storage: 'mmap-filesystem',
+ *   dataPath: '/mnt/brainy-data',
+ *   strategy: 'per-user',
+ * })
+ *
+ * // Per-request:
+ * app.get('/api/brainy', requireAuth, async (c) => {
+ *   const brain = await pool.forUser(user.emailHash, 'main')
+ *   const sdk = server.createSDK(brain)
+ *   const items = await sdk.brainy.find({ query: 'candle inventory' })
+ *   return c.json({ items })
+ * })
+ *
+ * // On shutdown:
+ * process.on('SIGTERM', () => server.shutdown())
+ * ```
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { createSDK } from './create-sdk.js';
+import { createHallModule } from './hall-handlers.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+/** Portal license activation endpoint. */
+const ACTIVATE_URL = 'https://soulcraft.com/api/license/activate';
+/** Re-validation interval: 4 hours. */
+const REVALIDATE_INTERVAL_MS = 4 * 60 * 60 * 1000;
+/** Path to the cached config bundle on disk. */
+const CACHE_PATH = resolve(process.cwd(), '.soulcraft-config.json');
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Call the Portal `licenseActivate` endpoint and return the full response.
+ *
+ * @throws {Error} If the network call fails or Portal returns a non-200 status.
+ */
+async function _activate(key, product) {
+    const response = await fetch(ACTIVATE_URL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ key, product, sdkVersion: '1.3.0' }),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (response.status === 403) {
+        const body = (await response.json().catch(() => ({})));
+        throw new Error(`License key rejected by Portal: ${body.reason ?? 'key_not_found'}. ` +
+            `Check SOULCRAFT_LICENSE_KEY is correct and the license has not expired.`);
+    }
+    if (!response.ok) {
+        throw new Error(`Portal license activation failed (HTTP ${response.status}). ` +
+            `The service may be temporarily unavailable.`);
+    }
+    return response.json();
+}
+/**
+ * Read the cached bundle from `.soulcraft-config.json`.
+ * Returns `undefined` if the file does not exist or cannot be parsed.
+ */
+function _readCache() {
+    try {
+        const raw = readFileSync(CACHE_PATH, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Write the activation response to `.soulcraft-config.json`.
+ * Failures are non-fatal — if the disk is read-only, the cache is simply not written.
+ */
+function _writeCache(product, response) {
+    try {
+        const bundle = {
+            activatedAt: new Date().toISOString(),
+            product,
+            response,
+        };
+        writeFileSync(CACHE_PATH, JSON.stringify(bundle, null, 2), 'utf8');
+    }
+    catch {
+        // Non-fatal — read-only FS or permission error.
+    }
+}
+/**
+ * Inject config bundle values into `process.env`.
+ *
+ * Only sets variables that are present in the bundle and not already set by the host
+ * environment. Host-set values take precedence, allowing per-deployment overrides.
+ */
+function _injectEnv(config) {
+    const mappings = [
+        ['anthropicApiKey', 'ANTHROPIC_API_KEY'],
+        ['portalCreditSecret', 'PORTAL_CREDIT_SECRET'],
+        ['hallUrl', 'HALL_URL'],
+        ['stripeSecretKey', 'STRIPE_SECRET_KEY'],
+        ['stripeWebhookSecret', 'STRIPE_WEBHOOK_SECRET'],
+        ['workshopDeploySecret', 'WORKSHOP_DEPLOY_SECRET'],
+        ['academyPublishSecret', 'ACADEMY_PUBLISH_SECRET'],
+        ['venueRpcSecret', 'VENUE_RPC_SECRET'],
+        ['postmarkToken', 'POSTMARK_SERVER_TOKEN'],
+        ['postmarkFromEmail', 'POSTMARK_FROM_EMAIL'],
+        ['twilioSid', 'TWILIO_ACCOUNT_SID'],
+        ['twilioToken', 'TWILIO_AUTH_TOKEN'],
+        ['twilioFromNumber', 'TWILIO_FROM_NUMBER'],
+        ['firebaseServiceAccountKey', 'FIREBASE_SERVICE_ACCOUNT_KEY'],
+    ];
+    for (const [configKey, envKey] of mappings) {
+        const value = config[configKey];
+        if (value && !process.env[envKey]) {
+            process.env[envKey] = value;
+        }
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// fromLicense factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Activate the SDK from a Soulcraft license key.
+ *
+ * Calls Portal's `licenseActivate` endpoint, injects the returned config bundle
+ * into `process.env`, and returns a `ServerSDK` ready for per-request use.
+ *
+ * Falls back to a cached bundle (`.soulcraft-config.json`) if Portal is unreachable.
+ * Throws if neither Portal nor a valid cache is available.
+ *
+ * @param options - Product name and optional license key override.
+ * @returns A `ServerSDK` instance, fully wired from the license bundle.
+ *
+ * @throws {Error} If the license key is invalid, expired, or Portal is unreachable with no cache.
+ *
+ * @example
+ * ```typescript
+ * const server = await createServerSDK.fromLicense({ product: 'academy' })
+ * const pool = new BrainyInstancePool({ storage: 'mmap-filesystem', dataPath: '/mnt/brainy-data', strategy: 'per-user' })
+ *
+ * app.use(requireAuth)
+ * app.get('/api/brainy', async (c) => {
+ *   const brain = await pool.forUser(c.get('user').emailHash, 'main')
+ *   const sdk = server.createSDK(brain)
+ *   return c.json(await sdk.brainy.find({ query: c.req.query('q') ?? '' }))
+ * })
+ *
+ * process.on('SIGTERM', () => server.shutdown())
+ * ```
+ */
+async function fromLicense(options) {
+    const { product } = options;
+    const key = options.licenseKey ?? process.env['SOULCRAFT_LICENSE_KEY'];
+    if (!key) {
+        throw new Error('SOULCRAFT_LICENSE_KEY is not set. ' +
+            'Set this environment variable to your Soulcraft license key, ' +
+            'or pass licenseKey explicitly to fromLicense().');
+    }
+    // ── Activate ──────────────────────────────────────────────────────────────
+    let activateResponse;
+    try {
+        activateResponse = await _activate(key, product);
+        _writeCache(product, activateResponse);
+    }
+    catch (err) {
+        // Portal unreachable — try the cached bundle.
+        const cached = _readCache();
+        if (cached?.product === product && cached.response.valid) {
+            console.warn(`[SDK] Portal unreachable (${err instanceof Error ? err.message : String(err)}). ` +
+                `Using cached config from ${cached.activatedAt}.`);
+            activateResponse = cached.response;
+        }
+        else {
+            throw new Error(`Failed to activate SDK license and no valid cache found. ` +
+                `Original error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (!activateResponse.valid) {
+        throw new Error(`License key is not valid: ${activateResponse.reason ?? 'unknown reason'}. ` +
+            `Check that your license has not expired.`);
+    }
+    const config = activateResponse.config;
+    const tier = activateResponse.tier ?? 'free';
+    // ── Inject env ────────────────────────────────────────────────────────────
+    _injectEnv(config);
+    // ── Wire Hall ─────────────────────────────────────────────────────────────
+    let hall;
+    if (config.hallSecret && config.hallUrl) {
+        hall = createHallModule({
+            url: config.hallUrl,
+            productName: product,
+            secret: config.hallSecret,
+        });
+        await hall.connect();
+    }
+    // ── Background re-validation ──────────────────────────────────────────────
+    let _revalidateTimer;
+    async function _revalidate() {
+        try {
+            const fresh = await _activate(key, product);
+            _writeCache(product, fresh);
+            _injectEnv(fresh.config);
+        }
+        catch {
+            // Non-fatal — the in-memory injected values remain valid until next attempt.
+        }
+    }
+    _revalidateTimer = setInterval(() => { void _revalidate(); }, REVALIDATE_INTERVAL_MS);
+    if (_revalidateTimer.unref)
+        _revalidateTimer.unref();
+    // ── Return ServerSDK ──────────────────────────────────────────────────────
+    return {
+        createSDK(brain) {
+            return createSDK({ brain });
+        },
+        get hall() {
+            return hall;
+        },
+        get config() {
+            return config;
+        },
+        get tier() {
+            return tier;
+        },
+        shutdown() {
+            if (_revalidateTimer) {
+                clearInterval(_revalidateTimer);
+                _revalidateTimer = undefined;
+            }
+            if (hall) {
+                void hall.close();
+            }
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// createServerSDK namespace
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Server SDK factory namespace.
+ *
+ * The primary entry point is `createServerSDK.fromLicense({ product })`.
+ * For lower-level control (custom Brainy instance, no license key), use
+ * `createSDK({ brain })` directly.
+ *
+ * @example
+ * ```typescript
+ * import { createServerSDK, BrainyInstancePool } from '@soulcraft/sdk/server'
+ *
+ * const server = await createServerSDK.fromLicense({ product: 'workshop' })
+ * const pool = new BrainyInstancePool({ storage: 'mmap-filesystem', dataPath: '/mnt/data', strategy: 'per-user' })
+ *
+ * app.get('/api/brainy', requireAuth, async (c) => {
+ *   const brain = await pool.forUser(c.get('user').emailHash, 'main')
+ *   const sdk = server.createSDK(brain)
+ *   return c.json(await sdk.brainy.find({ query: c.req.query('q') ?? '' }))
+ * })
+ * ```
+ */
+export const createServerSDK = {
+    fromLicense,
+};
+//# sourceMappingURL=from-license.js.map

package/dist/server/from-license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-license.js","sourceRoot":"","sources":["../../src/server/from-license.ts"],"names":[],"mappings":"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"}

package/dist/server/index.d.ts

@@ -36,6 +36,8 @@ export { BrainyInstancePool, BrainyInitializingError, computeEmailHash, } from '
 export type { InstancePoolConfig, InstancePoolStats, } from './instance-pool.js';
 export { createBrainyHandler, createBrainyWsHandler, } from './handlers.js';
 export type { BrainyHandlerConfig, BrainyWsHandlerConfig, BrainyWsHandler, WsSession, } from './handlers.js';
+export { createBrainyPostMessageHandler } from './postmessage-handler.js';
+export type { BrainyPostMessageHandlerConfig, BrainyPostMessageHandler, } from './postmessage-handler.js';
 export { createHallModule, generateTurnCredentials, HallClient, } from './hall-handlers.js';
 export type { HallConnectionOptions, HallModule, TurnCredentialOptions, TurnCredentials, } from './hall-handlers.js';
 export type { HallRoom, HallRoomEvents, RoomOptions, ConceptInput, RecordingManifest, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, } from '../modules/hall/types.js';
@@ -47,6 +49,8 @@ export { verifyServiceToken, extractBearerToken, } from '../modules/auth/service
 export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, getAuthMode, getOIDCClientConfig, } from '../modules/auth/config.js';
 export { createSDK } from './create-sdk.js';
 export type { CreateSDKOptions } from './create-sdk.js';
+export { createServerSDK } from './from-license.js';
+export type { ServerSDK, FromLicenseOptions, LicenseConfigBundle, } from './from-license.js';
 export { createBillingModule } from '../modules/billing/index.js';
 export type { CreateBillingModuleOptions } from '../modules/billing/index.js';
 export { createLicenseModule } from '../modules/license/index.js';