@timbro/invoices 0.7.0-next.30

package/dist/generated-operation-client.d.ts

@@ -0,0 +1,47 @@
+import type { TimbroTransport, TimbroTransportResponse } from "./transport-contract.ts";
+export type TDataShape = {
+    readonly body?: unknown;
+    readonly headers?: Readonly<Record<string, string | undefined>>;
+    readonly path?: unknown;
+    readonly query?: unknown;
+    readonly url: string;
+};
+export type ClientMeta = Record<string, never>;
+export type Options<TData extends TDataShape, _Response> = Omit<TData, "headers" | "url"> & {
+    readonly headers?: Readonly<Record<string, string | undefined>>;
+    readonly signal?: AbortSignal;
+};
+export type RequestResult<Responses, Errors> = Promise<GeneratedTransportResponse<Responses, Errors>>;
+type ResponseStatus<Responses> = Extract<keyof Responses, number>;
+type ErrorStatus<Errors> = Extract<keyof Errors, number>;
+type KnownResponse<Responses> = {
+    [Status in ResponseStatus<Responses>]: Omit<TimbroTransportResponse, "body" | "status"> & {
+        readonly status: Status;
+        readonly body: Responses[Status];
+    };
+}[ResponseStatus<Responses>];
+type KnownError<Errors> = {
+    [Status in ErrorStatus<Errors>]: Omit<TimbroTransportResponse, "body" | "status"> & {
+        readonly status: Status;
+        readonly body: Errors[Status];
+    };
+}[ErrorStatus<Errors>];
+type UnexpectedResponse = Omit<TimbroTransportResponse, "body" | "status"> & {
+    readonly status: "unexpected";
+    readonly status_code: number;
+    readonly body: unknown;
+};
+type GeneratedTransportResponse<Responses, Errors> = KnownResponse<Responses> | KnownError<Errors> | UnexpectedResponse;
+type GeneratedRequest<TData extends TDataShape, Responses, Errors> = Options<TData, unknown> & {
+    readonly url: TData["url"];
+    readonly response_decoder: (response: TimbroTransportResponse) => GeneratedTransportResponse<Responses, Errors>;
+};
+export type Client = {
+    readonly get: <Responses, Errors>(request: GeneratedRequest<TDataShape, Responses, Errors>) => RequestResult<Responses, Errors>;
+    readonly post: <Responses, Errors>(request: GeneratedRequest<TDataShape, Responses, Errors>) => RequestResult<Responses, Errors>;
+    readonly put: <Responses, Errors>(request: GeneratedRequest<TDataShape, Responses, Errors>) => RequestResult<Responses, Errors>;
+    readonly delete: <Responses, Errors>(request: GeneratedRequest<TDataShape, Responses, Errors>) => RequestResult<Responses, Errors>;
+};
+export declare function createGeneratedOperationClient(transport: TimbroTransport): Client;
+export {};
+//# sourceMappingURL=generated-operation-client.d.ts.map

package/dist/generated-operation-client.d.ts.map

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

package/dist/generated-operation-client.js

@@ -0,0 +1,112 @@
+import { FiscalError } from "./fiscal-error.js";
+import { readRetryAfterSeconds } from "./generated-problem.js";
+export function createGeneratedOperationClient(transport) {
+    return {
+        get: (request) => sendGeneratedRequest(transport, "GET", request),
+        post: (request) => sendGeneratedRequest(transport, "POST", request),
+        put: (request) => sendGeneratedRequest(transport, "PUT", request),
+        delete: (request) => sendGeneratedRequest(transport, "DELETE", request),
+    };
+}
+function sendGeneratedRequest(transport, method, request) {
+    return transport
+        .send({
+        method,
+        path: appendQuery(interpolatePath(request.url, request.path), request.query),
+        headers: toHeaders(request.headers),
+        body: request.body === undefined ? undefined : JSON.stringify(request.body),
+        signal: request.signal,
+    })
+        .then((response) => {
+        try {
+            return request.response_decoder(response);
+        }
+        catch (error) {
+            // biome-ignore lint/style/useErrorCause: the custom error keeps the generated failure detail in the second argument
+            throw new FiscalError("Timbro returned a response outside the generated contract", {
+                failure: "server_processing",
+                status: response.status,
+                retryAfterSeconds: readRetryAfterSeconds(response.headers),
+            }, { cause: error });
+        }
+    });
+}
+function interpolatePath(template, path) {
+    if (path === undefined) {
+        return template;
+    }
+    if (!isUnknownRecord(path)) {
+        throw new TypeError("generated operation path parameters must be an object");
+    }
+    return template.replaceAll(/\{([^}]+)\}/g, (_placeholder, name) => {
+        const parameter = path[name];
+        if (typeof parameter !== "string" &&
+            typeof parameter !== "number" &&
+            typeof parameter !== "bigint") {
+            throw new TypeError(`generated operation path parameter ${name} must be a string or integer`);
+        }
+        if (typeof parameter === "number" && !Number.isSafeInteger(parameter)) {
+            throw new TypeError(`generated operation path parameter ${name} must be a safe integer`);
+        }
+        return encodeURIComponent(String(parameter));
+    });
+}
+function appendQuery(path, query) {
+    if (query === undefined) {
+        return path;
+    }
+    if (!isUnknownRecord(query)) {
+        throw new TypeError("generated operation query parameters must be an object");
+    }
+    const parameters = new URLSearchParams();
+    for (const [name, parameter] of Object.entries(query)) {
+        appendQueryParameter(parameters, name, parameter);
+    }
+    return `${path}?${parameters.toString()}`;
+}
+function appendQueryParameter(parameters, name, parameter) {
+    if (parameter === undefined) {
+        return;
+    }
+    if (Array.isArray(parameter)) {
+        for (const element of parameter) {
+            if (!isQueryPrimitive(element)) {
+                throw new TypeError(`generated operation query parameter ${name} must contain only primitive values`);
+            }
+            parameters.append(name, String(element));
+        }
+        return;
+    }
+    if (!isQueryPrimitive(parameter)) {
+        throw new TypeError(`generated operation query parameter ${name} must be a primitive or primitive array`);
+    }
+    parameters.set(name, String(parameter));
+}
+function isQueryPrimitive(candidate) {
+    return (typeof candidate === "string" ||
+        typeof candidate === "number" ||
+        typeof candidate === "boolean" ||
+        typeof candidate === "bigint");
+}
+function toHeaders(headers) {
+    if (headers === undefined) {
+        return {};
+    }
+    if (!isUnknownRecord(headers)) {
+        throw new TypeError("generated operation headers must be an object");
+    }
+    const result = {};
+    for (const [name, header] of Object.entries(headers)) {
+        if (header === undefined) {
+            continue;
+        }
+        if (typeof header !== "string") {
+            throw new TypeError(`generated operation header ${name} must be a string`);
+        }
+        result[name] = header;
+    }
+    return result;
+}
+function isUnknownRecord(candidate) {
+    return typeof candidate === "object" && candidate !== null && !Array.isArray(candidate);
+}

package/dist/generated-problem.d.ts

@@ -0,0 +1,12 @@
+import type { PublicProblemCode } from "./generated/types.gen.ts";
+type GeneratedProblemResponse = {
+    readonly status: number | "unexpected";
+    readonly status_code?: number;
+    readonly headers?: ReadonlyMap<string, string>;
+    readonly body: unknown;
+};
+export declare function throwGeneratedProblem(response: GeneratedProblemResponse, message: string): never;
+export declare function isExpectedNotFoundProblem(response: GeneratedProblemResponse, expectedCode: Extract<PublicProblemCode, "fiscal_operation_not_found" | "fiscal_delivery_not_found" | "fiscal_receipt_not_found">, message: string): boolean;
+export declare function readRetryAfterSeconds(headers: ReadonlyMap<string, string> | undefined, nowMilliseconds?: number): number | undefined;
+export {};
+//# sourceMappingURL=generated-problem.d.ts.map

package/dist/generated-problem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-problem.d.ts","sourceRoot":"","sources":["../src/generated-problem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAwBhG;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,wBAAwB,EAClC,YAAY,EAAE,OAAO,CACnB,iBAAiB,EACjB,4BAA4B,GAAG,2BAA2B,GAAG,0BAA0B,CACxF,EACD,OAAO,EAAE,MAAM,GACd,OAAO,CAST;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAChD,eAAe,GAAE,MAAmB,GACnC,MAAM,GAAG,SAAS,CAEpB"}

package/dist/generated-problem.js

@@ -0,0 +1,37 @@
+import { parseProblemFields, parseRetryAfter } from "@timbro/protocol";
+import { FiscalError } from "./fiscal-error.js";
+import { zProblemBody } from "./generated/zod.gen.js";
+import { classifyProblemStatus } from "./problem-contract.js";
+export function throwGeneratedProblem(response, message) {
+    const retryAfterSeconds = readRetryAfterSeconds(response.headers);
+    if (response.status === "unexpected") {
+        throw new FiscalError(message, {
+            failure: "server_processing",
+            status: response.status_code,
+            retryAfterSeconds,
+        });
+    }
+    const parsed = zProblemBody.safeParse(response.body);
+    if (!parsed.success) {
+        throw new FiscalError(message, { failure: "server_processing", status: response.status, retryAfterSeconds }, { cause: parsed.error });
+    }
+    const problemFields = parseProblemFields(parsed.data.problems);
+    throw new FiscalError(message, {
+        failure: classifyProblemStatus(parsed.data),
+        problem: problemFields === undefined ? parsed.data : { ...parsed.data, problems: [...problemFields] },
+        retryAfterSeconds,
+    });
+}
+export function isExpectedNotFoundProblem(response, expectedCode, message) {
+    if (response.status !== 404) {
+        return false;
+    }
+    const parsed = zProblemBody.safeParse(response.body);
+    if (parsed.success && parsed.data.code === expectedCode) {
+        return true;
+    }
+    throwGeneratedProblem(response, message);
+}
+export function readRetryAfterSeconds(headers, nowMilliseconds = Date.now()) {
+    return parseRetryAfter(headers?.get("retry-after"), nowMilliseconds);
+}

package/dist/hosted-tenant.d.ts

@@ -0,0 +1,38 @@
+import { type CreateHostedTenantRequest, type HostedWebhookSecretRotation as GeneratedHostedWebhookSecretRotation, type ReleasedHostedTenant as GeneratedReleasedHostedTenant, type HostedTenantResource } from "./generated/index.ts";
+import { type ReadonlyCamelCase } from "./public-case.ts";
+import { type StampServerBearerTokenProvider } from "./stamp-server-http-transport.ts";
+export type HostedTenantEnvironment = CreateHostedTenantRequest["environment"];
+export type HostedTenantCreateCommand = {
+    readonly checkoutTenantId: string;
+    readonly environment: HostedTenantEnvironment;
+    readonly rnc: string;
+    readonly signal?: AbortSignal;
+};
+export type HostedTenantWebhookSecretRotationCommand = {
+    readonly sourceConnectionId: string;
+    readonly idempotencyKey?: string;
+    readonly signal?: AbortSignal;
+};
+export type HostedTenantReleaseCommand = {
+    readonly checkoutTenantId: string;
+    readonly hostedTenantBindingId: string;
+    readonly environment: HostedTenantEnvironment;
+    readonly idempotencyKey: string;
+    readonly signal?: AbortSignal;
+};
+export type HostedTenant = ReadonlyCamelCase<HostedTenantResource>;
+export type HostedTenantRelease = ReadonlyCamelCase<GeneratedReleasedHostedTenant>;
+export type HostedWebhookSecretRotation = ReadonlyCamelCase<GeneratedHostedWebhookSecretRotation>;
+export type HostedTenantClientOptions = {
+    readonly baseUrl: string;
+    readonly bearerToken: string | StampServerBearerTokenProvider;
+    readonly fetch?: typeof globalThis.fetch;
+};
+export type HostedTenantClient = {
+    readonly create: (command: HostedTenantCreateCommand) => Promise<HostedTenant>;
+    readonly release: (command: HostedTenantReleaseCommand) => Promise<HostedTenantRelease>;
+    readonly rotateWebhookSecret: (command: HostedTenantWebhookSecretRotationCommand) => Promise<HostedWebhookSecretRotation>;
+};
+/** Creates the owner-authenticated client for hosted Checkout tenant bindings. */
+export declare function createHostedTenantClient(options: HostedTenantClientOptions): HostedTenantClient;
+//# sourceMappingURL=hosted-tenant.d.ts.map

package/dist/hosted-tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-tenant.d.ts","sourceRoot":"","sources":["../src/hosted-tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,yBAAyB,EAG9B,KAAK,2BAA2B,IAAI,oCAAoC,EACxE,KAAK,oBAAoB,IAAI,6BAA6B,EAC1D,KAAK,oBAAoB,EAG1B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,KAAK,iBAAiB,EAAgB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC;AAE/E,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAAG;IACrD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,6BAA6B,CAAC,CAAC;AACnF,MAAM,MAAM,2BAA2B,GAAG,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;AAElG,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,8BAA8B,CAAC;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxF,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,OAAO,EAAE,wCAAwC,KAC9C,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC3C,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAkB/F"}

package/dist/hosted-tenant.js

@@ -0,0 +1,67 @@
+import { createHostedTenant, createHostedTenantWebhookSecretRotation, releaseHostedTenant, } from "./generated/index.js";
+import { createGeneratedOperationClient } from "./generated-operation-client.js";
+import { throwGeneratedProblem } from "./generated-problem.js";
+import { toPublicCase } from "./public-case.js";
+import { createStampServerHttpTransport, } from "./stamp-server-http-transport.js";
+/** Creates the owner-authenticated client for hosted Checkout tenant bindings. */
+export function createHostedTenantClient(options) {
+    const token = typeof options.bearerToken === "string"
+        ? () => options.bearerToken
+        : options.bearerToken;
+    const client = createGeneratedOperationClient(createStampServerHttpTransport({
+        stampServerOrigin: options.baseUrl,
+        authentication: { mode: "bearer", token },
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+    }));
+    return {
+        create: (command) => createHostedTenantResource(client, command),
+        release: (command) => releaseHostedTenantBinding(client, command),
+        rotateWebhookSecret: (command) => rotateHostedTenantWebhookSecret(client, command),
+    };
+}
+async function createHostedTenantResource(client, command) {
+    const response = await createHostedTenant({
+        client,
+        body: {
+            checkout_tenant_id: command.checkoutTenantId,
+            environment: command.environment,
+            rnc: command.rnc,
+        },
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (response.status !== 200 && response.status !== 201) {
+        throwGeneratedProblem(response, "Hosted tenant creation failed");
+    }
+    return toPublicCase(response.body);
+}
+async function releaseHostedTenantBinding(client, command) {
+    const body = {
+        checkout_tenant_id: command.checkoutTenantId,
+        hosted_tenant_binding_id: command.hostedTenantBindingId,
+        environment: command.environment,
+    };
+    const response = await releaseHostedTenant({
+        client,
+        body,
+        headers: { "Idempotency-Key": command.idempotencyKey },
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Hosted tenant release failed");
+    }
+    return toPublicCase(response.body);
+}
+async function rotateHostedTenantWebhookSecret(client, command) {
+    const response = await createHostedTenantWebhookSecretRotation({
+        client,
+        path: { source_connection_id: command.sourceConnectionId },
+        ...(command.idempotencyKey === undefined
+            ? {}
+            : { headers: { "Idempotency-Key": command.idempotencyKey } }),
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (response.status !== 200 && response.status !== 201) {
+        throwGeneratedProblem(response, "Hosted tenant Webhook secret rotation failed");
+    }
+    return toPublicCase(response.body);
+}

package/dist/hosted-workspace-transport.d.ts

@@ -0,0 +1,15 @@
+import { type StampServerBearerTokenProvider } from "./stamp-server-http-transport.ts";
+import type { TimbroTransport } from "./transport-contract.ts";
+export type HostedWorkspaceTransportOptions = {
+    /** Stamp-server origin the Checkout BFF reaches from its server runtime. */
+    readonly stampServerOrigin: string;
+    /** Hosted Workspace bearer, resolved for each request so sessions can rotate. */
+    readonly bearerToken: string | StampServerBearerTokenProvider;
+    readonly fetch?: typeof globalThis.fetch;
+};
+/**
+ * Creates the official bearer transport for Checkout's hosted Workspace passthrough.
+ * This transport deliberately has no Source connection credential option.
+ */
+export declare function createHostedWorkspaceTransport(options: HostedWorkspaceTransportOptions): TimbroTransport;
+//# sourceMappingURL=hosted-workspace-transport.d.ts.map

package/dist/hosted-workspace-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-workspace-transport.d.ts","sourceRoot":"","sources":["../src/hosted-workspace-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,MAAM,+BAA+B,GAAG;IAC5C,4EAA4E;IAC5E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,8BAA8B,CAAC;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,eAAe,CAUjB"}

package/dist/hosted-workspace-transport.js

@@ -0,0 +1,15 @@
+import { createStampServerHttpTransport, } from "./stamp-server-http-transport.js";
+/**
+ * Creates the official bearer transport for Checkout's hosted Workspace passthrough.
+ * This transport deliberately has no Source connection credential option.
+ */
+export function createHostedWorkspaceTransport(options) {
+    const token = typeof options.bearerToken === "string"
+        ? () => options.bearerToken
+        : options.bearerToken;
+    return createStampServerHttpTransport({
+        stampServerOrigin: options.stampServerOrigin,
+        authentication: { mode: "bearer", token },
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+    });
+}

package/dist/idempotency-key.d.ts

@@ -0,0 +1,3 @@
+export declare function isValidIdempotencyKey(candidate: string): boolean;
+export declare function createIdempotencyKey(): string;
+//# sourceMappingURL=idempotency-key.d.ts.map

package/dist/idempotency-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-key.d.ts","sourceRoot":"","sources":["../src/idempotency-key.ts"],"names":[],"mappings":"AAIA,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/idempotency-key.js

@@ -0,0 +1,11 @@
+const MIN_IDEMPOTENCY_KEY_LENGTH = 16;
+const MAX_IDEMPOTENCY_KEY_LENGTH = 255;
+const IDEMPOTENCY_KEY_PATTERN = /^[A-Za-z0-9._:-]+$/;
+export function isValidIdempotencyKey(candidate) {
+    const isWithinLength = candidate.length >= MIN_IDEMPOTENCY_KEY_LENGTH &&
+        candidate.length <= MAX_IDEMPOTENCY_KEY_LENGTH;
+    return isWithinLength && IDEMPOTENCY_KEY_PATTERN.test(candidate);
+}
+export function createIdempotencyKey() {
+    return globalThis.crypto.randomUUID();
+}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+export type { CertificateCustodyImportCommand, CertificateCustodyImportResult, } from "./certificate-custody-import.ts";
+export type { CertificateCustodyReadiness } from "./certificate-custody-readiness.ts";
+export type { CollectionPage } from "./collection.ts";
+export { walkCollectionPages } from "./collection.ts";
+export type { DirectConnectionApproval, DirectConnectionApprovalCommand, DirectConnectionClient, DirectConnectionClientOptions, DirectConnectionConfirmation, DirectConnectionCreateCommand, DirectConnectionEnvironment, DirectConnectionPoll, DirectConnectionPreview, DirectConnectionRequest, DirectConnectionRequestCommand, } from "./direct-connection.ts";
+export { createDirectConnectionClient, generateDirectConnectionCredential, } from "./direct-connection.ts";
+export type { FiscalDeliveryCreateCommand } from "./fiscal-delivery.ts";
+export type { FiscalErrorDetail, FiscalFailure } from "./fiscal-error.ts";
+export { FiscalError } from "./fiscal-error.ts";
+export type { FiscalNumberingReadiness } from "./fiscal-numbering-readiness.ts";
+export type { FiscalDocument, FiscalDocumentAction, FiscalDocumentIssueCommand, FiscalDocumentListCommand, FiscalDocumentNumberingInstruction, FiscalDocumentPage, FiscalOperationResource, FiscalOriginalSource, FiscalSource, HostedFiscalTenant, SourceType31Snapshot, SourceType32Snapshot, SourceType33Snapshot, SourceType34Snapshot, SourceType41Snapshot, SourceType43Snapshot, SourceType44Snapshot, SourceType45Snapshot, SourceType46Snapshot, SourceType47Snapshot, } from "./fiscal-operation.ts";
+export { toFiscalDocumentSnapshot } from "./fiscal-operation.ts";
+export type { FiscalOperationTimingReport, TimingStageId } from "./fiscal-operation-timing.ts";
+export { TIMING_STAGE_IDS } from "./fiscal-operation-timing.ts";
+export type { FiscalReceiptCommand, FiscalReceiptReference, FiscalReceiptResource, } from "./fiscal-receipt.ts";
+export type { FiscalDeliveryResource, FiscalOperationOutcomeResource, PrintedRepresentationProfile, SourceCreditNoteCorrection, SourceDebitNoteCorrection, SourceFiscalAction, WebhookDelivery, WebhookDeliveryPage, WebhookDeliveryState, } from "./generated/index.ts";
+export type { HostedTenant, HostedTenantClient, HostedTenantClientOptions, HostedTenantCreateCommand, HostedTenantEnvironment, HostedTenantRelease, HostedTenantReleaseCommand, HostedTenantWebhookSecretRotationCommand, HostedWebhookSecretRotation, } from "./hosted-tenant.ts";
+export { createHostedTenantClient } from "./hosted-tenant.ts";
+export type { HostedWorkspaceTransportOptions } from "./hosted-workspace-transport.ts";
+export { createHostedWorkspaceTransport } from "./hosted-workspace-transport.ts";
+export type { PrintedRepresentationDownload } from "./printed-representation.ts";
+export type { ProblemBody, ProblemCatalogEntry, ProblemCode, ProblemFailure, PublicProblemCode, } from "./problem-contract.ts";
+export { PROBLEM_CATALOG } from "./problem-contract.ts";
+export { toWireCase } from "./public-case.ts";
+export type { CommercialResponse, ReceivedDocumentListCommand, ReceivedDocumentPage, ReceivedDocumentRecoveryFilter, ReceivedDocumentResource, ReceivedDocumentResponseFilter, ReceivedDocumentSignedDocumentDownload, ReceivedDocumentStateFilter, ReceivedDocumentSummary, } from "./received-documents.ts";
+export { digestSha256Hex } from "./sha256.ts";
+export type { SignedDocumentDownload } from "./signed-document.ts";
+export type { HostedSandboxSourceCredential, HostedSandboxSourceCredentialIssueCommand, SourceConnectionActivationVerificationCommand, } from "./source-connection.ts";
+export type { SourceConnectionTransportOptions } from "./source-connection-transport.ts";
+export type { StampServerBearerTokenProvider, StampServerHttpAuthentication, } from "./stamp-server-http-transport.ts";
+export type { TimbroClient, TimbroClientAuthentication, TimbroClientOptions, } from "./timbro-client.ts";
+export { createTimbroClient } from "./timbro-client.ts";
+export type { WebhookDeliveryListCommand } from "./webhook-delivery.ts";
+export type { DeliveredWebhookEvent, ReceptionWebhookEvent, WebhookEvent, } from "./webhook-event.ts";
+export { parseDeliveredWebhookEvent, parseWebhookEvent, } from "./webhook-event.ts";
+export type { WebhookRegistration, WebhookRegistrationCommand } from "./webhook-registration.ts";
+export type { WebhookReplay, WebhookReplayCommand } from "./webhook-replay.ts";
+export type { WebhookDeliveryHeaders, WebhookVerificationCommand, WebhookVerificationRejection, } from "./webhook-verification.ts";
+export { verifyWebhookDelivery, WebhookVerificationError } from "./webhook-verification.ts";
+export type { WorkspaceClient, WorkspaceClientOptions } from "./workspace.ts";
+export { createWorkspaceClient } from "./workspace.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,14 @@
+export { walkCollectionPages } from "./collection.js";
+export { createDirectConnectionClient, generateDirectConnectionCredential, } from "./direct-connection.js";
+export { FiscalError } from "./fiscal-error.js";
+export { toFiscalDocumentSnapshot } from "./fiscal-operation.js";
+export { TIMING_STAGE_IDS } from "./fiscal-operation-timing.js";
+export { createHostedTenantClient } from "./hosted-tenant.js";
+export { createHostedWorkspaceTransport } from "./hosted-workspace-transport.js";
+export { PROBLEM_CATALOG } from "./problem-contract.js";
+export { toWireCase } from "./public-case.js";
+export { digestSha256Hex } from "./sha256.js";
+export { createTimbroClient } from "./timbro-client.js";
+export { parseDeliveredWebhookEvent, parseWebhookEvent, } from "./webhook-event.js";
+export { verifyWebhookDelivery, WebhookVerificationError } from "./webhook-verification.js";
+export { createWorkspaceClient } from "./workspace.js";

package/dist/printed-representation.d.ts

@@ -0,0 +1,23 @@
+import { type ElectronicFiscalDocumentType, type PrintedRepresentationProfile } from "./generated/index.ts";
+import type { Client } from "./generated-operation-client.ts";
+export declare function isCanonicalRfc3339MillisecondUtc(value: string): boolean;
+export type PrintedRepresentationDownload = {
+    readonly artifactId: string;
+    readonly bytes: Uint8Array;
+    readonly byteLength: number;
+    readonly contentSha256: string;
+    readonly createdAt: string;
+    readonly fiscalDocumentType: ElectronicFiscalDocumentType;
+    readonly fiscalNumber: string;
+    readonly fiscalOperationId: string;
+    readonly mediaType: "application/pdf";
+    readonly pageCount: number;
+    readonly paginationPlanSha256: string;
+    readonly profile: PrintedRepresentationProfile;
+    readonly profileVersion: "a4.v1" | "receipt_80mm.v1";
+    readonly rendererIdentity: string;
+    readonly signedSourceSha256: string;
+};
+export declare function downloadPrintedRepresentationResource(client: Client, fiscalOperationId: string, signal: AbortSignal | undefined): Promise<PrintedRepresentationDownload>;
+export declare function decodePrintedRepresentation(response: Pick<import("./transport-contract.ts").TimbroTransportResponse, "body" | "headers">, fiscalOperationId: string): Promise<PrintedRepresentationDownload>;
+//# sourceMappingURL=printed-representation.d.ts.map

package/dist/printed-representation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printed-representation.d.ts","sourceRoot":"","sources":["../src/printed-representation.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,4BAA4B,EAEjC,KAAK,4BAA4B,EAElC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAO9D,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAsBvE;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACrD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,6BAA6B,CAAC,CAaxC;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,IAAI,CAAC,OAAO,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAC,EAC7F,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,6BAA6B,CAAC,CAgFxC"}

package/dist/printed-representation.js

@@ -0,0 +1,135 @@
+import { createArtifactHeaderReader } from "./artifact-headers.js";
+import { FiscalError } from "./fiscal-error.js";
+import { findFiscalArtifact, zElectronicFiscalDocumentType, } from "./generated/index.js";
+import { throwGeneratedProblem } from "./generated-problem.js";
+import { digestSha256Hex } from "./sha256.js";
+const FISCAL_NUMBER_PATTERN = /^E(?:31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/;
+const RFC3339_MILLISECOND_UTC_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/;
+export function isCanonicalRfc3339MillisecondUtc(value) {
+    if (!RFC3339_MILLISECOND_UTC_PATTERN.test(value)) {
+        return false;
+    }
+    const year = Number(value.slice(0, 4));
+    const month = Number(value.slice(5, 7));
+    const day = Number(value.slice(8, 10));
+    const hours = Number(value.slice(11, 13));
+    const minutes = Number(value.slice(14, 16));
+    const seconds = Number(value.slice(17, 19));
+    const milliseconds = Number(value.slice(20, 23));
+    const instant = new Date(Date.UTC(year, month - 1, day, hours, minutes, seconds, milliseconds));
+    return (Number.isFinite(instant.getTime()) &&
+        instant.getUTCFullYear() === year &&
+        instant.getUTCMonth() === month - 1 &&
+        instant.getUTCDate() === day &&
+        instant.getUTCHours() === hours &&
+        instant.getUTCMinutes() === minutes &&
+        instant.getUTCSeconds() === seconds &&
+        instant.getUTCMilliseconds() === milliseconds);
+}
+export async function downloadPrintedRepresentationResource(client, fiscalOperationId, signal) {
+    if (fiscalOperationId.trim() === "") {
+        throw new TypeError("fiscalOperationId must not be blank");
+    }
+    const response = await findFiscalArtifact({
+        client,
+        path: { operation_id: fiscalOperationId, artifact_kind: "printed_representation" },
+        ...(signal === undefined ? {} : { signal }),
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Printed representation download failed");
+    }
+    return decodePrintedRepresentation(response, fiscalOperationId);
+}
+export async function decodePrintedRepresentation(response, fiscalOperationId) {
+    if (!(response.body instanceof Uint8Array)) {
+        throwArtifactFailure("Timbro returned a non-binary printed representation");
+    }
+    const artifactHeaders = createArtifactHeaderReader(response.headers, "artifact", throwArtifactFailure);
+    const mediaType = artifactHeaders.required("content-type");
+    if (mediaType !== "application/pdf") {
+        throwArtifactFailure("Timbro returned a printed representation with the wrong media type");
+    }
+    const artifactDigest = artifactHeaders.digest("timbro-artifact-sha256");
+    const pdfDigest = artifactHeaders.digest("timbro-pdf-sha256");
+    if (artifactDigest !== pdfDigest) {
+        throwArtifactFailure("Timbro returned mismatched artifact and PDF digests");
+    }
+    if ((await digestSha256Hex(response.body)) !== pdfDigest) {
+        throwArtifactFailure("the printed representation bytes do not match their SHA-256");
+    }
+    const byteLength = response.body.byteLength;
+    const artifactId = artifactHeaders.uuid("timbro-artifact-id");
+    const returnedOperationId = artifactHeaders.uuid("timbro-fiscal-operation-id");
+    if (returnedOperationId.toLowerCase() !== fiscalOperationId.toLowerCase()) {
+        throwArtifactFailure("the printed representation belongs to another Fiscal operation");
+    }
+    const fiscalDocumentType = artifactHeaders.required("timbro-fiscal-document-type");
+    const parsedFiscalDocumentType = zElectronicFiscalDocumentType.safeParse(fiscalDocumentType);
+    if (!parsedFiscalDocumentType.success) {
+        throwArtifactFailure("Timbro returned an unsupported fiscal document type header");
+    }
+    const typedFiscalDocumentType = parsedFiscalDocumentType.data;
+    const fiscalNumber = artifactHeaders.required("timbro-fiscal-number");
+    if (!FISCAL_NUMBER_PATTERN.test(fiscalNumber)) {
+        throwArtifactFailure("Timbro returned an invalid fiscal number header");
+    }
+    if (fiscalNumber.slice(1, 3) !== typedFiscalDocumentType) {
+        throwArtifactFailure("Timbro returned a fiscal number for another document type");
+    }
+    const signedSourceSha256 = artifactHeaders.digest("timbro-signed-source-sha256");
+    const paginationPlanSha256 = artifactHeaders.digest("timbro-pagination-plan-sha256");
+    const printedRepresentationProfile = requiredProfileHeader(artifactHeaders);
+    const printedRepresentationProfileVersion = requiredProfileVersionHeader(artifactHeaders);
+    const rendererIdentity = artifactHeaders.required("timbro-renderer-identity");
+    if (rendererIdentity.trim() === "" ||
+        rendererIdentity !== rendererIdentity.trim() ||
+        rendererIdentity.length > 200) {
+        throwArtifactFailure("Timbro returned an invalid renderer identity header");
+    }
+    const pageCount = artifactHeaders.positiveInteger("timbro-page-count");
+    if (pageCount > 100) {
+        throwArtifactFailure("Timbro returned a page count above the supported bound");
+    }
+    const createdAt = artifactHeaders.required("timbro-artifact-created-at");
+    if (!isCanonicalRfc3339MillisecondUtc(createdAt)) {
+        throwArtifactFailure("Timbro returned an invalid artifact creation time");
+    }
+    return {
+        artifactId,
+        bytes: response.body,
+        byteLength,
+        contentSha256: pdfDigest,
+        createdAt,
+        fiscalDocumentType: typedFiscalDocumentType,
+        fiscalNumber,
+        fiscalOperationId: returnedOperationId,
+        mediaType: "application/pdf",
+        pageCount,
+        paginationPlanSha256,
+        profile: printedRepresentationProfile,
+        profileVersion: printedRepresentationProfileVersion,
+        rendererIdentity,
+        signedSourceSha256,
+    };
+}
+function requiredProfileHeader(headers) {
+    const profile = headers.required("timbro-printed-representation-profile");
+    if (profile !== "receipt_80mm" && profile !== "a4") {
+        throwArtifactFailure("Timbro returned an unsupported printed representation profile");
+    }
+    return profile;
+}
+function requiredProfileVersionHeader(headers) {
+    const profile = requiredProfileHeader(headers);
+    const version = headers.required("timbro-printed-representation-profile-version");
+    if (version === "a4.v1" && profile === "a4") {
+        return version;
+    }
+    if (version === "receipt_80mm.v1" && profile === "receipt_80mm") {
+        return version;
+    }
+    throwArtifactFailure("Timbro returned a profile version that does not match its profile");
+}
+function throwArtifactFailure(message) {
+    throw new FiscalError(message, { failure: "server_processing" });
+}