@revstackhq/node 0.0.0-dev-20260226054346

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

@@ -0,0 +1,84 @@
+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 {
+    constructor(config: {
+        secretKey: string;
+        baseUrl: string;
+        timeout: number;
+    });
+    /**
+     * 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/src/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;gBACzC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAI3E;;;;;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/src/modules/admin/integrations.js

@@ -0,0 +1,100 @@
+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 {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * 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/src/modules/admin/plans.d.ts

@@ -0,0 +1,77 @@
+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 {
+    constructor(config: {
+        secretKey: string;
+        baseUrl: string;
+        timeout: number;
+    });
+    /**
+     * 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/src/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;gBAClC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAI3E;;;;;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/src/modules/admin/plans.js

@@ -0,0 +1,96 @@
+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 {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * 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),
+        });
+    }
+}

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/modules/customers.d.ts

@@ -0,0 +1,61 @@
+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 {
+    constructor(config: {
+        secretKey: string;
+        baseUrl: string;
+        timeout: number;
+    });
+    /**
+     * 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