@tagadapay/node-sdk 0.2.1 → 1.1.0

package/dist/onboarding/OnboardingClient.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Public, **unauthenticated** client for the Tagada onboarding endpoints.
+ *
+ * This is intentionally *not* a `Resource` on the main `Tagada` class because
+ * `Tagada` requires an API key in its constructor — but the whole point of
+ * onboarding is to *get* an API key. So we ship this as a standalone client
+ * that bypasses {@link HttpClient} entirely and uses `fetch` directly.
+ *
+ * Hits:
+ *   - `POST {baseUrl}/api/public/onboarding/start`
+ *   - `POST {baseUrl}/api/public/onboarding/verify`
+ *
+ * For a turn-key interactive flow, prefer the bundled `tagada-init` CLI:
+ *   `npx -p @tagadapay/node-sdk tagada-init you@example.com`
+ *
+ * @example
+ * ```ts
+ * import Tagada from '@tagadapay/node-sdk';
+ *
+ * const client = Tagada.public();
+ *
+ * await client.start({ email: 'you@example.com', source: 'cli' });
+ * // ...prompt the user for the 6-digit code from their inbox...
+ * const { apiKey, storeId } = await client.verify({
+ *   email: 'you@example.com',
+ *   code: '384921',
+ *   source: 'cli',
+ * });
+ *
+ * // Now build a regular Tagada client with the new key:
+ * const tagada = new Tagada(apiKey);
+ * ```
+ */
+export interface OnboardingClientOptions {
+    /**
+     * Base URL of the TagadaPay API (no path suffix). Default:
+     * `https://api.tagada.io`. Override for local development:
+     * `http://localhost:3000`.
+     */
+    baseUrl?: string;
+    /** Per-request timeout, default 30s. */
+    timeout?: number;
+}
+export interface OnboardingStartInput {
+    /** Email that will receive the 6-digit code. */
+    email: string;
+    /** Free-form source tag (e.g. `'cli'`, `'docs'`, `'partner_xyz'`). */
+    source?: string;
+    /** Optional acquisition payload. Kept opaque so we can add fields later. */
+    utm?: Record<string, string>;
+}
+export interface OnboardingStartResult {
+    ok: true;
+    /** ISO-8601 timestamp at which the issued code stops working. */
+    expiresAt: string;
+}
+export interface OnboardingVerifyInput extends OnboardingStartInput {
+    /** Exactly 6 digits. */
+    code: string;
+}
+export interface OnboardingVerifyResult {
+    ok: true;
+    /** Use this immediately as `new Tagada(apiKey)`. */
+    apiKey: string;
+    accountId: string;
+    storeId: string;
+    clerkUserId: string;
+    clerkOrgId: string;
+    /** Slug of the auto-created Clerk org (used by the CRM URL scheme). */
+    orgSlug: string | null;
+    /**
+     * Products / payment flow / funnel are seeded asynchronously via Inngest.
+     * Poll `tagada.stores.retrieve(storeId).config.demoSeeding` if you need
+     * to wait for it before running an end-to-end test.
+     */
+    demoSeeding: 'pending';
+}
+export type OnboardingErrorCode = 'invalid_request' | 'invalid_code' | 'expired' | 'no_pending_code' | 'too_many_attempts' | 'rate_limited' | 'email_send_failed' | 'provisioning_failed' | 'network_error' | 'unknown';
+export declare class OnboardingError extends Error {
+    readonly code: OnboardingErrorCode;
+    readonly statusCode: number | null;
+    readonly resetAt: Date | null;
+    readonly raw: unknown;
+    constructor(opts: {
+        message: string;
+        code: OnboardingErrorCode;
+        statusCode?: number | null;
+        resetAt?: Date | null;
+        raw?: unknown;
+    });
+}
+export declare class OnboardingClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(opts?: OnboardingClientOptions);
+    /**
+     * Issue a fresh 6-digit verification code to the supplied email. Returns
+     * once the code has been queued for delivery — typically lands in the
+     * inbox within a few seconds.
+     *
+     * @throws {OnboardingError} `rate_limited` (429), `email_send_failed`
+     *   (502), `invalid_request` (400), `network_error`, or `unknown`.
+     */
+    start(input: OnboardingStartInput): Promise<OnboardingStartResult>;
+    /**
+     * Verify the code; on success provisions a fresh sandbox account and
+     * returns its API key + IDs.
+     *
+     * @throws {OnboardingError} `invalid_code` (401), `expired` (410),
+     *   `no_pending_code` (410), `too_many_attempts` (429),
+     *   `rate_limited` (429), `provisioning_failed` (5xx),
+     *   `invalid_request` (400), `network_error`, or `unknown`.
+     */
+    verify(input: OnboardingVerifyInput): Promise<OnboardingVerifyResult>;
+    private post;
+}
+//# sourceMappingURL=OnboardingClient.d.ts.map

package/dist/onboarding/OnboardingClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnboardingClient.d.ts","sourceRoot":"","sources":["../../src/onboarding/OnboardingClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,IAAI,CAAC;IACT,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,WAAW,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,cAAc,GACd,SAAS,GACT,iBAAiB,GACjB,mBAAmB,GACnB,cAAc,GACd,mBAAmB,GACnB,qBAAqB,GACrB,eAAe,GACf,SAAS,CAAC;AAEd,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;gBAEV,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,mBAAmB,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QACtB,GAAG,CAAC,EAAE,OAAO,CAAC;KACf;CAQF;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,GAAE,uBAA4B;IAK9C;;;;;;;OAOG;IACG,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIxE;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAI7D,IAAI;CAiEnB"}

package/dist/onboarding/OnboardingClient.js

@@ -0,0 +1,154 @@
+/**
+ * Public, **unauthenticated** client for the Tagada onboarding endpoints.
+ *
+ * This is intentionally *not* a `Resource` on the main `Tagada` class because
+ * `Tagada` requires an API key in its constructor — but the whole point of
+ * onboarding is to *get* an API key. So we ship this as a standalone client
+ * that bypasses {@link HttpClient} entirely and uses `fetch` directly.
+ *
+ * Hits:
+ *   - `POST {baseUrl}/api/public/onboarding/start`
+ *   - `POST {baseUrl}/api/public/onboarding/verify`
+ *
+ * For a turn-key interactive flow, prefer the bundled `tagada-init` CLI:
+ *   `npx -p @tagadapay/node-sdk tagada-init you@example.com`
+ *
+ * @example
+ * ```ts
+ * import Tagada from '@tagadapay/node-sdk';
+ *
+ * const client = Tagada.public();
+ *
+ * await client.start({ email: 'you@example.com', source: 'cli' });
+ * // ...prompt the user for the 6-digit code from their inbox...
+ * const { apiKey, storeId } = await client.verify({
+ *   email: 'you@example.com',
+ *   code: '384921',
+ *   source: 'cli',
+ * });
+ *
+ * // Now build a regular Tagada client with the new key:
+ * const tagada = new Tagada(apiKey);
+ * ```
+ */
+const DEFAULT_BASE_URL = 'https://api.tagada.io';
+const DEFAULT_TIMEOUT_MS = 30000;
+export class OnboardingError extends Error {
+    constructor(opts) {
+        super(opts.message);
+        this.name = 'OnboardingError';
+        this.code = opts.code;
+        this.statusCode = opts.statusCode ?? null;
+        this.resetAt = opts.resetAt ?? null;
+        this.raw = opts.raw;
+    }
+}
+export class OnboardingClient {
+    constructor(opts = {}) {
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.timeout = opts.timeout ?? DEFAULT_TIMEOUT_MS;
+    }
+    /**
+     * Issue a fresh 6-digit verification code to the supplied email. Returns
+     * once the code has been queued for delivery — typically lands in the
+     * inbox within a few seconds.
+     *
+     * @throws {OnboardingError} `rate_limited` (429), `email_send_failed`
+     *   (502), `invalid_request` (400), `network_error`, or `unknown`.
+     */
+    async start(input) {
+        return this.post('/api/public/onboarding/start', input);
+    }
+    /**
+     * Verify the code; on success provisions a fresh sandbox account and
+     * returns its API key + IDs.
+     *
+     * @throws {OnboardingError} `invalid_code` (401), `expired` (410),
+     *   `no_pending_code` (410), `too_many_attempts` (429),
+     *   `rate_limited` (429), `provisioning_failed` (5xx),
+     *   `invalid_request` (400), `network_error`, or `unknown`.
+     */
+    async verify(input) {
+        return this.post('/api/public/onboarding/verify', input);
+    }
+    async post(path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        let res;
+        try {
+            res = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                    'User-Agent': 'tagada-node-sdk/onboarding',
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            if (err.name === 'AbortError') {
+                throw new OnboardingError({
+                    message: `Request to ${url} timed out after ${this.timeout}ms`,
+                    code: 'network_error',
+                });
+            }
+            throw new OnboardingError({
+                message: `Failed to reach ${url}: ${err.message}`,
+                code: 'network_error',
+                raw: err,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        let parsed = null;
+        try {
+            parsed = await res.json();
+        }
+        catch {
+            // Empty / non-JSON body — fall through with parsed=null.
+        }
+        if (res.ok) {
+            return parsed;
+        }
+        const body_ = (parsed ?? {});
+        // Map the server's error.code / status pair to our discriminated codes.
+        const code = mapErrorCode(res.status, body_.code);
+        const message = body_.error ?? `Request failed with status ${res.status}`;
+        const resetAt = body_.resetAt ? new Date(body_.resetAt) : null;
+        throw new OnboardingError({
+            message,
+            code,
+            statusCode: res.status,
+            resetAt,
+            raw: parsed,
+        });
+    }
+}
+function mapErrorCode(status, serverCode) {
+    if (serverCode === 'invalid_code')
+        return 'invalid_code';
+    if (serverCode === 'expired')
+        return 'expired';
+    if (serverCode === 'no_pending_code')
+        return 'no_pending_code';
+    if (serverCode === 'too_many_attempts')
+        return 'too_many_attempts';
+    if (status === 429)
+        return 'rate_limited';
+    if (status === 502)
+        return 'email_send_failed';
+    if (status === 400)
+        return 'invalid_request';
+    if (status === 410)
+        return 'expired';
+    if (status === 401)
+        return 'invalid_code';
+    if (status >= 500)
+        return 'provisioning_failed';
+    return 'unknown';
+}
+//# sourceMappingURL=OnboardingClient.js.map

package/dist/onboarding/OnboardingClient.js.map

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

package/dist/resources/Partners.d.ts

@@ -0,0 +1,133 @@
+import { BaseResource } from './BaseResource.js';
+import type { RequestOptions } from '../types/common.js';
+import type { PartnerAccount, PartnerAccountCreateParams, PartnerAccountListParams, PartnerAccountUpdateParams, PartnerAccountRepointStoreParams, PartnerApiKey, PartnerApiKeyCreated, PartnerApiKeyCreateParams, PartnerRequirement, PartnerRequirementUpdateParams, PartnerDocument, PartnerDocumentRecordParams } from '../types/partners.js';
+/**
+ * Partner Accounts resource (`tagada.partners.accounts.*`).
+ *
+ * Wraps `/api/tagadapay/v1/accounts`. Used by partners (PSPs, marketplaces,
+ * embedded-payments platforms) to provision and manage sub-merchants (TPAs).
+ *
+ * Each `create()` call atomically creates:
+ *   1. an `accounts` row (private namespace, no Clerk user — never auto-invited)
+ *   2. a `stores` row (auto-provisioned, `1 TPA = 1 store` invariant)
+ *   3. a `tagadapay_accounts` row (the TPA itself)
+ *
+ * Idempotency: pass `externalRef` to make `create()` idempotent on retries.
+ * A second call with the same `(partnerId, externalRef)` returns the existing TPA.
+ */
+export declare class PartnerAccounts extends BaseResource {
+    /**
+     * Provision a new sub-merchant. Atomically creates the `accounts` row,
+     * the auto-provisioned store, and the TPA in a single round-trip.
+     *
+     * @example
+     * const tpa = await tagada.partners.accounts.create({
+     *   legalName: 'Acme SAS',
+     *   country: 'FR',
+     *   currency: 'EUR',
+     *   externalRef: 'merchant_42',  // your own id — used for idempotency
+     * });
+     * // → { id: 'tpa_xxx', storeId: 'store_xxx', accountId: 'acc_xxx', ... }
+     */
+    create(params: PartnerAccountCreateParams, opts?: RequestOptions): Promise<PartnerAccount>;
+    retrieve(tpaId: string, opts?: RequestOptions): Promise<PartnerAccount>;
+    /**
+     * Look up a TPA by your own external reference (e.g. your merchant id).
+     * Returns `null` if no TPA matches.
+     */
+    retrieveByExternalRef(externalRef: string, opts?: RequestOptions): Promise<PartnerAccount | null>;
+    list(params?: PartnerAccountListParams, opts?: RequestOptions): Promise<{
+        data: PartnerAccount[];
+        hasMore: boolean;
+    }>;
+    update(tpaId: string, params: PartnerAccountUpdateParams, opts?: RequestOptions): Promise<PartnerAccount>;
+    /**
+     * Move the TPA from its current store to `targetStoreId`. The target
+     * store MUST belong to the same `accounts` row — we never let a TPA
+     * cross merchant entities. The old store stays intact (orphaned from
+     * any active TPA) so historical data remains accessible.
+     *
+     * NOT YET IMPLEMENTED — the corresponding backend route
+     * (`POST /api/tagadapay/v1/accounts/:id/repoint_store`) ships in a
+     * later phase. This stub throws synchronously so partner code
+     * doesn&rsquo;t depend on a route that 404s in production. Track the
+     * upstream ticket before re-enabling.
+     *
+     * @internal
+     */
+    repointStore(_tpaId: string, _params: PartnerAccountRepointStoreParams, _opts?: RequestOptions): Promise<PartnerAccount>;
+    /**
+     * Send a TagadaPay portal invitation to the merchant. Only meaningful
+     * when the partner&rsquo;s `merchantPortalAccess` policy is `'on_request'`.
+     *
+     * NOT YET IMPLEMENTED — the corresponding backend route
+     * (`POST /api/tagadapay/v1/accounts/:id/onboarding_link`) ships
+     * alongside the merchant-portal access policy enforcement. Stub
+     * throws synchronously to prevent silent 404s in partner code.
+     *
+     * @internal
+     */
+    invite(_tpaId: string, _opts?: RequestOptions): Promise<{
+        url: string;
+        expiresAt: string;
+    }>;
+}
+/**
+ * Partner API keys resource (`tagada.partners.apiKeys.*`).
+ *
+ * Sub-keys are restricted to a single TPA. Use sub-keys (not the partner key)
+ * for charging — smaller blast radius if either leaks.
+ */
+export declare class PartnerApiKeys extends BaseResource {
+    /**
+     * Mint a sub-key restricted to one TPA. The plaintext `secret` is
+     * returned ONLY on creation — store it immediately in your secret manager.
+     */
+    create(tpaId: string, params?: PartnerApiKeyCreateParams, opts?: RequestOptions): Promise<PartnerApiKeyCreated>;
+    list(tpaId: string, opts?: RequestOptions): Promise<{
+        data: PartnerApiKey[];
+    }>;
+    /**
+     * Revoke a sub-key. Subsequent calls with that secret get HTTP 401.
+     * In-flight calls complete normally. Irreversible &mdash; mint a new key
+     * and deploy it before revoking.
+     */
+    revoke(apiKeyId: string, opts?: RequestOptions): Promise<{
+        id: string;
+        status: 'revoked';
+    }>;
+}
+/**
+ * Partner KYB requirements resource (`tagada.partners.requirements.*`).
+ */
+export declare class PartnerRequirements extends BaseResource {
+    list(tpaId: string, opts?: RequestOptions): Promise<{
+        data: PartnerRequirement[];
+    }>;
+    update(tpaId: string, code: string, params: PartnerRequirementUpdateParams, opts?: RequestOptions): Promise<PartnerRequirement>;
+}
+/**
+ * Partner KYB documents resource (`tagada.partners.documents.*`).
+ *
+ * v1 ships only the metadata-only path. Document bytes live in S3 — you
+ * upload directly via a presigned URL we issue (`getUploadUrl()`), then
+ * call `record()` with the resulting `storageUrl` to attach metadata.
+ */
+export declare class PartnerDocuments extends BaseResource {
+    list(tpaId: string, opts?: RequestOptions): Promise<{
+        data: PartnerDocument[];
+    }>;
+    record(params: PartnerDocumentRecordParams, opts?: RequestOptions): Promise<PartnerDocument>;
+}
+/**
+ * Aggregator class exposed as `tagada.partners`. Holds the per-resource
+ * sub-clients so you can write `tagada.partners.accounts.create(...)`.
+ */
+export declare class Partners {
+    readonly accounts: PartnerAccounts;
+    readonly apiKeys: PartnerApiKeys;
+    readonly requirements: PartnerRequirements;
+    readonly documents: PartnerDocuments;
+    constructor(client: ConstructorParameters<typeof PartnerAccounts>[0]);
+}
+//# sourceMappingURL=Partners.d.ts.map

package/dist/resources/Partners.d.ts.map

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

package/dist/resources/Partners.js

@@ -0,0 +1,151 @@
+import { BaseResource } from './BaseResource.js';
+/**
+ * Partner Accounts resource (`tagada.partners.accounts.*`).
+ *
+ * Wraps `/api/tagadapay/v1/accounts`. Used by partners (PSPs, marketplaces,
+ * embedded-payments platforms) to provision and manage sub-merchants (TPAs).
+ *
+ * Each `create()` call atomically creates:
+ *   1. an `accounts` row (private namespace, no Clerk user — never auto-invited)
+ *   2. a `stores` row (auto-provisioned, `1 TPA = 1 store` invariant)
+ *   3. a `tagadapay_accounts` row (the TPA itself)
+ *
+ * Idempotency: pass `externalRef` to make `create()` idempotent on retries.
+ * A second call with the same `(partnerId, externalRef)` returns the existing TPA.
+ */
+export class PartnerAccounts extends BaseResource {
+    /**
+     * Provision a new sub-merchant. Atomically creates the `accounts` row,
+     * the auto-provisioned store, and the TPA in a single round-trip.
+     *
+     * @example
+     * const tpa = await tagada.partners.accounts.create({
+     *   legalName: 'Acme SAS',
+     *   country: 'FR',
+     *   currency: 'EUR',
+     *   externalRef: 'merchant_42',  // your own id — used for idempotency
+     * });
+     * // → { id: 'tpa_xxx', storeId: 'store_xxx', accountId: 'acc_xxx', ... }
+     */
+    async create(params, opts) {
+        return this.client.partnerPost('/v1/accounts', params, opts);
+    }
+    async retrieve(tpaId, opts) {
+        return this.client.partnerGet(`/v1/accounts/${tpaId}`, undefined, opts);
+    }
+    /**
+     * Look up a TPA by your own external reference (e.g. your merchant id).
+     * Returns `null` if no TPA matches.
+     */
+    async retrieveByExternalRef(externalRef, opts) {
+        const list = await this.client.partnerGet('/v1/accounts', { externalRef, limit: 1 }, opts);
+        return list.data?.[0] ?? null;
+    }
+    async list(params, opts) {
+        return this.client.partnerGet('/v1/accounts', params, opts);
+    }
+    async update(tpaId, params, opts) {
+        return this.client.partnerPut(`/v1/accounts/${tpaId}`, params, opts);
+    }
+    /**
+     * Move the TPA from its current store to `targetStoreId`. The target
+     * store MUST belong to the same `accounts` row — we never let a TPA
+     * cross merchant entities. The old store stays intact (orphaned from
+     * any active TPA) so historical data remains accessible.
+     *
+     * NOT YET IMPLEMENTED — the corresponding backend route
+     * (`POST /api/tagadapay/v1/accounts/:id/repoint_store`) ships in a
+     * later phase. This stub throws synchronously so partner code
+     * doesn’t depend on a route that 404s in production. Track the
+     * upstream ticket before re-enabling.
+     *
+     * @internal
+     */
+    async repointStore(_tpaId, _params, _opts) {
+        throw new Error("[tagada.partners.accounts.repointStore] route_not_implemented — " +
+            "the backend route POST /v1/accounts/:id/repoint_store is not yet " +
+            "available. Contact the TagadaPay team if you need TPA re-pointing.");
+    }
+    /**
+     * Send a TagadaPay portal invitation to the merchant. Only meaningful
+     * when the partner’s `merchantPortalAccess` policy is `'on_request'`.
+     *
+     * NOT YET IMPLEMENTED — the corresponding backend route
+     * (`POST /api/tagadapay/v1/accounts/:id/onboarding_link`) ships
+     * alongside the merchant-portal access policy enforcement. Stub
+     * throws synchronously to prevent silent 404s in partner code.
+     *
+     * @internal
+     */
+    async invite(_tpaId, _opts) {
+        throw new Error("[tagada.partners.accounts.invite] route_not_implemented — " +
+            "the backend route POST /v1/accounts/:id/onboarding_link is not " +
+            "yet available. Contact the TagadaPay team if you need merchant " +
+            "portal invitations.");
+    }
+}
+/**
+ * Partner API keys resource (`tagada.partners.apiKeys.*`).
+ *
+ * Sub-keys are restricted to a single TPA. Use sub-keys (not the partner key)
+ * for charging — smaller blast radius if either leaks.
+ */
+export class PartnerApiKeys extends BaseResource {
+    /**
+     * Mint a sub-key restricted to one TPA. The plaintext `secret` is
+     * returned ONLY on creation — store it immediately in your secret manager.
+     */
+    async create(tpaId, params, opts) {
+        return this.client.partnerPost(`/v1/accounts/${tpaId}/api_keys`, params ?? {}, opts);
+    }
+    async list(tpaId, opts) {
+        return this.client.partnerGet(`/v1/accounts/${tpaId}/api_keys`, undefined, opts);
+    }
+    /**
+     * Revoke a sub-key. Subsequent calls with that secret get HTTP 401.
+     * In-flight calls complete normally. Irreversible — mint a new key
+     * and deploy it before revoking.
+     */
+    async revoke(apiKeyId, opts) {
+        return this.client.partnerDel(`/v1/api_keys/${apiKeyId}`, undefined, opts);
+    }
+}
+/**
+ * Partner KYB requirements resource (`tagada.partners.requirements.*`).
+ */
+export class PartnerRequirements extends BaseResource {
+    async list(tpaId, opts) {
+        return this.client.partnerGet(`/v1/accounts/${tpaId}/requirements`, undefined, opts);
+    }
+    async update(tpaId, code, params, opts) {
+        return this.client.partnerPut(`/v1/accounts/${tpaId}/requirements/${code}`, params, opts);
+    }
+}
+/**
+ * Partner KYB documents resource (`tagada.partners.documents.*`).
+ *
+ * v1 ships only the metadata-only path. Document bytes live in S3 — you
+ * upload directly via a presigned URL we issue (`getUploadUrl()`), then
+ * call `record()` with the resulting `storageUrl` to attach metadata.
+ */
+export class PartnerDocuments extends BaseResource {
+    async list(tpaId, opts) {
+        return this.client.partnerGet(`/v1/accounts/${tpaId}/documents`, undefined, opts);
+    }
+    async record(params, opts) {
+        return this.client.partnerPost(`/v1/accounts/${params.tagadapayAccountId}/documents`, params, opts);
+    }
+}
+/**
+ * Aggregator class exposed as `tagada.partners`. Holds the per-resource
+ * sub-clients so you can write `tagada.partners.accounts.create(...)`.
+ */
+export class Partners {
+    constructor(client) {
+        this.accounts = new PartnerAccounts(client);
+        this.apiKeys = new PartnerApiKeys(client);
+        this.requirements = new PartnerRequirements(client);
+        this.documents = new PartnerDocuments(client);
+    }
+}
+//# sourceMappingURL=Partners.js.map

package/dist/resources/Partners.js.map

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

package/dist/resources/PaymentSetup.d.ts

@@ -0,0 +1,34 @@
+import { BaseResource } from './BaseResource.js';
+import type { RequestOptions } from '../types/common.js';
+import type { PaymentSetupConfig, PaymentSetupGetParams } from '../types/paymentSetup.js';
+/**
+ * Payment setup config resource (`tagada.paymentSetup.*`).
+ *
+ * Returns the runtime payment configuration for a store: which methods
+ * are enabled, which processors handle them, and the metadata each
+ * needs to render. The shape is `Record<"{method}" | "{method}:{provider}", PaymentMethodConfig>`.
+ *
+ * Used by partners to discover what each merchant has enabled before
+ * rendering the payment UI &mdash; without needing to create a checkout session.
+ *
+ * @example
+ * const setup = await tagada.paymentSetup.get('store_xxx');
+ * if (setup.apple_pay?.enabled && setup.apple_pay.provider === 'apple_pay') {
+ *   renderNativeApplePayButton();
+ * } else if (setup['apple_pay:stripe']?.enabled) {
+ *   renderStripeExpressButton();
+ * }
+ */
+export declare class PaymentSetup extends BaseResource {
+    /**
+     * Get the paymentSetupConfig for a store.
+     *
+     * Backed by `GET /v1/stores/:id/payment-setup` — currently in the
+     * W4.B1 backend workstream. Until that endpoint ships, this method
+     * returns a 404 with `code: 'route_not_implemented'`. See the
+     * [implementation plan](https://docs.tagadapay.com/internal/decisions/2026-04-29-partner-s2s-architecture)
+     * for status.
+     */
+    get(storeId: string, params?: PaymentSetupGetParams, opts?: RequestOptions): Promise<PaymentSetupConfig>;
+}
+//# sourceMappingURL=PaymentSetup.d.ts.map

package/dist/resources/PaymentSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentSetup.d.ts","sourceRoot":"","sources":["../../src/resources/PaymentSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C;;;;;;;;OAQG;IACG,GAAG,CACP,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,qBAAqB,EAC9B,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,kBAAkB,CAAC;CAO/B"}

package/dist/resources/PaymentSetup.js

@@ -0,0 +1,34 @@
+import { BaseResource } from './BaseResource.js';
+/**
+ * Payment setup config resource (`tagada.paymentSetup.*`).
+ *
+ * Returns the runtime payment configuration for a store: which methods
+ * are enabled, which processors handle them, and the metadata each
+ * needs to render. The shape is `Record<"{method}" | "{method}:{provider}", PaymentMethodConfig>`.
+ *
+ * Used by partners to discover what each merchant has enabled before
+ * rendering the payment UI &mdash; without needing to create a checkout session.
+ *
+ * @example
+ * const setup = await tagada.paymentSetup.get('store_xxx');
+ * if (setup.apple_pay?.enabled && setup.apple_pay.provider === 'apple_pay') {
+ *   renderNativeApplePayButton();
+ * } else if (setup['apple_pay:stripe']?.enabled) {
+ *   renderStripeExpressButton();
+ * }
+ */
+export class PaymentSetup extends BaseResource {
+    /**
+     * Get the paymentSetupConfig for a store.
+     *
+     * Backed by `GET /v1/stores/:id/payment-setup` — currently in the
+     * W4.B1 backend workstream. Until that endpoint ships, this method
+     * returns a 404 with `code: 'route_not_implemented'`. See the
+     * [implementation plan](https://docs.tagadapay.com/internal/decisions/2026-04-29-partner-s2s-architecture)
+     * for status.
+     */
+    async get(storeId, params, opts) {
+        return this._get(`/stores/${storeId}/payment-setup`, params, opts);
+    }
+}
+//# sourceMappingURL=PaymentSetup.js.map

package/dist/resources/PaymentSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentSetup.js","sourceRoot":"","sources":["../../src/resources/PaymentSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,YAAa,SAAQ,YAAY;IAC5C;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CACP,OAAe,EACf,MAA8B,EAC9B,IAAqB;QAErB,OAAO,IAAI,CAAC,IAAI,CACd,WAAW,OAAO,gBAAgB,EAClC,MAA6C,EAC7C,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}