@nurama/sdk 0.0.0-stage → 1.4.0

package/dist/routes/bot.js

@@ -0,0 +1,157 @@
+/**
+ * Bot user administration methods. Used by workspace owners/admins (callers
+ * holding a JWT) to manage bot users in a workspace. Bots themselves cannot
+ * call these endpoints — bot administration is restricted server-side.
+ */
+export default function createBotMethods(client) {
+    return {
+        /**
+         * Create a bot user in a workspace.
+         * Returns the new bot and the raw API key (shown only once).
+         */
+        async createBot(workspaceId, data) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/workspaces/${workspaceId}/bots`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /** List bot users in a workspace. */
+        async listBots(workspaceId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/workspaces/${workspaceId}/bots`,
+                sendJWT: true,
+                bypassCache: true,
+            });
+        },
+        /** Get a single bot's details, including all of its API key metadata (no secrets). */
+        async getBot(workspaceId, botId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}`,
+                sendJWT: true,
+                bypassCache: true,
+            });
+        },
+        /** Update a bot's display name and/or color. */
+        async updateBot(workspaceId, botId, data) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Delete a bot user. Revokes all API keys, removes the workspace
+         * membership, and marks the user inactive.
+         */
+        async deleteBot(workspaceId, botId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Revoke the bot's current API key and issue a new one.
+         * The new raw key is returned once.
+         */
+        async rotateBotKey(workspaceId, botId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}/rotate-key`,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Request signed URL data to upload a new avatar for the bot.
+         * Caller multipart-uploads the file to S3 using the returned `signedUrlData`,
+         * then calls `client.asset.completeUpload(...)` to finalize.
+         */
+        async updateBotAvatar(workspaceId, botId, fileData) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            return client._request({
+                method: 'POST',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}/avatar`,
+                body: fileData,
+                sendJWT: true,
+            });
+        },
+        /**
+         * List the bot's project memberships within the workspace.
+         */
+        async listProjectMemberships(workspaceId, botId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            return client._request({
+                method: 'GET',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}/memberships`,
+                sendJWT: true,
+                bypassCache: true,
+            });
+        },
+        /**
+         * Upsert the bot's membership on a project. Replaces roles if a membership
+         * already exists; creates one otherwise. Idempotent.
+         */
+        async setProjectMembership(workspaceId, botId, projectId, data) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            if (!projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'PUT',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}/memberships/project/${projectId}`,
+                body: data,
+                sendJWT: true,
+            });
+        },
+        /**
+         * Remove the bot's membership on a project. Idempotent.
+         */
+        async removeProjectMembership(workspaceId, botId, projectId) {
+            if (!workspaceId)
+                throw new Error('workspaceId is required.');
+            if (!botId)
+                throw new Error('botId is required.');
+            if (!projectId)
+                throw new Error('projectId is required.');
+            return client._request({
+                method: 'DELETE',
+                endpoint: `/v1/workspaces/${workspaceId}/bots/${botId}/memberships/project/${projectId}`,
+                sendJWT: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=bot.js.map

package/dist/routes/bot.js.map

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