@nurama/sdk 0.0.0-stage → 1.4.0

package/dist/routes/webhook.js

@@ -0,0 +1,173 @@
+/**
+ * Outbound webhook subscription management. Admin-gated server-side
+ * by `canManageWebhooks`. All operations are workspace-scoped — there
+ * is no app-owned surface here yet (Phase 3 / OAuth).
+ */
+export default function createWebhookMethods(client) {
+    return {
+        /**
+         * Create a webhook subscription. The signing secret is in the
+         * response's `secret` field — store it immediately, it cannot be
+         * retrieved again.
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async createWebhook(workspaceId, data) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List webhook subscriptions in a workspace. Secrets are never returned.
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async listWebhooks(workspaceId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks`,
+                sendJWT: true,
+                bypassCache: true,
+            });
+        },
+        /**
+         * Fetch a single webhook subscription by id.
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async getWebhook(workspaceId, webhookId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!webhookId)
+                throw new Error('webhookId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks/${webhookId}`,
+                sendJWT: true,
+                bypassCache: true,
+            });
+        },
+        /**
+         * Update a webhook subscription's url, event filter, or active state.
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async updateWebhook(workspaceId, webhookId, data) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!webhookId)
+                throw new Error('webhookId is required.');
+            return client._request({
+                method: 'PATCH',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks/${webhookId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Delete a webhook subscription. In-flight deliveries continue to
+         * the receiver until they exhaust retries; no new deliveries fire.
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async deleteWebhook(workspaceId, webhookId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!webhookId)
+                throw new Error('webhookId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks/${webhookId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Generate a new HMAC signing secret for a subscription and return
+         * it once. The old secret is invalidated immediately.
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async rotateWebhookSecret(workspaceId, webhookId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!webhookId)
+                throw new Error('webhookId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks/${webhookId}/rotate-secret`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Fire a synthetic `webhook.test` delivery to the subscription's
+         * URL. The receiver gets a small payload they can use to verify
+         * their HMAC + parsing setup. Returns immediately; check the
+         * delivery log for the outcome.
+         */
+        async testWebhook(workspaceId, webhookId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!webhookId)
+                throw new Error('webhookId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks/${webhookId}/test`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Paginated list of delivery attempts for a webhook subscription.
+         * Useful for diagnosing failures (HTTP status, response body snippet,
+         * retry timing).
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async listWebhookDeliveries(workspaceId, webhookId, params = {}) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!webhookId)
+                throw new Error('webhookId is required.');
+            const search = new URLSearchParams();
+            if (params.limit !== undefined)
+                search.set('limit', String(params.limit));
+            if (params.cursor !== undefined)
+                search.set('cursor', params.cursor);
+            if (params.status !== undefined)
+                search.set('status', params.status);
+            const qs = search.toString();
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks/${webhookId}/deliveries${qs ? `?${qs}` : ''}`,
+                sendJWT: true,
+                bypassCache: true,
+            });
+        },
+        /**
+         * Re-fire a specific past delivery attempt. Useful for confirming a
+         * receiver fix without waiting for the next real event.
+         *
+         * @requires `canManageWebhooks` on the workspace.
+         */
+        async replayWebhookDelivery(workspaceId, webhookId, attemptId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!webhookId)
+                throw new Error('webhookId is required.');
+            if (!attemptId)
+                throw new Error('attemptId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/workspaces/${workspaceId}/webhooks/${webhookId}/deliveries/${attemptId}/replay`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/routes/webhook.js.map

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

package/dist/routes/workspace.d.ts

@@ -0,0 +1,120 @@
+import NuramaClient from '../NuramaClient.js';
+export interface CreateWorkspaceData {
+    name: string;
+    description?: string;
+}
+export interface UpdateWorkspaceData {
+    name?: string;
+    description?: string;
+    updateSlug?: boolean;
+}
+export interface FileData {
+    name: string;
+    checksum: string;
+    sizeInMB: number;
+}
+export interface SortParams {
+    [key: string]: 1 | -1;
+}
+/**
+ * Defines workspace-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the workspace methods.
+ */
+export default function createWorkspaceMethods(client: NuramaClient): {
+    /**
+     * Creates a new workspace.
+     * Requires authentication.
+     * @param data - Workspace data.
+     * @returns {Promise<object>} The created workspace object.
+     */
+    createWorkspace(data: CreateWorkspaceData): Promise<any>;
+    /**
+     * Retrieves a specific workspace by its ID.
+     * Requires authentication.
+     * @param {string} workspaceId - The ID of the workspace to retrieve.
+     * @returns {Promise<object>} The workspace object.
+     */
+    getWorkspace(workspaceId: string): Promise<any>;
+    /**
+     * Lists all workspaces the authenticated user has access to.
+     * Requires authentication.
+     * @param {object} [sortParams] - Optional sorting. Keys are field names (`id`, `name`, `createdAt`, `updatedAt`);
+     *   values are 1 for ascending or -1 for descending. Sent as `?sort[name]=1&sort[createdAt]=-1`.
+     * @returns {Promise<Array<object>>} Workspaces with the caller's `roles` and the workspace `capabilities`.
+     */
+    listWorkspaces(sortParams?: SortParams): Promise<any[]>;
+    /**
+     * Request signed URL data to upload a workspace logo.
+     * Caller then multipart-uploads the file using the returned `signedUrlData`
+     * and calls `client.asset.completeUpload(...)` to finalize.
+     *
+     * @param {string} fileData.checksum - The MD5 checksum.
+     * @param {number} fileData.sizeInMB - The file size in MB.
+     * @returns {Promise<object>} Response containing signed URL data and workspace info.
+     */
+    createLogo(workspaceId: string, fileData: FileData): Promise<any>;
+    /**
+     * Request signed URL data to replace the workspace logo. Same upload
+     * shape as `createLogo`; existing logo is replaced once `completeUpload`
+     * lands.
+     *
+     * @param {string} fileData.checksum - The MD5 checksum.
+     * @param {number} fileData.sizeInMB - The file size in MB.
+     * @returns {Promise<object>} Response containing signed URL data and workspace info.
+     */
+    updateLogo(workspaceId: string, fileData: FileData): Promise<any>;
+    /**
+     * Request signed URL data to upload a workspace icon (the small square
+     * shown in sidebars and tabs — distinct from the logo).
+     *
+     * @param {string} fileData.checksum - The MD5 checksum.
+     * @param {number} fileData.sizeInMB - The file size in MB.
+     * @returns {Promise<object>} Response containing signed URL data and workspace info.
+     */
+    createIcon(workspaceId: string, fileData: FileData): Promise<any>;
+    /**
+     * Request signed URL data to replace the workspace icon. Same upload
+     * shape as `createIcon`.
+     *
+     * @param {string} fileData.checksum - The MD5 checksum.
+     * @param {number} fileData.sizeInMB - The file size in MB.
+     * @returns {Promise<object>} Response containing signed URL data and workspace info.
+     */
+    updateIcon(workspaceId: string, fileData: FileData): Promise<any>;
+    /**
+     * List the projects inside a workspace that the calling user has
+     * access to.
+     *
+     * @param {string} workspaceId - The ID of the workspace.
+     * @returns {Promise<Array<object>>} An array of project objects.
+     */
+    listProjects(workspaceId: string): Promise<any[]>;
+    /**
+     * Update workspace metadata (name, description, etc.).
+     *
+     * @param {boolean} [updateData.updateSlug] - Whether to update the slug based on the new name.
+     * @returns {Promise<object>} The updated workspace object.
+     */
+    updateWorkspace(workspaceId: string, updateData: UpdateWorkspaceData): Promise<any>;
+    /**
+     * Soft-delete a workspace. All nested resources (projects, chats,
+     * assets) become inaccessible; bytes are reclaimed by the cleanup
+     * cron.
+     *
+     * @param {string} workspaceId - The ID of the workspace to delete.
+     * @returns {Promise<object>} Object confirming the status change.
+     */
+    deleteWorkspace(workspaceId: string): Promise<any>;
+    /**
+     * Toggle a single workspace boolean setting (e.g. an `enableX` feature
+     * flag).
+     *
+     * @param {string} workspaceId - The ID of the workspace.
+     * @param {string} settingName - The name of the setting.
+     * @param {boolean} value - The new value for the setting.
+     * @returns {Promise<object>} The updated workspace object with new settings.
+     */
+    updateSetting(workspaceId: string, settingName: string, value: boolean): Promise<any>;
+};
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/routes/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAG9C,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAM,EAAE,YAAY;IAG/D;;;;;OAKG;0BACyB,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC;IAS9D;;;;;OAKG;8BAC6B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASrD;;;;;;OAMG;gCAC8B,UAAU,GAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IASjE;;;;;;;;OAQG;4BAC2B,MAAM,YAAY,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAUvE;;;;;;;;OAQG;4BAC2B,MAAM,YAAY,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAUvE;;;;;;;OAOG;4BAC2B,MAAM,YAAY,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAUvE;;;;;;;OAOG;4BAC2B,MAAM,YAAY,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAUvE;;;;;;OAMG;8BAC6B,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IASvD;;;;;OAKG;iCACgC,MAAM,cAAc,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC;IAUzF;;;;;;;OAOG;iCACgC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASxD;;;;;;;;OAQG;+BAC8B,MAAM,eAAe,MAAM,SAAS,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;EAY9F"}

package/dist/routes/workspace.js

@@ -0,0 +1,199 @@
+/**
+ * Defines workspace-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the workspace methods.
+ */
+export default function createWorkspaceMethods(client) {
+    // Specify return type more accurately if possible, using WorkspaceMethods interface
+    return {
+        /**
+         * Creates a new workspace.
+         * Requires authentication.
+         * @param data - Workspace data.
+         * @returns {Promise<object>} The created workspace object.
+         */
+        async createWorkspace(data) {
+            return client._request({
+                endpoint: '/v1/workspaces',
+                method: 'POST',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Retrieves a specific workspace by its ID.
+         * Requires authentication.
+         * @param {string} workspaceId - The ID of the workspace to retrieve.
+         * @returns {Promise<object>} The workspace object.
+         */
+        async getWorkspace(workspaceId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}`,
+                method: 'GET',
+                sendJWT: true,
+            });
+        },
+        /**
+         * Lists all workspaces the authenticated user has access to.
+         * Requires authentication.
+         * @param {object} [sortParams] - Optional sorting. Keys are field names (`id`, `name`, `createdAt`, `updatedAt`);
+         *   values are 1 for ascending or -1 for descending. Sent as `?sort[name]=1&sort[createdAt]=-1`.
+         * @returns {Promise<Array<object>>} Workspaces with the caller's `roles` and the workspace `capabilities`.
+         */
+        async listWorkspaces(sortParams = {}) {
+            return client._request({
+                endpoint: '/v1/workspaces',
+                method: 'GET',
+                params: Object.keys(sortParams).length > 0 ? { sort: sortParams } : undefined,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Request signed URL data to upload a workspace logo.
+         * Caller then multipart-uploads the file using the returned `signedUrlData`
+         * and calls `client.asset.completeUpload(...)` to finalize.
+         *
+         * @param {string} fileData.checksum - The MD5 checksum.
+         * @param {number} fileData.sizeInMB - The file size in MB.
+         * @returns {Promise<object>} Response containing signed URL data and workspace info.
+         */
+        async createLogo(workspaceId, fileData) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}/logo`,
+                method: 'POST',
+                body: fileData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Request signed URL data to replace the workspace logo. Same upload
+         * shape as `createLogo`; existing logo is replaced once `completeUpload`
+         * lands.
+         *
+         * @param {string} fileData.checksum - The MD5 checksum.
+         * @param {number} fileData.sizeInMB - The file size in MB.
+         * @returns {Promise<object>} Response containing signed URL data and workspace info.
+         */
+        async updateLogo(workspaceId, fileData) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}/logo`,
+                method: 'PUT',
+                body: fileData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Request signed URL data to upload a workspace icon (the small square
+         * shown in sidebars and tabs — distinct from the logo).
+         *
+         * @param {string} fileData.checksum - The MD5 checksum.
+         * @param {number} fileData.sizeInMB - The file size in MB.
+         * @returns {Promise<object>} Response containing signed URL data and workspace info.
+         */
+        async createIcon(workspaceId, fileData) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}/icon`,
+                method: 'POST',
+                body: fileData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Request signed URL data to replace the workspace icon. Same upload
+         * shape as `createIcon`.
+         *
+         * @param {string} fileData.checksum - The MD5 checksum.
+         * @param {number} fileData.sizeInMB - The file size in MB.
+         * @returns {Promise<object>} Response containing signed URL data and workspace info.
+         */
+        async updateIcon(workspaceId, fileData) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}/icon`,
+                method: 'PUT',
+                body: fileData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List the projects inside a workspace that the calling user has
+         * access to.
+         *
+         * @param {string} workspaceId - The ID of the workspace.
+         * @returns {Promise<Array<object>>} An array of project objects.
+         */
+        async listProjects(workspaceId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}/projects`,
+                method: 'GET',
+                sendJWT: true,
+            });
+        },
+        /**
+         * Update workspace metadata (name, description, etc.).
+         *
+         * @param {boolean} [updateData.updateSlug] - Whether to update the slug based on the new name.
+         * @returns {Promise<object>} The updated workspace object.
+         */
+        async updateWorkspace(workspaceId, updateData) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}`,
+                method: 'PUT',
+                body: updateData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Soft-delete a workspace. All nested resources (projects, chats,
+         * assets) become inaccessible; bytes are reclaimed by the cleanup
+         * cron.
+         *
+         * @param {string} workspaceId - The ID of the workspace to delete.
+         * @returns {Promise<object>} Object confirming the status change.
+         */
+        async deleteWorkspace(workspaceId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}`,
+                method: 'DELETE',
+                sendJWT: true,
+            });
+        },
+        /**
+         * Toggle a single workspace boolean setting (e.g. an `enableX` feature
+         * flag).
+         *
+         * @param {string} workspaceId - The ID of the workspace.
+         * @param {string} settingName - The name of the setting.
+         * @param {boolean} value - The new value for the setting.
+         * @returns {Promise<object>} The updated workspace object with new settings.
+         */
+        async updateSetting(workspaceId, settingName, value) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!settingName)
+                throw new Error('settingName is required.');
+            return client._request({
+                endpoint: `/v1/workspaces/${workspaceId}/settings/${settingName}`,
+                method: 'PUT',
+                body: { value },
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/routes/workspace.js.map

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

package/dist/utils/uploadSessionManager.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Upload Session Manager for Nurama SDK
+ *
+ * Provides upload progress persistence and cross-tab synchronization
+ * - Persists upload progress to localStorage with project isolation
+ * - Syncs upload state across multiple browser tabs
+ * - Automatic cleanup of completed/failed uploads
+ */
+export interface UploadSessionData {
+    sessionId: string;
+    projectId: string;
+    uploadId: string;
+    key: string;
+    assetId?: string;
+    progress: number;
+    partNumber: number;
+    totalParts: number;
+    completedParts: number[];
+    fileName: string;
+    fileSize: number;
+    timestamp: number;
+    status: 'uploading' | 'completing' | 'completed' | 'failed' | 'cancelled';
+    error?: string;
+}
+export interface CrossTabMessage {
+    type: 'upload_progress_update' | 'upload_status_change' | 'upload_cleanup';
+    projectId: string;
+    sessionId: string;
+    data?: Partial<UploadSessionData>;
+}
+export declare class UploadSessionManager {
+    private static instance;
+    private messageListeners;
+    private readonly STORAGE_PREFIX;
+    private readonly MESSAGE_CHANNEL;
+    private broadcastChannel?;
+    constructor();
+    static getInstance(): UploadSessionManager;
+    /**
+     * Initialize cross-tab synchronization using BroadcastChannel
+     */
+    private initializeCrossTabSync;
+    /**
+     * Handle cross-tab messages
+     */
+    private handleCrossTabMessage;
+    /**
+     * Generate storage key for upload session
+     */
+    private getStorageKey;
+    /**
+     * Create a new upload session
+     */
+    createSession(projectId: string, sessionId: string, uploadData: {
+        uploadId: string;
+        key: string;
+        fileName: string;
+        fileSize: number;
+        totalParts: number;
+        assetId?: string;
+    }): UploadSessionData;
+    /**
+     * Update upload progress for a session
+     */
+    updateProgress(projectId: string, sessionId: string, progress: {
+        progress: number;
+        partNumber: number;
+        completedParts?: number[];
+    }): void;
+    /**
+     * Update upload status
+     */
+    updateStatus(projectId: string, sessionId: string, status: UploadSessionData['status'], error?: string): void;
+    /**
+     * Get upload session data
+     */
+    getSession(projectId: string, sessionId: string): UploadSessionData | null;
+    /**
+     * Get all upload sessions for a project
+     */
+    getProjectSessions(projectId: string): UploadSessionData[];
+    /**
+     * Get every upload session across ALL projects (scans the whole localStorage
+     * prefix, not a single project). Used by app-level guards that need a global
+     * "is anything uploading right now" answer without knowing the project id.
+     */
+    getAllSessions(): UploadSessionData[];
+    /**
+     * True when at least one upload is genuinely in flight anywhere in the app.
+     *
+     * "In flight" = status `uploading`/`completing` AND updated within `staleMs`.
+     * The freshness window matters: a tab that crashed mid-upload leaves an
+     * `uploading` row in localStorage forever (it never reaches a terminal
+     * status). Progress ticks bump `timestamp` on every part, so a real upload
+     * stays fresh; a dead one goes stale and stops counting — otherwise a stale
+     * row would block app refreshes/navigation indefinitely.
+     *
+     * @param staleMs How long since the last progress update still counts as
+     *   active. Default 2 minutes — comfortably longer than a single part PUT on
+     *   a slow connection, short enough that a crashed upload clears quickly.
+     */
+    hasActiveUploads(staleMs?: number): boolean;
+    /**
+     * Save session to localStorage
+     */
+    private saveSession;
+    /**
+     * Remove upload session
+     */
+    removeSession(projectId: string, sessionId: string): void;
+    /**
+     * Clean up old or completed sessions
+     */
+    cleanupSessions(projectId: string, olderThanMs?: number): void;
+    /**
+     * Register a listener for cross-tab messages
+     */
+    onMessage(listenerId: string, callback: (message: CrossTabMessage) => void): void;
+    /**
+     * Unregister a message listener
+     */
+    offMessage(listenerId: string): void;
+    /**
+     * Broadcast a message to other tabs
+     */
+    private broadcastMessage;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+export declare const uploadSessionManager: UploadSessionManager;
+//# sourceMappingURL=uploadSessionManager.d.ts.map

package/dist/utils/uploadSessionManager.d.ts.map

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