@vuevox/sdk 0.1.0 → 0.2.0

package/README.md

@@ -18,10 +18,11 @@ Settings -> Developer API -> Manage API Clients
 
 Create a client, select the scopes it can request, and copy the `client_secret` immediately. VueVox shows each client secret only once.
 
-Available scope:
+Available scopes:
 
 ```text
 hello:read
+spaces:read
 ```
 
 ## Basic Usage
@@ -32,11 +33,14 @@ import { createVueVoxClient } from "@vuevox/sdk";
 const vuevox = createVueVoxClient({
   clientId: process.env.VUEVOX_CLIENT_ID!,
   clientSecret: process.env.VUEVOX_CLIENT_SECRET!,
-  scope: "hello:read",
+  scope: ["hello:read", "spaces:read"],
 });
 
 const hello = await vuevox.hello();
 console.log(hello.message);
+
+const spaces = await vuevox.listSpaces({ limit: 50 });
+console.log(spaces.data);
 ```
 
 The SDK requests and caches a short-lived access token using client credentials, then sends it as a bearer token for API calls.
@@ -51,11 +55,11 @@ import { VueVoxApiError, createVueVoxClient } from "@vuevox/sdk";
 const vuevox = createVueVoxClient({
   clientId: process.env.VUEVOX_CLIENT_ID!,
   clientSecret: process.env.VUEVOX_CLIENT_SECRET!,
-  scope: "hello:read",
+  scope: ["hello:read", "spaces:read"],
 });
 
 try {
-  await vuevox.hello();
+  await vuevox.listSpaces({ limit: 50 });
 } catch (error) {
   if (error instanceof VueVoxApiError) {
     console.error(error.status, error.code, error.message);
@@ -100,7 +104,7 @@ const vuevox = createVueVoxClient({
   baseUrl: "https://api.vuevox.com",
   clientId: process.env.VUEVOX_CLIENT_ID!,
   clientSecret: process.env.VUEVOX_CLIENT_SECRET!,
-  scope: "hello:read",
+  scope: ["hello:read", "spaces:read"],
 });
 ```
 
@@ -115,3 +119,18 @@ const { data, error } = await vuevox.raw.GET("/v1/hello", {
   },
 });
 ```
+
+## Pagination
+
+List endpoints use cursor pagination.
+
+```ts
+const firstPage = await vuevox.listSpaces({ limit: 50 });
+
+if (firstPage.pagination.nextCursor) {
+  const secondPage = await vuevox.listSpaces({
+    limit: 50,
+    cursor: firstPage.pagination.nextCursor,
+  });
+}
+```

package/dist/client.d.ts

@@ -1,5 +1,10 @@
 import type { components, paths } from "./generated/schema.js";
 type HelloResponse = components["schemas"]["HelloResponse"];
+type SpacesListResponse = components["schemas"]["SpacesListResponse"];
+export interface ListSpacesOptions {
+    limit?: number;
+    cursor?: string;
+}
 export interface VueVoxClientOptions {
     baseUrl?: string;
     clientId: string;
@@ -10,6 +15,7 @@ export interface VueVoxClientOptions {
 export declare function createVueVoxClient(options: VueVoxClientOptions): {
     getAccessToken: () => Promise<string>;
     hello: () => Promise<HelloResponse>;
+    listSpaces: (options?: ListSpacesOptions) => Promise<SpacesListResponse>;
     raw: import("openapi-fetch").Client<paths, `${string}/${string}`>;
 };
 export {};

package/dist/client.js

@@ -47,9 +47,25 @@ export function createVueVoxClient(options) {
         }
         return data;
     }
+    async function listSpaces(options = {}) {
+        const accessToken = await getAccessToken();
+        const { data, error, response } = await raw.GET("/v1/spaces", {
+            params: {
+                query: options,
+            },
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+            },
+        });
+        if (error) {
+            throw new VueVoxApiError(response.status, error.error.code, error.error.message, error);
+        }
+        return data;
+    }
     return {
         getAccessToken,
         hello,
+        listSpaces,
         raw,
     };
 }

package/dist/generated/schema.d.ts

@@ -44,6 +44,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/spaces": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List organization spaces
+         * @description Returns spaces for the API client's organization using cursor pagination.
+         */
+        get: operations["listSpaces"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -72,6 +92,30 @@ export interface components {
             /** @example Hello world */
             message: string;
         };
+        Space: {
+            /** Format: uuid */
+            id: string;
+            /** @example Sales Team */
+            name: string;
+            /** @example Workspace for inbound sales calls. */
+            description: string | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        SpacesListResponse: {
+            data: components["schemas"]["Space"][];
+            pagination: components["schemas"]["CursorPagination"];
+        };
+        CursorPagination: {
+            /** @example 50 */
+            limit: number;
+            /** @example false */
+            hasMore: boolean;
+            /** @description Opaque cursor to pass as cursor on the next request. */
+            nextCursor: string | null;
+        };
         ErrorResponse: {
             error: components["schemas"]["Error"];
         };
@@ -197,4 +241,69 @@ export interface operations {
             };
         };
     };
+    listSpaces: {
+        parameters: {
+            query?: {
+                /** @description Number of spaces to return. Defaults to 50. Maximum is 100. */
+                limit?: number;
+                /** @description Opaque cursor from the previous response's pagination.nextCursor value. */
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated spaces response. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SpacesListResponse"];
+                };
+            };
+            /** @description Bearer token is missing, invalid, or expired. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Bearer token does not include the required scope. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Query parameters failed validation. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Per-client rate limit exceeded. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: string;
+                    /** @description Request limit per minute for this API client. */
+                    "X-RateLimit-Limit"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { createVueVoxClient } from "./client.js";
-export type { VueVoxClientOptions } from "./client.js";
+export type { ListSpacesOptions, VueVoxClientOptions } from "./client.js";
 export { VueVoxApiError } from "./errors.js";
 export type { VueVoxErrorResponse } from "./errors.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vuevox/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript SDK for the VueVox Developer API.",
   "type": "module",
   "main": "./dist/index.js",