@soulcraft/sdk 1.4.12 → 1.5.1

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"}