@nurama/sdk 0.0.0-stage → 1.4.1

package/dist/routes/board.d.ts

@@ -0,0 +1,187 @@
+import NuramaClient from '../NuramaClient.js';
+import { type Board, type BoardColumn, type BoardWithTasks, type Task } from '@nurama/types';
+export interface CreateBoardData {
+    projectId: string;
+    name: string;
+    description?: string;
+    visibility?: ('creator' | 'reviewer')[];
+    columns?: {
+        name: string;
+        description?: string;
+        color?: string;
+        isDefault?: boolean;
+        taskStatus?: 'pending' | 'inProgress' | 'complete' | 'closed' | null;
+        sortOrder?: number;
+    }[];
+}
+export interface UpdateBoardData {
+    name?: string;
+    description?: string | null;
+    visibility?: ('creator' | 'reviewer')[];
+    status?: 'active' | 'archived';
+    sortOrder?: number;
+    /**
+     * When narrowing visibility, opt into automatic cleanup of dependent tasks,
+     * assignees, and relations. If omitted (or false) and dependents exist, the
+     * server returns 409 with a structured `errorData.blockers` payload.
+     */
+    cascade?: boolean;
+}
+export interface AddColumnData {
+    name: string;
+    description?: string;
+    color?: string;
+    isDefault?: boolean;
+    taskStatus?: 'pending' | 'inProgress' | 'complete' | 'closed' | null;
+    sortOrder?: number;
+    /** When true, reviewer-role users may create tasks in this column on a reviewer-visibility board. */
+    reviewersCanContribute?: boolean;
+}
+export interface UpdateColumnData {
+    name?: string;
+    description?: string | null;
+    color?: string | null;
+    isDefault?: boolean;
+    taskStatus?: 'pending' | 'inProgress' | 'complete' | 'closed' | null;
+    sortOrder?: number;
+    /** When true, reviewer-role users may create tasks in this column on a reviewer-visibility board. */
+    reviewersCanContribute?: boolean;
+}
+export interface ReorderColumnsData {
+    columns: {
+        id: string;
+        sortOrder: number;
+    }[];
+}
+export interface CreateBoardTaskData {
+    subject: string;
+    description?: string;
+    assignedToId?: string;
+    columnId?: string;
+    /** Optional announce flag. When supplied, after the task is created
+     *  the server posts a Nu reply in `chatId` threaded under `messageId`
+     *  with this task as a single taskCard and links them via TaskRelation.
+     *  Mirrors the same flag on `tasks.bulkCreate`. */
+    announce?: {
+        chatId: string;
+        messageId: string;
+    };
+}
+export interface AddExistingTaskData {
+    taskId: string;
+    columnId?: string;
+}
+export interface MoveTaskData {
+    /** Required for same-board moves; optional when `targetBoardId` is
+     *  set (server defaults to the target board's default column). */
+    columnId?: string;
+    sortOrder?: number;
+    /** When supplied AND different from the URL `boardId`, the server
+     *  performs a cross-board move — `boardId` and `columnId` are
+     *  updated together. Omit for the original same-board move. */
+    targetBoardId?: string;
+}
+export interface UpdateTaskDetailsData {
+    subject?: string;
+    description?: string | null;
+    assignedToId?: string | null;
+}
+export interface LinkTaskData {
+    linkedTaskId: string;
+    linkType?: 'related' | 'blocks' | 'blockedBy' | 'duplicate';
+}
+export default function createBoardMethods(client: NuramaClient): {
+    /**
+     * Create a new board inside a project. If `columns` are omitted the
+     * server seeds the standard four-column layout.
+     */
+    createBoard(data: CreateBoardData): Promise<Board>;
+    /**
+     * List boards in a project. Filters by visibility, free-text search,
+     * and tag ids.
+     */
+    getProjectBoards(projectId: string, params?: {
+        visibility?: string;
+        search?: string;
+        tags?: string[];
+    }): Promise<Board[]>;
+    /**
+     * List every task in a project across all boards. Use `boardId:
+     * 'unassigned'` to fetch only tasks not yet placed on a board.
+     */
+    getProjectTasks(projectId: string, params?: {
+        search?: string;
+        status?: string;
+        boardId?: string | "unassigned";
+        columnId?: string;
+        assignedToId?: string;
+        visibility?: string;
+        tags?: string[];
+        page?: number;
+        limit?: number;
+        sort?: Record<string, 1 | -1>;
+    }): Promise<any>;
+    /** Fetch a board with its columns and tasks populated. */
+    getBoard(boardId: string): Promise<BoardWithTasks>;
+    /**
+     * Update a board's metadata. Set `cascade: true` to opt into
+     * automatic cleanup of dependent tasks when narrowing visibility;
+     * otherwise the server returns 409 with a `blockers` payload.
+     */
+    updateBoard(boardId: string, data: UpdateBoardData): Promise<Board>;
+    /**
+     * Delete a board. `disposition` controls what happens to its tasks:
+     * `unassign` (default — tasks survive boardless), `delete`, or
+     * `reassign` to another board/column.
+     */
+    deleteBoard(boardId: string, body?: {
+        disposition?: "unassign" | "delete" | "reassign";
+        targetBoardId?: string;
+        targetColumnId?: string;
+    }): Promise<{
+        message: string;
+        disposition: string;
+        deletedTaskIds: string[];
+        reassignedTaskIds: string[];
+    }>;
+    /** Add a column to a board. Appended at the end unless `sortOrder` is provided. */
+    addColumn(boardId: string, data: AddColumnData): Promise<BoardColumn>;
+    /** Reorder a board's columns. The request must include every column id. */
+    reorderColumns(boardId: string, data: ReorderColumnsData): Promise<BoardColumn[]>;
+    /** Update column metadata (name, color, task-status mapping, etc.). */
+    updateColumn(boardId: string, columnId: string, data: UpdateColumnData): Promise<BoardColumn>;
+    /**
+     * Delete a column. If the column holds tasks, pass `targetColumnId`
+     * to move them; otherwise the call fails.
+     */
+    deleteColumn(boardId: string, columnId: string, targetColumnId?: string): Promise<void>;
+    /** List tasks on a board, optionally narrowed by column / assignee / tag / status / search. */
+    getBoardTasks(boardId: string, params?: {
+        columnId?: string;
+        search?: string;
+        status?: string;
+        assignedToId?: string;
+        tags?: string[];
+    }): Promise<Task[]>;
+    /**
+     * Create a task directly on a board. When `announce` is supplied the
+     * server also posts a Nu reply in the named chat threaded under the
+     * given message, with this task linked via TaskRelation.
+     */
+    createBoardTask(boardId: string, data: CreateBoardTaskData): Promise<Task>;
+    /** Attach an existing project task to a board (no new task is created). */
+    addExistingTaskToBoard(boardId: string, data: AddExistingTaskData): Promise<Task>;
+    /** Move a task to a different column on the same board. */
+    moveTask(boardId: string, taskId: string, data: MoveTaskData): Promise<Task>;
+    /** Detach a task from a board. The task itself is preserved as boardless. */
+    removeTaskFromBoard(boardId: string, taskId: string): Promise<Task>;
+    /** Attach a tag to a board. */
+    tagBoard(boardId: string, tagId: string): Promise<Board>;
+    /** Detach a tag from a board. */
+    untagBoard(boardId: string, tagId: string): Promise<Board>;
+    /** Follow a board to receive notifications about its tasks. */
+    followBoard(boardId: string): Promise<Board>;
+    /** Stop following a board. */
+    unfollowBoard(boardId: string): Promise<Board>;
+};
+//# sourceMappingURL=board.d.ts.map

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

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

package/dist/routes/board.js

@@ -0,0 +1,270 @@
+// --- Method Definitions ---
+export default function createBoardMethods(client) {
+    return {
+        // ========================================================================
+        // Board CRUD
+        // ========================================================================
+        /**
+         * Create a new board inside a project. If `columns` are omitted the
+         * server seeds the standard four-column layout.
+         */
+        async createBoard(data) {
+            if (!data.projectId)
+                throw new Error('projectId is required.');
+            if (!data.name)
+                throw new Error('name is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/boards/',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List boards in a project. Filters by visibility, free-text search,
+         * and tag ids.
+         */
+        async getProjectBoards(projectId, params) {
+            if (!projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/boards/project/${projectId}`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List every task in a project across all boards. Use `boardId:
+         * 'unassigned'` to fetch only tasks not yet placed on a board.
+         */
+        async getProjectTasks(projectId, params) {
+            if (!projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/boards/project/${projectId}/tasks`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /** Fetch a board with its columns and tasks populated. */
+        async getBoard(boardId) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/boards/${boardId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Update a board's metadata. Set `cascade: true` to opt into
+         * automatic cleanup of dependent tasks when narrowing visibility;
+         * otherwise the server returns 409 with a `blockers` payload.
+         */
+        async updateBoard(boardId, data) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Delete a board. `disposition` controls what happens to its tasks:
+         * `unassign` (default — tasks survive boardless), `delete`, or
+         * `reassign` to another board/column.
+         */
+        async deleteBoard(boardId, body) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/boards/${boardId}`,
+                body: body && Object.keys(body).length > 0 ? body : undefined,
+                sendJWT: true,
+            });
+        },
+        // ========================================================================
+        // Column Operations
+        // ========================================================================
+        /** Add a column to a board. Appended at the end unless `sortOrder` is provided. */
+        async addColumn(boardId, data) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            if (!data.name)
+                throw new Error('name is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/boards/${boardId}/columns`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** Reorder a board's columns. The request must include every column id. */
+        async reorderColumns(boardId, data) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}/columns/reorder`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** Update column metadata (name, color, task-status mapping, etc.). */
+        async updateColumn(boardId, columnId, data) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            if (!columnId)
+                throw new Error('columnId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}/columns/${columnId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Delete a column. If the column holds tasks, pass `targetColumnId`
+         * to move them; otherwise the call fails.
+         */
+        async deleteColumn(boardId, columnId, targetColumnId) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            if (!columnId)
+                throw new Error('columnId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/boards/${boardId}/columns/${columnId}`,
+                body: targetColumnId ? { targetColumnId } : undefined,
+                sendJWT: true,
+            });
+        },
+        // ========================================================================
+        // Board Task Operations
+        // ========================================================================
+        /** List tasks on a board, optionally narrowed by column / assignee / tag / status / search. */
+        async getBoardTasks(boardId, params) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/boards/${boardId}/tasks`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Create a task directly on a board. When `announce` is supplied the
+         * server also posts a Nu reply in the named chat threaded under the
+         * given message, with this task linked via TaskRelation.
+         */
+        async createBoardTask(boardId, data) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            if (!data.subject)
+                throw new Error('subject is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/boards/${boardId}/tasks`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** Attach an existing project task to a board (no new task is created). */
+        async addExistingTaskToBoard(boardId, data) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            if (!data.taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/boards/${boardId}/tasks/add`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** Move a task to a different column on the same board. */
+        async moveTask(boardId, taskId, data) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            if (!taskId)
+                throw new Error('taskId is required.');
+            if (!data.columnId)
+                throw new Error('columnId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}/tasks/${taskId}/move`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** Detach a task from a board. The task itself is preserved as boardless. */
+        async removeTaskFromBoard(boardId, taskId) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            if (!taskId)
+                throw new Error('taskId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/boards/${boardId}/tasks/${taskId}`,
+                sendJWT: true,
+            });
+        },
+        // ========================================================================
+        // Task Detail Operations
+        // ========================================================================
+        // ========================================================================
+        // Task Link Operations
+        // ========================================================================
+        // ========================================================================
+        // Tagging
+        // ========================================================================
+        /** Attach a tag to a board. */
+        async tagBoard(boardId, tagId) {
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}/tag`,
+                body: { tagId },
+                sendJWT: true,
+            });
+        },
+        /** Detach a tag from a board. */
+        async untagBoard(boardId, tagId) {
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}/untag`,
+                body: { tagId },
+                sendJWT: true,
+            });
+        },
+        // ========================================================================
+        // Following
+        // ========================================================================
+        /** Follow a board to receive notifications about its tasks. */
+        async followBoard(boardId) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}/follow`,
+                sendJWT: true,
+            });
+        },
+        /** Stop following a board. */
+        async unfollowBoard(boardId) {
+            if (!boardId)
+                throw new Error('boardId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/boards/${boardId}/unfollow`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=board.js.map

package/dist/routes/board.js.map

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

package/dist/routes/bot.d.ts

@@ -0,0 +1,202 @@
+import NuramaClient from '../NuramaClient.js';
+export interface BotApiKeySummary {
+    id: string;
+    keyPrefix: string;
+    name: string;
+    /** Discriminator. Bot keys mint as 'botAccess'. */
+    kind?: 'botAccess' | 'pat' | 'oauthAccess' | 'oauthRefresh' | null;
+    /** Granted scopes. A bot key is minted with the full registry when none are chosen. */
+    scopes?: string[];
+    lastUsed?: string | null;
+    expiresAt?: string | null;
+    status: 'active' | 'revoked';
+    createdAt: string;
+}
+export interface Bot {
+    id: string;
+    displayName: string;
+    color: string;
+    accountType: 'bot';
+    status: string;
+    avatarId: string | null;
+    /**
+     * Populated avatar Asset (joined server-side from `avatarId`). The web client
+     * resolves the image URL from this field via `getAvatarUrl()`.
+     */
+    avatar?: any | null;
+    roles?: string[];
+    membershipId?: string;
+    apiKeys?: BotApiKeySummary[];
+    apiKey?: BotApiKeySummary;
+    /**
+     * Project memberships within the workspace the bot belongs to. Populated by
+     * `listBots` and `getBot`. Empty array if the bot has no project assignments.
+     */
+    projectMemberships?: BotProjectMembership[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateBotData {
+    /** Display name for the bot. 1–50 characters. */
+    name: string;
+    /** Optional hex color from the approved palette. Auto-assigned if omitted. */
+    color?: string;
+    /** Workspace roles to grant the bot. Must be one or more of:
+     *  workspaceAdmin, workspaceMember, workspaceChatMember. */
+    roles: Array<'workspaceAdmin' | 'workspaceMember' | 'workspaceChatMember'>;
+    /**
+     * Optional API-key scopes. Omit (or pass an empty array) to mint the key
+     * with the full scope registry, which is what the bot's roles already allow
+     * — every route declares a scope now, so a genuinely empty set would leave
+     * the key unable to call anything. Pass a subset to narrow it.
+     */
+    scopes?: string[];
+}
+export interface CreateBotResponse {
+    bot: Bot;
+    /** Raw API key, returned ONCE at creation time. Store it immediately — it
+     *  cannot be retrieved again. */
+    rawKey: string;
+}
+export interface UpdateBotData {
+    name?: string;
+    color?: string;
+}
+export interface RotateBotKeyResponse {
+    apiKey: BotApiKeySummary;
+    /** New raw API key. Returned once. */
+    rawKey: string;
+}
+export interface CreateBotKeyData {
+    /** Label shown in the bot's key list. */
+    name: string;
+    /** Validated server-side against the token-scope registry. Omit for the full set. */
+    scopes?: string[];
+    /** Optional expiry, ISO 8601. Must be in the future. */
+    expiresAt?: string;
+}
+export interface CreateBotKeyResponse {
+    apiKey: BotApiKeySummary;
+    /** Raw API key. Returned once and not recoverable afterwards. */
+    rawKey: string;
+}
+export interface UpdateBotKeyScopesData {
+    /**
+     * The COMPLETE new scope set, not a delta — the same shape `createBotKey`
+     * takes. At least one scope; a scopeless key authenticates and is then
+     * refused by every gated route, so revoke it instead of emptying it.
+     */
+    scopes: string[];
+}
+export interface UpdateBotAvatarFileData {
+    name: string;
+    sizeInMB: number;
+    checksum: string;
+}
+export interface UpdateBotAvatarResponse {
+    user: {
+        id: string;
+        avatarId: string | null;
+    };
+    asset?: {
+        id: string;
+        [k: string]: unknown;
+    };
+    signedUrlData?: {
+        key: string;
+        uploadId: string;
+        urls: string[];
+    };
+    [k: string]: unknown;
+}
+export type BotProjectRole = 'creator' | 'reviewer' | 'projectAdmin';
+export interface BotProjectMembership {
+    membershipId: string;
+    projectId: string;
+    projectName: string;
+    roles: BotProjectRole[];
+}
+/**
+ * Bot user administration methods. Used by workspace owners/admins (callers
+ * holding a JWT) to manage bot users in a workspace. Bots themselves cannot
+ * call these endpoints — bot administration is restricted server-side.
+ */
+export default function createBotMethods(client: NuramaClient): {
+    /**
+     * Create a bot user in a workspace.
+     * Returns the new bot and the raw API key (shown only once).
+     */
+    createBot(workspaceId: string, data: CreateBotData): Promise<CreateBotResponse>;
+    /** List bot users in a workspace. */
+    listBots(workspaceId: string): Promise<Bot[]>;
+    /** Get a single bot's details, including all of its API key metadata (no secrets). */
+    getBot(workspaceId: string, botId: string): Promise<Bot>;
+    /** Update a bot's display name and/or color. */
+    updateBot(workspaceId: string, botId: string, data: UpdateBotData): Promise<Bot>;
+    /**
+     * Delete a bot user. Revokes all API keys, removes the workspace
+     * membership, and marks the user inactive.
+     */
+    deleteBot(workspaceId: string, botId: string): Promise<void>;
+    /**
+     * Revoke the bot's current API key and issue a new one.
+     * The new raw key is returned once.
+     *
+     * The replacement carries the old key's scopes verbatim, so this is not a
+     * way to pick up scopes added to the registry since the key was minted —
+     * `updateBotKeyScopes` is.
+     */
+    rotateBotKey(workspaceId: string, botId: string): Promise<RotateBotKeyResponse>;
+    /**
+     * Mint an ADDITIONAL API key for the bot, up to 5 live keys.
+     *
+     * Unlike `rotateBotKey`, the bot's existing keys keep working — which is
+     * what makes a zero-downtime changeover possible: mint, move traffic over,
+     * then revoke the old key. The raw key is returned once.
+     */
+    createBotKey(workspaceId: string, botId: string, keyData: CreateBotKeyData): Promise<CreateBotKeyResponse>;
+    /**
+     * Replace the scopes on one of the bot's API keys, in place.
+     *
+     * A key's scopes are a snapshot taken when it was minted, and the registry
+     * grows — a key created before a scope existed cannot hold it. Rotation is
+     * not a substitute: `rotateBotKey` copies the old scope set onto the
+     * replacement, so a stale key stays stale through every rotation.
+     *
+     * This matters most for keys minted with `scopes` omitted, which means
+     * "the full registry" as it stood that day, not "whatever the full registry
+     * becomes".
+     *
+     * The secret is unchanged — every caller configured with this key keeps
+     * working, which is the whole point. Requires `canManageBots`.
+     */
+    updateBotKeyScopes(workspaceId: string, botId: string, keyId: string, data: UpdateBotKeyScopesData): Promise<BotApiKeySummary>;
+    /**
+     * Revoke one of the bot's API keys, leaving its others working.
+     * A revoked key stops authenticating immediately and frees a slot
+     * against the 5-key cap.
+     */
+    revokeBotKey(workspaceId: string, botId: string, keyId: string): Promise<void>;
+    /**
+     * Request signed URL data to upload a new avatar for the bot.
+     * Caller multipart-uploads the file to S3 using the returned `signedUrlData`,
+     * then calls `client.asset.completeUpload(...)` to finalize.
+     */
+    updateBotAvatar(workspaceId: string, botId: string, fileData: UpdateBotAvatarFileData): Promise<UpdateBotAvatarResponse>;
+    /**
+     * List the bot's project memberships within the workspace.
+     */
+    listProjectMemberships(workspaceId: string, botId: string): Promise<BotProjectMembership[]>;
+    /**
+     * Upsert the bot's membership on a project. Replaces roles if a membership
+     * already exists; creates one otherwise. Idempotent.
+     */
+    setProjectMembership(workspaceId: string, botId: string, projectId: string, data: {
+        roles: BotProjectRole[];
+    }): Promise<BotProjectMembership>;
+    /**
+     * Remove the bot's membership on a project. Idempotent.
+     */
+    removeProjectMembership(workspaceId: string, botId: string, projectId: string): Promise<void>;
+};
+//# sourceMappingURL=bot.d.ts.map