@soulcraft/sdk 1.0.0 → 1.2.0

package/dist/modules/hall/types.d.ts

@@ -1,56 +1,527 @@
 /**
  * @module modules/hall/types
- * @description Hall module types for @soulcraft/sdk.
+ * @description Types for the sdk.hall namespace — the Soulcraft real-time communication layer.
  *
- * Re-exports the full public API surface of @soulcraft/hall (HallServer, Room, and all
- * supporting types) so consumers only need to import from @soulcraft/sdk.
+ * Hall is a standalone Rust server at `hall.soulcraft.com`. It handles WebRTC SFU
+ * (video/audio/data channels), in-process Whisper ASR transcription, BERT concept
+ * matching, RFC 6464 speaker detection, and per-track MKV recording.
  *
- * The HallModule interface defines the sdk.hall namespace exposed on SoulcraftSDK.
- * Hall is server-only — the HallServer runs in-process with the product backend,
- * and the SDK provides handler factories that products mount as WebSocket routes.
+ * The `sdk.hall` namespace has two faces depending on context:
  *
- * @see createHallRoomHandler in @soulcraft/sdk/server for the signaling handler.
- * @see @soulcraft/hall for the NAPI implementation.
+ * **Server mode** (`@soulcraft/sdk/server`) — the product backend (Academy, Workshop, Venue)
+ * connects to Hall with a shared secret, creates rooms, and mints short-lived session tokens.
+ * Use `createHallModule(options)` from `@soulcraft/sdk/server`.
+ *
+ * **Client mode** (`@soulcraft/sdk/client`) — a browser kit app joins a room using a session
+ * token issued by the product backend. Use `HallRoomClient` from `@soulcraft/sdk/client`.
+ *
+ * Products never pass their shared secret to the browser. The token is the only browser credential.
+ */
+/**
+ * Options for the server-side Hall connection (product backend → Hall server).
+ */
+export interface HallConnectionOptions {
+    /** WebSocket URL of the Hall server (e.g. `"wss://hall.soulcraft.com"`). */
+    url: string;
+    /**
+     * Product name as configured in `[auth.products]` in `hall.toml`.
+     * e.g. `"academy"`, `"workshop"`, `"venue"`.
+     */
+    productName: string;
+    /**
+     * Shared secret for this product, set via `HALL_<PRODUCT>_SECRET` env var.
+     * Must match the value in `[auth.products.<productName>]` in `hall.toml`.
+     * Never expose this to browsers.
+     */
+    secret: string;
+    /**
+     * Milliseconds to wait before a reconnect attempt after an unexpected disconnect.
+     * Set to 0 to disable auto-reconnect. Default: 2000.
+     */
+    reconnectDelayMs?: number;
+}
+/**
+ * A workspace concept node passed to Hall for in-process BERT concept matching.
+ * Hall embeds concept names and detects mentions in the Whisper transcript.
+ */
+export interface ConceptInput {
+    /** Brainy entity ID of the concept node. */
+    nodeId: string;
+    /** Human-readable concept name (embedded for BERT similarity matching). */
+    name: string;
+    /** Brainy NounType (e.g. `"skill"`, `"concept"`, `"process"`). */
+    nounType: string;
+    /** Kit-defined subtype, if any. */
+    subtype?: string;
+}
+/** Options for creating a room. All fields are optional with safe defaults. */
+export interface RoomOptions {
+    /** Maximum peers before the SFU stops accepting new connections (default: 30). */
+    maxPeers?: number;
+    /**
+     * Enable in-process Whisper ASR transcription and BERT concept matching.
+     * Default: true. Disable to reduce CPU usage when transcription is not needed.
+     */
+    enableTranscription?: boolean;
+    /** Enable per-track MKV recording to disk (default: false). */
+    enableRecording?: boolean;
+    /** Brainy entity ID this room is associated with (e.g. cohort or session entity ID). */
+    entityId?: string;
+    /**
+     * Workspace concept nodes for in-process BERT concept matching.
+     * Pass an empty array to disable concept matching while keeping transcription.
+     */
+    concepts?: ConceptInput[];
+}
+/**
+ * Manifest emitted when recording stops.
+ * Contains absolute local file paths on the Hall server's disk.
+ * The product is responsible for uploading these files to object storage.
+ */
+export interface RecordingManifest {
+    /** Session UUID assigned by Hall. */
+    sessionId: string;
+    /** Unix timestamp (ms) when recording started. */
+    startedAt: number;
+    /** Unix timestamp (ms) when recording stopped. */
+    endedAt: number;
+    /** Absolute paths to per-participant Opus audio track MKV files. */
+    audioTracks: string[];
+    /** Absolute paths to per-participant video track MKV files. */
+    videoTracks: string[];
+}
+/** A Whisper ASR transcript segment from a peer in the room. */
+export interface TranscriptEvent {
+    roomId: string;
+    peerId: string;
+    /** The transcribed text. May be a partial result if `isFinal` is false. */
+    text: string;
+    /** Offset from session start in milliseconds. */
+    sessionMs: number;
+    /** True when the ASR model has committed this segment. False for interim results. */
+    isFinal: boolean;
+}
+/** A BERT concept mention detected in the Whisper transcript. */
+export interface ConceptMentionEvent {
+    roomId: string;
+    peerId: string;
+    /** Brainy entity ID of the matched concept node. */
+    nodeId: string;
+    nounType: string;
+    subtype?: string;
+    /** How the concept was referenced (e.g. `"define"`, `"apply"`, `"question"`). */
+    verbType: string;
+    /** BERT cosine similarity score (0–1). */
+    confidence: number;
+    /** The transcript excerpt that triggered the match. */
+    text: string;
+    sessionMs: number;
+}
+/** An inferred subject–verb–object relation proposed for review. */
+export interface RelationProposedEvent {
+    roomId: string;
+    peerId: string;
+    fromNodeId: string;
+    verbType: string;
+    toNodeId: string;
+    /** Confidence score (0–1). */
+    confidence: number;
+    /** The transcript excerpt that triggered the inference. */
+    text: string;
+    sessionMs: number;
+}
+/** The active speaker changed. Uses RFC 6464 audio level detection. */
+export interface SpeakerChangedEvent {
+    roomId: string;
+    /** Peer ID of the new active speaker. */
+    peerId: string;
+}
+/** A new peer joined the room. */
+export interface PeerJoinedEvent {
+    roomId: string;
+    peerId: string;
+}
+/** A peer left or was disconnected from the room. */
+export interface PeerLeftEvent {
+    roomId: string;
+    peerId: string;
+}
+/**
+ * Messages sent from the product backend to the Hall server over the product WebSocket.
+ * Encoded as msgpack with `t` (type tag) and `d` (data) fields — matching Rust serde
+ * `tag/content` encoding.
+ *
+ * @internal Used by HallClient. Not part of the public sdk.hall API surface.
  */
-export type { HallConfig, RoomOptions, RecordingManifest, ConceptEvent, RelationProposedEvent, AttentionEvent, RoomEventMap, } from '@soulcraft/hall';
-export type { Room, HallServer } from '@soulcraft/hall';
+export type HallClientMessage = {
+    t: 'authProduct';
+    d: {
+        productName: string;
+        secret: string;
+    };
+} | {
+    t: 'createRoom';
+    d: {
+        roomId: string;
+        options: RoomOptions;
+    };
+} | {
+    t: 'closeRoom';
+    d: {
+        roomId: string;
+    };
+} | {
+    t: 'listRooms';
+    d: Record<string, never>;
+} | {
+    t: 'createSessionToken';
+    d: {
+        roomId: string;
+        peerId: string;
+        ttlSecs?: number | undefined;
+    };
+} | {
+    t: 'startRecording';
+    d: {
+        roomId: string;
+    };
+} | {
+    t: 'stopRecording';
+    d: {
+        roomId: string;
+    };
+} | {
+    t: 'sendData';
+    d: {
+        roomId: string;
+        channel: string;
+        payload: Uint8Array;
+    };
+};
+/**
+ * Messages sent from the Hall server to the product backend.
+ * Decoded from msgpack binary frames.
+ *
+ * @internal Used by HallClient. Not part of the public sdk.hall API surface.
+ */
+export type HallServerMessage = {
+    t: 'authOk';
+    d: {
+        productName: string;
+    };
+} | {
+    t: 'authFailed';
+    d: {
+        reason: string;
+    };
+} | {
+    t: 'roomCreated';
+    d: {
+        roomId: string;
+        sessionId: string;
+    };
+} | {
+    t: 'roomClosed';
+    d: {
+        roomId: string;
+    };
+} | {
+    t: 'roomList';
+    d: {
+        roomIds: string[];
+    };
+} | {
+    t: 'sessionToken';
+    d: {
+        token: string;
+        expiresAt: number;
+    };
+} | {
+    t: 'recordingStarted';
+    d: {
+        roomId: string;
+    };
+} | {
+    t: 'recordingManifest';
+    d: {
+        roomId: string;
+        manifest: RecordingManifest;
+    };
+} | {
+    t: 'dataSent';
+    d: {
+        roomId: string;
+    };
+} | {
+    t: 'error';
+    d: {
+        code: string;
+        message: string;
+    };
+} | {
+    t: 'transcript';
+    d: TranscriptEvent;
+} | {
+    t: 'conceptMention';
+    d: ConceptMentionEvent;
+} | {
+    t: 'relationProposed';
+    d: RelationProposedEvent;
+} | {
+    t: 'speakerChanged';
+    d: SpeakerChangedEvent;
+} | {
+    t: 'peerJoined';
+    d: PeerJoinedEvent;
+} | {
+    t: 'peerLeft';
+    d: PeerLeftEvent;
+};
+/** Event map for server-side {@link HallRoom} listeners. */
+export interface HallRoomEvents {
+    transcript: TranscriptEvent;
+    conceptMention: ConceptMentionEvent;
+    relationProposed: RelationProposedEvent;
+    speakerChanged: SpeakerChangedEvent;
+    peerJoined: PeerJoinedEvent;
+    peerLeft: PeerLeftEvent;
+    recordingManifest: RecordingManifest;
+    closed: {
+        roomId: string;
+    };
+}
 /**
- * @description The sdk.hall namespace on SoulcraftSDK (server mode only).
+ * The `sdk.hall` namespace on `SoulcraftSDK` in **server mode**.
  *
- * Provides access to the running HallServer instance and room management utilities.
- * In server mode, the SDK manages one HallServer per process. Products call
- * createRoom/getRoom directly, then mount the signaling handler returned by
- * createHallRoomHandler() at their WebSocket route.
+ * Products call these methods in request handlers to create rooms and issue session
+ * tokens that browser clients use to join. Rooms are managed by the Hall server;
+ * the product only holds a control-plane connection over WebSocket.
+ *
+ * Obtain via `createHallModule(options)` from `@soulcraft/sdk/server`.
+ *
+ * @example Academy lesson handler
+ * ```typescript
+ * import { createHallModule } from '@soulcraft/sdk/server'
+ *
+ * const hall = createHallModule({
+ *   url: process.env.HALL_URL!,
+ *   productName: 'academy',
+ *   secret: process.env.HALL_ACADEMY_SECRET!,
+ * })
+ * await hall.connect()
+ *
+ * app.post('/api/lessons/:id/join', requireAuth, async (c) => {
+ *   const { id } = c.req.param()
+ *   const user = c.get('user')!
+ *   await hall.createRoom(id, {
+ *     enableTranscription: true,
+ *     concepts: await loadConcepts(id),
+ *   })
+ *   const { token } = await hall.createSessionToken(id, user.id, 3600)
+ *   return c.json({ token, hallUrl: process.env.HALL_URL })
+ * })
+ * ```
  */
 export interface HallModule {
     /**
-     * Creates a new room with the given ID and options. Errors if a room with the
-     * same ID already exists — check with getRoom() first.
-     * @param roomId - Unique room identifier (e.g. Brainy session entity ID).
-     * @param options - Room creation options (max peers, transcription, recording, etc.).
-     * @returns The Room instance, ready for peer connections.
+     * Connects to the Hall server and authenticates with the product shared secret.
+     * Must be called once at startup before any other method.
+     *
+     * @throws {Error} If auth fails or the connection cannot be established.
      */
-    createRoom(roomId: string, options: import('@soulcraft/hall').RoomOptions): Promise<import('@soulcraft/hall').Room>;
+    connect(): Promise<void>;
     /**
-     * Returns an existing room by ID, or null if it does not exist.
-     * @param roomId - The room ID to look up.
-     * @returns The Room or null.
+     * Creates a new room. Errors if a room with the same ID already exists.
+     *
+     * @param roomId - Unique room identifier (e.g. Brainy session entity ID).
+     * @param options - Room options: peer limit, transcription, recording, concept list.
+     * @returns The HallRoom handle — register event listeners on it immediately.
      */
-    getRoom(roomId: string): Promise<import('@soulcraft/hall').Room | null>;
+    createRoom(roomId: string, options?: RoomOptions): Promise<HallRoom>;
     /**
-     * Close a specific room and disconnect all its peers.
-     * @param roomId - The room ID to close.
+     * Closes a room and disconnects all its peers.
+     *
+     * @param roomId - The room ID passed to `createRoom`.
      */
     closeRoom(roomId: string): Promise<void>;
     /**
-     * Return IDs of all currently active rooms.
+     * Returns the IDs of all active rooms managed by this Hall connection.
+     *
      * @returns Array of room ID strings.
      */
-    roomIds(): Promise<string[]>;
+    listRooms(): Promise<string[]>;
+    /**
+     * Returns an active room handle by ID, or `undefined` if not found.
+     *
+     * @param roomId - The room ID passed to `createRoom`.
+     */
+    getRoom(roomId: string): HallRoom | undefined;
+    /**
+     * Mints a short-lived session token for a browser client.
+     * Pass `{ token, hallUrl }` to the browser — never the product secret.
+     *
+     * @param roomId - The room the browser will join.
+     * @param peerId - The peer's unique identifier (e.g. authenticated user ID).
+     * @param ttlSecs - Token lifetime in seconds (default: 300).
+     * @returns `{ token, expiresAt }`.
+     */
+    createSessionToken(roomId: string, peerId: string, ttlSecs?: number): Promise<{
+        token: string;
+        expiresAt: number;
+    }>;
+    /**
+     * Starts per-track MKV recording for an active room.
+     * The room emits `recordingManifest` when `stopRecording` is called.
+     *
+     * @param roomId - The room to start recording.
+     */
+    startRecording(roomId: string): Promise<void>;
+    /**
+     * Stops recording. Hall writes track files to disk and emits `recordingManifest`
+     * on the room with absolute paths to the recorded files.
+     *
+     * @param roomId - The room to stop recording.
+     */
+    stopRecording(roomId: string): Promise<void>;
+    /**
+     * Registers a listener for unexpected disconnects (not triggered by `close()`).
+     *
+     * @param listener - Called with a human-readable disconnect reason.
+     */
+    onDisconnect(listener: (reason: string) => void): void;
+    /**
+     * Registers a listener for successful reconnections.
+     * On reconnect, rooms from before the disconnect are gone — re-create them.
+     */
+    onReconnect(listener: () => void): void;
     /**
-     * Shuts down the Hall server and all active rooms, releasing NAPI resources.
-     * Called automatically by sdk.shutdown() in server mode.
+     * Gracefully closes the Hall connection and releases resources.
+     * Called automatically by `sdk.shutdown()` in server mode.
      */
     close(): Promise<void>;
 }
+/**
+ * A handle for a live Hall room, returned by `sdk.hall.createRoom()`.
+ *
+ * Register event listeners immediately after creation — events can arrive before
+ * `createRoom` resolves if peers connect rapidly.
+ *
+ * @example
+ * ```typescript
+ * const room = await hall.createRoom('cohort-123', { enableTranscription: true })
+ * room.on('transcript', (t) => console.log(`${t.peerId}: ${t.text}`))
+ * room.on('conceptMention', (c) => brain.relate({ from: c.peerId, to: c.nodeId }))
+ * room.on('peerJoined', (p) => updatePresence(p.peerId, 'joined'))
+ * ```
+ */
+export interface HallRoom {
+    /** The room's entity ID (same as passed to `createRoom`). */
+    readonly roomId: string;
+    /** The session UUID assigned by Hall for this room instance. */
+    readonly sessionId: string;
+    /**
+     * Register a listener for a room event.
+     *
+     * @param event - The event name.
+     * @param listener - Callback invoked with the typed event payload.
+     * @returns `this` for chaining.
+     */
+    on<K extends keyof HallRoomEvents>(event: K, listener: (data: HallRoomEvents[K]) => void): this;
+    /**
+     * Remove a previously registered listener.
+     *
+     * @param event - The event name.
+     * @param listener - The exact function reference passed to `on`.
+     */
+    off<K extends keyof HallRoomEvents>(event: K, listener: (data: HallRoomEvents[K]) => void): this;
+}
+/**
+ * Events emitted by a `HallRoomHandle` in the browser.
+ */
+export interface HallRoomHandleEvents {
+    /** A Whisper ASR transcript segment from any peer in the room. */
+    transcript: TranscriptEvent;
+    /** A BERT concept mention detected in the transcript. */
+    conceptMention: ConceptMentionEvent;
+    /** An inferred subject–verb–object relation proposed for review. */
+    relationProposed: RelationProposedEvent;
+    /** The active speaker changed. */
+    speakerChanged: SpeakerChangedEvent;
+    /** A new peer joined the room. */
+    peerJoined: PeerJoinedEvent;
+    /** A peer left the room. */
+    peerLeft: PeerLeftEvent;
+    /** A remote media track became available — render it in a `<video>` or `<audio>` element. */
+    trackAdded: {
+        peerId: string;
+        track: MediaStreamTrack;
+        streams: readonly MediaStream[];
+    };
+    /** A remote media track was removed. */
+    trackRemoved: {
+        peerId: string;
+        track: MediaStreamTrack;
+    };
+    /** The Hall server closed the room. */
+    closed: {
+        roomId: string;
+    };
+    /** A WebRTC or signaling error occurred. */
+    error: {
+        message: string;
+    };
+}
+/**
+ * An active WebRTC peer connection to a Hall room, returned by `joinHallRoom()`.
+ *
+ * Wraps an `RTCPeerConnection` and the Hall signaling WebSocket. Emits AI events
+ * (transcript, conceptMention, relationProposed) alongside media track events
+ * so kit apps have a single event surface for the full session experience.
+ *
+ * @example
+ * ```typescript
+ * const room = await joinHallRoom({ token, hallUrl: 'wss://hall.soulcraft.com' })
+ * room.addStream(await navigator.mediaDevices.getUserMedia({ video: true, audio: true }))
+ *
+ * room.on('trackAdded', ({ peerId, streams }) => {
+ *   document.getElementById(`video-${peerId}`).srcObject = streams[0]
+ * })
+ * room.on('transcript', ({ peerId, text, isFinal }) => {
+ *   if (isFinal) appendTranscript(peerId, text)
+ * })
+ * room.on('conceptMention', ({ nodeId, confidence }) => pulseGraphNode(nodeId, confidence))
+ * ```
+ */
+export interface HallRoomHandle {
+    /** The room ID this peer has joined. */
+    readonly roomId: string;
+    /** The peer ID for this connection (decoded from the session token). */
+    readonly peerId: string;
+    /**
+     * Register a listener for a room event.
+     *
+     * @param event - The event name.
+     * @param listener - Callback invoked with the typed event payload.
+     */
+    on<K extends keyof HallRoomHandleEvents>(event: K, listener: (data: HallRoomHandleEvents[K]) => void): this;
+    /**
+     * Remove a previously registered listener.
+     *
+     * @param event - The event name.
+     * @param listener - The exact function reference passed to `on`.
+     */
+    off<K extends keyof HallRoomHandleEvents>(event: K, listener: (data: HallRoomHandleEvents[K]) => void): this;
+    /**
+     * Adds a local media stream to the peer connection.
+     * Call this before or shortly after `joinHallRoom` returns.
+     *
+     * @param stream - The MediaStream from `navigator.mediaDevices.getUserMedia()`.
+     */
+    addStream(stream: MediaStream): void;
+    /**
+     * Disconnects the WebRTC peer connection and the signaling WebSocket.
+     * Always call this when the user leaves the session.
+     */
+    close(): void;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/modules/hall/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/hall/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,YAAY,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAA;AAExB,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,iBAAiB,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,IAAI,CAAC,CAAA;IAEnH;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAC,CAAA;IAEvE;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE5B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/hall/types.ts"],"names":[],"mappings":"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"}

package/dist/modules/hall/types.js

@@ -1,16 +1,21 @@
 /**
  * @module modules/hall/types
- * @description Hall module types for @soulcraft/sdk.
+ * @description Types for the sdk.hall namespace — the Soulcraft real-time communication layer.
  *
- * Re-exports the full public API surface of @soulcraft/hall (HallServer, Room, and all
- * supporting types) so consumers only need to import from @soulcraft/sdk.
+ * Hall is a standalone Rust server at `hall.soulcraft.com`. It handles WebRTC SFU
+ * (video/audio/data channels), in-process Whisper ASR transcription, BERT concept
+ * matching, RFC 6464 speaker detection, and per-track MKV recording.
  *
- * The HallModule interface defines the sdk.hall namespace exposed on SoulcraftSDK.
- * Hall is server-only — the HallServer runs in-process with the product backend,
- * and the SDK provides handler factories that products mount as WebSocket routes.
+ * The `sdk.hall` namespace has two faces depending on context:
  *
- * @see createHallRoomHandler in @soulcraft/sdk/server for the signaling handler.
- * @see @soulcraft/hall for the NAPI implementation.
+ * **Server mode** (`@soulcraft/sdk/server`) — the product backend (Academy, Workshop, Venue)
+ * connects to Hall with a shared secret, creates rooms, and mints short-lived session tokens.
+ * Use `createHallModule(options)` from `@soulcraft/sdk/server`.
+ *
+ * **Client mode** (`@soulcraft/sdk/client`) — a browser kit app joins a room using a session
+ * token issued by the product backend. Use `HallRoomClient` from `@soulcraft/sdk/client`.
+ *
+ * Products never pass their shared secret to the browser. The token is the only browser credential.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/modules/hall/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/hall/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/hall/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

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

@@ -0,0 +1,41 @@
+/**
+ * @module kits
+ * @description Factory for sdk.kits.* — the Soulcraft kit registry module.
+ *
+ * Provides read-only access to kit configurations from the `@soulcraft/kits`
+ * package. The package is an optional peer dependency loaded lazily via
+ * `createRequire` so that the SDK compiles and runs without it installed;
+ * calls gracefully return `null` / empty array when it is absent.
+ *
+ * The factory accepts an optional `bundledRegistry` override (used in tests)
+ * to inject a mock registry without needing the real package.
+ *
+ * @example
+ * ```typescript
+ * import { createKitsModule } from '@soulcraft/sdk/server'
+ *
+ * const kits = createKitsModule()
+ * const kit = await kits.load('wicks-and-whiskers')
+ * console.log(kit?.name) // "Wicks & Whiskers"
+ * ```
+ */
+import type { KitsModule, CreateKitsModuleOptions } from './types.js';
+/**
+ * Create the `sdk.kits.*` module.
+ *
+ * @param options - Optional overrides, primarily for testing.
+ * @returns A `KitsModule` backed by the `@soulcraft/kits` registry.
+ *
+ * @example
+ * ```typescript
+ * // In production:
+ * const kits = createKitsModule()
+ *
+ * // In tests — inject a mock registry to avoid the peer dep:
+ * const kits = createKitsModule({
+ *   bundledRegistry: { 'test-kit': { id: 'test-kit', name: 'Test Kit', ... } }
+ * })
+ * ```
+ */
+export declare function createKitsModule(options?: CreateKitsModuleOptions): KitsModule;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/kits/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAsB,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AA8BzF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAkBlF"}