@timbro/invoices 0.7.0-next.30

package/dist/source-connection-activation.js

@@ -0,0 +1,41 @@
+// biome-ignore-all lint/correctness/noNodejsModules: This published SDK subpath is explicitly Node-only.
+import { createHmac } from "node:crypto";
+import { zCompleteActivationVerificationRequest, zWebhookEventEnvelope, } from "./generated/index.js";
+const ACTIVATION_VERIFICATION_TRANSCRIPT_SCHEMA = "timbro.source-connection.activation-verification.v1";
+const ACTIVATION_VERIFICATION_EVENT_TYPE = "source_connection.verification_requested";
+const WEBHOOK_SIGNING_SECRET_PATTERN = /^whsec_[A-Za-z0-9+/]{43}=$/u;
+/**
+ * Builds the proof a deployed Source target returns for Timbro's signed activation challenge.
+ * Callers must verify the Webhook signature before passing its parsed event here.
+ */
+export function buildSourceConnectionActivationVerification(input) {
+    const event = zWebhookEventEnvelope.parse(input.verificationRequestEvent);
+    if (event.type !== ACTIVATION_VERIFICATION_EVENT_TYPE) {
+        throw new TypeError("verificationRequestEvent.type is invalid");
+    }
+    const webhookSecret = requireWebhookSecret(input.webhookSecret);
+    const transcript = JSON.stringify({
+        schema: ACTIVATION_VERIFICATION_TRANSCRIPT_SCHEMA,
+        source_connection_id: event.data.source_connection_id,
+        activation_attempt_id: event.data.activation_attempt_id,
+        challenge: event.data.challenge,
+        expected_provider_target_id: event.data.provider_target_id,
+        expected_provider_deployment_id: event.data.provider_deployment_id,
+        runtime_provider_target_id: input.runtimeProviderTargetId,
+        runtime_provider_deployment_id: input.runtimeProviderDeploymentId,
+    });
+    const proof = createHmac("sha256", webhookSecret).update(transcript, "utf8").digest("base64url");
+    return zCompleteActivationVerificationRequest.parse({
+        activation_attempt_id: event.data.activation_attempt_id,
+        challenge: event.data.challenge,
+        proof,
+        runtime_provider_deployment_id: input.runtimeProviderDeploymentId,
+        runtime_provider_target_id: input.runtimeProviderTargetId,
+    });
+}
+function requireWebhookSecret(candidate) {
+    if (typeof candidate !== "string" || !WEBHOOK_SIGNING_SECRET_PATTERN.test(candidate)) {
+        throw new TypeError("webhookSecret is invalid");
+    }
+    return candidate;
+}

package/dist/source-connection-transport.d.ts

@@ -0,0 +1,8 @@
+import type { TimbroTransport } from "./transport-contract.ts";
+export type SourceConnectionTransportOptions = {
+    readonly stampServerOrigin: string;
+    readonly credential: string;
+    readonly fetch?: typeof globalThis.fetch;
+};
+export declare function createSourceConnectionTransport(options: SourceConnectionTransportOptions): TimbroTransport;
+//# sourceMappingURL=source-connection-transport.d.ts.map

package/dist/source-connection-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-connection-transport.d.ts","sourceRoot":"","sources":["../src/source-connection-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C,CAAC;AAEF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,eAAe,CAMjB"}

package/dist/source-connection-transport.js

@@ -0,0 +1,8 @@
+import { createStampServerHttpTransport } from "./stamp-server-http-transport.js";
+export function createSourceConnectionTransport(options) {
+    return createStampServerHttpTransport({
+        stampServerOrigin: options.stampServerOrigin,
+        authentication: { mode: "source_connection", credential: options.credential },
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+    });
+}

package/dist/source-connection.d.ts

@@ -0,0 +1,18 @@
+import type { HostedFiscalTenant } from "./fiscal-operation.ts";
+import { type CompleteActivationVerificationRequest, type HostedSourceCredentialResponse } from "./generated/index.ts";
+import type { Client } from "./generated-operation-client.ts";
+import { type ReadonlyCamelCase } from "./public-case.ts";
+export type SourceConnectionActivationVerificationCommand = {
+    readonly sourceConnectionId: string;
+    readonly verification: CompleteActivationVerificationRequest;
+    readonly signal?: AbortSignal;
+};
+export declare function completeSourceConnectionActivationVerificationResource(client: Client, command: SourceConnectionActivationVerificationCommand): Promise<void>;
+export type HostedSandboxSourceCredentialIssueCommand = {
+    readonly hosted: Pick<HostedFiscalTenant, "checkoutTenantId">;
+    readonly environment?: HostedFiscalTenant["environment"];
+    readonly signal?: AbortSignal;
+};
+export type HostedSandboxSourceCredential = ReadonlyCamelCase<HostedSourceCredentialResponse>;
+export declare function issueHostedSandboxSourceCredentialResource(client: Client, command: HostedSandboxSourceCredentialIssueCommand): Promise<HostedSandboxSourceCredential>;
+//# sourceMappingURL=source-connection.d.ts.map

package/dist/source-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-connection.d.ts","sourceRoot":"","sources":["../src/source-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EACL,KAAK,qCAAqC,EAE1C,KAAK,8BAA8B,EAEpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAgB,MAAM,kBAAkB,CAAC;AAExE,MAAM,MAAM,6CAA6C,GAAG;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,qCAAqC,CAAC;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,wBAAsB,sDAAsD,CAC1E,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6CAA6C,GACrD,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,MAAM,MAAM,yCAAyC,GAAG;IACtD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;AAE9F,wBAAsB,0CAA0C,CAC9D,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,yCAAyC,GACjD,OAAO,CAAC,6BAA6B,CAAC,CAiBxC"}

package/dist/source-connection.js

@@ -0,0 +1,35 @@
+import { completeSourceConnectionActivationVerification, issueHostedSandboxSourceCredential, } from "./generated/index.js";
+import { throwGeneratedProblem } from "./generated-problem.js";
+import { toPublicCase } from "./public-case.js";
+export async function completeSourceConnectionActivationVerificationResource(client, command) {
+    if (command.sourceConnectionId.trim() === "") {
+        throw new TypeError("sourceConnectionId must not be blank");
+    }
+    const response = await completeSourceConnectionActivationVerification({
+        client,
+        body: command.verification,
+        path: { source_connection_id: command.sourceConnectionId },
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (response.status !== 204) {
+        throwGeneratedProblem(response, "Source connection activation verification failed");
+    }
+}
+export async function issueHostedSandboxSourceCredentialResource(client, command) {
+    if (command.hosted.checkoutTenantId.trim() === "") {
+        throw new TypeError("hosted.checkoutTenantId must not be blank");
+    }
+    const environment = command.environment ?? "sandbox";
+    if (environment !== "sandbox") {
+        throw new TypeError("environment must be sandbox");
+    }
+    const response = await issueHostedSandboxSourceCredential({
+        client,
+        body: { checkout_tenant_id: command.hosted.checkoutTenantId, environment },
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (response.status !== 201) {
+        throwGeneratedProblem(response, "Sandbox Source credential issuance failed");
+    }
+    return toPublicCase(response.body);
+}

package/dist/stamp-server-http-transport.d.ts

@@ -0,0 +1,23 @@
+import type { TimbroTransport } from "./transport-contract.ts";
+/** Answers one outbound request's bearer token, so a short-lived token is never held across calls. */
+export type StampServerBearerTokenProvider = () => string | Promise<string>;
+export type StampServerHttpAuthentication = {
+    readonly mode: "none";
+} | {
+    readonly mode: "source_connection";
+    readonly credential: string;
+} | {
+    readonly mode: "bearer";
+    readonly token: StampServerBearerTokenProvider;
+} | {
+    readonly mode: "workspace_session";
+};
+export type StampServerHttpTransportOptions = {
+    readonly stampServerOrigin: string;
+    readonly authentication: StampServerHttpAuthentication;
+    readonly fetch?: typeof globalThis.fetch;
+    /** Maximum bytes retained from a non-JSON response, when set by a caller. */
+    readonly maxBinaryResponseBytes?: number;
+};
+export declare function createStampServerHttpTransport(options: StampServerHttpTransportOptions): TimbroTransport;
+//# sourceMappingURL=stamp-server-http-transport.d.ts.map

package/dist/stamp-server-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-server-http-transport.d.ts","sourceRoot":"","sources":["../src/stamp-server-http-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yBAAyB,CAAC;AAEjC,sGAAsG;AACtG,MAAM,MAAM,8BAA8B,GAAG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,MAAM,6BAA6B,GACrC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,6BAA6B,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,6EAA6E;IAC7E,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C,CAAC;AAMF,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,eAAe,CAoCjB"}

package/dist/stamp-server-http-transport.js

@@ -0,0 +1,179 @@
+import { FiscalError } from "./fiscal-error.js";
+const CONTENT_TYPE_HEADER = "content-type";
+const JSON_MEDIA_TYPE = "application/json";
+const DECIMAL_INTEGER_PATTERN = /^\d+$/;
+export function createStampServerHttpTransport(options) {
+    const stampServerOrigin = parseStampServerOrigin(options.stampServerOrigin);
+    const sendHttpRequest = options.fetch ?? globalThis.fetch.bind(globalThis);
+    return {
+        async send(request) {
+            const url = `${stampServerOrigin}${request.path}`;
+            const headers = {
+                ...(request.body === undefined ? {} : { [CONTENT_TYPE_HEADER]: JSON_MEDIA_TYPE }),
+                ...callerHeaders(request.headers),
+            };
+            const authenticatedHeaders = await buildAuthenticatedHeaders(headers, options.authentication);
+            try {
+                const response = await sendHttpRequest(url, {
+                    method: request.method,
+                    headers: authenticatedHeaders,
+                    credentials: options.authentication.mode === "workspace_session" ? "include" : "omit",
+                    ...(request.body === undefined ? {} : { body: request.body }),
+                    ...(request.signal === undefined ? {} : { signal: request.signal }),
+                });
+                return {
+                    status: response.status,
+                    headers: new Map(response.headers),
+                    body: await decodeResponseBody(response, options.maxBinaryResponseBytes),
+                };
+            }
+            catch (cause) {
+                if (cause instanceof ResponseBodyTooLarge) {
+                    // biome-ignore lint/style/useErrorCause: FiscalError already exposes the bounded transport failure detail.
+                    throw new FiscalError(cause.message, { failure: "server_processing" }, { cause });
+                }
+                throw describeTransportFailure(cause, request.signal, url);
+            }
+        },
+    };
+}
+async function buildAuthenticatedHeaders(headers, authentication) {
+    if (authentication.mode === "source_connection") {
+        return { ...headers, authorization: `Bearer ${authentication.credential}` };
+    }
+    if (authentication.mode === "bearer") {
+        return { ...headers, authorization: `Bearer ${await mintBearerToken(authentication.token)}` };
+    }
+    return headers;
+}
+async function mintBearerToken(token) {
+    const minted = await token();
+    if (typeof minted !== "string" || minted.trim() === "") {
+        throw new TypeError("the bearer token provider answered no token");
+    }
+    return minted;
+}
+function parseStampServerOrigin(stampServerOrigin) {
+    let parsedOrigin;
+    try {
+        parsedOrigin = new URL(stampServerOrigin);
+    }
+    catch (cause) {
+        throw new Error("stampServerOrigin must be an absolute HTTP(S) origin", { cause });
+    }
+    if ((parsedOrigin.protocol !== "http:" && parsedOrigin.protocol !== "https:") ||
+        parsedOrigin.username !== "" ||
+        parsedOrigin.password !== "" ||
+        parsedOrigin.search !== "" ||
+        parsedOrigin.hash !== "" ||
+        parsedOrigin.pathname !== "/") {
+        throw new Error("stampServerOrigin must use HTTP(S), have no credentials/query/fragment, and have pathname /");
+    }
+    if (stampServerOrigin !== parsedOrigin.origin &&
+        stampServerOrigin !== `${parsedOrigin.origin}/`) {
+        throw new Error("stampServerOrigin must be the canonical HTTP(S) origin");
+    }
+    return parsedOrigin.origin;
+}
+/** One lowercase name per header, so no header reaches the wire twice under two spellings. */
+function callerHeaders(headers) {
+    return Object.fromEntries(Object.entries(headers)
+        .map(([name, value]) => [name.toLowerCase(), value])
+        .filter(([name]) => name !== "authorization"));
+}
+function describeTransportFailure(cause, signal, url) {
+    if (signal?.aborted === true && signal.reason?.name === "TimeoutError") {
+        return new FiscalError(`the request to ${url} timed out`, { failure: "timeout" }, { cause });
+    }
+    if (signal?.aborted === true) {
+        return new FiscalError(`the request to ${url} was cancelled`, { failure: "cancelled" }, { cause });
+    }
+    return new FiscalError(`the request to ${url} could not reach Timbro`, { failure: "connectivity" }, { cause });
+}
+async function decodeResponseBody(response, maxBinaryResponseBytes) {
+    if (response.status === 204 || response.status === 205) {
+        return;
+    }
+    const contentType = response.headers.get("content-type")?.toLowerCase();
+    if (contentType?.includes("json") !== true) {
+        return readBinaryResponse(response, maxBinaryResponseBytes);
+    }
+    if (maxBinaryResponseBytes !== undefined) {
+        const bytes = await readBinaryResponse(response, maxBinaryResponseBytes);
+        return decodeJsonBody(new TextDecoder().decode(bytes));
+    }
+    return decodeJsonBody(await response.text());
+}
+async function readBinaryResponse(response, maxBinaryResponseBytes) {
+    if (maxBinaryResponseBytes === undefined) {
+        return new Uint8Array(await response.arrayBuffer());
+    }
+    validateBinaryResponseLimit(maxBinaryResponseBytes);
+    await rejectDeclaredResponseLength(response, maxBinaryResponseBytes);
+    if (response.body === null) {
+        return readArrayBufferWithinLimit(response, maxBinaryResponseBytes);
+    }
+    return readStreamWithinLimit(response.body, maxBinaryResponseBytes);
+}
+function validateBinaryResponseLimit(maxBinaryResponseBytes) {
+    if (!Number.isSafeInteger(maxBinaryResponseBytes) || maxBinaryResponseBytes < 1) {
+        throw new TypeError("maxBinaryResponseBytes must be a positive safe integer");
+    }
+}
+async function rejectDeclaredResponseLength(response, maxBinaryResponseBytes) {
+    const declaredLength = response.headers.get("content-length");
+    if (declaredLength === null || !DECIMAL_INTEGER_PATTERN.test(declaredLength)) {
+        return;
+    }
+    if (BigInt(declaredLength) > BigInt(maxBinaryResponseBytes)) {
+        await response.body?.cancel().catch(() => undefined);
+        throw new ResponseBodyTooLarge(`the binary response exceeds the configured ${maxBinaryResponseBytes}-byte limit`);
+    }
+}
+async function readArrayBufferWithinLimit(response, maxBinaryResponseBytes) {
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    if (bytes.byteLength > maxBinaryResponseBytes) {
+        throw new ResponseBodyTooLarge(`the binary response exceeds the configured ${maxBinaryResponseBytes}-byte limit`);
+    }
+    return bytes;
+}
+async function readStreamWithinLimit(stream, maxBinaryResponseBytes) {
+    const reader = stream.getReader();
+    const chunks = [];
+    let byteLength = 0;
+    try {
+        for (;;) {
+            const result = await reader.read();
+            if (result.done) {
+                break;
+            }
+            const chunk = result.value;
+            if (byteLength > maxBinaryResponseBytes - chunk.byteLength) {
+                await reader.cancel();
+                throw new ResponseBodyTooLarge(`the binary response exceeds the configured ${maxBinaryResponseBytes}-byte limit`);
+            }
+            chunks.push(chunk);
+            byteLength += chunk.byteLength;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(byteLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes;
+}
+class ResponseBodyTooLarge extends Error {
+}
+function decodeJsonBody(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}

package/dist/timbro-client.d.ts

@@ -0,0 +1,124 @@
+import { type CertificateCustodyImportCommand, type CertificateCustodyImportResult } from "./certificate-custody-import.ts";
+import { type CertificateCustodyReadiness } from "./certificate-custody-readiness.ts";
+import { type FiscalDeliveryCreateCommand } from "./fiscal-delivery.ts";
+import { type FiscalNumberingReadiness } from "./fiscal-numbering-readiness.ts";
+import type { FiscalOperationResource } from "./fiscal-operation.ts";
+import { type FiscalDocumentIssueCommand, type FiscalDocumentListCommand, type FiscalDocumentPage, type HostedFiscalTenant } from "./fiscal-operation.ts";
+import { type FiscalOperationTimingReport } from "./fiscal-operation-timing.ts";
+import { type FiscalReceiptCommand, type FiscalReceiptReference, type FiscalReceiptResource } from "./fiscal-receipt.ts";
+import type { FiscalDeliveryResource, WebhookDelivery, WebhookDeliveryPage } from "./generated/index.ts";
+import { type PrintedRepresentationDownload } from "./printed-representation.ts";
+import { type CommercialResponse, type ReceivedDocumentListCommand, type ReceivedDocumentPage, type ReceivedDocumentResource, type ReceivedDocumentSignedDocumentDownload } from "./received-documents.ts";
+import { type SignedDocumentDownload } from "./signed-document.ts";
+import { type HostedSandboxSourceCredential, type HostedSandboxSourceCredentialIssueCommand, type SourceConnectionActivationVerificationCommand } from "./source-connection.ts";
+import { type StampServerBearerTokenProvider } from "./stamp-server-http-transport.ts";
+import { type WebhookDeliveryListCommand } from "./webhook-delivery.ts";
+import type { DeliveredWebhookEvent } from "./webhook-event.ts";
+import { type WebhookRegistration, type WebhookRegistrationCommand } from "./webhook-registration.ts";
+import { type WebhookReplay, type WebhookReplayCommand } from "./webhook-replay.ts";
+import { type WebhookVerificationCommand } from "./webhook-verification.ts";
+export type TimbroClientOptions = {
+    readonly baseUrl: string;
+    readonly authentication: TimbroClientAuthentication;
+    readonly fetch?: typeof globalThis.fetch;
+};
+/** Authentication accepted by the high-level fiscal client.
+ *
+ * The lower-level HTTP transport also serves Workspace and unauthenticated helper clients.
+ */
+export type TimbroClientAuthentication = {
+    readonly mode: "source_connection";
+    readonly credential: string;
+} | {
+    readonly mode: "bearer";
+    readonly token: StampServerBearerTokenProvider;
+};
+export type TimbroClient = {
+    readonly fiscalDocuments: {
+        readonly shareReceipt: (command: {
+            readonly fiscalOperationId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<FiscalReceiptReference>;
+        readonly issue: (command: FiscalDocumentIssueCommand) => Promise<FiscalOperationResource>;
+        readonly get: (command: {
+            readonly fiscalOperationId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<FiscalOperationResource | undefined>;
+        readonly list: (command?: FiscalDocumentListCommand) => Promise<FiscalDocumentPage>;
+        readonly findBySource: (command: {
+            readonly source: {
+                readonly id: string;
+                readonly version: string;
+            };
+            readonly hosted?: HostedFiscalTenant;
+            readonly signal?: AbortSignal;
+        }) => Promise<FiscalOperationResource | undefined>;
+        readonly getTiming: (command: {
+            readonly fiscalOperationId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<FiscalOperationTimingReport | undefined>;
+    };
+    readonly fiscalNumbering: {
+        readonly getReadiness: (command?: {
+            readonly signal?: AbortSignal;
+        }) => Promise<FiscalNumberingReadiness>;
+    };
+    readonly certificateCustody: {
+        readonly getReadiness: (command?: {
+            readonly signal?: AbortSignal;
+        }) => Promise<CertificateCustodyReadiness>;
+        readonly import: (command: CertificateCustodyImportCommand) => Promise<CertificateCustodyImportResult>;
+    };
+    readonly fiscalArtifacts: {
+        readonly downloadSignedDocument: (command: {
+            readonly fiscalOperationId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<SignedDocumentDownload>;
+        readonly downloadPrintedRepresentation: (command: {
+            readonly fiscalOperationId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<PrintedRepresentationDownload>;
+    };
+    readonly fiscalReceipts: {
+        readonly get: (command: FiscalReceiptCommand) => Promise<FiscalReceiptResource | undefined>;
+        readonly downloadPrintedRepresentation: (command: FiscalReceiptCommand) => Promise<PrintedRepresentationDownload>;
+    };
+    readonly fiscalDeliveries: {
+        readonly create: (command: FiscalDeliveryCreateCommand) => Promise<FiscalDeliveryResource>;
+        readonly get: (command: {
+            readonly deliveryId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<FiscalDeliveryResource | undefined>;
+    };
+    readonly receivedDocuments: {
+        readonly list: (command?: ReceivedDocumentListCommand) => Promise<ReceivedDocumentPage>;
+        readonly get: (command: {
+            readonly fiscalReceptionId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<ReceivedDocumentResource>;
+        readonly respond: (command: {
+            readonly fiscalReceptionId: string;
+            readonly response: CommercialResponse;
+            readonly signal?: AbortSignal;
+        }) => Promise<ReceivedDocumentResource>;
+        readonly downloadSignedDocument: (command: {
+            readonly fiscalReceptionId: string;
+            readonly signal?: AbortSignal;
+        }) => Promise<ReceivedDocumentSignedDocumentDownload>;
+    };
+    readonly sourceConnections: {
+        readonly completeActivationVerification: (command: SourceConnectionActivationVerificationCommand) => Promise<void>;
+        readonly issueSandboxCredential: (command: HostedSandboxSourceCredentialIssueCommand) => Promise<HostedSandboxSourceCredential>;
+    };
+    readonly webhookDeliveries: {
+        readonly list: (command: WebhookDeliveryListCommand) => Promise<WebhookDeliveryPage>;
+        readonly listAll: (command: WebhookDeliveryListCommand) => AsyncIterable<WebhookDelivery>;
+    };
+    readonly webhooks: {
+        readonly register: (command: WebhookRegistrationCommand) => Promise<WebhookRegistration>;
+        readonly replay: (command: WebhookReplayCommand) => Promise<WebhookReplay>;
+        readonly verify: (command: WebhookVerificationCommand) => Promise<DeliveredWebhookEvent>;
+    };
+};
+export declare function createTimbroClient(options: TimbroClientOptions): TimbroClient;
+//# sourceMappingURL=timbro-client.d.ts.map

package/dist/timbro-client.d.ts.map

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

package/dist/timbro-client.js

@@ -0,0 +1,72 @@
+import { importHostedCertificateCustodyResource, } from "./certificate-custody-import.js";
+import { readCertificateCustodyReadinessResource, } from "./certificate-custody-readiness.js";
+import { createFiscalDeliveryResource, getFiscalDeliveryResource, } from "./fiscal-delivery.js";
+import { readFiscalNumberingReadinessResource, } from "./fiscal-numbering-readiness.js";
+import { findFiscalOperationBySourceResource, getFiscalOperationResource, issueFiscalDocumentResource, listFiscalOperationResources, } from "./fiscal-operation.js";
+import { getFiscalOperationTimingResource, } from "./fiscal-operation-timing.js";
+import { downloadFiscalReceiptPrintedRepresentation, getFiscalReceiptResource, shareFiscalReceiptResource, } from "./fiscal-receipt.js";
+import { createGeneratedOperationClient } from "./generated-operation-client.js";
+import { downloadPrintedRepresentationResource, } from "./printed-representation.js";
+import { downloadReceivedDocumentSignedDocument, getReceivedDocumentResource, listReceivedDocumentResources, respondToReceivedDocument, } from "./received-documents.js";
+import { downloadSignedDocumentResource } from "./signed-document.js";
+import { completeSourceConnectionActivationVerificationResource, issueHostedSandboxSourceCredentialResource, } from "./source-connection.js";
+import { createStampServerHttpTransport, } from "./stamp-server-http-transport.js";
+import { readEveryWebhookDelivery, readWebhookDeliveryPage, } from "./webhook-delivery.js";
+import { registerWebhookResource, } from "./webhook-registration.js";
+import { replayWebhookResource, } from "./webhook-replay.js";
+import { verifyWebhookDelivery } from "./webhook-verification.js";
+export function createTimbroClient(options) {
+    const operationClient = createGeneratedOperationClient(createStampServerHttpTransport({
+        stampServerOrigin: options.baseUrl,
+        authentication: options.authentication,
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+    }));
+    return {
+        fiscalDocuments: {
+            shareReceipt: (command) => shareFiscalReceiptResource(operationClient, command.fiscalOperationId, command.signal),
+            issue: (command) => issueFiscalDocumentResource(operationClient, command),
+            get: (command) => getFiscalOperationResource(operationClient, command.fiscalOperationId, command.signal),
+            list: (command) => listFiscalOperationResources(operationClient, command),
+            findBySource: (command) => findFiscalOperationBySourceResource(operationClient, command.source, command.hosted, command.signal),
+            getTiming: (command) => getFiscalOperationTimingResource(operationClient, command.fiscalOperationId, command.signal),
+        },
+        fiscalNumbering: {
+            getReadiness: (command) => readFiscalNumberingReadinessResource(operationClient, command?.signal),
+        },
+        certificateCustody: {
+            getReadiness: (command) => readCertificateCustodyReadinessResource(operationClient, command?.signal),
+            import: (command) => importHostedCertificateCustodyResource(operationClient, command),
+        },
+        fiscalArtifacts: {
+            downloadSignedDocument: (command) => downloadSignedDocumentResource(operationClient, command.fiscalOperationId, command.signal),
+            downloadPrintedRepresentation: (command) => downloadPrintedRepresentationResource(operationClient, command.fiscalOperationId, command.signal),
+        },
+        receivedDocuments: {
+            list: (command) => listReceivedDocumentResources(operationClient, command),
+            get: (command) => getReceivedDocumentResource(operationClient, command.fiscalReceptionId, command.signal),
+            respond: (command) => respondToReceivedDocument(operationClient, command.fiscalReceptionId, command.response, command.signal),
+            downloadSignedDocument: (command) => downloadReceivedDocumentSignedDocument(operationClient, command.fiscalReceptionId, command.signal),
+        },
+        fiscalReceipts: {
+            get: (command) => getFiscalReceiptResource(options, command),
+            downloadPrintedRepresentation: (command) => downloadFiscalReceiptPrintedRepresentation(options, command),
+        },
+        fiscalDeliveries: {
+            create: (command) => createFiscalDeliveryResource(operationClient, command),
+            get: (command) => getFiscalDeliveryResource(operationClient, command.deliveryId, command.signal),
+        },
+        sourceConnections: {
+            completeActivationVerification: (command) => completeSourceConnectionActivationVerificationResource(operationClient, command),
+            issueSandboxCredential: (command) => issueHostedSandboxSourceCredentialResource(operationClient, command),
+        },
+        webhookDeliveries: {
+            list: (command) => readWebhookDeliveryPage(operationClient, command),
+            listAll: (command) => readEveryWebhookDelivery(operationClient, command),
+        },
+        webhooks: {
+            register: (command) => registerWebhookResource(operationClient, command),
+            replay: (command) => replayWebhookResource(operationClient, command),
+            verify: (command) => verifyWebhookDelivery(command),
+        },
+    };
+}