@12-apps/fiscal 1.4.0 → 1.5.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/dist/{chunk-2ISYBTCE.js → chunk-3E3NBXSW.js} +11 -4
- package/dist/chunk-3E3NBXSW.js.map +1 -0
- package/dist/{chunk-OSYB7CVT.js → chunk-G6QNU4FD.js} +2 -2
- package/dist/{chunk-GF3DXCD2.js → chunk-GH452ITO.js} +1 -1
- package/dist/{chunk-GF3DXCD2.js.map → chunk-GH452ITO.js.map} +1 -1
- package/dist/{chunk-EDEGIADD.js → chunk-HMTPJWXM.js} +2 -2
- package/dist/{chunk-F2PGQVWL.js → chunk-TJCUO6D6.js} +3 -3
- package/dist/{chunk-JVQKJNOC.js → chunk-ZKWVKCGJ.js} +1 -1
- package/dist/chunk-ZKWVKCGJ.js.map +1 -0
- package/dist/{context-CLSMOSuf.d.ts → context-CwZiHLnY.d.ts} +14 -3
- package/dist/documents/index.d.ts +7 -5
- package/dist/documents/index.js +92 -3
- package/dist/documents/index.js.map +1 -1
- package/dist/http.d.ts +3 -3
- package/dist/http.js +3 -3
- package/dist/issuer/index.d.ts +2 -2
- package/dist/issuer/index.js +9 -1
- package/dist/issuer/index.js.map +1 -1
- package/dist/jobs.d.ts +3 -3
- package/dist/jobs.js +3 -3
- package/dist/manifest/server.d.ts +3 -3
- package/dist/manifest/server.js +5 -5
- package/dist/notifications.d.ts +2 -2
- package/dist/notifications.js +2 -2
- package/dist/sale/index.d.ts +29 -1
- package/dist/sale/index.js +7 -0
- package/dist/sale/index.js.map +1 -1
- package/dist/{service-hR3tgLpO.d.ts → service-Cz2O84Xr.d.ts} +38 -4
- package/dist/sidecar/index.d.ts +37 -1
- package/dist/sidecar/index.js +1 -1
- package/dist/{types-BIJqm5GM.d.ts → types-DSYwap42.d.ts} +25 -4
- package/package.json +1 -1
- package/prisma/migrations/20261118120000_fiscal_link_payment_event/migration.sql +9 -0
- package/sidecar/README.md +1 -0
- package/sidecar/composer.json +1 -1
- package/sidecar/composer.lock +7 -7
- package/sidecar/schema/sale-for-document.schema.json +18 -1
- package/sidecar/src/Nfe/DocumentMapper.php +27 -0
- package/sidecar/src/Nfe/Input.php +10 -0
- package/sidecar/src/Nfe/NfeModule.php +1 -0
- package/sidecar/src/Nfe/NfeService.php +120 -0
- package/sidecar/src/Nfe/SefazReply.php +21 -0
- package/src/documents/helpers.ts +2 -0
- package/src/documents/index.ts +2 -1
- package/src/documents/machine-steps.ts +12 -2
- package/src/documents/machine.ts +7 -0
- package/src/documents/payment-link.ts +156 -0
- package/src/documents/service.ts +4 -0
- package/src/documents/types.ts +2 -1
- package/src/issuer/port.ts +24 -1
- package/src/issuer/sidecar.ts +10 -0
- package/src/sale/index.ts +1 -0
- package/src/sale/types.ts +30 -0
- package/src/sidecar/types.ts +38 -0
- package/dist/chunk-2ISYBTCE.js.map +0 -1
- package/dist/chunk-JVQKJNOC.js.map +0 -1
- /package/dist/{chunk-OSYB7CVT.js.map → chunk-G6QNU4FD.js.map} +0 -0
- /package/dist/{chunk-EDEGIADD.js.map → chunk-HMTPJWXM.js.map} +0 -0
- /package/dist/{chunk-F2PGQVWL.js.map → chunk-TJCUO6D6.js.map} +0 -0
package/src/sidecar/types.ts
CHANGED
|
@@ -80,6 +80,22 @@ export interface CancelBySubstitutionRequest extends CancelRequest {
|
|
|
80
80
|
readonly substituteAccessKey: string;
|
|
81
81
|
}
|
|
82
82
|
|
|
83
|
+
/** `POST /<model>/link-payment`: the event 110300 for one transaction (NT 2026.006 v1.00). */
|
|
84
|
+
export interface LinkPaymentRequest extends Authenticated {
|
|
85
|
+
readonly accessKey: string;
|
|
86
|
+
/** The authorisation protocol (`nProt`). */
|
|
87
|
+
readonly protocol: string;
|
|
88
|
+
/** `nSeqEvento`, 1–20: this document's how-manieth 110300. */
|
|
89
|
+
readonly sequence: number;
|
|
90
|
+
/** Exactly one entry: the event's schema carries a single `gPgto`. */
|
|
91
|
+
readonly payments: ReadonlyArray<{
|
|
92
|
+
readonly transactionId: string;
|
|
93
|
+
readonly meansCode: string;
|
|
94
|
+
readonly pspCnpjBase: string;
|
|
95
|
+
readonly receiverCnpj: string;
|
|
96
|
+
}>;
|
|
97
|
+
}
|
|
98
|
+
|
|
83
99
|
/** `POST /<model>/lookup`. */
|
|
84
100
|
export interface LookupRequest extends Authenticated {
|
|
85
101
|
readonly accessKey: string;
|
|
@@ -156,6 +172,28 @@ export interface CancelledDocument extends SefazAnswer {
|
|
|
156
172
|
readonly eventXml: string | null;
|
|
157
173
|
}
|
|
158
174
|
|
|
175
|
+
/**
|
|
176
|
+
* `/link-payment`: the event registered. On 573 "Duplicidade de Evento" the
|
|
177
|
+
* service looks the key up and answers the event SEFAZ already holds at that
|
|
178
|
+
* `nSeqEvento`, with its own XML and the transaction it carries — which may be
|
|
179
|
+
* another transaction than the one sent (`statusCode` "573" tells the two apart).
|
|
180
|
+
*/
|
|
181
|
+
export interface RegisteredPaymentLink extends SefazAnswer {
|
|
182
|
+
readonly status: "REGISTERED";
|
|
183
|
+
readonly accessKey: string;
|
|
184
|
+
readonly protocol: string | null;
|
|
185
|
+
readonly registeredAt: string | null;
|
|
186
|
+
/** The `procEventoNFe`. */
|
|
187
|
+
readonly eventXml: string | null;
|
|
188
|
+
/** The `gPgto` SEFAZ registered at this `nSeqEvento`. */
|
|
189
|
+
readonly transaction: {
|
|
190
|
+
readonly transactionId: string;
|
|
191
|
+
readonly meansCode: string;
|
|
192
|
+
readonly pspCnpjBase: string;
|
|
193
|
+
readonly receiverCnpj: string;
|
|
194
|
+
};
|
|
195
|
+
}
|
|
196
|
+
|
|
159
197
|
/** `/lookup`: what SEFAZ knows of the key. `NOT_FOUND` is an answer, not an error. */
|
|
160
198
|
export interface LookedUpDocument extends SefazAnswer {
|
|
161
199
|
readonly status: "AUTHORIZED" | "CANCELLED" | "DENIED" | "NOT_FOUND";
|
|
@@ -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 SidecarErrorBody,\n} from \"../sidecar/types\";\nimport type { 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\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};\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 * `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};\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 (\"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 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":";;;;;;;;;;;;;;;AAsBO,IAAM,eAAe;AAgDrB,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;AACR;;;ACjOA,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;AACtB;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,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;AALS;AAOT,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;;;AC/GT,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,EACR,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;;;ACxFT,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/sidecar/types.ts"],"sourcesContent":["/**\n * The wire contract of the fiscal service (`sidecar/` in this package): a\n * stateless HTTP door in front of sped-nfe. JSON in, JSON out.\n *\n * Stateless means every call carries what it needs: the signing certificate\n * (an A1 `.pfx` as base64 and its password) and, for an NFC-e, the CSC. The\n * service keeps nothing between calls, writes nothing to disk and never logs\n * any of the three.\n */\n\nimport type { SaleForDocument } from \"../sale/types\";\n\n/** The path segment of a document model: `nfe` is model 55, `nfce` model 65. */\nexport type DocumentModelPath = \"nfe\" | \"nfce\";\n\n/** The SEFAZ environment (`tpAmb` 2 and 1). */\nexport type SefazEnvironment = \"homologacao\" | \"producao\";\n\n/** The A1 certificate, per call. */\nexport interface SigningCertificate {\n /** The `.pfx` (PKCS#12) bytes, base64. */\n readonly pfxBase64: string;\n readonly password: string;\n}\n\n/** The NFC-e's Código de Segurança do Contribuinte and its id. */\nexport interface Csc {\n readonly id: string;\n readonly token: string;\n}\n\ninterface Authenticated {\n readonly environment: SefazEnvironment;\n readonly certificate: SigningCertificate;\n}\n\n/**\n * `POST /<model>/issue`: builds, signs and transmits. `csc` is required for\n * `nfce` and refused for `nfe`.\n */\nexport interface IssueRequest extends Authenticated {\n readonly csc: Csc | null;\n readonly document: SaleForDocument;\n}\n\n/** Why and since when the caixa issues offline (`dhCont`, `xJust`). */\nexport interface ContingencyEntry {\n /** ISO 8601 with the UTC offset. */\n readonly since: string;\n /** 15–256 characters. */\n readonly reason: string;\n}\n\n/** `POST /nfce/sign-contingency`: builds and signs with `tpEmis = 9`; does NOT transmit. */\nexport interface SignContingencyRequest extends IssueRequest {\n readonly contingency: ContingencyEntry;\n}\n\n/** `POST /<model>/transmit`: an already signed XML (from `/nfce/sign-contingency`, say). */\nexport interface TransmitRequest extends Authenticated {\n readonly signedXml: string;\n}\n\n/** `POST /<model>/cancel`: the UF and the issuer come from the access key. */\nexport interface CancelRequest extends Authenticated {\n readonly accessKey: string;\n /** The authorisation protocol (`nProt`). */\n readonly protocol: string;\n /** 15–255 characters. */\n readonly reason: string;\n}\n\n/**\n * `POST /nfce/cancel-substitution`: the NFC-e \"cancelamento por substituição\"\n * (event 110112) — an online NFC-e found authorised after its sale was issued\n * again in contingency, cancelled naming the substitute. Answers as `/cancel`.\n */\nexport interface CancelBySubstitutionRequest extends CancelRequest {\n /** The contingency document that replaced it (`chNFeRef`). */\n readonly substituteAccessKey: string;\n}\n\n/** `POST /<model>/lookup`. */\nexport interface LookupRequest extends Authenticated {\n readonly accessKey: string;\n}\n\n/** `POST /inutilize`: voids a range of unused numbers. */\nexport interface InutilizeRequest extends Authenticated {\n readonly model: DocumentModelPath;\n readonly uf: string;\n readonly cnpj: string;\n /** The year of the numbers, four digits. */\n readonly year: number;\n readonly series: number;\n readonly from: number;\n readonly to: number;\n /** 15–255 characters. */\n readonly reason: string;\n}\n\n/** What SEFAZ answered, as the service read it. */\nexport interface SefazAnswer {\n /** `cStat`. */\n readonly statusCode: string;\n /** `xMotivo`. */\n readonly statusReason: string;\n /** The SOAP body SEFAZ returned, verbatim. */\n readonly sefazReply: string;\n}\n\n/**\n * `/issue` and `/transmit`: SEFAZ's final answer on the document.\n *\n * - `AUTHORIZED` (100, 120, 150).\n * - `DENIED` (110, 301, 302, 303): a denial of use. The number is SPENT and\n * the denial is kept like an authorisation (its `authorizedXml` carries the\n * denial protocol); it is not a rejection, which leaves the number free.\n *\n * A retried call answers the same: SEFAZ's \"already authorised\" (204) and\n * \"already denied\" (205), and a request sent with no answer, are settled by\n * looking the key up, so a retry never turns an authorised document into an error.\n */\nexport interface IssuedDocument extends SefazAnswer {\n readonly status: \"AUTHORIZED\" | \"DENIED\";\n readonly accessKey: string;\n readonly protocol: string;\n /** `dhRecbto` of the protocol. */\n readonly authorizedAt: string;\n readonly signedXml: string;\n /** The `nfeProc`: the signed XML with its protocol (of authorisation or of denial), what is stored. */\n readonly authorizedXml: string;\n}\n\n/** `/nfce/sign-contingency`. */\nexport interface ContingencySignedDocument {\n readonly status: \"SIGNED\";\n readonly accessKey: string;\n /** Carries `tpEmis = 9` and the QR code; transmit it later through `/nfce/transmit`. */\n readonly signedXml: string;\n}\n\n/**\n * `/cancel`. A retried cancel (SEFAZ's 218 \"already cancelled\" or 573\n * \"duplicate event\", or a cancel sent with no answer) is settled by looking\n * the key up, and answers CANCELLED with what the lookup carries: the event's\n * protocol and XML when SEFAZ returns them, `null` when it does not.\n */\nexport interface CancelledDocument extends SefazAnswer {\n readonly status: \"CANCELLED\";\n readonly accessKey: string;\n /** The event's protocol. */\n readonly protocol: string | null;\n readonly registeredAt: string | null;\n /** The `procEventoNFe`. */\n readonly eventXml: string | null;\n}\n\n/** `/lookup`: what SEFAZ knows of the key. `NOT_FOUND` is an answer, not an error. */\nexport interface LookedUpDocument extends SefazAnswer {\n readonly status: \"AUTHORIZED\" | \"CANCELLED\" | \"DENIED\" | \"NOT_FOUND\";\n readonly accessKey: string;\n readonly protocol: string | null;\n}\n\n/**\n * `/inutilize`. A retried inutilização (563, \"a request for the same range\n * already exists\") answers INUTILIZED too, with `protocol` and\n * `inutilizationXml` `null`: the range is void at SEFAZ, and SEFAZ offers no\n * query that would return the first protocol.\n */\nexport interface InutilizedRange extends SefazAnswer {\n readonly status: \"INUTILIZED\";\n readonly protocol: string | null;\n readonly registeredAt: string | null;\n /** The signed request with its reply (`procInutNFe`). */\n readonly inutilizationXml: string | null;\n}\n\n/**\n * How a failed call is classified — the issuer port's own classes:\n *\n * - `REJECTED`: SEFAZ refused the document or the event; `code` is its `cStat`.\n * The number is NOT spent (a denial is not an error: it answers `DENIED`).\n * - `RETRYABLE`: try the same call again later. When `outcomeUnknown` is true\n * the request went out and neither it nor the lookup that would settle it\n * was answered: look the key up before sending it again.\n * - `CONTINGENCY`: SEFAZ is unavailable. For an NFC-e being issued, nothing\n * reached SEFAZ (or the lookup after an unanswered request could not reach\n * it): go offline through `/nfce/sign-contingency`. For an NF-e (model 55)\n * the service has no offline path (no SVC, no EPEC): treat it as RETRYABLE.\n * - `AUTH`: the certificate is unreadable, the password wrong, the certificate\n * expired, or SEFAZ refused it.\n * - `INVALID`: the request itself is malformed (the schema, a missing CSC, an\n * XML the layout refuses, a document the layout version cannot express).\n * Fix the input; never retry it as is.\n * - `INTERNAL`: a defect of the service, or a 4xx other than 403/408/429 from\n * the verified SEFAZ host (a wrong web-service address). A retry would only repeat it.\n */\nexport type SidecarErrorClass = \"REJECTED\" | \"RETRYABLE\" | \"CONTINGENCY\" | \"AUTH\" | \"INVALID\" | \"INTERNAL\";\n\nexport const SIDECAR_ERROR_CLASSES: readonly SidecarErrorClass[] = [\n \"REJECTED\",\n \"RETRYABLE\",\n \"CONTINGENCY\",\n \"AUTH\",\n \"INVALID\",\n \"INTERNAL\",\n];\n\n/** The body of every non-2xx answer. */\nexport interface SidecarErrorBody {\n readonly error: {\n readonly class: SidecarErrorClass;\n /**\n * The SEFAZ `cStat` when SEFAZ answered (always for `REJECTED`); for\n * `INVALID`, a named code where one applies (`NT_2026_008_NOT_SUPPORTED`:\n * a document issued on or after 2027-01-01, which needs NT 2026.008's\n * `vProdLiq`; `RETURN_ON_NFCE`: a return asked of an NFC-e, which has no\n * return purpose; `RETURN_NEEDS_REFERENCE`: a return quoting no\n * `referencedDocuments`); `null` otherwise.\n */\n readonly code: string | null;\n readonly message: string;\n /** Per-field problems of an `INVALID` request. */\n readonly details: readonly string[];\n /** When the call got as far as building and signing: keep it, the key is now spoken for. */\n readonly accessKey: string | null;\n readonly signedXml: string | null;\n readonly sefazReply: string | null;\n /** The request went out and its outcome is still unknown: look the key up before sending it again. */\n readonly outcomeUnknown: boolean;\n };\n}\n\n/** `GET /health`. */\nexport interface SidecarHealth {\n readonly status: \"ok\";\n /** The libraries the service runs, by name, with the version installed. */\n readonly libraries: Readonly<Record<string, string>>;\n /** The schema package the NF-e layout is validated against. */\n readonly nfeSchemas: string;\n /** Whether SEFAZ's server certificate is verified; `false` only with `FISCAL_SEFAZ_TLS_VERIFY=off`. */\n readonly sefazTlsVerify: boolean;\n}\n"],"mappings":";AAyMO,IAAM,wBAAsD;AAAA,EACjE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
|
|
File without changes
|
|
File without changes
|
|
File without changes
|