@nurama/sdk 0.0.0-stage → 1.4.1

package/dist/routes/settings.d.ts

@@ -0,0 +1,102 @@
+import NuramaClient from '../NuramaClient.js';
+export interface ResourceSettingsOverrides {
+    emailNotifications?: {
+        sendEmailNotifications?: boolean | null;
+        newMention?: boolean | null;
+        newFollowing?: boolean | null;
+        dailySummary?: boolean | null;
+        publishedAsset?: boolean | null;
+        newMentionActiveInterval?: number | null;
+        newFollowingActiveInterval?: number | null;
+    };
+    systemNotifications?: {
+        showSystemNotifications?: boolean | null;
+        mentions?: boolean | null;
+        alerts?: boolean | null;
+        privateMessages?: boolean | null;
+    };
+    sounds?: {
+        playSounds?: boolean | null;
+        mentions?: boolean | null;
+        alerts?: boolean | null;
+        privateMessages?: boolean | null;
+    };
+}
+export interface ResourceSettings {
+    resourceId: string;
+    resourceType: 'workspace' | 'project';
+    emailNotifications?: Record<string, any>;
+    systemNotifications?: Record<string, any>;
+    sounds?: Record<string, any>;
+}
+export interface EffectiveSettings {
+    emailNotifications: Record<string, any>;
+    systemNotifications: Record<string, any>;
+    sounds: Record<string, any>;
+}
+/**
+ * Defines settings-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the settings-related methods.
+ */
+export default function createSettingsMethods(client: NuramaClient): {
+    /**
+     * Get effective (resolved) settings for a resource with full cascade.
+     * Requires authentication.
+     * @param {string} resourceType - The resource type (workspace or project).
+     * @param {string} resourceId - The resource ID.
+     * @param {string} [workspaceId] - The workspace ID (required for projects).
+     * @returns {Promise<EffectiveSettings>} The effective settings object.
+     */
+    getEffectiveSettings(resourceType: "workspace" | "project", resourceId: string, workspaceId?: string): Promise<EffectiveSettings>;
+    /**
+     * Get raw resource settings (overrides only, not cascaded).
+     * Requires authentication.
+     * @param {string} resourceType - The resource type (workspace or project).
+     * @param {string} resourceId - The resource ID.
+     * @returns {Promise<ResourceSettings | { message: string }>} The resource settings object.
+     */
+    getResourceSettings(resourceType: "workspace" | "project", resourceId: string): Promise<ResourceSettings | {
+        message: string;
+    }>;
+    /**
+     * Get all resource settings for current user.
+     * Requires authentication.
+     * @returns {Promise<{ resourceSettings: ResourceSettings[] }>} Object containing array of resource settings.
+     */
+    getAllResourceSettings(): Promise<{
+        resourceSettings: ResourceSettings[];
+    }>;
+    /**
+     * Update resource-specific settings.
+     * Requires authentication.
+     * @param {string} resourceType - The resource type (workspace or project).
+     * @param {string} resourceId - The resource ID.
+     * @param {ResourceSettingsOverrides} settings - The settings to update.
+     * @returns {Promise<{ message: string; settings: ResourceSettings }>} Success message and updated settings.
+     */
+    updateResourceSettings(resourceType: "workspace" | "project", resourceId: string, settings: ResourceSettingsOverrides): Promise<{
+        message: string;
+        settings: ResourceSettings;
+    }>;
+    /**
+     * Reset resource settings to inherit from parent/global.
+     * Requires authentication.
+     * @param {string} resourceType - The resource type (workspace or project).
+     * @param {string} resourceId - The resource ID.
+     * @returns {Promise<{ message: string }>} Success message.
+     */
+    resetResourceSettings(resourceType: "workspace" | "project", resourceId: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Cleanup orphaned settings (settings for resources user no longer has access to).
+     * Requires authentication.
+     * @returns {Promise<{ message: string; removedCount: number }>} Success message and count of removed settings.
+     */
+    cleanupOrphanedSettings(): Promise<{
+        message: string;
+        removedCount: number;
+    }>;
+};
+//# sourceMappingURL=settings.d.ts.map

package/dist/routes/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,CAAC,EAAE;QACnB,sBAAsB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACxC,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC5B,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC9B,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC9B,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAChC,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzC,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5C,CAAC;IACF,mBAAmB,CAAC,EAAE;QACpB,uBAAuB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACzC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACxB,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KAClC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC5B,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACxB,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,MAAM,EAAE,YAAY;IAE9D;;;;;;;OAOG;uCAEa,WAAW,GAAG,SAAS,cACzB,MAAM,gBACJ,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC;IAS7B;;;;;;OAMG;sCAEa,WAAW,GAAG,SAAS,cACzB,MAAM,GACjB,OAAO,CAAC,gBAAgB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQlD;;;;OAIG;8BAC6B,OAAO,CAAC;QAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;IAQjF;;;;;;;OAOG;yCAEa,WAAW,GAAG,SAAS,cACzB,MAAM,YACR,yBAAyB,GAClC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAS3D;;;;;;OAMG;wCAEa,WAAW,GAAG,SAAS,cACzB,MAAM,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ/B;;;;OAIG;+BAC8B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;EAQtF"}

package/dist/routes/settings.js

@@ -0,0 +1,94 @@
+/**
+ * Defines settings-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the settings-related methods.
+ */
+export default function createSettingsMethods(client) {
+    return {
+        /**
+         * Get effective (resolved) settings for a resource with full cascade.
+         * Requires authentication.
+         * @param {string} resourceType - The resource type (workspace or project).
+         * @param {string} resourceId - The resource ID.
+         * @param {string} [workspaceId] - The workspace ID (required for projects).
+         * @returns {Promise<EffectiveSettings>} The effective settings object.
+         */
+        async getEffectiveSettings(resourceType, resourceId, workspaceId) {
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/settings/${resourceType}/${resourceId}/effective`,
+                params: workspaceId ? { workspaceId } : undefined,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Get raw resource settings (overrides only, not cascaded).
+         * Requires authentication.
+         * @param {string} resourceType - The resource type (workspace or project).
+         * @param {string} resourceId - The resource ID.
+         * @returns {Promise<ResourceSettings | { message: string }>} The resource settings object.
+         */
+        async getResourceSettings(resourceType, resourceId) {
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/settings/${resourceType}/${resourceId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Get all resource settings for current user.
+         * Requires authentication.
+         * @returns {Promise<{ resourceSettings: ResourceSettings[] }>} Object containing array of resource settings.
+         */
+        async getAllResourceSettings() {
+            return client._request({
+                method: 'GET',
+                endpoint: '/v1/settings',
+                sendJWT: true,
+            });
+        },
+        /**
+         * Update resource-specific settings.
+         * Requires authentication.
+         * @param {string} resourceType - The resource type (workspace or project).
+         * @param {string} resourceId - The resource ID.
+         * @param {ResourceSettingsOverrides} settings - The settings to update.
+         * @returns {Promise<{ message: string; settings: ResourceSettings }>} Success message and updated settings.
+         */
+        async updateResourceSettings(resourceType, resourceId, settings) {
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/settings/${resourceType}/${resourceId}`,
+                body: settings,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Reset resource settings to inherit from parent/global.
+         * Requires authentication.
+         * @param {string} resourceType - The resource type (workspace or project).
+         * @param {string} resourceId - The resource ID.
+         * @returns {Promise<{ message: string }>} Success message.
+         */
+        async resetResourceSettings(resourceType, resourceId) {
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/settings/${resourceType}/${resourceId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Cleanup orphaned settings (settings for resources user no longer has access to).
+         * Requires authentication.
+         * @returns {Promise<{ message: string; removedCount: number }>} Success message and count of removed settings.
+         */
+        async cleanupOrphanedSettings() {
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/settings/cleanup',
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/routes/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":"AAwCA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,MAAoB;IAChE,OAAO;QACL;;;;;;;WAOG;QACH,KAAK,CAAC,oBAAoB,CACxB,YAAqC,EACrC,UAAkB,EAClB,WAAoB;YAEpB,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,gBAAgB,YAAY,IAAI,UAAU,YAAY;gBAChE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;gBACjD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;WAMG;QACH,KAAK,CAAC,mBAAmB,CACvB,YAAqC,EACrC,UAAkB;YAElB,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,gBAAgB,YAAY,IAAI,UAAU,EAAE;gBACtD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,sBAAsB;YAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,cAAc;gBACxB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;;WAOG;QACH,KAAK,CAAC,sBAAsB,CAC1B,YAAqC,EACrC,UAAkB,EAClB,QAAmC;YAEnC,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,gBAAgB,YAAY,IAAI,UAAU,EAAE;gBACtD,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;WAMG;QACH,KAAK,CAAC,qBAAqB,CACzB,YAAqC,EACrC,UAAkB;YAElB,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,gBAAgB,YAAY,IAAI,UAAU,EAAE;gBACtD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,uBAAuB;YAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,sBAAsB;gBAChC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/shortlink.d.ts

@@ -0,0 +1,79 @@
+import NuramaClient from '../NuramaClient.js';
+export interface ResolveShortLinkResponse {
+    deepLink: string;
+    resourceId: string;
+    resourceType: 'asset' | 'project' | 'workspace' | 'chatMessage' | 'chatSubmission';
+    visibility: 'creator' | 'reviewer' | null;
+}
+export interface ResolvePublicDownloadResponse {
+    token: string;
+    fileName: string;
+    mediaType: string;
+    status: string;
+    /**
+     * Capability mode of the link. The download page uses this to decide
+     * whether to render the inline preview (`embed-download`), the embed-only
+     * message (`embed`), or auto-download (`download`). Optional for backward
+     * compatibility with older API versions; treat absence as `embed-download`.
+     */
+    mode?: 'download' | 'embed' | 'embed-download';
+    /** Mime type of the original media file, when known. */
+    mimeType?: string | null;
+    /**
+     * For image assets: the keyPath of the image file, used to render an
+     * inline preview on the download page. Null for non-image assets (video /
+     * audio previews are iframed from the embed page; files render an icon).
+     */
+    previewKeyPath?: string | null;
+}
+export interface PublicDownloadUrlResponse {
+    url: string;
+    fileName: string;
+    mimeType: string;
+    expires: number;
+}
+export interface PublicEmbedFilesResponse {
+    fileName: string;
+    mediaType: 'video' | 'audio' | 'image' | 'file' | string;
+    /**
+     * Mode of the underlying public link: 'embed' (no download) or 'embed-download'
+     * (download allowed alongside embed). 'download' never appears — that mode
+     * blocks the embed-files endpoint entirely. Optional for backward compatibility
+     * with older API versions; treat absence as 'embed-download'.
+     */
+    mode?: 'embed' | 'embed-download';
+    /** HLS manifest keyPath (e.g. "workspaces/.../stream/index.m3u8"), null if not yet processed. */
+    streamKeyPath: string | null;
+    /** Original media keyPath used as fallback when no HLS manifest is available. */
+    mediaKeyPath: string | null;
+    /** Poster image keyPath for video assets (explicit poster, falling back to largest thumbnail). Null when none exists. */
+    posterKeyPath: string | null;
+    /** Pre-computed waveform peaks JSON keyPath for audio assets. Null for video / when no peaks file exists. */
+    waveformKeyPath?: string | null;
+    /**
+     * Timeline-thumbnail geometry (`asset.meta.storyboard`) for a video's filmstrip and
+     * hover preview. Null for non-video assets or video without storyboard sheets.
+     * Optional for backward compatibility with older API versions.
+     */
+    storyboard?: Record<string, unknown> | null;
+    /** The storyboard sheet files matching `storyboard.sheets`. Empty when there's no storyboard. */
+    storyboardFiles?: Array<{
+        name?: string;
+        keyPath: string;
+    }>;
+}
+/**
+ * Defines short link related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the short link related methods.
+ */
+export default function createShortLinkMethods(client: NuramaClient): {
+    /**
+     * Resolves a short link code to its full deep link path.
+     * This endpoint is publicly accessible and does not require authentication.
+     * @param {string} code - The 8-character alphanumeric short link code.
+     * @returns {Promise<ResolveShortLinkResponse>} The resolved deep link information.
+     */
+    resolveShortLink(code: string): Promise<ResolveShortLinkResponse>;
+};
+//# sourceMappingURL=shortlink.d.ts.map

package/dist/routes/shortlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortlink.d.ts","sourceRoot":"","sources":["../../src/routes/shortlink.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAG9C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACnF,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,gBAAgB,CAAC;IAC/C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACzD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAClC,iGAAiG;IACjG,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iFAAiF;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yHAAyH;IACzH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6GAA6G;IAC7G,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,iGAAiG;IACjG,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAM,EAAE,YAAY;IAE/D;;;;;OAKG;2BAC0B,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;EAS1E"}

package/dist/routes/shortlink.js

@@ -0,0 +1,25 @@
+/**
+ * Defines short link related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the short link related methods.
+ */
+export default function createShortLinkMethods(client) {
+    return {
+        /**
+         * Resolves a short link code to its full deep link path.
+         * This endpoint is publicly accessible and does not require authentication.
+         * @param {string} code - The 8-character alphanumeric short link code.
+         * @returns {Promise<ResolveShortLinkResponse>} The resolved deep link information.
+         */
+        async resolveShortLink(code) {
+            if (!code)
+                throw new Error('code is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/shortlink/${code}`,
+                sendJWT: false,
+            });
+        },
+    };
+}
+//# sourceMappingURL=shortlink.js.map

package/dist/routes/shortlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortlink.js","sourceRoot":"","sources":["../../src/routes/shortlink.ts"],"names":[],"mappings":"AAmEA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAoB;IACjE,OAAO;QACL;;;;;WAKG;QACH,KAAK,CAAC,gBAAgB,CAAC,IAAY;YACjC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC,QAAQ,CAA2B;gBAC/C,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,iBAAiB,IAAI,EAAE;gBACjC,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/socket.d.ts

@@ -0,0 +1,108 @@
+import NuramaClient from '../NuramaClient.js';
+export interface SocketInterface {
+    connected: boolean;
+    on: (event: string, listener: (...args: any[]) => void) => void;
+    off: (event: string) => void;
+    disconnect: () => void;
+    emit: (event: string, ...args: any[]) => void;
+    timeout: (ms: number) => {
+        emit: (event: string, ...args: any[]) => void;
+    };
+}
+export interface BaseNotificationEvent {
+    type: string;
+    initiatorId: string | null;
+    initiatorType: 'user' | 'system';
+    initiator: any | null;
+    resourceId: string;
+    resourceType: string;
+    channels: string[];
+    createdAt: string;
+    tokens?: Record<string, any>;
+    changes?: {
+        create?: Array<{
+            resourceId: string;
+            resourceType: string;
+            resource: any;
+        }>;
+        update?: Array<{
+            resourceId: string;
+            resourceType: string;
+            resource: any;
+            oldResource?: any;
+            newResource?: any;
+        }>;
+        delete?: Array<{
+            resourceId: string;
+            resourceType: string;
+        }>;
+    };
+}
+export interface SocketOptions {
+    /**
+     * Automatically handle token refresh
+     * @default true
+     */
+    autoRefresh?: boolean;
+    /**
+     * Automatically reconnect if connection is lost
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Automatically attempt to reconnect if token expires
+     * @default true
+     */
+    autoReconnectOnTokenExpiry?: boolean;
+    /**
+     * Debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Override the WebSocket URL for this specific connection
+     * Takes precedence over the client's websocketURL option
+     */
+    websocketURL?: string;
+}
+export interface PublicSocketOptions {
+    /**
+     * Automatically reconnect if connection is lost
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Override the WebSocket URL for this specific connection
+     * Takes precedence over the client's websocketURL option
+     */
+    websocketURL?: string;
+}
+export interface SocketChannel {
+    /** Socket.IO instance */
+    socket: SocketInterface;
+    /** Channel path */
+    channel: string;
+    /** Event listeners */
+    listeners: Record<string, Set<(event: any) => void>>;
+}
+export default function createSocketMethods(client: NuramaClient): {
+    connect: (channel: string, options?: SocketOptions) => Promise<SocketChannel>;
+    connectPublic: (publicToken: string, options?: PublicSocketOptions) => Promise<SocketChannel>;
+    disconnect: (channel: string) => Promise<void>;
+    disconnectAll: () => Promise<void>;
+    subscribe: <T = BaseNotificationEvent>(channel: string, event: string, callback: (event: T) => void) => Promise<void>;
+    subscribePublic: <T = BaseNotificationEvent>(publicToken: string, event: string, callback: (event: T) => void) => Promise<void>;
+    unsubscribe: (channel: string, event: string, callback?: (event: any) => void) => void;
+    isConnected: (channel: string) => boolean;
+    emit: (channel: string, event: string, data?: unknown) => void;
+    emitWithAck: (channel: string, event: string, data: unknown, timeoutMs: number) => Promise<boolean>;
+    onReconnect: (channel: string, callback: (event?: unknown) => void) => void;
+    onReconnectFailed: (channel: string, callback: () => void) => void;
+};
+export type SocketMethods = ReturnType<typeof createSocketMethods>;
+//# sourceMappingURL=socket.d.ts.map

package/dist/routes/socket.d.ts.map

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