@nurama/sdk 0.0.0-stage → 1.4.1

package/dist/routes/convo.js

@@ -0,0 +1,284 @@
+/**
+ * Defines convo (video/audio chat) related methods for the NuramaClient.
+ * Handles starting, joining, and managing real-time conversations.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the convo-related methods.
+ */
+export default function createConvoMethods(client) {
+    return {
+        /**
+         * Start a new conversation (video or audio).
+         * Requires authentication.
+         * @param {StartConvoRequest} data - Conversation start data.
+         * @returns {Promise<StartConvoResponse>} The created conversation and room details.
+         * @example
+         * const result = await client.convo.startConvo({
+         *   chatId: '507f1f77bcf86cd799439011',
+         *   chatType: 'chat',
+         *   convoType: 'video'
+         * });
+         */
+        async startConvo(data) {
+            if (!data.chatId || !data.chatType || !data.convoType) {
+                throw new Error('chatId, chatType, and convoType are required.');
+            }
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/convos',
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Get a specific conversation by ID.
+         * Requires authentication and permission to view the conversation.
+         * @param {string} convoId - The conversation ID.
+         * @returns {Promise<GetConvoResponse>} The conversation details.
+         * @example
+         * const result = await client.convo.getConvo('507f1f77bcf86cd799439011');
+         */
+        async getConvo(convoId) {
+            if (!convoId) {
+                throw new Error('convoId is required.');
+            }
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/convos/${convoId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Join an active conversation.
+         * Returns the conversation details and a Daily.co meeting token for the user.
+         * Requires authentication and permission to join the conversation.
+         * @param {string} convoId - The conversation ID.
+         * @returns {Promise<JoinConvoResponse>} The conversation and meeting token.
+         * @example
+         * const result = await client.convo.joinConvo('507f1f77bcf86cd799439011');
+         * // Use result.token to join the Daily.co call
+         * // Use result.convo.dailyRoomUrl as the room URL
+         */
+        async joinConvo(convoId) {
+            if (!convoId) {
+                throw new Error('convoId is required.');
+            }
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/convos/${convoId}/join`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Rejoin an active conversation (page refresh / reconnect).
+         * Only returns a new meeting token if the user is already an active participant.
+         * No notifications are sent.
+         * @param {string} convoId - The conversation ID.
+         * @returns {Promise<JoinConvoResponse>} The conversation and meeting token.
+         */
+        async rejoinConvo(convoId) {
+            if (!convoId) {
+                throw new Error('convoId is required.');
+            }
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/convos/${convoId}/rejoin`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Leave an active conversation.
+         * Removes the user from the active participants list.
+         * Requires authentication.
+         * @param {string} convoId - The conversation ID.
+         * @returns {Promise<LeaveConvoResponse>} The updated conversation.
+         * @example
+         * const result = await client.convo.leaveConvo('507f1f77bcf86cd799439011');
+         */
+        async leaveConvo(convoId) {
+            if (!convoId) {
+                throw new Error('convoId is required.');
+            }
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/convos/${convoId}/leave`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Mark a conversation as complete.
+         * Ends the conversation and triggers recording/transcript processing if enabled.
+         * Requires authentication and permission to complete the conversation.
+         * @param {string} convoId - The conversation ID.
+         * @returns {Promise<CompleteConvoResponse>} The completed conversation.
+         * @example
+         * const result = await client.convo.completeConvo('507f1f77bcf86cd799439011');
+         */
+        async completeConvo(convoId) {
+            if (!convoId) {
+                throw new Error('convoId is required.');
+            }
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/convos/${convoId}/complete`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Delete/cancel a conversation.
+         * Only the creator can delete a conversation.
+         * Requires authentication and permission to delete the conversation.
+         * @param {string} convoId - The conversation ID.
+         * @returns {Promise<void>} Resolves with no value; the API responds 204.
+         * @example
+         * await client.convo.deleteConvo('507f1f77bcf86cd799439011');
+         */
+        async deleteConvo(convoId) {
+            if (!convoId) {
+                throw new Error('convoId is required.');
+            }
+            await client._request({
+                method: 'DELETE',
+                endpoint: `/v1/convos/${convoId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Update a conversation's subject and/or description.
+         * Only the conversation starter can update these fields.
+         * Requires authentication.
+         * @param {string} convoId - The conversation ID.
+         * @param {UpdateConvoRequest} data - Update data containing subject and/or description.
+         * @returns {Promise<UpdateConvoResponse>} The updated conversation.
+         * @example
+         * const result = await client.convo.updateConvo('507f1f77bcf86cd799439011', {
+         *   subject: 'Weekly Team Sync',
+         *   description: 'Discussing project updates and roadmap'
+         * });
+         */
+        async updateConvo(convoId, data) {
+            if (!convoId) {
+                throw new Error('convoId is required.');
+            }
+            return client._request({
+                method: 'PATCH',
+                endpoint: `/v1/convos/${convoId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List the convos that have taken place in a chat, newest first.
+         * Requires read access to the chat.
+         * @param {string} chatId - The chat ID.
+         * @param {object} [params] - Optional filter.
+         * @param {'active'|'completed'|'cancelled'} [params.status] - Only convos in this status.
+         * @returns {Promise<Convo[]>} Convos for the chat.
+         */
+        async getChatConvos(chatId, params) {
+            if (!chatId)
+                throw new Error('chatId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/chats/${chatId}/convos`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List every convo across all chats in a project (the "Convos drawer"), newest first.
+         * Requires `canGetProject` on the project.
+         * @param {string} projectId - The project ID.
+         * @param {object} [params] - Optional filters.
+         * @param {'creator'|'reviewer'} [params.visibility] - Only convos from chats with this visibility.
+         * @param {'active'|'completed'|'cancelled'} [params.status] - Only convos in this status.
+         * @returns {Promise<Convo[]>} Convos for the project.
+         */
+        async getProjectConvos(projectId, params) {
+            if (!projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/projects/${projectId}/convos`,
+                params,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Get conversations for a scope (project).
+         * Returns paginated list of conversations with cursor-based pagination.
+         * Active conversations are returned first.
+         * Requires authentication and permission to view conversations.
+         * @param {string} scopeId - The scope (project) ID.
+         * @param {object} params - Query parameters.
+         * @param {string[]} params.visibility - Array of visibility levels ('creator', 'reviewer').
+         * @param {string} [params.status] - Filter by status ('active', 'completed', 'cancelled').
+         * @param {string} [params.search] - Search query for participant names.
+         * @param {number} [params.limit=20] - Number of results per page.
+         * @param {string} [params.cursor] - Cursor for pagination.
+         * @param {boolean} [params.includeCounts] - Include total counts.
+         * @returns {Promise<GetScopeConvosResponse>} Paginated conversation list.
+         * @example
+         * const result = await client.convo.getScopeConvos('507f1f77bcf86cd799439011', {
+         *   visibility: ['creator', 'reviewer'],
+         *   status: 'active',
+         *   limit: 20
+         * });
+         */
+        /**
+         * Promote a convo's recording or transcript to a standalone asset.
+         *
+         * Additive: the artifact stays bundled with the convo as well, so calling
+         * this twice returns the first asset with `alreadyPromoted: true` rather
+         * than making a second copy.
+         *
+         * Only the convo's starter may promote. A transcript is promoted as a text
+         * document built from the transcript text, not the raw .vtt.
+         * @param {string} convoId - The conversation ID.
+         * @param {'recording'|'transcript'} kind - Which artifact to promote.
+         * @param {string} dailyId - The provider's id for the artifact, taken from
+         *   the convo's `recordings` / `transcripts` entries.
+         * @param {PromoteConvoArtifactRequest} [data] - Optional display name.
+         * @returns {Promise<PromoteConvoArtifactResponse>} The asset, and whether it already existed.
+         * @example
+         * const { asset } = await client.convo.promoteConvoArtifact(convoId, 'recording', rec.dailyId);
+         */
+        async promoteConvoArtifact(convoId, kind, dailyId, data) {
+            if (!convoId)
+                throw new Error('convoId is required.');
+            if (!dailyId)
+                throw new Error('dailyId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/convos/${convoId}/artifacts/${kind}/${dailyId}/promote`,
+                body: data ?? {},
+                sendJWT: true,
+            });
+        },
+        async getScopeConvos(scopeId, params) {
+            if (!scopeId) {
+                throw new Error('scopeId is required.');
+            }
+            if (!params.visibility || params.visibility.length === 0) {
+                throw new Error('visibility array is required and must not be empty.');
+            }
+            const queryParams = new URLSearchParams();
+            params.visibility.forEach((vis) => queryParams.append('visibility[]', vis));
+            if (params.status)
+                queryParams.append('status', params.status);
+            if (params.search)
+                queryParams.append('search', params.search);
+            if (params.limit)
+                queryParams.append('limit', params.limit.toString());
+            if (params.cursor)
+                queryParams.append('cursor', params.cursor);
+            if (params.includeCounts)
+                queryParams.append('includeCounts', 'true');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/convos/scope/${scopeId}?${queryParams.toString()}`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=convo.js.map

package/dist/routes/convo.js.map

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

package/dist/routes/credits.d.ts

@@ -0,0 +1,82 @@
+import NuramaClient from '../NuramaClient.js';
+export interface GetBalanceResponse {
+    /** Total spendable balance — sum of planBalance + purchasedBalance. */
+    balance: number;
+    /**
+     * Plan-granted credits for the current billing cycle. Refreshed (SET, not
+     * added) on every Stripe renewal. Unspent plan credits do NOT carry over.
+     */
+    planBalance: number;
+    /**
+     * Purchased credits — accumulated from one-off top-ups, auto-top-ups, admin
+     * grants. Carries over indefinitely.
+     */
+    purchasedBalance: number;
+    /**
+     * True when the workspace has at least one prior manual top-up
+     * (`subscriptionGrant` order). Powers the FE auto-top-up enable gate —
+     * users must top up manually once before auto top-up can be enabled.
+     */
+    hasPriorTopUp?: boolean;
+}
+export interface UsageReportParams {
+    /** ISO date string. Server defaults to 30 days ago when omitted. */
+    startDate?: string;
+    /** ISO date string. Server defaults to "now" when omitted. */
+    endDate?: string;
+    /** Narrow the per-integration breakdown to a single user's calls. */
+    userId?: string;
+    /** Narrow the per-user breakdown to a single integration point. */
+    integrationPoint?: string;
+}
+export interface UsageReportUserRow {
+    userId: string;
+    displayName: string | null;
+    avatar: unknown | null;
+    color: string | null;
+    billedCredits: number;
+    callCount: number;
+}
+export interface UsageReportIntegrationRow {
+    integrationPoint: string;
+    billedCredits: number;
+    callCount: number;
+}
+export interface UsageReportResponse {
+    total: {
+        billedCredits: number;
+        callCount: number;
+        tokensIn: number;
+        tokensOut: number;
+    };
+    byUser: UsageReportUserRow[];
+    byIntegration: UsageReportIntegrationRow[];
+    filters: {
+        startDate: string;
+        endDate: string;
+        userId: string | null;
+        integrationPoint: string | null;
+    };
+}
+/**
+ * Service-agnostic Nurama Credit balance + usage endpoints.
+ *
+ * The `/v1/credits/*` route shape and SDK namespace are deliberately
+ * decoupled from any single service's naming so future services (convos,
+ * etc.) can draw from the same balance without callers having to know
+ * where the spend originated. Today the metered data is AI-only because
+ * AI is the only service that's metered, but the contract is stable.
+ */
+export default function createCreditsMethods(client: NuramaClient): {
+    /**
+     * Get the workspace's spendable credit balance.
+     */
+    getBalance(workspaceId: string): Promise<GetBalanceResponse>;
+    /**
+     * Get the workspace's credit usage report. Same shape as the AI usage
+     * report — today the data is AI-only because AI is the only service
+     * that's metered.
+     */
+    getUsageReport(workspaceId: string, params?: UsageReportParams): Promise<UsageReportResponse>;
+};
+//# sourceMappingURL=credits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../../src/routes/credits.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC3C,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,MAAM,EAAE,YAAY;IAE7D;;OAEG;4BAC2B,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IASlE;;;;OAIG;gCAEY,MAAM,WACX,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,CAAC;EAclC"}

package/dist/routes/credits.js

@@ -0,0 +1,49 @@
+/**
+ * Service-agnostic Nurama Credit balance + usage endpoints.
+ *
+ * The `/v1/credits/*` route shape and SDK namespace are deliberately
+ * decoupled from any single service's naming so future services (convos,
+ * etc.) can draw from the same balance without callers having to know
+ * where the spend originated. Today the metered data is AI-only because
+ * AI is the only service that's metered, but the contract is stable.
+ */
+export default function createCreditsMethods(client) {
+    return {
+        /**
+         * Get the workspace's spendable credit balance.
+         */
+        async getBalance(workspaceId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                endpoint: `/v1/credits/balance?workspaceId=${encodeURIComponent(workspaceId)}`,
+                method: 'GET',
+                sendJWT: true,
+            });
+        },
+        /**
+         * Get the workspace's credit usage report. Same shape as the AI usage
+         * report — today the data is AI-only because AI is the only service
+         * that's metered.
+         */
+        async getUsageReport(workspaceId, params = {}) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            const query = new URLSearchParams({ workspaceId });
+            if (params.startDate)
+                query.set('startDate', params.startDate);
+            if (params.endDate)
+                query.set('endDate', params.endDate);
+            if (params.userId)
+                query.set('userId', params.userId);
+            if (params.integrationPoint)
+                query.set('integrationPoint', params.integrationPoint);
+            return client._request({
+                endpoint: `/v1/credits/usage?${query.toString()}`,
+                method: 'GET',
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=credits.js.map

package/dist/routes/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/routes/credits.ts"],"names":[],"mappings":"AAkEA;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,MAAoB;IAC/D,OAAO;QACL;;WAEG;QACH,KAAK,CAAC,UAAU,CAAC,WAAmB;YAClC,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9D,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,QAAQ,EAAE,mCAAmC,kBAAkB,CAAC,WAAW,CAAC,EAAE;gBAC9E,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,SAA4B,EAAE;YAE9B,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,SAAS;gBAAE,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,MAAM,CAAC,OAAO;gBAAE,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,MAAM,CAAC,MAAM;gBAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,gBAAgB;gBAAE,KAAK,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;YACpF,OAAO,MAAM,CAAC,QAAQ,CAAC;gBACrB,QAAQ,EAAE,qBAAqB,KAAK,CAAC,QAAQ,EAAE,EAAE;gBACjD,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routes/device.d.ts

@@ -0,0 +1,74 @@
+import NuramaClient from '../NuramaClient.js';
+import { type Device, type RegisterDeviceBody, type UpdateDeviceBody, type GetUserDevicesQuery } from '@nurama/types';
+/**
+ * Defines device-related methods for the NuramaClient.
+ * Handles device registration and management for push notifications.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the device-related methods.
+ */
+export default function createDeviceMethods(client: NuramaClient): {
+    /**
+     * Register a new device for push notifications.
+     * If the same push token is registered again, the existing device will be updated.
+     * Requires authentication.
+     * @param {RegisterDeviceBody} deviceData - Device registration data.
+     * @returns {Promise<Device>} The registered device object.
+     * @example
+     * const device = await client.device.registerDevice({
+     *   deviceType: 'ios',
+     *   pushToken: 'ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]',
+     *   bundleId: 'com.nurama.mobile',
+     *   deviceInfo: {
+     *     appVersion: '1.0.0',
+     *     osVersion: '17.0',
+     *     deviceModel: 'iPhone 15',
+     *     deviceName: "John's iPhone"
+     *   }
+     * });
+     */
+    registerDevice(deviceData: RegisterDeviceBody): Promise<Device>;
+    /**
+     * Get all devices for the authenticated user.
+     * Requires authentication.
+     * @param {GetUserDevicesQuery} [filters] - Optional filters (status, deviceType).
+     * @returns {Promise<Device[]>} Array of device objects.
+     * @example
+     * const devices = await client.device.getUserDevices({ status: 'active' });
+     */
+    getUserDevices(filters?: GetUserDevicesQuery): Promise<Device[]>;
+    /**
+     * Get a specific device by ID.
+     * Users can only access their own devices.
+     * Requires authentication.
+     * @param {string} deviceId - The device ID.
+     * @returns {Promise<Device>} The device object.
+     * @example
+     * const device = await client.device.getDevice('507f1f77bcf86cd799439011');
+     */
+    getDevice(deviceId: string): Promise<Device>;
+    /**
+     * Update device information.
+     * Users can only update their own devices.
+     * Requires authentication.
+     * @param {string} deviceId - The device ID.
+     * @param {UpdateDeviceBody} updateData - Data to update (pushToken, deviceInfo, status, subscribedChannels).
+     * @returns {Promise<Device>} The updated device object.
+     * @example
+     * const device = await client.device.updateDevice('507f1f77bcf86cd799439011', {
+     *   deviceInfo: { appVersion: '1.1.0' },
+     *   status: 'active'
+     * });
+     */
+    updateDevice(deviceId: string, updateData: UpdateDeviceBody): Promise<Device>;
+    /**
+     * Delete a device.
+     * Users can only delete their own devices.
+     * Requires authentication.
+     * @param {string} deviceId - The device ID.
+     * @returns {Promise<void>}
+     * @example
+     * await client.device.deleteDevice('507f1f77bcf86cd799439011');
+     */
+    deleteDevice(deviceId: string): Promise<void>;
+};
+//# sourceMappingURL=device.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/routes/device.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAM,EAAE,YAAY;IAE5D;;;;;;;;;;;;;;;;;;OAkBG;+BAC8B,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAYrE;;;;;;;OAOG;6BAC4B,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAStE;;;;;;;;OAQG;wBACuB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWlD;;;;;;;;;;;;OAYG;2BAC0B,MAAM,cAAc,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAenF;;;;;;;;OAQG;2BAC0B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EAWtD"}

package/dist/routes/device.js

@@ -0,0 +1,122 @@
+/**
+ * Defines device-related methods for the NuramaClient.
+ * Handles device registration and management for push notifications.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the device-related methods.
+ */
+export default function createDeviceMethods(client) {
+    return {
+        /**
+         * Register a new device for push notifications.
+         * If the same push token is registered again, the existing device will be updated.
+         * Requires authentication.
+         * @param {RegisterDeviceBody} deviceData - Device registration data.
+         * @returns {Promise<Device>} The registered device object.
+         * @example
+         * const device = await client.device.registerDevice({
+         *   deviceType: 'ios',
+         *   pushToken: 'ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]',
+         *   bundleId: 'com.nurama.mobile',
+         *   deviceInfo: {
+         *     appVersion: '1.0.0',
+         *     osVersion: '17.0',
+         *     deviceModel: 'iPhone 15',
+         *     deviceName: "John's iPhone"
+         *   }
+         * });
+         */
+        async registerDevice(deviceData) {
+            if (!deviceData.deviceType || !deviceData.pushToken) {
+                throw new Error('deviceType and pushToken are required.');
+            }
+            return client._request({
+                method: 'POST',
+                endpoint: '/v1/devices',
+                body: deviceData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Get all devices for the authenticated user.
+         * Requires authentication.
+         * @param {GetUserDevicesQuery} [filters] - Optional filters (status, deviceType).
+         * @returns {Promise<Device[]>} Array of device objects.
+         * @example
+         * const devices = await client.device.getUserDevices({ status: 'active' });
+         */
+        async getUserDevices(filters) {
+            return client._request({
+                method: 'GET',
+                endpoint: '/v1/devices',
+                params: filters,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Get a specific device by ID.
+         * Users can only access their own devices.
+         * Requires authentication.
+         * @param {string} deviceId - The device ID.
+         * @returns {Promise<Device>} The device object.
+         * @example
+         * const device = await client.device.getDevice('507f1f77bcf86cd799439011');
+         */
+        async getDevice(deviceId) {
+            if (!deviceId) {
+                throw new Error('deviceId is required.');
+            }
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/devices/${deviceId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Update device information.
+         * Users can only update their own devices.
+         * Requires authentication.
+         * @param {string} deviceId - The device ID.
+         * @param {UpdateDeviceBody} updateData - Data to update (pushToken, deviceInfo, status, subscribedChannels).
+         * @returns {Promise<Device>} The updated device object.
+         * @example
+         * const device = await client.device.updateDevice('507f1f77bcf86cd799439011', {
+         *   deviceInfo: { appVersion: '1.1.0' },
+         *   status: 'active'
+         * });
+         */
+        async updateDevice(deviceId, updateData) {
+            if (!deviceId) {
+                throw new Error('deviceId is required.');
+            }
+            if (Object.keys(updateData).length === 0) {
+                throw new Error('At least one field must be provided to update the device.');
+            }
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/devices/${deviceId}`,
+                body: updateData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Delete a device.
+         * Users can only delete their own devices.
+         * Requires authentication.
+         * @param {string} deviceId - The device ID.
+         * @returns {Promise<void>}
+         * @example
+         * await client.device.deleteDevice('507f1f77bcf86cd799439011');
+         */
+        async deleteDevice(deviceId) {
+            if (!deviceId) {
+                throw new Error('deviceId is required.');
+            }
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/devices/${deviceId}`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=device.js.map

package/dist/routes/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../src/routes/device.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAoB;IAC9D,OAAO;QACL;;;;;;;;;;;;;;;;;;WAkBG;QACH,KAAK,CAAC,cAAc,CAAC,UAA8B;YACjD,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAS;gBAC7B,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,aAAa;gBACvB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;;WAOG;QACH,KAAK,CAAC,cAAc,CAAC,OAA6B;YAChD,OAAO,MAAM,CAAC,QAAQ,CAAW;gBAC/B,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,aAAa;gBACvB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;;;WAQG;QACH,KAAK,CAAC,SAAS,CAAC,QAAgB;YAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAS;gBAC7B,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,EAAE;gBACnC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;;;;;;;WAYG;QACH,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,UAA4B;YAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAS;gBAC7B,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,eAAe,QAAQ,EAAE;gBACnC,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAED;;;;;;;;WAQG;QACH,KAAK,CAAC,YAAY,CAAC,QAAgB;YACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAO;gBAC3B,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,eAAe,QAAQ,EAAE;gBACnC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}