rocketride 1.0.6 → 1.1.1

package/README.md

@@ -7,10 +7,10 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/rocketride"><img src="https://img.shields.io/npm/v/rocketride?color=222223&label=npm" alt="npm"></a>
+  <a href="https://www.npmjs.com/package/rocketride"><img src="https://img.shields.io/npm/v/rocketride?color=222223&label=NPM" alt="npm"></a>
   <a href="https://github.com/rocketride-org/rocketride-server"><img src="https://img.shields.io/github/stars/rocketride-org/rocketride-server?style=flat&color=238636&label=GitHub&logo=github&logoColor=white" alt="GitHub"></a>
   <a href="https://discord.gg/9hr3tdZmEG"><img src="https://img.shields.io/badge/Discord-Join-370b7a?logo=discord&logoColor=white" alt="Discord"></a>
-  <a href="https://github.com/rocketride-org/rocketride-server/blob/develop/LICENSE"><img src="https://img.shields.io/badge/license-MIT-41b6e6" alt="MIT License"></a>
+  <a href="https://github.com/rocketride-org/rocketride-server/blob/develop/LICENSE"><img src="https://img.shields.io/badge/License-MIT-41b6e6" alt="MIT License"></a>
 </p>
 
 ## Quick Start

package/dist/cjs/account.js

@@ -0,0 +1,284 @@
+"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.AccountApi = void 0;
+// =============================================================================
+// 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.
+ */
+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);
+    }
+}
+exports.AccountApi = AccountApi;
+//# sourceMappingURL=account.js.map

package/dist/cjs/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/cjs/billing.js

@@ -0,0 +1,171 @@
+"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.BillingApi = void 0;
+// =============================================================================
+// 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.
+ */
+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,
+        });
+    }
+}
+exports.BillingApi = BillingApi;
+//# sourceMappingURL=billing.js.map

package/dist/cjs/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,MAAa,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;AA5ID,gCA4IC"}