rocketride 1.0.6 → 1.1.0

package/dist/cli/client/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/client/types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;AAEH;;;;GAIG;AAEH,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B;AAC5B,gDAA8B;AAC9B,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/client/types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;AAEH;;;;GAIG;AAEH,+CAA6B;AAC7B,+CAA6B;AAC7B,8CAA4B;AAC5B,gDAA8B;AAC9B,iDAA+B;AAC/B,4CAA0B;AAC1B,8CAA4B;AAC5B,gDAA8B;AAC9B,+CAA6B;AAC7B,4CAA0B"}

package/dist/cli/client/types/service.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 Aparavi Software AG
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOCOL_CAPS = void 0;
+// ============================================================================
+// PROTOCOL CAPABILITY FLAGS
+// ============================================================================
+/**
+ * Protocol capability flags for service drivers.
+ *
+ * Each flag is a single bit in a uint32 bitmask describing what a service
+ * driver supports. Values are returned by the engine in the `capabilities`
+ * field of a service definition and can be tested with bitwise AND.
+ *
+ * @example
+ * ```typescript
+ * const services = await client.getServices();
+ * const svc = services.services['my_driver'];
+ * if (svc.capabilities & PROTOCOL_CAPS.GPU) {
+ *   console.log('Driver requires a GPU');
+ * }
+ * ```
+ */
+var PROTOCOL_CAPS;
+(function (PROTOCOL_CAPS) {
+    /** No capabilities */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["NONE"] = 0] = "NONE";
+    /** Supports the file permissions interface */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["SECURITY"] = 1] = "SECURITY";
+    /** Is a filesystem interface */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["FILESYSTEM"] = 2] = "FILESYSTEM";
+    /** Supports the substream interface */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["SUBSTREAM"] = 4] = "SUBSTREAM";
+    /** Uses a network interface */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["NETWORK"] = 8] = "NETWORK";
+    /** Uses datanet or streamnet interfaces */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["DATANET"] = 16] = "DATANET";
+    /** Uses delta queries to track changes */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["SYNC"] = 32] = "SYNC";
+    /** Internal — will not be returned in services.json */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["INTERNAL"] = 64] = "INTERNAL";
+    /** Supports data catalog operations */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["CATALOG"] = 128] = "CATALOG";
+    /** Do not monitor for excessive failures */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["NOMONITOR"] = 256] = "NOMONITOR";
+    /** Source endpoint does not use include */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["NOINCLUDE"] = 512] = "NOINCLUDE";
+    /** Driver supports the invoke function */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["INVOKE"] = 1024] = "INVOKE";
+    /** Driver supports remoting execution */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["REMOTING"] = 2048] = "REMOTING";
+    /** Driver requires a GPU */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["GPU"] = 4096] = "GPU";
+    /** Driver is not SaaS compatible */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["NOSAAS"] = 8192] = "NOSAAS";
+    /** Focus on this driver */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["FOCUS"] = 16384] = "FOCUS";
+    /** Driver is deprecated */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["DEPRECATED"] = 32768] = "DEPRECATED";
+    /** Driver is experimental */
+    PROTOCOL_CAPS[PROTOCOL_CAPS["EXPERIMENTAL"] = 65536] = "EXPERIMENTAL";
+})(PROTOCOL_CAPS || (exports.PROTOCOL_CAPS = PROTOCOL_CAPS = {}));
+//# sourceMappingURL=service.js.map

package/dist/cli/client/types/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../src/client/types/service.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AA8HH,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,IAAY,aAsDX;AAtDD,WAAY,aAAa;IACxB,sBAAsB;IACtB,iDAAQ,CAAA;IAER,8CAA8C;IAC9C,yDAAiB,CAAA;IAEjB,gCAAgC;IAChC,6DAAmB,CAAA;IAEnB,uCAAuC;IACvC,2DAAkB,CAAA;IAElB,+BAA+B;IAC/B,uDAAgB,CAAA;IAEhB,2CAA2C;IAC3C,wDAAgB,CAAA;IAEhB,0CAA0C;IAC1C,kDAAa,CAAA;IAEb,uDAAuD;IACvD,0DAAiB,CAAA;IAEjB,uCAAuC;IACvC,yDAAgB,CAAA;IAEhB,4CAA4C;IAC5C,6DAAkB,CAAA;IAElB,2CAA2C;IAC3C,6DAAkB,CAAA;IAElB,0CAA0C;IAC1C,wDAAgB,CAAA;IAEhB,yCAAyC;IACzC,4DAAkB,CAAA;IAElB,4BAA4B;IAC5B,kDAAa,CAAA;IAEb,oCAAoC;IACpC,wDAAgB,CAAA;IAEhB,2BAA2B;IAC3B,uDAAe,CAAA;IAEf,2BAA2B;IAC3B,iEAAoB,CAAA;IAEpB,6BAA6B;IAC7B,qEAAsB,CAAA;AACvB,CAAC,EAtDW,aAAa,6BAAb,aAAa,QAsDxB"}

package/dist/esm/account.js

@@ -0,0 +1,280 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 Aparavi Software AG
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+// =============================================================================
+// ACCOUNT API CLASS
+// =============================================================================
+/**
+ * Typed wrapper around the `rrext_account_*` DAP commands.
+ *
+ * Accessed via `client.account` — not instantiated directly. All methods
+ * delegate to {@link RocketRideClient.dap} which handles envelope
+ * unwrapping and error propagation.
+ */
+export class AccountApi {
+    /** @param client - The parent RocketRideClient that owns this namespace. */
+    constructor(client) {
+        this.client = client;
+    }
+    // =========================================================================
+    // PROFILE
+    // =========================================================================
+    /**
+     * Fetches the current user's profile from the server.
+     *
+     * @returns The user's profile data.
+     */
+    async getProfile() {
+        return this.client.call('rrext_account_me', { subcommand: 'get' });
+    }
+    /**
+     * Persists updated profile fields.
+     *
+     * @param fields - The profile fields to update.
+     */
+    async updateProfile(fields) {
+        await this.client.call('rrext_account_me', { subcommand: 'update', ...fields });
+    }
+    /**
+     * Sets the user's preferred default team.
+     *
+     * @param teamId - The team ID to set as default.
+     */
+    async setDefaultTeam(teamId) {
+        await this.client.call('rrext_account_me', { subcommand: 'set_default_team', teamId });
+    }
+    /**
+     * Permanently deletes the current user's account.
+     */
+    async deleteAccount() {
+        await this.client.call('rrext_account_me', { subcommand: 'delete' });
+    }
+    // =========================================================================
+    // ORGANIZATION
+    // =========================================================================
+    /**
+     * Fetches the organization detail for the given org.
+     *
+     * @param orgId - Organisation UUID. The server may infer the org if omitted.
+     * @returns The organization detail (id, name, plan, memberCount, teamCount).
+     */
+    async getOrg(orgId) {
+        return this.client.call('rrext_account_org', { subcommand: 'get', ...(orgId ? { orgId } : {}) });
+    }
+    /**
+     * Updates the organization name.
+     *
+     * @param orgId - Organisation UUID.
+     * @param name  - The new organization name.
+     */
+    async updateOrgName(orgId, name) {
+        await this.client.call('rrext_account_org', { subcommand: 'update', orgId, name });
+    }
+    // =========================================================================
+    // API KEYS
+    // =========================================================================
+    /**
+     * Fetches the list of API keys for the current user.
+     *
+     * @returns Array of API key records.
+     */
+    async listKeys() {
+        const body = await this.client.call('rrext_account_keys', { subcommand: 'list' });
+        return body.keys ?? [];
+    }
+    /**
+     * Creates a new API key and returns the raw key string.
+     *
+     * @param params - Key creation parameters (name, permissions, expiresAt).
+     * @returns Object containing the raw key string.
+     */
+    async createKey(params) {
+        const body = await this.client.call('rrext_account_keys', { subcommand: 'create', ...params });
+        return { key: body.key };
+    }
+    /**
+     * Revokes an API key by its ID.
+     *
+     * @param keyId - The key to revoke.
+     */
+    async revokeKey(keyId) {
+        await this.client.call('rrext_account_keys', { subcommand: 'revoke', keyId });
+    }
+    // =========================================================================
+    // MEMBERS
+    // =========================================================================
+    /**
+     * Fetches the flat list of organization members.
+     *
+     * @param orgId - Organisation UUID.
+     * @returns Array of member records.
+     */
+    async listMembers(orgId) {
+        const body = await this.client.call('rrext_account_members', { subcommand: 'list', orgId });
+        return body.members ?? [];
+    }
+    /**
+     * Sends an invitation to a new organization member.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param params - Invitation parameters (email, givenName, familyName, role).
+     */
+    async inviteMember(orgId, params) {
+        await this.client.call('rrext_account_members', { subcommand: 'invite', orgId, ...params });
+    }
+    /**
+     * Updates an organization member's role.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param userId - The member's user ID.
+     * @param role   - The new role string.
+     */
+    async updateMemberRole(orgId, userId, role) {
+        await this.client.call('rrext_account_members', { subcommand: 'update', orgId, userId, role });
+    }
+    /**
+     * Removes an organization member.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param userId - The member's user ID.
+     */
+    async removeMember(orgId, userId) {
+        await this.client.call('rrext_account_members', { subcommand: 'delete', orgId, userId });
+    }
+    // =========================================================================
+    // TEAMS
+    // =========================================================================
+    /**
+     * Fetches the flat list of teams in the organization.
+     *
+     * @param orgId - Organisation UUID.
+     * @returns Array of team summary records.
+     */
+    async listTeams(orgId) {
+        const body = await this.client.call('rrext_account_teams', { subcommand: 'list', orgId });
+        return body.teams ?? [];
+    }
+    /**
+     * Fetches full detail (including member list) for a specific team.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param teamId - The team to load.
+     * @returns The team detail with nested members.
+     */
+    async getTeamDetail(orgId, teamId) {
+        return this.client.call('rrext_account_teams', { subcommand: 'get', orgId, teamId });
+    }
+    /**
+     * Creates a new team.
+     *
+     * @param orgId - Organisation UUID.
+     * @param name  - The team name.
+     */
+    async createTeam(orgId, name) {
+        await this.client.call('rrext_account_teams', { subcommand: 'create', orgId, name });
+    }
+    /**
+     * Deletes a team.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param teamId - The team to delete.
+     */
+    async deleteTeam(orgId, teamId) {
+        await this.client.call('rrext_account_teams', { subcommand: 'delete', orgId, teamId });
+    }
+    /**
+     * Adds a member to a team with specified permissions.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param params - Parameters (teamId, userId, permissions).
+     */
+    async addTeamMember(orgId, params) {
+        await this.client.call('rrext_account_teams', { subcommand: 'add_member', orgId, ...params });
+    }
+    /**
+     * Updates a team member's permissions.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param params - Parameters (teamId, userId, permissions).
+     */
+    async updateTeamMemberPerms(orgId, params) {
+        await this.client.call('rrext_account_teams', { subcommand: 'update_member', orgId, ...params });
+    }
+    /**
+     * Removes a member from a team.
+     *
+     * @param orgId  - Organisation UUID.
+     * @param params - Parameters (teamId, userId).
+     */
+    async removeTeamMember(orgId, params) {
+        await this.client.call('rrext_account_teams', { subcommand: 'delete_member', orgId, ...params });
+    }
+    // =========================================================================
+    // ENVIRONMENT SECRETS
+    // =========================================================================
+    /**
+     * Returns the available ROCKETRIDE_* key names from the merged environment.
+     * Does not return values — only key names for use in dropdowns.
+     *
+     * @returns Array of key names (e.g. ['ROCKETRIDE_ANTHROPIC_KEY', 'ROCKETRIDE_OPENAI_KEY']).
+     */
+    async getEnvironmentKeys() {
+        const body = await this.client.call('rrext_account_me', { subcommand: 'env_keys' });
+        return body.keys ?? [];
+    }
+    /**
+     * Reads the environment dict for a scope (org, team, or user).
+     *
+     * @param scope   - One of 'org', 'team', 'user'.
+     * @param scopeId - For org: orgId. For team: teamId. For user: omit (uses current user).
+     * @returns Decrypted key-value dict.
+     */
+    async getEnv(scope, scopeId) {
+        const command = scope === 'org' ? 'rrext_account_org' : scope === 'team' ? 'rrext_account_teams' : 'rrext_account_me';
+        const args = { subcommand: 'get_env' };
+        if (scope === 'org' && scopeId)
+            args.orgId = scopeId;
+        if (scope === 'team' && scopeId)
+            args.teamId = scopeId;
+        const body = await this.client.call(command, args);
+        return body.env ?? {};
+    }
+    /**
+     * Writes the full environment dict for a scope (org, team, or user).
+     * Replaces the entire set of keys at that scope level.
+     *
+     * @param scope   - One of 'org', 'team', 'user'.
+     * @param env     - Full key-value dict to store.
+     * @param scopeId - For org: orgId. For team: teamId. For user: omit.
+     */
+    async setEnv(scope, env, scopeId) {
+        const command = scope === 'org' ? 'rrext_account_org' : scope === 'team' ? 'rrext_account_teams' : 'rrext_account_me';
+        const args = { subcommand: 'set_env', env };
+        if (scope === 'org' && scopeId)
+            args.orgId = scopeId;
+        if (scope === 'team' && scopeId)
+            args.teamId = scopeId;
+        await this.client.call(command, args);
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/esm/account.js.map

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

package/dist/esm/billing.js

@@ -0,0 +1,167 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 Aparavi Software AG
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+// =============================================================================
+// BILLING API CLASS
+// =============================================================================
+/**
+ * Typed wrapper around the `rrext_account_billing` DAP command.
+ *
+ * Accessed via `client.billing` — not instantiated directly. All methods
+ * delegate to {@link RocketRideClient.dap} which handles envelope
+ * unwrapping and error propagation.
+ */
+export class BillingApi {
+    /** @param client - The parent RocketRideClient that owns this namespace. */
+    constructor(client) {
+        this.client = client;
+    }
+    // =========================================================================
+    // SUBSCRIPTION OPERATIONS
+    // =========================================================================
+    /**
+     * Fetches the per-app subscription details for the given org.
+     *
+     * @param orgId - Organisation UUID whose subscriptions to load.
+     * @returns Array of BillingDetail rows (one per subscribed app).
+     */
+    async getDetails(orgId) {
+        const body = await this.client.call('rrext_account_billing', { subcommand: 'list', orgId });
+        return body.subscriptions ?? [];
+    }
+    /**
+     * Fetches the active subscription plans (prices) for an app.
+     *
+     * Plans are returned sorted month-first, year-second, formatted for
+     * display in the checkout plan picker. The server resolves the app's
+     * Stripe product internally and calls `stripe.Price.list()` so pricing
+     * changes in the Stripe dashboard are reflected immediately.
+     *
+     * @param appId - App identifier (e.g. "rocketride.pipeBuilder").
+     * @returns Array of StripePlan objects ready for display.
+     */
+    async getProductPrices(appId) {
+        const body = await this.client.call('rrext_account_billing', { subcommand: 'prices', appId });
+        return body.plans ?? [];
+    }
+    /**
+     * Creates a Stripe subscription and returns the Stripe Elements client_secret.
+     *
+     * The returned client_secret is passed to `stripe.confirmPayment()` to
+     * complete the checkout without a browser redirect to Stripe.
+     *
+     * @param orgId   - Organisation UUID to subscribe.
+     * @param appId   - App being subscribed (e.g. "brandi").
+     * @param priceId - Stripe price_* identifier for the plan.
+     * @returns Object with client_secret for Stripe Elements and subscription_id.
+     */
+    async createCheckoutSession(orgId, appId, priceId) {
+        return this.client.call('rrext_account_billing', {
+            subcommand: 'subscribe',
+            orgId,
+            appId,
+            priceId,
+        });
+    }
+    /**
+     * Creates a Stripe Billing Portal session for managing payment methods.
+     *
+     * @param orgId     - Organisation UUID whose Stripe customer portal to open.
+     * @param returnUrl - URL to redirect the user back to after portal interaction.
+     * @returns Object with portal URL to redirect the user to.
+     */
+    async createPortalSession(orgId, returnUrl) {
+        return this.client.call('rrext_account_billing', {
+            subcommand: 'portal',
+            orgId,
+            returnUrl,
+        });
+    }
+    /**
+     * Schedules an app subscription for cancellation at the end of the current period.
+     *
+     * The user retains access until the period ends. The webhook handler will
+     * update `cancel_at_period_end` in the database asynchronously.
+     *
+     * @param orgId - Organisation UUID that owns the subscription.
+     * @param appId - App to cancel (e.g. "brandi").
+     * @returns Object with canceled: true on success.
+     */
+    async cancelSubscription(orgId, appId) {
+        return this.client.call('rrext_account_billing', {
+            subcommand: 'cancel',
+            orgId,
+            appId,
+        });
+    }
+    // =========================================================================
+    // COMPUTE CREDITS WALLET
+    // =========================================================================
+    /**
+     * Reads the org's compute credit balance.
+     *
+     * The balance lives in a Redis-backed wallet on the engine side; this
+     * call is cheap and safe to poll (~1 req/s is fine for a live widget).
+     *
+     * @param orgId - Organisation UUID to query.
+     * @returns The credit balance with lifetime stats.
+     */
+    async getCreditBalance(orgId) {
+        return this.client.call('rrext_account_billing', {
+            subcommand: 'credits_balance',
+            orgId,
+        });
+    }
+    /**
+     * Loads the purchasable credit packs, sourced from the Stripe catalog
+     * that Terraform maintains. Call once on modal mount.
+     *
+     * @returns Array of credit pack pricing rows.
+     */
+    async listCreditPacks() {
+        const body = await this.client.call('rrext_account_billing', { subcommand: 'credits_packs' });
+        return body.packs ?? [];
+    }
+    /**
+     * Creates a one-off Stripe Checkout session for a credit pack purchase
+     * and returns the redirect URL.
+     *
+     * The frontend redirects the user to Stripe-hosted checkout; on success
+     * Stripe redirects back to the app, and the `checkout.session.completed`
+     * webhook increments the wallet server-side.
+     *
+     * @param orgId     - Organisation UUID that the credits belong to.
+     * @param packId    - Pack key returned by {@link listCreditPacks}.
+     * @param returnUrl - Where Stripe sends the user after payment.
+     * @returns Object with the Stripe checkout URL.
+     */
+    async createCreditCheckout(orgId, packId, returnUrl) {
+        return this.client.call('rrext_account_billing', {
+            subcommand: 'credits_checkout',
+            orgId,
+            packId,
+            returnUrl,
+        });
+    }
+}
+//# sourceMappingURL=billing.js.map

package/dist/esm/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../src/client/billing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAaH,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACtB,4EAA4E;IAC5E,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEhD,4EAA4E;IAC5E,0BAA0B;IAC1B,4EAA4E;IAE5E;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAAa;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAAa,EAAE,KAAa,EAAE,OAAe;QACxE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAmD,uBAAuB,EAAE;YAClG,UAAU,EAAE,WAAW;YACvB,KAAK;YACL,KAAK;YACL,OAAO;SACP,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa,EAAE,SAAiB;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAkB,uBAAuB,EAAE;YACjE,UAAU,EAAE,QAAQ;YACpB,KAAK;YACL,SAAS;SACT,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAAa,EAAE,KAAa;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAwB,uBAAuB,EAAE;YACvE,UAAU,EAAE,QAAQ;YACpB,KAAK;YACL,KAAK;SACL,CAAC,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,yBAAyB;IACzB,4EAA4E;IAE5E;;;;;;;;OAQG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAAa;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAgB,uBAAuB,EAAE;YAC/D,UAAU,EAAE,iBAAiB;YAC7B,KAAK;SACL,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe;QACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,oBAAoB,CAAC,KAAa,EAAE,MAAc,EAAE,SAAiB;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAkB,uBAAuB,EAAE;YACjE,UAAU,EAAE,kBAAkB;YAC9B,KAAK;YACL,MAAM;YACN,SAAS;SACT,CAAC,CAAC;IACJ,CAAC;CACD"}