@revstackhq/node 0.0.0-dev-20260226054346

package/dist/modules/admin/entitlements.js

@@ -0,0 +1,87 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Admin client for managing entitlement definitions (CRUD + upsert).
+ * Entitlements define the features and capabilities that can be gated behind plans.
+ *
+ * The `upsert()` method is idempotent by `slug`, making it safe for repeated
+ * CLI deployments without creating duplicates.
+ *
+ * @example
+ * ```typescript
+ * await revstack.admin.entitlements.upsert({
+ *   slug: "api-calls",
+ *   name: "API Calls",
+ *   type: "metered",
+ *   unitType: "count",
+ * });
+ * ```
+ */
+export class AdminEntitlementsClient extends BaseClient {
+    /**
+     * List all entitlement definitions with optional pagination.
+     *
+     * @param params - Pagination parameters.
+     * @returns A paginated list of entitlements.
+     */
+    async list(params) {
+        return this.request(`/admin/entitlements${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * Retrieve a single entitlement definition by ID.
+     *
+     * @param entitlementId - The entitlement's unique identifier.
+     * @returns The entitlement definition.
+     */
+    async get(entitlementId) {
+        return this.request(`/admin/entitlements/${entitlementId}`, {
+            method: "GET",
+        });
+    }
+    /**
+     * Create a new entitlement definition.
+     *
+     * @param params - Entitlement creation parameters.
+     * @returns The newly created entitlement.
+     */
+    async create(params) {
+        return this.request("/admin/entitlements", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Partially update an existing entitlement definition.
+     *
+     * @param entitlementId - The entitlement's unique identifier.
+     * @param params - Fields to update.
+     * @returns The updated entitlement.
+     */
+    async update(entitlementId, params) {
+        return this.request(`/admin/entitlements/${entitlementId}`, {
+            method: "PATCH",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Delete an entitlement definition. Fails if any active plans reference it.
+     *
+     * @param entitlementId - The entitlement's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    async delete(entitlementId) {
+        return this.request(`/admin/entitlements/${entitlementId}`, { method: "DELETE" });
+    }
+    /**
+     * Idempotently create or update an entitlement by its `slug`.
+     * If an entitlement with the given slug exists, it is updated; otherwise, it is created.
+     *
+     * @param params - Full entitlement state.
+     * @returns The created or updated entitlement.
+     */
+    async upsert(params) {
+        return this.request("/admin/entitlements", {
+            method: "PUT",
+            body: JSON.stringify(params),
+        });
+    }
+}

package/dist/modules/admin/environments.d.ts

@@ -0,0 +1,71 @@
+import { BaseClient } from "@/modules/base";
+import { Environment, CreateEnvironmentParams, UpdateEnvironmentParams, ListParams, PaginatedResponse } from "@/types";
+/**
+ * Admin client for managing deployment environments.
+ * Each environment has its own API keys, auth configuration, and integrations.
+ *
+ * @example
+ * ```typescript
+ * // Create a staging environment
+ * const env = await revstack.admin.environments.create({
+ *   name: "staging",
+ *   authProvider: "supabase",
+ *   authJwksUri: "https://my-project.supabase.co/.well-known/jwks.json",
+ * });
+ *
+ * // Rotate API keys after a security incident
+ * const newKeys = await revstack.admin.environments.rotateKeys(env.id);
+ * ```
+ */
+export declare class AdminEnvironmentsClient extends BaseClient {
+    /**
+     * List all environments with optional pagination.
+     *
+     * @param params - Pagination parameters.
+     * @returns A paginated list of environments.
+     */
+    list(params?: ListParams): Promise<PaginatedResponse<Environment>>;
+    /**
+     * Retrieve a single environment by ID.
+     *
+     * @param environmentId - The environment's unique identifier.
+     * @returns The environment record including API keys and auth config.
+     */
+    get(environmentId: string): Promise<Environment>;
+    /**
+     * Create a new deployment environment.
+     *
+     * @param params - Environment creation parameters.
+     * @returns The newly created environment with generated API keys.
+     */
+    create(params: CreateEnvironmentParams): Promise<Environment>;
+    /**
+     * Update an existing environment's name or auth configuration.
+     *
+     * @param environmentId - The environment's unique identifier.
+     * @param params - Fields to update.
+     * @returns The updated environment.
+     */
+    update(environmentId: string, params: UpdateEnvironmentParams): Promise<Environment>;
+    /**
+     * Delete an environment. This invalidates its API keys immediately.
+     *
+     * @param environmentId - The environment's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    delete(environmentId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Rotate both the public and secret API keys for an environment.
+     * The old keys become invalid immediately. Use this after a security incident.
+     *
+     * @param environmentId - The environment whose keys to rotate.
+     * @returns The new API key pair.
+     */
+    rotateKeys(environmentId: string): Promise<{
+        apiKeyPublic: string;
+        apiKeySecret: string;
+    }>;
+}
+//# sourceMappingURL=environments.d.ts.map

package/dist/modules/admin/environments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../../../src/modules/admin/environments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD;;;;;OAKG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAOxE;;;;;OAKG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMtD;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAOnE;;;;;;OAMG;IACG,MAAM,CACV,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAOvB;;;;;OAKG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAOlE;;;;;;OAMG;IACG,UAAU,CACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAM3D"}

package/dist/modules/admin/environments.js

@@ -0,0 +1,84 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Admin client for managing deployment environments.
+ * Each environment has its own API keys, auth configuration, and integrations.
+ *
+ * @example
+ * ```typescript
+ * // Create a staging environment
+ * const env = await revstack.admin.environments.create({
+ *   name: "staging",
+ *   authProvider: "supabase",
+ *   authJwksUri: "https://my-project.supabase.co/.well-known/jwks.json",
+ * });
+ *
+ * // Rotate API keys after a security incident
+ * const newKeys = await revstack.admin.environments.rotateKeys(env.id);
+ * ```
+ */
+export class AdminEnvironmentsClient extends BaseClient {
+    /**
+     * List all environments with optional pagination.
+     *
+     * @param params - Pagination parameters.
+     * @returns A paginated list of environments.
+     */
+    async list(params) {
+        return this.request(`/admin/environments${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * Retrieve a single environment by ID.
+     *
+     * @param environmentId - The environment's unique identifier.
+     * @returns The environment record including API keys and auth config.
+     */
+    async get(environmentId) {
+        return this.request(`/admin/environments/${environmentId}`, {
+            method: "GET",
+        });
+    }
+    /**
+     * Create a new deployment environment.
+     *
+     * @param params - Environment creation parameters.
+     * @returns The newly created environment with generated API keys.
+     */
+    async create(params) {
+        return this.request("/admin/environments", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Update an existing environment's name or auth configuration.
+     *
+     * @param environmentId - The environment's unique identifier.
+     * @param params - Fields to update.
+     * @returns The updated environment.
+     */
+    async update(environmentId, params) {
+        return this.request(`/admin/environments/${environmentId}`, {
+            method: "PATCH",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Delete an environment. This invalidates its API keys immediately.
+     *
+     * @param environmentId - The environment's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    async delete(environmentId) {
+        return this.request(`/admin/environments/${environmentId}`, { method: "DELETE" });
+    }
+    /**
+     * Rotate both the public and secret API keys for an environment.
+     * The old keys become invalid immediately. Use this after a security incident.
+     *
+     * @param environmentId - The environment whose keys to rotate.
+     * @returns The new API key pair.
+     */
+    async rotateKeys(environmentId) {
+        return this.request(`/admin/environments/${environmentId}/rotate-keys`, { method: "POST" });
+    }
+}

package/dist/modules/admin/index.d.ts

@@ -0,0 +1,30 @@
+import { AdminPlansClient } from "@/modules/admin/plans";
+import { AdminEntitlementsClient } from "@/modules/admin/entitlements";
+import { AdminIntegrationsClient } from "@/modules/admin/integrations";
+import { AdminEnvironmentsClient } from "@/modules/admin/environments";
+import { AdminSystemClient } from "@/modules/admin/system";
+/**
+ * Aggregated admin client that bundles all Control Plane modules.
+ * Exposed as `revstack.admin` on the main {@link Revstack} class.
+ *
+ * Used by the CLI (`npx revstack push`) for Billing as Code deployments
+ * and by advanced integrations that need full infrastructure control.
+ */
+export declare class AdminClient {
+    /** Manage billing plans (CRUD + idempotent upsert). */
+    readonly plans: AdminPlansClient;
+    /** Manage entitlement definitions (CRUD + idempotent upsert). */
+    readonly entitlements: AdminEntitlementsClient;
+    /** Manage payment provider integrations and their events/metrics. */
+    readonly integrations: AdminIntegrationsClient;
+    /** Manage deployment environments and API keys. */
+    readonly environments: AdminEnvironmentsClient;
+    /** Billing as Code orchestrator for atomic state synchronization. */
+    readonly system: AdminSystemClient;
+    constructor(config: {
+        secretKey: string;
+        baseUrl: string;
+        timeout: number;
+    });
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/admin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,uDAAuD;IACvD,SAAgB,KAAK,EAAE,gBAAgB,CAAC;IACxC,iEAAiE;IACjE,SAAgB,YAAY,EAAE,uBAAuB,CAAC;IACtD,qEAAqE;IACrE,SAAgB,YAAY,EAAE,uBAAuB,CAAC;IACtD,mDAAmD;IACnD,SAAgB,YAAY,EAAE,uBAAuB,CAAC;IACtD,qEAAqE;IACrE,SAAgB,MAAM,EAAE,iBAAiB,CAAC;gBAE9B,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAO5E"}

package/dist/modules/admin/index.js

@@ -0,0 +1,31 @@
+import { AdminPlansClient } from "@/modules/admin/plans";
+import { AdminEntitlementsClient } from "@/modules/admin/entitlements";
+import { AdminIntegrationsClient } from "@/modules/admin/integrations";
+import { AdminEnvironmentsClient } from "@/modules/admin/environments";
+import { AdminSystemClient } from "@/modules/admin/system";
+/**
+ * Aggregated admin client that bundles all Control Plane modules.
+ * Exposed as `revstack.admin` on the main {@link Revstack} class.
+ *
+ * Used by the CLI (`npx revstack push`) for Billing as Code deployments
+ * and by advanced integrations that need full infrastructure control.
+ */
+export class AdminClient {
+    /** Manage billing plans (CRUD + idempotent upsert). */
+    plans;
+    /** Manage entitlement definitions (CRUD + idempotent upsert). */
+    entitlements;
+    /** Manage payment provider integrations and their events/metrics. */
+    integrations;
+    /** Manage deployment environments and API keys. */
+    environments;
+    /** Billing as Code orchestrator for atomic state synchronization. */
+    system;
+    constructor(config) {
+        this.plans = new AdminPlansClient(config);
+        this.entitlements = new AdminEntitlementsClient(config);
+        this.integrations = new AdminIntegrationsClient(config);
+        this.environments = new AdminEnvironmentsClient(config);
+        this.system = new AdminSystemClient(config);
+    }
+}

package/dist/modules/admin/integrations.d.ts

@@ -0,0 +1,79 @@
+import { BaseClient } from "@/modules/base";
+import { Integration, CreateIntegrationParams, UpdateIntegrationParams, ListIntegrationsParams, ProviderEvent, ListProviderEventsParams, IntegrationMetric, ListMetricsParams, PaginatedResponse } from "@/types";
+/**
+ * Admin client for managing payment provider integrations.
+ * Supports CRUD operations on integrations (e.g. Stripe, Paddle) and
+ * read access to their webhook events and hourly metrics.
+ *
+ * @example
+ * ```typescript
+ * // Create a Stripe integration
+ * await revstack.admin.integrations.create({
+ *   provider: "stripe",
+ *   credentials: { apiKey: "sk_live_..." },
+ *   webhookSecret: "whsec_...",
+ * });
+ *
+ * // View recent webhook events
+ * const { data: events } = await revstack.admin.integrations.listEvents("int_abc");
+ * ```
+ */
+export declare class AdminIntegrationsClient extends BaseClient {
+    /**
+     * List all integrations with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of integrations.
+     */
+    list(params?: ListIntegrationsParams): Promise<PaginatedResponse<Integration>>;
+    /**
+     * Retrieve a single integration by ID.
+     *
+     * @param integrationId - The integration's unique identifier.
+     * @returns The integration record.
+     */
+    get(integrationId: string): Promise<Integration>;
+    /**
+     * Create a new payment provider integration.
+     *
+     * @param params - Integration creation parameters.
+     * @returns The newly created integration.
+     */
+    create(params: CreateIntegrationParams): Promise<Integration>;
+    /**
+     * Update an existing integration's credentials, webhook secret, or active status.
+     *
+     * @param integrationId - The integration's unique identifier.
+     * @param params - Fields to update.
+     * @returns The updated integration.
+     */
+    update(integrationId: string, params: UpdateIntegrationParams): Promise<Integration>;
+    /**
+     * Delete an integration. This stops webhook processing for the provider.
+     *
+     * @param integrationId - The integration's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    delete(integrationId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * List webhook events received by an integration.
+     * Useful for debugging webhook delivery and processing issues.
+     *
+     * @param integrationId - The integration to query events for.
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of provider events.
+     */
+    listEvents(integrationId: string, params?: ListProviderEventsParams): Promise<PaginatedResponse<ProviderEvent>>;
+    /**
+     * List hourly aggregated metrics for an integration.
+     * Shows volume processed and event counts per hour.
+     *
+     * @param integrationId - The integration to query metrics for.
+     * @param params - Time range and pagination parameters.
+     * @returns A paginated list of hourly metrics.
+     */
+    listMetrics(integrationId: string, params?: ListMetricsParams): Promise<PaginatedResponse<IntegrationMetric>>;
+}
+//# sourceMappingURL=integrations.d.ts.map

package/dist/modules/admin/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../src/modules/admin/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD;;;;;OAKG;IACG,IAAI,CACR,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAO1C;;;;;OAKG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMtD;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAOnE;;;;;;OAMG;IACG,MAAM,CACV,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAOvB;;;;;OAKG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAOlE;;;;;;;OAOG;IACG,UAAU,CACd,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAO5C;;;;;;;OAOG;IACG,WAAW,CACf,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;CAMjD"}

package/dist/modules/admin/integrations.js

@@ -0,0 +1,97 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Admin client for managing payment provider integrations.
+ * Supports CRUD operations on integrations (e.g. Stripe, Paddle) and
+ * read access to their webhook events and hourly metrics.
+ *
+ * @example
+ * ```typescript
+ * // Create a Stripe integration
+ * await revstack.admin.integrations.create({
+ *   provider: "stripe",
+ *   credentials: { apiKey: "sk_live_..." },
+ *   webhookSecret: "whsec_...",
+ * });
+ *
+ * // View recent webhook events
+ * const { data: events } = await revstack.admin.integrations.listEvents("int_abc");
+ * ```
+ */
+export class AdminIntegrationsClient extends BaseClient {
+    /**
+     * List all integrations with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of integrations.
+     */
+    async list(params) {
+        return this.request(`/admin/integrations${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * Retrieve a single integration by ID.
+     *
+     * @param integrationId - The integration's unique identifier.
+     * @returns The integration record.
+     */
+    async get(integrationId) {
+        return this.request(`/admin/integrations/${integrationId}`, {
+            method: "GET",
+        });
+    }
+    /**
+     * Create a new payment provider integration.
+     *
+     * @param params - Integration creation parameters.
+     * @returns The newly created integration.
+     */
+    async create(params) {
+        return this.request("/admin/integrations", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Update an existing integration's credentials, webhook secret, or active status.
+     *
+     * @param integrationId - The integration's unique identifier.
+     * @param params - Fields to update.
+     * @returns The updated integration.
+     */
+    async update(integrationId, params) {
+        return this.request(`/admin/integrations/${integrationId}`, {
+            method: "PATCH",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Delete an integration. This stops webhook processing for the provider.
+     *
+     * @param integrationId - The integration's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    async delete(integrationId) {
+        return this.request(`/admin/integrations/${integrationId}`, { method: "DELETE" });
+    }
+    /**
+     * List webhook events received by an integration.
+     * Useful for debugging webhook delivery and processing issues.
+     *
+     * @param integrationId - The integration to query events for.
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of provider events.
+     */
+    async listEvents(integrationId, params) {
+        return this.request(`/admin/integrations/${integrationId}/events${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * List hourly aggregated metrics for an integration.
+     * Shows volume processed and event counts per hour.
+     *
+     * @param integrationId - The integration to query metrics for.
+     * @param params - Time range and pagination parameters.
+     * @returns A paginated list of hourly metrics.
+     */
+    async listMetrics(integrationId, params) {
+        return this.request(`/admin/integrations/${integrationId}/metrics${this.buildQuery(params)}`, { method: "GET" });
+    }
+}

package/dist/modules/admin/plans.d.ts

@@ -0,0 +1,72 @@
+import { BaseClient } from "@/modules/base";
+import { Plan, CreatePlanParams, UpdatePlanParams, UpsertPlanParams, ListPlansParams, PaginatedResponse } from "@/types";
+/**
+ * Admin client for managing billing plans (CRUD + upsert).
+ * Used by the CLI (`npx revstack push`) and advanced integrations.
+ *
+ * The `upsert()` method is the primary primitive for Billing as Code —
+ * it creates or updates a plan by its `slug`, making deployments idempotent.
+ *
+ * @example
+ * ```typescript
+ * await revstack.admin.plans.upsert({
+ *   slug: "pro",
+ *   name: "Pro",
+ *   status: "active",
+ *   prices: [{ amount: 4900, currency: "USD", billingInterval: "month" }],
+ *   entitlements: [{ entitlementSlug: "api-calls", valueLimit: 10000 }],
+ * });
+ * ```
+ */
+export declare class AdminPlansClient extends BaseClient {
+    /**
+     * List all plans with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of plans.
+     */
+    list(params?: ListPlansParams): Promise<PaginatedResponse<Plan>>;
+    /**
+     * Retrieve a plan by ID, including nested prices and entitlements.
+     *
+     * @param planId - The plan's unique identifier.
+     * @returns The plan with populated `prices[]` and `entitlements[]`.
+     */
+    get(planId: string): Promise<Plan>;
+    /**
+     * Create a new billing plan with optional prices and entitlements.
+     *
+     * @param params - Plan creation parameters.
+     * @returns The newly created plan.
+     */
+    create(params: CreatePlanParams): Promise<Plan>;
+    /**
+     * Partially update an existing plan's attributes.
+     * Does not modify prices or entitlements — use `upsert()` for that.
+     *
+     * @param planId - The plan's unique identifier.
+     * @param params - Fields to update.
+     * @returns The updated plan.
+     */
+    update(planId: string, params: UpdatePlanParams): Promise<Plan>;
+    /**
+     * Delete a plan. Fails if the plan has active subscriptions.
+     *
+     * @param planId - The plan's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    delete(planId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Idempotently create or update a plan by its `slug`.
+     * This is the primary method used by the CLI for Billing as Code deployments.
+     * If a plan with the given slug exists, it is updated; otherwise, it is created.
+     * Nested prices and entitlements are replaced atomically.
+     *
+     * @param params - Full plan state including prices and entitlements.
+     * @returns The created or updated plan.
+     */
+    upsert(params: UpsertPlanParams): Promise<Plan>;
+}
+//# sourceMappingURL=plans.d.ts.map

package/dist/modules/admin/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../../src/modules/admin/plans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C;;;;;OAKG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAOtE;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrE;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAM3D;;;;;;;;OAQG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAMtD"}

package/dist/modules/admin/plans.js

@@ -0,0 +1,93 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Admin client for managing billing plans (CRUD + upsert).
+ * Used by the CLI (`npx revstack push`) and advanced integrations.
+ *
+ * The `upsert()` method is the primary primitive for Billing as Code —
+ * it creates or updates a plan by its `slug`, making deployments idempotent.
+ *
+ * @example
+ * ```typescript
+ * await revstack.admin.plans.upsert({
+ *   slug: "pro",
+ *   name: "Pro",
+ *   status: "active",
+ *   prices: [{ amount: 4900, currency: "USD", billingInterval: "month" }],
+ *   entitlements: [{ entitlementSlug: "api-calls", valueLimit: 10000 }],
+ * });
+ * ```
+ */
+export class AdminPlansClient extends BaseClient {
+    /**
+     * List all plans with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of plans.
+     */
+    async list(params) {
+        return this.request(`/admin/plans${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * Retrieve a plan by ID, including nested prices and entitlements.
+     *
+     * @param planId - The plan's unique identifier.
+     * @returns The plan with populated `prices[]` and `entitlements[]`.
+     */
+    async get(planId) {
+        return this.request(`/admin/plans/${planId}`, {
+            method: "GET",
+        });
+    }
+    /**
+     * Create a new billing plan with optional prices and entitlements.
+     *
+     * @param params - Plan creation parameters.
+     * @returns The newly created plan.
+     */
+    async create(params) {
+        return this.request("/admin/plans", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Partially update an existing plan's attributes.
+     * Does not modify prices or entitlements — use `upsert()` for that.
+     *
+     * @param planId - The plan's unique identifier.
+     * @param params - Fields to update.
+     * @returns The updated plan.
+     */
+    async update(planId, params) {
+        return this.request(`/admin/plans/${planId}`, {
+            method: "PATCH",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Delete a plan. Fails if the plan has active subscriptions.
+     *
+     * @param planId - The plan's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    async delete(planId) {
+        return this.request(`/admin/plans/${planId}`, {
+            method: "DELETE",
+        });
+    }
+    /**
+     * Idempotently create or update a plan by its `slug`.
+     * This is the primary method used by the CLI for Billing as Code deployments.
+     * If a plan with the given slug exists, it is updated; otherwise, it is created.
+     * Nested prices and entitlements are replaced atomically.
+     *
+     * @param params - Full plan state including prices and entitlements.
+     * @returns The created or updated plan.
+     */
+    async upsert(params) {
+        return this.request("/admin/plans", {
+            method: "PUT",
+            body: JSON.stringify(params),
+        });
+    }
+}