@revstackhq/node 0.0.0-dev-20260226054346

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

@@ -0,0 +1,53 @@
+import { BaseClient } from "@/modules/base";
+import { SyncConfig, SyncResult, SyncPreview } from "@/types";
+/**
+ * Admin client for the Billing as Code orchestrator.
+ * Provides atomic sync operations used by the CLI (`npx revstack push`) to
+ * apply the full desired state from `revstack.config.ts` in a single ACID
+ * Postgres transaction.
+ *
+ * @example
+ * ```typescript
+ * const config: SyncConfig = {
+ *   plans: [
+ *     { slug: "free", name: "Free", type: "free", status: "active" },
+ *     { slug: "pro", name: "Pro", prices: [{ amount: 4900, billingInterval: "month" }] },
+ *   ],
+ *   entitlements: [
+ *     { slug: "api-calls", name: "API Calls", type: "metered", unitType: "count" },
+ *   ],
+ * };
+ *
+ * // Preview changes before applying
+ * const preview = await revstack.admin.system.preview(config);
+ * console.log(`${preview.changes.length} changes, breaking: ${preview.hasBreakingChanges}`);
+ *
+ * // Apply atomically
+ * const result = await revstack.admin.system.sync(config);
+ * console.log(`Applied ${result.applied.length} changes at ${result.timestamp}`);
+ * ```
+ */
+export declare class AdminSystemClient extends BaseClient {
+    /**
+     * Apply the full desired billing state in a single ACID transaction.
+     * The Revstack Cloud backend computes the diff between the current state
+     * and the desired config, then applies all changes atomically.
+     *
+     * @param config - The complete desired state (plans + entitlements).
+     * @returns The list of changes that were applied and the execution timestamp.
+     *
+     * @throws {SyncConflictError} If the remote state has drifted unexpectedly (HTTP 409).
+     */
+    sync(config: SyncConfig): Promise<SyncResult>;
+    /**
+     * Preview the changes that would be applied by a `sync()` call.
+     * Returns the computed diff without applying any mutations.
+     * The CLI should **always** call this before `sync()` to show the operator
+     * what will change.
+     *
+     * @param config - The complete desired state (plans + entitlements).
+     * @returns A preview with the list of changes and whether any are breaking.
+     */
+    preview(config: SyncConfig): Promise<SyncPreview>;
+}
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/modules/admin/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAOnD;;;;;;;;OAQG;IACG,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CAMxD"}

package/dist/modules/admin/system.js

@@ -0,0 +1,61 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Admin client for the Billing as Code orchestrator.
+ * Provides atomic sync operations used by the CLI (`npx revstack push`) to
+ * apply the full desired state from `revstack.config.ts` in a single ACID
+ * Postgres transaction.
+ *
+ * @example
+ * ```typescript
+ * const config: SyncConfig = {
+ *   plans: [
+ *     { slug: "free", name: "Free", type: "free", status: "active" },
+ *     { slug: "pro", name: "Pro", prices: [{ amount: 4900, billingInterval: "month" }] },
+ *   ],
+ *   entitlements: [
+ *     { slug: "api-calls", name: "API Calls", type: "metered", unitType: "count" },
+ *   ],
+ * };
+ *
+ * // Preview changes before applying
+ * const preview = await revstack.admin.system.preview(config);
+ * console.log(`${preview.changes.length} changes, breaking: ${preview.hasBreakingChanges}`);
+ *
+ * // Apply atomically
+ * const result = await revstack.admin.system.sync(config);
+ * console.log(`Applied ${result.applied.length} changes at ${result.timestamp}`);
+ * ```
+ */
+export class AdminSystemClient extends BaseClient {
+    /**
+     * Apply the full desired billing state in a single ACID transaction.
+     * The Revstack Cloud backend computes the diff between the current state
+     * and the desired config, then applies all changes atomically.
+     *
+     * @param config - The complete desired state (plans + entitlements).
+     * @returns The list of changes that were applied and the execution timestamp.
+     *
+     * @throws {SyncConflictError} If the remote state has drifted unexpectedly (HTTP 409).
+     */
+    async sync(config) {
+        return this.request("/admin/system/sync", {
+            method: "POST",
+            body: JSON.stringify(config),
+        });
+    }
+    /**
+     * Preview the changes that would be applied by a `sync()` call.
+     * Returns the computed diff without applying any mutations.
+     * The CLI should **always** call this before `sync()` to show the operator
+     * what will change.
+     *
+     * @param config - The complete desired state (plans + entitlements).
+     * @returns A preview with the list of changes and whether any are breaking.
+     */
+    async preview(config) {
+        return this.request("/admin/system/preview", {
+            method: "POST",
+            body: JSON.stringify(config),
+        });
+    }
+}

package/dist/modules/base.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Base HTTP client shared by all SDK modules.
+ * Handles authentication, timeouts, idempotency headers, and typed error responses.
+ *
+ * @internal Not intended for direct use — all public modules extend this class.
+ */
+export declare class BaseClient {
+    protected config: {
+        secretKey: string;
+        baseUrl: string;
+        timeout: number;
+    };
+    constructor(config: {
+        secretKey: string;
+        baseUrl: string;
+        timeout: number;
+    });
+    /**
+     * Builds a URL query string from an object of parameters.
+     * Filters out `null` and `undefined` values.
+     *
+     * @typeParam T - The parameter object type.
+     * @param params - Key-value pairs to encode as query parameters.
+     * @returns A query string prefixed with `?`, or an empty string if no params.
+     */
+    protected buildQuery<T extends object>(params?: T): string;
+    /**
+     * Sends an authenticated HTTP request to the Revstack API.
+     *
+     * @typeParam T - Expected response body type.
+     * @param endpoint - API endpoint path (e.g. `/customers`).
+     * @param options - Fetch options with optional `idempotencyKey`.
+     * @returns Parsed JSON response body.
+     *
+     * @throws {RateLimitError} When the API returns HTTP 429.
+     * @throws {SyncConflictError} When `admin.system.sync()` detects a conflict (HTTP 409).
+     * @throws {RevstackAPIError} For all other non-2xx responses.
+     */
+    protected request<T>(endpoint: string, options?: RequestInit & {
+        idempotencyKey?: string;
+    }): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/modules/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/modules/base.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,qBAAa,UAAU;IAEnB,SAAS,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;gBAA/D,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAG3E;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM;IAY1D;;;;;;;;;;;OAWG;cACa,OAAO,CAAC,CAAC,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAW,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,GACtD,OAAO,CAAC,CAAC,CAAC;CAsDd"}

package/dist/modules/base.js

@@ -0,0 +1,84 @@
+import { RevstackAPIError, RateLimitError, SyncConflictError, } from "@/errors";
+/**
+ * Base HTTP client shared by all SDK modules.
+ * Handles authentication, timeouts, idempotency headers, and typed error responses.
+ *
+ * @internal Not intended for direct use — all public modules extend this class.
+ */
+export class BaseClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Builds a URL query string from an object of parameters.
+     * Filters out `null` and `undefined` values.
+     *
+     * @typeParam T - The parameter object type.
+     * @param params - Key-value pairs to encode as query parameters.
+     * @returns A query string prefixed with `?`, or an empty string if no params.
+     */
+    buildQuery(params) {
+        if (!params)
+            return "";
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null) {
+                searchParams.append(key, String(value));
+            }
+        }
+        const query = searchParams.toString();
+        return query ? `?${query}` : "";
+    }
+    /**
+     * Sends an authenticated HTTP request to the Revstack API.
+     *
+     * @typeParam T - Expected response body type.
+     * @param endpoint - API endpoint path (e.g. `/customers`).
+     * @param options - Fetch options with optional `idempotencyKey`.
+     * @returns Parsed JSON response body.
+     *
+     * @throws {RateLimitError} When the API returns HTTP 429.
+     * @throws {SyncConflictError} When `admin.system.sync()` detects a conflict (HTTP 409).
+     * @throws {RevstackAPIError} For all other non-2xx responses.
+     */
+    async request(endpoint, options = {}) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        const headers = {
+            Authorization: `Bearer ${this.config.secretKey}`,
+            "Content-Type": "application/json",
+            ...options.headers,
+        };
+        if (options.idempotencyKey) {
+            headers["Idempotency-Key"] = options.idempotencyKey;
+        }
+        try {
+            const response = await fetch(`${this.config.baseUrl}${endpoint}`, {
+                ...options,
+                headers,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                const message = errorData.message || `Revstack API Error: ${response.status}`;
+                const requestId = errorData.requestId;
+                if (response.status === 429) {
+                    const retryAfter = errorData.retryAfter ??
+                        parseInt(response.headers.get("Retry-After") || "60", 10);
+                    throw new RateLimitError(message, retryAfter, requestId);
+                }
+                if (response.status === 409 && errorData.conflicts) {
+                    throw new SyncConflictError(message, errorData.conflicts, requestId);
+                }
+                throw new RevstackAPIError(message, response.status, errorData.code || "UNKNOWN_ERROR", requestId);
+            }
+            return (await response.json());
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}

package/dist/modules/customers.d.ts

@@ -0,0 +1,56 @@
+import { BaseClient } from "@/modules/base";
+import { Customer, IdentifyCustomerParams, UpdateCustomerParams, ListParams, PaginatedResponse } from "@/types";
+/**
+ * Client for managing end-user (customer) records.
+ * Provides full CRUD operations on the `app_users` table.
+ *
+ * @example
+ * ```typescript
+ * const customer = await revstack.customers.identify({
+ *   customerId: "user-123",
+ *   email: "john@acme.com",
+ * });
+ * ```
+ */
+export declare class CustomersClient extends BaseClient {
+    /**
+     * Identify (upsert) a customer. Creates the customer if not found,
+     * or updates it if a record with the same `customerId` already exists.
+     *
+     * @param params - Customer identification parameters.
+     * @returns The created or updated customer record.
+     */
+    identify(params: IdentifyCustomerParams): Promise<Customer>;
+    /**
+     * Retrieve a customer by ID.
+     *
+     * @param customerId - The customer's unique identifier.
+     * @returns The customer record.
+     */
+    get(customerId: string): Promise<Customer>;
+    /**
+     * List customers with optional pagination.
+     *
+     * @param params - Pagination parameters (limit, offset).
+     * @returns A paginated list of customer records.
+     */
+    list(params?: ListParams): Promise<PaginatedResponse<Customer>>;
+    /**
+     * Update an existing customer's profile.
+     *
+     * @param customerId - The customer's unique identifier.
+     * @param params - Fields to update (email, metadata).
+     * @returns The updated customer record.
+     */
+    update(customerId: string, params: UpdateCustomerParams): Promise<Customer>;
+    /**
+     * Delete a customer and all associated data.
+     *
+     * @param customerId - The customer's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    delete(customerId: string): Promise<{
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=customers.d.ts.map

package/dist/modules/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../src/modules/customers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOjE;;;;;OAKG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMhD;;;;;OAKG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAOrE;;;;;;OAMG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,QAAQ,CAAC;IAOpB;;;;;OAKG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAKhE"}

package/dist/modules/customers.js

@@ -0,0 +1,72 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Client for managing end-user (customer) records.
+ * Provides full CRUD operations on the `app_users` table.
+ *
+ * @example
+ * ```typescript
+ * const customer = await revstack.customers.identify({
+ *   customerId: "user-123",
+ *   email: "john@acme.com",
+ * });
+ * ```
+ */
+export class CustomersClient extends BaseClient {
+    /**
+     * Identify (upsert) a customer. Creates the customer if not found,
+     * or updates it if a record with the same `customerId` already exists.
+     *
+     * @param params - Customer identification parameters.
+     * @returns The created or updated customer record.
+     */
+    async identify(params) {
+        return this.request("/customers", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Retrieve a customer by ID.
+     *
+     * @param customerId - The customer's unique identifier.
+     * @returns The customer record.
+     */
+    async get(customerId) {
+        return this.request(`/customers/${customerId}`, {
+            method: "GET",
+        });
+    }
+    /**
+     * List customers with optional pagination.
+     *
+     * @param params - Pagination parameters (limit, offset).
+     * @returns A paginated list of customer records.
+     */
+    async list(params) {
+        return this.request(`/customers${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * Update an existing customer's profile.
+     *
+     * @param customerId - The customer's unique identifier.
+     * @param params - Fields to update (email, metadata).
+     * @returns The updated customer record.
+     */
+    async update(customerId, params) {
+        return this.request(`/customers/${customerId}`, {
+            method: "PATCH",
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Delete a customer and all associated data.
+     *
+     * @param customerId - The customer's unique identifier.
+     * @returns Confirmation of deletion.
+     */
+    async delete(customerId) {
+        return this.request(`/customers/${customerId}`, {
+            method: "DELETE",
+        });
+    }
+}

package/dist/modules/entitlements.d.ts

@@ -0,0 +1,49 @@
+import { BaseClient } from "@/modules/base";
+import { Entitlement, EntitlementCheckOptions, EntitlementCheckResult } from "@/types";
+/**
+ * Client for checking and querying feature entitlements.
+ * The `check()` method is the core primitive of the SDK — it determines whether
+ * a customer is allowed to use a specific feature based on their plan.
+ *
+ * @example
+ * ```typescript
+ * const { allowed, reason } = await revstack.entitlements.check(
+ *   "usr_abc",
+ *   "api-calls",
+ *   { amount: 10 }
+ * );
+ *
+ * if (!allowed) {
+ *   throw new Error(`Access denied: ${reason}`);
+ * }
+ * ```
+ */
+export declare class EntitlementsClient extends BaseClient {
+    /**
+     * Check whether a customer has access to a specific feature.
+     * This is the most critical method in the SDK — it evaluates the customer's
+     * plan, metered usage, and custom entitlement overrides.
+     *
+     * @param customerId - The customer to check.
+     * @param featureId - The entitlement slug or ID.
+     * @param options - Optional check parameters (e.g. requested amount).
+     * @returns The check result with `allowed`, `reason`, and `remainingBalance`.
+     */
+    check(customerId: string, featureId: string, options?: EntitlementCheckOptions): Promise<EntitlementCheckResult>;
+    /**
+     * List all active entitlements for a customer, including limits from
+     * their plan and any custom overrides.
+     *
+     * @param customerId - The customer whose entitlements to list.
+     * @returns Array of entitlement definitions the customer has access to.
+     */
+    list(customerId: string): Promise<Entitlement[]>;
+    /**
+     * Retrieve a single entitlement definition by ID.
+     *
+     * @param entitlementId - The entitlement's unique identifier.
+     * @returns The entitlement definition.
+     */
+    get(entitlementId: string): Promise<Entitlement>;
+}
+//# sourceMappingURL=entitlements.d.ts.map

package/dist/modules/entitlements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../../src/modules/entitlements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD;;;;;;;;;OASG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAWlC;;;;;;OAMG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMtD;;;;;OAKG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAKvD"}

package/dist/modules/entitlements.js

@@ -0,0 +1,64 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Client for checking and querying feature entitlements.
+ * The `check()` method is the core primitive of the SDK — it determines whether
+ * a customer is allowed to use a specific feature based on their plan.
+ *
+ * @example
+ * ```typescript
+ * const { allowed, reason } = await revstack.entitlements.check(
+ *   "usr_abc",
+ *   "api-calls",
+ *   { amount: 10 }
+ * );
+ *
+ * if (!allowed) {
+ *   throw new Error(`Access denied: ${reason}`);
+ * }
+ * ```
+ */
+export class EntitlementsClient extends BaseClient {
+    /**
+     * Check whether a customer has access to a specific feature.
+     * This is the most critical method in the SDK — it evaluates the customer's
+     * plan, metered usage, and custom entitlement overrides.
+     *
+     * @param customerId - The customer to check.
+     * @param featureId - The entitlement slug or ID.
+     * @param options - Optional check parameters (e.g. requested amount).
+     * @returns The check result with `allowed`, `reason`, and `remainingBalance`.
+     */
+    async check(customerId, featureId, options) {
+        return this.request("/entitlements/check", {
+            method: "POST",
+            body: JSON.stringify({
+                customerId,
+                featureId,
+                requestedAmount: options?.amount || 1,
+            }),
+        });
+    }
+    /**
+     * List all active entitlements for a customer, including limits from
+     * their plan and any custom overrides.
+     *
+     * @param customerId - The customer whose entitlements to list.
+     * @returns Array of entitlement definitions the customer has access to.
+     */
+    async list(customerId) {
+        return this.request(`/entitlements/customer/${customerId}`, {
+            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(`/entitlements/${entitlementId}`, {
+            method: "GET",
+        });
+    }
+}

package/dist/modules/invoices.d.ts

@@ -0,0 +1,33 @@
+import { BaseClient } from "@/modules/base";
+import { Invoice, ListInvoicesParams, PaginatedResponse } from "@/types";
+/**
+ * Read-only client for querying billing invoices.
+ * Used to display billing history to end users. Invoice creation is handled
+ * automatically by the payment pipeline and is not accessible from the SDK.
+ *
+ * @example
+ * ```typescript
+ * // List invoices for a customer's billing history page
+ * const { data: invoices } = await revstack.invoices.list({
+ *   customerId: "usr_abc",
+ *   status: "paid",
+ * });
+ * ```
+ */
+export declare class InvoicesClient extends BaseClient {
+    /**
+     * List invoices with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of invoices.
+     */
+    list(params?: ListInvoicesParams): Promise<PaginatedResponse<Invoice>>;
+    /**
+     * Retrieve a single invoice by ID.
+     *
+     * @param invoiceId - The invoice's unique identifier.
+     * @returns The invoice record.
+     */
+    get(invoiceId: string): Promise<Invoice>;
+}
+//# sourceMappingURL=invoices.d.ts.map

package/dist/modules/invoices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/modules/invoices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C;;;;;OAKG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAO5E;;;;;OAKG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAK/C"}

package/dist/modules/invoices.js

@@ -0,0 +1,37 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Read-only client for querying billing invoices.
+ * Used to display billing history to end users. Invoice creation is handled
+ * automatically by the payment pipeline and is not accessible from the SDK.
+ *
+ * @example
+ * ```typescript
+ * // List invoices for a customer's billing history page
+ * const { data: invoices } = await revstack.invoices.list({
+ *   customerId: "usr_abc",
+ *   status: "paid",
+ * });
+ * ```
+ */
+export class InvoicesClient extends BaseClient {
+    /**
+     * List invoices with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of invoices.
+     */
+    async list(params) {
+        return this.request(`/invoices${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * Retrieve a single invoice by ID.
+     *
+     * @param invoiceId - The invoice's unique identifier.
+     * @returns The invoice record.
+     */
+    async get(invoiceId) {
+        return this.request(`/invoices/${invoiceId}`, {
+            method: "GET",
+        });
+    }
+}

package/dist/modules/plans.d.ts

@@ -0,0 +1,35 @@
+import { BaseClient } from "@/modules/base";
+import { Plan, ListPlansParams, PaginatedResponse } from "@/types";
+/**
+ * Read-only client for querying billing plans.
+ * Used by the merchant's frontend to render pricing pages and plan selectors.
+ * Plan mutations are handled via `revstack.admin.plans`.
+ *
+ * @example
+ * ```typescript
+ * // Fetch all public plans for the pricing page
+ * const { data: plans } = await revstack.plans.list({ status: "active" });
+ *
+ * // Get a specific plan with prices and entitlements
+ * const proPlan = await revstack.plans.get("plan_pro");
+ * console.log(proPlan.prices);       // billing intervals
+ * console.log(proPlan.entitlements);  // feature allocations
+ * ```
+ */
+export declare class PlansClient extends BaseClient {
+    /**
+     * List plans with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of plans.
+     */
+    list(params?: ListPlansParams): Promise<PaginatedResponse<Plan>>;
+    /**
+     * Retrieve a single plan by ID, including its nested prices and entitlements.
+     *
+     * @param planId - The plan's unique identifier.
+     * @returns The plan with populated `prices[]` and `entitlements[]`.
+     */
+    get(planId: string): Promise<Plan>;
+}
+//# sourceMappingURL=plans.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/modules/plans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC;;;;;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;CAKzC"}

package/dist/modules/plans.js

@@ -0,0 +1,39 @@
+import { BaseClient } from "@/modules/base";
+/**
+ * Read-only client for querying billing plans.
+ * Used by the merchant's frontend to render pricing pages and plan selectors.
+ * Plan mutations are handled via `revstack.admin.plans`.
+ *
+ * @example
+ * ```typescript
+ * // Fetch all public plans for the pricing page
+ * const { data: plans } = await revstack.plans.list({ status: "active" });
+ *
+ * // Get a specific plan with prices and entitlements
+ * const proPlan = await revstack.plans.get("plan_pro");
+ * console.log(proPlan.prices);       // billing intervals
+ * console.log(proPlan.entitlements);  // feature allocations
+ * ```
+ */
+export class PlansClient extends BaseClient {
+    /**
+     * List plans with optional filters.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A paginated list of plans.
+     */
+    async list(params) {
+        return this.request(`/plans${this.buildQuery(params)}`, { method: "GET" });
+    }
+    /**
+     * Retrieve a single plan by ID, including its 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(`/plans/${planId}`, {
+            method: "GET",
+        });
+    }
+}