@timbro/invoices 0.7.0-next.30

package/dist/fiscal-error.d.ts

@@ -0,0 +1,23 @@
+import type { FiscalAdmissionProblem, IssuanceBlocker, ProblemBody, PublicProblemCode } from "./generated/types.gen.ts";
+import type { ProblemFailure } from "./problem-contract.ts";
+export type FiscalFailure = ProblemFailure | "connectivity" | "timeout" | "cancelled";
+export type FiscalErrorDetail = {
+    readonly failure: FiscalFailure;
+    readonly status?: number | undefined;
+    readonly problem?: ProblemBody;
+    readonly retryAfterSeconds?: number | undefined;
+};
+export declare class FiscalError extends Error {
+    readonly failure: FiscalFailure;
+    readonly status: number | undefined;
+    readonly problem: ProblemBody | undefined;
+    readonly retryAfterSeconds: number | undefined;
+    constructor(message: string, detail: FiscalErrorDetail, options?: ErrorOptions);
+    get code(): PublicProblemCode | undefined;
+    get title(): string | undefined;
+    get requestId(): string | undefined;
+    get problems(): readonly FiscalAdmissionProblem[];
+    get issuanceBlockers(): readonly IssuanceBlocker[];
+    get isRetryable(): boolean;
+}
+//# sourceMappingURL=fiscal-error.d.ts.map

package/dist/fiscal-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-error.d.ts","sourceRoot":"","sources":["../src/fiscal-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD,CAAC;AAIF,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/C,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,YAAY,EAO7E;IAED,IAAI,IAAI,IAAI,iBAAiB,GAAG,SAAS,CAExC;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,IAAI,QAAQ,IAAI,SAAS,sBAAsB,EAAE,CAEhD;IAED,IAAI,gBAAgB,IAAI,SAAS,eAAe,EAAE,CAEjD;IAED,IAAI,WAAW,IAAI,OAAO,CAKzB;CACF"}

package/dist/fiscal-error.js

@@ -0,0 +1,36 @@
+const RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+export class FiscalError extends Error {
+    failure;
+    status;
+    problem;
+    retryAfterSeconds;
+    constructor(message, detail, options) {
+        super(message, options);
+        this.name = "FiscalError";
+        this.failure = detail.failure;
+        this.status = detail.problem?.status ?? detail.status;
+        this.problem = detail.problem;
+        this.retryAfterSeconds = detail.retryAfterSeconds;
+    }
+    get code() {
+        return this.problem?.code;
+    }
+    get title() {
+        return this.problem?.title;
+    }
+    get requestId() {
+        return this.problem?.request_id;
+    }
+    get problems() {
+        return this.problem?.problems ?? [];
+    }
+    get issuanceBlockers() {
+        return this.problem?.issuance_blockers ?? [];
+    }
+    get isRetryable() {
+        if (this.failure === "connectivity" || this.failure === "timeout") {
+            return true;
+        }
+        return this.status !== undefined && RETRYABLE_STATUSES.has(this.status);
+    }
+}

package/dist/fiscal-numbering-readiness.d.ts

@@ -0,0 +1,6 @@
+import { type FiscalNumberAuthorizationReadiness } from "./generated/index.ts";
+import type { Client } from "./generated-operation-client.ts";
+import { type ReadonlyCamelCase } from "./public-case.ts";
+export type FiscalNumberingReadiness = ReadonlyCamelCase<FiscalNumberAuthorizationReadiness>;
+export declare function readFiscalNumberingReadinessResource(client: Client, signal: AbortSignal | undefined): Promise<FiscalNumberingReadiness>;
+//# sourceMappingURL=fiscal-numbering-readiness.d.ts.map

package/dist/fiscal-numbering-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-numbering-readiness.d.ts","sourceRoot":"","sources":["../src/fiscal-numbering-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kCAAkC,EAExC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAgB,MAAM,kBAAkB,CAAC;AAExE,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,kCAAkC,CAAC,CAAC;AAE7F,wBAAsB,oCAAoC,CACxD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CASnC"}

package/dist/fiscal-numbering-readiness.js

@@ -0,0 +1,13 @@
+import { readFiscalNumberAuthorizationReadiness, } from "./generated/index.js";
+import { throwGeneratedProblem } from "./generated-problem.js";
+import { toPublicCase } from "./public-case.js";
+export async function readFiscalNumberingReadinessResource(client, signal) {
+    const response = await readFiscalNumberAuthorizationReadiness({
+        client,
+        ...(signal === undefined ? {} : { signal }),
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal-number readiness read failed");
+    }
+    return toPublicCase(response.body);
+}

package/dist/fiscal-operation-timing.d.ts

@@ -0,0 +1,9 @@
+import { type FiscalOperationTimingReport as GeneratedFiscalOperationTimingReport } from "./generated/index.ts";
+import type { Client } from "./generated-operation-client.ts";
+import { type ReadonlyCamelCase } from "./public-case.ts";
+export type { TimingStageId } from "./generated/index.ts";
+export type FiscalOperationTimingReport = ReadonlyCamelCase<GeneratedFiscalOperationTimingReport>;
+/** Every stage id the operation timing contract publishes. */
+export declare const TIMING_STAGE_IDS: ("timbro.activation_drain" | "timbro.admission.authenticate" | "timbro.admission.commit" | "timbro.admission.evaluate" | "timbro.admission.prepare" | "timbro.admission_request" | "timbro.dgii.authenticate" | "timbro.dgii.inquiry.consumer_summary" | "timbro.dgii.inquiry.fiscal_identity" | "timbro.dgii.inquiry.track_id" | "timbro.dgii.lease_wait" | "timbro.dgii.seed_request" | "timbro.dgii.seed_validate" | "timbro.dgii.submit.complete_ecf" | "timbro.dgii.submit.consumer_summary" | "timbro.inline_drain" | "timbro.operation_terminal" | "timbro.render.printed_representation" | "timbro.sign.complete_document" | "timbro.sign.consumer_summary" | "timbro.sign.dgii_authentication_seed" | "timbro.signer.call" | "timbro.vault.get.printed_representation" | "timbro.vault.get.signed_complete_document" | "timbro.vault.get.signed_consumer_summary" | "timbro.vault.put.printed_representation" | "timbro.vault.put.signed_complete_document" | "timbro.vault.put.signed_consumer_summary" | "timbro.vault.verify.printed_representation" | "timbro.vault.verify.signed_complete_document" | "timbro.vault.verify.signed_consumer_summary" | "timbro.webhook.authority_accepted" | "timbro.webhook.authority_accepted_with_findings" | "timbro.webhook.authority_rejected" | "timbro.webhook.commercially_accepted" | "timbro.webhook.commercially_rejected" | "timbro.webhook.fiscal_document.artifacts_updated" | "timbro.webhook.fiscal_document.ready" | "timbro.webhook.intervention_required" | "timbro.webhook.processing" | "timbro.webhook.rejected" | "timbro.webhook.submission_outcome_unknown" | "timbro.work.claim" | "timbro.work.pickup")[];
+export declare function getFiscalOperationTimingResource(client: Client, fiscalOperationId: string, signal: AbortSignal | undefined): Promise<FiscalOperationTimingReport | undefined>;
+//# sourceMappingURL=fiscal-operation-timing.d.ts.map

package/dist/fiscal-operation-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-operation-timing.d.ts","sourceRoot":"","sources":["../src/fiscal-operation-timing.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,2BAA2B,IAAI,oCAAoC,EAEzE,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAgB,MAAM,kBAAkB,CAAC;AAExE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,MAAM,2BAA2B,GAAG,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;AAElG,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,olDAAyB,CAAC;AAEvD,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAoBlD"}

package/dist/fiscal-operation-timing.js

@@ -0,0 +1,22 @@
+import { validateIdentity } from "./fiscal-operation.js";
+import { readFiscalOperationTiming, } from "./generated/index.js";
+import { zTimingStageId } from "./generated/zod.gen.js";
+import { isExpectedNotFoundProblem, throwGeneratedProblem } from "./generated-problem.js";
+import { toPublicCase } from "./public-case.js";
+/** Every stage id the operation timing contract publishes. */
+export const TIMING_STAGE_IDS = zTimingStageId.options;
+export async function getFiscalOperationTimingResource(client, fiscalOperationId, signal) {
+    validateIdentity(fiscalOperationId, "fiscalOperationId");
+    const response = await readFiscalOperationTiming({
+        client,
+        path: { operation_id: fiscalOperationId },
+        ...(signal === undefined ? {} : { signal }),
+    });
+    if (isExpectedNotFoundProblem(response, "fiscal_operation_not_found", "Fiscal operation timing lookup failed")) {
+        return;
+    }
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal operation timing lookup failed");
+    }
+    return toPublicCase(response.body);
+}

package/dist/fiscal-operation.d.ts

@@ -0,0 +1,112 @@
+import { type FiscalEnvironment, type FiscalIntent, type SourceFiscalOperationPage as GeneratedFiscalOperationPage, type FiscalOperationResource as GeneratedFiscalOperationResource, type SourceType31Snapshot as GeneratedSourceType31Snapshot, type SourceType32Snapshot as GeneratedSourceType32Snapshot, type SourceType33Snapshot as GeneratedSourceType33Snapshot, type SourceType34Snapshot as GeneratedSourceType34Snapshot, type SourceType41Snapshot as GeneratedSourceType41Snapshot, type SourceType43Snapshot as GeneratedSourceType43Snapshot, type SourceType44Snapshot as GeneratedSourceType44Snapshot, type SourceType45Snapshot as GeneratedSourceType45Snapshot, type SourceType46Snapshot as GeneratedSourceType46Snapshot, type SourceType47Snapshot as GeneratedSourceType47Snapshot, type PrintedRepresentationProfile } from "./generated/index.ts";
+import type { Client } from "./generated-operation-client.ts";
+import { type ReadonlyCamelCase } from "./public-case.ts";
+export type FiscalSource = {
+    readonly id: string;
+    readonly version: string;
+};
+export type SourceType31Snapshot = ReadonlyCamelCase<GeneratedSourceType31Snapshot>;
+export type SourceType32Snapshot = ReadonlyCamelCase<GeneratedSourceType32Snapshot>;
+export type SourceType33Snapshot = ReadonlyCamelCase<GeneratedSourceType33Snapshot>;
+export type SourceType34Snapshot = ReadonlyCamelCase<GeneratedSourceType34Snapshot>;
+export type SourceType41Snapshot = ReadonlyCamelCase<GeneratedSourceType41Snapshot>;
+export type SourceType43Snapshot = ReadonlyCamelCase<GeneratedSourceType43Snapshot>;
+export type SourceType44Snapshot = ReadonlyCamelCase<GeneratedSourceType44Snapshot>;
+export type SourceType45Snapshot = ReadonlyCamelCase<GeneratedSourceType45Snapshot>;
+export type SourceType46Snapshot = ReadonlyCamelCase<GeneratedSourceType46Snapshot>;
+export type SourceType47Snapshot = ReadonlyCamelCase<GeneratedSourceType47Snapshot>;
+/** One caller-owned immutable document snapshot for every supported e-CF family. */
+export type FiscalDocument = {
+    readonly kind: "type31";
+    readonly snapshot: SourceType31Snapshot;
+} | {
+    readonly kind: "type32";
+    readonly snapshot: SourceType32Snapshot;
+} | {
+    readonly kind: "type33";
+    readonly snapshot: SourceType33Snapshot;
+} | {
+    readonly kind: "type34";
+    readonly snapshot: SourceType34Snapshot;
+} | {
+    readonly kind: "type41";
+    readonly snapshot: SourceType41Snapshot;
+} | {
+    readonly kind: "type43";
+    readonly snapshot: SourceType43Snapshot;
+} | {
+    readonly kind: "type44";
+    readonly snapshot: SourceType44Snapshot;
+} | {
+    readonly kind: "type45";
+    readonly snapshot: SourceType45Snapshot;
+} | {
+    readonly kind: "type46";
+    readonly snapshot: SourceType46Snapshot;
+} | {
+    readonly kind: "type47";
+    readonly snapshot: SourceType47Snapshot;
+};
+/** Wraps one generated Fiscal intent as a caller-owned immutable Source snapshot. */
+export declare function toFiscalDocumentSnapshot(intent: FiscalIntent): FiscalDocument;
+export type FiscalOriginalSource = FiscalSource;
+export type FiscalDocumentNumberingInstruction = {
+    readonly kind: "centralAssignment";
+} | {
+    readonly fiscalNumber: string;
+    readonly kind: "externalAssignment";
+    readonly sequenceExpiresOn?: string | null;
+};
+export type FiscalDocumentAction = {
+    readonly kind: "issue";
+} | {
+    readonly affectedFiscalOperationId: string;
+    readonly correction: "cancel" | "correctText" | "correctAmounts";
+    readonly kind: "creditNote";
+    readonly originalSource: FiscalOriginalSource;
+    readonly reason: string;
+} | {
+    readonly affectedFiscalOperationId: string;
+    readonly correction: "correctText" | "correctAmounts";
+    readonly kind: "debitNote";
+    readonly originalSource: FiscalOriginalSource;
+    readonly reason: string;
+};
+type FiscalDocumentCommandFields = {
+    /** Timbro assigns from the verified central range when omitted. */
+    readonly numberingInstruction?: FiscalDocumentNumberingInstruction;
+    readonly printedRepresentation: {
+        readonly profile: PrintedRepresentationProfile;
+    };
+    readonly signal?: AbortSignal;
+    readonly source: FiscalSource;
+};
+export type FiscalDocumentIssueCommand = FiscalDocumentCommandFields & {
+    readonly action?: FiscalDocumentAction;
+    readonly predecessorOperationId?: string;
+    readonly document: FiscalDocument;
+    readonly hosted?: HostedFiscalTenant;
+};
+/** The hosted Checkout tenant and Fiscal environment a first-party service submits through. */
+export type HostedFiscalTenant = {
+    readonly checkoutTenantId: string;
+    readonly environment: FiscalEnvironment;
+};
+export type FiscalDocumentListCommand = {
+    readonly cursor?: string;
+    readonly limit?: number;
+    readonly signal?: AbortSignal;
+};
+export type FiscalOperationResource = Omit<ReadonlyCamelCase<GeneratedFiscalOperationResource>, "id"> & {
+    readonly fiscalOperationId: string;
+};
+export type FiscalDocumentPage = Omit<ReadonlyCamelCase<GeneratedFiscalOperationPage>, "data"> & {
+    readonly data: readonly FiscalOperationResource[];
+};
+export declare function issueFiscalDocumentResource(client: Client, command: FiscalDocumentIssueCommand): Promise<FiscalOperationResource>;
+export declare function listFiscalOperationResources(client: Client, command?: FiscalDocumentListCommand): Promise<FiscalDocumentPage>;
+export declare function getFiscalOperationResource(client: Client, fiscalOperationId: string, signal: AbortSignal | undefined): Promise<FiscalOperationResource | undefined>;
+export declare function findFiscalOperationBySourceResource(client: Client, source: FiscalSource, hosted: HostedFiscalTenant | undefined, signal: AbortSignal | undefined): Promise<FiscalOperationResource | undefined>;
+export declare function validateIdentity(identity: string, name: string): void;
+export {};
+//# sourceMappingURL=fiscal-operation.d.ts.map

package/dist/fiscal-operation.d.ts.map

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

package/dist/fiscal-operation.js

@@ -0,0 +1,193 @@
+import { createFiscalOperation, findFiscalOperation, findFiscalOperationBySource, listFiscalOperations, zFiscalOperationSubmission, zSourceFiscalOperationRequest, } from "./generated/index.js";
+import { isExpectedNotFoundProblem, throwGeneratedProblem } from "./generated-problem.js";
+import { toPublicCase, toWireCase } from "./public-case.js";
+import { validateSource } from "./source-command-validation.js";
+/** Wraps one generated Fiscal intent as a caller-owned immutable Source snapshot. */
+export function toFiscalDocumentSnapshot(intent) {
+    const { document_type: _documentType, issuer: _issuer, issued_on: _issuedOn, signed_at: _signedAt, schema_version: _schemaVersion, ...snapshot } = intent;
+    return toPublicCase({
+        kind: `type${intent.document_type}`,
+        snapshot,
+    });
+}
+async function createFiscalOperationResource(client, command) {
+    validateSource(command.source);
+    const body = toFiscalOperationSubmission(command);
+    const response = await createFiscalOperation({
+        client,
+        body,
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    switch (response.status) {
+        case 200:
+        case 202:
+            return toFiscalOperationResource(response.body);
+        default:
+            throwGeneratedProblem(response, "Fiscal operation creation failed");
+    }
+}
+export function issueFiscalDocumentResource(client, command) {
+    return createFiscalOperationResource(client, command);
+}
+export async function listFiscalOperationResources(client, command = {}) {
+    const response = await listFiscalOperations({
+        client,
+        ...(command.cursor === undefined && command.limit === undefined
+            ? {}
+            : { query: { cursor: command.cursor, limit: command.limit } }),
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal operation listing failed");
+    }
+    return toFiscalDocumentPage(response.body);
+}
+export async function getFiscalOperationResource(client, fiscalOperationId, signal) {
+    const response = await requestFiscalOperation(client, fiscalOperationId, signal);
+    if (isExpectedNotFoundProblem(response, "fiscal_operation_not_found", "Fiscal operation lookup failed")) {
+        return;
+    }
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal operation lookup failed");
+    }
+    return toFiscalOperationResource(response.body);
+}
+function requestFiscalOperation(client, fiscalOperationId, signal) {
+    validateIdentity(fiscalOperationId, "fiscalOperationId");
+    return findFiscalOperation({
+        client,
+        path: { operation_id: fiscalOperationId },
+        ...(signal === undefined ? {} : { signal }),
+    });
+}
+export async function findFiscalOperationBySourceResource(client, source, hosted, signal) {
+    validateSource(source);
+    const response = await findFiscalOperationBySource({
+        client,
+        path: { source_id: source.id, source_version: source.version },
+        ...(hosted === undefined
+            ? {}
+            : {
+                query: {
+                    checkout_tenant_id: hosted.checkoutTenantId,
+                    environment: hosted.environment,
+                },
+            }),
+        ...(signal === undefined ? {} : { signal }),
+    });
+    if (isExpectedNotFoundProblem(response, "fiscal_operation_not_found", "Fiscal operation source lookup failed")) {
+        return;
+    }
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal operation source lookup failed");
+    }
+    return toFiscalOperationResource(response.body);
+}
+function toSourceFiscalOperationRequest(command) {
+    const parsed = zSourceFiscalOperationRequest.safeParse({
+        action: toWireAction(command.action ?? { kind: "issue" }),
+        document: toWireCase(command.document),
+        printed_representation_profile: command.printedRepresentation.profile,
+        numbering_instruction: toWireNumberingInstruction(command.numberingInstruction),
+        id: command.source.id,
+        version: command.source.version,
+        ...(command.predecessorOperationId === undefined
+            ? {}
+            : { predecessor_operation_id: command.predecessorOperationId }),
+    });
+    if (!parsed.success) {
+        throw new TypeError("the Source Fiscal operation command does not satisfy Timbro's contract");
+    }
+    return parsed.data;
+}
+function toFiscalOperationSubmission(command) {
+    const request = toSourceFiscalOperationRequest(command);
+    if (command.hosted === undefined) {
+        return request;
+    }
+    const parsed = zFiscalOperationSubmission.safeParse({
+        checkout_tenant_id: command.hosted.checkoutTenantId,
+        environment: command.hosted.environment,
+        request,
+    });
+    if (!parsed.success) {
+        throw new TypeError("the hosted Fiscal operation submission does not satisfy Timbro's contract");
+    }
+    return parsed.data;
+}
+function toWireNumberingInstruction(numberingInstruction) {
+    if (numberingInstruction === undefined || numberingInstruction.kind === "centralAssignment") {
+        return { kind: "central_assignment" };
+    }
+    return {
+        fiscal_number: numberingInstruction.fiscalNumber,
+        kind: "external_assignment",
+        sequence_expires_on: numberingInstruction.sequenceExpiresOn ?? null,
+    };
+}
+function toWireAction(action) {
+    switch (action.kind) {
+        case "issue":
+            return { kind: "issue" };
+        case "creditNote":
+            return {
+                affected_fiscal_operation_id: action.affectedFiscalOperationId,
+                correction: toWireCreditCorrection(action.correction),
+                kind: "credit_note",
+                original_source: action.originalSource,
+                reason: action.reason,
+            };
+        case "debitNote":
+            return {
+                affected_fiscal_operation_id: action.affectedFiscalOperationId,
+                correction: toWireDebitCorrection(action.correction),
+                kind: "debit_note",
+                original_source: action.originalSource,
+                reason: action.reason,
+            };
+        default:
+            throw new Error("the Fiscal operation action vocabulary is incomplete");
+    }
+}
+function toWireCreditCorrection(correction) {
+    switch (correction) {
+        case "cancel":
+            return "cancel";
+        case "correctText":
+            return "correct_text";
+        case "correctAmounts":
+            return "correct_amounts";
+        default:
+            throw new Error("the credit-note correction vocabulary is incomplete");
+    }
+}
+function toWireDebitCorrection(correction) {
+    switch (correction) {
+        case "correctText":
+            return "correct_text";
+        case "correctAmounts":
+            return "correct_amounts";
+        default:
+            throw new Error("the debit-note correction vocabulary is incomplete");
+    }
+}
+function toFiscalOperationResource(resource) {
+    const publicResource = toPublicCase(resource);
+    const { id, ...rest } = publicResource;
+    return {
+        ...rest,
+        fiscalOperationId: id,
+    };
+}
+function toFiscalDocumentPage(page) {
+    const publicPage = toPublicCase(page);
+    return {
+        ...publicPage,
+        data: page.data.map(toFiscalOperationResource),
+    };
+}
+export function validateIdentity(identity, name) {
+    if (identity.trim() === "") {
+        throw new TypeError(`${name} must not be blank`);
+    }
+}

package/dist/fiscal-receipt.d.ts

@@ -0,0 +1,19 @@
+import { type FiscalReceiptReference as WireReceiptReference, type FiscalReceiptResource as WireReceiptResource } from "./generated/index.ts";
+import { type Client } from "./generated-operation-client.ts";
+import { type PrintedRepresentationDownload } from "./printed-representation.ts";
+import { type ReadonlyCamelCase } from "./public-case.ts";
+export type FiscalReceiptReference = ReadonlyCamelCase<WireReceiptReference>;
+export type FiscalReceiptResource = ReadonlyCamelCase<WireReceiptResource>;
+export type FiscalReceiptCommand = {
+    readonly receipt: FiscalReceiptReference;
+    readonly signal?: AbortSignal;
+};
+type ReceiptTransportOptions = {
+    readonly baseUrl: string;
+    readonly fetch?: typeof globalThis.fetch;
+};
+export declare function shareFiscalReceiptResource(client: Client, fiscalOperationId: string, signal: AbortSignal | undefined): Promise<FiscalReceiptReference>;
+export declare function getFiscalReceiptResource(options: ReceiptTransportOptions, command: FiscalReceiptCommand): Promise<FiscalReceiptResource | undefined>;
+export declare function downloadFiscalReceiptPrintedRepresentation(options: ReceiptTransportOptions, command: FiscalReceiptCommand): Promise<PrintedRepresentationDownload>;
+export {};
+//# sourceMappingURL=fiscal-receipt.d.ts.map

package/dist/fiscal-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal-receipt.d.ts","sourceRoot":"","sources":["../src/fiscal-receipt.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,sBAAsB,IAAI,oBAAoB,EACnD,KAAK,qBAAqB,IAAI,mBAAmB,EAElD,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,MAAM,EAAkC,MAAM,iCAAiC,CAAC;AAE9F,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,iBAAiB,EAA4B,MAAM,kBAAkB,CAAC;AAGpF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C,CAAC;AAEF,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAwB5C;AAED,wBAAsB,0CAA0C,CAC9D,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,6BAA6B,CAAC,CAUxC"}

package/dist/fiscal-receipt.js

@@ -0,0 +1,66 @@
+import { FiscalError } from "./fiscal-error.js";
+import { retrieveFiscalReceipt, retrieveFiscalReceiptPrintedRepresentation, shareFiscalReceipt, zFiscalReceiptReference, } from "./generated/index.js";
+import { createGeneratedOperationClient } from "./generated-operation-client.js";
+import { isExpectedNotFoundProblem, throwGeneratedProblem } from "./generated-problem.js";
+import { decodePrintedRepresentation, } from "./printed-representation.js";
+import { toPublicCase, toWireCase } from "./public-case.js";
+import { createStampServerHttpTransport } from "./stamp-server-http-transport.js";
+export async function shareFiscalReceiptResource(client, fiscalOperationId, signal) {
+    if (fiscalOperationId.trim() === "") {
+        throw new TypeError("fiscalOperationId must not be blank");
+    }
+    const response = await shareFiscalReceipt({
+        client,
+        path: { operation_id: fiscalOperationId },
+        ...(signal === undefined ? {} : { signal }),
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal receipt sharing failed");
+    }
+    if (response.body.fiscal_operation_id.toLowerCase() !== fiscalOperationId.toLowerCase()) {
+        throw new FiscalError("Timbro returned a receipt for another Fiscal operation", {
+            failure: "server_processing",
+        });
+    }
+    return toPublicCase(response.body);
+}
+export async function getFiscalReceiptResource(options, command) {
+    const response = await retrieveFiscalReceipt({
+        client: receiptClient(options, command.receipt),
+        path: { receipt_id: command.receipt.id },
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (isExpectedNotFoundProblem(response, "fiscal_receipt_not_found", "Fiscal receipt lookup failed")) {
+        return;
+    }
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal receipt lookup failed");
+    }
+    if (response.body.id.toLowerCase() !== command.receipt.id.toLowerCase() ||
+        response.body.fiscal_operation_id.toLowerCase() !==
+            command.receipt.fiscalOperationId.toLowerCase()) {
+        throw new FiscalError("Timbro returned another shared receipt", {
+            failure: "server_processing",
+        });
+    }
+    return toPublicCase(response.body);
+}
+export async function downloadFiscalReceiptPrintedRepresentation(options, command) {
+    const response = await retrieveFiscalReceiptPrintedRepresentation({
+        client: receiptClient(options, command.receipt),
+        path: { receipt_id: command.receipt.id },
+        ...(command.signal === undefined ? {} : { signal: command.signal }),
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Fiscal receipt PDF download failed");
+    }
+    return decodePrintedRepresentation(response, command.receipt.fiscalOperationId);
+}
+function receiptClient(options, receipt) {
+    const wire = zFiscalReceiptReference.parse(toWireCase(receipt));
+    return createGeneratedOperationClient(createStampServerHttpTransport({
+        stampServerOrigin: options.baseUrl,
+        authentication: { mode: "bearer", token: () => wire.access_token },
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+    }));
+}