@flintpay/node 0.2.0-beta.2 → 0.3.0-beta.1

package/RUNTIME.md

@@ -1,24 +1,47 @@
 # Flint Public API runtime guide (node)
 
-Package 0.2.0-beta.2; API 2026-09-07.
+Package 0.3.0-beta.1; API 2026-09-07.
 
 [Back to the quickstart](README.md) · [API reference](REFERENCE.md)
 
 ## Client and request options
 
-Construct a client with baseUrl and, for legacy authenticated operations, token. Composed clients accept authMode and credentials keyed by mode and scheme; requests can select a mode with request-local credentials. A combined scheme set must be complete. The SDK does not discover credentials or read environment variables; the operation example scripts read API_BASE_URL and their named credential variables explicitly. Pass per-request options as the second method argument: a plain object in Node, or RequestOptions in PHP. Defaults are timeoutMs: 10000 per attempt and deadlineMs: 30000 for the overall duration (not an absolute timestamp). Request values override client defaults. maxAttempts defaults to the operation's declared limit, or one when no retries are declared; overrides cannot exceed that limit. Request headers carry tenant context without shared mutable state.
+Construct a client with baseUrl and, for legacy authenticated operations, token. Composed clients accept authMode and credentials keyed by mode and scheme; requests can select a mode with request-local credentials. A combined scheme set must be complete. The SDK does not discover credentials or read environment variables; the operation example scripts read API_BASE_URL and their named credential variables explicitly. Pass per-request options as the last method argument: a plain object in Node, or RequestOptions in PHP. Defaults are timeoutMs: 10000 per attempt and deadlineMs: 30000 for the overall duration (not an absolute timestamp). Request values override client defaults. maxAttempts defaults to the operation's declared limit, or one when no retries are declared; overrides cannot exceed that limit. Request headers carry tenant context without shared mutable state.
+
+## Authentication
+
+Authentication shortcuts are accepted on both client and request options:
+
+- `apiKey` selects `merchant` and supplies `BearerAuth`.
+
+Request shortcuts override client authentication for that call. Explicit request modes still work. Use only one shortcut, and do not combine it with authMode or credentials in the same options object.
+
+Set `authMode` to one of the modes below and put its credentials under `credentials[mode]`. Request overrides use the mode’s credential map directly, without the outer mode key. A request credential map replaces the selected mode’s client map; supply every required key.
+
+| Mode | Required credential keys |
+| --- | --- |
+| `checkout` | `CheckoutSessionIDHeader`, `CheckoutSessionSecretHeader` |
+| `customer` | `CustomerSessionBearer` |
+| `invoice` | `InvoiceAccessTokenBearer` |
+| `merchant` | `BearerAuth` |
+| `merchantKey` | `ApiKeyHeader` |
+| `onboarding` | `OnboardingSessionBearer` |
+
+TypeScript checks mode names, credential keys, and the modes permitted by each operation. Credentials themselves are never shown in SDK diagnostics.
 
 ## Responses and errors
 
+Methods return the decoded body directly by default. A configured payloadPath explicitly selects a nested payload. WithResponse companions expose the full body, meta and raw response. Operations configured with return: result instead return Result, whose data is the complete decoded HTTP response body and meta is HTTP metadata. A provider may also wrap its payload in a data field, making result.data.data the provider payload. For example, create may wrap a payment_intent while get returns that entity directly. The operation examples show the exact access path. The SDK preserves these shapes; do not assume all operations share an envelope.
+
 Results expose data, meta and explicit raw response access. JSON raw values are text; PDF data/raw are Uint8Array in Node and binary-safe strings in PHP. SSE data is a closeable iterable carrying event names, IDs, decoded data and rawData. Node metadata uses properties; PHP metadata uses array keys. SdkError exposes kind, outcome, retryAllowed and optional metadata; provider codes use code in Node and errorCode in PHP. outcome is not_sent, response or unknown. Reconcile an unknown mutation outcome with the provider and the original persisted idempotency key before resubmitting.
 
 ## Input and response values
 
-Optional properties distinguish omission from null. PHP inputs use presence-aware typed input objects constructed from arrays: omit a key to omit it; include a key with null to clear only where permitted. PHP models expose presence through has()/get(); typed getters unwrap nested models and getters for omitted optional fields throw. In object/array alternatives, PHP lists (including []) represent JSON arrays; use (object) [] for an empty JSON object.
+Optional properties distinguish omission from null. PHP methods accept associative arrays or presence-aware typed input objects constructed from arrays: omit a key to omit it; include a key with null to clear only where permitted. PHP models expose presence through has()/get() and generated hasField() methods. Use valueOrDefault("field", fallback) for optional values; explicit null stays null. Typed getters unwrap nested values and throw with the field name when a field is omitted. In object/array alternatives, PHP lists (including []) represent JSON arrays; use (object) [] for an empty JSON object.
 
 Numeric enum inputs use exact strings for number/int64/uint64 schemas; membership compares exact values, so equivalent decimal/exponent spellings are accepted. Numeric anyOf branches merge equivalent values exactly and preserve the request token; oneOf still requires exactly one matching branch. Numeric conversions supported only by branches that stop matching fail validation before dispatch. Mutually dependent numeric alternatives use joint matching, limited to 256 combinations per value path; exceeding this limit fails validation.
 
-Large integers (int64) and decimals use exact strings, including numeric JSON wire values. When the provider enables explicit numeric unions, ambiguous numeric inputs use new ExactNumber("1.2500") and plain strings retain their JSON string meaning. Integer responses accept integral decimal/exponent notation without rounding. Sparse Node input arrays fail before dispatch. Timestamps remain strings. Unknown response fields, enum members, and tagged variants are retained.
+Large integers (int64) and decimals use exact strings, including numeric JSON wire values. Ambiguous numeric inputs automatically use new ExactNumber("1.2500") and plain strings retain their JSON string meaning. Integer responses accept integral decimal/exponent notation without rounding. Sparse Node input arrays fail before dispatch. Timestamps remain strings. Unknown response fields, enum members, and tagged variants are retained.
 
 PHP response class names include status codes and, for tagged alternatives, branch positions. Adding a status can introduce a new return class even with an identical JSON shape; consult migration notes before upgrading class-based dispatch.
 
@@ -30,7 +53,7 @@ Retries count total attempts, include jitter and Retry-After, and never exceed t
 
 ## Timeouts, streaming and cancellation
 
-Timeout is per attempt, including buffered body consumption. For SSE, timeout/deadline bound connection setup; streamIdleTimeoutMs controls idle reads and streamLifetimeMs optionally bounds stream lifetime. Close result.data or the client to release a stream; breaking iteration also closes it. Unknown event names retain raw strings. Reconnect and persist resume cursors explicitly; no yielded event is retried automatically.
+Timeout is per attempt, including buffered body consumption. For SSE, timeout/deadline bound connection setup; streamIdleTimeoutMs controls idle reads and streamLifetimeMs optionally bounds stream lifetime. Close the returned stream (Result.data in result mode) or the client to release a stream; breaking iteration also closes it. Unknown event names retain raw strings. Reconnect and persist resume cursors explicitly; no yielded event is retried automatically.
 
 Deadline covers attempts and waits; pagination and polling share an overall deadline. Cancellation stops local work, not the remote operation. Node uses AbortSignal. PHP uses a Cancellation token checked during cURL progress and between waits; synchronous calls need an external signal handler to cancel while blocked.
 
@@ -50,7 +73,7 @@ Clients perform no network I/O at import/construction. Node clients reuse the ru
 
 Diagnostics run once per attempted HTTP request, including transport failures, with operation, request ID, status, timing, attempt count and error kind only; hook failures are ignored. Bodies and credentials are excluded. Raw response text/headers and structured error details are privileged explicit access. Binary/stream result inspection omits raw headers and URLs; event inspection omits payloads.
 
-Node Model.toJSON() and PHP model accessors return defensive copies. To change an input, edit the Node toJSON() or PHP toInputArray()/toInputValue() copy and construct a new model; the PHP input exports preserve exact numeric kinds. Model debug printing redacts declared sensitive fields and additional field names supplied in ClientOptions.redactFields; printing arbitrary raw values is application responsibility. Injected transports are privileged and see credentials/bodies.
+Node Model.toJSON() returns a defensive copy of the public JSON representation, with exact numbers represented as strings. Rebuilding from that copy treats these as JSON strings in number/string alternatives. To edit a Node input, retain the original input values, including ExactNumber instances, and construct a new model from the updated input. If editing a toJSON() copy, explicitly restore ExactNumber at fields intended to be JSON numbers in ambiguous alternatives. PHP model accessors also return defensive copies; use toInputArray()/toInputValue() to edit and rebuild inputs while preserving exact numeric kinds. Model debug printing redacts declared sensitive fields and additional field names supplied in ClientOptions.redactFields; printing arbitrary raw values is application responsibility. Injected transports are privileged and see credentials/bodies.
 
 ## Schema helpers
 
@@ -67,3 +90,44 @@ Verification uses the configured HMAC-SHA256 signature format, signed headers an
 ## Custom helpers
 
 Custom helpers belong in custom/; they survive regeneration. Multi-call helpers are not atomic and must expose partial completion. See [reference](REFERENCE.md).
+
+## Resume an action with its saved key
+
+Use this only after reconciling the previous outcome and confirming the provider permits resubmission. Read the key and the original input from your saved action; keep both unchanged. The environment variable below stands in for your application's durable action record. Do not generate a new key when retrying that action. This example makes one request attempt.
+
+```typescript
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const idempotencyKey = process.env.API_IDEMPOTENCY_KEY;
+if (!idempotencyKey) throw new Error('Set API_IDEMPOTENCY_KEY to the key saved with this action');
+const result = await client.orders.addCharge(
+  "example",
+  {
+    charge: {
+      name: "example",
+      type: "service_fee",
+      amount_money: {
+        amount: "0",
+        currency: "USD",
+      },
+    },
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.order_id);
+console.log(result.status);
+```
+
+## Response return modes
+
+Payload-mode methods return the decoded body, or their explicitly configured payload path, directly. Their WithResponse companions return SdkResponse with body, meta and raw, without unwrapping. Each invocation makes its own request; choose one form per action. Result-mode operations keep their existing data/meta/raw envelope. Pages and Wait helpers always return full Results, and Items helpers yield individual items; pagination and polling paths still address the original body.
+
+```typescript
+const response = await client.orders.addChargeWithResponse("example", {charge: {name: "example", type: "service_fee", amount_money: {amount: "0", currency: "USD"}}});
+console.log(response.body, response.meta.requestId);
+```
+

package/contract.d.ts

@@ -1,3 +1,6 @@
+import { type RequestStyle } from './request-style.js';
+import { type ResponseReturn } from './response-return.js';
+import { Diagnostic } from './diagnostic.js';
 export type Json = null | boolean | number | string | Json[] | {
     [key: string]: Json;
 };
@@ -65,6 +68,8 @@ export interface Retry {
     baseDelayMs: number;
 }
 export interface Capability {
+    request?: RequestStyle;
+    response?: ResponseReturn;
     stream?: {
         events?: Record<string, string>;
         idleTimeoutMs?: number;
@@ -128,6 +133,10 @@ export interface Auth {
     type: 'bearer' | 'apiKey';
     header: string;
 }
+export type AuthShortcuts = Record<string, {
+    mode: string;
+    scheme: string;
+}>;
 export interface AuthenticationMode {
     schemes: (Auth & {
         name: string;
@@ -146,8 +155,12 @@ export interface Webhook {
     typeField: string;
 }
 export interface Config {
+    requests?: RequestStyle;
+    responses?: ResponseReturn;
     profiles?: string[];
+    /** @deprecated Exact-number/string alternatives are supported automatically. */
     numericUnions?: 'explicit';
+    /** @deprecated Named schema sharing is automatic. */
     schemaSharing?: 'named';
     validation?: 'encoding' | 'schema';
     auth?: {
@@ -157,6 +170,7 @@ export interface Config {
             schemes: string[];
             operations?: string[];
         }>;
+        shortcuts?: AuthShortcuts;
     };
     targets?: ('node' | 'php')[];
     version: string;
@@ -208,6 +222,7 @@ export interface Contract {
     modelDependencies?: Record<string, string[]>;
     auth?: Auth;
     authentication?: Record<string, AuthenticationMode>;
+    authShortcuts?: AuthShortcuts;
     config: Config;
     sources: Record<string, string>;
     hash: string;
@@ -223,4 +238,7 @@ export interface IncomingWebhook {
 export { Diagnostic } from './diagnostic.js';
 export { stable } from './canonical.js';
 export declare const hash: (value: string) => string;
-export declare function loadContract(definitionPath: string, configPath: string): Contract;
+export declare function loadContract(definitionPath: string, configPath: string, options?: {
+    collectDiagnostics?: boolean;
+    onWarning?: (warning: Diagnostic) => void;
+}): Contract;

package/diagnostic.d.ts

@@ -1,4 +1,20 @@
 export declare class Diagnostic extends Error {
     location: string;
-    constructor(location: string, message: string);
+    detail: string;
+    constructor(location: string, detail: string);
 }
+export declare class DiagnosticGroup extends Diagnostic {
+    findings: Diagnostic[];
+    constructor(findings: Diagnostic[]);
+}
+/** Collect only expected validation failures, never programming errors. */
+export declare class DiagnosticCollector {
+    private enabled;
+    readonly findings: Diagnostic[];
+    constructor(enabled: boolean);
+    capture(error: unknown): void;
+    check(validate: () => void): boolean;
+    finish(): void;
+}
+/** Suggest nearby spellings, including an adjacent letter transposition. */
+export declare function suggestion(value: string, candidates: readonly string[]): string;

package/diagnostic.js

@@ -1,9 +1,76 @@
 export class Diagnostic extends Error {
     location;
-    constructor(location, message) {
-        super(`${location}: ${message}`);
+    detail;
+    constructor(location, detail) {
+        super(`${location}: ${detail}`);
         this.location = location;
+        this.detail = detail;
         this.name = 'Diagnostic';
     }
 }
+export class DiagnosticGroup extends Diagnostic {
+    findings;
+    constructor(findings) {
+        super(findings[0].location, findings[0].detail);
+        this.findings = findings;
+        this.message = findings.map((finding) => finding.message).join('\n');
+    }
+}
+/** Collect only expected validation failures, never programming errors. */
+export class DiagnosticCollector {
+    enabled;
+    findings = [];
+    constructor(enabled) {
+        this.enabled = enabled;
+    }
+    capture(error) {
+        if (!this.enabled || !(error instanceof Diagnostic))
+            throw error;
+        for (const finding of error instanceof DiagnosticGroup ? error.findings : [error])
+            if (!this.findings.some((existing) => existing.message === finding.message))
+                this.findings.push(finding);
+    }
+    check(validate) {
+        try {
+            validate();
+            return true;
+        }
+        catch (error) {
+            this.capture(error);
+            return false;
+        }
+    }
+    finish() {
+        if (this.findings.length)
+            throw new DiagnosticGroup(this.findings);
+    }
+}
+/** Suggest nearby spellings, including an adjacent letter transposition. */
+export function suggestion(value, candidates) {
+    const limit = value.length < 4 ? 1 : 2;
+    let best;
+    let distance = limit + 1;
+    for (const candidate of [...candidates].sort()) {
+        if (Math.abs(candidate.length - value.length) > limit)
+            continue;
+        const rows = Array.from({ length: value.length + 1 }, (_, i) => [i]);
+        rows[0] = Array.from({ length: candidate.length + 1 }, (_, i) => i);
+        for (let i = 1; i <= value.length; i++) {
+            for (let j = 1; j <= candidate.length; j++) {
+                rows[i][j] = Math.min(rows[i - 1][j] + 1, rows[i][j - 1] + 1, rows[i - 1][j - 1] + (value[i - 1] === candidate[j - 1] ? 0 : 1));
+                if (i > 1 &&
+                    j > 1 &&
+                    value[i - 1] === candidate[j - 2] &&
+                    value[i - 2] === candidate[j - 1])
+                    rows[i][j] = Math.min(rows[i][j], rows[i - 2][j - 2] + 1);
+            }
+        }
+        const current = rows[value.length][candidate.length];
+        if (current < distance) {
+            best = candidate;
+            distance = current;
+        }
+    }
+    return best === undefined ? '' : ` Did you mean "${best}"?`;
+}
 //# sourceMappingURL=diagnostic.js.map

package/examples/analytics-getOverview.mjs

@@ -0,0 +1,11 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.analytics.getOverview(
+  {
+    range: "today",
+  },
+  { maxAttempts: 1 },
+);

package/examples/analytics-getOverview.ts

@@ -0,0 +1,11 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.analytics.getOverview(
+  {
+    range: "today",
+  },
+  { maxAttempts: 1 },
+);

package/examples/analytics-getPaymentVolumeTimeseries.mjs

@@ -0,0 +1,11 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.analytics.getPaymentVolumeTimeseries(
+  {
+    range: "today",
+  },
+  { maxAttempts: 1 },
+);

package/examples/analytics-getPaymentVolumeTimeseries.ts

@@ -0,0 +1,11 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.analytics.getPaymentVolumeTimeseries(
+  {
+    range: "today",
+  },
+  { maxAttempts: 1 },
+);

package/examples/analytics-getSubscription.mjs

@@ -0,0 +1,11 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.analytics.getSubscription(
+  {
+    range: "today",
+  },
+  { maxAttempts: 1 },
+);

package/examples/analytics-getSubscription.ts

@@ -0,0 +1,11 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.analytics.getSubscription(
+  {
+    range: "today",
+  },
+  { maxAttempts: 1 },
+);

package/examples/apiKeys-create.mjs

@@ -0,0 +1,18 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.apiKeys.create(
+  {
+    name: "example",
+    scopes: [],
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/apiKeys-create.ts

@@ -0,0 +1,18 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.apiKeys.create(
+  {
+    name: "example",
+    scopes: [],
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/apiKeys-get.mjs

@@ -0,0 +1,12 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.apiKeys.get(
+  "example",
+  {},
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/apiKeys-get.ts

@@ -0,0 +1,12 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.apiKeys.get(
+  "example",
+  {},
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/apiKeys-list.mjs

@@ -0,0 +1,9 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.apiKeys.list(
+  {},
+  { maxAttempts: 1 },
+);

package/examples/apiKeys-list.ts

@@ -0,0 +1,9 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.apiKeys.list(
+  {},
+  { maxAttempts: 1 },
+);

package/examples/apiKeys-revoke.mjs

@@ -0,0 +1,17 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.apiKeys.revoke(
+  "example",
+  {
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/apiKeys-revoke.ts

@@ -0,0 +1,17 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.apiKeys.revoke(
+  "example",
+  {
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/apiKeys-update.mjs

@@ -0,0 +1,17 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.apiKeys.update(
+  "example",
+  {
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/apiKeys-update.ts

@@ -0,0 +1,17 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.apiKeys.update(
+  "example",
+  {
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.api_key_id);
+console.log(result.status);

package/examples/balanceTransactions-get.mjs

@@ -0,0 +1,12 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.balanceTransactions.get(
+  "example",
+  {},
+  { maxAttempts: 1 },
+);
+console.log(result.balance_transaction_id);
+console.log(result.merchant_id);

package/examples/balanceTransactions-get.ts

@@ -0,0 +1,12 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.balanceTransactions.get(
+  "example",
+  {},
+  { maxAttempts: 1 },
+);
+console.log(result.balance_transaction_id);
+console.log(result.merchant_id);

package/examples/balanceTransactions-list.mjs

@@ -0,0 +1,9 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.balanceTransactions.list(
+  {},
+  { maxAttempts: 1 },
+);

package/examples/balanceTransactions-list.ts

@@ -0,0 +1,9 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.balanceTransactions.list(
+  {},
+  { maxAttempts: 1 },
+);

package/examples/balances-list.mjs

@@ -0,0 +1,9 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.balances.list(
+  {},
+  { maxAttempts: 1 },
+);

package/examples/balances-list.ts

@@ -0,0 +1,9 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.balances.list(
+  {},
+  { maxAttempts: 1 },
+);

package/examples/bundles-create.mjs

@@ -0,0 +1,21 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.bundles.create(
+  {
+    name: "example",
+    unit_price_money: {
+      amount: "0",
+      currency: "USD",
+    },
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.bundle_id);
+console.log(result.status);

package/examples/bundles-create.ts

@@ -0,0 +1,21 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+// Reuse this key when retrying the same action.
+const idempotencyKey = crypto.randomUUID();
+
+const result = await client.bundles.create(
+  {
+    name: "example",
+    unit_price_money: {
+      amount: "0",
+      currency: "USD",
+    },
+    "Idempotency-Key": idempotencyKey,
+  },
+  { maxAttempts: 1 },
+);
+console.log(result.bundle_id);
+console.log(result.status);

package/examples/bundles-get.mjs

@@ -0,0 +1,12 @@
+import { Client } from '@flintpay/node';
+const client = new Client({
+  baseUrl: process.env.API_BASE_URL ?? 'https://sandbox.example.invalid',
+  apiKey: process.env.API_KEY ?? '',
+});
+const result = await client.bundles.get(
+  "example",
+  {},
+  { maxAttempts: 1 },
+);
+console.log(result.bundle_id);
+console.log(result.status);