@12-apps/fiscal 1.5.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +46 -4
- package/dist/{chunk-HMTPJWXM.js → chunk-2JVTHJAU.js} +2 -2
- package/dist/{chunk-3E3NBXSW.js → chunk-CEK2GDRY.js} +5 -3
- package/dist/chunk-CEK2GDRY.js.map +1 -0
- package/dist/{chunk-MGTROA7K.js → chunk-OAQSGDZ7.js} +11 -7
- package/dist/chunk-OAQSGDZ7.js.map +1 -0
- package/dist/{chunk-G6QNU4FD.js → chunk-P7CRGZGO.js} +2 -2
- package/dist/{chunk-H33BK623.js → chunk-WRYCYXRA.js} +1 -1
- package/dist/{chunk-H33BK623.js.map → chunk-WRYCYXRA.js.map} +1 -1
- package/dist/{chunk-TJCUO6D6.js → chunk-YHSO3476.js} +6 -5
- package/dist/chunk-YHSO3476.js.map +1 -0
- package/dist/{context-CwZiHLnY.d.ts → context-Cyvfr2YB.d.ts} +155 -19
- package/dist/danfe/index.d.ts +7 -0
- package/dist/danfe/index.js +2 -2
- package/dist/documents/index.d.ts +152 -34
- package/dist/documents/index.js +1103 -305
- package/dist/documents/index.js.map +1 -1
- package/dist/engine/index.d.ts +2 -2
- package/dist/http.d.ts +6 -5
- package/dist/http.js +4 -4
- package/dist/issuer/index.d.ts +10 -3
- package/dist/issuer/index.js +18 -3
- package/dist/issuer/index.js.map +1 -1
- package/dist/jobs.d.ts +5 -5
- package/dist/jobs.js +3 -3
- package/dist/manifest/index.d.ts +6 -4
- package/dist/manifest/index.js.map +1 -1
- package/dist/manifest/server.d.ts +5 -5
- package/dist/manifest/server.js +6 -6
- package/dist/notifications.d.ts +4 -4
- package/dist/notifications.js +2 -2
- package/dist/{service-Cz2O84Xr.d.ts → service-BCK9aXop.d.ts} +64 -5
- package/dist/sidecar/index.d.ts +38 -249
- package/dist/sidecar/index.js +29 -1
- package/dist/sidecar/index.js.map +1 -1
- package/dist/{types-B1b8LIWX.d.ts → types-BLdkww6G.d.ts} +1 -1
- package/dist/{types-DSYwap42.d.ts → types-Sk010Em2.d.ts} +2 -2
- package/dist/types-Z5E14EPw.d.ts +254 -0
- package/package.json +2 -1
- package/prisma/fiscal.prisma +50 -1
- package/prisma/migrations/20261118180000_fiscal_contingency_blocks/migration.sql +64 -0
- package/sidecar/README.md +52 -1
- package/sidecar/bin/check-platform.php +29 -0
- package/sidecar/extensions.json +12 -0
- package/sidecar/src/Http/Request.php +6 -1
- package/sidecar/src/Kernel.php +39 -1
- package/sidecar/src/Platform.php +84 -0
- package/src/danfe/render.ts +16 -5
- package/src/documents/contingency-gaps.ts +88 -0
- package/src/documents/contingency-pass.ts +157 -0
- package/src/documents/contingency-xml.ts +136 -0
- package/src/documents/contingency.ts +257 -0
- package/src/documents/errors.ts +8 -1
- package/src/documents/helpers.ts +3 -0
- package/src/documents/index.ts +23 -1
- package/src/documents/memory-blocks.ts +118 -0
- package/src/documents/memory.ts +6 -2
- package/src/documents/ports.ts +163 -13
- package/src/documents/service.ts +10 -0
- package/src/documents/sql-blocks.ts +202 -0
- package/src/documents/sql-store.ts +4 -3
- package/src/http.ts +1 -0
- package/src/issuer/sidecar.ts +27 -3
- package/src/manifest/index.ts +6 -4
- package/src/sidecar/index.ts +2 -0
- package/src/sidecar/platform.ts +55 -0
- package/dist/chunk-3E3NBXSW.js.map +0 -1
- package/dist/chunk-MGTROA7K.js.map +0 -1
- package/dist/chunk-TJCUO6D6.js.map +0 -1
- /package/dist/{chunk-HMTPJWXM.js.map → chunk-2JVTHJAU.js.map} +0 -0
- /package/dist/{chunk-G6QNU4FD.js.map → chunk-P7CRGZGO.js.map} +0 -0
package/src/manifest/index.ts
CHANGED
|
@@ -20,10 +20,12 @@
|
|
|
20
20
|
* list are built with their screen tickets (FUT-2231, FUT-2238) from the
|
|
21
21
|
* owner's approved prototypes, over these routes.
|
|
22
22
|
* - **No NFS-e.** Only the platform's own NFS-e is planned (FUT-2242).
|
|
23
|
-
* - **No register
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
23
|
+
* - **No register-block routes or job.** Contingency blocks are implemented
|
|
24
|
+
* (FUT-4717): `createFiscalDocuments` is the `ContingencyBlockSource`
|
|
25
|
+
* (reserve, record a signed note, close, abandon) and runs the gap pass
|
|
26
|
+
* (`voidKnownGaps`, `listUnknownRanges`). The host wires them: the routes a
|
|
27
|
+
* register calls, the monthly void job, and the store's flag of unknown
|
|
28
|
+
* ranges.
|
|
27
29
|
*
|
|
28
30
|
* `@12-apps/wiring` is a TYPE-ONLY dependency: the manifest is a plain
|
|
29
31
|
* `satisfies`-checked value, and the producer's assertions run in this
|
package/src/sidecar/index.ts
CHANGED
|
@@ -6,4 +6,6 @@
|
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
8
|
export { SIDECAR_ERROR_CLASSES } from "./types";
|
|
9
|
+
export { SIDECAR_PHP_EXTENSIONS, SIDECAR_PHP_LAUNCH_FLAGS, SIDECAR_PHP_SETTINGS, SIDECAR_PHP_VERSION } from "./platform";
|
|
10
|
+
export type { SidecarPhpExtension } from "./platform";
|
|
9
11
|
export type * from "./types";
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What a PHP must carry to run the fiscal service outside its Docker image
|
|
3
|
+
* (FUT-4717: a desktop install bundles a static PHP): the minor version and
|
|
4
|
+
* the extensions, the same list as `sidecar/extensions.json`
|
|
5
|
+
* (`@12-apps/fiscal/sidecar/extensions.json`), which `sidecar/bin/check-platform.php`
|
|
6
|
+
* checks a PHP against and a PHPUnit test keeps equal to every `ext-*` the
|
|
7
|
+
* service and its locked libraries require. A test keeps this copy equal to
|
|
8
|
+
* the file.
|
|
9
|
+
*
|
|
10
|
+
* Launch it bound to the loopback only, with a token minted per launch and
|
|
11
|
+
* the image's safety settings as `-d` flags ({@link SIDECAR_PHP_LAUNCH_FLAGS}):
|
|
12
|
+
*
|
|
13
|
+
* ```sh
|
|
14
|
+
* FISCAL_SIDECAR_TOKEN=<random, 32+ chars> php -d display_errors=0 -d log_errors=1 \
|
|
15
|
+
* -d zend.exception_ignore_args=1 -d zend.exception_string_param_max_len=0 -d file_uploads=0 \
|
|
16
|
+
* -S 127.0.0.1:<port> -t sidecar/public sidecar/public/index.php
|
|
17
|
+
* ```
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
export const SIDECAR_PHP_VERSION = "8.3";
|
|
21
|
+
|
|
22
|
+
export const SIDECAR_PHP_EXTENSIONS = [
|
|
23
|
+
"curl",
|
|
24
|
+
"dom",
|
|
25
|
+
"filter",
|
|
26
|
+
"json",
|
|
27
|
+
"libxml",
|
|
28
|
+
"mbstring",
|
|
29
|
+
"openssl",
|
|
30
|
+
"reflection",
|
|
31
|
+
"simplexml",
|
|
32
|
+
"soap",
|
|
33
|
+
"zlib",
|
|
34
|
+
] as const;
|
|
35
|
+
|
|
36
|
+
export type SidecarPhpExtension = (typeof SIDECAR_PHP_EXTENSIONS)[number];
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* What the image's `docker/php.ini` guarantees, which a bundled PHP gets only
|
|
40
|
+
* from its launch line (`extensions.json`'s `ini`): no error printed into a
|
|
41
|
+
* response (the issuer would read it as an unanswered call), a stack trace
|
|
42
|
+
* with no arguments (a password, a certificate, the launch token), no upload
|
|
43
|
+
* spooled to disk. `-d` flags, not `-c docker/php.ini`: that file logs to
|
|
44
|
+
* `/dev/stderr`, which a Windows desktop does not have.
|
|
45
|
+
*/
|
|
46
|
+
export const SIDECAR_PHP_SETTINGS = {
|
|
47
|
+
display_errors: "0",
|
|
48
|
+
log_errors: "1",
|
|
49
|
+
"zend.exception_ignore_args": "1",
|
|
50
|
+
"zend.exception_string_param_max_len": "0",
|
|
51
|
+
file_uploads: "0",
|
|
52
|
+
} as const;
|
|
53
|
+
|
|
54
|
+
/** {@link SIDECAR_PHP_SETTINGS} as the argv a launcher puts before `-S` (and before `bin/check-platform.php`). */
|
|
55
|
+
export const SIDECAR_PHP_LAUNCH_FLAGS: readonly string[] = Object.entries(SIDECAR_PHP_SETTINGS).flatMap(([name, value]) => ["-d", `${name}=${value}`]);
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/documents/machine-steps.ts","../src/documents/machine.ts","../src/documents/helpers.ts","../src/documents/context.ts"],"sourcesContent":["/**\n * What each input does to a document's fields — the state machine's body\n * (`./machine` holds its table and its one entry point). Pure functions; a\n * refusal throws `TRANSITION_REFUSED`.\n */\n\nimport type {\n CancelledDocument,\n ContingencyEntry,\n ContingencySignedDocument,\n InutilizedRange,\n IssuedDocument,\n LookedUpDocument,\n RegisteredPaymentLink,\n SidecarErrorBody,\n} from \"../sidecar/types\";\nimport type { LinkedTransaction, SaleForDocument } from \"../sale/types\";\nimport { FiscalDocumentError } from \"./errors\";\nimport { type DocumentEventKind, type DocumentTotals, type FiscalDocument, type NumberVoid, isLive } from \"./types\";\n\nexport type SidecarError = SidecarErrorBody[\"error\"];\n\n/** Failures in a row after which a document waits for a person. */\nexport const MAX_FAILURES = 8;\n\n/** What the machine is fed. Each carries the service's answer, which the event keeps. */\nexport type DocumentInput =\n | { readonly kind: \"SUBMIT\" }\n | { readonly kind: \"AUTHORIZE\"; readonly answer: IssuedDocument; readonly xmlKey: string }\n | { readonly kind: \"DENY\"; readonly answer: IssuedDocument; readonly xmlKey: string }\n | { readonly kind: \"REJECT\"; readonly error: SidecarError }\n /** `xmlKey`: where the signed XML the failed call returned was stored, when it returned one. */\n | { readonly kind: \"RETRY\"; readonly error: SidecarError; readonly xmlKey?: string }\n | {\n readonly kind: \"SIGN_OFFLINE\";\n readonly answer: ContingencySignedDocument;\n readonly contingency: ContingencyEntry;\n readonly xmlKey: string;\n }\n | { readonly kind: \"REPLACE\"; readonly replacedById: string }\n | { readonly kind: \"CANCEL\"; readonly answer: CancelledDocument; readonly reason: string; readonly eventXmlKey: string | null }\n /**\n * `xmlKey`: the `nfeProc` assembled from the stored signed XML and the\n * lookup's protocol. Without it a lookup never makes a SUBMITTED document\n * final: an authorised document always has its XML.\n */\n | { readonly kind: \"LOOKUP\"; readonly answer: LookedUpDocument; readonly xmlKey?: string }\n | { readonly kind: \"INUTILIZE\"; readonly answer: InutilizedRange; readonly eventXmlKey: string | null }\n /**\n * A step that made no progress (a settlement refused or unanswered, a step\n * that threw). It counts a failure; `attention` hands the document to a\n * person at once (SEFAZ refused it: retrying would only repeat the refusal).\n */\n | { readonly kind: \"DEFER\"; readonly reason: string; readonly error: SidecarError | null; readonly attention: boolean }\n /** A rejected contingency NFC-e, corrected by the store and signed again under the same number. */\n | {\n readonly kind: \"RESIGN\";\n readonly answer: ContingencySignedDocument;\n readonly sale: SaleForDocument;\n readonly totals: DocumentTotals;\n readonly buyerTaxId: string | null;\n readonly xmlKey: string;\n }\n /** A person took a document back from `attention`: the sweep may try again. */\n | { readonly kind: \"RELEASE\" }\n /** The 24-hour contingency deadline warning went out. */\n | { readonly kind: \"WARN\" }\n /** SEFAZ registered the event 110300 #`sequence` linking `payment` to the document; its XML is at `eventXmlKey`. */\n | {\n readonly kind: \"LINK_PAYMENT\";\n readonly answer: RegisteredPaymentLink;\n readonly payment: LinkedTransaction;\n readonly sequence: number;\n readonly eventXmlKey: string | null;\n };\n\ntype InputOf<K extends DocumentEventKind> = Extract<DocumentInput, { kind: K }>;\ntype Step = { readonly [K in DocumentEventKind]: (document: FiscalDocument, input: InputOf<K>) => Partial<FiscalDocument> };\n\nexport function refuse(document: FiscalDocument, kind: DocumentEventKind, why: string): never {\n throw new FiscalDocumentError(\n \"TRANSITION_REFUSED\",\n `${kind} is refused on document ${document.id} in ${document.status}: ${why}.`,\n );\n}\n\n/** Progress: the failure count, the person's flag and the unknown outcome are settled. */\nconst SETTLED = { failures: 0, attention: false } as const;\n\nfunction issuedFields(answer: IssuedDocument, xmlKey: string): Partial<FiscalDocument> {\n return {\n ...SETTLED,\n accessKey: answer.accessKey,\n protocol: answer.protocol,\n authorizedAt: answer.authorizedAt,\n statusCode: answer.statusCode,\n statusReason: answer.statusReason,\n lastErrorClass: null,\n outcomeUnknown: false,\n xmlKey,\n };\n}\n\n/**\n * A failed call. `outcomeUnknown` is STICKY: once a request may have reached\n * SEFAZ unanswered, only a definitive answer or a lookup clears it — a later\n * \"nothing was sent this time\" says nothing about the first send.\n */\nfunction failedFields(document: FiscalDocument, error: SidecarError): Partial<FiscalDocument> {\n return {\n accessKey: document.accessKey ?? error.accessKey,\n statusCode: error.code,\n statusReason: error.message,\n lastErrorClass: error.class,\n outcomeUnknown: document.outcomeUnknown || error.outcomeUnknown,\n };\n}\n\nfunction failure(document: FiscalDocument, attention: boolean): Partial<FiscalDocument> {\n const failures = document.failures + 1;\n return { failures, attention: attention || failures >= MAX_FAILURES };\n}\n\n/** What a lookup says is owed on a number SEFAZ may hold. */\nfunction voidAfterLookup(answer: LookedUpDocument): NumberVoid {\n if (answer.status === \"AUTHORIZED\") return \"CANCEL\";\n if (answer.status === \"CANCELLED\") return \"CANCELLED\";\n if (answer.status === \"DENIED\") return \"DENIED\";\n return \"INUTILIZE\";\n}\n\nfunction lookupOfSettledNumber(document: FiscalDocument, answer: LookedUpDocument): Partial<FiscalDocument> {\n if (document.numberVoid !== \"LOOKUP_FIRST\") refuse(document, \"LOOKUP\", \"its number is already settled\");\n if (isLive(document) && (answer.status === \"AUTHORIZED\" || answer.status === \"DENIED\")) {\n // The sale's own document, still SEFAZ's: never cancelled, never voided,\n // never left REJECTED. It goes back to SUBMITTED, owing work, with the\n // protocol kept — the next step settles it with its XML (the service does\n // at once when it holds the XML the protocol certifies; otherwise the\n // sweep sends the same call again, which the fiscal service settles).\n // Its failures keep counting, so a loop of refusals reaches a person.\n return {\n status: \"SUBMITTED\",\n numberVoid: null,\n outcomeUnknown: false,\n protocol: answer.protocol ?? document.protocol,\n statusCode: answer.statusCode,\n statusReason: answer.statusReason,\n };\n }\n return {\n ...SETTLED,\n numberVoid: voidAfterLookup(answer),\n outcomeUnknown: false,\n // The protocol SEFAZ answered is what a cancel of this number must quote.\n protocol: answer.protocol ?? document.protocol,\n statusCode: answer.statusCode,\n statusReason: answer.statusReason,\n };\n}\n\n/**\n * A lookup of a SUBMITTED document. It settles it as AUTHORIZED or DENIED\n * only with the XML in hand (`xmlKey`); otherwise it keeps what SEFAZ said —\n * the protocol marks the number as SEFAZ's — and the document stays\n * SUBMITTED, for the sweep to fetch the XML by sending the same call again.\n */\nfunction lookupOfSubmitted(document: FiscalDocument, answer: LookedUpDocument, xmlKey: string | undefined): Partial<FiscalDocument> {\n const known = { statusCode: answer.statusCode, statusReason: answer.statusReason, outcomeUnknown: false };\n // A key found cancelled elsewhere is left to the next issue call, which the service settles: CANCELLED is entered only from AUTHORIZED.\n const settles = answer.status === \"AUTHORIZED\" || answer.status === \"DENIED\";\n if (!settles || answer.protocol === null || document.accessKey === null) return known;\n if (xmlKey === undefined) return { ...known, protocol: answer.protocol };\n return { ...known, ...SETTLED, status: answer.status, protocol: answer.protocol, lastErrorClass: null, xmlKey };\n}\n\nfunction lookupFields(document: FiscalDocument, answer: LookedUpDocument, xmlKey?: string): Partial<FiscalDocument> {\n if (document.status === \"REPLACED\" || document.status === \"REJECTED\") return lookupOfSettledNumber(document, answer);\n if (document.status === \"SUBMITTED\") return lookupOfSubmitted(document, answer, xmlKey);\n if (answer.status === \"CANCELLED\") return { status: \"CANCELLED\", statusCode: answer.statusCode, statusReason: answer.statusReason };\n return { statusCode: answer.statusCode, statusReason: answer.statusReason };\n}\n\nfunction cancelFields(document: FiscalDocument, input: InputOf<\"CANCEL\">): Partial<FiscalDocument> {\n const recorded = {\n ...SETTLED,\n cancelledAt: input.answer.registeredAt,\n cancelReason: input.reason,\n cancelProtocol: input.answer.protocol,\n eventXmlKey: input.eventXmlKey,\n };\n if (document.status === \"AUTHORIZED\") {\n return { ...recorded, status: \"CANCELLED\", statusCode: input.answer.statusCode, statusReason: input.answer.statusReason };\n }\n if (document.numberVoid !== \"CANCEL\") refuse(document, \"CANCEL\", \"a voided number is cancelled only when found authorised\");\n return { ...recorded, numberVoid: \"CANCELLED\" };\n}\n\n/** A rejected online number may have been authorised by an unanswered first send: look it up first. */\n/**\n * A rejected online number may have been authorised by an unanswered first\n * send — or a lookup already found it authorised (its protocol is kept, and\n * a re-send for the XML met a 704 or a different XML under the key): either\n * way it is looked up, never voided blindly.\n */\nfunction rejectFields(document: FiscalDocument, error: SidecarError): Partial<FiscalDocument> {\n const failed = failedFields(document, error);\n if (document.seriesKind === \"CONTINGENCY\") return { status: \"REJECTED\", ...failed, ...SETTLED, numberVoid: null };\n // Known to be SEFAZ's: a refused re-send is one more failure of the same document, not a settlement.\n if (document.protocol !== null) return { status: \"REJECTED\", ...failed, ...failure(document, false), numberVoid: \"LOOKUP_FIRST\" };\n return { status: \"REJECTED\", ...failed, ...SETTLED, numberVoid: failed.outcomeUnknown === true ? \"LOOKUP_FIRST\" : \"INUTILIZE\" };\n}\n\nexport const STEPS: Step = {\n SUBMIT: () => ({ status: \"SUBMITTED\" }),\n AUTHORIZE: (_document, input) => ({ status: \"AUTHORIZED\", ...issuedFields(input.answer, input.xmlKey) }),\n DENY: (_document, input) => ({ status: \"DENIED\", ...issuedFields(input.answer, input.xmlKey) }),\n REJECT: (document, input) => rejectFields(document, input.error),\n RETRY: (document, input) => ({\n ...failedFields(document, input.error),\n ...failure(document, false),\n ...(input.xmlKey === undefined ? {} : { xmlKey: input.xmlKey }),\n }),\n SIGN_OFFLINE: (document, input) => {\n if (document.seriesKind !== \"CONTINGENCY\") refuse(document, input.kind, \"only a contingency-series number is signed offline\");\n return { ...SETTLED, status: \"CONTINGENCY\", accessKey: input.answer.accessKey, contingency: input.contingency, xmlKey: input.xmlKey };\n },\n REPLACE: (document, input) => ({\n ...SETTLED,\n status: \"REPLACED\",\n replacedById: input.replacedById,\n // A SUBMITTED document may have reached SEFAZ whatever was recorded (a process\n // that died mid-call, a receipt with no protocol yet): its key is always\n // known, so it is looked up before its number is voided. Only a PENDING one\n // was never sent.\n numberVoid: document.status === \"SUBMITTED\" ? \"LOOKUP_FIRST\" : \"INUTILIZE\",\n }),\n CANCEL: cancelFields,\n LOOKUP: (document, input) => lookupFields(document, input.answer, input.xmlKey),\n INUTILIZE: (document, input) => {\n if (document.numberVoid !== \"INUTILIZE\") refuse(document, input.kind, \"its number is not owed an inutilization\");\n return { ...SETTLED, numberVoid: \"INUTILIZED\", eventXmlKey: input.eventXmlKey };\n },\n DEFER: (document, input) => ({\n ...failure(document, input.attention),\n ...(input.error === null ? {} : { lastErrorClass: input.error.class, statusCode: input.error.code }),\n statusReason: input.error?.message ?? input.reason,\n }),\n RESIGN: (document, input) => {\n if (document.seriesKind !== \"CONTINGENCY\") refuse(document, input.kind, \"only a rejected contingency NFC-e is resent\");\n return {\n ...SETTLED,\n status: \"CONTINGENCY\",\n sale: input.sale,\n totals: input.totals,\n buyerTaxId: input.buyerTaxId,\n accessKey: input.answer.accessKey,\n xmlKey: input.xmlKey,\n statusCode: null,\n statusReason: null,\n lastErrorClass: null,\n };\n },\n RELEASE: (document) => {\n if (!document.attention) refuse(document, \"RELEASE\", \"it is not waiting for a person\");\n return SETTLED;\n },\n // `deadlineWarnedAt` is the transition's own time, set by `transition`.\n WARN: () => ({}),\n LINK_PAYMENT: () => ({}),\n};\n","/**\n * The fiscal document state machine: pure functions from a document and one\n * input to the next document and the event that records the step.\n *\n * ```\n * PENDING ──SUBMIT──▶ SUBMITTED ──AUTHORIZE──▶ AUTHORIZED ──CANCEL──▶ CANCELLED\n * │ │ ├──DENY─────▶ DENIED\n * │ │ ├──REJECT───▶ REJECTED\n * │ │ └──RETRY────▶ SUBMITTED\n * │ └──REPLACE──▶ REPLACED\n * ├──REPLACE──▶ REPLACED\n * └──SIGN_OFFLINE──▶ CONTINGENCY ──AUTHORIZE | DENY | REJECT | RETRY──▶ …\n * ▲ REJECTED (contingency) ──RESIGN──┘\n * ```\n *\n * A document is one number, so going offline is a SECOND document on the\n * issuing point's contingency series (`PENDING → CONTINGENCY`), and the first\n * one is `REPLACED`. Every input yields an event; a refused one throws\n * {@link FiscalDocumentError} `TRANSITION_REFUSED` and changes nothing:\n * `CANCELLED` is entered only from `AUTHORIZED`, and `AUTHORIZED` never from a\n * final state. A rejected contingency NFC-e is the one way back: the store\n * corrects it and it is signed again under the same number (`RESIGN`).\n *\n * `LINK_PAYMENT` records an event 110300 SEFAZ registered on an authorised\n * document (a payment transaction linked after the fact); it changes nothing.\n *\n * `DEFER`, `RELEASE` and `WARN` record what the sweep and a person did without\n * changing the state: a failed step counts toward {@link MAX_FAILURES}, after\n * which the document waits for a person (`attention`).\n */\n\nimport { type DocumentInput, STEPS, refuse } from \"./machine-steps\";\nimport type { DocumentEventKind, FiscalDocument, FiscalDocumentEvent, FiscalDocumentStatus } from \"./types\";\n\nexport { MAX_FAILURES } from \"./machine-steps\";\nexport type { DocumentInput } from \"./machine-steps\";\n\nconst ANY: readonly FiscalDocumentStatus[] = [\n \"PENDING\", \"SUBMITTED\", \"AUTHORIZED\", \"REJECTED\", \"DENIED\", \"CONTINGENCY\", \"CANCELLED\", \"REPLACED\",\n];\n\n/** From which states each input is accepted. */\nexport const DOCUMENT_TRANSITIONS: Readonly<Record<DocumentEventKind, readonly FiscalDocumentStatus[]>> = {\n SUBMIT: [\"PENDING\"],\n AUTHORIZE: [\"SUBMITTED\", \"CONTINGENCY\"],\n DENY: [\"SUBMITTED\", \"CONTINGENCY\"],\n REJECT: [\"SUBMITTED\", \"CONTINGENCY\"],\n RETRY: [\"SUBMITTED\", \"CONTINGENCY\"],\n SIGN_OFFLINE: [\"PENDING\"],\n REPLACE: [\"PENDING\", \"SUBMITTED\"],\n CANCEL: [\"AUTHORIZED\", \"REPLACED\", \"REJECTED\"],\n LOOKUP: [\"SUBMITTED\", \"AUTHORIZED\", \"REPLACED\", \"REJECTED\"],\n INUTILIZE: [\"REJECTED\", \"REPLACED\"],\n DEFER: ANY,\n RESIGN: [\"REJECTED\"],\n RELEASE: ANY,\n WARN: [\"CONTINGENCY\"],\n LINK_PAYMENT: [\"AUTHORIZED\"],\n};\n\n/** The states nothing but a lookup, a cancel or an inutilization of the number may follow. */\nexport const FINAL_STATUSES: readonly FiscalDocumentStatus[] = [\"REJECTED\", \"DENIED\", \"CANCELLED\", \"REPLACED\"];\n\nexport interface Transition {\n readonly document: FiscalDocument;\n readonly event: FiscalDocumentEvent;\n}\n\nconst SECRET_KEY = /^(pfx|pfxBase64|password|passphrase|certificate|csc|token|privateKey)$/i;\n\n/**\n * A copy of an answer with every secret-named key dropped. The service never\n * echoes one; this is the second lock, so an event row can never hold one.\n */\nexport function scrubSecrets(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(scrubSecrets);\n if (value === null || typeof value !== \"object\") return value;\n const out: Record<string, unknown> = {};\n for (const [key, inner] of Object.entries(value)) {\n if (!SECRET_KEY.test(key)) out[key] = scrubSecrets(inner);\n }\n return out;\n}\n\nfunction answerOf(input: DocumentInput): unknown {\n if (input.kind === \"LINK_PAYMENT\") {\n return { ...input.answer, payment: input.payment, sequence: input.sequence, eventXmlKey: input.eventXmlKey };\n }\n if (\"answer\" in input) return input.answer;\n if (\"error\" in input && input.error !== null) return { error: input.error };\n if (input.kind === \"DEFER\") return { reason: input.reason };\n return null;\n}\n\nfunction eventOf(document: FiscalDocument, input: DocumentInput, toStatus: FiscalDocumentStatus, at: string): FiscalDocumentEvent {\n const error = \"error\" in input ? input.error : null;\n const answer = \"answer\" in input ? input.answer : null;\n return {\n documentId: document.id,\n kind: input.kind,\n fromStatus: document.status,\n toStatus,\n at,\n errorClass: error?.class ?? null,\n code: error?.code ?? (answer !== null && \"statusCode\" in answer ? answer.statusCode : null),\n answer: scrubSecrets(answerOf(input)),\n };\n}\n\nconst COUNTED = new Set<DocumentEventKind>([\"SUBMIT\", \"RETRY\", \"SIGN_OFFLINE\", \"RESIGN\"]);\n\n/**\n * Apply one input. Throws `TRANSITION_REFUSED` (and changes nothing) when the\n * document's state does not accept it. `at` is the caller's clock, ISO 8601.\n */\nexport function transition(document: FiscalDocument, input: DocumentInput, at: string): Transition {\n if (!DOCUMENT_TRANSITIONS[input.kind].includes(document.status)) {\n refuse(document, input.kind, `accepted only from ${DOCUMENT_TRANSITIONS[input.kind].join(\", \")}`);\n }\n const step = STEPS[input.kind] as (document: FiscalDocument, input: DocumentInput) => Partial<FiscalDocument>;\n const updated: FiscalDocument = {\n ...document,\n ...step(document, input),\n ...(input.kind === \"WARN\" ? { deadlineWarnedAt: at } : {}),\n attempts: document.attempts + (COUNTED.has(input.kind) ? 1 : 0),\n updatedAt: at,\n };\n return { document: updated, event: eventOf(document, input, updated.status, at) };\n}\n\n/** Whether an input would be accepted, without applying it. */\nexport function canTransition(status: FiscalDocumentStatus, kind: DocumentEventKind): boolean {\n return DOCUMENT_TRANSITIONS[kind].includes(status);\n}\n\n","/**\n * The pure helpers the document service builds a document with: the local\n * clock, the key code, the access key, the issuer block, the totals, the\n * storage keys. No port, no state.\n */\n\nimport type { DocumentIssuer, SaleForDocument, Uf } from \"../sale/types\";\nimport { FiscalDocumentError } from \"./errors\";\nimport type { SaleDraft } from \"./ports\";\nimport type { EmitterProfile } from \"./profile\";\nimport type { DocumentTotals, FiscalDocument, FiscalDocumentModel, SeriesKind } from \"./types\";\n\n/** `2026-11-20T12:30:00-03:00`: the instant as the owner's wall clock. */\nexport function localIso(at: Date, offset: string): string {\n const match = /^([+-])(\\d{2}):(\\d{2})$/.exec(offset);\n if (match === null) throw new FiscalDocumentError(\"INVALID_INPUT\", `utcOffset answered \"${offset}\", not ±HH:MM.`);\n const minutes = (match[1] === \"-\" ? -1 : 1) * (Number(match[2]) * 60 + Number(match[3]));\n return `${new Date(at.getTime() + minutes * 60_000).toISOString().slice(0, 19)}${offset}`;\n}\n\nconst UNBIASED_LIMIT = Math.floor(2 ** 32 / 100_000_000) * 100_000_000;\n\n/** `cNF`: eight random digits, never equal to the number's own eight (the layout's rule). */\nexport function drawKeyCode(number: number): string {\n const own = String(number % 100_000_000).padStart(8, \"0\");\n for (;;) {\n const [value] = globalThis.crypto.getRandomValues(new Uint32Array(1));\n // Rejection sampling: values at or above the last whole multiple of 10^8 would bias the low codes.\n if (value === undefined || value >= UNBIASED_LIMIT) continue;\n const code = String(value % 100_000_000).padStart(8, \"0\");\n if (code !== own) return code;\n }\n}\n\nconst FILLED_BY_THE_PACKAGE = new Set([\"series\", \"number\", \"keyCode\", \"issuer\", \"issuedAt\"]);\n\n/** A stored sale back to the draft it was built from (for a second document of the same sale). */\nexport function draftOf(sale: SaleForDocument): SaleDraft {\n return Object.fromEntries(Object.entries(sale).filter(([key]) => !FILLED_BY_THE_PACKAGE.has(key))) as unknown as SaleDraft;\n}\n\nexport function issuerOf(profile: EmitterProfile): DocumentIssuer {\n return {\n cnpj: profile.cnpj,\n stateRegistration: profile.stateRegistration,\n legalName: profile.legalName,\n tradeName: profile.tradeName,\n taxRegime: profile.taxRegime,\n address: profile.address,\n };\n}\n\nexport function totalsOf(sale: SaleDraft): DocumentTotals {\n const sum = (pick: (line: SaleDraft[\"lines\"][number]) => number) => sale.lines.reduce((total, line) => total + pick(line), 0);\n const discountCents = sum((line) => line.discountCents);\n return {\n totalCents: sum((line) => line.valueCents) - discountCents,\n discountCents,\n cbsCents: sum((line) => line.ibsCbs?.figures?.cbsCents ?? 0),\n ibsUfCents: sum((line) => line.ibsCbs?.figures?.ibsUfCents ?? 0),\n ibsMunCents: sum((line) => line.ibsCbs?.figures?.ibsMunCents ?? 0),\n };\n}\n\n/** `text` without any trailing run of `char`, in linear time (no regex backtracking). */\nexport function trimEnd(text: string, char: string): string {\n let end = text.length;\n while (end > 0 && text[end - 1] === char) end -= 1;\n return text.slice(0, end);\n}\n\n/** Storage keys, by access key: one folder per document, whatever its owner. */\nexport const xmlKeys = {\n signed: (accessKey: string) => `fiscal/${accessKey}/signed.xml`,\n /** One signed XML per digest: every XML a failed call returned under a key is kept, none overwritten. */\n signedByDigest: (accessKey: string, digest: string) =>\n `fiscal/${accessKey}/signed-${trimEnd(digest.replace(/\\+/g, \"-\").replace(/\\//g, \"_\"), \"=\")}.xml`,\n authorized: (accessKey: string) => `fiscal/${accessKey}/authorized.xml`,\n cancel: (accessKey: string) => `fiscal/${accessKey}/cancel.xml`,\n /** The event 110300 of `nSeqEvento` `sequence`. */\n linkPayment: (accessKey: string, sequence: number) => `fiscal/${accessKey}/link-payment-${sequence}.xml`,\n inutilization: (document: FiscalDocument) =>\n `fiscal/inutilization/${document.environment}/${document.model}/${document.ownerId}/${document.series}-${document.number}.xml`,\n};\n\n/** The IBGE code of each federative unit: the access key's first two digits. */\nconst UF_CODES: Readonly<Record<Uf, string>> = {\n RO: \"11\", AC: \"12\", AM: \"13\", RR: \"14\", PA: \"15\", AP: \"16\", TO: \"17\", MA: \"21\", PI: \"22\", CE: \"23\", RN: \"24\", PB: \"25\",\n PE: \"26\", AL: \"27\", SE: \"28\", BA: \"29\", MG: \"31\", ES: \"32\", RJ: \"33\", SP: \"35\", PR: \"41\", SC: \"42\", RS: \"43\", MS: \"50\",\n MT: \"51\", GO: \"52\", DF: \"53\",\n};\n\n/** The access key's modulo-11 check digit (weights 2–9 from the right). */\nfunction keyCheckDigit(body: string): number {\n let sum = 0;\n let weight = 2;\n for (let i = body.length - 1; i >= 0; i -= 1) {\n sum += (body.charCodeAt(i) - 48) * weight;\n weight = weight === 9 ? 2 : weight + 1;\n }\n const rest = sum % 11;\n return rest < 2 ? 0 : 11 - rest;\n}\n\n/** cUF and AAMM, the issuer's CNPJ (alphanumeric from July 2026), then model to `cDV`, all digits. */\nconst ACCESS_KEY_SHAPE = /^[0-9]{6}[0-9A-Z]{12}[0-9]{26}$/;\n/** `NFref` occurs at most 500 times. */\nconst MAX_REFERENCED_DOCUMENTS = 500;\n\n/**\n * Whether `key` is an access key as the layout writes one: 44 characters, the\n * CNPJ inside it alphanumeric or not, and its modulo-11 check digit right.\n */\nexport function isValidAccessKey(key: string): boolean {\n if (!ACCESS_KEY_SHAPE.test(key)) return false;\n return keyCheckDigit(key.slice(0, 43)) === Number(key.slice(43));\n}\n\n/**\n * Refuses a sale the model cannot carry, before a number is drawn: a return on\n * an NFC-e, an NFC-e of entry, an NFC-e quoting another document (SEFAZ\n * rejects `NFref` on a model 65 with 708, and the number would be burned), a\n * return quoting nothing, or a reference that is not an access key. A document without `operation` and\n * `referencedDocuments` passes as it always did.\n */\nexport function assertDraftFits(draft: Pick<SaleDraft, \"purpose\" | \"operation\" | \"referencedDocuments\">, model: FiscalDocumentModel): void {\n const references = draft.referencedDocuments ?? [];\n if (model === \"NFCE\") assertNfceDraftFits(draft, references.length);\n if (draft.purpose === \"RETURN\" && references.length === 0) {\n throw new FiscalDocumentError(\"RETURN_NEEDS_REFERENCE\", \"a return must reference the document it returns (referencedDocuments).\");\n }\n if (references.length > MAX_REFERENCED_DOCUMENTS) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", `at most ${MAX_REFERENCED_DOCUMENTS} referenced documents, not ${references.length}.`);\n }\n const bad = references.findIndex((reference) => !isValidAccessKey(reference.accessKey));\n if (bad !== -1) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", `referencedDocuments[${bad}].accessKey is not a 44-character access key.`);\n }\n}\n\n/** The NFC-e half of `assertDraftFits`: no return, no entry, no reference. */\nfunction assertNfceDraftFits(draft: Pick<SaleDraft, \"purpose\" | \"operation\">, referenceCount: number): void {\n if (draft.purpose === \"RETURN\") {\n throw new FiscalDocumentError(\"RETURN_ON_NFCE\", \"an NFC-e has no return purpose: issue an NF-e (model 55) of entry referencing it.\");\n }\n if (draft.operation === \"IN\") {\n throw new FiscalDocumentError(\"INVALID_INPUT\", 'an NFC-e is an outgoing document: operation must be \"OUT\".');\n }\n if (referenceCount > 0) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", \"an NFC-e references no document (SEFAZ 708): referencedDocuments must be empty.\");\n }\n}\n\n/**\n * The 44-character access key a document will carry, computed as the layout\n * does: cUF, AAMM of `dhEmi`, CNPJ, model, series, number, `tpEmis` (1 online,\n * 9 offline NFC-e), `cNF` and the check digit. The package knows a document's\n * key before any call, so an unanswered send can always be looked up.\n */\nexport function computeAccessKey(input: {\n readonly sale: Pick<SaleForDocument, \"issuer\" | \"issuedAt\" | \"series\" | \"number\" | \"keyCode\">;\n readonly model: FiscalDocumentModel;\n readonly seriesKind: SeriesKind;\n}): string {\n const { sale } = input;\n const body = [\n UF_CODES[sale.issuer.address.uf],\n sale.issuedAt.slice(2, 4),\n sale.issuedAt.slice(5, 7),\n sale.issuer.cnpj,\n input.model === \"NFE\" ? \"55\" : \"65\",\n String(sale.series).padStart(3, \"0\"),\n String(sale.number).padStart(9, \"0\"),\n input.seriesKind === \"CONTINGENCY\" ? \"9\" : \"1\",\n sale.keyCode,\n ].join(\"\");\n return `${body}${keyCheckDigit(body)}`;\n}\n\n","/**\n * What every step of the document service shares: the ports, the clock, the\n * host's words written into a document, and the two writes everything goes\n * through — numbering a new document, and persisting one transition with the\n * schedule and the person's flag it implies.\n */\n\nimport type { Issuer, SigningMaterial } from \"../issuer/port\";\nimport { FISCAL_ISSUE } from \"../manifest/permissions\";\nimport { FiscalDocumentError } from \"./errors\";\nimport { computeAccessKey, drawKeyCode, issuerOf, localIso, totalsOf } from \"./helpers\";\nimport { type DocumentInput, type Transition, transition } from \"./machine\";\nimport type { DocumentStorage, FiscalStore, SaleDraft, SaleSource } from \"./ports\";\nimport type { EmitterProfile, IssuingPoint } from \"./profile\";\nimport type { SigningIdentities } from \"./signing\";\nimport { type FiscalDocument, type FiscalDocumentModel, OWED_VOIDS, type SeriesKind } from \"./types\";\n\nexport { assertDraftFits, computeAccessKey, draftOf, drawKeyCode, isValidAccessKey, issuerOf, localIso, totalsOf, xmlKeys } from \"./helpers\";\n\n/** Twin of `@12-apps/wiring/ports`' `NotifyPort`: never throws. */\nexport interface FiscalNotifyPort {\n emit(event: {\n readonly type: string;\n readonly recipient: { readonly tenantId: string; readonly permission: string };\n readonly payload: unknown;\n }): Promise<unknown>;\n}\n\n/**\n * The words SEFAZ receives in a document, an event or a request — the host's,\n * in the host's language, 15 to 255 characters each. No default: a library\n * that wrote them would be writing a fiscal statement for its host.\n */\nexport interface FiscalReasons {\n /** `xJust` of a document signed offline. */\n readonly contingency: string;\n /** Why an unused number is inutilized. */\n readonly inutilization: string;\n /** Why a document found authorised after its sale moved to contingency is cancelled. */\n readonly substitution: string;\n}\n\nexport interface FiscalDocumentsConfig {\n readonly store: FiscalStore;\n readonly issuer: Issuer;\n readonly signing: SigningIdentities;\n readonly storage: DocumentStorage;\n readonly sales: SaleSource;\n readonly notify: FiscalNotifyPort;\n readonly now: () => Date;\n /** The owner's UTC offset at an instant (`-03:00`): `dhEmi` and `dhCont` are local times. */\n readonly utcOffset: (ownerId: string, at: Date) => string | Promise<string>;\n readonly reasons: FiscalReasons;\n /**\n * How long a document owing a step waits before the sweep takes it again,\n * the base of the backoff: each failure in a row doubles it, up to 64×.\n */\n readonly staleAfterMs: number;\n /**\n * How late an online NFC-e may still be sent with its `dhEmi`. SEFAZ refuses\n * a late one (704, \"data-hora de emissão atrasada\"; five minutes in most\n * states — the host's, per state). Past it, a stale online NFC-e at a point\n * with a contingency series goes offline instead of being sent again.\n */\n readonly nfceOnlineToleranceMs: number;\n /** Ids for new documents. */\n readonly newId: () => string;\n}\n\nexport const FISCAL_DOCUMENT_REJECTED = \"fiscal.document-rejected\";\nexport const FISCAL_CERTIFICATE_EXPIRING = \"fiscal.certificate-expiring\";\nexport const FISCAL_DOCUMENT_NEEDS_ATTENTION = \"fiscal.document-needs-attention\";\nexport const FISCAL_CONTINGENCY_DEADLINE = \"fiscal.contingency-deadline\";\n\nconst REQUIRED_PORTS = [\"store\", \"issuer\", \"signing\", \"storage\", \"sales\", \"notify\"] as const;\nconst REQUIRED_FUNCTIONS = [\"now\", \"utcOffset\", \"newId\"] as const;\nconst REASONS = [\"contingency\", \"inutilization\", \"substitution\"] as const;\nconst DURATIONS = [\"staleAfterMs\", \"nfceOnlineToleranceMs\"] as const;\n\nexport function assertConfig(config: FiscalDocumentsConfig): void {\n const missing = [\n ...REQUIRED_PORTS.filter((port) => config?.[port] === undefined || config[port] === null),\n ...REQUIRED_FUNCTIONS.filter((fn) => typeof config?.[fn] !== \"function\"),\n ...DURATIONS.filter((name) => !Number.isInteger(config?.[name]) || config[name] <= 0),\n ];\n if (missing.length > 0) throw new TypeError(`createFiscalDocuments needs ${missing.join(\", \")}.`);\n for (const name of REASONS) assertReason(config.reasons?.[name], `reasons.${name}`);\n}\n\nexport function assertReason(text: unknown, name: string): asserts text is string {\n if (typeof text !== \"string\" || text.trim().length < 15 || text.length > 255) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", `${name} must be 15 to 255 characters.`);\n }\n}\n\n/** The backoff never grows past 64 × `staleAfterMs`. */\nconst MAX_BACKOFF_DOUBLINGS = 6;\n\n/** Whether a document still owes the sweep (or the transmission) a call. */\nfunction owesWork(document: FiscalDocument): boolean {\n if (document.status === \"PENDING\" || document.status === \"SUBMITTED\" || document.status === \"CONTINGENCY\") return true;\n return document.numberVoid !== null && OWED_VOIDS.includes(document.numberVoid);\n}\n\nexport class FiscalContext {\n constructor(readonly config: FiscalDocumentsConfig) {}\n\n nowIso(): string {\n return this.config.now().toISOString();\n }\n\n async localNow(ownerId: string): Promise<string> {\n const at = this.config.now();\n return localIso(at, await this.config.utcOffset(ownerId, at));\n }\n\n /** When a document may be taken again: never, when nothing is owed or a person must look. */\n nextAttemptAt(document: FiscalDocument): string | null {\n if (document.attention || !owesWork(document)) return null;\n const wait = this.config.staleAfterMs * 2 ** Math.min(document.failures, MAX_BACKOFF_DOUBLINGS);\n return new Date(this.config.now().getTime() + wait).toISOString();\n }\n\n /** The machine's step, scheduled. */\n scheduled(document: FiscalDocument, input: DocumentInput): Transition {\n const step = transition(document, input, this.nowIso());\n return { ...step, document: { ...step.document, nextAttemptAt: this.nextAttemptAt(step.document) } };\n }\n\n /**\n * Persist one transition; a lost race is a `CONFLICT`, never a silent\n * overwrite. A document that has just come to need a person is announced.\n */\n async advance(document: FiscalDocument, input: DocumentInput): Promise<FiscalDocument> {\n const step = this.scheduled(document, input);\n if (!(await this.config.store.saveTransition(document, step))) {\n throw new FiscalDocumentError(\"CONFLICT\", `document ${document.id} moved while ${input.kind} was applied.`);\n }\n if (step.document.attention && !document.attention) await this.announceAttention(step.document);\n return step.document;\n }\n\n async announceAttention(document: FiscalDocument): Promise<void> {\n await this.config.notify.emit({\n type: FISCAL_DOCUMENT_NEEDS_ATTENTION,\n recipient: { tenantId: document.ownerId, permission: FISCAL_ISSUE },\n payload: {\n documentId: document.id,\n subjectId: document.subjectId,\n model: document.model,\n status: document.status,\n numberVoid: document.numberVoid,\n series: document.series,\n number: document.number,\n code: document.statusCode,\n reason: document.statusReason ?? \"\",\n failures: document.failures,\n },\n });\n }\n\n material(profile: EmitterProfile): Promise<SigningMaterial> {\n return this.config.signing[profile.signingIdentity].materialFor(profile);\n }\n\n async requireProfile(ownerId: string): Promise<EmitterProfile> {\n const profile = await this.config.store.getProfile(ownerId);\n if (profile === null) throw new FiscalDocumentError(\"NOT_FOUND\", `owner ${ownerId} has no emitter profile.`);\n return profile;\n }\n\n async requirePoint(ownerId: string, issuingPointId: string): Promise<IssuingPoint> {\n const point = await this.config.store.getIssuingPoint(ownerId, issuingPointId);\n if (point === null) throw new FiscalDocumentError(\"NOT_FOUND\", `owner ${ownerId} has no issuing point ${issuingPointId}.`);\n return point;\n }\n\n /**\n * Draw the next number of a series and store the PENDING document built on\n * it, together. With `replacing`, that document is REPLACED by this one in\n * the same transaction (going offline), so a crash leaves exactly one live.\n */\n async createNumbered(input: {\n readonly profile: EmitterProfile;\n readonly point: IssuingPoint;\n readonly subjectId: string;\n readonly model: FiscalDocumentModel;\n readonly seriesKind: SeriesKind;\n readonly draft: SaleDraft;\n readonly replacing?: FiscalDocument;\n }): Promise<FiscalDocument> {\n const { profile, point, draft } = input;\n const series = input.seriesKind === \"ONLINE\" ? point.onlineSeries : point.contingencySeries;\n if (series === null) throw new FiscalDocumentError(\"INVALID_INPUT\", `issuing point ${point.id} has no contingency series.`);\n const issuedAt = await this.localNow(profile.ownerId);\n const at = this.nowIso();\n const id = this.config.newId();\n const replace =\n input.replacing === undefined\n ? undefined\n : { previous: input.replacing, transition: this.scheduled(input.replacing, { kind: \"REPLACE\", replacedById: id }) };\n const request = {\n ownerId: profile.ownerId,\n issuerCnpj: profile.cnpj,\n issuingPointId: point.id,\n environment: profile.environment,\n model: input.model,\n seriesKind: input.seriesKind,\n series,\n };\n return this.config.store.createDocument(\n request,\n (number) => {\n const keyCode = drawKeyCode(number);\n const sale = { ...draft, series, number, keyCode, issuedAt, issuer: issuerOf(profile) };\n return {\n id,\n ownerId: profile.ownerId,\n issuerCnpj: profile.cnpj,\n subjectId: input.subjectId,\n issuingPointId: point.id,\n model: input.model,\n environment: profile.environment,\n seriesKind: input.seriesKind,\n series,\n number,\n keyCode,\n status: \"PENDING\",\n sale,\n totals: totalsOf(draft),\n buyerTaxId: draft.buyer?.document.number ?? null,\n accessKey: computeAccessKey({ sale, model: input.model, seriesKind: input.seriesKind }),\n protocol: null,\n statusCode: null,\n statusReason: null,\n lastErrorClass: null,\n outcomeUnknown: false,\n issuedAt,\n authorizedAt: null,\n contingency: null,\n cancelledAt: null,\n cancelReason: null,\n cancelProtocol: null,\n replacedById: null,\n numberVoid: null,\n xmlKey: null,\n eventXmlKey: null,\n attempts: 0,\n failures: 0,\n nextAttemptAt: new Date(Date.parse(at) + this.config.staleAfterMs).toISOString(),\n attention: false,\n deadlineWarnedAt: null,\n createdAt: at,\n updatedAt: at,\n };\n },\n replace,\n );\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBO,IAAM,eAAe;AAwDrB,SAAS,OAAO,UAA0B,MAAyB,KAAoB;AAC5F,QAAM,IAAI;AAAA,IACR;AAAA,IACA,GAAG,IAAI,2BAA2B,SAAS,EAAE,OAAO,SAAS,MAAM,KAAK,GAAG;AAAA,EAC7E;AACF;AALgB;AAQhB,IAAM,UAAU,EAAE,UAAU,GAAG,WAAW,MAAM;AAEhD,SAAS,aAAa,QAAwB,QAAyC;AACrF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO;AAAA,IACjB,cAAc,OAAO;AAAA,IACrB,YAAY,OAAO;AAAA,IACnB,cAAc,OAAO;AAAA,IACrB,gBAAgB;AAAA,IAChB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAZS;AAmBT,SAAS,aAAa,UAA0B,OAA8C;AAC5F,SAAO;AAAA,IACL,WAAW,SAAS,aAAa,MAAM;AAAA,IACvC,YAAY,MAAM;AAAA,IAClB,cAAc,MAAM;AAAA,IACpB,gBAAgB,MAAM;AAAA,IACtB,gBAAgB,SAAS,kBAAkB,MAAM;AAAA,EACnD;AACF;AARS;AAUT,SAAS,QAAQ,UAA0B,WAA6C;AACtF,QAAM,WAAW,SAAS,WAAW;AACrC,SAAO,EAAE,UAAU,WAAW,aAAa,YAAY,aAAa;AACtE;AAHS;AAMT,SAAS,gBAAgB,QAAsC;AAC7D,MAAI,OAAO,WAAW,aAAc,QAAO;AAC3C,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,MAAI,OAAO,WAAW,SAAU,QAAO;AACvC,SAAO;AACT;AALS;AAOT,SAAS,sBAAsB,UAA0B,QAAmD;AAC1G,MAAI,SAAS,eAAe,eAAgB,QAAO,UAAU,UAAU,+BAA+B;AACtG,MAAI,OAAO,QAAQ,MAAM,OAAO,WAAW,gBAAgB,OAAO,WAAW,WAAW;AAOtF,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,gBAAgB;AAAA,MAChB,UAAU,OAAO,YAAY,SAAS;AAAA,MACtC,YAAY,OAAO;AAAA,MACnB,cAAc,OAAO;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,YAAY,gBAAgB,MAAM;AAAA,IAClC,gBAAgB;AAAA;AAAA,IAEhB,UAAU,OAAO,YAAY,SAAS;AAAA,IACtC,YAAY,OAAO;AAAA,IACnB,cAAc,OAAO;AAAA,EACvB;AACF;AA3BS;AAmCT,SAAS,kBAAkB,UAA0B,QAA0B,QAAqD;AAClI,QAAM,QAAQ,EAAE,YAAY,OAAO,YAAY,cAAc,OAAO,cAAc,gBAAgB,MAAM;AAExG,QAAM,UAAU,OAAO,WAAW,gBAAgB,OAAO,WAAW;AACpE,MAAI,CAAC,WAAW,OAAO,aAAa,QAAQ,SAAS,cAAc,KAAM,QAAO;AAChF,MAAI,WAAW,OAAW,QAAO,EAAE,GAAG,OAAO,UAAU,OAAO,SAAS;AACvE,SAAO,EAAE,GAAG,OAAO,GAAG,SAAS,QAAQ,OAAO,QAAQ,UAAU,OAAO,UAAU,gBAAgB,MAAM,OAAO;AAChH;AAPS;AAST,SAAS,aAAa,UAA0B,QAA0B,QAA0C;AAClH,MAAI,SAAS,WAAW,cAAc,SAAS,WAAW,WAAY,QAAO,sBAAsB,UAAU,MAAM;AACnH,MAAI,SAAS,WAAW,YAAa,QAAO,kBAAkB,UAAU,QAAQ,MAAM;AACtF,MAAI,OAAO,WAAW,YAAa,QAAO,EAAE,QAAQ,aAAa,YAAY,OAAO,YAAY,cAAc,OAAO,aAAa;AAClI,SAAO,EAAE,YAAY,OAAO,YAAY,cAAc,OAAO,aAAa;AAC5E;AALS;AAOT,SAAS,aAAa,UAA0B,OAAmD;AACjG,QAAM,WAAW;AAAA,IACf,GAAG;AAAA,IACH,aAAa,MAAM,OAAO;AAAA,IAC1B,cAAc,MAAM;AAAA,IACpB,gBAAgB,MAAM,OAAO;AAAA,IAC7B,aAAa,MAAM;AAAA,EACrB;AACA,MAAI,SAAS,WAAW,cAAc;AACpC,WAAO,EAAE,GAAG,UAAU,QAAQ,aAAa,YAAY,MAAM,OAAO,YAAY,cAAc,MAAM,OAAO,aAAa;AAAA,EAC1H;AACA,MAAI,SAAS,eAAe,SAAU,QAAO,UAAU,UAAU,yDAAyD;AAC1H,SAAO,EAAE,GAAG,UAAU,YAAY,YAAY;AAChD;AAbS;AAsBT,SAAS,aAAa,UAA0B,OAA8C;AAC5F,QAAM,SAAS,aAAa,UAAU,KAAK;AAC3C,MAAI,SAAS,eAAe,cAAe,QAAO,EAAE,QAAQ,YAAY,GAAG,QAAQ,GAAG,SAAS,YAAY,KAAK;AAEhH,MAAI,SAAS,aAAa,KAAM,QAAO,EAAE,QAAQ,YAAY,GAAG,QAAQ,GAAG,QAAQ,UAAU,KAAK,GAAG,YAAY,eAAe;AAChI,SAAO,EAAE,QAAQ,YAAY,GAAG,QAAQ,GAAG,SAAS,YAAY,OAAO,mBAAmB,OAAO,iBAAiB,YAAY;AAChI;AANS;AAQF,IAAM,QAAc;AAAA,EACzB,QAAQ,8BAAO,EAAE,QAAQ,YAAY,IAA7B;AAAA,EACR,WAAW,wBAAC,WAAW,WAAW,EAAE,QAAQ,cAAc,GAAG,aAAa,MAAM,QAAQ,MAAM,MAAM,EAAE,IAA3F;AAAA,EACX,MAAM,wBAAC,WAAW,WAAW,EAAE,QAAQ,UAAU,GAAG,aAAa,MAAM,QAAQ,MAAM,MAAM,EAAE,IAAvF;AAAA,EACN,QAAQ,wBAAC,UAAU,UAAU,aAAa,UAAU,MAAM,KAAK,GAAvD;AAAA,EACR,OAAO,wBAAC,UAAU,WAAW;AAAA,IAC3B,GAAG,aAAa,UAAU,MAAM,KAAK;AAAA,IACrC,GAAG,QAAQ,UAAU,KAAK;AAAA,IAC1B,GAAI,MAAM,WAAW,SAAY,CAAC,IAAI,EAAE,QAAQ,MAAM,OAAO;AAAA,EAC/D,IAJO;AAAA,EAKP,cAAc,wBAAC,UAAU,UAAU;AACjC,QAAI,SAAS,eAAe,cAAe,QAAO,UAAU,MAAM,MAAM,oDAAoD;AAC5H,WAAO,EAAE,GAAG,SAAS,QAAQ,eAAe,WAAW,MAAM,OAAO,WAAW,aAAa,MAAM,aAAa,QAAQ,MAAM,OAAO;AAAA,EACtI,GAHc;AAAA,EAId,SAAS,wBAAC,UAAU,WAAW;AAAA,IAC7B,GAAG;AAAA,IACH,QAAQ;AAAA,IACR,cAAc,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,IAKpB,YAAY,SAAS,WAAW,cAAc,iBAAiB;AAAA,EACjE,IATS;AAAA,EAUT,QAAQ;AAAA,EACR,QAAQ,wBAAC,UAAU,UAAU,aAAa,UAAU,MAAM,QAAQ,MAAM,MAAM,GAAtE;AAAA,EACR,WAAW,wBAAC,UAAU,UAAU;AAC9B,QAAI,SAAS,eAAe,YAAa,QAAO,UAAU,MAAM,MAAM,yCAAyC;AAC/G,WAAO,EAAE,GAAG,SAAS,YAAY,cAAc,aAAa,MAAM,YAAY;AAAA,EAChF,GAHW;AAAA,EAIX,OAAO,wBAAC,UAAU,WAAW;AAAA,IAC3B,GAAG,QAAQ,UAAU,MAAM,SAAS;AAAA,IACpC,GAAI,MAAM,UAAU,OAAO,CAAC,IAAI,EAAE,gBAAgB,MAAM,MAAM,OAAO,YAAY,MAAM,MAAM,KAAK;AAAA,IAClG,cAAc,MAAM,OAAO,WAAW,MAAM;AAAA,EAC9C,IAJO;AAAA,EAKP,QAAQ,wBAAC,UAAU,UAAU;AAC3B,QAAI,SAAS,eAAe,cAAe,QAAO,UAAU,MAAM,MAAM,6CAA6C;AACrH,WAAO;AAAA,MACL,GAAG;AAAA,MACH,QAAQ;AAAA,MACR,MAAM,MAAM;AAAA,MACZ,QAAQ,MAAM;AAAA,MACd,YAAY,MAAM;AAAA,MAClB,WAAW,MAAM,OAAO;AAAA,MACxB,QAAQ,MAAM;AAAA,MACd,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,gBAAgB;AAAA,IAClB;AAAA,EACF,GAdQ;AAAA,EAeR,SAAS,wBAAC,aAAa;AACrB,QAAI,CAAC,SAAS,UAAW,QAAO,UAAU,WAAW,gCAAgC;AACrF,WAAO;AAAA,EACT,GAHS;AAAA;AAAA,EAKT,MAAM,8BAAO,CAAC,IAAR;AAAA,EACN,cAAc,8BAAO,CAAC,IAAR;AAChB;;;ACxOA,IAAM,MAAuC;AAAA,EAC3C;AAAA,EAAW;AAAA,EAAa;AAAA,EAAc;AAAA,EAAY;AAAA,EAAU;AAAA,EAAe;AAAA,EAAa;AAC1F;AAGO,IAAM,uBAA6F;AAAA,EACxG,QAAQ,CAAC,SAAS;AAAA,EAClB,WAAW,CAAC,aAAa,aAAa;AAAA,EACtC,MAAM,CAAC,aAAa,aAAa;AAAA,EACjC,QAAQ,CAAC,aAAa,aAAa;AAAA,EACnC,OAAO,CAAC,aAAa,aAAa;AAAA,EAClC,cAAc,CAAC,SAAS;AAAA,EACxB,SAAS,CAAC,WAAW,WAAW;AAAA,EAChC,QAAQ,CAAC,cAAc,YAAY,UAAU;AAAA,EAC7C,QAAQ,CAAC,aAAa,cAAc,YAAY,UAAU;AAAA,EAC1D,WAAW,CAAC,YAAY,UAAU;AAAA,EAClC,OAAO;AAAA,EACP,QAAQ,CAAC,UAAU;AAAA,EACnB,SAAS;AAAA,EACT,MAAM,CAAC,aAAa;AAAA,EACpB,cAAc,CAAC,YAAY;AAC7B;AAGO,IAAM,iBAAkD,CAAC,YAAY,UAAU,aAAa,UAAU;AAO7G,IAAM,aAAa;AAMZ,SAAS,aAAa,OAAyB;AACpD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,YAAY;AACvD,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,MAA+B,CAAC;AACtC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,CAAC,WAAW,KAAK,GAAG,EAAG,KAAI,GAAG,IAAI,aAAa,KAAK;AAAA,EAC1D;AACA,SAAO;AACT;AARgB;AAUhB,SAAS,SAAS,OAA+B;AAC/C,MAAI,MAAM,SAAS,gBAAgB;AACjC,WAAO,EAAE,GAAG,MAAM,QAAQ,SAAS,MAAM,SAAS,UAAU,MAAM,UAAU,aAAa,MAAM,YAAY;AAAA,EAC7G;AACA,MAAI,YAAY,MAAO,QAAO,MAAM;AACpC,MAAI,WAAW,SAAS,MAAM,UAAU,KAAM,QAAO,EAAE,OAAO,MAAM,MAAM;AAC1E,MAAI,MAAM,SAAS,QAAS,QAAO,EAAE,QAAQ,MAAM,OAAO;AAC1D,SAAO;AACT;AARS;AAUT,SAAS,QAAQ,UAA0B,OAAsB,UAAgC,IAAiC;AAChI,QAAM,QAAQ,WAAW,QAAQ,MAAM,QAAQ;AAC/C,QAAM,SAAS,YAAY,QAAQ,MAAM,SAAS;AAClD,SAAO;AAAA,IACL,YAAY,SAAS;AAAA,IACrB,MAAM,MAAM;AAAA,IACZ,YAAY,SAAS;AAAA,IACrB;AAAA,IACA;AAAA,IACA,YAAY,OAAO,SAAS;AAAA,IAC5B,MAAM,OAAO,SAAS,WAAW,QAAQ,gBAAgB,SAAS,OAAO,aAAa;AAAA,IACtF,QAAQ,aAAa,SAAS,KAAK,CAAC;AAAA,EACtC;AACF;AAbS;AAeT,IAAM,UAAU,oBAAI,IAAuB,CAAC,UAAU,SAAS,gBAAgB,QAAQ,CAAC;AAMjF,SAAS,WAAW,UAA0B,OAAsB,IAAwB;AACjG,MAAI,CAAC,qBAAqB,MAAM,IAAI,EAAE,SAAS,SAAS,MAAM,GAAG;AAC/D,WAAO,UAAU,MAAM,MAAM,sBAAsB,qBAAqB,MAAM,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE;AAAA,EAClG;AACA,QAAM,OAAO,MAAM,MAAM,IAAI;AAC7B,QAAM,UAA0B;AAAA,IAC9B,GAAG;AAAA,IACH,GAAG,KAAK,UAAU,KAAK;AAAA,IACvB,GAAI,MAAM,SAAS,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;AAAA,IACxD,UAAU,SAAS,YAAY,QAAQ,IAAI,MAAM,IAAI,IAAI,IAAI;AAAA,IAC7D,WAAW;AAAA,EACb;AACA,SAAO,EAAE,UAAU,SAAS,OAAO,QAAQ,UAAU,OAAO,QAAQ,QAAQ,EAAE,EAAE;AAClF;AAbgB;AAgBT,SAAS,cAAc,QAA8B,MAAkC;AAC5F,SAAO,qBAAqB,IAAI,EAAE,SAAS,MAAM;AACnD;AAFgB;;;ACtHT,SAAS,SAAS,IAAU,QAAwB;AACzD,QAAM,QAAQ,0BAA0B,KAAK,MAAM;AACnD,MAAI,UAAU,KAAM,OAAM,IAAI,oBAAoB,iBAAiB,uBAAuB,MAAM,mBAAgB;AAChH,QAAM,WAAW,MAAM,CAAC,MAAM,MAAM,KAAK,MAAM,OAAO,MAAM,CAAC,CAAC,IAAI,KAAK,OAAO,MAAM,CAAC,CAAC;AACtF,SAAO,GAAG,IAAI,KAAK,GAAG,QAAQ,IAAI,UAAU,GAAM,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM;AACzF;AALgB;AAOhB,IAAM,iBAAiB,KAAK,MAAM,KAAK,KAAK,GAAW,IAAI;AAGpD,SAAS,YAAY,QAAwB;AAClD,QAAM,MAAM,OAAO,SAAS,GAAW,EAAE,SAAS,GAAG,GAAG;AACxD,aAAS;AACP,UAAM,CAAC,KAAK,IAAI,WAAW,OAAO,gBAAgB,IAAI,YAAY,CAAC,CAAC;AAEpE,QAAI,UAAU,UAAa,SAAS,eAAgB;AACpD,UAAM,OAAO,OAAO,QAAQ,GAAW,EAAE,SAAS,GAAG,GAAG;AACxD,QAAI,SAAS,IAAK,QAAO;AAAA,EAC3B;AACF;AATgB;AAWhB,IAAM,wBAAwB,oBAAI,IAAI,CAAC,UAAU,UAAU,WAAW,UAAU,UAAU,CAAC;AAGpF,SAAS,QAAQ,MAAkC;AACxD,SAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,sBAAsB,IAAI,GAAG,CAAC,CAAC;AACnG;AAFgB;AAIT,SAAS,SAAS,SAAyC;AAChE,SAAO;AAAA,IACL,MAAM,QAAQ;AAAA,IACd,mBAAmB,QAAQ;AAAA,IAC3B,WAAW,QAAQ;AAAA,IACnB,WAAW,QAAQ;AAAA,IACnB,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ;AAAA,EACnB;AACF;AATgB;AAWT,SAAS,SAAS,MAAiC;AACxD,QAAM,MAAM,wBAAC,SAAuD,KAAK,MAAM,OAAO,CAAC,OAAO,SAAS,QAAQ,KAAK,IAAI,GAAG,CAAC,GAAhH;AACZ,QAAM,gBAAgB,IAAI,CAAC,SAAS,KAAK,aAAa;AACtD,SAAO;AAAA,IACL,YAAY,IAAI,CAAC,SAAS,KAAK,UAAU,IAAI;AAAA,IAC7C;AAAA,IACA,UAAU,IAAI,CAAC,SAAS,KAAK,QAAQ,SAAS,YAAY,CAAC;AAAA,IAC3D,YAAY,IAAI,CAAC,SAAS,KAAK,QAAQ,SAAS,cAAc,CAAC;AAAA,IAC/D,aAAa,IAAI,CAAC,SAAS,KAAK,QAAQ,SAAS,eAAe,CAAC;AAAA,EACnE;AACF;AAVgB;AAaT,SAAS,QAAQ,MAAc,MAAsB;AAC1D,MAAI,MAAM,KAAK;AACf,SAAO,MAAM,KAAK,KAAK,MAAM,CAAC,MAAM,KAAM,QAAO;AACjD,SAAO,KAAK,MAAM,GAAG,GAAG;AAC1B;AAJgB;AAOT,IAAM,UAAU;AAAA,EACrB,QAAQ,wBAAC,cAAsB,UAAU,SAAS,eAA1C;AAAA;AAAA,EAER,gBAAgB,wBAAC,WAAmB,WAClC,UAAU,SAAS,WAAW,QAAQ,OAAO,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,GAAG,GAAG,CAAC,QAD5E;AAAA,EAEhB,YAAY,wBAAC,cAAsB,UAAU,SAAS,mBAA1C;AAAA,EACZ,QAAQ,wBAAC,cAAsB,UAAU,SAAS,eAA1C;AAAA;AAAA,EAER,aAAa,wBAAC,WAAmB,aAAqB,UAAU,SAAS,iBAAiB,QAAQ,QAArF;AAAA,EACb,eAAe,wBAAC,aACd,wBAAwB,SAAS,WAAW,IAAI,SAAS,KAAK,IAAI,SAAS,OAAO,IAAI,SAAS,MAAM,IAAI,SAAS,MAAM,QAD3G;AAEjB;AAGA,IAAM,WAAyC;AAAA,EAC7C,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAClH,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAAA,EAClH,IAAI;AAAA,EAAM,IAAI;AAAA,EAAM,IAAI;AAC1B;AAGA,SAAS,cAAc,MAAsB;AAC3C,MAAI,MAAM;AACV,MAAI,SAAS;AACb,WAAS,IAAI,KAAK,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AAC5C,YAAQ,KAAK,WAAW,CAAC,IAAI,MAAM;AACnC,aAAS,WAAW,IAAI,IAAI,SAAS;AAAA,EACvC;AACA,QAAM,OAAO,MAAM;AACnB,SAAO,OAAO,IAAI,IAAI,KAAK;AAC7B;AATS;AAYT,IAAM,mBAAmB;AAEzB,IAAM,2BAA2B;AAM1B,SAAS,iBAAiB,KAAsB;AACrD,MAAI,CAAC,iBAAiB,KAAK,GAAG,EAAG,QAAO;AACxC,SAAO,cAAc,IAAI,MAAM,GAAG,EAAE,CAAC,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;AACjE;AAHgB;AAYT,SAAS,gBAAgB,OAAyE,OAAkC;AACzI,QAAM,aAAa,MAAM,uBAAuB,CAAC;AACjD,MAAI,UAAU,OAAQ,qBAAoB,OAAO,WAAW,MAAM;AAClE,MAAI,MAAM,YAAY,YAAY,WAAW,WAAW,GAAG;AACzD,UAAM,IAAI,oBAAoB,0BAA0B,wEAAwE;AAAA,EAClI;AACA,MAAI,WAAW,SAAS,0BAA0B;AAChD,UAAM,IAAI,oBAAoB,iBAAiB,WAAW,wBAAwB,8BAA8B,WAAW,MAAM,GAAG;AAAA,EACtI;AACA,QAAM,MAAM,WAAW,UAAU,CAAC,cAAc,CAAC,iBAAiB,UAAU,SAAS,CAAC;AACtF,MAAI,QAAQ,IAAI;AACd,UAAM,IAAI,oBAAoB,iBAAiB,uBAAuB,GAAG,+CAA+C;AAAA,EAC1H;AACF;AAbgB;AAgBhB,SAAS,oBAAoB,OAAiD,gBAA8B;AAC1G,MAAI,MAAM,YAAY,UAAU;AAC9B,UAAM,IAAI,oBAAoB,kBAAkB,mFAAmF;AAAA,EACrI;AACA,MAAI,MAAM,cAAc,MAAM;AAC5B,UAAM,IAAI,oBAAoB,iBAAiB,4DAA4D;AAAA,EAC7G;AACA,MAAI,iBAAiB,GAAG;AACtB,UAAM,IAAI,oBAAoB,iBAAiB,iFAAiF;AAAA,EAClI;AACF;AAVS;AAkBF,SAAS,iBAAiB,OAItB;AACT,QAAM,EAAE,KAAK,IAAI;AACjB,QAAM,OAAO;AAAA,IACX,SAAS,KAAK,OAAO,QAAQ,EAAE;AAAA,IAC/B,KAAK,SAAS,MAAM,GAAG,CAAC;AAAA,IACxB,KAAK,SAAS,MAAM,GAAG,CAAC;AAAA,IACxB,KAAK,OAAO;AAAA,IACZ,MAAM,UAAU,QAAQ,OAAO;AAAA,IAC/B,OAAO,KAAK,MAAM,EAAE,SAAS,GAAG,GAAG;AAAA,IACnC,OAAO,KAAK,MAAM,EAAE,SAAS,GAAG,GAAG;AAAA,IACnC,MAAM,eAAe,gBAAgB,MAAM;AAAA,IAC3C,KAAK;AAAA,EACP,EAAE,KAAK,EAAE;AACT,SAAO,GAAG,IAAI,GAAG,cAAc,IAAI,CAAC;AACtC;AAlBgB;;;AC1FT,IAAM,2BAA2B;AACjC,IAAM,8BAA8B;AACpC,IAAM,kCAAkC;AACxC,IAAM,8BAA8B;AAE3C,IAAM,iBAAiB,CAAC,SAAS,UAAU,WAAW,WAAW,SAAS,QAAQ;AAClF,IAAM,qBAAqB,CAAC,OAAO,aAAa,OAAO;AACvD,IAAM,UAAU,CAAC,eAAe,iBAAiB,cAAc;AAC/D,IAAM,YAAY,CAAC,gBAAgB,uBAAuB;AAEnD,SAAS,aAAa,QAAqC;AAChE,QAAM,UAAU;AAAA,IACd,GAAG,eAAe,OAAO,CAAC,SAAS,SAAS,IAAI,MAAM,UAAa,OAAO,IAAI,MAAM,IAAI;AAAA,IACxF,GAAG,mBAAmB,OAAO,CAAC,OAAO,OAAO,SAAS,EAAE,MAAM,UAAU;AAAA,IACvE,GAAG,UAAU,OAAO,CAAC,SAAS,CAAC,OAAO,UAAU,SAAS,IAAI,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC;AAAA,EACtF;AACA,MAAI,QAAQ,SAAS,EAAG,OAAM,IAAI,UAAU,+BAA+B,QAAQ,KAAK,IAAI,CAAC,GAAG;AAChG,aAAW,QAAQ,QAAS,cAAa,OAAO,UAAU,IAAI,GAAG,WAAW,IAAI,EAAE;AACpF;AARgB;AAUT,SAAS,aAAa,MAAe,MAAsC;AAChF,MAAI,OAAO,SAAS,YAAY,KAAK,KAAK,EAAE,SAAS,MAAM,KAAK,SAAS,KAAK;AAC5E,UAAM,IAAI,oBAAoB,iBAAiB,GAAG,IAAI,gCAAgC;AAAA,EACxF;AACF;AAJgB;AAOhB,IAAM,wBAAwB;AAG9B,SAAS,SAAS,UAAmC;AACnD,MAAI,SAAS,WAAW,aAAa,SAAS,WAAW,eAAe,SAAS,WAAW,cAAe,QAAO;AAClH,SAAO,SAAS,eAAe,QAAQ,WAAW,SAAS,SAAS,UAAU;AAChF;AAHS;AAKF,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAqB,QAA+B;AAA/B;AAAA,EAAgC;AAAA,EAAhC;AAAA,EAzGvB,OAwG2B;AAAA;AAAA;AAAA,EAGzB,SAAiB;AACf,WAAO,KAAK,OAAO,IAAI,EAAE,YAAY;AAAA,EACvC;AAAA,EAEA,MAAM,SAAS,SAAkC;AAC/C,UAAM,KAAK,KAAK,OAAO,IAAI;AAC3B,WAAO,SAAS,IAAI,MAAM,KAAK,OAAO,UAAU,SAAS,EAAE,CAAC;AAAA,EAC9D;AAAA;AAAA,EAGA,cAAc,UAAyC;AACrD,QAAI,SAAS,aAAa,CAAC,SAAS,QAAQ,EAAG,QAAO;AACtD,UAAM,OAAO,KAAK,OAAO,eAAe,KAAK,KAAK,IAAI,SAAS,UAAU,qBAAqB;AAC9F,WAAO,IAAI,KAAK,KAAK,OAAO,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,YAAY;AAAA,EAClE;AAAA;AAAA,EAGA,UAAU,UAA0B,OAAkC;AACpE,UAAM,OAAO,WAAW,UAAU,OAAO,KAAK,OAAO,CAAC;AACtD,WAAO,EAAE,GAAG,MAAM,UAAU,EAAE,GAAG,KAAK,UAAU,eAAe,KAAK,cAAc,KAAK,QAAQ,EAAE,EAAE;AAAA,EACrG;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAAQ,UAA0B,OAA+C;AACrF,UAAM,OAAO,KAAK,UAAU,UAAU,KAAK;AAC3C,QAAI,CAAE,MAAM,KAAK,OAAO,MAAM,eAAe,UAAU,IAAI,GAAI;AAC7D,YAAM,IAAI,oBAAoB,YAAY,YAAY,SAAS,EAAE,gBAAgB,MAAM,IAAI,eAAe;AAAA,IAC5G;AACA,QAAI,KAAK,SAAS,aAAa,CAAC,SAAS,UAAW,OAAM,KAAK,kBAAkB,KAAK,QAAQ;AAC9F,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,kBAAkB,UAAyC;AAC/D,UAAM,KAAK,OAAO,OAAO,KAAK;AAAA,MAC5B,MAAM;AAAA,MACN,WAAW,EAAE,UAAU,SAAS,SAAS,YAAY,aAAa;AAAA,MAClE,SAAS;AAAA,QACP,YAAY,SAAS;AAAA,QACrB,WAAW,SAAS;AAAA,QACpB,OAAO,SAAS;AAAA,QAChB,QAAQ,SAAS;AAAA,QACjB,YAAY,SAAS;AAAA,QACrB,QAAQ,SAAS;AAAA,QACjB,QAAQ,SAAS;AAAA,QACjB,MAAM,SAAS;AAAA,QACf,QAAQ,SAAS,gBAAgB;AAAA,QACjC,UAAU,SAAS;AAAA,MACrB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,SAAS,SAAmD;AAC1D,WAAO,KAAK,OAAO,QAAQ,QAAQ,eAAe,EAAE,YAAY,OAAO;AAAA,EACzE;AAAA,EAEA,MAAM,eAAe,SAA0C;AAC7D,UAAM,UAAU,MAAM,KAAK,OAAO,MAAM,WAAW,OAAO;AAC1D,QAAI,YAAY,KAAM,OAAM,IAAI,oBAAoB,aAAa,SAAS,OAAO,0BAA0B;AAC3G,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,aAAa,SAAiB,gBAA+C;AACjF,UAAM,QAAQ,MAAM,KAAK,OAAO,MAAM,gBAAgB,SAAS,cAAc;AAC7E,QAAI,UAAU,KAAM,OAAM,IAAI,oBAAoB,aAAa,SAAS,OAAO,yBAAyB,cAAc,GAAG;AACzH,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,eAAe,OAQO;AAC1B,UAAM,EAAE,SAAS,OAAO,MAAM,IAAI;AAClC,UAAM,SAAS,MAAM,eAAe,WAAW,MAAM,eAAe,MAAM;AAC1E,QAAI,WAAW,KAAM,OAAM,IAAI,oBAAoB,iBAAiB,iBAAiB,MAAM,EAAE,6BAA6B;AAC1H,UAAM,WAAW,MAAM,KAAK,SAAS,QAAQ,OAAO;AACpD,UAAM,KAAK,KAAK,OAAO;AACvB,UAAM,KAAK,KAAK,OAAO,MAAM;AAC7B,UAAM,UACJ,MAAM,cAAc,SAChB,SACA,EAAE,UAAU,MAAM,WAAW,YAAY,KAAK,UAAU,MAAM,WAAW,EAAE,MAAM,WAAW,cAAc,GAAG,CAAC,EAAE;AACtH,UAAM,UAAU;AAAA,MACd,SAAS,QAAQ;AAAA,MACjB,YAAY,QAAQ;AAAA,MACpB,gBAAgB,MAAM;AAAA,MACtB,aAAa,QAAQ;AAAA,MACrB,OAAO,MAAM;AAAA,MACb,YAAY,MAAM;AAAA,MAClB;AAAA,IACF;AACA,WAAO,KAAK,OAAO,MAAM;AAAA,MACvB;AAAA,MACA,CAAC,WAAW;AACV,cAAM,UAAU,YAAY,MAAM;AAClC,cAAM,OAAO,EAAE,GAAG,OAAO,QAAQ,QAAQ,SAAS,UAAU,QAAQ,SAAS,OAAO,EAAE;AACtF,eAAO;AAAA,UACL;AAAA,UACA,SAAS,QAAQ;AAAA,UACjB,YAAY,QAAQ;AAAA,UACpB,WAAW,MAAM;AAAA,UACjB,gBAAgB,MAAM;AAAA,UACtB,OAAO,MAAM;AAAA,UACb,aAAa,QAAQ;AAAA,UACrB,YAAY,MAAM;AAAA,UAClB;AAAA,UACA;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,UACR;AAAA,UACA,QAAQ,SAAS,KAAK;AAAA,UACtB,YAAY,MAAM,OAAO,SAAS,UAAU;AAAA,UAC5C,WAAW,iBAAiB,EAAE,MAAM,OAAO,MAAM,OAAO,YAAY,MAAM,WAAW,CAAC;AAAA,UACtF,UAAU;AAAA,UACV,YAAY;AAAA,UACZ,cAAc;AAAA,UACd,gBAAgB;AAAA,UAChB,gBAAgB;AAAA,UAChB;AAAA,UACA,cAAc;AAAA,UACd,aAAa;AAAA,UACb,aAAa;AAAA,UACb,cAAc;AAAA,UACd,gBAAgB;AAAA,UAChB,cAAc;AAAA,UACd,YAAY;AAAA,UACZ,QAAQ;AAAA,UACR,aAAa;AAAA,UACb,UAAU;AAAA,UACV,UAAU;AAAA,UACV,eAAe,IAAI,KAAK,KAAK,MAAM,EAAE,IAAI,KAAK,OAAO,YAAY,EAAE,YAAY;AAAA,UAC/E,WAAW;AAAA,UACX,kBAAkB;AAAA,UAClB,WAAW;AAAA,UACX,WAAW;AAAA,QACb;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/danfe/labels.ts","../src/danfe/render.ts"],"sourcesContent":["/**\n * The words a DANFE NFC-e prints. The layout is the Manual do DANFE NFC-e's\n * and the words are the host's language: a host passes them all, or the\n * `./pt-BR` pack, which carries the Manual's own texts. Nothing here defaults.\n */\n\nexport interface DanfeNfceLabels {\n /** Division I. */\n readonly cnpj: string;\n readonly stateRegistration: string;\n /** Division II: the document's own title. */\n readonly title: string;\n /** Division III: the item table's header. */\n readonly itemsHeader: string;\n /** Division IV. */\n readonly itemCount: string;\n readonly totalValue: string;\n readonly discounts: string;\n readonly amountDue: string;\n readonly paymentHeader: string;\n readonly change: string;\n /** `tPag` code (`01`, `17`…) → the method's name; an unknown code prints itself. */\n readonly paymentMethods: Readonly<Record<string, string>>;\n /** Division V. */\n readonly lookupByKey: string;\n readonly homologation: string;\n readonly contingency: string;\n readonly pendingAuthorization: string;\n /** Printed on a paper signed offline and not yet authorised: the one copy, the consumer's. */\n readonly consumerCopy: string;\n /** Division VI. */\n readonly consumer: string;\n readonly unidentifiedConsumer: string;\n /** Division VII. */\n readonly number: string;\n readonly series: string;\n readonly protocol: string;\n readonly authorizedAt: string;\n /** Division VIII and after: the QR code's caption and the approximate tax line (Lei 12.741/2012). */\n readonly qrCaption: string;\n readonly approximateTaxes: string;\n}\n\nexport const DANFE_LABEL_KEYS: readonly (keyof DanfeNfceLabels)[] = [\n \"cnpj\", \"stateRegistration\", \"title\", \"itemsHeader\", \"itemCount\", \"totalValue\", \"discounts\", \"amountDue\",\n \"paymentHeader\", \"change\", \"paymentMethods\", \"lookupByKey\", \"homologation\", \"contingency\", \"pendingAuthorization\",\n \"consumerCopy\",\n \"consumer\", \"unidentifiedConsumer\", \"number\", \"series\", \"protocol\", \"authorizedAt\", \"qrCaption\", \"approximateTaxes\",\n];\n","/**\n * The DANFE NFC-e as ESC/POS-ready lines, read from the document's XML —\n * the authorised `nfeProc`, or the signed XML of a document issued offline,\n * which prints the contingency variant. No provider returns ESC/POS and a\n * register offline has nothing else to print, so the package renders it.\n *\n * The paper follows the Manual do DANFE NFC-e's divisions, in order (the\n * FULL DANFE, items included):\n *\n * I the issuer: name, CNPJ, IE, address\n * II the document's title\n * III the items: code, description, quantity, unit, unit value, total\n * IV the totals: item count, total, discounts, amount due, payments, change\n * V the fiscal message: homologation, contingency, where to look the key up, the key\n * VI the consumer\n * VII the number, series, issue time, and the authorisation protocol\n * VIII the QR code, then the taxpayer's message and the approximate taxes\n *\n * Each line is `{ text, align, emphasis }`, the shape `@12-apps/thermal-printing`\n * encodes, laid out for the column count of the roll (Font A: 32 columns on\n * 58 mm, 48 on 80 mm); the QR line carries `qrCode` for the host to rasterise.\n */\n\nimport { FiscalDocumentError } from \"../documents/errors\";\nimport type { DanfeNfceLabels } from \"./labels\";\nimport { DANFE_LABEL_KEYS } from \"./labels\";\nimport { accessKeyOf, element, elements, text } from \"./xml\";\n\nexport type DanfeDivision = \"I\" | \"II\" | \"III\" | \"IV\" | \"V\" | \"VI\" | \"VII\" | \"VIII\";\n\nexport interface DanfeLine {\n readonly division: DanfeDivision;\n readonly text: string;\n readonly align: \"left\" | \"center\";\n readonly emphasis: \"normal\" | \"bold\";\n /** Present on the QR line only: the URL the code encodes. */\n readonly qrCode?: string;\n}\n\nexport type PaperWidth = 58 | 80;\n\nexport const DANFE_COLUMNS: Readonly<Record<PaperWidth, number>> = { 58: 32, 80: 48 };\n\nexport interface DanfeNfceInput {\n /** The `nfeProc` of an authorised document, or the signed XML of one issued offline. */\n readonly xml: string;\n readonly paperWidth: PaperWidth;\n readonly labels: DanfeNfceLabels;\n}\n\n/** `1234` cents → `12,34`; thousands with a dot, as the DANFE prints money. */\nexport function money(value: string | null): string {\n const cents = Math.round(Number(value ?? \"0\") * 100);\n const whole = Math.trunc(Math.abs(cents) / 100).toString().replace(/\\B(?=(\\d{3})+(?!\\d))/g, \".\");\n return `${cents < 0 ? \"-\" : \"\"}${whole},${String(Math.abs(cents) % 100).padStart(2, \"0\")}`;\n}\n\nfunction quantity(value: string | null): string {\n return Number(value ?? \"0\").toLocaleString(\"en-US\", { maximumFractionDigits: 4, useGrouping: false }).replace(\".\", \",\");\n}\n\n/** A word longer than the width (a URL) cut into width-long pieces: nothing is dropped. */\nfunction pieces(word: string, width: number): string[] {\n const out: string[] = [];\n for (let at = 0; at < word.length; at += width) out.push(word.slice(at, at + width));\n return out;\n}\n\n/** Wrap a text at the width, breaking on spaces where it can. */\nexport function wrap(value: string, width: number): string[] {\n const words = value\n .trim()\n .split(/\\s+/)\n .filter((word) => word !== \"\")\n .flatMap((word) => pieces(word, width));\n const lines: string[] = [];\n let current = \"\";\n for (const word of words) {\n const candidate = current === \"\" ? word : `${current} ${word}`;\n if (candidate.length <= width) {\n current = candidate;\n continue;\n }\n if (current !== \"\") lines.push(current);\n current = word;\n }\n if (current !== \"\") lines.push(current);\n return lines.length > 0 ? lines : [\"\"];\n}\n\n/** `label ……… value` across the width. */\nfunction spread(label: string, value: string, width: number): string {\n const gap = width - label.length - value.length;\n return gap >= 1 ? `${label}${\" \".repeat(gap)}${value}` : `${label} ${value}`;\n}\n\nfunction groupKey(key: string): string {\n return key.replace(/(.{4})/g, \"$1 \").trim();\n}\n\nclass Paper {\n readonly lines: DanfeLine[] = [];\n constructor(readonly width: number) {}\n\n add(division: DanfeDivision, value: string, align: DanfeLine[\"align\"] = \"left\", emphasis: DanfeLine[\"emphasis\"] = \"normal\"): void {\n for (const piece of wrap(value, this.width)) this.lines.push({ division, text: piece, align, emphasis });\n }\n\n /**\n * `label ……… value` on one line when it fits; otherwise the label wraps and\n * the value closes its last line, or takes a line of its own, right-aligned.\n * Nothing passes the roll's width.\n */\n pair(division: DanfeDivision, label: string, value: string, emphasis: DanfeLine[\"emphasis\"] = \"normal\"): void {\n const labelLines = wrap(label, this.width);\n const last = labelLines.pop() ?? \"\";\n for (const piece of labelLines) this.lines.push({ division, text: piece, align: \"left\", emphasis });\n const closing = last.length + 1 + value.length <= this.width ? [spread(last, value, this.width)] : [last, value.padStart(this.width)];\n for (const piece of closing) this.lines.push({ division, text: piece, align: \"left\", emphasis });\n }\n\n rule(division: DanfeDivision): void {\n this.lines.push({ division, text: \"-\".repeat(this.width), align: \"left\", emphasis: \"normal\" });\n }\n}\n\ninterface Parsed {\n readonly infNFe: string;\n readonly ide: string;\n readonly emit: string;\n readonly total: string;\n /** `infNFeSupl`, beside `infNFe`: the QR code and the lookup URL. */\n readonly supl: string;\n readonly accessKey: string;\n readonly contingency: boolean;\n /** The authorisation protocol, once SEFAZ has answered (the `nfeProc`). */\n readonly infProt: string | null;\n readonly homologation: boolean;\n}\n\nfunction parse(xml: string): Parsed {\n const infNFe = element(xml, \"infNFe\");\n const ide = infNFe === null ? null : element(infNFe, \"ide\");\n const emit = infNFe === null ? null : element(infNFe, \"emit\");\n const accessKey = accessKeyOf(xml);\n if (infNFe === null || ide === null || emit === null || accessKey === null) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", \"the XML is not an NF-e: no infNFe, ide, emit or access key.\");\n }\n if (text(ide, \"mod\") !== \"65\") throw new FiscalDocumentError(\"INVALID_INPUT\", \"the XML is not an NFC-e (model 65).\");\n return {\n infNFe,\n ide,\n emit,\n total: element(infNFe, \"ICMSTot\") ?? \"\",\n supl: element(xml, \"infNFeSupl\") ?? \"\",\n accessKey,\n contingency: text(ide, \"tpEmis\") === \"9\",\n infProt: element(xml, \"infProt\"),\n homologation: text(ide, \"tpAmb\") === \"2\",\n };\n}\n\nfunction issuerPart(paper: Paper, doc: Parsed, labels: DanfeNfceLabels): void {\n const address = element(doc.emit, \"enderEmit\");\n paper.add(\"I\", text(doc.emit, \"xNome\") ?? \"\", \"center\", \"bold\");\n paper.add(\"I\", `${labels.cnpj} ${text(doc.emit, \"CNPJ\") ?? \"\"} ${labels.stateRegistration} ${text(doc.emit, \"IE\") ?? \"\"}`, \"center\");\n const street = [text(address, \"xLgr\"), text(address, \"nro\"), text(address, \"xBairro\"), text(address, \"xMun\"), text(address, \"UF\")];\n paper.add(\"I\", street.filter((part) => part !== null && part !== \"\").join(\", \"), \"center\");\n paper.add(\"II\", labels.title, \"center\", \"bold\");\n paper.rule(\"II\");\n}\n\nfunction itemsPart(paper: Paper, doc: Parsed, labels: DanfeNfceLabels): number {\n paper.add(\"III\", labels.itemsHeader);\n const items = elements(doc.infNFe, \"det\");\n for (const det of items) {\n const prod = element(det, \"prod\");\n paper.add(\"III\", `${text(prod, \"cProd\") ?? \"\"} ${text(prod, \"xProd\") ?? \"\"}`);\n const amount = `${quantity(text(prod, \"qCom\"))} ${text(prod, \"uCom\") ?? \"\"} x ${money(text(prod, \"vUnCom\"))}`;\n paper.pair(\"III\", amount, money(text(prod, \"vProd\")));\n }\n paper.rule(\"III\");\n return items.length;\n}\n\nfunction totalsPart(paper: Paper, doc: Parsed, labels: DanfeNfceLabels, count: number): void {\n paper.pair(\"IV\", labels.itemCount, String(count));\n paper.pair(\"IV\", labels.totalValue, money(text(doc.total, \"vProd\")));\n const discount = text(doc.total, \"vDesc\");\n if (discount !== null && Number(discount) > 0) paper.pair(\"IV\", labels.discounts, money(discount));\n paper.pair(\"IV\", labels.amountDue, money(text(doc.total, \"vNF\")), \"bold\");\n paper.add(\"IV\", labels.paymentHeader);\n for (const detPag of elements(doc.infNFe, \"detPag\")) {\n const code = text(detPag, \"tPag\") ?? \"\";\n paper.pair(\"IV\", text(detPag, \"xPag\") ?? labels.paymentMethods[code] ?? code, money(text(detPag, \"vPag\")));\n }\n const change = text(element(doc.infNFe, \"pag\"), \"vTroco\");\n if (change !== null && Number(change) > 0) paper.pair(\"IV\", labels.change, money(change));\n paper.rule(\"IV\");\n}\n\nfunction fiscalMessagePart(paper: Paper, doc: Parsed, labels: DanfeNfceLabels): void {\n if (doc.homologation) paper.add(\"V\", labels.homologation, \"center\", \"bold\");\n if (doc.contingency) paper.add(\"V\", labels.contingency, \"center\", \"bold\");\n // Offline and not yet authorised: ONE copy, the consumer's (reprints are the same paper).\n if (doc.contingency && doc.infProt === null) {\n paper.add(\"V\", labels.pendingAuthorization, \"center\", \"bold\");\n paper.add(\"V\", labels.consumerCopy, \"center\", \"bold\");\n }\n paper.add(\"V\", labels.lookupByKey, \"center\");\n paper.add(\"V\", text(doc.supl, \"urlChave\") ?? \"\", \"center\");\n paper.add(\"V\", groupKey(doc.accessKey), \"center\");\n paper.rule(\"V\");\n}\n\nfunction consumerPart(paper: Paper, doc: Parsed, labels: DanfeNfceLabels): void {\n const dest = element(doc.infNFe, \"dest\");\n const id = text(dest, \"CPF\") ?? text(dest, \"CNPJ\") ?? text(dest, \"idEstrangeiro\");\n if (id === null) {\n paper.add(\"VI\", labels.unidentifiedConsumer, \"center\");\n } else {\n paper.add(\"VI\", `${labels.consumer} ${id}`, \"center\");\n const name = text(dest, \"xNome\");\n if (name !== null) paper.add(\"VI\", name, \"center\");\n }\n paper.rule(\"VI\");\n}\n\nfunction identificationPart(paper: Paper, doc: Parsed, labels: DanfeNfceLabels): void {\n const issued = (text(doc.ide, \"dhEmi\") ?? \"\").replace(\"T\", \" \").slice(0, 19);\n paper.add(\"VII\", `${labels.number} ${text(doc.ide, \"nNF\") ?? \"\"} ${labels.series} ${text(doc.ide, \"serie\") ?? \"\"} ${issued}`, \"center\", \"bold\");\n const { infProt } = doc;\n if (infProt !== null) {\n paper.add(\"VII\", `${labels.protocol} ${text(infProt, \"nProt\") ?? \"\"}`, \"center\");\n paper.add(\"VII\", `${labels.authorizedAt} ${(text(infProt, \"dhRecbto\") ?? \"\").replace(\"T\", \" \").slice(0, 19)}`, \"center\");\n }\n}\n\nfunction qrPart(paper: Paper, doc: Parsed, labels: DanfeNfceLabels): void {\n const qrCode = text(doc.supl, \"qrCode\");\n if (qrCode === null) throw new FiscalDocumentError(\"INVALID_INPUT\", \"the NFC-e XML carries no QR code (infNFeSupl/qrCode).\");\n paper.add(\"VIII\", labels.qrCaption, \"center\");\n paper.lines.push({ division: \"VIII\", text: \"\", align: \"center\", emphasis: \"normal\", qrCode });\n const message = text(element(doc.infNFe, \"infAdic\"), \"infCpl\");\n if (message !== null && message !== \"\") paper.add(\"VIII\", message);\n const taxes = text(doc.total, \"vTotTrib\");\n if (taxes !== null && Number(taxes) > 0) paper.add(\"VIII\", `${labels.approximateTaxes} ${money(taxes)}`);\n}\n\nexport function renderDanfeNfce(input: DanfeNfceInput): DanfeLine[] {\n const missing = DANFE_LABEL_KEYS.filter((key) => input.labels?.[key] === undefined);\n if (missing.length > 0) throw new FiscalDocumentError(\"INVALID_INPUT\", `labels is missing: ${missing.join(\", \")}.`);\n const width = DANFE_COLUMNS[input.paperWidth];\n if (width === undefined) throw new FiscalDocumentError(\"INVALID_INPUT\", \"paperWidth must be 58 or 80.\");\n const doc = parse(input.xml);\n const paper = new Paper(width);\n issuerPart(paper, doc, input.labels);\n const count = itemsPart(paper, doc, input.labels);\n totalsPart(paper, doc, input.labels, count);\n fiscalMessagePart(paper, doc, input.labels);\n consumerPart(paper, doc, input.labels);\n identificationPart(paper, doc, input.labels);\n qrPart(paper, doc, input.labels);\n return paper.lines;\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/http.ts"],"sourcesContent":["/**\n * `createApiFiscal` — the fiscal HTTP surface as framework-neutral route\n * descriptors (the wiring contract's `http` capability, restated here\n * structurally: this package imports nothing from the contract at runtime,\n * and its manifest suite pins the twins).\n *\n * The package owns the paths, the bodies it reads (`./documents/profile-input`,\n * unknown keys refused), the `{ data }` envelope, the permission each route\n * needs and the status a refusal earns ({@link FISCAL_ERROR_STATUS}). The host\n * owns resolving WHO is calling into the opaque `ownerId` of its tenant, the\n * guards that check the declared permission, and every word a person reads:\n * an error answers a `code` for the host to word, never a sentence for a user.\n *\n * Nothing secret leaves: the profile answers `hasCertificate` / `hasCsc`, never\n * a ciphertext, and the certificate upload answers the profile view.\n */\n\nimport { type DanfeNfceLabels } from \"./danfe/labels\";\nimport { type PaperWidth, renderDanfeNfce } from \"./danfe/render\";\nimport { FiscalDocumentError, type FiscalDocumentErrorCode } from \"./documents/errors\";\nimport type { DocumentStorage } from \"./documents/ports\";\nimport { parseCertificateUpload, parseIssuingPointInput, parseProfileInput } from \"./documents/profile-input\";\nimport { viewOf } from \"./documents/profile\";\nimport type { FiscalDocuments } from \"./documents/service\";\nimport { FISCAL_DOCUMENT_MODELS, type FiscalDocumentModel } from \"./documents/types\";\nimport { FISCAL_CANCEL, FISCAL_ISSUE, FISCAL_MANAGE, FISCAL_READ } from \"./manifest/permissions\";\n\n/** The caller, as the host's adapter resolved it. */\nexport interface FiscalHttpActor {\n /** The emitter profile's owner: the host's tenant, mapped to an opaque id. */\n readonly ownerId: string;\n}\n\n/** Structural twin of the wiring contract's `WireRequest<FiscalHttpActor>`. */\nexport interface FiscalHttpRequest {\n actor: FiscalHttpActor;\n params: Record<string, string | undefined>;\n query: Record<string, string | undefined>;\n body?: unknown;\n}\n\n/** Structural twin of the wiring contract's `WireResponse`. */\nexport interface FiscalHttpResponse {\n status: number;\n body: unknown;\n}\n\n/** Structural twin of the wiring contract's `WireRoute<FiscalHttpActor>`. */\nexport interface FiscalRoute {\n method: \"GET\" | \"POST\" | \"PUT\";\n path: string;\n permission: string;\n handle(request: FiscalHttpRequest): Promise<FiscalHttpResponse>;\n}\n\nexport interface FiscalApiConfig {\n readonly documents: FiscalDocuments;\n /** Where the XMLs are, to render a DANFE from. */\n readonly storage: DocumentStorage;\n /** The DANFE's words: the host's, or `@12-apps/fiscal/danfe/pt-BR`. */\n readonly danfeLabels: DanfeNfceLabels;\n}\n\nexport const FISCAL_ERROR_STATUS = {\n INVALID_INPUT: 400,\n NOT_FOUND: 404,\n NOT_ISSUABLE: 409,\n NOT_SUPPORTED: 501,\n TRANSITION_REFUSED: 409,\n SERIES_EXHAUSTED: 409,\n CONFLICT: 409,\n SUBJECT_HAS_DOCUMENT: 409,\n NOT_PRINTABLE: 409,\n RESEND_CHANGES_PRINTED_FIELDS: 422,\n RETURN_NEEDS_REFERENCE: 422,\n RETURN_ON_NFCE: 422,\n RETURN_OF_NFCE_ONLY: 422,\n} as const satisfies Record<FiscalDocumentErrorCode, number>;\n\n/**\n * The states with paper: an authorised document, and one signed offline and\n * not yet transmitted (its DANFE is what the buyer takes). A denied,\n * cancelled, rejected or replaced document is not a valid DANFE.\n */\nconst PRINTABLE = new Set([\"AUTHORIZED\", \"CONTINGENCY\"]);\n\nconst ok = (data: unknown, status = 200): FiscalHttpResponse => ({ status, body: { data } });\n\nasync function answering(run: () => Promise<FiscalHttpResponse>): Promise<FiscalHttpResponse> {\n try {\n return await run();\n } catch (error) {\n if (error instanceof FiscalDocumentError) {\n return { status: FISCAL_ERROR_STATUS[error.code], body: { error: error.code, message: error.message } };\n }\n throw error;\n }\n}\n\nfunction record(body: unknown): Record<string, unknown> {\n if (body === null || typeof body !== \"object\" || Array.isArray(body)) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", \"the body must be an object.\");\n }\n return body as Record<string, unknown>;\n}\n\nfunction stringField(body: Record<string, unknown>, key: string): string {\n const value = body[key];\n if (typeof value !== \"string\" || value === \"\") throw new FiscalDocumentError(\"INVALID_INPUT\", `${key} is required.`);\n return value;\n}\n\nfunction param(request: FiscalHttpRequest, key: string): string {\n const value = request.params[key];\n if (value === undefined || value === \"\") throw new FiscalDocumentError(\"INVALID_INPUT\", `${key} is required.`);\n return value;\n}\n\nconst ISSUE_KEYS = new Set([\"subjectId\", \"issuingPointId\", \"model\", \"offline\"]);\n\nfunction issueBody(body: unknown): { subjectId: string; issuingPointId: string; model: FiscalDocumentModel; offline: boolean } {\n const fields = record(body);\n const unknown = Object.keys(fields).filter((key) => !ISSUE_KEYS.has(key));\n if (unknown.length > 0) throw new FiscalDocumentError(\"INVALID_INPUT\", `unknown keys: ${unknown.join(\", \")}.`);\n const model = fields[\"model\"];\n if (!FISCAL_DOCUMENT_MODELS.includes(model as FiscalDocumentModel)) throw new FiscalDocumentError(\"INVALID_INPUT\", \"model must be NFE or NFCE.\");\n const offline = fields[\"offline\"] ?? false;\n if (typeof offline !== \"boolean\") throw new FiscalDocumentError(\"INVALID_INPUT\", \"offline must be a boolean.\");\n if (offline && model !== \"NFCE\") throw new FiscalDocumentError(\"INVALID_INPUT\", \"only an NFC-e is issued offline.\");\n return { subjectId: stringField(fields, \"subjectId\"), issuingPointId: stringField(fields, \"issuingPointId\"), model: model as FiscalDocumentModel, offline };\n}\n\nfunction profileRoutes({ documents }: FiscalApiConfig): FiscalRoute[] {\n return [\n {\n method: \"GET\",\n path: \"/fiscal/profile\",\n permission: FISCAL_READ,\n handle: ({ actor }) =>\n answering(async () => {\n const profile = await documents.getProfile(actor.ownerId);\n return ok(profile === null ? null : viewOf(profile));\n }),\n },\n {\n method: \"PUT\",\n path: \"/fiscal/profile\",\n permission: FISCAL_MANAGE,\n handle: ({ actor, body }) => answering(async () => ok(viewOf(await documents.saveProfile(actor.ownerId, parseProfileInput(body))))),\n },\n {\n method: \"PUT\",\n path: \"/fiscal/profile/certificate\",\n permission: FISCAL_MANAGE,\n handle: ({ actor, body }) =>\n answering(async () => ok(viewOf(await documents.uploadCertificate(actor.ownerId, parseCertificateUpload(body))))),\n },\n {\n method: \"GET\",\n path: \"/fiscal/issuing-points\",\n permission: FISCAL_READ,\n handle: ({ actor }) => answering(async () => ok(await documents.listIssuingPoints(actor.ownerId))),\n },\n {\n method: \"POST\",\n path: \"/fiscal/issuing-points\",\n permission: FISCAL_MANAGE,\n handle: ({ actor, body }) =>\n answering(async () => ok(await documents.createIssuingPoint(actor.ownerId, parseIssuingPointInput(body)), 201)),\n },\n ];\n}\n\n/** The DANFE of a printable document, as ESC/POS-ready lines. */\nfunction danfeRoute({ documents, storage, danfeLabels }: FiscalApiConfig): FiscalRoute {\n return {\n method: \"GET\",\n path: \"/fiscal/documents/:documentId/danfe\",\n permission: FISCAL_READ,\n handle: (request) =>\n answering(async () => {\n const paper = Number(request.query[\"paper\"] ?? \"80\");\n if (paper !== 58 && paper !== 80) throw new FiscalDocumentError(\"INVALID_INPUT\", \"paper must be 58 or 80.\");\n const document = await documents.getDocument(request.actor.ownerId, param(request, \"documentId\"));\n if (!PRINTABLE.has(document.status)) {\n throw new FiscalDocumentError(\"NOT_PRINTABLE\", `document ${document.id} is ${document.status}: only an AUTHORIZED or CONTINGENCY document prints.`);\n }\n const xml = document.model === \"NFCE\" && document.xmlKey !== null ? await storage.get(document.xmlKey) : null;\n if (xml === null) throw new FiscalDocumentError(\"NOT_FOUND\", `document ${document.id} has no NFC-e XML to print.`);\n return ok(renderDanfeNfce({ xml, paperWidth: paper as PaperWidth, labels: danfeLabels }));\n }),\n };\n}\n\nfunction documentRoutes(config: FiscalApiConfig): FiscalRoute[] {\n const { documents } = config;\n return [\n {\n method: \"POST\",\n path: \"/fiscal/documents\",\n permission: FISCAL_ISSUE,\n handle: ({ actor, body }) =>\n answering(async () => {\n const { offline, ...input } = issueBody(body);\n const document = offline\n ? await documents.issueOffline({ ownerId: actor.ownerId, subjectId: input.subjectId, issuingPointId: input.issuingPointId })\n : await documents.issue({ ownerId: actor.ownerId, ...input });\n return ok(document);\n }),\n },\n {\n method: \"GET\",\n path: \"/fiscal/documents/:documentId\",\n permission: FISCAL_READ,\n handle: (request) =>\n answering(async () => {\n const documentId = param(request, \"documentId\");\n const document = await documents.getDocument(request.actor.ownerId, documentId);\n return ok({ document, events: await documents.listEvents(request.actor.ownerId, documentId) });\n }),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/cancel\",\n permission: FISCAL_CANCEL,\n handle: (request) =>\n answering(async () => {\n const reason = stringField(record(request.body), \"reason\");\n const result = await documents.cancel({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\"), reason });\n return result.failure === null\n ? ok(result.document)\n : { status: 422, body: { error: \"ISSUER_FAILURE\", failure: result.failure, data: result.document } };\n }),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/resend\",\n permission: FISCAL_ISSUE,\n handle: (request) =>\n answering(async () =>\n ok(await documents.resendContingency({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\") })),\n ),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/release\",\n permission: FISCAL_ISSUE,\n handle: (request) =>\n answering(async () => ok(await documents.release({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\") }))),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/lookup\",\n permission: FISCAL_READ,\n handle: (request) =>\n answering(async () => ok(await documents.lookup({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\") }))),\n },\n danfeRoute(config),\n ];\n}\n\nexport function createApiFiscal(config: FiscalApiConfig): { routes: readonly FiscalRoute[] } {\n if (config?.documents === undefined) throw new TypeError(\"createApiFiscal needs documents.\");\n if (config.storage === undefined) throw new TypeError(\"createApiFiscal needs storage.\");\n if (config.danfeLabels === undefined) throw new TypeError(\"createApiFiscal needs danfeLabels.\");\n return { routes: [...profileRoutes(config), ...documentRoutes(config)] };\n}\n"],"mappings":"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","names":[]}
|
|
File without changes
|
|
File without changes
|