@nurama/sdk 0.0.0-stage → 1.4.0

package/dist/routes/folder.d.ts

@@ -0,0 +1,75 @@
+import NuramaClient from '../NuramaClient.js';
+import { type Folder, type Asset, type PaginatedResult, type CursorPaginatedResult } from '@nurama/types';
+export type PaginatedResponse<T> = (PaginatedResult | CursorPaginatedResult) & {
+    results?: T[];
+};
+export interface PaginationParams {
+    limit?: number;
+    page?: number;
+}
+export interface SortParams {
+    sort?: Record<string, 1 | -1>;
+}
+export interface UpdateFolderData {
+    name?: string;
+    color?: string;
+}
+export interface UpdateFolderIconData {
+    name: string;
+    checksum: string;
+    sizeInMB: number;
+}
+export interface TagFolderData {
+    tagId: string;
+}
+export interface UntagFolderData {
+    tagId: string;
+}
+export interface GetFoldersAssetsParams extends PaginationParams, SortParams {
+    visibility?: 'creator' | 'reviewer';
+    chats?: boolean;
+    messages?: number;
+    replies?: number;
+}
+export type FolderResponse = Folder;
+export type AssetResponse = Asset;
+/**
+ * Defines folder-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the folder-related methods.
+ */
+export default function createFolderMethods(client: NuramaClient): {
+    /** Fetch a single folder by id. */
+    getFolder(folderId: string): Promise<FolderResponse>;
+    /**
+     * Updates a folder's name and/or color.
+     * @param {string} folderId - The ID of the folder to update.
+     * @param {UpdateFolderData} data - Data containing the name and/or color to update.
+     * @returns {Promise<FolderResponse>} The updated folder object.
+     */
+    updateFolder(folderId: string, data: UpdateFolderData): Promise<FolderResponse>;
+    /**
+     * Updates a folder's icon.
+     * @param {string} folderId - The ID of the folder to update.
+     * @param {UpdateFolderIconData} data - Icon file data including name, checksum, and size.
+     * @returns {Promise<any>} Object containing the updated folder and signed upload URLs.
+     */
+    updateFolderIcon(folderId: string, data: UpdateFolderIconData): Promise<any>;
+    /** List the assets that live directly inside a folder (does not recurse). */
+    getFoldersAssets(folderId: string, params?: GetFoldersAssetsParams): Promise<PaginatedResponse<AssetResponse>>;
+    /**
+     * Tags a folder with a specific tag.
+     * @param {string} folderId - The ID of the folder to tag.
+     * @param {TagFolderData} tagData - Data containing the tag ID.
+     * @returns {Promise<FolderResponse>} The updated folder object.
+     */
+    tagFolder(folderId: string, tagData: TagFolderData): Promise<FolderResponse>;
+    /**
+     * Untags a folder by removing a specific tag.
+     * @param {string} folderId - The ID of the folder to untag.
+     * @param {UntagFolderData} untagData - Data containing the tag ID to remove.
+     * @returns {Promise<FolderResponse>} The updated folder object.
+     */
+    untagFolder(folderId: string, untagData: UntagFolderData): Promise<FolderResponse>;
+};
+//# sourceMappingURL=folder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../../src/routes/folder.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAIvB,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,eAAe,GAAG,qBAAqB,CAAC,GAAG;IAC7E,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;CACf,CAAC;AAGF,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACjC;AAGD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB,EAAE,UAAU;IACxE,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAM,EAAE,YAAY;IAE5D,mCAAmC;wBACT,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAS1D;;;;;OAKG;2BAC0B,MAAM,QAAQ,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAUrF;;;;;OAKG;+BAC8B,MAAM,QAAQ,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC;IAUlF,6EAA6E;+BAC5C,MAAM,WAAW,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAUpH;;;;;OAKG;wBACuB,MAAM,WAAW,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAWlF;;;;;OAKG;0BACyB,MAAM,aAAa,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;EAY3F"}

package/dist/routes/folder.js

@@ -0,0 +1,99 @@
+/**
+ * Defines folder-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the folder-related methods.
+ */
+export default function createFolderMethods(client) {
+    return {
+        /** Fetch a single folder by id. */
+        async getFolder(folderId) {
+            if (!folderId)
+                throw new Error('folderId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/folders/${folderId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Updates a folder's name and/or color.
+         * @param {string} folderId - The ID of the folder to update.
+         * @param {UpdateFolderData} data - Data containing the name and/or color to update.
+         * @returns {Promise<FolderResponse>} The updated folder object.
+         */
+        async updateFolder(folderId, data) {
+            if (!folderId)
+                throw new Error('folderId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/folders/${folderId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Updates a folder's icon.
+         * @param {string} folderId - The ID of the folder to update.
+         * @param {UpdateFolderIconData} data - Icon file data including name, checksum, and size.
+         * @returns {Promise<any>} Object containing the updated folder and signed upload URLs.
+         */
+        async updateFolderIcon(folderId, data) {
+            if (!folderId)
+                throw new Error('folderId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/folders/${folderId}/icon`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** List the assets that live directly inside a folder (does not recurse). */
+        async getFoldersAssets(folderId, params) {
+            if (!folderId)
+                throw new Error('folderId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/folders/${folderId}/assets`,
+                params: params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Tags a folder with a specific tag.
+         * @param {string} folderId - The ID of the folder to tag.
+         * @param {TagFolderData} tagData - Data containing the tag ID.
+         * @returns {Promise<FolderResponse>} The updated folder object.
+         */
+        async tagFolder(folderId, tagData) {
+            if (!folderId)
+                throw new Error('folderId is required.');
+            if (!tagData.tagId)
+                throw new Error('tagId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/folders/${folderId}/tag`,
+                body: tagData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Untags a folder by removing a specific tag.
+         * @param {string} folderId - The ID of the folder to untag.
+         * @param {UntagFolderData} untagData - Data containing the tag ID to remove.
+         * @returns {Promise<FolderResponse>} The updated folder object.
+         */
+        async untagFolder(folderId, untagData) {
+            if (!folderId)
+                throw new Error('folderId is required.');
+            if (!untagData.tagId)
+                throw new Error('tagId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/folders/${folderId}/untag`,
+                body: untagData,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=folder.js.map

package/dist/routes/folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.js","sourceRoot":"","sources":["../../src/routes/folder.ts"],"names":[],"mappings":"AA0DA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAoB;IAC9D,OAAO;QACL,mCAAmC;QACnC,KAAK,CAAC,SAAS,CAAC,QAAgB;YAC9B,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,EAAE;gBACnC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,IAAsB;YACzD,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,EAAE;gBACnC,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,IAA0B;YACjE,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAM;gBAC1B,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,OAAO;gBACxC,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,6EAA6E;QAC7E,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,MAA+B;YACtE,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAmC;gBACvD,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,SAAS;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,OAAsB;YACtD,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,IAAI,CAAC,OAAO,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,MAAM;gBACvC,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,SAA0B;YAC5D,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,IAAI,CAAC,SAAS,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,QAAQ;gBACzC,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KAEF,CAAC;AACJ,CAAC"}

package/dist/routes/invite.d.ts

@@ -0,0 +1,61 @@
+import NuramaClient from '../NuramaClient.js';
+import { type Invite, type Membership, type PaginatedResult, type CursorPaginatedResult } from '@nurama/types';
+export type PaginatedResponse<T> = (PaginatedResult | CursorPaginatedResult) & {
+    results?: T[];
+};
+export interface InviteUserToResourceData {
+    inviteeEmail: string;
+    resourceType: string;
+    resourceId: string;
+    role: string;
+    /** Optional workspace-level roles granted alongside the primary role
+     *  (subset of the backend `additionalRoles`, e.g. workspaceChatMember,
+     *  workspaceAdmin). Applied to the workspace membership on accept. */
+    additionalRoles?: string[];
+}
+export type InviteStatus = 'active' | 'canceled' | 'accepted';
+export interface GetUsersInvitesParams {
+    inviteType?: 'all' | 'inviter' | 'invitee';
+    status?: InviteStatus | InviteStatus[];
+}
+export interface GetInvitesToResourceParams {
+    status?: InviteStatus | InviteStatus[];
+}
+export type InviteResponse = Invite;
+export type PaginatedInvitesResponse = PaginatedResponse<Invite> | {
+    inviter: Invite[];
+    invitee: Invite[];
+} | Invite[];
+export type AcceptInviteResponse = {
+    membership: Membership;
+    invite: Invite;
+};
+/**
+ * Defines invite-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the invite-related methods.
+ */
+export default function createInviteMethods(client: NuramaClient): {
+    /**
+     * Invite a user (by email) to a workspace or project at a given role.
+     * Triggers an invitation email; the recipient accepts via the link.
+     */
+    inviteUser(data: InviteUserToResourceData): Promise<InviteResponse>;
+    /** List invites the current user has issued (pending, accepted, expired). */
+    getInvites(params?: GetUsersInvitesParams): Promise<PaginatedInvitesResponse>;
+    /**
+     * Look up an invite by id. Public — no auth — so the recipient can
+     * preview the invite (target resource, role, inviter) before signing
+     * up or logging in.
+     */
+    getInviteById(inviteId: string): Promise<InviteResponse>;
+    /** Revoke a pending invite. */
+    cancelInvite(inviteId: string): Promise<InviteResponse>;
+    /** List pending invites attached to a workspace or project resource. */
+    getInvitesForResource(resourceId: string, params?: GetInvitesToResourceParams): Promise<InviteResponse[]>;
+    /** Accept an invite for the authenticated user. Creates the membership. */
+    acceptInvite(inviteId: string): Promise<AcceptInviteResponse>;
+    /** Re-send a pending invite email (does not extend or reissue the token). */
+    resendInvite(inviteId: string): Promise<InviteResponse>;
+};
+//# sourceMappingURL=invite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invite.d.ts","sourceRoot":"","sources":["../../src/routes/invite.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAIvB,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,eAAe,GAAG,qBAAqB,CAAC,GAAG;IAC7E,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;CACf,CAAC;AAGF,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;0EAEsE;IACtE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAGD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IAClC,UAAU,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACvC,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;CAC1C;AAGD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAAC;AACvH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAM,EAAE,YAAY;IAE5D;;;OAGG;qBACoB,wBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC;IASzE,6EAA6E;wBACnD,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IASnF;;;;OAIG;4BAC2B,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAS9D,+BAA+B;2BACF,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAS7D,wEAAwE;sCAChC,MAAM,WAAW,0BAA0B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAU/G,2EAA2E;2BAC9C,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IASnE,6EAA6E;2BAChD,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;EAShE"}

package/dist/routes/invite.js

@@ -0,0 +1,86 @@
+/**
+ * Defines invite-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the invite-related methods.
+ */
+export default function createInviteMethods(client) {
+    return {
+        /**
+         * Invite a user (by email) to a workspace or project at a given role.
+         * Triggers an invitation email; the recipient accepts via the link.
+         */
+        async inviteUser(data) {
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/invites',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** List invites the current user has issued (pending, accepted, expired). */
+        async getInvites(params) {
+            return client._request({
+                method: 'GET',
+                endpoint: '/v1/invites',
+                params: params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Look up an invite by id. Public — no auth — so the recipient can
+         * preview the invite (target resource, role, inviter) before signing
+         * up or logging in.
+         */
+        async getInviteById(inviteId) {
+            if (!inviteId)
+                throw new Error('inviteId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/invites/${inviteId}`,
+                sendJWT: false, // Public route - no authentication required
+            });
+        },
+        /** Revoke a pending invite. */
+        async cancelInvite(inviteId) {
+            if (!inviteId)
+                throw new Error('inviteId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/invites/${inviteId}`,
+                sendJWT: true,
+            });
+        },
+        /** List pending invites attached to a workspace or project resource. */
+        async getInvitesForResource(resourceId, params) {
+            if (!resourceId)
+                throw new Error('resourceId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/invites/resource/${resourceId}`,
+                params: params,
+                sendJWT: true,
+            });
+        },
+        /** Accept an invite for the authenticated user. Creates the membership. */
+        async acceptInvite(inviteId) {
+            if (!inviteId)
+                throw new Error('inviteId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/invites/accept/${inviteId}`,
+                sendJWT: true,
+            });
+        },
+        /** Re-send a pending invite email (does not extend or reissue the token). */
+        async resendInvite(inviteId) {
+            if (!inviteId)
+                throw new Error('inviteId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/invites/resend/${inviteId}`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=invite.js.map

package/dist/routes/invite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invite.js","sourceRoot":"","sources":["../../src/routes/invite.ts"],"names":[],"mappings":"AA+CA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAoB;IAC9D,OAAO;QACL;;;WAGG;QACH,KAAK,CAAC,UAAU,CAAC,IAA8B;YAC7C,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,aAAa;gBACvB,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,6EAA6E;QAC7E,KAAK,CAAC,UAAU,CAAC,MAA8B;YAC7C,OAAO,MAAM,CAAC,QAAQ,CAA2B;gBAC/C,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,aAAa;gBACvB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,aAAa,CAAC,QAAgB;YAClC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,EAAE;gBACnC,OAAO,EAAE,KAAK,EAAE,4CAA4C;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,+BAA+B;QAC/B,KAAK,CAAC,YAAY,CAAC,QAAgB;YACjC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,eAAe,QAAQ,EAAE;gBACnC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,wEAAwE;QACxE,KAAK,CAAC,qBAAqB,CAAC,UAAkB,EAAE,MAAmC;YACjF,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC,QAAQ,CAAmB;gBACvC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,wBAAwB,UAAU,EAAE;gBAC9C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,2EAA2E;QAC3E,KAAK,CAAC,YAAY,CAAC,QAAgB;YACjC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAuB;gBAC3C,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,sBAAsB,QAAQ,EAAE;gBAC1C,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,6EAA6E;QAC7E,KAAK,CAAC,YAAY,CAAC,QAAgB;YACjC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,QAAQ,CAAiB;gBACrC,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,sBAAsB,QAAQ,EAAE;gBAC1C,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/joinLink.d.ts

@@ -0,0 +1,38 @@
+import NuramaClient from '../NuramaClient.js';
+import { type JoinLink, type JoinLinkPreview, type CreateJoinLinkPayload, type UpdateJoinLinkPayload, type RedeemJoinLinkResult } from '@nurama/types';
+export interface GetJoinLinksParams {
+    projectId: string;
+}
+export type JoinLinkResponse = JoinLink;
+export interface JoinLinksListResponse {
+    results: JoinLink[];
+}
+/**
+ * Defines join-link ("invite link") methods for the NuramaClient. A join link
+ * lets people join a project via a shareable URL; management is gated by the
+ * caller's grant authority and the workspace plan's per-mode capability
+ * (enforced server-side).
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the join-link methods.
+ */
+export default function createJoinLinkMethods(client: NuramaClient): {
+    /** Create a join link for a project. */
+    createJoinLink(data: CreateJoinLinkPayload): Promise<JoinLinkResponse>;
+    /** List a project's join links. */
+    getJoinLinks(params: GetJoinLinksParams): Promise<JoinLinksListResponse>;
+    /** Update a join link's settings (role, mode, domains, expiry, enable/disable). */
+    updateJoinLink(linkId: string, data: UpdateJoinLinkPayload): Promise<JoinLinkResponse>;
+    /**
+     * Rotate a link's token, invalidating the old URL. Optionally reset expiry.
+     * Existing memberships are untouched.
+     */
+    rollJoinLink(linkId: string, expiresAt?: string | null): Promise<JoinLinkResponse>;
+    /**
+     * Public preview of a join link by token — no auth — so the join landing
+     * page can show "Join <project>" before the visitor signs in.
+     */
+    getJoinByToken(token: string): Promise<JoinLinkPreview>;
+    /** Redeem a join link for the authenticated user. */
+    joinByToken(token: string): Promise<RedeemJoinLinkResult>;
+};
+//# sourceMappingURL=joinLink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"joinLink.d.ts","sourceRoot":"","sources":["../../src/routes/joinLink.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACxC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,MAAM,EAAE,YAAY;IAE9D,wCAAwC;yBACb,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS5E,mCAAmC;yBACR,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAU9E,mFAAmF;2BACtD,MAAM,QAAQ,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAU5F;;;OAGG;yBACwB,MAAM,cAAc,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUxF;;;OAGG;0BACyB,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAS7D,qDAAqD;uBAC5B,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;EASlE"}

package/dist/routes/joinLink.js

@@ -0,0 +1,81 @@
+/**
+ * Defines join-link ("invite link") methods for the NuramaClient. A join link
+ * lets people join a project via a shareable URL; management is gated by the
+ * caller's grant authority and the workspace plan's per-mode capability
+ * (enforced server-side).
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the join-link methods.
+ */
+export default function createJoinLinkMethods(client) {
+    return {
+        /** Create a join link for a project. */
+        async createJoinLink(data) {
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/join-links',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** List a project's join links. */
+        async getJoinLinks(params) {
+            if (!params?.projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: '/v1/join-links',
+                params,
+                sendJWT: true,
+            });
+        },
+        /** Update a join link's settings (role, mode, domains, expiry, enable/disable). */
+        async updateJoinLink(linkId, data) {
+            if (!linkId)
+                throw new Error('linkId is required.');
+            return client._request({
+                method: 'PATCH',
+                endpoint: `/v1/join-links/${linkId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Rotate a link's token, invalidating the old URL. Optionally reset expiry.
+         * Existing memberships are untouched.
+         */
+        async rollJoinLink(linkId, expiresAt) {
+            if (!linkId)
+                throw new Error('linkId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/join-links/${linkId}/roll`,
+                body: expiresAt !== undefined ? { expiresAt } : {},
+                sendJWT: true,
+            });
+        },
+        /**
+         * Public preview of a join link by token — no auth — so the join landing
+         * page can show "Join <project>" before the visitor signs in.
+         */
+        async getJoinByToken(token) {
+            if (!token)
+                throw new Error('token is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/join/${token}`,
+                sendJWT: false, // Public route - no authentication required
+            });
+        },
+        /** Redeem a join link for the authenticated user. */
+        async joinByToken(token) {
+            if (!token)
+                throw new Error('token is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/join/${token}`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=joinLink.js.map

package/dist/routes/joinLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinLink.js","sourceRoot":"","sources":["../../src/routes/joinLink.ts"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,MAAoB;IAChE,OAAO;QACL,wCAAwC;QACxC,KAAK,CAAC,cAAc,CAAC,IAA2B;YAC9C,OAAO,MAAM,CAAC,QAAQ,CAAmB;gBACvC,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,gBAAgB;gBAC1B,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,KAAK,CAAC,YAAY,CAAC,MAA0B;YAC3C,IAAI,CAAC,MAAM,EAAE,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAClE,OAAO,MAAM,CAAC,QAAQ,CAAwB;gBAC5C,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,gBAAgB;gBAC1B,MAAM;gBACN,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED,mFAAmF;QACnF,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,IAA2B;YAC9D,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC,QAAQ,CAAmB;gBACvC,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,kBAAkB,MAAM,EAAE;gBACpC,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,SAAyB;YAC1D,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC,QAAQ,CAAmB;gBACvC,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,kBAAkB,MAAM,OAAO;gBACzC,IAAI,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;gBAClD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,cAAc,CAAC,KAAa;YAChC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,QAAQ,CAAkB;gBACtC,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,YAAY,KAAK,EAAE;gBAC7B,OAAO,EAAE,KAAK,EAAE,4CAA4C;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,KAAK,CAAC,WAAW,CAAC,KAAa;YAC7B,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,QAAQ,CAAuB;gBAC3C,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,YAAY,KAAK,EAAE;gBAC7B,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/membership.d.ts

@@ -0,0 +1,116 @@
+import NuramaClient from '../NuramaClient.js';
+import { type Membership, type MembershipReport, type Mentionable } from '@nurama/types';
+export interface PaginationParams {
+    limit?: number;
+    page?: number;
+}
+export interface SortParams {
+    sort?: Record<string, 1 | -1>;
+}
+export interface AddRemoveRoleData {
+    membershipId: string;
+    role: string;
+}
+export interface GetWorkspaceMembershipParams extends PaginationParams, SortParams {
+    nameSearch?: string | null;
+    isBillable?: boolean;
+}
+export interface GetProjectMembershipParams extends PaginationParams, SortParams {
+    nameSearch?: string | null;
+}
+export interface GetLastSeenData {
+    userIds: string[];
+}
+export interface LastSeenResult {
+    userId: string;
+    resourceId: string;
+    resourceType: 'workspace' | 'project';
+    lastSeen: string | null;
+}
+export interface GetLastSeenResponse {
+    results: LastSeenResult[];
+}
+export type MembershipResponse = Membership;
+export type PaginatedMembershipResponse = MembershipReport;
+export type MentionableUserResponse = Mentionable;
+/**
+ * Defines membership-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the membership-related methods.
+ */
+export default function createMembershipMethods(client: NuramaClient): {
+    /**
+         * Retrieves the membership records for the currently authenticated user.
+         * @returns {Promise<MembershipResponse[]>} An array of the user's membership records.
+         */
+    getMyMemberships(): Promise<MembershipResponse[]>;
+    /**
+         * Retrieves memberships associated with a specific workspace.
+         * Requires permission to get workspace members.
+         * @param {string} workspaceId - The ID of the workspace.
+         * @param {GetWorkspaceMembershipParams} [params] - Query parameters for pagination, sorting, filtering.
+         * @returns {Promise<PaginatedMembershipResponse>} Paginated list of workspace memberships.
+         */
+    getWorkspaceMemberships(workspaceId: string, params?: GetWorkspaceMembershipParams): Promise<PaginatedMembershipResponse>;
+    /**
+         * Retrieves memberships associated with a specific project.
+         * Requires permission based on user's role in the project/workspace.
+         * @param {string} projectId - The ID of the project.
+         * @param {GetProjectMembershipParams} [params] - Query parameters for pagination, sorting, filtering.
+         * @returns {Promise<PaginatedMembershipResponse>} Paginated list of project memberships.
+         */
+    getProjectMemberships(projectId: string, params?: GetProjectMembershipParams): Promise<PaginatedMembershipResponse>;
+    /**
+         * Deletes a specific membership record by its ID.
+         * Requires specific permissions to delete others' memberships.
+         * @param {string} membershipId - The ID of the membership record to delete.
+         * @returns {Promise<void>}
+         */
+    deleteMembership(membershipId: string): Promise<void>;
+    /**
+         * Allows the authenticated user to leave a resource (delete their own membership).
+         * Cannot be used to remove ownership roles.
+         * @param {string} resourceId - The ID of the resource (workspace or project) to leave.
+         * @returns {Promise<void>}
+         */
+    leaveResource(resourceId: string): Promise<void>;
+    /**
+         * Adds a role to an existing membership record.
+         * Requires permission to add roles.
+         * @param {AddRemoveRoleData} data - Object containing membershipId and the role to add.
+         * @returns {Promise<MembershipResponse>} The updated membership object.
+         */
+    addRole(data: AddRemoveRoleData): Promise<MembershipResponse>;
+    /**
+         * Removes a role from an existing membership record.
+         * Requires permission to remove roles. Cannot remove ownership roles.
+         * @param {AddRemoveRoleData} data - Object containing membershipId and the role to remove.
+         * @returns {Promise<MembershipResponse>} The updated membership object.
+         */
+    removeRole(data: AddRemoveRoleData): Promise<MembershipResponse>;
+    /**
+         * Retrieves a list of users mentionable within a project based on visibility.
+         * Requires permission to get mentionable users.
+         * @param {string} projectId - The ID of the project.
+         * @param {'creator' | 'reviewer' | 'all'} visibility - The visibility scope. Pass 'all' to get users from both creator and reviewer visibilities (e.g. for boards visible to both).
+         * @returns {Promise<MentionableUserResponse[]>} An array of mentionable user objects.
+         */
+    getProjectMentionableUsers(projectId: string, visibility: "creator" | "reviewer" | "all"): Promise<MentionableUserResponse[]>;
+    /**
+         * Retrieves resource-specific last seen timestamps for multiple users in a workspace.
+         * Requires permission to get workspace members.
+         * @param {string} workspaceId - The ID of the workspace.
+         * @param {GetLastSeenData} data - Object containing array of user IDs (1-100).
+         * @returns {Promise<GetLastSeenResponse>} Object with results array containing last seen data.
+         */
+    getWorkspaceLastSeen(workspaceId: string, data: GetLastSeenData): Promise<GetLastSeenResponse>;
+    /**
+         * Retrieves resource-specific last seen timestamps for multiple users in a project.
+         * Requires permission to get project members.
+         * @param {string} projectId - The ID of the project.
+         * @param {GetLastSeenData} data - Object containing array of user IDs (1-100).
+         * @returns {Promise<GetLastSeenResponse>} Object with results array containing last seen data.
+         */
+    getProjectLastSeen(projectId: string, data: GetLastSeenData): Promise<GetLastSeenResponse>;
+};
+//# sourceMappingURL=membership.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../../src/routes/membership.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACjC;AAGD,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,4BAA6B,SAAQ,gBAAgB,EAAE,UAAU;IAC9E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB,EAAE,UAAU;IAC5E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAGD,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC7B;AAGD,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC5C,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,CAAC;AAC3D,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,MAAM,EAAE,YAAY;IAEhE;;;WAGO;wBACmB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQvD;;;;;;WAMO;yCACoC,MAAM,WAAW,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAU/H;;;;;;WAMO;qCACgC,MAAM,WAAW,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAUzH;;;;;WAKO;mCAC8B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D;;;;;WAKO;8BACyB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAStD;;;;;WAKO;kBACa,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYnE;;;;;WAKO;qBACgB,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYtE;;;;;;WAMO;0CACqC,MAAM,cAAc,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAUnI;;;;;;WAMO;sCACiC,MAAM,QAAQ,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgBpG;;;;;;WAMO;kCAC6B,MAAM,QAAQ,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;EAgBnG"}