@soulcraft/sdk 1.4.12 → 1.5.0

package/dist/client/create-client-sdk.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @module client/create-client-sdk
+ * @description `createClientSDK` factory for browser/client-mode @soulcraft/sdk.
+ *
+ * Assembles a `SoulcraftSDK` from a `ClientSDKOptions` specification. Selects and
+ * wires the appropriate transport (`http`, `ws`, or `sse`) and returns a full SDK
+ * object whose `sdk.brainy.*` API works identically to server mode.
+ *
+ * ## Transport selection
+ *
+ * | `transport` | Use case |
+ * |-------------|----------|
+ * | `'http'`    | Stateless RPC — kit apps, simple clients. No push events. |
+ * | `'ws'`      | Bidirectional RPC + real-time change push. Call `sdk.connect()` first. |
+ * | `'sse'`     | Receive-only push events. Pair with `'http'` for outbound RPC. |
+ *
+ * ## Auth
+ *
+ * - `auth: 'cookie'` — sends session cookies (same-origin browser use). HTTP only.
+ * - `auth: { token }` — sends `Authorization: Bearer <token>`. HTTP and WS.
+ * - Omit `auth` for unauthenticated requests (public endpoints).
+ *
+ * @example HTTP transport (kit app, cookie auth)
+ * ```typescript
+ * import { createClientSDK } from '@soulcraft/sdk/client'
+ *
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'workshop',
+ *   transport: 'http',
+ *   baseUrl: 'https://workshop.soulcraft.com',
+ *   auth: 'cookie',
+ * })
+ *
+ * const results = await sdk.brainy.find({ query: 'candle kits', limit: 10 })
+ * ```
+ *
+ * @example WebSocket transport (real-time change push)
+ * ```typescript
+ * import { createClientSDK } from '@soulcraft/sdk/client'
+ *
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'venue',
+ *   transport: 'ws',
+ *   baseUrl: 'wss://venue.soulcraft.com/api/brainy/ws',
+ *   auth: { token: capabilityToken },
+ * })
+ *
+ * await sdk.connect!()
+ * sdk.brainy.onDataChange((event) => refreshUI(event))
+ * const items = await sdk.brainy.find({ query: 'inventory' })
+ * ```
+ *
+ * @example SSE transport (receive-only change events + HTTP for outbound)
+ * ```typescript
+ * import { createClientSDK } from '@soulcraft/sdk/client'
+ *
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'venue',
+ *   transport: 'sse',
+ *   baseUrl: 'https://venue.soulcraft.com',
+ *   auth: 'cookie',
+ * })
+ *
+ * // sdk.brainy.onDataChange() fires on live server changes.
+ * // sdk.brainy.find() etc. are not available on SSE — wire an HttpTransport separately.
+ * sdk.brainy.onDataChange((event) => console.log('change:', event))
+ * ```
+ */
+import type { ClientSDKOptions } from '../types.js';
+import type { SoulcraftSDK } from '../types.js';
+/**
+ * Create a client-mode `SoulcraftSDK` from the given options.
+ *
+ * Selects the transport specified by `options.transport`, wires auth, and returns
+ * a `SoulcraftSDK` whose `sdk.brainy.*` surface is identical to server mode.
+ *
+ * For `'ws'` transport, call `await sdk.connect!()` before making any `sdk.brainy.*`
+ * calls to establish the WebSocket connection.
+ *
+ * @param options - Client SDK options including transport, baseUrl, and auth.
+ * @returns A `SoulcraftSDK` backed by the chosen transport.
+ *
+ * @example HTTP transport
+ * ```typescript
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'workshop',
+ *   transport: 'http',
+ *   baseUrl: 'https://workshop.soulcraft.com',
+ *   auth: 'cookie',
+ * })
+ * const results = await sdk.brainy.find({ query: 'candle inventory' })
+ * ```
+ */
+export declare function createClientSDK(options: ClientSDKOptions): SoulcraftSDK;
+//# sourceMappingURL=create-client-sdk.d.ts.map

package/dist/client/create-client-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client-sdk.d.ts","sourceRoot":"","sources":["../../src/client/create-client-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAA6B,MAAM,aAAa,CAAA;AAO1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA6EvE"}

package/dist/client/create-client-sdk.js

@@ -0,0 +1,174 @@
+/**
+ * @module client/create-client-sdk
+ * @description `createClientSDK` factory for browser/client-mode @soulcraft/sdk.
+ *
+ * Assembles a `SoulcraftSDK` from a `ClientSDKOptions` specification. Selects and
+ * wires the appropriate transport (`http`, `ws`, or `sse`) and returns a full SDK
+ * object whose `sdk.brainy.*` API works identically to server mode.
+ *
+ * ## Transport selection
+ *
+ * | `transport` | Use case |
+ * |-------------|----------|
+ * | `'http'`    | Stateless RPC — kit apps, simple clients. No push events. |
+ * | `'ws'`      | Bidirectional RPC + real-time change push. Call `sdk.connect()` first. |
+ * | `'sse'`     | Receive-only push events. Pair with `'http'` for outbound RPC. |
+ *
+ * ## Auth
+ *
+ * - `auth: 'cookie'` — sends session cookies (same-origin browser use). HTTP only.
+ * - `auth: { token }` — sends `Authorization: Bearer <token>`. HTTP and WS.
+ * - Omit `auth` for unauthenticated requests (public endpoints).
+ *
+ * @example HTTP transport (kit app, cookie auth)
+ * ```typescript
+ * import { createClientSDK } from '@soulcraft/sdk/client'
+ *
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'workshop',
+ *   transport: 'http',
+ *   baseUrl: 'https://workshop.soulcraft.com',
+ *   auth: 'cookie',
+ * })
+ *
+ * const results = await sdk.brainy.find({ query: 'candle kits', limit: 10 })
+ * ```
+ *
+ * @example WebSocket transport (real-time change push)
+ * ```typescript
+ * import { createClientSDK } from '@soulcraft/sdk/client'
+ *
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'venue',
+ *   transport: 'ws',
+ *   baseUrl: 'wss://venue.soulcraft.com/api/brainy/ws',
+ *   auth: { token: capabilityToken },
+ * })
+ *
+ * await sdk.connect!()
+ * sdk.brainy.onDataChange((event) => refreshUI(event))
+ * const items = await sdk.brainy.find({ query: 'inventory' })
+ * ```
+ *
+ * @example SSE transport (receive-only change events + HTTP for outbound)
+ * ```typescript
+ * import { createClientSDK } from '@soulcraft/sdk/client'
+ *
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'venue',
+ *   transport: 'sse',
+ *   baseUrl: 'https://venue.soulcraft.com',
+ *   auth: 'cookie',
+ * })
+ *
+ * // sdk.brainy.onDataChange() fires on live server changes.
+ * // sdk.brainy.find() etc. are not available on SSE — wire an HttpTransport separately.
+ * sdk.brainy.onDataChange((event) => console.log('change:', event))
+ * ```
+ */
+import { HttpTransport } from '../transports/http.js';
+import { WsTransport } from '../transports/ws.js';
+import { SseTransport } from '../transports/sse.js';
+import { createBrainyProxy } from '../modules/brainy/proxy.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create a client-mode `SoulcraftSDK` from the given options.
+ *
+ * Selects the transport specified by `options.transport`, wires auth, and returns
+ * a `SoulcraftSDK` whose `sdk.brainy.*` surface is identical to server mode.
+ *
+ * For `'ws'` transport, call `await sdk.connect!()` before making any `sdk.brainy.*`
+ * calls to establish the WebSocket connection.
+ *
+ * @param options - Client SDK options including transport, baseUrl, and auth.
+ * @returns A `SoulcraftSDK` backed by the chosen transport.
+ *
+ * @example HTTP transport
+ * ```typescript
+ * const sdk = createClientSDK({
+ *   mode: 'client',
+ *   product: 'workshop',
+ *   transport: 'http',
+ *   baseUrl: 'https://workshop.soulcraft.com',
+ *   auth: 'cookie',
+ * })
+ * const results = await sdk.brainy.find({ query: 'candle inventory' })
+ * ```
+ */
+export function createClientSDK(options) {
+    const { baseUrl, transport: transportType, auth, timeoutMs } = options;
+    const authToken = auth && auth !== 'cookie' && typeof auth === 'object' ? auth.token : undefined;
+    const useCookies = auth === 'cookie';
+    let transport;
+    if (transportType === 'ws') {
+        if (!authToken) {
+            throw new Error('createClientSDK: WebSocket transport requires auth: { token } — ' +
+                'browser WebSocket does not support cookie auth or header-less connections.');
+        }
+        transport = new WsTransport(baseUrl, authToken, undefined, timeoutMs);
+    }
+    else if (transportType === 'sse') {
+        transport = new SseTransport(baseUrl, undefined, authToken);
+    }
+    else {
+        // Default: HTTP
+        transport = new HttpTransport(baseUrl, authToken, useCookies, timeoutMs);
+    }
+    const brainyProxy = createBrainyProxy(transport);
+    // VFS and versions are sub-namespaces of the Brainy proxy.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const vfs = brainyProxy.vfs;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const versions = brainyProxy.versions;
+    const sdk = {
+        brainy: brainyProxy,
+        vfs,
+        versions,
+        // Client mode stubs — these module namespaces are server-only.
+        // Accessing them from a client app is a usage error; throw explicitly.
+        get auth() {
+            throw new Error('sdk.auth is not available in client mode — use server-side auth middleware');
+        },
+        get license() {
+            throw new Error('sdk.license is not available in client mode');
+        },
+        get ai() {
+            throw new Error('sdk.ai is not available in client mode — use server-side AI endpoints');
+        },
+        get events() {
+            throw new Error('sdk.events is not available in client mode');
+        },
+        get skills() {
+            throw new Error('sdk.skills is not available in client mode');
+        },
+        get kits() {
+            throw new Error('sdk.kits is not available in client mode');
+        },
+        get billing() {
+            throw new Error('sdk.billing is not available in client mode');
+        },
+        get notifications() {
+            throw new Error('sdk.notifications is not available in client mode');
+        },
+        async connect() {
+            if (transportType === 'ws') {
+                await transport.connect();
+            }
+            else if (transportType === 'sse') {
+                ;
+                transport.connect();
+            }
+            // HTTP is stateless — connect is a no-op.
+        },
+        async disconnect() {
+            await transport.close();
+        },
+    };
+    return sdk;
+}
+//# sourceMappingURL=create-client-sdk.js.map

package/dist/client/create-client-sdk.js.map

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

package/dist/client/index.d.ts

@@ -51,6 +51,7 @@
  * sse.onEvent((event) => refreshUI(event))
  * ```
  */
+export { createClientSDK } from './create-client-sdk.js';
 export { HttpTransport } from '../transports/http.js';
 export { WsTransport } from '../transports/ws.js';
 export { SseTransport } from '../transports/sse.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD,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

@@ -51,6 +51,8 @@
  * sse.onEvent((event) => refreshUI(event))
  * ```
  */
+// ── Client SDK factory ────────────────────────────────────────────────────────
+export { createClientSDK } from './create-client-sdk.js';
 // ── Transport classes ─────────────────────────────────────────────────────────
 export { HttpTransport } from '../transports/http.js';
 export { WsTransport } from '../transports/ws.js';

package/dist/client/index.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,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/index.d.ts

@@ -1,26 +1,26 @@
 /**
  * @module @soulcraft/sdk
- * @description Shared entry point for @soulcraft/sdk. Exports the createSDK factory,
- * all shared types, and re-exports from every module namespace. This entry point is
- * safe to import in any environment (server or browser).
+ * @description Shared entry point for @soulcraft/sdk. Exports all shared types and
+ * environment-agnostic constants. This entry point is safe to import in any environment
+ * (server or browser).
  *
- * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers),
- * use `@soulcraft/sdk/server`.
+ * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers,
+ * `createSDK`, `computeEmailHash`, `createCapabilityToken`, `verifyCapabilityToken`,
+ * `getAuthMode`, `getOIDCClientConfig`), use `@soulcraft/sdk/server`.
  *
- * For browser-specific exports (HTTP/WS/SSE transports, cookie auth), use
+ * For browser-specific exports (HTTP/WS/SSE transports, `createClientSDK`), use
  * `@soulcraft/sdk/client`.
  */
 export type { SoulcraftSDK, SDKOptions, ServerSDKOptions, ClientSDKOptions } from './types.js';
 export type { SoulcraftBrainy } from './modules/brainy/types.js';
 export type { Entity, Relation, Result, AddParams, UpdateParams, RelateParams, FindParams, BrainyConfig, AggregateDefinition, DiagnosticsResult, MigrationResult, MigrateOptions, MigrationPreview, NounType, VerbType, BrainyChangeEvent, BrainyChangeEntity, BrainyChangeRelation, } from './modules/brainy/types.js';
 export type { CreateCapabilityTokenOptions, CapabilityTokenClaims, } from './modules/brainy/auth.js';
-export { createCapabilityToken, verifyCapabilityToken, } from './modules/brainy/auth.js';
 export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from './modules/brainy/errors.js';
 export type { VfsModule } from './modules/vfs/types.js';
 export type { VersionsModule } from './modules/versions/types.js';
 export type { HallModule, HallRoom, HallRoomHandle, HallRoomEvents, HallRoomHandleEvents, HallConnectionOptions, RoomOptions, ConceptInput, RecordingManifest, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, } from './modules/hall/types.js';
 export type { AuthModule, PlatformRole, SoulcraftAuthProvider, SoulcraftOrganization, SoulcraftUserFields, SoulcraftSessionUser, SoulcraftSession, OIDCClientConfig, AuthMode, } from './modules/auth/types.js';
-export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, computeEmailHash, getAuthMode, getOIDCClientConfig, } from './modules/auth/config.js';
+export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, } from './modules/auth/config.js';
 export type { AiModule, AiCompleteOptions, AiCompleteResult, AiStreamOptions, AiStreamEvent, AiToolCall, AiMessage, AiContentBlock, AiTool, AiModel, } from './modules/ai/types.js';
 export { AI_MODELS } from './modules/ai/types.js';
 export type { EventsModule, SoulcraftEventMap, SoulcraftEventName, VfsWriteEvent, VfsDeleteEvent, VfsRenameEvent, } from './modules/events/types.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,18 +1,23 @@
 /**
  * @module @soulcraft/sdk
- * @description Shared entry point for @soulcraft/sdk. Exports the createSDK factory,
- * all shared types, and re-exports from every module namespace. This entry point is
- * safe to import in any environment (server or browser).
+ * @description Shared entry point for @soulcraft/sdk. Exports all shared types and
+ * environment-agnostic constants. This entry point is safe to import in any environment
+ * (server or browser).
  *
- * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers),
- * use `@soulcraft/sdk/server`.
+ * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers,
+ * `createSDK`, `computeEmailHash`, `createCapabilityToken`, `verifyCapabilityToken`,
+ * `getAuthMode`, `getOIDCClientConfig`), use `@soulcraft/sdk/server`.
  *
- * For browser-specific exports (HTTP/WS/SSE transports, cookie auth), use
+ * For browser-specific exports (HTTP/WS/SSE transports, `createClientSDK`), use
  * `@soulcraft/sdk/client`.
  */
-export { createCapabilityToken, verifyCapabilityToken, } from './modules/brainy/auth.js';
+// createCapabilityToken and verifyCapabilityToken are server-only (node:crypto).
+// Import from @soulcraft/sdk/server.
 export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from './modules/brainy/errors.js';
-export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, computeEmailHash, getAuthMode, getOIDCClientConfig, } from './modules/auth/config.js';
+// SOULCRAFT_USER_FIELDS and SOULCRAFT_SESSION_CONFIG are pure constants — safe on shared entry.
+// computeEmailHash, getAuthMode, getOIDCClientConfig use node:crypto / process.env.
+// Import those from @soulcraft/sdk/server.
+export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, } from './modules/auth/config.js';
 export { AI_MODELS } from './modules/ai/types.js';
 export { SOULCRAFT_FORMATS } from './modules/formats/types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA8BH,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,4BAA4B,CAAA;AAuCnC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AAejC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAoFjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA8BH,iFAAiF;AACjF,qCAAqC;AACrC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,4BAA4B,CAAA;AAuCnC,gGAAgG;AAChG,oFAAoF;AACpF,2CAA2C;AAC3C,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,0BAA0B,CAAA;AAejC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAoFjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/modules/brainy/errors.d.ts

@@ -5,6 +5,8 @@
  * All errors thrown by SDK transports and handlers extend `SDKError` so callers
  * can distinguish Soulcraft-specific failures from generic `Error`s with a single
  * `instanceof` check. Machine-readable `code` fields allow programmatic handling.
+ * All errors support `{ cause }` chaining so the original underlying error is
+ * preserved when wrapping (e.g. a network TypeError inside `SDKDisconnectedError`).
  *
  * @example
  * ```typescript
@@ -24,7 +26,8 @@
 /**
  * Base class for all @soulcraft/sdk errors.
  *
- * Carries a machine-readable `code` for programmatic error handling.
+ * Carries a machine-readable `code` for programmatic error handling and optional
+ * `cause` chaining so the original underlying error is never lost when wrapping.
  * All SDK errors extend this class so callers can use a single `instanceof SDKError` check.
  */
 export declare class SDKError extends Error {
@@ -33,8 +36,9 @@ export declare class SDKError extends Error {
     /**
      * @param code - Machine-readable identifier.
      * @param message - Human-readable description.
+     * @param cause - Optional underlying error that caused this one.
      */
-    constructor(code: string, message: string);
+    constructor(code: string, message: string, cause?: unknown);
 }
 /**
  * Thrown when an RPC call is attempted while the transport is not connected.
@@ -43,7 +47,10 @@ export declare class SDKError extends Error {
  * WebSocket transport when the connection is in a disconnected or closed state.
  */
 export declare class SDKDisconnectedError extends SDKError {
-    constructor();
+    /**
+     * @param cause - Optional underlying error (e.g. a network TypeError).
+     */
+    constructor(cause?: unknown);
 }
 /**
  * Thrown when an RPC call exceeds the configured response timeout.
@@ -74,8 +81,9 @@ export declare class SDKTimeoutError extends SDKError {
 export declare class SDKAuthError extends SDKError {
     /**
      * @param detail - Optional detail appended to the error message.
+     * @param cause - Optional underlying error.
      */
-    constructor(detail?: string);
+    constructor(detail?: string, cause?: unknown);
 }
 /**
  * Thrown when the server rejects an RPC call due to insufficient permissions.
@@ -86,8 +94,9 @@ export declare class SDKAuthError extends SDKError {
 export declare class SDKForbiddenError extends SDKError {
     /**
      * @param detail - Optional detail appended to the error message.
+     * @param cause - Optional underlying error.
      */
-    constructor(detail?: string);
+    constructor(detail?: string, cause?: unknown);
 }
 /**
  * Thrown when a remote RPC call fails on the server side.
@@ -100,8 +109,9 @@ export declare class SDKRpcError extends SDKError {
     /**
      * @param serverCode - The error code returned by the server.
      * @param serverMessage - The human-readable message returned by the server.
+     * @param cause - Optional underlying error.
      */
-    constructor(serverCode: string, serverMessage: string);
+    constructor(serverCode: string, serverMessage: string, cause?: unknown);
 }
 /**
  * Thrown when a method path cannot be resolved on the target Brainy instance.

package/dist/modules/brainy/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/modules/brainy/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,wEAAwE;IACxE,SAAgB,IAAI,EAAE,MAAM,CAAA;IAE5B;;;OAGG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;;CAKjD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,8EAA8E;IAC9E,SAAgB,MAAM,EAAE,MAAM,CAAA;IAE9B;;OAEG;gBACS,MAAM,EAAE,MAAM;CAK3B;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC;;OAEG;gBACS,MAAM,CAAC,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C;;OAEG;gBACS,MAAM,CAAC,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,qEAAqE;IACrE,SAAgB,UAAU,EAAE,MAAM,CAAA;IAElC;;;OAGG;gBACS,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAKtD;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD;;OAEG;gBACS,MAAM,EAAE,MAAM;CAI3B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/modules/brainy/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,wEAAwE;IACxE,SAAgB,IAAI,EAAE,MAAM,CAAA;IAE5B;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK3D;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD;;OAEG;gBACS,KAAK,CAAC,EAAE,OAAO;CAI5B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,8EAA8E;IAC9E,SAAgB,MAAM,EAAE,MAAM,CAAA;IAE9B;;OAEG;gBACS,MAAM,EAAE,MAAM;CAK3B;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC;;;OAGG;gBACS,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C;;;OAGG;gBACS,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,qEAAqE;IACrE,SAAgB,UAAU,EAAE,MAAM,CAAA;IAElC;;;;OAIG;gBACS,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKvE;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD;;OAEG;gBACS,MAAM,EAAE,MAAM;CAI3B"}

package/dist/modules/brainy/errors.js

@@ -5,6 +5,8 @@
  * All errors thrown by SDK transports and handlers extend `SDKError` so callers
  * can distinguish Soulcraft-specific failures from generic `Error`s with a single
  * `instanceof` check. Machine-readable `code` fields allow programmatic handling.
+ * All errors support `{ cause }` chaining so the original underlying error is
+ * preserved when wrapping (e.g. a network TypeError inside `SDKDisconnectedError`).
  *
  * @example
  * ```typescript
@@ -24,7 +26,8 @@
 /**
  * Base class for all @soulcraft/sdk errors.
  *
- * Carries a machine-readable `code` for programmatic error handling.
+ * Carries a machine-readable `code` for programmatic error handling and optional
+ * `cause` chaining so the original underlying error is never lost when wrapping.
  * All SDK errors extend this class so callers can use a single `instanceof SDKError` check.
  */
 export class SDKError extends Error {
@@ -33,9 +36,10 @@ export class SDKError extends Error {
     /**
      * @param code - Machine-readable identifier.
      * @param message - Human-readable description.
+     * @param cause - Optional underlying error that caused this one.
      */
-    constructor(code, message) {
-        super(message);
+    constructor(code, message, cause) {
+        super(message, cause !== undefined ? { cause } : undefined);
         this.name = 'SDKError';
         this.code = code;
     }
@@ -47,8 +51,11 @@ export class SDKError extends Error {
  * WebSocket transport when the connection is in a disconnected or closed state.
  */
 export class SDKDisconnectedError extends SDKError {
-    constructor() {
-        super('DISCONNECTED', 'SDK: not connected to a Brainy server');
+    /**
+     * @param cause - Optional underlying error (e.g. a network TypeError).
+     */
+    constructor(cause) {
+        super('DISCONNECTED', 'SDK: not connected to a Brainy server', cause);
         this.name = 'SDKDisconnectedError';
     }
 }
@@ -85,9 +92,10 @@ export class SDKTimeoutError extends SDKError {
 export class SDKAuthError extends SDKError {
     /**
      * @param detail - Optional detail appended to the error message.
+     * @param cause - Optional underlying error.
      */
-    constructor(detail) {
-        super('UNAUTHORIZED', `SDK: authentication rejected${detail ? ` — ${detail}` : ''}`);
+    constructor(detail, cause) {
+        super('UNAUTHORIZED', `SDK: authentication rejected${detail ? ` — ${detail}` : ''}`, cause);
         this.name = 'SDKAuthError';
     }
 }
@@ -100,9 +108,10 @@ export class SDKAuthError extends SDKError {
 export class SDKForbiddenError extends SDKError {
     /**
      * @param detail - Optional detail appended to the error message.
+     * @param cause - Optional underlying error.
      */
-    constructor(detail) {
-        super('FORBIDDEN', `SDK: insufficient permissions${detail ? ` — ${detail}` : ''}`);
+    constructor(detail, cause) {
+        super('FORBIDDEN', `SDK: insufficient permissions${detail ? ` — ${detail}` : ''}`, cause);
         this.name = 'SDKForbiddenError';
     }
 }
@@ -117,9 +126,10 @@ export class SDKRpcError extends SDKError {
     /**
      * @param serverCode - The error code returned by the server.
      * @param serverMessage - The human-readable message returned by the server.
+     * @param cause - Optional underlying error.
      */
-    constructor(serverCode, serverMessage) {
-        super('RPC_ERROR', `SDK: remote error [${serverCode}] ${serverMessage}`);
+    constructor(serverCode, serverMessage, cause) {
+        super('RPC_ERROR', `SDK: remote error [${serverCode}] ${serverMessage}`, cause);
         this.name = 'SDKRpcError';
         this.serverCode = serverCode;
     }

package/dist/modules/brainy/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/modules/brainy/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,wEAAwE;IACxD,IAAI,CAAQ;IAE5B;;;OAGG;IACH,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD;QACE,KAAK,CAAC,cAAc,EAAE,uCAAuC,CAAC,CAAA;QAC9D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,8EAA8E;IAC9D,MAAM,CAAQ;IAE9B;;OAEG;IACH,YAAY,MAAc;QACxB,KAAK,CAAC,SAAS,EAAE,yBAAyB,MAAM,kBAAkB,CAAC,CAAA;QACnE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC;;OAEG;IACH,YAAY,MAAe;QACzB,KAAK,CAAC,cAAc,EAAE,+BAA+B,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACpF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C;;OAEG;IACH,YAAY,MAAe;QACzB,KAAK,CAAC,WAAW,EAAE,gCAAgC,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAClF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,qEAAqE;IACrD,UAAU,CAAQ;IAElC;;;OAGG;IACH,YAAY,UAAkB,EAAE,aAAqB;QACnD,KAAK,CAAC,WAAW,EAAE,sBAAsB,UAAU,KAAK,aAAa,EAAE,CAAC,CAAA;QACxE,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAClD;;OAEG;IACH,YAAY,MAAc;QACxB,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,MAAM,gCAAgC,CAAC,CAAA;QACjF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/modules/brainy/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,wEAAwE;IACxD,IAAI,CAAQ;IAE5B;;;;OAIG;IACH,YAAY,IAAY,EAAE,OAAe,EAAE,KAAe;QACxD,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC3D,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD;;OAEG;IACH,YAAY,KAAe;QACzB,KAAK,CAAC,cAAc,EAAE,uCAAuC,EAAE,KAAK,CAAC,CAAA;QACrE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,8EAA8E;IAC9D,MAAM,CAAQ;IAE9B;;OAEG;IACH,YAAY,MAAc;QACxB,KAAK,CAAC,SAAS,EAAE,yBAAyB,MAAM,kBAAkB,CAAC,CAAA;QACnE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC;;;OAGG;IACH,YAAY,MAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,cAAc,EAAE,+BAA+B,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;QAC3F,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C;;;OAGG;IACH,YAAY,MAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,WAAW,EAAE,gCAAgC,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;QACzF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,qEAAqE;IACrD,UAAU,CAAQ;IAElC;;;;OAIG;IACH,YAAY,UAAkB,EAAE,aAAqB,EAAE,KAAe;QACpE,KAAK,CAAC,WAAW,EAAE,sBAAsB,UAAU,KAAK,aAAa,EAAE,EAAE,KAAK,CAAC,CAAA;QAC/E,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAClD;;OAEG;IACH,YAAY,MAAc;QACxB,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,MAAM,gCAAgC,CAAC,CAAA;QACjF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF"}

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

@@ -1 +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;AAoBjE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,GAAG,MAAM,CAAA;IACjD,kCAAkC;IAClC,YAAY,CAAC,EAAE,iBAAiB,GAAG,cAAc,GAAG,QAAQ,CAAA;CAC7D;AAED;;;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;IAClC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAwBD;;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;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAE9D;;;;OAIG;IACH,QAAQ,IAAI,IAAI,CAAA;CACjB;AA8HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAe,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CA6H1E;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe;;CAE3B,CAAA"}
+{"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;AA2BjE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,GAAG,MAAM,CAAA;IACjD,kCAAkC;IAClC,YAAY,CAAC,EAAE,iBAAiB,GAAG,cAAc,GAAG,QAAQ,CAAA;CAC7D;AAED;;;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;IAClC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAwBD;;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;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAE9D;;;;OAIG;IACH,QAAQ,IAAI,IAAI,CAAA;CACjB;AA8HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAe,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CA6H1E;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe;;CAE3B,CAAA"}

package/dist/server/from-license.js

@@ -71,8 +71,15 @@ import { SDK_VERSION } from '../version.js';
 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');
+/**
+ * Returns the path to the cached config bundle.
+ *
+ * Resolved lazily at call-time so the path is always relative to the working
+ * directory at the time of the call, not at module load time.
+ */
+function getCachePath() {
+    return resolve(process.cwd(), '.soulcraft-config.json');
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // Internal helpers
 // ─────────────────────────────────────────────────────────────────────────────
@@ -105,7 +112,7 @@ async function _activate(key, product) {
  */
 function _readCache() {
     try {
-        const raw = readFileSync(CACHE_PATH, 'utf8');
+        const raw = readFileSync(getCachePath(), 'utf8');
         return JSON.parse(raw);
     }
     catch {
@@ -123,7 +130,7 @@ function _writeCache(product, response) {
             product,
             response,
         };
-        writeFileSync(CACHE_PATH, JSON.stringify(bundle, null, 2), 'utf8');
+        writeFileSync(getCachePath(), JSON.stringify(bundle, null, 2), 'utf8');
     }
     catch {
         // Non-fatal — read-only FS or permission error.