@timbro/invoices 0.8.2 → 0.9.0-next.0

package/dist/invoice.d.ts

@@ -0,0 +1,94 @@
+import type { Client, InvoiceDeliveryResource, InvoicePage, InvoicePreview, InvoiceReceipt, InvoiceReceiptAccess, InvoiceRequest, InvoiceResource, InvoiceType } from "./generated/index.ts";
+import { type CommercialResponse } from "./generated/index.ts";
+import { type InvoiceHostedControls } from "./invoice-hosted-controls.ts";
+import { type InvoiceReceiptTransportOptions } from "./invoice-receipt.ts";
+import { type InvoiceReplacement } from "./invoice-replacement.ts";
+import { type ReceivedDocumentDownload, type ReceivedDocumentListCommand, type ReceivedDocumentPage, type ReceivedDocumentResource } from "./received-documents.ts";
+import type { DeliveredWebhookEvent } from "./webhook-event.ts";
+import { type WebhookVerificationCommand } from "./webhook-verification.ts";
+export type { InvoiceReplacement } from "./invoice-replacement.ts";
+export type TimbroInvoicesOptions = {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly fetch?: typeof globalThis.fetch;
+};
+export type InvoiceListFilters = {
+    readonly invoiceReference?: string;
+    readonly type?: InvoiceType;
+    readonly cursor?: string;
+    readonly limit?: number;
+};
+export type InvoiceRequestOptions = {
+    readonly signal?: AbortSignal;
+};
+export type InvoiceCreateOptions = InvoiceRequestOptions & {
+    readonly idempotencyKey?: string;
+};
+export type InvoiceDeliveryCommand = InvoiceRequestOptions & {
+    readonly invoiceId: string;
+    readonly recipientEmail: string;
+    readonly idempotencyKey: string;
+    readonly accountClaimUrl?: string;
+};
+export type InvoiceDeliveryReadCommand = InvoiceRequestOptions & {
+    readonly invoiceId: string;
+    readonly deliveryId: string;
+};
+export type InvoiceXmlDownload = {
+    readonly bytes: Uint8Array;
+    readonly byteLength: number;
+    readonly certificateSha256: string;
+    readonly createdAt: string;
+    readonly invoiceId: string;
+    readonly mediaType: "application/xml";
+    readonly securityCode: string;
+    readonly sha256: string;
+};
+export type InvoicePdfDownload = {
+    readonly bytes: Uint8Array;
+    readonly byteLength: number;
+    readonly createdAt: string;
+    readonly eNcf: string;
+    readonly invoiceId: string;
+    readonly invoiceType: InvoiceType;
+    readonly layout: "a4" | "receipt80mm";
+    readonly mediaType: "application/pdf";
+    readonly pageCount: number;
+    readonly sha256: string;
+    readonly signedSourceSha256: string;
+};
+export type TimbroInvoices = InvoiceHostedControls & {
+    readonly webhooks: {
+        readonly verify: (command: WebhookVerificationCommand) => Promise<DeliveredWebhookEvent>;
+    };
+    readonly invoices: {
+        readonly shareReceipt: (invoiceId: string, options?: InvoiceRequestOptions) => Promise<InvoiceReceiptAccess>;
+        readonly retrieveReceipt: (receipt: InvoiceReceiptAccess, options?: InvoiceRequestOptions) => Promise<InvoiceReceipt | undefined>;
+        readonly downloadReceiptPdf: (receipt: InvoiceReceiptAccess, options?: InvoiceRequestOptions) => Promise<InvoicePdfDownload>;
+        readonly create: (request: InvoiceRequest, options?: InvoiceCreateOptions) => Promise<InvoiceResource>;
+        readonly preview: (request: InvoiceRequest, options?: InvoiceRequestOptions) => Promise<InvoicePreview>;
+        readonly retrieve: (invoiceId: string, options?: InvoiceRequestOptions) => Promise<InvoiceResource | undefined>;
+        readonly downloadXml: (invoiceId: string, options?: InvoiceRequestOptions) => Promise<InvoiceXmlDownload>;
+        readonly downloadPdf: (invoiceId: string, options?: InvoiceRequestOptions) => Promise<InvoicePdfDownload>;
+        readonly list: (filters?: InvoiceListFilters, options?: InvoiceRequestOptions) => Promise<InvoicePage>;
+        readonly deliver: (command: InvoiceDeliveryCommand) => Promise<InvoiceDeliveryResource>;
+        readonly retrieveDelivery: (command: InvoiceDeliveryReadCommand) => Promise<InvoiceDeliveryResource | undefined>;
+    } & InvoiceReplacement;
+    readonly receivedDocuments: {
+        readonly list: (command?: ReceivedDocumentListCommand) => Promise<ReceivedDocumentPage>;
+        readonly retrieve: (receivedDocumentId: string, options?: InvoiceRequestOptions) => Promise<ReceivedDocumentResource | undefined>;
+        readonly respond: (receivedDocumentId: string, response: CommercialResponse, options?: InvoiceRequestOptions) => Promise<ReceivedDocumentResource>;
+        readonly downloadXml: (receivedDocumentId: string, options?: InvoiceRequestOptions) => Promise<ReceivedDocumentDownload>;
+    };
+};
+export declare function createTimbroInvoices(options: TimbroInvoicesOptions): TimbroInvoices;
+export declare function createInvoiceResources(client: Client, transport: InvoiceReceiptTransportOptions): TimbroInvoices["invoices"];
+export declare function verifyInvoiceXmlDownload(response: {
+    readonly body: unknown;
+    readonly headers: ReadonlyMap<string, string>;
+}, requestedInvoiceId: string): Promise<InvoiceXmlDownload>;
+export declare function verifyInvoicePdfDownload(response: {
+    readonly body: unknown;
+    readonly headers: ReadonlyMap<string, string>;
+}, requestedInvoiceId: string): Promise<InvoicePdfDownload>;
+//# sourceMappingURL=invoice.d.ts.map

package/dist/invoice.d.ts.map

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

package/dist/invoice.js

@@ -0,0 +1,251 @@
+import { createArtifactHeaderReader } from "./artifact-headers.js";
+import { createInvoiceDelivery as createInvoiceDeliveryOperation, createInvoice as createInvoiceOperation, downloadInvoicePdf as downloadInvoicePdfOperation, downloadInvoiceReceiptPdf as downloadInvoiceReceiptPdfOperation, downloadInvoiceXml as downloadInvoiceXmlOperation, listInvoices as listInvoicesOperation, previewInvoice as previewInvoiceOperation, retrieveInvoiceDelivery as retrieveInvoiceDeliveryOperation, retrieveInvoice as retrieveInvoiceOperation, zCreateInvoiceDeliveryRequest, zInvoiceRequest, zInvoiceType, } from "./generated/index.js";
+import { zProblemBody } from "./generated/zod.gen.js";
+import { createGeneratedOperationClient } from "./generated-operation-client.js";
+import { isExpectedNotFoundProblem, throwGeneratedProblem } from "./generated-problem.js";
+import { isValidIdempotencyKey } from "./idempotency-key.js";
+import { createInvoiceHostedControls, } from "./invoice-hosted-controls.js";
+import { createInvoiceReceiptClient, retrieveInvoiceReceiptResource, shareInvoiceReceiptResource, } from "./invoice-receipt.js";
+import { createInvoiceReplacement } from "./invoice-replacement.js";
+import { isCanonicalRfc3339MillisecondUtc } from "./printed-representation.js";
+import { downloadReceivedDocument, listReceivedDocuments, respondToReceivedDocument, retrieveReceivedDocument, } from "./received-documents.js";
+import { digestSha256Hex } from "./sha256.js";
+import { createStampServerHttpTransport } from "./stamp-server-http-transport.js";
+import { verifyWebhookDelivery } from "./webhook-verification.js";
+const DEFAULT_INVOICES_ORIGIN = "https://api.timbro.do";
+export function createTimbroInvoices(options) {
+    if (options.apiKey.trim() === "") {
+        throw new TypeError("apiKey must not be empty");
+    }
+    const client = createGeneratedOperationClient(createStampServerHttpTransport({
+        stampServerOrigin: options.baseUrl ?? DEFAULT_INVOICES_ORIGIN,
+        authentication: { mode: "source_connection", credential: options.apiKey },
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+    }));
+    return {
+        ...createInvoiceHostedControls(client),
+        invoices: createInvoiceResources(client, {
+            baseUrl: options.baseUrl ?? DEFAULT_INVOICES_ORIGIN,
+            ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+        }),
+        receivedDocuments: {
+            list: (command) => listReceivedDocuments(client, command),
+            retrieve: (receivedDocumentId, requestOptions) => retrieveReceivedDocument(client, receivedDocumentId, requestOptions?.signal),
+            respond: (receivedDocumentId, response, requestOptions) => respondToReceivedDocument(client, receivedDocumentId, response, requestOptions?.signal),
+            downloadXml: (receivedDocumentId, requestOptions) => downloadReceivedDocument(client, receivedDocumentId, requestOptions?.signal),
+        },
+        webhooks: { verify: verifyWebhookDelivery },
+    };
+}
+export function createInvoiceResources(client, transport) {
+    return {
+        ...createInvoiceReplacement(client),
+        deliver: async (command) => {
+            if (command.invoiceId.trim() === "") {
+                throw new TypeError("invoiceId must not be blank");
+            }
+            if (!isValidIdempotencyKey(command.idempotencyKey)) {
+                throw new TypeError("idempotencyKey must contain 16 to 255 allowed characters");
+            }
+            const body = zCreateInvoiceDeliveryRequest.parse({
+                recipientEmail: command.recipientEmail,
+                ...(command.accountClaimUrl === undefined
+                    ? {}
+                    : { accountClaimUrl: command.accountClaimUrl }),
+            });
+            const response = await createInvoiceDeliveryOperation({
+                client,
+                path: { invoiceId: command.invoiceId },
+                body,
+                headers: { "Idempotency-Key": command.idempotencyKey },
+                ...(command.signal === undefined ? {} : { signal: command.signal }),
+            });
+            if (response.status === 200 || response.status === 201) {
+                return response.body;
+            }
+            throwGeneratedProblem(response, "Invoice delivery request failed");
+        },
+        retrieveDelivery: async (command) => {
+            if (command.invoiceId.trim() === "" || command.deliveryId.trim() === "") {
+                throw new TypeError("invoiceId and deliveryId must not be blank");
+            }
+            const response = await retrieveInvoiceDeliveryOperation({
+                client,
+                path: { invoiceId: command.invoiceId, deliveryId: command.deliveryId },
+                ...(command.signal === undefined ? {} : { signal: command.signal }),
+            });
+            if (response.status === 200) {
+                return response.body;
+            }
+            if (isExpectedNotFoundProblem(response, "fiscal_delivery_not_found", "Invoice delivery lookup failed")) {
+                return;
+            }
+            throwGeneratedProblem(response, "Invoice delivery lookup failed");
+        },
+        shareReceipt: (invoiceId, requestOptions) => shareInvoiceReceiptResource(client, invoiceId, requestOptions?.signal),
+        retrieveReceipt: (receipt, requestOptions) => retrieveInvoiceReceiptResource(transport, receipt, requestOptions?.signal),
+        downloadReceiptPdf: async (receipt, requestOptions) => {
+            const response = await downloadInvoiceReceiptPdfOperation({
+                client: createInvoiceReceiptClient(transport, receipt),
+                path: { receiptId: receipt.id },
+                ...(requestOptions?.signal === undefined ? {} : { signal: requestOptions.signal }),
+            });
+            if (response.status !== 200) {
+                throwGeneratedProblem(response, "Invoice receipt PDF download failed");
+            }
+            return verifyInvoicePdfDownload(response, receipt.invoiceId);
+        },
+        create: async (request, requestOptions) => {
+            const body = zInvoiceRequest.parse(request);
+            const response = await createInvoiceOperation({
+                client,
+                body,
+                ...(requestOptions?.idempotencyKey === undefined
+                    ? {}
+                    : { headers: { "Idempotency-Key": requestOptions.idempotencyKey } }),
+                ...(requestOptions?.signal === undefined ? {} : { signal: requestOptions.signal }),
+            });
+            if (response.status === 200 || response.status === 201) {
+                return response.body;
+            }
+            throwGeneratedProblem(response, "Invoice creation failed");
+        },
+        preview: async (request, requestOptions) => {
+            const body = zInvoiceRequest.parse(request);
+            const response = await previewInvoiceOperation({
+                client,
+                body,
+                ...(requestOptions?.signal === undefined ? {} : { signal: requestOptions.signal }),
+            });
+            if (response.status === 200) {
+                return response.body;
+            }
+            throwGeneratedProblem(response, "Invoice preview failed");
+        },
+        retrieve: async (invoiceId, requestOptions) => {
+            const response = await retrieveInvoiceOperation({
+                client,
+                path: { invoiceId },
+                ...(requestOptions?.signal === undefined ? {} : { signal: requestOptions.signal }),
+            });
+            if (response.status === 200) {
+                return response.body;
+            }
+            if (response.status === 404) {
+                const problem = zProblemBody.safeParse(response.body);
+                if (problem.success && problem.data.code === "invoice_not_found") {
+                    return;
+                }
+            }
+            throwGeneratedProblem(response, "Invoice lookup failed");
+        },
+        downloadXml: async (invoiceId, requestOptions) => {
+            const response = await downloadInvoiceXmlOperation({
+                client,
+                path: { invoiceId },
+                ...(requestOptions?.signal === undefined ? {} : { signal: requestOptions.signal }),
+            });
+            if (response.status !== 200) {
+                throwGeneratedProblem(response, "Invoice XML download failed");
+            }
+            return verifyInvoiceXmlDownload(response, invoiceId);
+        },
+        downloadPdf: async (invoiceId, requestOptions) => {
+            const response = await downloadInvoicePdfOperation({
+                client,
+                path: { invoiceId },
+                ...(requestOptions?.signal === undefined ? {} : { signal: requestOptions.signal }),
+            });
+            if (response.status !== 200) {
+                throwGeneratedProblem(response, "Invoice PDF download failed");
+            }
+            return verifyInvoicePdfDownload(response, invoiceId);
+        },
+        list: async (filters, requestOptions) => {
+            const response = await listInvoicesOperation({
+                client,
+                ...(filters === undefined ? {} : { query: filters }),
+                ...(requestOptions?.signal === undefined ? {} : { signal: requestOptions.signal }),
+            });
+            if (response.status === 200) {
+                return response.body;
+            }
+            throwGeneratedProblem(response, "Invoice listing failed");
+        },
+    };
+}
+export async function verifyInvoiceXmlDownload(response, requestedInvoiceId) {
+    const file = await decodeInvoiceFile(response, requestedInvoiceId, "application/xml");
+    const headers = createArtifactHeaderReader(response.headers, "Invoice XML");
+    const certificateSha256 = headers.digest("timbro-certificate-sha256");
+    const securityCode = headers.required("timbro-security-code");
+    if (securityCode.length !== 6) {
+        throw new TypeError("Timbro returned an invalid Invoice XML security code");
+    }
+    return { ...file, certificateSha256, securityCode };
+}
+export async function verifyInvoicePdfDownload(response, requestedInvoiceId) {
+    const file = await decodeInvoiceFile(response, requestedInvoiceId, "application/pdf");
+    const headers = createArtifactHeaderReader(response.headers, "Invoice PDF");
+    const pdfSha256 = headers.digest("timbro-pdf-sha256");
+    if (file.sha256 !== pdfSha256) {
+        throw new TypeError("Timbro returned mismatched Invoice file and PDF digests");
+    }
+    const signedSourceSha256 = headers.digest("timbro-signed-source-sha256");
+    const parsedInvoiceType = zInvoiceType.safeParse(headers.required("timbro-invoice-type"));
+    if (!parsedInvoiceType.success) {
+        throw new TypeError("Timbro returned an unsupported Invoice PDF document type");
+    }
+    const invoiceType = parsedInvoiceType.data;
+    const eNcf = headers.required("timbro-encf");
+    if (!FISCAL_NUMBER_PATTERN.test(eNcf) || eNcf.slice(0, 3) !== invoiceType) {
+        throw new TypeError("Timbro returned an Invoice PDF eNCF for another type");
+    }
+    const layout = headers.required("timbro-pdf-layout");
+    if (layout !== "a4" && layout !== "receipt80mm") {
+        throw new TypeError("Timbro returned an unsupported Invoice PDF layout");
+    }
+    const pageCount = headers.positiveInteger("timbro-page-count");
+    if (pageCount > 100) {
+        throw new TypeError("Timbro returned an Invoice PDF with too many pages");
+    }
+    return {
+        ...file,
+        eNcf,
+        invoiceType,
+        layout,
+        mediaType: "application/pdf",
+        pageCount,
+        signedSourceSha256,
+    };
+}
+async function decodeInvoiceFile(response, requestedInvoiceId, mediaType) {
+    if (!(response.body instanceof Uint8Array)) {
+        throw new TypeError("Timbro returned a non-binary Invoice file");
+    }
+    const headers = createArtifactHeaderReader(response.headers, "Invoice file");
+    if (headers.required("content-type") !== mediaType) {
+        throw new TypeError("Timbro returned an Invoice file with the wrong media type");
+    }
+    const sha256 = headers.digest("timbro-file-sha256");
+    if ((await digestSha256Hex(response.body)) !== sha256) {
+        throw new TypeError("Invoice file bytes do not match their SHA-256");
+    }
+    const invoiceId = headers.uuid("timbro-invoice-id");
+    if (invoiceId.toLowerCase() !== requestedInvoiceId.toLowerCase()) {
+        throw new TypeError("Timbro returned a file for another Invoice");
+    }
+    const createdAt = headers.required("timbro-file-created-at");
+    if (!isCanonicalRfc3339MillisecondUtc(createdAt)) {
+        throw new TypeError("Timbro returned an invalid Invoice file creation time");
+    }
+    return {
+        bytes: response.body,
+        byteLength: response.body.byteLength,
+        createdAt,
+        invoiceId,
+        mediaType,
+        sha256,
+    };
+}
+const FISCAL_NUMBER_PATTERN = /^E(?:31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/;

package/dist/printed-representation.d.ts

@@ -19,5 +19,4 @@ export type PrintedRepresentationDownload = {
     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

@@ -1 +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"}
+{"version":3,"file":"printed-representation.d.ts","sourceRoot":"","sources":["../src/printed-representation.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,4BAA4B,EAEjC,KAAK,4BAA4B,EAElC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAQ9D,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"}

package/dist/printed-representation.js

@@ -1,7 +1,7 @@
 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 { InvoiceError } from "./invoice-error.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$/;
@@ -40,7 +40,7 @@ export async function downloadPrintedRepresentationResource(client, fiscalOperat
     }
     return decodePrintedRepresentation(response, fiscalOperationId);
 }
-export async function decodePrintedRepresentation(response, fiscalOperationId) {
+async function decodePrintedRepresentation(response, fiscalOperationId) {
     if (!(response.body instanceof Uint8Array)) {
         throwArtifactFailure("Timbro returned a non-binary printed representation");
     }
@@ -131,5 +131,5 @@ function requiredProfileVersionHeader(headers) {
     throwArtifactFailure("Timbro returned a profile version that does not match its profile");
 }
 function throwArtifactFailure(message) {
-    throw new FiscalError(message, { failure: "server_processing" });
+    throw new InvoiceError(message, { failure: "server_processing" });
 }

package/dist/problem-contract.d.ts

@@ -8,115 +8,10 @@ export type { ProblemCatalogEntry } from "./generated/problem-catalog.ts";
 export { PROBLEM_CATALOG } from "./generated/problem-catalog.ts";
 export type { ProblemBody, PublicProblemCode } from "./generated/types.gen.ts";
 export declare const problemBodySchema: z.ZodObject<{
-    code: z.ZodEnum<{
-        affected_fiscal_operation_unsupported: "affected_fiscal_operation_unsupported";
-        already_a_member: "already_a_member";
-        authority_rejected_replacement: "authority_rejected_replacement";
-        certificate_custody_binding_conflict: "certificate_custody_binding_conflict";
-        certificate_custody_binding_not_found: "certificate_custody_binding_not_found";
-        certificate_custody_certificate_version_not_active: "certificate_custody_certificate_version_not_active";
-        certificate_p12_password_invalid: "certificate_p12_password_invalid";
-        commercial_response_decision_conflict: "commercial_response_decision_conflict";
-        commercial_response_motive_invalid: "commercial_response_motive_invalid";
-        correction_target_unsettled: "correction_target_unsettled";
-        credential_revoked: "credential_revoked";
-        custody_certificate_chain_untrusted: "custody_certificate_chain_untrusted";
-        custody_certificate_malformed: "custody_certificate_malformed";
-        custody_certificate_purpose_unsupported: "custody_certificate_purpose_unsupported";
-        custody_certificate_trust_profile_unsupported: "custody_certificate_trust_profile_unsupported";
-        custody_signature_algorithm_unsupported: "custody_signature_algorithm_unsupported";
-        custody_unavailable: "custody_unavailable";
-        delegated_authorization_verifier_forbidden: "delegated_authorization_verifier_forbidden";
-        document_type_not_enabled: "document_type_not_enabled";
-        email_already_registered: "email_already_registered";
-        environment_not_active: "environment_not_active";
-        fiscal_artifact_not_found: "fiscal_artifact_not_found";
-        fiscal_artifact_unavailable: "fiscal_artifact_unavailable";
-        fiscal_artifact_unverified: "fiscal_artifact_unverified";
-        fiscal_delivery_not_found: "fiscal_delivery_not_found";
-        fiscal_delivery_outcome_conflict: "fiscal_delivery_outcome_conflict";
-        fiscal_delivery_unavailable: "fiscal_delivery_unavailable";
-        fiscal_intent_rejected: "fiscal_intent_rejected";
-        fiscal_issuance_blocked: "fiscal_issuance_blocked";
-        fiscal_number_already_used: "fiscal_number_already_used";
-        fiscal_number_authorization_changed: "fiscal_number_authorization_changed";
-        fiscal_number_authorization_source_record_conflict: "fiscal_number_authorization_source_record_conflict";
-        fiscal_operation_not_found: "fiscal_operation_not_found";
-        fiscal_receipt_not_found: "fiscal_receipt_not_found";
-        fiscal_receipt_not_ready: "fiscal_receipt_not_ready";
-        fiscal_receipt_unavailable: "fiscal_receipt_unavailable";
-        hosted_tenant_conflict: "hosted_tenant_conflict";
-        idempotency_key_conflict: "idempotency_key_conflict";
-        insufficient_role: "insufficient_role";
-        internal_error: "internal_error";
-        invalid_certificate_custody_signer_identity: "invalid_certificate_custody_signer_identity";
-        invalid_collection_cursor: "invalid_collection_cursor";
-        invalid_collection_query: "invalid_collection_query";
-        invalid_credential: "invalid_credential";
-        invalid_fiscal_identity: "invalid_fiscal_identity";
-        invalid_idempotency_key: "invalid_idempotency_key";
-        invalid_login: "invalid_login";
-        invalid_replay_scope: "invalid_replay_scope";
-        invalid_request: "invalid_request";
-        invitation_expired: "invitation_expired";
-        invitation_invalid: "invitation_invalid";
-        issuer_not_authorized: "issuer_not_authorized";
-        legal_issuer_already_registered: "legal_issuer_already_registered";
-        legal_issuer_not_found: "legal_issuer_not_found";
-        legal_issuer_profile_incomplete: "legal_issuer_profile_incomplete";
-        malformed_json: "malformed_json";
-        method_not_allowed: "method_not_allowed";
-        missing_idempotency_key: "missing_idempotency_key";
-        onboarding_legal_issuer_identity_conflict: "onboarding_legal_issuer_identity_conflict";
-        organization_not_found: "organization_not_found";
-        organization_slug_taken: "organization_slug_taken";
-        printed_representation_profile_conflict: "printed_representation_profile_conflict";
-        received_document_not_found: "received_document_not_found";
-        request_body_timeout: "request_body_timeout";
-        request_too_large: "request_too_large";
-        route_not_found: "route_not_found";
-        service_role_not_permitted: "service_role_not_permitted";
-        signed_document_schema_invalid: "signed_document_schema_invalid";
-        source_action_conflict: "source_action_conflict";
-        source_command_conflict: "source_command_conflict";
-        source_connection_activation_conflict: "source_connection_activation_conflict";
-        source_connection_activation_verification_rejected: "source_connection_activation_verification_rejected";
-        source_connection_creation_conflict: "source_connection_creation_conflict";
-        source_connection_not_connected: "source_connection_not_connected";
-        source_connection_not_found: "source_connection_not_found";
-        source_content_conflict: "source_content_conflict";
-        source_history_requires_reconciliation: "source_history_requires_reconciliation";
-        source_operation_pending: "source_operation_pending";
-        source_outcome_unknown: "source_outcome_unknown";
-        source_predecessor_conflict: "source_predecessor_conflict";
-        source_provider_authorization_conflict: "source_provider_authorization_conflict";
-        source_provider_authorization_not_found: "source_provider_authorization_not_found";
-        source_provider_authorization_required: "source_provider_authorization_required";
-        source_provider_installation_callback_replayed: "source_provider_installation_callback_replayed";
-        source_provider_installation_disabled: "source_provider_installation_disabled";
-        source_provider_installation_removed: "source_provider_installation_removed";
-        source_provider_installation_request_expired: "source_provider_installation_request_expired";
-        source_provider_installation_request_invalid: "source_provider_installation_request_invalid";
-        source_provider_outcome_unknown: "source_provider_outcome_unknown";
-        source_provider_scope_insufficient: "source_provider_scope_insufficient";
-        source_provider_target_access_removed: "source_provider_target_access_removed";
-        source_provider_throttled: "source_provider_throttled";
-        source_provider_unavailable: "source_provider_unavailable";
-        source_record_already_fiscalized: "source_record_already_fiscalized";
-        source_version_stale: "source_version_stale";
-        unauthenticated: "unauthenticated";
-        unsigned_document_schema_invalid: "unsigned_document_schema_invalid";
-        unsupported_media_type: "unsupported_media_type";
-        unsupported_printed_representation_profile: "unsupported_printed_representation_profile";
-        webhook_destination_not_allowed: "webhook_destination_not_allowed";
-        webhook_endpoint_deleted: "webhook_endpoint_deleted";
-        webhook_endpoint_not_found: "webhook_endpoint_not_found";
-        webhook_endpoint_registration_conflict: "webhook_endpoint_registration_conflict";
-        webhook_endpoint_suspended: "webhook_endpoint_suspended";
-        webhook_event_not_found: "webhook_event_not_found";
-    }>;
-    fiscal_operation_id: z.ZodOptional<z.ZodString>;
-    issuance_blockers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    code: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+    invoiceId: z.ZodOptional<z.ZodString>;
+    issuanceBlockers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         authorization_cancelled: "authorization_cancelled";
         authorization_conflicting: "authorization_conflicting";
         authorization_document_type_mismatch: "authorization_document_type_mismatch";
@@ -146,10 +41,12 @@ export declare const problemBodySchema: z.ZodObject<{
         message: z.ZodString;
         path: z.ZodString;
     }, z.core.$strict>>>;
-    request_id: z.ZodString;
+    requestId: z.ZodString;
     status: z.ZodInt;
     title: z.ZodString;
-    type: z.ZodString;
+    type: z.ZodEnum<{
+        "about:blank": "about:blank";
+    }>;
 }, z.core.$strict>;
 export declare const problemCodeSchema: z.ZodEnum<{
     affected_fiscal_operation_unsupported: "affected_fiscal_operation_unsupported";
@@ -164,9 +61,12 @@ export declare const problemCodeSchema: z.ZodEnum<{
     correction_target_unsettled: "correction_target_unsettled";
     credential_revoked: "credential_revoked";
     custody_certificate_chain_untrusted: "custody_certificate_chain_untrusted";
+    custody_certificate_expired: "custody_certificate_expired";
     custody_certificate_malformed: "custody_certificate_malformed";
+    custody_certificate_not_yet_valid: "custody_certificate_not_yet_valid";
     custody_certificate_purpose_unsupported: "custody_certificate_purpose_unsupported";
     custody_certificate_trust_profile_unsupported: "custody_certificate_trust_profile_unsupported";
+    custody_p12_work_limit_exceeded: "custody_p12_work_limit_exceeded";
     custody_signature_algorithm_unsupported: "custody_signature_algorithm_unsupported";
     custody_unavailable: "custody_unavailable";
     delegated_authorization_verifier_forbidden: "delegated_authorization_verifier_forbidden";
@@ -185,9 +85,6 @@ export declare const problemCodeSchema: z.ZodEnum<{
     fiscal_number_authorization_changed: "fiscal_number_authorization_changed";
     fiscal_number_authorization_source_record_conflict: "fiscal_number_authorization_source_record_conflict";
     fiscal_operation_not_found: "fiscal_operation_not_found";
-    fiscal_receipt_not_found: "fiscal_receipt_not_found";
-    fiscal_receipt_not_ready: "fiscal_receipt_not_ready";
-    fiscal_receipt_unavailable: "fiscal_receipt_unavailable";
     hosted_tenant_conflict: "hosted_tenant_conflict";
     idempotency_key_conflict: "idempotency_key_conflict";
     insufficient_role: "insufficient_role";
@@ -203,6 +100,12 @@ export declare const problemCodeSchema: z.ZodEnum<{
     invalid_request: "invalid_request";
     invitation_expired: "invitation_expired";
     invitation_invalid: "invitation_invalid";
+    invoice_not_found: "invoice_not_found";
+    invoice_receipt_not_found: "invoice_receipt_not_found";
+    invoice_receipt_not_ready: "invoice_receipt_not_ready";
+    invoice_receipt_unavailable: "invoice_receipt_unavailable";
+    invoice_reference_conflict: "invoice_reference_conflict";
+    invoice_totals_mismatch: "invoice_totals_mismatch";
     issuer_not_authorized: "issuer_not_authorized";
     legal_issuer_already_registered: "legal_issuer_already_registered";
     legal_issuer_not_found: "legal_issuer_not_found";

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

@@ -1 +1 @@
-{"version":3,"file":"problem-contract.d.ts","sourceRoot":"","sources":["../src/problem-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,YAAY,GAAG,WAAW,GAAG,mBAAmB,CAAC;AACjG,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAC5C,MAAM,MAAM,YAAY,GAAG,sBAAsB,GAAG,YAAY,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAe,CAAC;AAC9C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,iBAAiB,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAiB1E;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"problem-contract.d.ts","sourceRoot":"","sources":["../src/problem-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,YAAY,GAAG,WAAW,GAAG,mBAAmB,CAAC;AACjG,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAC5C,MAAM,MAAM,YAAY,GAAG,sBAAsB,GAAG,YAAY,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAe,CAAC;AAC9C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,iBAAiB,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAiB1E;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/public-case.d.ts

@@ -2,7 +2,7 @@
 type SnakeToCamelCase<Value extends string> = Value extends `${infer Head}_${infer Tail}` ? `${Head}${SnakeToCamelCase<Capitalize<Tail>>}` : Value;
 /**
  * Projects generated JSON types into the readonly camelCase vocabulary exposed by the task SDK.
- * Generated bindings remain available from `@timbro/invoices/generated` for wire-level consumers.
+ * Generated bindings remain available from `@timbro/invoices/admin/generated` for wire-level consumers.
  */
 export type ReadonlyCamelCase<Value> = Value extends readonly unknown[] ? readonly ReadonlyCamelCase<Value[number]>[] : Value extends object ? {
     readonly [Key in keyof Value as Key extends string ? SnakeToCamelCase<Key> : Key]: ReadonlyCamelCase<Value[Key]>;

package/dist/received-documents.d.ts

@@ -1,6 +1,5 @@
 import { type ReceivedDocumentPage as GeneratedReceivedDocumentPage, type ReceivedDocumentResource as GeneratedReceivedDocumentResource, type ReceivedDocumentRecoveryFilter, type ReceivedDocumentResponseFilter, type ReceivedDocumentStateFilter } from "./generated/index.ts";
 import type { Client } from "./generated-operation-client.ts";
-import { type ReadonlyCamelCase } from "./public-case.ts";
 export type CommercialResponse = {
     readonly decision: "accepted";
 } | {
@@ -16,20 +15,22 @@ export type ReceivedDocumentListCommand = {
     readonly recovery?: ReceivedDocumentRecoveryFilter;
     readonly signal?: AbortSignal;
 };
-export type ReceivedDocumentSummary = ReadonlyCamelCase<GeneratedReceivedDocumentPage["data"][number]>;
-export type ReceivedDocumentPage = Omit<ReadonlyCamelCase<GeneratedReceivedDocumentPage>, "data"> & {
-    readonly data: readonly ReceivedDocumentSummary[];
-};
-export type ReceivedDocumentResource = ReadonlyCamelCase<GeneratedReceivedDocumentResource>;
-export type ReceivedDocumentSignedDocumentDownload = {
+export type ReceivedDocumentSummary = GeneratedReceivedDocumentPage["data"][number];
+export type ReceivedDocumentPage = GeneratedReceivedDocumentPage;
+export type ReceivedDocumentResource = GeneratedReceivedDocumentResource;
+export type ReceivedDocumentDownload = {
     readonly bytes: Uint8Array;
     readonly byteLength: number;
     readonly contentSha256: string;
     readonly mediaType: "application/xml";
-    readonly fiscalReceptionId: string;
+    readonly receivedDocumentId: string;
 };
-export declare function listReceivedDocumentResources(client: Client, command?: ReceivedDocumentListCommand): Promise<ReceivedDocumentPage>;
-export declare function getReceivedDocumentResource(client: Client, fiscalReceptionId: string, signal: AbortSignal | undefined): Promise<ReceivedDocumentResource>;
-export declare function respondToReceivedDocument(client: Client, fiscalReceptionId: string, responseBody: CommercialResponse, signal: AbortSignal | undefined): Promise<ReceivedDocumentResource>;
-export declare function downloadReceivedDocumentSignedDocument(client: Client, fiscalReceptionId: string, signal: AbortSignal | undefined): Promise<ReceivedDocumentSignedDocumentDownload>;
+export declare function listReceivedDocuments(client: Client, command?: ReceivedDocumentListCommand): Promise<ReceivedDocumentPage>;
+export declare function retrieveReceivedDocument(client: Client, receivedDocumentId: string, signal: AbortSignal | undefined): Promise<ReceivedDocumentResource | undefined>;
+export declare function respondToReceivedDocument(client: Client, receivedDocumentId: string, responseBody: CommercialResponse, signal: AbortSignal | undefined): Promise<ReceivedDocumentResource>;
+export declare function downloadReceivedDocument(client: Client, receivedDocumentId: string, signal: AbortSignal | undefined): Promise<ReceivedDocumentDownload>;
+export declare function verifyReceivedDocumentXmlDownload(response: {
+    readonly body: unknown;
+    readonly headers: ReadonlyMap<string, string>;
+}, receivedDocumentId: string): Promise<ReceivedDocumentDownload>;
 //# sourceMappingURL=received-documents.d.ts.map

package/dist/received-documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"received-documents.d.ts","sourceRoot":"","sources":["../src/received-documents.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,IAAI,6BAA6B,EAC1D,KAAK,wBAAwB,IAAI,iCAAiC,EAGlE,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAEjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAgB,MAAM,kBAAkB,CAAC;AAGxE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GACjC;IAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,YAAY,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,8BAA8B,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,8BAA8B,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CACrD,6BAA6B,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAC9C,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,CAAC,6BAA6B,CAAC,EAChD,MAAM,CACP,GAAG;IACF,QAAQ,CAAC,IAAI,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACnD,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,iCAAiC,CAAC,CAAC;AAE5F,MAAM,MAAM,sCAAsC,GAAG;IACnD,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,iBAAiB,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAgB/B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAWnC;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAYnC;AAED,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,sCAAsC,CAAC,CA8BjD"}
+{"version":3,"file":"received-documents.d.ts","sourceRoot":"","sources":["../src/received-documents.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,IAAI,6BAA6B,EAC1D,KAAK,wBAAwB,IAAI,iCAAiC,EAGlE,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAEjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAI9D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GACjC;IAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,YAAY,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,8BAA8B,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,8BAA8B,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AACjE,MAAM,MAAM,wBAAwB,GAAG,iCAAiC,CAAC;AAEzE,MAAM,MAAM,wBAAwB,GAAG;IACrC,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,iBAAiB,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAgB/B;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAoB/C;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAYnC;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAWnC;AAED,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACnF,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAsBnC"}