@bubblebridge/sdk 0.1.1 → 0.1.2

package/README.md

@@ -16,17 +16,14 @@ You need a client ID and a client secret. Register your agent at `https://bubble
 
 ## Send a user to the consent page
 
-Create a `state` value and a PKCE verifier. Store both for at most ten minutes. Then send the browser to the consent page.
+Call `pkce` for a `state` value, a PKCE verifier, and its S256 challenge. Store the first two for at most ten minutes. Then send the browser to the consent page.
 
 ```ts
-import { createHash, randomBytes } from 'node:crypto';
-import { BubbleBridge } from '@bubblebridge/sdk';
+import { BubbleBridge, pkce } from '@bubblebridge/sdk';
 
 const bb = new BubbleBridge({ clientId, clientSecret });
 
-const state = randomBytes(16).toString('base64url');
-const codeVerifier = randomBytes(32).toString('base64url');
-const codeChallenge = createHash('sha256').update(codeVerifier).digest('base64url');
+const { state, codeVerifier, codeChallenge } = await pkce();
 
 const location = bb.oauth.authorizeUrl({
   scopes: ['google.gmail.readonly', 'google.calendar.events'],

package/dist/base64url.d.ts

@@ -0,0 +1 @@
+export declare function base64Url(bytes: Uint8Array): string;

package/dist/base64url.js

@@ -0,0 +1,6 @@
+export function base64Url(bytes) {
+    let binary = '';
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}

package/dist/generated.d.ts

@@ -115,6 +115,54 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/admin/builder-requests": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["list_requests"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/admin/builder-requests/{user_id}/accept": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["accept"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/admin/builder-requests/{user_id}/reject": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["reject"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agents": {
         parameters: {
             query?: never;
@@ -147,6 +195,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/billing": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["status"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/billing/checkout": {
         parameters: {
             query?: never;
@@ -179,6 +243,102 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/builder/agents": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["list_builder_agents"];
+        put?: never;
+        post: operations["create_builder_agent"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/builder/agents/{agent_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch: operations["update_builder_agent"];
+        trace?: never;
+    };
+    "/v1/builder/agents/{agent_id}/rotate-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["rotate_builder_agent_secret"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/builder/invites/redeem": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["redeem_invite"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/builder/requests": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["create_request"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/builder/requests/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["my_request"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/connections": {
         parameters: {
             query?: never;
@@ -368,6 +528,11 @@ export interface components {
         AgentList: {
             agents: components["schemas"]["Agent"][];
         };
+        /**
+         * @description `listed` agents appear in the catalog. `unlisted` agents keep working but are hidden.
+         * @enum {string}
+         */
+        AgentStatus: "listed" | "unlisted";
         /** @description Query of `GET /oauth/authorize`. `scope` is a space-separated list of scope names. */
         AuthorizeQuery: {
             client_id: string;
@@ -376,6 +541,34 @@ export interface components {
             scope: string;
             state: string;
         };
+        /** @description Response of `GET /v1/billing`. `status` is the Stripe status or `none`. */
+        BillingStatus: {
+            cancel_at_period_end: boolean;
+            /** Format: int64 */
+            current_period_end?: number | null;
+            status: string;
+        };
+        /** @description One agent as its builder sees it. Element of `GET /v1/builder/agents`. */
+        BuilderAgent: {
+            client_id: string;
+            description: string;
+            homepage_url?: string | null;
+            id: string;
+            logo_url?: string | null;
+            name: string;
+            redirect_uris: string[];
+            requested_scopes: components["schemas"]["Scope"][];
+            slug: string;
+            status: components["schemas"]["AgentStatus"];
+        };
+        /** @description Response of `GET /v1/builder/agents`. */
+        BuilderAgentList: {
+            agents: components["schemas"]["BuilderAgent"][];
+        };
+        /** @description Response of `POST /v1/builder/agents/:agentId/rotate-secret`. The secret appears here one time. */
+        ClientSecret: {
+            client_secret: string;
+        };
         /** @description One connection without its credentials. */
         Connection: {
             account_email: string;
@@ -404,6 +597,22 @@ export interface components {
         ConsentResponse: {
             redirect_url: string;
         };
+        /** @description Body of `POST /v1/builder/agents`. */
+        CreateAgentBody: {
+            description: string;
+            homepage_url?: string | null;
+            logo_url?: string | null;
+            name: string;
+            redirect_uris: string[];
+            requested_scopes: components["schemas"]["Scope"][];
+            slug: string;
+            status: components["schemas"]["AgentStatus"];
+        };
+        /** @description Response of `POST /v1/builder/agents`. The client secret appears here one time. */
+        CreatedAgent: {
+            agent: components["schemas"]["BuilderAgent"];
+            client_secret: string;
+        };
         ErrorBody: {
             code: components["schemas"]["ErrorCode"];
             message: string;
@@ -413,7 +622,7 @@ export interface components {
          * @description The error codes that the API returns. See the proxy page, section 6.
          * @enum {string}
          */
-        ErrorCode: "invalid_request" | "unauthorized" | "subscription_required" | "endpoint_not_allowed" | "scope_missing" | "agent_not_enabled" | "not_found" | "connection_not_found" | "connection_required" | "connection_reauth_required" | "payload_too_large" | "rate_limited" | "internal_error" | "upstream_timeout";
+        ErrorCode: "invalid_request" | "unauthorized" | "subscription_required" | "endpoint_not_allowed" | "scope_missing" | "agent_not_enabled" | "forbidden" | "not_found" | "connection_not_found" | "connection_required" | "connection_reauth_required" | "conflict" | "payload_too_large" | "rate_limited" | "internal_error" | "upstream_timeout";
         /** @description The JSON shape of every API error: `{ "error": { ... } }`. */
         ErrorResponse: {
             error: components["schemas"]["ErrorBody"];
@@ -436,6 +645,16 @@ export interface components {
         };
         /** @enum {string} */
         GrantStatus: "active" | "revoked";
+        /** @description Response of `POST /v1/admin/builder-requests/:userId/accept`. The code appears here one time. */
+        InviteCodeResponse: {
+            code: string;
+            /** Format: int64 */
+            expires_at: number;
+        };
+        /** @description Body of `POST /v1/builder/invites/redeem`. */
+        InviteRedeemBody: {
+            code: string;
+        };
         /** @description One RSA public key in `GET /.well-known/jwks.json`. */
         Jwk: {
             alg: string;
@@ -449,12 +668,43 @@ export interface components {
         Jwks: {
             keys: components["schemas"]["Jwk"][];
         };
+        /** @description Response of `POST /v1/builder/requests` and `GET /v1/builder/requests/me`. */
+        OnboardingRequest: {
+            agent_description: string;
+            company_name: string;
+            /** Format: int64 */
+            created_at: number;
+            email: string;
+            status: components["schemas"]["RequestStatus"];
+            user_id: string;
+            website: string;
+        };
+        /** @description Body of `POST /v1/builder/requests`. */
+        OnboardingRequestBody: {
+            agent_description: string;
+            company_name: string;
+            website: string;
+        };
+        /** @description Response of `GET /v1/admin/builder-requests`. */
+        OnboardingRequestList: {
+            requests: components["schemas"]["OnboardingRequest"][];
+        };
+        /**
+         * @description The status of an onboarding request. See the builder platform page, section 3.
+         * @enum {string}
+         */
+        RequestStatus: "pending" | "accepted" | "rejected";
         /** @description Body of `POST /oauth/revoke`. `token` is a refresh token. */
         RevokeRequest: {
             client_id: string;
             client_secret: string;
             token: string;
         };
+        /**
+         * @description The roles from the builder platform page, section 2. A later variant includes the earlier ones.
+         * @enum {string}
+         */
+        Role: "user" | "builder" | "admin";
         /**
          * @description A BubbleBridge scope. Each variant maps to one Google OAuth scope URL.
          * @enum {string}
@@ -493,12 +743,23 @@ export interface components {
             scope: string;
             user_id: string;
         };
+        /** @description Body of `PATCH /v1/builder/agents/:agentId`. A missing field keeps its value. */
+        UpdateAgentBody: {
+            description?: string | null;
+            homepage_url?: string | null;
+            logo_url?: string | null;
+            name?: string | null;
+            redirect_uris?: string[] | null;
+            requested_scopes?: components["schemas"]["Scope"][] | null;
+            status?: components["schemas"]["AgentStatus"] | null;
+        };
         /** @description Response of `POST /auth/google` and `GET /auth/me`. */
         User: {
             avatar_url?: string | null;
             email: string;
             id: string;
             name: string;
+            role: components["schemas"]["Role"];
         };
     };
     responses: never;
@@ -709,6 +970,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": components["schemas"]["RevokeRequest"];
+                "application/x-www-form-urlencoded": components["schemas"]["RevokeRequest"];
             };
         };
         responses: {
@@ -738,6 +1000,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": components["schemas"]["TokenRequest"];
+                "application/x-www-form-urlencoded": components["schemas"]["TokenRequest"];
             };
         };
         responses: {
@@ -767,9 +1030,11 @@ export interface operations {
             };
         };
     };
-    list_catalog: {
+    list_requests: {
         parameters: {
-            query?: never;
+            query: {
+                status: components["schemas"]["RequestStatus"];
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -781,7 +1046,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AgentList"];
+                    "application/json": components["schemas"]["OnboardingRequestList"];
                 };
             };
             401: {
@@ -792,15 +1057,22 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
         };
     };
-    get: {
+    accept: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description The agent slug */
-                slug: string;
+                user_id: string;
             };
             cookie?: never;
         };
@@ -811,7 +1083,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["Agent"];
+                    "application/json": components["schemas"]["InviteCodeResponse"];
                 };
             };
             401: {
@@ -822,6 +1094,14 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -830,13 +1110,23 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
         };
     };
-    checkout: {
+    reject: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                user_id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
@@ -846,7 +1136,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["StripeUrl"];
+                    "application/json": components["schemas"]["OnboardingRequest"];
                 };
             };
             401: {
@@ -857,9 +1147,33 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
         };
     };
-    portal: {
+    list_catalog: {
         parameters: {
             query?: never;
             header?: never;
@@ -873,7 +1187,431 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["StripeUrl"];
+                    "application/json": components["schemas"]["AgentList"];
+                };
+            };
+        };
+    };
+    get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The agent slug */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Agent"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    status: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BillingStatus"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    checkout: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StripeUrl"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    portal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StripeUrl"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    list_builder_agents: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BuilderAgentList"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    create_builder_agent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateAgentBody"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreatedAgent"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    update_builder_agent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateAgentBody"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BuilderAgent"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    rotate_builder_agent_secret: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                agent_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClientSecret"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    redeem_invite: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InviteRedeemBody"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["User"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    create_request: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["OnboardingRequestBody"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OnboardingRequest"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    my_request: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OnboardingRequest"];
                 };
             };
             401: {
@@ -933,7 +1671,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Redirect to the connections page */
+            /** @description Redirect to return_to from the start request, or to the connections page */
             303: {
                 headers: {
                     [name: string]: unknown;
@@ -962,6 +1700,7 @@ export interface operations {
         parameters: {
             query: {
                 scopes: string;
+                return_to?: string;
             };
             header?: never;
             path?: never;

package/dist/gmail.js

@@ -1,3 +1,4 @@
+import { base64Url } from './base64url.js';
 /** The Gmail helpers. `Google.gmail` holds it. */
 export class Gmail {
     google;
@@ -8,7 +9,7 @@ export class Gmail {
     send(email) {
         const message = `To: ${email.to}\r\nSubject: ${email.subject}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${email.text}`;
         return this.google.request('POST', '/gmail/v1/users/me/messages/send', {
-            raw: base64Url(message),
+            raw: base64Url(new TextEncoder().encode(message)),
         });
     }
     /** Lists the message IDs that match a Gmail search query. */
@@ -17,10 +18,3 @@ export class Gmail {
         return this.google.request('GET', `/gmail/v1/users/me/messages?${params}`);
     }
 }
-function base64Url(text) {
-    const bytes = new TextEncoder().encode(text);
-    let binary = '';
-    for (const byte of bytes)
-        binary += String.fromCharCode(byte);
-    return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
-}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export type { components, operations, paths } from './generated.js';
 export type { Connection, ConnectionList, ConnectionStatus, Method, Scope, TokenResponse, } from './types.js';
 export { ApiError, UpstreamError } from './error.js';
 export { Oauth, type AuthorizeUrlInput, type ExchangeCodeInput } from './oauth.js';
+export { pkce, type Pkce } from './pkce.js';
 export { UserClient, type ForUserOptions, type OnTokensUpdated } from './user.js';
 export { Google } from './google.js';
 export { Gmail, type SendEmail } from './gmail.js';

package/dist/index.js

@@ -2,6 +2,7 @@ import { Oauth } from './oauth.js';
 import { UserClient } from './user.js';
 export { ApiError, UpstreamError } from './error.js';
 export { Oauth } from './oauth.js';
+export { pkce } from './pkce.js';
 export { UserClient } from './user.js';
 export { Google } from './google.js';
 export { Gmail } from './gmail.js';

package/dist/pkce.d.ts

@@ -0,0 +1,8 @@
+/** The values for one consent flow. The agent site stores `state` and `codeVerifier` and sends `codeChallenge` to the consent page. */
+export interface Pkce {
+    state: string;
+    codeVerifier: string;
+    codeChallenge: string;
+}
+/** A random `state` value, a random PKCE verifier, and its S256 challenge. */
+export declare function pkce(): Promise<Pkce>;

package/dist/pkce.js

@@ -0,0 +1,8 @@
+import { base64Url } from './base64url.js';
+/** A random `state` value, a random PKCE verifier, and its S256 challenge. */
+export async function pkce() {
+    const state = base64Url(crypto.getRandomValues(new Uint8Array(16)));
+    const codeVerifier = base64Url(crypto.getRandomValues(new Uint8Array(32)));
+    const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(codeVerifier));
+    return { state, codeVerifier, codeChallenge: base64Url(new Uint8Array(digest)) };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblebridge/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The BubbleBridge SDK for agent builders",
   "keywords": ["bubblebridge", "oauth", "gmail", "google-calendar", "agent"],
   "homepage": "https://bubblebridge.io",