@beacon-build/sdk 3.1.4 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @beacon-build/sdk Changelog
 
+## 3.2.0
+
+### Patch Changes
+
+- 2669916: F733 increment 3: connector instance CRUD/status/sync API + SDK clients + connector_status/connector_sync MCP tools
+- 0d3275f: F730 Increment 5 (AC-15): GET /organizations/{id}/billing/account and GET /users/me/billing/account expose { billingAccountId, holderType, recipientStatus, recipient } (never stripeCustomerId), wired through a new InvoiceRecipientService instance in BillingServices. OrgBillingStatusPanel.tsx and BillingStatusTab.tsx show a "Rechnungsangaben unvollständig" hint listing every missing item, linking to ?tab=master-data, once recipientStatus.complete is false. New SDK BillingClient.orgAccount/myAccount methods and DTOs. All 29 F730 ACs are now implemented; the M2 contract migration (dropping the old organizations/users billing\* columns) is deliberately deferred to the next release per the owner's rolling-deploy decision.
+- 07c7211: F572: Stripe foundation increment 6 — AC-15 permissions smoke check logic + the normative permission table, and the SDK payment-method client methods
+- 93a3714: F574 round 9 (Worker B, item 1): BillingClient gains accountInvoices/vendorInvoices/vendorInvoicesExport/vendorPayouts/createPaymentLink/downloadInvoicePdf for the AC-23/AC-24/AC-25/AC-26 round-7 routes, wired through a new optional BinaryClient transport for the CSV export and the archived PDF download (constructor backward-compatible).
+- 23d0d67: F574 round 9 follow-up: BillingClient.vendorInvoiceDetail(invoiceId) for the AC-25 vendor invoice detail view (GET /admin/invoices/{id}), plus a VendorInvoiceListFilter.q recipient-name filter on vendorInvoices/vendorInvoicesExport.
+- 3bc8e7c: Fix PR #1049 review findings (14 Copilot threads) and the F728 master-data merge-contributor blocker: connector-stripe is now loadable via CONNECTOR_TYPE_PACKAGES, the webhook ingress derives a per-type replay id/timestamp (Stripe-compatible) and bounds its rate limiter, a malformed webhook instance id no longer reaches the DB as a raw error, connector source runs are now atomic (DB-level single-in-flight guard), keep their prior contentHash on a failed item and never advance the cursor past a partial failure with secrets redacted from error messages, invoice archiving/delivery alerting is fully fail-safe, organization slug rename is idempotent, connector webhook deliveries are now pruned by the retention worker, and the master-data PersonMergeContributor is registered so claiming a Person with contact data no longer rolls back.
+- Updated dependencies [6dc50b2]
+- Updated dependencies [a12f615]
+- Updated dependencies [c2d2584]
+- Updated dependencies [ef6f4b2]
+- Updated dependencies [48dab4c]
+- Updated dependencies [87a2798]
+- Updated dependencies [4b37b86]
+- Updated dependencies [43719b0]
+- Updated dependencies [b15b53b]
+- Updated dependencies [fd575dd]
+- Updated dependencies [553477f]
+- Updated dependencies [b6cf744]
+- Updated dependencies [ef3276d]
+- Updated dependencies [c3d1605]
+- Updated dependencies [b5246d4]
+- Updated dependencies [d3f0699]
+- Updated dependencies [315d5e6]
+- Updated dependencies [acac63b]
+- Updated dependencies [fdf5e2f]
+- Updated dependencies [dc5e131]
+- Updated dependencies [aaf36dc]
+- Updated dependencies [0e00a93]
+- Updated dependencies [358a17f]
+- Updated dependencies [1c9825d]
+- Updated dependencies [bf7aaea]
+- Updated dependencies [ce630cb]
+- Updated dependencies [8cac6d3]
+- Updated dependencies [0dcf7bb]
+- Updated dependencies [0dd2bb6]
+- Updated dependencies [ea9a5ab]
+- Updated dependencies [a870f53]
+- Updated dependencies [c9219d3]
+- Updated dependencies [3bc8e7c]
+    - @beacon-build/core@3.2.0
+
 ## 3.1.4
 
 ### Patch Changes

package/dist/clients/agent/connectors.client.d.ts

@@ -0,0 +1,69 @@
+/**
+ * AgentConnectorsClient — F733/AC-16/AC-17/AC-24: the agent-facing SDK surface for the
+ * connector infrastructure's status/sync API (`services/api/src/routes/connectors*.ts`).
+ * Canonical under `/api/v1/connectors` — same basePath every other `Agent*Client` uses.
+ */
+import type { HttpClient } from '../../transport/http-client.js';
+export interface ConnectorInstanceSummary {
+    id: string;
+    typeId: string;
+    typeVersion: string;
+    orgId: string | null;
+    projectId: string | null;
+    name: string;
+    config: Record<string, unknown>;
+    allowedHosts: string[];
+    profile: string | null;
+    cadenceMinutes: number | null;
+    state: 'enabled' | 'disabled' | 'misconfigured' | 'archived';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ConnectorStatus {
+    instanceId: string;
+    state: string;
+    source: {
+        active: boolean;
+        lastRun: {
+            startedAt: string;
+            finishedAt: string | null;
+            result: string | null;
+        } | null;
+        lastSuccessfulRunAt: string | null;
+        stale: boolean;
+        counts: Record<string, number> | null;
+    } | null;
+    sink: {
+        active: boolean;
+        backlog: number;
+        oldestPendingAt: string | null;
+        dead: number;
+    } | null;
+    health: 'healthy' | 'stale' | 'degraded';
+}
+export interface ConnectorSyncOutcome {
+    source: {
+        started: boolean;
+    } | null;
+    sink: {
+        requeued: number;
+    } | null;
+}
+export declare class AgentConnectorsClient {
+    private http;
+    constructor(http: HttpClient);
+    listTypes(): Promise<{
+        id: string;
+        version: string;
+        roles: string[];
+        secretKeys: string[];
+    }[]>;
+    list(): Promise<ConnectorInstanceSummary[]>;
+    get(id: string): Promise<ConnectorInstanceSummary>;
+    /** AC-16: the tenant-guard-filtered status/drift read. */
+    status(id: string): Promise<ConnectorStatus>;
+    /** AC-17/AC-24: `connector_sync` — server-side gated (operator capability + tenant
+     *  guard), never a client-side capability check. */
+    sync(id: string, role?: 'source' | 'sink'): Promise<ConnectorSyncOutcome>;
+}
+//# sourceMappingURL=connectors.client.d.ts.map

package/dist/clients/agent/connectors.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.client.d.ts","sourceRoot":"","sources":["../../../src/clients/agent/connectors.client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,UAAU,CAAA;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE;QACJ,MAAM,EAAE,OAAO,CAAA;QACf,OAAO,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAA;QACvF,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;QAClC,KAAK,EAAE,OAAO,CAAA;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;KACxC,GAAG,IAAI,CAAA;IACR,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC/F,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IACnC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACpC;AAED,qBAAa,qBAAqB;IAClB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,SAAS,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAI9F,IAAI,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAI3C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIlD,0DAA0D;IAC1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI5C;wDACoD;IACpD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAG5E"}

package/dist/clients/agent/connectors.client.js

@@ -0,0 +1,25 @@
+export class AgentConnectorsClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    listTypes() {
+        return this.http.get('/connectors/types');
+    }
+    list() {
+        return this.http.get('/connectors');
+    }
+    get(id) {
+        return this.http.get(`/connectors/${encodeURIComponent(id)}`);
+    }
+    /** AC-16: the tenant-guard-filtered status/drift read. */
+    status(id) {
+        return this.http.get(`/connectors/${encodeURIComponent(id)}/status`);
+    }
+    /** AC-17/AC-24: `connector_sync` — server-side gated (operator capability + tenant
+     *  guard), never a client-side capability check. */
+    sync(id, role) {
+        return this.http.post(`/connectors/${encodeURIComponent(id)}/sync`, role ? { role } : {});
+    }
+}
+//# sourceMappingURL=connectors.client.js.map

package/dist/clients/agent/connectors.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.client.js","sourceRoot":"","sources":["../../../src/clients/agent/connectors.client.ts"],"names":[],"mappings":"AA0CA,MAAM,OAAO,qBAAqB;IACV;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,SAAS;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI;QACA,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACjE,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,kBAAkB,CAAC,EAAE,CAAC,SAAS,CAAC,CAAA;IACxE,CAAC;IAED;wDACoD;IACpD,IAAI,CAAC,EAAU,EAAE,IAAwB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC7F,CAAC;CACJ"}

package/dist/clients/billing-account.types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * F730 (billing account / recipient / vendor merge) and F572 (Stripe payment-method setup)
+ * wire types — split out of billing.client.ts (loc-guard), re-exported from there.
+ */
+/** F730/AC-13..AC-15 — resolved billing recipient (never contains `stripeCustomerId`, D11
+ * billing contact as `{personId, displayName}` only). */
+export interface InvoiceRecipientDto {
+    holderType: 'organization' | 'person';
+    holderId: string;
+    name: string;
+    legalName: string | null;
+    address: {
+        street: string;
+        houseNumber: string | null;
+        streetExtra: string | null;
+        postalCode: string;
+        city: string;
+        region: string | null;
+        countryCode: string;
+    };
+    countryCode: string;
+    vatId: string | null;
+    vatScheme: 'CH' | 'EU' | 'LI' | 'GB' | null;
+    vatCountry: string | null;
+    invoiceEmails: string[];
+    billingContact: {
+        personId: string;
+        displayName: string;
+    } | null;
+}
+/** F730/AC-15 — `GET .../billing/account` response. */
+export interface BillingAccountViewDto {
+    billingAccountId: string;
+    holderType: 'organization' | 'person';
+    recipientStatus: {
+        complete: boolean;
+        missing: Array<'billing_address' | 'legal_name' | 'invoice_email'>;
+    };
+    recipient: InvoiceRecipientDto | null;
+}
+/** F730/D15 — vendor company merge response (`POST /vendor/billing-accounts/merge`). */
+export interface BillingAccountMergeResultDto {
+    sourceOrgId: string;
+    targetOrgId: string;
+    closedBillingAccountId: string;
+    survivingBillingAccountId: string;
+    movedCounts: {
+        activationPeriods: number;
+        tierSnapshots: number;
+        tierSnapshotRuns: number;
+        requestMonths: number;
+    };
+    mergedAt: string;
+}
+/** F572 AC-11 — start the payment-method Checkout Session. */
+export interface PaymentMethodSetupInput {
+    successUrl: string;
+    cancelUrl: string;
+    locale?: 'de' | 'en';
+}
+export interface PaymentMethodSetupResultDto {
+    url: string;
+}
+/** F572 AC-13 — chargeability read. */
+export interface PaymentMethodStatusDto {
+    paymentMethodOnFile: boolean;
+}
+//# sourceMappingURL=billing-account.types.d.ts.map

package/dist/clients/billing-account.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-account.types.d.ts","sourceRoot":"","sources":["../../src/clients/billing-account.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;yDACyD;AACzD,MAAM,WAAW,mBAAmB;IAChC,UAAU,EAAE,cAAc,GAAG,QAAQ,CAAA;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;QACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAC3C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACnE;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,cAAc,GAAG,QAAQ,CAAA;IACrC,eAAe,EAAE;QACb,QAAQ,EAAE,OAAO,CAAA;QACjB,OAAO,EAAE,KAAK,CAAC,iBAAiB,GAAG,YAAY,GAAG,eAAe,CAAC,CAAA;KACrE,CAAA;IACD,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAAA;CACxC;AAED,wFAAwF;AACxF,MAAM,WAAW,4BAA4B;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,yBAAyB,EAAE,MAAM,CAAA;IACjC,WAAW,EAAE;QACT,iBAAiB,EAAE,MAAM,CAAA;QACzB,aAAa,EAAE,MAAM,CAAA;QACrB,gBAAgB,EAAE,MAAM,CAAA;QACxB,aAAa,EAAE,MAAM,CAAA;KACxB,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACvB;AACD,MAAM,WAAW,2BAA2B;IACxC,GAAG,EAAE,MAAM,CAAA;CACd;AACD,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACnC,mBAAmB,EAAE,OAAO,CAAA;CAC/B"}

package/dist/clients/billing-account.types.js

@@ -0,0 +1,6 @@
+/**
+ * F730 (billing account / recipient / vendor merge) and F572 (Stripe payment-method setup)
+ * wire types — split out of billing.client.ts (loc-guard), re-exported from there.
+ */
+export {};
+//# sourceMappingURL=billing-account.types.js.map

package/dist/clients/billing-account.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-account.types.js","sourceRoot":"","sources":["../../src/clients/billing-account.types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/clients/billing-errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * billing-errors.ts — typed SdkError subclasses for the billing lifecycle (F705) + the
+ * `typed()` wrapper that maps a raw SdkError onto one of these by `apiCode`. Extracted out of
+ * `billing.client.ts` (loc-guard) — that file only imports `typed`/`toTypedBillingError` now.
+ */
+import { SdkError } from '../transport/errors.js';
+import type { InactiveReasonValue } from './billing.client.js';
+/** 403/409 BILLING_ENTITY_INACTIVE — writes to a resource of an inactive entity. */
+export declare class BillingEntityInactiveError extends SdkError {
+    readonly entity: 'company' | 'personal';
+    readonly rootOrgId: string | null;
+    readonly inactiveReason: InactiveReasonValue | null;
+    constructor(e: SdkError);
+}
+export declare class PersonalSubscriptionRequiredError extends SdkError {
+}
+export declare class ProjectOwnerRequiredError extends SdkError {
+}
+export declare class PaymentOverdueError extends SdkError {
+}
+export declare class PaymentRequiredError extends SdkError {
+}
+/** Maps a raw SdkError to its typed billing subclass (unchanged when not a billing code). */
+export declare function toTypedBillingError(err: unknown): unknown;
+export declare function typed<T>(p: Promise<T>): Promise<T>;
+//# sourceMappingURL=billing-errors.d.ts.map

package/dist/clients/billing-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-errors.d.ts","sourceRoot":"","sources":["../../src/clients/billing-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,oFAAoF;AACpF,qBAAa,0BAA2B,SAAQ,QAAQ;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,mBAAmB,GAAG,IAAI,CAAA;gBACvC,CAAC,EAAE,QAAQ;CAO1B;AACD,qBAAa,iCAAkC,SAAQ,QAAQ;CAAG;AAClE,qBAAa,yBAA0B,SAAQ,QAAQ;CAAG;AAC1D,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,oBAAqB,SAAQ,QAAQ;CAAG;AAcrD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMxD"}

package/dist/clients/billing-errors.js

@@ -0,0 +1,49 @@
+/**
+ * billing-errors.ts — typed SdkError subclasses for the billing lifecycle (F705) + the
+ * `typed()` wrapper that maps a raw SdkError onto one of these by `apiCode`. Extracted out of
+ * `billing.client.ts` (loc-guard) — that file only imports `typed`/`toTypedBillingError` now.
+ */
+import { SdkError } from '../transport/errors.js';
+/** 403/409 BILLING_ENTITY_INACTIVE — writes to a resource of an inactive entity. */
+export class BillingEntityInactiveError extends SdkError {
+    entity;
+    rootOrgId;
+    inactiveReason;
+    constructor(e) {
+        super(e.code, e.message, e.status, e.apiCode, e.details);
+        this.name = 'BillingEntityInactiveError';
+        this.entity = e.details?.entity ?? 'company';
+        this.rootOrgId = e.details?.rootOrgId ?? null;
+        this.inactiveReason = e.details?.inactiveReason ?? null;
+    }
+}
+export class PersonalSubscriptionRequiredError extends SdkError {
+}
+export class ProjectOwnerRequiredError extends SdkError {
+}
+export class PaymentOverdueError extends SdkError {
+}
+export class PaymentRequiredError extends SdkError {
+}
+const TYPED = {
+    BILLING_ENTITY_INACTIVE: (e) => new BillingEntityInactiveError(e),
+    PERSONAL_SUBSCRIPTION_REQUIRED: (e) => new PersonalSubscriptionRequiredError(e.code, e.message, e.status, e.apiCode, e.details),
+    PROJECT_OWNER_REQUIRED: (e) => new ProjectOwnerRequiredError(e.code, e.message, e.status, e.apiCode, e.details),
+    PAYMENT_OVERDUE: (e) => new PaymentOverdueError(e.code, e.message, e.status, e.apiCode, e.details),
+    PAYMENT_REQUIRED: (e) => new PaymentRequiredError(e.code, e.message, e.status, e.apiCode, e.details),
+};
+/** Maps a raw SdkError to its typed billing subclass (unchanged when not a billing code). */
+export function toTypedBillingError(err) {
+    if (err instanceof SdkError && err.apiCode && TYPED[err.apiCode])
+        return TYPED[err.apiCode](err);
+    return err;
+}
+export async function typed(p) {
+    try {
+        return await p;
+    }
+    catch (err) {
+        throw toTypedBillingError(err);
+    }
+}
+//# sourceMappingURL=billing-errors.js.map

package/dist/clients/billing-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-errors.js","sourceRoot":"","sources":["../../src/clients/billing-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAGjD,oFAAoF;AACpF,MAAM,OAAO,0BAA2B,SAAQ,QAAQ;IAC3C,MAAM,CAAwB;IAC9B,SAAS,CAAe;IACxB,cAAc,CAA4B;IACnD,YAAY,CAAW;QACnB,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;QACxC,IAAI,CAAC,MAAM,GAAI,CAAC,CAAC,OAAO,EAAE,MAAiC,IAAI,SAAS,CAAA;QACxE,IAAI,CAAC,SAAS,GAAI,CAAC,CAAC,OAAO,EAAE,SAAgC,IAAI,IAAI,CAAA;QACrE,IAAI,CAAC,cAAc,GAAI,CAAC,CAAC,OAAO,EAAE,cAAkD,IAAI,IAAI,CAAA;IAChG,CAAC;CACJ;AACD,MAAM,OAAO,iCAAkC,SAAQ,QAAQ;CAAG;AAClE,MAAM,OAAO,yBAA0B,SAAQ,QAAQ;CAAG;AAC1D,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;CAAG;AAErD,MAAM,KAAK,GAA8C;IACrD,uBAAuB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,0BAA0B,CAAC,CAAC,CAAC;IACjE,8BAA8B,EAAE,CAAC,CAAC,EAAE,EAAE,CAClC,IAAI,iCAAiC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;IAC5F,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE,CAC1B,IAAI,yBAAyB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;IACpF,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CACnB,IAAI,mBAAmB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;IAC9E,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CACpB,IAAI,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;CAClF,CAAA;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC5C,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;QAC5D,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,GAAG,CAAA;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAI,CAAa;IACxC,IAAI,CAAC;QACD,OAAO,MAAM,CAAC,CAAA;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAA;IAClC,CAAC;AACL,CAAC"}

package/dist/clients/billing-invoice-list-query.d.ts

@@ -0,0 +1,10 @@
+/**
+ * F574/AC-25/AC-26 — query-string builders shared by `BillingClient.vendorInvoices`/
+ * `vendorInvoicesExport` (same filter shape, one JSON, one CSV via `BinaryClient`) and
+ * `vendorPayouts`. Kept out of `billing.client.ts` to keep that file's per-method bodies
+ * short (loc-guard).
+ */
+import type { VendorInvoiceListFilter, VendorPayoutListFilter } from './billing-invoice-list.types.js';
+export declare function vendorInvoiceQuery(filter?: VendorInvoiceListFilter): string;
+export declare function vendorPayoutQuery(filter?: VendorPayoutListFilter): string;
+//# sourceMappingURL=billing-invoice-list-query.d.ts.map

package/dist/clients/billing-invoice-list-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-invoice-list-query.d.ts","sourceRoot":"","sources":["../../src/clients/billing-invoice-list-query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACR,uBAAuB,EACvB,sBAAsB,EACzB,MAAM,iCAAiC,CAAA;AAExC,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,uBAA4B,GAAG,MAAM,CAQ/E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,sBAA2B,GAAG,MAAM,CAK7E"}

package/dist/clients/billing-invoice-list-query.js

@@ -0,0 +1,23 @@
+export function vendorInvoiceQuery(filter = {}) {
+    const params = new URLSearchParams();
+    if (filter.status && filter.status.length > 0)
+        params.set('status', filter.status.join(','));
+    if (filter.billingAccountId)
+        params.set('billingAccountId', filter.billingAccountId);
+    if (filter.issuedFrom)
+        params.set('issuedFrom', filter.issuedFrom);
+    if (filter.issuedTo)
+        params.set('issuedTo', filter.issuedTo);
+    if (filter.q)
+        params.set('q', filter.q);
+    return params.toString();
+}
+export function vendorPayoutQuery(filter = {}) {
+    const params = new URLSearchParams();
+    if (filter.arrivalFrom)
+        params.set('arrivalFrom', filter.arrivalFrom);
+    if (filter.arrivalTo)
+        params.set('arrivalTo', filter.arrivalTo);
+    return params.toString();
+}
+//# sourceMappingURL=billing-invoice-list-query.js.map

package/dist/clients/billing-invoice-list-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-invoice-list-query.js","sourceRoot":"","sources":["../../src/clients/billing-invoice-list-query.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,kBAAkB,CAAC,SAAkC,EAAE;IACnE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC5F,IAAI,MAAM,CAAC,gBAAgB;QAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;IACpF,IAAI,MAAM,CAAC,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAClE,IAAI,MAAM,CAAC,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5D,IAAI,MAAM,CAAC,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACvC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiC,EAAE;IACjE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,IAAI,MAAM,CAAC,WAAW;QAAE,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;IACrE,IAAI,MAAM,CAAC,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IAC/D,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;AAC5B,CAAC"}

package/dist/clients/billing-invoice-list.client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * F574/AC-23..AC-26 — invoice list, vendor overview + CSV export, payout view and payment-link
+ * method bodies, extracted out of `billing.client.ts` (loc-guard — that file was already near
+ * the 300-line threshold). `BillingClient`'s own methods are thin delegations into these plain
+ * functions, same split `tasks-attachments.client.ts` established for `AdminTasksClient`.
+ */
+import type { HttpClient } from '../transport/http-client.js';
+import type { BinaryClient, BinaryDownloadResult } from '../transport/binary-client.js';
+import type { InvoiceDetailDto, InvoiceListItemDto, PaymentLinkInput, PaymentLinkResultDto, PayoutListItemDto, VendorInvoiceListFilter, VendorPayoutListFilter } from './billing-invoice-list.types.js';
+/** GET /billing-accounts/{id}/invoices — one billing account's own invoice list (AC-23). */
+export declare function accountInvoices(http: HttpClient, billingAccountId: string): Promise<InvoiceListItemDto[]>;
+/** GET /admin/invoices — vendor cross-account overview, filterable (AC-25). */
+export declare function vendorInvoices(http: HttpClient, filter?: VendorInvoiceListFilter): Promise<InvoiceListItemDto[]>;
+/** GET /admin/invoices/export — same filter, CSV (AC-25). Needs the binary transport — throws
+ *  if not configured, same guard B302's `downloadAttachment` uses. */
+export declare function vendorInvoicesExport(binary: BinaryClient | undefined, filter?: VendorInvoiceListFilter): Promise<BinaryDownloadResult>;
+/** GET /admin/invoices/{id} — vendor invoice detail + payment-event timeline (AC-25). */
+export declare function vendorInvoiceDetail(http: HttpClient, invoiceId: string): Promise<InvoiceDetailDto>;
+/** GET /admin/payouts — vendor payout view with per-payout BT attribution (AC-26). */
+export declare function vendorPayouts(http: HttpClient, filter?: VendorPayoutListFilter): Promise<PayoutListItemDto[]>;
+/** POST /billing-accounts/{id}/payment-link — pay an invoice or set up a payment method, one
+ *  unified endpoint (AC-24). */
+export declare function createPaymentLink(http: HttpClient, billingAccountId: string, input: PaymentLinkInput): Promise<PaymentLinkResultDto>;
+/** GET /invoices/{id}/pdf — the archived invoice/credit-note PDF (AC-23/AC-31). Serves ONLY the
+ *  F574 archive (F710/DOM-29), never a live re-render (Worker A's download-route contract). */
+export declare function downloadInvoicePdf(binary: BinaryClient | undefined, invoiceId: string): Promise<BinaryDownloadResult>;
+//# sourceMappingURL=billing-invoice-list.client.d.ts.map

package/dist/clients/billing-invoice-list.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-invoice-list.client.d.ts","sourceRoot":"","sources":["../../src/clients/billing-invoice-list.client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACvF,OAAO,KAAK,EACR,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACzB,MAAM,iCAAiC,CAAA;AAGxC,4FAA4F;AAC5F,wBAAgB,eAAe,CAC3B,IAAI,EAAE,UAAU,EAChB,gBAAgB,EAAE,MAAM,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAI/B;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC1B,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,uBAAuB,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAG/B;AAED;sEACsE;AACtE,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,MAAM,CAAC,EAAE,uBAAuB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CACzB,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,sBAAsB,GAChC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAG9B;AAED;gCACgC;AAChC,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,UAAU,EAChB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAK/B;AAED;+FAC+F;AAC/F,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAG/B"}

package/dist/clients/billing-invoice-list.client.js

@@ -0,0 +1,40 @@
+import { vendorInvoiceQuery, vendorPayoutQuery } from './billing-invoice-list-query.js';
+/** GET /billing-accounts/{id}/invoices — one billing account's own invoice list (AC-23). */
+export function accountInvoices(http, billingAccountId) {
+    return http.get(`/billing-accounts/${encodeURIComponent(billingAccountId)}/invoices`);
+}
+/** GET /admin/invoices — vendor cross-account overview, filterable (AC-25). */
+export function vendorInvoices(http, filter) {
+    const qs = vendorInvoiceQuery(filter);
+    return http.get(`/admin/invoices${qs ? `?${qs}` : ''}`);
+}
+/** GET /admin/invoices/export — same filter, CSV (AC-25). Needs the binary transport — throws
+ *  if not configured, same guard B302's `downloadAttachment` uses. */
+export function vendorInvoicesExport(binary, filter) {
+    if (!binary)
+        throw new Error('BillingClient: binary transport not configured');
+    const qs = vendorInvoiceQuery(filter);
+    return binary.download(`/admin/invoices/export${qs ? `?${qs}` : ''}`);
+}
+/** GET /admin/invoices/{id} — vendor invoice detail + payment-event timeline (AC-25). */
+export function vendorInvoiceDetail(http, invoiceId) {
+    return http.get(`/admin/invoices/${encodeURIComponent(invoiceId)}`);
+}
+/** GET /admin/payouts — vendor payout view with per-payout BT attribution (AC-26). */
+export function vendorPayouts(http, filter) {
+    const qs = vendorPayoutQuery(filter);
+    return http.get(`/admin/payouts${qs ? `?${qs}` : ''}`);
+}
+/** POST /billing-accounts/{id}/payment-link — pay an invoice or set up a payment method, one
+ *  unified endpoint (AC-24). */
+export function createPaymentLink(http, billingAccountId, input) {
+    return http.post(`/billing-accounts/${encodeURIComponent(billingAccountId)}/payment-link`, input);
+}
+/** GET /invoices/{id}/pdf — the archived invoice/credit-note PDF (AC-23/AC-31). Serves ONLY the
+ *  F574 archive (F710/DOM-29), never a live re-render (Worker A's download-route contract). */
+export function downloadInvoicePdf(binary, invoiceId) {
+    if (!binary)
+        throw new Error('BillingClient: binary transport not configured');
+    return binary.download(`/invoices/${encodeURIComponent(invoiceId)}/pdf`);
+}
+//# sourceMappingURL=billing-invoice-list.client.js.map

package/dist/clients/billing-invoice-list.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-invoice-list.client.js","sourceRoot":"","sources":["../../src/clients/billing-invoice-list.client.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAEvF,4FAA4F;AAC5F,MAAM,UAAU,eAAe,CAC3B,IAAgB,EAChB,gBAAwB;IAExB,OAAO,IAAI,CAAC,GAAG,CACX,qBAAqB,kBAAkB,CAAC,gBAAgB,CAAC,WAAW,CACvE,CAAA;AACL,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAC1B,IAAgB,EAChB,MAAgC;IAEhC,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACrC,OAAO,IAAI,CAAC,GAAG,CAAuB,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACjF,CAAC;AAED;sEACsE;AACtE,MAAM,UAAU,oBAAoB,CAChC,MAAgC,EAChC,MAAgC;IAEhC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IAC9E,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACzE,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CAC/B,IAAgB,EAChB,SAAiB;IAEjB,OAAO,IAAI,CAAC,GAAG,CAAmB,mBAAmB,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;AACzF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CACzB,IAAgB,EAChB,MAA+B;IAE/B,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IACpC,OAAO,IAAI,CAAC,GAAG,CAAsB,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC/E,CAAC;AAED;gCACgC;AAChC,MAAM,UAAU,iBAAiB,CAC7B,IAAgB,EAChB,gBAAwB,EACxB,KAAuB;IAEvB,OAAO,IAAI,CAAC,IAAI,CACZ,qBAAqB,kBAAkB,CAAC,gBAAgB,CAAC,eAAe,EACxE,KAAK,CACR,CAAA;AACL,CAAC;AAED;+FAC+F;AAC/F,MAAM,UAAU,kBAAkB,CAC9B,MAAgC,EAChC,SAAiB;IAEjB,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IAC9E,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;AAC5E,CAAC"}

package/dist/clients/billing-invoice-list.types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * F574/AC-23/AC-24/AC-25/AC-26 — wire DTOs for the customer invoice list, the vendor
+ * cross-account invoice overview + CSV export, the vendor payout view, and the unified
+ * payment-link endpoint. Shapes mirror `services/api/src/routes/billing-account-invoices.ts`,
+ * `routes/admin/billing-invoices-admin.ts`, `routes/admin/billing-payouts-admin.ts` and
+ * `routes/billing-payment-link.ts` exactly (see each route's own zod schema).
+ */
+export type InvoicePaymentStatusValue = 'open' | 'paid' | 'overdue' | 'refunded' | 'disputed' | 'credited';
+/** One row of `GET /billing-accounts/{id}/invoices` (AC-23) or `GET /admin/invoices` (AC-25) —
+ *  same shape (`toInvoiceListDto`), so the customer list and the vendor overview share ONE DTO. */
+export interface InvoiceListItemDto {
+    id: string;
+    number: string;
+    billingAccountId: string;
+    billingAccountHolderType: 'organization' | 'person';
+    recipientName: string;
+    issuedAt: string;
+    billingDate: string;
+    status: InvoicePaymentStatusValue;
+    paidAt: string | null;
+    amountRefundedChf: string;
+    creditedAmountChf: string;
+    totalNetChf: string;
+    totalVatChf: string;
+    totalGrossChf: string;
+    stripeInvoiceId: string | null;
+    hasPendingCreditNote: boolean;
+}
+/** Filter for `GET /admin/invoices` / `GET /admin/invoices/export` (AC-25). */
+export interface VendorInvoiceListFilter {
+    status?: InvoicePaymentStatusValue[];
+    billingAccountId?: string;
+    issuedFrom?: string;
+    issuedTo?: string;
+    /** AC-25 — the "billing-account-name" filter: a free-text search over the invoice row's
+     *  own recipient-name snapshot. */
+    q?: string;
+}
+/** One row of the detail view's payment-event timeline (`GET /admin/invoices/{id}`, AC-25). */
+export interface PaymentEventDto {
+    id: string;
+    kind: string;
+    occurredAt: string;
+    amountChf: string | null;
+    stripeEventId: string;
+}
+/** `GET /admin/invoices/{id}` (AC-25) — the list-row shape plus the payment-event timeline. */
+export interface InvoiceDetailDto extends InvoiceListItemDto {
+    events: PaymentEventDto[];
+}
+export type PayoutBtTypeValue = 'charge' | 'refund' | 'payment' | 'adjustment' | 'stripe_fee';
+export type PayoutStatusValue = 'paid' | 'failed' | 'in_transit' | 'pending' | 'canceled';
+export type PayoutReconciliationStatusValue = 'balanced' | 'mismatch';
+export interface PayoutBalanceTransactionDto {
+    stripeBalanceTransactionId: string;
+    type: PayoutBtTypeValue;
+    grossAmountChf: string;
+    feeAmountChf: string;
+    netAmountChf: string;
+    invoiceId: string | null;
+    invoiceNumber: string | null;
+}
+/** One row of `GET /admin/payouts` (AC-26). */
+export interface PayoutListItemDto {
+    stripePayoutId: string;
+    arrivalDate: string;
+    status: PayoutStatusValue;
+    reconciliationStatus: PayoutReconciliationStatusValue | null;
+    grossChf: string;
+    feeChf: string;
+    refundedChf: string;
+    netChf: string;
+    amountChf: string;
+    items: PayoutBalanceTransactionDto[];
+}
+/** Filter for `GET /admin/payouts` (AC-26). */
+export interface VendorPayoutListFilter {
+    arrivalFrom?: string;
+    arrivalTo?: string;
+}
+/** Body of `POST /billing-accounts/{id}/payment-link` (AC-24). */
+export interface PaymentLinkInput {
+    purpose: 'pay_invoice' | 'setup_payment_method';
+    invoiceId?: string;
+    locale: 'de' | 'en';
+    successUrl: string;
+    cancelUrl: string;
+    returnUrl: string;
+}
+export interface PaymentLinkResultDto {
+    url: string;
+    expiresAt?: string;
+}
+//# sourceMappingURL=billing-invoice-list.types.d.ts.map

package/dist/clients/billing-invoice-list.types.d.ts.map

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

package/dist/clients/billing-invoice-list.types.js

@@ -0,0 +1,9 @@
+/**
+ * F574/AC-23/AC-24/AC-25/AC-26 — wire DTOs for the customer invoice list, the vendor
+ * cross-account invoice overview + CSV export, the vendor payout view, and the unified
+ * payment-link endpoint. Shapes mirror `services/api/src/routes/billing-account-invoices.ts`,
+ * `routes/admin/billing-invoices-admin.ts`, `routes/admin/billing-payouts-admin.ts` and
+ * `routes/billing-payment-link.ts` exactly (see each route's own zod schema).
+ */
+export {};
+//# sourceMappingURL=billing-invoice-list.types.js.map

package/dist/clients/billing-invoice-list.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-invoice-list.types.js","sourceRoot":"","sources":["../../src/clients/billing-invoice-list.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/clients/billing-invoice.types.d.ts

@@ -0,0 +1,64 @@
+/** F573/AC-22 — `GET /billing/invoices/{id}` response shape. */
+export interface InvoiceDocumentRecipientDto {
+    holderType: 'organization' | 'person';
+    holderId: string;
+    name: string;
+    legalName: string | null;
+    address: {
+        street: string;
+        houseNumber: string | null;
+        streetExtra: string | null;
+        postalCode: string;
+        city: string;
+        region: string | null;
+        countryCode: string;
+    };
+    countryCode: string;
+    vatId: string | null;
+    vatScheme: 'CH' | 'EU' | 'LI' | 'GB' | null;
+    vatCountry: string | null;
+    invoiceEmails: string[];
+    billingContact: {
+        personId: string;
+        displayName: string;
+    } | null;
+}
+export interface InvoiceDocumentLineDto {
+    lineNo: number;
+    positionKind: 'advance_floor' | 'true_up' | 'credit_brought_forward' | 'credit_carried_forward';
+    tier: 'community' | 'solo' | 'org_contributor' | 'org_reviewer' | 'viewer' | null;
+    isCompanyMinimum: boolean;
+    seatCount: number | null;
+    description: string;
+    priceBasis: 'net' | 'gross' | null;
+    netAmountChf: string;
+    vatCode: string;
+    vatRate: string;
+    vatAmountChf: string;
+    grossAmountChf: string;
+}
+export interface InvoiceDocumentDto {
+    id: string;
+    kind: 'invoice' | 'credit_note';
+    number: string;
+    billingAccountId: string;
+    billingKind: 'first' | 'reactivation' | 'monthly' | null;
+    billingDate: string;
+    issuedAt: string;
+    creditedInvoiceId: string | null;
+    creditReason: string | null;
+    creditOrigin: 'vendor' | 'stripe_refund' | 'stripe_dispute' | null;
+    recipient: InvoiceDocumentRecipientDto;
+    vatCode: string;
+    vatNote: string | null;
+    lines: InvoiceDocumentLineDto[];
+    totalNetChf: string;
+    totalVatChf: string;
+    totalGrossChf: string;
+    creditAppliedChf: string;
+    creditCarriedChf: string;
+    amountDueChf: string;
+    stripeInvoiceId: string | null;
+    stripeSyncStatus: string | null;
+}
+//# sourceMappingURL=billing-invoice.types.d.ts.map