@nurama/sdk 0.0.0-stage → 1.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"supportTicket.d.ts","sourceRoot":"","sources":["../../src/routes/supportTicket.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC;AAE1F,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,sBAAsB,CAAA;KAAE,EAAE,CAAC;IAC/G,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,sBAAsB,CAAA;KAAE,EAAE,CAAC;CAC1I;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,MAAM,EAAE,YAAY;IAYnE,gFAAgF;8BAChD,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAUnF,oFAAoF;gCACnD,uBAAuB,GAAQ,OAAO,CAAC,yBAAyB,CAAC;+BAIjE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAShE,gEAAgE;oCAC1B,OAAO,CAAC,yBAAyB,CAAC;EAI3E"}

package/dist/routes/supportTicket.js

@@ -0,0 +1,54 @@
+/**
+ * Support tickets. A ticket carries the metadata + a backing Chat thread; the
+ * conversation itself is sent/read through the regular chat endpoints:
+ *
+ *   - send: `nuramaClient.chat.createMessage(ticket.chatId, …)`
+ *   - read: `nuramaClient.chat.getMessages(ticket.chatId, …)`
+ *
+ * Nurama customer service replies (as the support persona) from the admin site.
+ */
+export default function createSupportTicketMethods(client) {
+    const buildQuery = (params = {}) => {
+        const search = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null || value === '')
+                continue;
+            search.set(key, String(value));
+        }
+        const query = search.toString();
+        return query ? `?${query}` : '';
+    };
+    return {
+        /** Create a ticket. The opening message body becomes the first thread entry. */
+        async createSupportTicket(data) {
+            if (!data?.scopeType)
+                throw new Error('scopeType is required.');
+            if (data.scopeType !== 'user' && !data.scopeId) {
+                throw new Error('scopeId is required for workspace/project scope.');
+            }
+            if (!data?.subject)
+                throw new Error('subject is required.');
+            if (!data?.body)
+                throw new Error('body is required.');
+            return client._request({ endpoint: '/v1/support-tickets', method: 'POST', body: data, sendJWT: true });
+        },
+        /** List the caller's own tickets + (for resource admins) tickets in their scope. */
+        async listSupportTickets(params = {}) {
+            return client._request({ endpoint: `/v1/support-tickets${buildQuery(params)}`, method: 'GET', sendJWT: true });
+        },
+        async getSupportTicket(ticketId) {
+            if (!ticketId)
+                throw new Error('ticketId is required.');
+            return client._request({
+                endpoint: `/v1/support-tickets/${encodeURIComponent(ticketId)}`,
+                method: 'GET',
+                sendJWT: true,
+            });
+        },
+        /** Workspaces/projects the caller may scope a new ticket to. */
+        async getSupportTicketScopeOptions() {
+            return client._request({ endpoint: '/v1/support-tickets/scope-options', method: 'GET', sendJWT: true });
+        },
+    };
+}
+//# sourceMappingURL=supportTicket.js.map

package/dist/routes/supportTicket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportTicket.js","sourceRoot":"","sources":["../../src/routes/supportTicket.ts"],"names":[],"mappings":"AA8DA;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,MAAoB;IACrE,MAAM,UAAU,GAAG,CAAC,SAAkC,EAAE,EAAU,EAAE;QAClE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;gBAAE,SAAS;YACpE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,CAAC,CAAC;IAEF,OAAO;QACL,gFAAgF;QAChF,KAAK,CAAC,mBAAmB,CAAC,IAAgC;YACxD,IAAI,CAAC,IAAI,EAAE,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAChE,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,CAAC,IAAI,EAAE,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,EAAE,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACzG,CAAC;QAED,oFAAoF;QACpF,KAAK,CAAC,kBAAkB,CAAC,SAAkC,EAAE;YAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,sBAAsB,UAAU,CAAC,MAAiC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5I,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,QAAgB;YACrC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,QAAQ,EAAE,uBAAuB,kBAAkB,CAAC,QAAQ,CAAC,EAAE;gBAC/D,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,gEAAgE;QAChE,KAAK,CAAC,4BAA4B;YAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,mCAAmC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1G,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/tag.d.ts

@@ -0,0 +1,72 @@
+import NuramaClient from '../NuramaClient.js';
+import { type Tag, type TagOwnerResourceType } from '@nurama/types';
+/**
+ * Data required to create a new tag
+ */
+export interface CreateTagData {
+    /** The name of the tag */
+    name: string;
+    /** The type of resource that will own this tag */
+    ownerResourceType: TagOwnerResourceType;
+    /** The ID of the resource that will own this tag */
+    ownerResourceId: string;
+    /** Optional hex color code for the tag. If not provided, a color will be assigned automatically */
+    color?: string;
+}
+/**
+ * Data for updating an existing tag
+ */
+export interface UpdateTagData {
+    /** The new name for the tag */
+    name?: string;
+    /** The new hex color code for the tag */
+    color?: string;
+}
+/**
+ * Parameters for getting tags for a resource
+ */
+export interface GetTagsParams {
+    /** Filter tags by partial name match (case-insensitive) */
+    name?: string;
+    /** Sort tags by field */
+    sortBy?: 'name' | 'createdAt' | 'updatedAt';
+}
+/**
+ * Array of tags
+ */
+export type Tags = Tag[];
+/**
+ * Defines tag-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the tag-related methods.
+ */
+export default function createTagMethods(client: NuramaClient): {
+    /**
+     * Creates a new tag for a specific resource.
+     * @param {CreateTagData} tagData - The tag data to create.
+     * @returns {Promise<Tag>} The created tag object.
+     */
+    createTag(tagData: CreateTagData): Promise<Tag>;
+    /**
+     * Retrieves all tags for a specific resource.
+     * @param {TagOwnerResourceType} ownerResourceType - The type of resource to get tags for.
+     * @param {string} ownerResourceId - The ID of the resource to get tags for.
+     * @param {GetTagsParams} [params] - Optional parameters for filtering and sorting.
+     * @returns {Promise<Tags>} Array of tag objects.
+     */
+    getTags(ownerResourceType: TagOwnerResourceType, ownerResourceId: string, params?: GetTagsParams): Promise<Tags>;
+    /**
+     * Updates an existing tag.
+     * @param {string} tagId - The ID of the tag to update.
+     * @param {UpdateTagData} updateData - The data to update.
+     * @returns {Promise<Tag>} The updated tag object.
+     */
+    updateTag(tagId: string, updateData: UpdateTagData): Promise<Tag>;
+    /**
+     * Deletes a tag permanently.
+     * @param {string} tagId - The ID of the tag to delete.
+     * @returns {Promise<Tag>} The deleted tag object.
+     */
+    deleteTag(tagId: string): Promise<Tag>;
+};
+//# sourceMappingURL=tag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/routes/tag.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,kDAAkD;IAClD,iBAAiB,EAAE,oBAAoB,CAAC;IAExC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IAExB,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;AAEzB;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,MAAM,EAAE,YAAY;IAEzD;;;;OAIG;uBACsB,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;IAarD;;;;;;OAMG;+BAEkB,oBAAoB,mBACtB,MAAM,WACd,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;OAKG;qBACoB,MAAM,cAAc,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;IAcvE;;;;OAIG;qBACoB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;EAU/C"}

package/dist/routes/tag.js

@@ -0,0 +1,81 @@
+/**
+ * Defines tag-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the tag-related methods.
+ */
+export default function createTagMethods(client) {
+    return {
+        /**
+         * Creates a new tag for a specific resource.
+         * @param {CreateTagData} tagData - The tag data to create.
+         * @returns {Promise<Tag>} The created tag object.
+         */
+        async createTag(tagData) {
+            if (!tagData.name)
+                throw new Error('Tag name is required.');
+            if (!tagData.ownerResourceType)
+                throw new Error('Owner resource type is required.');
+            if (!tagData.ownerResourceId)
+                throw new Error('Owner resource ID is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/tags',
+                body: tagData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Retrieves all tags for a specific resource.
+         * @param {TagOwnerResourceType} ownerResourceType - The type of resource to get tags for.
+         * @param {string} ownerResourceId - The ID of the resource to get tags for.
+         * @param {GetTagsParams} [params] - Optional parameters for filtering and sorting.
+         * @returns {Promise<Tags>} Array of tag objects.
+         */
+        async getTags(ownerResourceType, ownerResourceId, params) {
+            if (!ownerResourceType)
+                throw new Error('Owner resource type is required.');
+            if (!ownerResourceId)
+                throw new Error('Owner resource ID is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/tags/${ownerResourceType}/${ownerResourceId}`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Updates an existing tag.
+         * @param {string} tagId - The ID of the tag to update.
+         * @param {UpdateTagData} updateData - The data to update.
+         * @returns {Promise<Tag>} The updated tag object.
+         */
+        async updateTag(tagId, updateData) {
+            if (!tagId)
+                throw new Error('Tag ID is required.');
+            if (!updateData.name && !updateData.color) {
+                throw new Error('At least one field (name or color) must be provided for update.');
+            }
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/tags/${tagId}`,
+                body: updateData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Deletes a tag permanently.
+         * @param {string} tagId - The ID of the tag to delete.
+         * @returns {Promise<Tag>} The deleted tag object.
+         */
+        async deleteTag(tagId) {
+            if (!tagId)
+                throw new Error('Tag ID is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/tags/${tagId}`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=tag.js.map

package/dist/routes/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/routes/tag.ts"],"names":[],"mappings":"AA+CA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,MAAoB;IAC3D,OAAO;QACL;;;;WAIG;QACH,KAAK,CAAC,SAAS,CAAC,OAAsB;YACpC,IAAI,CAAC,OAAO,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC5D,IAAI,CAAC,OAAO,CAAC,iBAAiB;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACpF,IAAI,CAAC,OAAO,CAAC,eAAe;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAEhF,OAAO,MAAM,CAAC,QAAQ,CAAM;gBAC1B,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,UAAU;gBACpB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;WAMG;QACH,KAAK,CAAC,OAAO,CACX,iBAAuC,EACvC,eAAuB,EACvB,MAAsB;YAEtB,IAAI,CAAC,iBAAiB;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAC5E,IAAI,CAAC,eAAe;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAExE,OAAO,MAAM,CAAC,QAAQ,CAAO;gBAC3B,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,YAAY,iBAAiB,IAAI,eAAe,EAAE;gBAC5D,MAAM;gBACN,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,UAAyB;YACtD,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACnD,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACrF,CAAC;YAED,OAAO,MAAM,CAAC,QAAQ,CAAM;gBAC1B,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,YAAY,KAAK,EAAE;gBAC7B,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,SAAS,CAAC,KAAa;YAC3B,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAEnD,OAAO,MAAM,CAAC,QAAQ,CAAM;gBAC1B,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,YAAY,KAAK,EAAE;gBAC7B,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/task.d.ts

@@ -0,0 +1,252 @@
+import NuramaClient from '../NuramaClient.js';
+import { type UpdateTaskDetailsData, type LinkTaskData } from './board.js';
+import { type Task, // Import Task type
+type PaginatedResult, // Import pagination types
+type CursorPaginatedResult, type TaskLink } from '@nurama/types';
+export type PaginatedResponse<T> = (PaginatedResult | CursorPaginatedResult) & {
+    results?: T[];
+};
+export interface SortParams {
+    sort?: Record<string, 1 | -1>;
+}
+export type TaskVisibility = 'creator' | 'reviewer';
+export type TaskStatus = 'pending' | 'complete' | 'cancelled';
+export interface GetTasksBaseParams extends SortParams {
+    projectId?: string;
+    creatorId?: string;
+    relatedToId?: string;
+    visibility?: TaskVisibility;
+    acknowledged?: boolean;
+    limit?: number;
+}
+export interface GetTasksIndexParams extends GetTasksBaseParams {
+    paginate?: 'index';
+    page?: number;
+    createdBefore?: number | string;
+    createdAfter?: number | string;
+}
+export interface GetTasksCursorParams extends GetTasksBaseParams {
+    paginate: 'cursor';
+    cursor?: string;
+    paginateReverse?: boolean;
+    includeCounts?: boolean;
+    includeCursorRecord?: boolean;
+    startAt?: string;
+    includeStartAtRecord?: boolean;
+}
+export type GetTasksParams = GetTasksIndexParams | GetTasksCursorParams;
+export interface UpdateTaskStatusData {
+    status: TaskStatus;
+}
+export type GetTasksResponse = PaginatedResponse<Task>;
+export interface UnacknowledgedTaskCountResponse {
+    total: number;
+    creator: number;
+    reviewer: number;
+}
+export interface AcknowledgeAllTasksResponse {
+    /** Number of tasks that were acknowledged by this call. */
+    acknowledged: number;
+    /** The user's remaining unacknowledged count for the project (should be all-zero). */
+    unacknowledgedCount: UnacknowledgedTaskCountResponse;
+}
+export interface TaskEventActor {
+    id: string;
+    displayName?: string;
+    firstName?: string;
+    lastName?: string;
+    color?: string;
+    avatar?: unknown;
+}
+export interface TaskEvent {
+    id: string;
+    taskId: string;
+    projectId: string;
+    eventType: string;
+    detail?: Record<string, unknown>;
+    createdAt: string;
+    actor: TaskEventActor | null;
+}
+export interface GetTaskEventsParams {
+    page?: number;
+    limit?: number;
+    sort?: Record<string, 1 | -1>;
+    eventType?: string;
+}
+export type GetTaskEventsResponse = PaginatedResponse<TaskEvent>;
+/**
+ * Defines task-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the task-related methods.
+ */
+export interface BulkTaskDraft {
+    /** FE-assigned id; echoed back in `results` so the caller can map a
+     *  per-task outcome onto the originating draft. */
+    clientId: string;
+    boardId: string;
+    columnId?: string;
+    subject: string;
+    description?: string | null;
+    assignedToId?: string;
+    tagIds?: string[];
+}
+export interface BulkCreateTasksRequest {
+    projectId: string;
+    tasks: BulkTaskDraft[];
+    /** When present, the server posts a single Nu reply in the chat after
+     *  the batch creates, threaded as `replyToId = messageId` and carrying
+     *  every newly-created task as a taskCard. Replaces the standalone
+     *  `ai.announceTasksFromMessage` endpoint we shipped previously. */
+    announce?: {
+        chatId: string;
+        messageId: string;
+    };
+}
+export interface BulkCreateTaskResult {
+    clientId: string;
+    status: 'created' | 'error';
+    task?: Task;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface BulkCreateTasksResponse {
+    results: BulkCreateTaskResult[];
+    announce?: {
+        posted: boolean;
+        messageId: string | null;
+    };
+}
+export default function createTaskMethods(client: NuramaClient): {
+    /**
+         * 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.
+         */
+    getMyTasks(params?: GetTasksParams): Promise<GetTasksResponse>;
+    /**
+     * 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.
+     */
+    bulkCreate(data: BulkCreateTasksRequest): Promise<BulkCreateTasksResponse>;
+    /**
+         * 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.
+         */
+    updateTaskStatus(taskId: string, data: UpdateTaskStatusData): Promise<Task>;
+    /**
+         * 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.
+         */
+    acknowledgeTask(taskId: string): Promise<Task>;
+    /**
+         * 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.
+         */
+    getUnacknowledgedTaskCount(projectId: string): Promise<UnacknowledgedTaskCountResponse>;
+    /**
+         * 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.
+         */
+    acknowledgeAllTasks(projectId: string): Promise<AcknowledgeAllTasksResponse>;
+    /**
+     * 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.
+     */
+    followTask(taskId: string): Promise<Task>;
+    /**
+     * 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.
+     */
+    unfollowTask(taskId: string): Promise<Task>;
+    /**
+     * 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.
+     */
+    deleteTask(taskId: string): Promise<void>;
+    /**
+     * 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.
+     */
+    getTaskEvents(taskId: string, params?: GetTaskEventsParams): Promise<GetTaskEventsResponse>;
+    /**
+     * 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.
+     */
+    updateTaskDetails(taskId: string, data: UpdateTaskDetailsData): Promise<Task>;
+    /**
+     * 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.'.
+     */
+    linkTask(taskId: string, data: LinkTaskData): Promise<TaskLink>;
+    /**
+     * 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.'.
+     */
+    unlinkTask(taskId: string, linkedTaskId: string): Promise<void>;
+    /**
+     * 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.
+     */
+    getTaskLinks(taskId: string): Promise<TaskLink[]>;
+    /**
+     * 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.'.
+     */
+    tagTask(taskId: string, tagId: string): Promise<Task>;
+    /**
+     * 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.'.
+     */
+    untagTask(taskId: string, tagId: string): Promise<Task>;
+};
+//# sourceMappingURL=task.d.ts.map

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

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