@flexprice/sdk 2.0.16 → 2.1.0

package/esm/sdk/wallets.d.ts

@@ -7,21 +7,21 @@ export declare class Wallets extends ClientSDK {
      * @remarks
      * Use when resolving wallets by external customer id or lookup key (e.g. from your app's user id). Supports optional real-time balance and expand.
      */
-    getCustomerWallets(request?: models.GetCustomerWalletsRequest | undefined, options?: RequestOptions): Promise<Array<models.DtoWalletResponse>>;
+    getCustomerWallets(request?: models.GetCustomerWalletsRequest | undefined, options?: RequestOptions): Promise<Array<models.Wallet>>;
     /**
      * Get wallets by customer ID
      *
      * @remarks
      * Use when showing a customer's wallets (e.g. balance overview by currency or in a billing portal). Supports optional expand for balance breakdown.
      */
-    getWalletsByCustomerId(id: string, options?: RequestOptions): Promise<Array<models.DtoWalletResponse>>;
+    getWalletsByCustomerId(id: string, options?: RequestOptions): Promise<Array<models.Wallet>>;
     /**
      * Create a new wallet
      *
      * @remarks
      * Use when giving a customer a prepaid or credit balance (e.g. prepaid plans or promotional credits).
      */
-    createWallet(request: models.DtoCreateWalletRequest, options?: RequestOptions): Promise<models.DtoWalletResponse>;
+    createWallet(request: models.CreateWalletRequest, options?: RequestOptions): Promise<models.Wallet>;
     /**
      * Query wallets
      *
@@ -35,48 +35,48 @@ export declare class Wallets extends ClientSDK {
      * @remarks
      * Use when searching or reporting on wallet transactions (e.g. cross-wallet history or reconciliation). Returns a paginated list; supports filtering by wallet, customer, type, date range.
      */
-    queryWalletTransaction(request: models.WalletTransactionFilter, options?: RequestOptions): Promise<models.DtoListWalletTransactionsResponse>;
+    queryWalletTransaction(request: models.WalletTransactionFilter, options?: RequestOptions): Promise<models.ListWalletTransactionsResponse>;
     /**
      * Get wallet
      *
      * @remarks
      * Use when you need to load a single wallet (e.g. for a balance or settings view).
      */
-    getWallet(id: string, options?: RequestOptions): Promise<models.DtoWalletResponse>;
+    getWallet(id: string, options?: RequestOptions): Promise<models.Wallet>;
     /**
      * Update a wallet
      *
      * @remarks
      * Use when changing wallet settings (e.g. enabling or updating auto top-up thresholds).
      */
-    updateWallet(id: string, body: models.DtoUpdateWalletRequest, options?: RequestOptions): Promise<models.DtoWalletResponse>;
+    updateWallet(id: string, body: models.UpdateWalletRequest, options?: RequestOptions): Promise<models.Wallet>;
     /**
      * Get wallet balance
      *
      * @remarks
      * Use when displaying or checking current wallet balance (e.g. before charging or in a portal). Supports optional expand for credits breakdown and from_cache.
      */
-    getWalletBalance(id: string, expand?: string | undefined, options?: RequestOptions): Promise<models.DtoWalletBalanceResponse>;
+    getWalletBalance(id: string, expand?: string | undefined, options?: RequestOptions): Promise<models.WalletBalanceResponse>;
     /**
      * Terminate a wallet
      *
      * @remarks
      * Use when closing a customer wallet (e.g. churn or migration). Closes the wallet and applies remaining balance per policy (refund or forfeit).
      */
-    terminateWallet(id: string, options?: RequestOptions): Promise<models.DtoWalletResponse>;
+    terminateWallet(id: string, options?: RequestOptions): Promise<models.Wallet>;
     /**
      * Top up wallet
      *
      * @remarks
      * Use when adding funds to a wallet (e.g. top-up, refund, or manual credit). Supports optional idempotency via reference.
      */
-    topUpWallet(id: string, body: models.DtoTopUpWalletRequest, options?: RequestOptions): Promise<models.DtoTopUpWalletResponse>;
+    topUpWallet(id: string, body: models.TopUpWalletRequest, options?: RequestOptions): Promise<models.TopUpWalletResponse>;
     /**
      * Get wallet transactions
      *
      * @remarks
      * Use when showing transaction history for a wallet (e.g. credit/debit log or audit). Returns a paginated list; supports limit, offset, and filters.
      */
-    getWalletTransactions(request: models.GetWalletTransactionsRequest, options?: RequestOptions): Promise<models.DtoListWalletTransactionsResponse>;
+    getWalletTransactions(request: models.GetWalletTransactionsRequest, options?: RequestOptions): Promise<models.ListWalletTransactionsResponse>;
 }
 //# sourceMappingURL=wallets.d.ts.map

package/esm/sdk/wallets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallets.d.ts","sourceRoot":"","sources":["../../src/sdk/wallets.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,OAAQ,SAAQ,SAAS;IACpC;;;;;OAKG;IACG,kBAAkB,CACtB,OAAO,CAAC,EAAE,MAAM,CAAC,yBAAyB,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAM1C;IAED;;;;;OAKG;IACG,sBAAsB,CAC1B,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAM1C;IAED;;;;;OAKG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,CAAC,sBAAsB,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAMnC;IAED;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,CAAC,YAAY,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAM/C;IAED;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,CAAC,uBAAuB,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAMnD;IAED;;;;;OAKG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAMnC;IAED;;;;;OAKG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,sBAAsB,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAOnC;IAED;;;;;OAKG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAO1C;IAED;;;;;OAKG;IACG,eAAe,CACnB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAMnC;IAED;;;;;OAKG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,qBAAqB,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAOxC;IAED;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,EAAE,MAAM,CAAC,4BAA4B,EAC5C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAMnD;CACF"}
+{"version":3,"file":"wallets.d.ts","sourceRoot":"","sources":["../../src/sdk/wallets.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,OAAQ,SAAQ,SAAS;IACpC;;;;;OAKG;IACG,kBAAkB,CACtB,OAAO,CAAC,EAAE,MAAM,CAAC,yBAAyB,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAM/B;IAED;;;;;OAKG;IACG,sBAAsB,CAC1B,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAM/B;IAED;;;;;OAKG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,CAAC,mBAAmB,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAMxB;IAED;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,CAAC,YAAY,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAM/C;IAED;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,CAAC,uBAAuB,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAMhD;IAED;;;;;OAKG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAMxB;IAED;;;;;OAKG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,mBAAmB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAOxB;IAED;;;;;OAKG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAOvC;IAED;;;;;OAKG;IACG,eAAe,CACnB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAMxB;IAED;;;;;OAKG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,kBAAkB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAOrC;IAED;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,EAAE,MAAM,CAAC,4BAA4B,EAC5C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAMhD;CACF"}

package/esm/sdk/wallets.js.map

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

package/esm/sdk/workflows.d.ts

@@ -7,6 +7,6 @@ export declare class Workflows extends ClientSDK {
      * @remarks
      * Use when listing or auditing workflow runs (e.g. ops dashboard or debugging). Returns a paginated list; supports filtering by workflow type and status.
      */
-    queryWorkflow(request: models.WorkflowExecutionFilter, options?: RequestOptions): Promise<models.DtoListWorkflowsResponse>;
+    queryWorkflow(request: models.WorkflowExecutionFilter, options?: RequestOptions): Promise<models.ListWorkflowsResponse>;
 }
 //# sourceMappingURL=workflows.d.ts.map

package/esm/sdk/workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/sdk/workflows.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,SAAU,SAAQ,SAAS;IACtC;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,CAAC,uBAAuB,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAM1C;CACF"}
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/sdk/workflows.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,SAAU,SAAQ,SAAS;IACtC;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,CAAC,uBAAuB,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAMvC;CACF"}

package/esm/sdk/workflows.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/sdk/workflows.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,MAAM,OAAO,SAAU,SAAQ,SAAS;IACtC;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,OAAuC,EACvC,OAAwB,EACkB;QAC1C,OAAO,WAAW,CAAC,sBAAsB,CACvC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IAAA,CACJ;CACF"}
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/sdk/workflows.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,MAAM,OAAO,SAAU,SAAQ,SAAS;IACtC;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,OAAuC,EACvC,OAAwB,EACe;QACvC,OAAO,WAAW,CAAC,sBAAsB,CACvC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IAAA,CACJ;CACF"}

package/examples/README.md

@@ -1,7 +1,7 @@
 # TypeScript SDK examples
 
 1. Install the SDK: `npm i @flexprice/sdk`.
-2. Copy `.env.sample` to `.env` and set `FLEXPRICE_API_KEY` (optionally `FLEXPRICE_API_HOST`; include `/v1`, e.g. `us.api.flexprice.io/v1`).
-3. Run the example: from the package root, `npx tsx examples/quick-start.ts`; or from the `examples/` directory, `npx tsx quick-start.ts`.
+2. Copy `.env.sample` to `.env` and set **`FLEXPRICE_API_KEY`**. Optionally set **`FLEXPRICE_API_HOST`** to a full URL (default: `https://us.api.flexprice.io/v1`).
+3. Run: from the package root, `npx tsx examples/quick-start.ts`; or from `examples/`, `npx tsx quick-start.ts`.
 
-**Verified tests:** The same API flows are covered and verified by the integration test suite at **api/tests/ts/test_sdk.ts**. Run with `npm test` from `api/tests/ts`; see [api/tests/README.md](../../tests/README.md).
+**Integration tests:** Full API flows are in [api/tests/ts/test_sdk.ts](../../tests/ts/test_sdk.ts). Run `npm test` from `api/tests/ts`; see [api/tests/README.md](../../tests/README.md).

package/examples/complete.ts

@@ -0,0 +1,486 @@
+/**
+ * FlexPrice TypeScript SDK – Complete example
+ *
+ * Demonstrates: client init, customer CRUD, pagination, plan creation,
+ * subscription lifecycle, event ingestion (single + bulk), invoice listing,
+ * idempotency headers, per-request timeouts, and webhook handling.
+ *
+ * Prerequisites:
+ *   FLEXPRICE_API_KEY  – your API key
+ *   FLEXPRICE_API_HOST – optional, defaults to us.api.flexprice.io
+ */
+
+import { FlexPrice } from "@flexprice/sdk";
+import type {
+  Customer,
+  Subscription,
+  Invoice,
+  Plan,
+  CreateCustomerRequest,
+  UpdateCustomerRequest,
+  CreatePlanRequest,
+  CreateSubscriptionRequest,
+  CancelSubscriptionRequest,
+  IngestEventRequest,
+  BulkIngestEventRequest,
+  InvoiceFilter,
+  CustomerFilter,
+  ListCustomersResponse,
+  ListInvoicesResponse,
+} from "@flexprice/sdk";
+import { SDKError } from "@flexprice/sdk";
+
+// ── Client initialisation ─────────────────────────────────────────────────────
+
+const apiKey = process.env.FLEXPRICE_API_KEY;
+const apiHost = process.env.FLEXPRICE_API_HOST ?? "us.api.flexprice.io";
+
+if (!apiKey) {
+  console.error("FLEXPRICE_API_KEY is not set. Exiting.");
+  process.exit(1);
+}
+
+const serverURL = apiHost.startsWith("http") ? apiHost : `https://${apiHost}`;
+
+const flexprice = new FlexPrice({
+  serverURL,
+  apiKeyAuth: apiKey,
+});
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+/** Generate a unique external ID so the example is re-runnable. */
+const externalId = (prefix: string): string => `${prefix}-${Date.now()}`;
+
+// ── createOrGetCustomer ───────────────────────────────────────────────────────
+
+/**
+ * Creates a new customer, handling a 409 Conflict gracefully by fetching the
+ * existing record instead.  Demonstrates idempotency key and optional chaining.
+ */
+async function createOrGetCustomer(): Promise<Customer> {
+  console.log("\n// ── Create customer ──────────────────────────────────────");
+
+  const customerExternalId = externalId("acme-corp");
+
+  const request: CreateCustomerRequest = {
+    externalId: customerExternalId,
+    name: "Acme Corp",
+    email: "billing@acme-corp.example.com",
+    addressLine1: "123 Commerce Street",
+    addressCity: "San Francisco",
+    addressState: "CA",
+    addressPostalCode: "94105",
+    addressCountry: "US",
+    metadata: {
+      salesforce_id: "0010X000abcdef",
+      tier: "enterprise",
+    },
+  };
+
+  try {
+    // Pass an idempotency key via a custom request header so that retrying the
+    // same network call never creates a duplicate customer.
+    const customer = await flexprice.customers.createCustomer(request, {
+      headers: { "Idempotency-Key": `create-customer-${customerExternalId}` },
+    });
+
+    console.log(
+      `Created customer  id=${customer.id}  email=${customer.email ?? "N/A"}`
+    );
+    return customer;
+  } catch (err) {
+    // A 409 means the external_id already exists – retrieve the existing record.
+    if (err instanceof SDKError && err.statusCode === 409) {
+      console.log("Customer already exists; fetching by external_id …");
+      const result: ListCustomersResponse =
+        await flexprice.customers.queryCustomer({
+          externalId: customerExternalId,
+          limit: 1,
+        });
+      const existing = result.items?.[0];
+      if (!existing) {
+        throw new Error(
+          `409 returned but customer with externalId=${customerExternalId} not found`
+        );
+      }
+      console.log(
+        `Fetched existing customer  id=${existing.id}  name=${existing.name ?? "N/A"}`
+      );
+      return existing;
+    }
+    throw err;
+  }
+}
+
+// ── updateCustomer ────────────────────────────────────────────────────────────
+
+async function updateCustomer(customerId: string): Promise<Customer> {
+  console.log("\n// ── Update customer ──────────────────────────────────────");
+
+  const update: UpdateCustomerRequest = {
+    metadata: {
+      salesforce_id: "0010X000abcdef",
+      tier: "enterprise",
+      onboarded: "true",
+    },
+  };
+
+  const updated = await flexprice.customers.updateCustomer(update, customerId);
+  console.log(
+    `Updated customer  id=${updated.id}  name=${updated.name ?? "N/A"}`
+  );
+  return updated;
+}
+
+// ── paginateCustomers ─────────────────────────────────────────────────────────
+
+/**
+ * Iterates through every customer page until all records have been visited.
+ * Uses the `pagination.total` field to decide when to stop.
+ */
+async function paginateCustomers(): Promise<void> {
+  console.log(
+    "\n// ── Paginate all customers ────────────────────────────────"
+  );
+
+  const PAGE_SIZE = 50;
+  let offset = 0;
+  let total: number | undefined;
+  let page = 1;
+
+  do {
+    const filter: CustomerFilter = {
+      limit: PAGE_SIZE,
+      offset,
+      order: "desc",
+    };
+
+    const response: ListCustomersResponse =
+      await flexprice.customers.queryCustomer(filter);
+
+    total = response.pagination?.total;
+    const items = response.items ?? [];
+
+    console.log(
+      `  Page ${page}: fetched ${items.length} customers` +
+        (total !== undefined ? `  (total=${total})` : "")
+    );
+
+    for (const c of items) {
+      console.log(`    • ${c.id}  ${c.email ?? "no-email"}`);
+    }
+
+    offset += items.length;
+    page++;
+
+    // Stop if we received fewer items than the page size (last page) or once
+    // we have consumed everything reported by the server.
+  } while (
+    (total === undefined || offset < total) &&
+    (response.items?.length ?? 0) === PAGE_SIZE
+  );
+}
+
+// ── createPlan ────────────────────────────────────────────────────────────────
+
+async function createPlan(): Promise<Plan> {
+  console.log("\n// ── Create plan ──────────────────────────────────────────");
+
+  const request: CreatePlanRequest = {
+    name: "Pro Plan",
+    description: "Usage-based plan for professional teams",
+    lookupKey: `pro-plan-${Date.now()}`,
+    metadata: {
+      internal_code: "PLAN_PRO_V1",
+    },
+  };
+
+  const plan = await flexprice.plans.createPlan(request);
+  console.log(`Created plan  id=${plan.id}  name=${plan.name}`);
+  return plan;
+}
+
+// ── createSubscription ────────────────────────────────────────────────────────
+
+async function createSubscription(
+  customerId: string,
+  planId: string
+): Promise<Subscription> {
+  console.log(
+    "\n// ── Create subscription ──────────────────────────────────"
+  );
+
+  const request: CreateSubscriptionRequest = {
+    customerId,
+    planId,
+    billingCadence: "RECURRING",
+    billingPeriod: "MONTHLY",
+    currency: "USD",
+    collectionMethod: "charge_automatically",
+    startDate: new Date(),
+    metadata: {
+      source: "ts_sdk_example",
+    },
+  };
+
+  // Per-request timeout – useful for operations that trigger async work on the
+  // server (e.g. proration calculations) and may take longer than the default.
+  const subscription = await flexprice.subscriptions.createSubscription(
+    request,
+    { timeoutMs: 15000 }
+  );
+
+  console.log(
+    `Created subscription  id=${subscription.id}` +
+      `  status=${subscription.subscriptionStatus ?? "unknown"}`
+  );
+  return subscription;
+}
+
+// ── ingestEvents ──────────────────────────────────────────────────────────────
+
+async function ingestEvents(externalCustomerId: string): Promise<void> {
+  console.log(
+    "\n// ── Ingest single event ──────────────────────────────────"
+  );
+
+  // Single event ingest (returns void on HTTP 202)
+  const singleEvent: IngestEventRequest = {
+    eventName: "api_request",
+    externalCustomerId,
+    eventId: `evt-single-${Date.now()}`,
+    timestamp: new Date().toISOString(),
+    source: "ts_sdk_example",
+    properties: {
+      endpoint: "/v1/completions",
+      model: "gpt-4o",
+      tokens_used: "1500",
+    },
+  };
+
+  await flexprice.events.ingestEvent(singleEvent);
+  console.log("Single event accepted (202)");
+
+  // ── Bulk event ingest ───────────────────────────────────────────────────────
+  console.log(
+    "\n// ── Ingest events bulk ───────────────────────────────────"
+  );
+
+  const bulkPayload: BulkIngestEventRequest = {
+    events: [
+      {
+        eventName: "api_request",
+        externalCustomerId,
+        eventId: `evt-bulk-1-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        source: "ts_sdk_example",
+        properties: {
+          endpoint: "/v1/embeddings",
+          model: "text-embedding-3-small",
+          tokens_used: "800",
+        },
+      },
+      {
+        eventName: "storage_write",
+        externalCustomerId,
+        eventId: `evt-bulk-2-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        source: "ts_sdk_example",
+        properties: {
+          bucket: "user-uploads",
+          bytes_written: "204800",
+        },
+      },
+      {
+        eventName: "storage_read",
+        externalCustomerId,
+        eventId: `evt-bulk-3-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        source: "ts_sdk_example",
+        properties: {
+          bucket: "user-uploads",
+          bytes_read: "102400",
+        },
+      },
+    ],
+  };
+
+  await flexprice.events.ingestEventsBulk(bulkPayload);
+  console.log(`Bulk ingest accepted (202)  count=${bulkPayload.events.length}`);
+}
+
+// ── cancelSubscription ────────────────────────────────────────────────────────
+
+async function cancelSubscription(subscriptionId: string): Promise<void> {
+  console.log(
+    "\n// ── Cancel subscription ──────────────────────────────────"
+  );
+
+  const request: CancelSubscriptionRequest = {
+    cancellationType: "end_of_period",
+    reason: "Customer requested cancellation via account settings",
+  };
+
+  const cancelled = await flexprice.subscriptions.cancelSubscription(
+    subscriptionId,
+    request
+  );
+
+  console.log(
+    `Subscription cancellation scheduled  id=${cancelled.id}` +
+      `  status=${cancelled.subscriptionStatus ?? "unknown"}`
+  );
+}
+
+// ── listInvoices ──────────────────────────────────────────────────────────────
+
+async function listInvoices(customerId: string): Promise<void> {
+  console.log("\n// ── List invoices ────────────────────────────────────────");
+
+  const filter: InvoiceFilter = {
+    customerId,
+    invoiceStatus: ["DRAFT", "FINALIZED"],
+    limit: 20,
+    offset: 0,
+    order: "desc",
+  };
+
+  const response: ListInvoicesResponse =
+    await flexprice.invoices.queryInvoice(filter);
+
+  const invoices: Invoice[] = response.items ?? [];
+  console.log(
+    `Found ${invoices.length} invoice(s)` +
+      (response.pagination?.total !== undefined
+        ? `  (total=${response.pagination.total})`
+        : "")
+  );
+
+  for (const inv of invoices) {
+    console.log(
+      `  • ${inv.id}` +
+        `  status=${inv.invoiceStatus ?? "unknown"}` +
+        `  amount_due=${inv.amountDue ?? "0"} ${inv.currency ?? ""}`
+    );
+  }
+}
+
+// ── handleWebhook ─────────────────────────────────────────────────────────────
+
+/**
+ * Express-style webhook handler that reads the FlexPrice event type and
+ * type-narrows the payload.  Mount with:
+ *
+ *   app.post("/webhooks/flexprice", express.raw({ type: "*\/*" }), handleWebhook);
+ */
+async function handleWebhook(
+  req: { body: Buffer | string; headers: Record<string, string | string[] | undefined> },
+  res: { status: (code: number) => { send: (body: string) => void } }
+): Promise<void> {
+  const rawBody =
+    req.body instanceof Buffer ? req.body.toString("utf8") : req.body;
+
+  let event: Record<string, unknown>;
+  try {
+    event = JSON.parse(rawBody) as Record<string, unknown>;
+  } catch {
+    res.status(400).send("Invalid JSON");
+    return;
+  }
+
+  const eventType = event["event_type"] as string | undefined;
+
+  switch (eventType) {
+    case "invoice.created": {
+      const invoice = event["data"] as Invoice;
+      console.log(
+        `Webhook: invoice created  id=${invoice?.id}` +
+          `  amount_due=${invoice?.amountDue ?? "0"}`
+      );
+      break;
+    }
+
+    case "invoice.finalized": {
+      const invoice = event["data"] as Invoice;
+      console.log(
+        `Webhook: invoice finalised  id=${invoice?.id}` +
+          `  status=${invoice?.invoiceStatus ?? "unknown"}`
+      );
+      break;
+    }
+
+    case "subscription.created":
+    case "subscription.updated":
+    case "subscription.cancelled": {
+      const sub = event["data"] as Subscription;
+      console.log(
+        `Webhook: ${eventType}  id=${sub?.id}` +
+          `  status=${sub?.subscriptionStatus ?? "unknown"}`
+      );
+      break;
+    }
+
+    default:
+      console.log(`Webhook: unhandled event_type="${eventType ?? ""}"`);
+  }
+
+  res.status(200).send("OK");
+}
+
+// ── main ──────────────────────────────────────────────────────────────────────
+
+async function main(): Promise<void> {
+  console.log("FlexPrice TypeScript SDK – complete example");
+  console.log(`Server: ${serverURL}\n`);
+
+  // 1. Customer lifecycle
+  const customer = await createOrGetCustomer();
+  await updateCustomer(customer.id);
+
+  // 2. Pagination
+  await paginateCustomers();
+
+  // 3. Plan
+  const plan = await createPlan();
+
+  // 4. Subscription (requires a plan with at least one price; this example
+  //    assumes the plan already has prices attached via the dashboard / API)
+  const subscription = await createSubscription(customer.id, plan.id);
+
+  // 5. Usage events
+  const extId = customer.externalId ?? customer.id;
+  await ingestEvents(extId);
+
+  // 6. Invoices
+  await listInvoices(customer.id);
+
+  // 7. Cancel at end of current billing period
+  await cancelSubscription(subscription.id);
+
+  // 8. Webhook handler – simulated invocation (would normally be wired into
+  //    an HTTP server; shown here to demonstrate the typing pattern)
+  console.log("\n// ── Webhook handler (simulated) ──────────────────────────");
+  await handleWebhook(
+    {
+      body: JSON.stringify({
+        event_type: "invoice.created",
+        data: { id: "inv_demo", amountDue: "49.00", currency: "USD" },
+      }),
+      headers: { "content-type": "application/json" },
+    },
+    {
+      status: (code: number) => ({
+        send: (body: string) =>
+          console.log(`  Webhook response: ${code} ${body}`),
+      }),
+    }
+  );
+
+  console.log("\nAll examples completed successfully.");
+}
+
+main().catch((err: unknown) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/examples/quick-start.ts

@@ -1,22 +1,21 @@
 /**
  * FlexPrice TypeScript SDK – Quick start example
  *
- * Creates a client, creates a customer, and ingests one event.
- * Set FLEXPRICE_API_KEY (and optionally FLEXPRICE_API_HOST) in .env or environment.
+ * Default base URL: https://us.api.flexprice.io/v1
+ * Override with FLEXPRICE_API_HOST (full URL). Set FLEXPRICE_API_KEY in .env or environment.
  */
 
 import { FlexPrice } from "@flexprice/sdk";
 
 const apiKey = process.env.FLEXPRICE_API_KEY;
-const apiHost = process.env.FLEXPRICE_API_HOST ?? "us.api.flexprice.io";
+const serverURL =
+  process.env.FLEXPRICE_API_HOST ?? "https://us.api.flexprice.io/v1";
 
 if (!apiKey) {
   console.error("Set FLEXPRICE_API_KEY in .env or environment");
   process.exit(1);
 }
 
-const serverURL = apiHost.startsWith("http") ? apiHost : `https://${apiHost}`;
-
 const flexPrice = new FlexPrice({
   serverURL,
   apiKeyAuth: apiKey,

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@flexprice/sdk",
-  "version": "2.0.16",
+  "version": "2.1.0",
   "exports": {
     ".": "./src/index.ts",    
     "./sdk/models": "./src/sdk/models/index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flexprice/sdk",
-  "version": "2.0.16",
+  "version": "2.1.0",
   "author": "FlexPrice",
   "engines": {
     "node": ">=18"