@nurama/sdk 0.0.0-stage → 1.4.1

package/dist/routes/task.js

@@ -0,0 +1,284 @@
+export default function createTaskMethods(client) {
+    return {
+        /**
+             * Retrieves tasks assigned to the currently authenticated user.
+             * Supports filtering, sorting, and both index and cursor pagination.
+             * @param {GetTasksParams} [params] - Optional query parameters for filtering, sorting, and pagination.
+             * @returns {Promise<GetTasksResponse>} Paginated list of tasks.
+             */
+        async getMyTasks(params) {
+            return client._request({
+                method: 'GET',
+                endpoint: '/v1/tasks/',
+                params: params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Bulk-create one or more tasks under a single project — single
+         * round-trip replacement for the per-draft create loop the
+         * EnhancedTaskCreatorModal used to drive. Per-task partial success
+         * is returned in `results[]`; if `announce` is set and at least
+         * one task creates, the server also posts a Nu reply linking the
+         * new tasks back to the source message and rendering them as
+         * inline taskCards.
+         */
+        async bulkCreate(data) {
+            if (!data?.projectId)
+                throw new Error('projectId is required.');
+            if (!Array.isArray(data?.tasks) || data.tasks.length === 0) {
+                throw new Error('tasks is required and must contain at least one draft.');
+            }
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/tasks/bulk-create',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+             * Updates the status of a specific task.
+             * Requires authentication and permission.
+             * @param {string} taskId - The ID of the task to update.
+             * @param {UpdateTaskStatusData} data - The new status for the task.
+             * @returns {Promise<Task>} The updated task object.
+             */
+        async updateTaskStatus(taskId, data) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!data || !data.status)
+                throw new Error('status is required in the request body.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/${taskId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+             * Toggles the acknowledgement status of a specific task.
+             * Requires authentication and permission.
+             * @param {string} taskId - The ID of the task to acknowledge/unacknowledge.
+             * @returns {Promise<Task>} The updated task object with the new acknowledgement status.
+             */
+        async acknowledgeTask(taskId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/acknowledge/${taskId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+             * Retrieves the count of unacknowledged tasks for the current user within a specific project.
+             * Requires authentication.
+             * @param {string} projectId - The ID of the project.
+             * @returns {Promise<UnacknowledgedTaskCountResponse>} An object containing total, creator, and reviewer unacknowledged task counts.
+             */
+        async getUnacknowledgedTaskCount(projectId) {
+            if (!projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/tasks/unacknowledged/${projectId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+             * Acknowledge every unacknowledged mention-task the current user has in a
+             * project. Idempotent server-side.
+             * @param {string} projectId - The ID of the project.
+             * @returns {Promise<AcknowledgeAllTasksResponse>} The number acknowledged and the remaining unacknowledged count.
+             */
+        async acknowledgeAllTasks(projectId) {
+            if (!projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/acknowledge-all/${projectId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Add the calling user to a task's `followers` list.
+         * Idempotent server-side — following an already-followed task is a no-op
+         * and still returns the current task.
+         * @param taskId - The ID of the task to follow.
+         * @returns The updated task with the new followers array.
+         */
+        async followTask(taskId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/${taskId}/follow`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Remove the calling user from a task's `followers` list.
+         * Idempotent server-side — unfollowing a task you don't follow is a
+         * no-op and still returns the current task.
+         * @param taskId - The ID of the task to unfollow.
+         * @returns The updated task with the new followers array.
+         */
+        async unfollowTask(taskId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/${taskId}/unfollow`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Permanently delete a task. Gated server-side by
+         * `canRemove{Visibility}BoardTask` for at least one of the parent
+         * board's visibility tiers (see `boardPermission('Remove', 'BoardTask')`).
+         *
+         * Returns void; the server responds with 204 No Content.
+         *
+         * @param taskId - The ID of the task to delete.
+         */
+        async deleteTask(taskId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/tasks/${taskId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Retrieves the event log for a specific task.
+         * Returns paginated events in reverse chronological order with populated actor info.
+         * @param {string} taskId - The ID of the task.
+         * @param {GetTaskEventsParams} [params] - Optional pagination, sort, search, and filter params.
+         * @returns {Promise<GetTaskEventsResponse>} Paginated list of task events.
+         */
+        async getTaskEvents(taskId, params) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/tasks/${taskId}/events`,
+                params,
+                sendJWT: true,
+            });
+        },
+        // ========================================================================
+        // Task details, links and tags
+        // ========================================================================
+        /**
+         * Update a board task's subject, description, assignee or status.
+         * Requires the boards capability and board-task write permission.
+         * @param {string} taskId - The task ID.
+         * @param {UpdateTaskDetailsData} data - Fields to change.
+         * @returns {Promise<Task>} The updated task.
+         * @throws {Error} 'taskId is required.' when `taskId` is falsy.
+         */
+        async updateTaskDetails(taskId, data) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/${taskId}/details`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Link two tasks with a typed relation (related, blocks, blockedBy, duplicate).
+         * The link is symmetrical: both tasks reflect the relationship.
+         * @param {string} taskId - The task ID.
+         * @param {LinkTaskData} data - `linkedTaskId` and `type`.
+         * @returns {Promise<TaskLink>} The created link.
+         * @throws {Error} 'taskId is required.' or 'linkedTaskId is required.'.
+         */
+        async linkTask(taskId, data) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!data.linkedTaskId)
+                throw new Error('linkedTaskId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/tasks/${taskId}/links`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Remove a task-to-task link.
+         * @param {string} taskId - The task ID.
+         * @param {string} linkedTaskId - The other task in the link.
+         * @returns {Promise<void>} Resolves once removed.
+         * @throws {Error} 'taskId is required.' or 'linkedTaskId is required.'.
+         */
+        async unlinkTask(taskId, linkedTaskId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!linkedTaskId)
+                throw new Error('linkedTaskId is required.');
+            await client._request({
+                method: 'DELETE',
+                endpoint: `/v1/tasks/${taskId}/links/${linkedTaskId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List the tasks linked to a task, with the relation type of each link.
+         * @param {string} taskId - The task ID.
+         * @returns {Promise<TaskLink[]>} The task's links.
+         * @throws {Error} 'taskId is required.' when `taskId` is falsy.
+         */
+        async getTaskLinks(taskId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/tasks/${taskId}/links`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Attach a project tag to a task.
+         * @param {string} taskId - The task ID.
+         * @param {string} tagId - The tag ID.
+         * @returns {Promise<Task>} The updated task.
+         * @throws {Error} 'taskId is required.' or 'tagId is required.'.
+         */
+        async tagTask(taskId, tagId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!tagId)
+                throw new Error('tagId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/${taskId}/tag`,
+                body: { tagId },
+                sendJWT: true,
+            });
+        },
+        /**
+         * Detach a project tag from a task.
+         * @param {string} taskId - The task ID.
+         * @param {string} tagId - The tag ID.
+         * @returns {Promise<Task>} The updated task.
+         * @throws {Error} 'taskId is required.' or 'tagId is required.'.
+         */
+        async untagTask(taskId, tagId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!tagId)
+                throw new Error('tagId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tasks/${taskId}/untag`,
+                body: { tagId },
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=task.js.map

package/dist/routes/task.js.map

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

package/dist/routes/taskRelation.d.ts

@@ -0,0 +1,80 @@
+import NuramaClient from '../NuramaClient.js';
+export type RelationResourceType = 'chat' | 'chatMessage';
+export interface TaskRelation {
+    id: string;
+    taskId: string;
+    resourceId: string;
+    resourceType: RelationResourceType;
+    creatorId: string;
+    createdAt: string;
+    relatedBy?: any;
+    chat?: {
+        id: string;
+        topicId: string;
+        topicType: string;
+        visibility: string;
+        chatType: string;
+        subject?: string | null;
+        publicId?: string | null;
+    } | null;
+    asset?: any | null;
+    submission?: {
+        id: string;
+        name: string;
+    } | null;
+    publicLink?: {
+        id: string;
+        name: string;
+    } | null;
+    message?: {
+        id: string;
+        chatId: string;
+        content: string | null;
+        authorId: string | null;
+        author: any;
+        mentions: string[];
+        assetMentions: string[];
+        folderMentions: string[];
+        createdAt: string;
+    } | null;
+}
+export interface PaginatedTaskRelations {
+    results: TaskRelation[];
+    page: number;
+    limit: number;
+    totalPages: number;
+    totalResults: number;
+    hasNextPage?: boolean;
+    hasPrevPage?: boolean;
+}
+export default function createTaskRelationMethods(client: NuramaClient): {
+    /**
+     * List the relations attached to a task — chat messages, chats, or
+     * other resources that reference this task as context.
+     */
+    getTaskRelations(taskId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedTaskRelations>;
+    /**
+     * Attach a related resource (chat message, chat, etc.) to a task,
+     * so the task surface shows the originating context.
+     */
+    createTaskRelation(taskId: string, data: {
+        resourceId: string;
+        resourceType: RelationResourceType;
+    }): Promise<TaskRelation>;
+    /** Detach a related resource from a task. */
+    deleteTaskRelation(taskId: string, relationId: string): Promise<void>;
+    /** List task relations referencing a chat (reverse lookup). */
+    getRelationsForChat(chatId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedTaskRelations>;
+    /** List task relations referencing a specific chat message (reverse lookup). */
+    getRelationsForMessage(messageId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedTaskRelations>;
+};
+//# sourceMappingURL=taskRelation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskRelation.d.ts","sourceRoot":"","sources":["../../src/routes/taskRelation.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,aAAa,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,GAAG,CAAC;QACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,MAAM,EAAE,YAAY;IAElE;;;OAGG;6BAEO,MAAM,WACL;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,sBAAsB,CAAC;IAUlC;;;OAGG;+BAEO,MAAM,QACR;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,oBAAoB,CAAA;KAAE,GAC/D,OAAO,CAAC,YAAY,CAAC;IAYxB,6CAA6C;+BACZ,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E,+DAA+D;gCAErD,MAAM,WACL;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,sBAAsB,CAAC;IAUlC,gFAAgF;sCAEnE,MAAM,WACR;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,sBAAsB,CAAC;EAUrC"}

package/dist/routes/taskRelation.js

@@ -0,0 +1,71 @@
+export default function createTaskRelationMethods(client) {
+    return {
+        /**
+         * List the relations attached to a task — chat messages, chats, or
+         * other resources that reference this task as context.
+         */
+        async getTaskRelations(taskId, params) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/tasks/${taskId}/relations`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Attach a related resource (chat message, chat, etc.) to a task,
+         * so the task surface shows the originating context.
+         */
+        async createTaskRelation(taskId, data) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!data?.resourceId)
+                throw new Error('resourceId is required.');
+            if (!data?.resourceType)
+                throw new Error('resourceType is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/tasks/${taskId}/relations`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** Detach a related resource from a task. */
+        async deleteTaskRelation(taskId, relationId) {
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!relationId)
+                throw new Error('relationId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/tasks/${taskId}/relations/${relationId}`,
+                sendJWT: true,
+            });
+        },
+        /** List task relations referencing a chat (reverse lookup). */
+        async getRelationsForChat(chatId, params) {
+            if (!chatId)
+                throw new Error('chatId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/chats/${chatId}/relations`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /** List task relations referencing a specific chat message (reverse lookup). */
+        async getRelationsForMessage(messageId, params) {
+            if (!messageId)
+                throw new Error('messageId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/chat-messages/${messageId}/relations`,
+                params,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=taskRelation.js.map

package/dist/routes/taskRelation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskRelation.js","sourceRoot":"","sources":["../../src/routes/taskRelation.ts"],"names":[],"mappings":"AA+CA,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,MAAoB;IACpE,OAAO;QACL;;;WAGG;QACH,KAAK,CAAC,gBAAgB,CACpB,MAAc,EACd,MAA0C;YAE1C,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC,QAAQ,CAAyB;gBAC7C,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,aAAa,MAAM,YAAY;gBACzC,MAAM;gBACN,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,kBAAkB,CACtB,MAAc,EACd,IAAgE;YAEhE,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACpD,IAAI,CAAC,IAAI,EAAE,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAClE,IAAI,CAAC,IAAI,EAAE,YAAY;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACtE,OAAO,MAAM,CAAC,QAAQ,CAAe;gBACnC,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,aAAa,MAAM,YAAY;gBACzC,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,6CAA6C;QAC7C,KAAK,CAAC,kBAAkB,CAAC,MAAc,EAAE,UAAkB;YACzD,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC,QAAQ,CAAO;gBAC3B,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,aAAa,MAAM,cAAc,UAAU,EAAE;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,+DAA+D;QAC/D,KAAK,CAAC,mBAAmB,CACvB,MAAc,EACd,MAA0C;YAE1C,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC,QAAQ,CAAyB;gBAC7C,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,aAAa,MAAM,YAAY;gBACzC,MAAM;gBACN,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,gFAAgF;QAChF,KAAK,CAAC,sBAAsB,CAC1B,SAAiB,EACjB,MAA0C;YAE1C,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,QAAQ,CAAyB;gBAC7C,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,qBAAqB,SAAS,YAAY;gBACpD,MAAM;gBACN,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/token.d.ts

@@ -0,0 +1,97 @@
+import NuramaClient from '../NuramaClient.js';
+/**
+ * Personal Access Token kinds. v1 only mints `pat`; the rest are
+ * reserved for the future OAuth grant flow and are listed here so
+ * downstream code can switch on the kind without importing a server-
+ * side enum.
+ */
+export type TokenKind = 'pat' | 'oauthAccess' | 'oauthRefresh' | 'botAccess';
+/**
+ * Granted action verbs on a token. Mirrors the backend's
+ * `@config/tokenScopes` registry; adding a scope on the BE means
+ * adding it here too (or callers fall back to `string` when they
+ * accept arbitrary scopes from configuration).
+ */
+export type TokenScope = 'chat:read' | 'chat:write' | 'tasks:read' | 'tasks:write' | 'assets:read' | 'assets:write' | 'projects:read' | 'projects:write' | 'workspaces:read' | 'workspaces:write' | 'convos:read' | 'convos:write' | 'notifications:read' | 'notifications:write' | 'ai:use';
+/**
+ * The shape returned by `listTokens` and (without the `token` field)
+ * the metadata half of `createToken`. Never includes the raw secret —
+ * that is shown exactly once at creation time and is the caller's
+ * responsibility to capture.
+ */
+export interface TokenSummary {
+    id: string;
+    name: string;
+    prefix: string;
+    scopes: TokenScope[];
+    kind: TokenKind;
+    lastUsed?: string | null;
+    expiresAt?: string | null;
+    createdAt: string;
+}
+export interface CreateTokenData {
+    /** Customer-facing label. 1–80 characters. */
+    name: string;
+    /** At least one scope. Validated against the backend registry. */
+    scopes: TokenScope[];
+    /** Optional ISO date. Null / omitted = non-expiring. */
+    expiresAt?: string | null;
+}
+export interface UpdateTokenScopesData {
+    /**
+     * The COMPLETE new scope set, not a delta — the same shape
+     * `createToken` takes, so what a token may do is always stated in
+     * full rather than accumulated through edits nobody can review.
+     * At least one scope.
+     */
+    scopes: TokenScope[];
+}
+export interface CreateTokenResponse extends TokenSummary {
+    /**
+     * The raw secret. Returned ONLY in this response. The server keeps a
+     * one-way hash and cannot recover this value — the customer must
+     * capture it immediately (typical pattern: reveal-once modal with a
+     * copy button).
+     */
+    token: string;
+}
+/**
+ * Personal Access Token surface — auth-gated, owner-scoped. Any
+ * logged-in user can mint, list, and revoke their own tokens; there
+ * is no admin-on-behalf surface here (admins managing bot keys do
+ * that via the `bot` methods).
+ */
+export default function createTokenMethods(client: NuramaClient): {
+    /**
+     * Mint a new Personal Access Token for the calling user.
+     * The raw secret is in the response's `token` field — store it
+     * immediately, it cannot be retrieved again.
+     */
+    createToken(data: CreateTokenData): Promise<CreateTokenResponse>;
+    /**
+     * List the caller's Personal Access Tokens. Bot-access keys held
+     * by the same user (rare but possible — admin who's also a bot
+     * owner) are filtered out server-side and surface via the bot
+     * management screens instead.
+     */
+    listTokens(): Promise<TokenSummary[]>;
+    /**
+     * Replace the scopes on one of the caller's Personal Access Tokens.
+     *
+     * `scopes` is the complete new set, not a delta. This exists because
+     * the scope registry grows over time: a token minted before a scope
+     * existed cannot hold it, and without this the only remedy is minting
+     * a replacement and reconfiguring everywhere the old one is used.
+     *
+     * The change takes effect on the token's very next request. Scopes
+     * remain a ceiling, never a floor — widening a token never lets it do
+     * anything its owner cannot already do.
+     */
+    updateTokenScopes(tokenId: string, data: UpdateTokenScopesData): Promise<TokenSummary>;
+    /**
+     * Revoke one of the caller's Personal Access Tokens. The revocation
+     * is immediate — the token will return 401 on the very next request.
+     */
+    deleteToken(tokenId: string): Promise<void>;
+};
+//# sourceMappingURL=token.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/routes/token.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,aAAa,GACb,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,qBAAqB,GACrB,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,MAAM,EAAE,YAAY;IAE3D;;;;OAIG;sBACqB,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAStE;;;;;OAKG;kBACiB,OAAO,CAAC,YAAY,EAAE,CAAC;IAS3C;;;;;;;;;;;OAWG;+BAC8B,MAAM,QAAQ,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAU5F;;;OAGG;yBACwB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EASpD"}

package/dist/routes/token.js

@@ -0,0 +1,73 @@
+/**
+ * Personal Access Token surface — auth-gated, owner-scoped. Any
+ * logged-in user can mint, list, and revoke their own tokens; there
+ * is no admin-on-behalf surface here (admins managing bot keys do
+ * that via the `bot` methods).
+ */
+export default function createTokenMethods(client) {
+    return {
+        /**
+         * Mint a new Personal Access Token for the calling user.
+         * The raw secret is in the response's `token` field — store it
+         * immediately, it cannot be retrieved again.
+         */
+        async createToken(data) {
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/tokens',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List the caller's Personal Access Tokens. Bot-access keys held
+         * by the same user (rare but possible — admin who's also a bot
+         * owner) are filtered out server-side and surface via the bot
+         * management screens instead.
+         */
+        async listTokens() {
+            return client._request({
+                method: 'GET',
+                endpoint: '/v1/tokens',
+                sendJWT: true,
+                bypassCache: true,
+            });
+        },
+        /**
+         * Replace the scopes on one of the caller's Personal Access Tokens.
+         *
+         * `scopes` is the complete new set, not a delta. This exists because
+         * the scope registry grows over time: a token minted before a scope
+         * existed cannot hold it, and without this the only remedy is minting
+         * a replacement and reconfiguring everywhere the old one is used.
+         *
+         * The change takes effect on the token's very next request. Scopes
+         * remain a ceiling, never a floor — widening a token never lets it do
+         * anything its owner cannot already do.
+         */
+        async updateTokenScopes(tokenId, data) {
+            if (!tokenId)
+                throw new Error('tokenId is required.');
+            return client._request({
+                method: 'PATCH',
+                endpoint: `/v1/tokens/${tokenId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Revoke one of the caller's Personal Access Tokens. The revocation
+         * is immediate — the token will return 401 on the very next request.
+         */
+        async deleteToken(tokenId) {
+            if (!tokenId)
+                throw new Error('tokenId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/tokens/${tokenId}`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=token.js.map

package/dist/routes/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/routes/token.ts"],"names":[],"mappings":"AA+EA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,MAAoB;IAC7D,OAAO;QACL;;;;WAIG;QACH,KAAK,CAAC,WAAW,CAAC,IAAqB;YACrC,OAAO,MAAM,CAAC,QAAQ,CAAsB;gBAC1C,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,YAAY;gBACtB,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,UAAU;YACd,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,YAAY;gBACtB,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED;;;;;;;;;;;WAWG;QACH,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,IAA2B;YAClE,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,QAAQ,CAAe;gBACnC,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,cAAc,OAAO,EAAE;gBACjC,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,WAAW,CAAC,OAAe;YAC/B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,QAAQ,CAAO;gBAC3B,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,cAAc,OAAO,EAAE;gBACjC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}