@12-apps/fiscal 0.0.0-stage → 1.1.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.
Files changed (155) hide show
  1. package/README.md +269 -2
  2. package/dist/chunk-27B4HNO6.js +574 -0
  3. package/dist/chunk-27B4HNO6.js.map +1 -0
  4. package/dist/chunk-3SDXLSG4.js +24 -0
  5. package/dist/chunk-3SDXLSG4.js.map +1 -0
  6. package/dist/chunk-7QVYU63E.js +7 -0
  7. package/dist/chunk-7QVYU63E.js.map +1 -0
  8. package/dist/chunk-ALABGVPO.js +247 -0
  9. package/dist/chunk-ALABGVPO.js.map +1 -0
  10. package/dist/chunk-FOFIN5M7.js +14 -0
  11. package/dist/chunk-FOFIN5M7.js.map +1 -0
  12. package/dist/chunk-HQ2NXSTX.js +85 -0
  13. package/dist/chunk-HQ2NXSTX.js.map +1 -0
  14. package/dist/chunk-PNTKG3DZ.js +47 -0
  15. package/dist/chunk-PNTKG3DZ.js.map +1 -0
  16. package/dist/chunk-RRFKYVLZ.js +192 -0
  17. package/dist/chunk-RRFKYVLZ.js.map +1 -0
  18. package/dist/chunk-V5ZQAAJT.js +210 -0
  19. package/dist/chunk-V5ZQAAJT.js.map +1 -0
  20. package/dist/chunk-X6MRDUYH.js +21 -0
  21. package/dist/chunk-X6MRDUYH.js.map +1 -0
  22. package/dist/chunk-XQGW5HUG.js +30 -0
  23. package/dist/chunk-XQGW5HUG.js.map +1 -0
  24. package/dist/context-ChnWR4Kb.d.ts +455 -0
  25. package/dist/danfe/en-US.d.ts +12 -0
  26. package/dist/danfe/en-US.js +51 -0
  27. package/dist/danfe/en-US.js.map +1 -0
  28. package/dist/danfe/index.d.ts +50 -0
  29. package/dist/danfe/index.js +18 -0
  30. package/dist/danfe/index.js.map +1 -0
  31. package/dist/danfe/pt-BR.d.ts +11 -0
  32. package/dist/danfe/pt-BR.js +51 -0
  33. package/dist/danfe/pt-BR.js.map +1 -0
  34. package/dist/documents/index.d.ts +169 -0
  35. package/dist/documents/index.js +1228 -0
  36. package/dist/documents/index.js.map +1 -0
  37. package/dist/engine/index.d.ts +118 -0
  38. package/dist/engine/index.js +591 -0
  39. package/dist/engine/index.js.map +1 -0
  40. package/dist/http.d.ts +73 -0
  41. package/dist/http.js +16 -0
  42. package/dist/http.js.map +1 -0
  43. package/dist/issuer/index.d.ts +43 -0
  44. package/dist/issuer/index.js +131 -0
  45. package/dist/issuer/index.js.map +1 -0
  46. package/dist/jobs.d.ts +74 -0
  47. package/dist/jobs.js +22 -0
  48. package/dist/jobs.js.map +1 -0
  49. package/dist/labels-BNvflT0h.d.ts +44 -0
  50. package/dist/manifest/index.d.ts +97 -0
  51. package/dist/manifest/index.js +27 -0
  52. package/dist/manifest/index.js.map +1 -0
  53. package/dist/manifest/server.d.ts +57 -0
  54. package/dist/manifest/server.js +25 -0
  55. package/dist/manifest/server.js.map +1 -0
  56. package/dist/notifications.d.ts +93 -0
  57. package/dist/notifications.js +41 -0
  58. package/dist/notifications.js.map +1 -0
  59. package/dist/port-DpRFK56U.d.ts +238 -0
  60. package/dist/sale/index.d.ts +243 -0
  61. package/dist/sale/index.js +1 -0
  62. package/dist/sale/index.js.map +1 -0
  63. package/dist/service-KTjH7AxW.d.ts +139 -0
  64. package/dist/sidecar/index.d.ts +216 -0
  65. package/dist/sidecar/index.js +8 -0
  66. package/dist/sidecar/index.js.map +1 -0
  67. package/dist/types-B1b8LIWX.d.ts +247 -0
  68. package/package.json +126 -4
  69. package/prisma/fiscal.prisma +158 -0
  70. package/prisma/migrations/20261113220000_fiscal_documents/migration.sql +201 -0
  71. package/sidecar/.dockerignore +5 -0
  72. package/sidecar/Dockerfile +68 -0
  73. package/sidecar/README.md +149 -0
  74. package/sidecar/composer.json +30 -0
  75. package/sidecar/composer.lock +2224 -0
  76. package/sidecar/docker/apache.conf +14 -0
  77. package/sidecar/docker/icp-brasil.pem +8031 -0
  78. package/sidecar/docker/mpm.conf +17 -0
  79. package/sidecar/docker/openssl.cnf +16 -0
  80. package/sidecar/docker/php.ini +19 -0
  81. package/sidecar/public/index.php +15 -0
  82. package/sidecar/schema/sale-for-document.schema.json +401 -0
  83. package/sidecar/src/ErrorClass.php +31 -0
  84. package/sidecar/src/Http/Request.php +48 -0
  85. package/sidecar/src/Http/Response.php +32 -0
  86. package/sidecar/src/Http/Router.php +59 -0
  87. package/sidecar/src/Kernel.php +99 -0
  88. package/sidecar/src/Module.php +31 -0
  89. package/sidecar/src/Nfe/Classifier.php +89 -0
  90. package/sidecar/src/Nfe/Credentials.php +52 -0
  91. package/sidecar/src/Nfe/DocumentMapper.php +383 -0
  92. package/sidecar/src/Nfe/DocumentSchema.php +39 -0
  93. package/sidecar/src/Nfe/Input.php +125 -0
  94. package/sidecar/src/Nfe/Model.php +17 -0
  95. package/sidecar/src/Nfe/NfeModule.php +62 -0
  96. package/sidecar/src/Nfe/NfeService.php +504 -0
  97. package/sidecar/src/Nfe/Sefaz.php +49 -0
  98. package/sidecar/src/Nfe/SefazReply.php +81 -0
  99. package/sidecar/src/Nfe/Transport/CurlTransport.php +198 -0
  100. package/sidecar/src/Nfe/Transport/SoapAdapter.php +57 -0
  101. package/sidecar/src/Nfe/Transport/Transport.php +20 -0
  102. package/sidecar/src/Nfe/Transport/TransportFailure.php +42 -0
  103. package/sidecar/src/RequestLog.php +54 -0
  104. package/sidecar/src/ServiceError.php +69 -0
  105. package/src/danfe/en-US.ts +53 -0
  106. package/src/danfe/index.ts +11 -0
  107. package/src/danfe/labels.ts +49 -0
  108. package/src/danfe/pt-BR.ts +52 -0
  109. package/src/danfe/render.ts +265 -0
  110. package/src/danfe/xml.ts +45 -0
  111. package/src/documents/context.ts +260 -0
  112. package/src/documents/errors.ts +41 -0
  113. package/src/documents/helpers.ts +128 -0
  114. package/src/documents/index.ts +39 -0
  115. package/src/documents/lines.ts +63 -0
  116. package/src/documents/machine-steps.ts +260 -0
  117. package/src/documents/machine.ts +128 -0
  118. package/src/documents/memory.ts +138 -0
  119. package/src/documents/nfe-proc.ts +51 -0
  120. package/src/documents/ports.ts +130 -0
  121. package/src/documents/profile-input.ts +168 -0
  122. package/src/documents/profile.ts +98 -0
  123. package/src/documents/service-profile.ts +104 -0
  124. package/src/documents/service.ts +296 -0
  125. package/src/documents/settle.ts +121 -0
  126. package/src/documents/signing.ts +61 -0
  127. package/src/documents/sql-rows.ts +180 -0
  128. package/src/documents/sql-store.ts +242 -0
  129. package/src/documents/sql.ts +18 -0
  130. package/src/documents/steps.ts +173 -0
  131. package/src/documents/tests/integration/pglite.ts +73 -0
  132. package/src/documents/types.ts +193 -0
  133. package/src/engine/compare.ts +68 -0
  134. package/src/engine/compute.ts +40 -0
  135. package/src/engine/errors.ts +28 -0
  136. package/src/engine/index.ts +20 -0
  137. package/src/engine/oracle.ts +81 -0
  138. package/src/engine/plan.ts +268 -0
  139. package/src/engine/rounding.ts +81 -0
  140. package/src/engine/types.ts +270 -0
  141. package/src/engine/validate.ts +222 -0
  142. package/src/http.ts +264 -0
  143. package/src/issuer/index.ts +9 -0
  144. package/src/issuer/port.ts +109 -0
  145. package/src/issuer/sidecar.ts +171 -0
  146. package/src/jobs.ts +115 -0
  147. package/src/manifest/index.ts +46 -0
  148. package/src/manifest/permissions.ts +28 -0
  149. package/src/manifest/server.ts +20 -0
  150. package/src/notifications.ts +120 -0
  151. package/src/sale/index.ts +8 -0
  152. package/src/sale/types.ts +292 -0
  153. package/src/sidecar/index.ts +9 -0
  154. package/src/sidecar/types.ts +243 -0
  155. package/tables/ibs-cbs-2026-11-13.json +156 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/documents/signing.ts","../../src/documents/service-profile.ts","../../src/documents/nfe-proc.ts","../../src/documents/settle.ts","../../src/documents/steps.ts","../../src/documents/service.ts","../../src/documents/memory.ts","../../src/documents/sql.ts","../../src/documents/sql-rows.ts","../../src/documents/sql-store.ts","../../src/documents/lines.ts"],"sourcesContent":["/**\n * The SigningIdentity port: who signs a call. It turns a profile into the\n * {@link SigningMaterial} for ONE call to the issuer; the material is never\n * stored, logged or put in an error.\n *\n * - `STORE_CERTIFICATE` ships now: the store's own A1, decrypted through the\n * host's {@link Cipher} at the moment of the call.\n * - `PLATFORM` is declared and answers `NOT_SUPPORTED` until FUT-2229\n * question 4 says how the platform signs on a store's behalf.\n */\n\nimport type { SigningMaterial } from \"../issuer/port\";\nimport { FiscalDocumentError } from \"./errors\";\nimport type { Cipher } from \"./ports\";\nimport type { EmitterProfile, SigningIdentityKind } from \"./profile\";\n\nexport interface SigningIdentity {\n readonly kind: SigningIdentityKind;\n materialFor(profile: EmitterProfile): Promise<SigningMaterial>;\n}\n\nexport type SigningIdentities = Readonly<Record<SigningIdentityKind, SigningIdentity>>;\n\nexport function createStoreCertificateIdentity(config: { readonly cipher: Cipher }): SigningIdentity {\n if (typeof config?.cipher?.decrypt !== \"function\") throw new TypeError(\"createStoreCertificateIdentity needs a cipher.\");\n const { cipher } = config;\n return {\n kind: \"STORE_CERTIFICATE\",\n async materialFor(profile) {\n if (profile.certificateCiphertext === null || profile.certificatePasswordCiphertext === null) {\n throw new FiscalDocumentError(\"NOT_ISSUABLE\", `owner ${profile.ownerId} has no certificate.`);\n }\n const [pfxBase64, password] = await Promise.all([\n cipher.decrypt(profile.certificateCiphertext),\n cipher.decrypt(profile.certificatePasswordCiphertext),\n ]);\n const csc =\n profile.cscId !== null && profile.cscCiphertext !== null\n ? { id: profile.cscId, token: await cipher.decrypt(profile.cscCiphertext) }\n : null;\n return { certificate: { pfxBase64, password }, csc };\n },\n };\n}\n\nexport function createPlatformIdentity(): SigningIdentity {\n return {\n kind: \"PLATFORM\",\n async materialFor(profile) {\n throw new FiscalDocumentError(\n \"NOT_SUPPORTED\",\n `owner ${profile.ownerId} signs as PLATFORM, which is declared and not built yet (FUT-2229 q4).`,\n );\n },\n };\n}\n\n/** The two identities over one cipher: what a host passes as `signing`. */\nexport function createSigningIdentities(config: { readonly cipher: Cipher }): SigningIdentities {\n return { STORE_CERTIFICATE: createStoreCertificateIdentity(config), PLATFORM: createPlatformIdentity() };\n}\n","/**\n * The profile half of the document service: the emitter profile, the\n * certificate upload and the issuing points. A secret is encrypted through the\n * host's cipher the moment it arrives, and only its ciphertext is stored.\n */\n\nimport type { FiscalContext, FiscalDocumentsConfig } from \"./context\";\nimport { FiscalDocumentError } from \"./errors\";\nimport type { Cipher } from \"./ports\";\nimport type { CertificateUpload, EmitterProfileInput, IssuingPointInput } from \"./profile-input\";\nimport type { EmitterProfile, IssuingPoint } from \"./profile\";\n\n/** What the host learns from an A1 without this package parsing PKCS#12. */\nexport interface CertificateFacts {\n /** `notAfter`, ISO 8601. */\n readonly expiresAt: string;\n}\n\nexport interface FiscalDocumentsServiceConfig extends FiscalDocumentsConfig {\n /** Encrypts the certificate, its password and the CSC on arrival. */\n readonly cipher: Cipher;\n /**\n * Reads the expiry out of an uploaded A1; throws when the file does not\n * open with the password. The host's: Node's crypto cannot open every A1\n * (most issued before 2023 use RC2-40), and this package adds no parser.\n */\n readonly readCertificate: (certificate: CertificateUpload) => Promise<CertificateFacts>;\n}\n\nexport interface Deps {\n readonly ctx: FiscalContext;\n readonly config: FiscalDocumentsServiceConfig;\n}\n\n/**\n * The CSC's ciphertext a save leaves: the CSC id and token are one secret, so\n * a new id needs its token, a token needs an id, and no id clears both.\n */\nasync function cscCiphertextFor(\n config: FiscalDocumentsServiceConfig,\n stored: EmitterProfile | null,\n input: Pick<EmitterProfileInput, \"cscId\" | \"cscToken\">,\n): Promise<string | null> {\n if (input.cscToken !== null) {\n if (input.cscId === null) throw new FiscalDocumentError(\"INVALID_INPUT\", \"cscId is required with cscToken.\");\n return config.cipher.encrypt(input.cscToken);\n }\n if (input.cscId === null) return null;\n if (input.cscId !== stored?.cscId) throw new FiscalDocumentError(\"INVALID_INPUT\", \"cscToken is required with a new cscId.\");\n return stored.cscCiphertext;\n}\n\nexport async function saveProfile({ ctx, config }: Deps, ownerId: string, input: EmitterProfileInput): Promise<EmitterProfile> {\n const stored = await config.store.getProfile(ownerId);\n const fields = Object.fromEntries(Object.entries(input).filter(([key]) => key !== \"cscToken\")) as Omit<EmitterProfileInput, \"cscToken\">;\n const profile: EmitterProfile = {\n ...fields,\n ownerId,\n certificateCiphertext: stored?.certificateCiphertext ?? null,\n certificatePasswordCiphertext: stored?.certificatePasswordCiphertext ?? null,\n certificateExpiresAt: stored?.certificateExpiresAt ?? null,\n cscCiphertext: await cscCiphertextFor(config, stored, input),\n updatedAt: ctx.nowIso(),\n };\n await config.store.saveProfile(profile);\n return profile;\n}\n\nexport async function uploadCertificate({ ctx, config }: Deps, ownerId: string, certificate: CertificateUpload): Promise<EmitterProfile> {\n const stored = await ctx.requireProfile(ownerId);\n let facts: CertificateFacts;\n try {\n facts = await config.readCertificate(certificate);\n } catch {\n // The reader's own message may quote what it was given; this one never does.\n throw new FiscalDocumentError(\"INVALID_INPUT\", \"the certificate does not open with that password.\");\n }\n const profile: EmitterProfile = {\n ...stored,\n certificateCiphertext: await config.cipher.encrypt(certificate.pfxBase64),\n certificatePasswordCiphertext: await config.cipher.encrypt(certificate.password),\n certificateExpiresAt: facts.expiresAt,\n updatedAt: ctx.nowIso(),\n };\n await config.store.saveProfile(profile);\n return profile;\n}\n\nexport async function createIssuingPoint({ ctx, config }: Deps, ownerId: string, input: IssuingPointInput): Promise<IssuingPoint> {\n const profile = await ctx.requireProfile(ownerId);\n if (input.model === \"NFE\" && input.contingencySeries !== null) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", \"an NF-e issuing point has no contingency series: the service has no offline NF-e path.\");\n }\n const point: IssuingPoint = {\n id: input.id,\n ownerId,\n model: input.model,\n onlineSeries: input.onlineSeries,\n contingencySeries: input.contingencySeries,\n createdAt: ctx.nowIso(),\n };\n await config.store.createIssuingPoint(point, profile.cnpj, { online: input.firstOnlineNumber, contingency: input.firstContingencyNumber });\n return point;\n}\n","/**\n * The `nfeProc` — what an authorised document is stored as — assembled from\n * the signed XML the service built and the `protNFe` a lookup answered, for a\n * document whose sending went unanswered and was then found authorised.\n */\n\nimport { element } from \"../danfe/xml\";\n\nconst PROTOCOL = /<protNFe\\b[^>]*>[\\s\\S]*?<\\/protNFe>/;\nconst NFE = /<NFe\\b[^>]*>[\\s\\S]*<\\/NFe>/;\n/** The signed XML's own digest (`DigestValue`), which SEFAZ quotes back as the protocol's `digVal`. */\nexport function digestOf(signedXml: string): string | null {\n return /<DigestValue>([^<]+)<\\/DigestValue>/.exec(signedXml)?.[1]?.trim() ?? null;\n}\n\n/** The protocol a SEFAZ reply carries, with its `digVal`, or `null`. */\nexport function protocolDigestOf(sefazReply: string): string | null {\n const protocol = PROTOCOL.exec(sefazReply)?.[0];\n const infProt = protocol === undefined ? null : element(protocol, \"infProt\");\n return infProt === null ? null : (element(infProt, \"digVal\")?.trim() ?? null);\n}\n\n/** The `cStat`s of a protocol that authorises (100, 150 late) or denies (110, 301–303) the use of the key. */\nconst SETTLING = new Set([\"100\", \"150\", \"110\", \"301\", \"302\", \"303\"]);\n\n/**\n * `null` unless the reply carries a protocol for exactly this key with a\n * settling status, the signed XML is the document's, AND the protocol's\n * `digVal` is that XML's `DigestValue` — the protocol certifies THAT XML and\n * no other built under the same key (the fiscal service's own `issued()`\n * refuses the same mismatch). Never a guess.\n */\n/** Whether this protocol certifies this signed XML under this key, with a settling status. */\nfunction certifies(infProt: string, nfe: string, accessKey: string): boolean {\n const digest = digestOf(nfe);\n return (\n element(infProt, \"chNFe\") === accessKey &&\n SETTLING.has(element(infProt, \"cStat\") ?? \"\") &&\n nfe.includes(`Id=\"NFe${accessKey}\"`) &&\n digest !== null &&\n element(infProt, \"digVal\")?.trim() === digest\n );\n}\n\nexport function assembleNfeProc(input: { readonly signedXml: string; readonly sefazReply: string; readonly accessKey: string }): string | null {\n const protocol = PROTOCOL.exec(input.sefazReply)?.[0];\n const nfe = NFE.exec(input.signedXml)?.[0];\n const infProt = protocol === undefined ? null : element(protocol, \"infProt\");\n if (protocol === undefined || nfe === undefined || infProt === null || !certifies(infProt, nfe, input.accessKey)) return null;\n return `<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\">${nfe}${protocol}</nfeProc>`;\n}\n","/**\n * Settling a number SEFAZ never used, so a series has no unexplained gap:\n * look it up first when a send went unanswered, cancel it if SEFAZ authorised\n * it after all (by SUBSTITUTION, event 110112, when a contingency document\n * replaced it), inutilize it otherwise.\n *\n * A call that fails is never silent: it is DEFERRED — one more failure, a\n * later attempt — and a refusal SEFAZ will repeat (241 number used, 256, 501\n * late cancel, a certificate refused) hands the document to a person at once,\n * with the needs-attention notification.\n */\n\nimport type { IssuerFailure, IssuerOutcome, SigningMaterial } from \"../issuer/port\";\nimport type { CancelledDocument, LookedUpDocument } from \"../sidecar/types\";\nimport { type FiscalContext, xmlKeys } from \"./context\";\nimport { assembleNfeProc, protocolDigestOf } from \"./nfe-proc\";\nimport type { EmitterProfile } from \"./profile\";\nimport type { FiscalDocument, NumberVoid } from \"./types\";\n\ntype Settle = (ctx: FiscalContext, document: FiscalDocument, profile: EmitterProfile, signing: SigningMaterial) => Promise<FiscalDocument>;\n\n/** A refusal the same call would meet again: a person must look. */\nconst REFUSALS = new Set<IssuerFailure[\"class\"]>([\"REJECTED\", \"AUTH\", \"INVALID\", \"INTERNAL\"]);\n\nfunction defer(ctx: FiscalContext, document: FiscalDocument, what: string, error: IssuerFailure): Promise<FiscalDocument> {\n return ctx.advance(document, { kind: \"DEFER\", reason: `${what} failed`, error, attention: REFUSALS.has(error.class) });\n}\n\n/**\n * A SUBMITTED document a lookup finds authorised or denied: its `nfeProc`,\n * from the signed XML whose digest the protocol's `digVal` names and the\n * protocol itself, stored. `undefined` when either is missing — the document\n * then stays SUBMITTED, owing work, and the sweep sends the same call again\n * for the XML.\n */\nexport async function storeNfeProc(ctx: FiscalContext, document: FiscalDocument, answer: LookedUpDocument): Promise<string | undefined> {\n if ((answer.status !== \"AUTHORIZED\" && answer.status !== \"DENIED\") || document.accessKey === null) return undefined;\n // The XML the protocol certifies, by its digest; never simply the last one stored.\n const digest = protocolDigestOf(answer.sefazReply);\n if (digest === null) return undefined;\n const signedXml = await ctx.config.storage.get(xmlKeys.signedByDigest(document.accessKey, digest));\n if (signedXml === null) return undefined;\n const nfeProc = assembleNfeProc({ signedXml, sefazReply: answer.sefazReply, accessKey: document.accessKey });\n if (nfeProc === null) return undefined;\n const xmlKey = xmlKeys.authorized(document.accessKey);\n await ctx.config.storage.put(xmlKey, nfeProc, \"application/xml\");\n return xmlKey;\n}\n\n/**\n * A document a lookup just returned to SUBMITTED (a live REJECTED number\n * found SEFAZ's): settled as AUTHORIZED or DENIED with the same answer when\n * the XML the protocol certifies is held. Two steps, never REJECTED →\n * AUTHORIZED in one.\n */\nexport async function settleWithXml(ctx: FiscalContext, document: FiscalDocument, answer: LookedUpDocument): Promise<FiscalDocument> {\n if (document.status !== \"SUBMITTED\") return document;\n const xmlKey = await storeNfeProc(ctx, document, answer);\n return xmlKey === undefined ? document : ctx.advance(document, { kind: \"LOOKUP\", answer, xmlKey });\n}\n\nconst lookupFirst: Settle = async (ctx, document, _profile, signing) => {\n if (document.accessKey === null) return ctx.advance(document, { kind: \"DEFER\", reason: \"no access key to look up\", error: null, attention: true });\n const outcome = await ctx.config.issuer.lookup({ model: document.model, environment: document.environment, signing, accessKey: document.accessKey });\n if (!outcome.ok) return defer(ctx, document, \"the lookup\", outcome.error);\n return settleWithXml(ctx, await ctx.advance(document, { kind: \"LOOKUP\", answer: outcome.answer }), outcome.answer);\n};\n\n/** The cancel owed: by substitution when a contingency document replaced it, an ordinary one otherwise. */\nasync function sendOwedCancel(ctx: FiscalContext, document: FiscalDocument, signing: SigningMaterial): Promise<IssuerOutcome<CancelledDocument> | null> {\n const { accessKey, protocol, replacedById } = document;\n if (accessKey === null || protocol === null) return null;\n const reason = ctx.config.reasons.substitution;\n const base = { environment: document.environment, signing, accessKey, protocol, reason };\n const substitute = replacedById === null ? null : await ctx.config.store.getDocument(document.ownerId, replacedById);\n if (document.model === \"NFCE\" && substitute?.accessKey) {\n return ctx.config.issuer.cancelBySubstitution({ ...base, substituteAccessKey: substitute.accessKey });\n }\n return ctx.config.issuer.cancel({ ...base, model: document.model });\n}\n\nconst cancelOwed: Settle = async (ctx, document, _profile, signing) => {\n const outcome = await sendOwedCancel(ctx, document, signing);\n if (outcome === null) return ctx.advance(document, { kind: \"DEFER\", reason: \"no protocol to cancel with\", error: null, attention: true });\n if (!outcome.ok) return defer(ctx, document, \"the owed cancel\", outcome.error);\n const eventXmlKey = outcome.answer.eventXml === null ? null : xmlKeys.cancel(outcome.answer.accessKey);\n if (eventXmlKey !== null) await ctx.config.storage.put(eventXmlKey, outcome.answer.eventXml ?? \"\", \"application/xml\");\n return ctx.advance(document, { kind: \"CANCEL\", answer: outcome.answer, reason: ctx.config.reasons.substitution, eventXmlKey });\n};\n\nconst inutilizeOwed: Settle = async (ctx, document, profile, signing) => {\n const outcome = await ctx.config.issuer.inutilize({\n model: document.model,\n environment: document.environment,\n signing,\n uf: profile.address.uf,\n cnpj: document.issuerCnpj,\n year: Number(document.issuedAt.slice(0, 4)),\n series: document.series,\n from: document.number,\n to: document.number,\n reason: ctx.config.reasons.inutilization,\n });\n if (!outcome.ok) return defer(ctx, document, \"the inutilization\", outcome.error);\n const xml = outcome.answer.inutilizationXml;\n const eventXmlKey = xml === null ? null : xmlKeys.inutilization(document);\n if (eventXmlKey !== null) await ctx.config.storage.put(eventXmlKey, xml ?? \"\", \"application/xml\");\n return ctx.advance(document, { kind: \"INUTILIZE\", answer: outcome.answer, eventXmlKey });\n};\n\nconst SETTLE: Partial<Record<NumberVoid, Settle>> = {\n LOOKUP_FIRST: lookupFirst,\n CANCEL: cancelOwed,\n INUTILIZE: inutilizeOwed,\n};\n\n/** Settle what a replaced or rejected document still owes on its number. */\nexport async function settleNumber(ctx: FiscalContext, document: FiscalDocument, profile: EmitterProfile, signing: SigningMaterial): Promise<FiscalDocument> {\n const settle = document.numberVoid === null ? undefined : SETTLE[document.numberVoid];\n return settle === undefined ? document : settle(ctx, document, profile, signing);\n}\n","/**\n * The steps that issue a document, each one call and the transition its\n * answer earns. The mapping of the service's classes:\n *\n * | answer | on a document being issued | on a contingency document being transmitted |\n * |---|---|---|\n * | `AUTHORIZED` / `DENIED` | AUTHORIZE / DENY | AUTHORIZE / DENY |\n * | `REJECTED`, `INVALID`, `INTERNAL` | REJECT: the number is voided (looked up first if a send went unanswered) | REJECT: kept for the store to correct and resend |\n * | `CONTINGENCY`, NFC-e, point with a contingency series | a second document, offline, replacing this one in one transaction | RETRY |\n * | `CONTINGENCY` otherwise, `RETRYABLE`, `AUTH` | RETRY, with backoff; a person after `MAX_FAILURES` | RETRY |\n *\n * An online NFC-e is never sent again past `nfceOnlineToleranceMs` (SEFAZ\n * refuses a late `dhEmi`): where the point has a contingency series it goes\n * offline instead.\n */\n\nimport type { IssuerFailure, SigningMaterial } from \"../issuer/port\";\nimport { FISCAL_ISSUE } from \"../manifest/permissions\";\nimport type { IssuedDocument } from \"../sidecar/types\";\nimport { FISCAL_DOCUMENT_REJECTED, type FiscalContext, draftOf, xmlKeys } from \"./context\";\nimport { FiscalDocumentError } from \"./errors\";\nimport { digestOf } from \"./nfe-proc\";\nimport type { EmitterProfile, IssuingPoint } from \"./profile\";\nimport type { FiscalDocument } from \"./types\";\n\nconst FINAL_FAILURES = new Set<IssuerFailure[\"class\"]>([\"REJECTED\", \"INVALID\", \"INTERNAL\"]);\n\nasync function reject(ctx: FiscalContext, document: FiscalDocument, error: IssuerFailure): Promise<FiscalDocument> {\n const rejected = await ctx.advance(document, { kind: \"REJECT\", error });\n await ctx.config.notify.emit({\n type: FISCAL_DOCUMENT_REJECTED,\n recipient: { tenantId: document.ownerId, permission: FISCAL_ISSUE },\n payload: {\n documentId: document.id,\n subjectId: document.subjectId,\n model: document.model,\n series: document.series,\n number: document.number,\n code: error.code,\n reason: error.message,\n },\n });\n return rejected;\n}\n\nasync function accept(ctx: FiscalContext, document: FiscalDocument, answer: IssuedDocument): Promise<FiscalDocument> {\n const xmlKey = xmlKeys.authorized(answer.accessKey);\n await ctx.config.storage.put(xmlKey, answer.authorizedXml, \"application/xml\");\n return ctx.advance(document, { kind: answer.status === \"AUTHORIZED\" ? \"AUTHORIZE\" : \"DENY\", answer, xmlKey });\n}\n\nfunction canGoOffline(document: FiscalDocument, point: IssuingPoint): boolean {\n return document.model === \"NFCE\" && document.seriesKind === \"ONLINE\" && point.contingencySeries !== null;\n}\n\n/** An online NFC-e whose `dhEmi` SEFAZ would now refuse as late. */\nfunction pastOnlineTolerance(ctx: FiscalContext, document: FiscalDocument): boolean {\n return ctx.config.now().getTime() - Date.parse(document.createdAt) > ctx.config.nfceOnlineToleranceMs;\n}\n\n/** Sign a contingency-series document offline. On a failure it is left as it was, for the caller to defer. */\nasync function signOffline(\n ctx: FiscalContext,\n document: FiscalDocument,\n profile: EmitterProfile,\n signing: SigningMaterial,\n): Promise<{ document: FiscalDocument; error: IssuerFailure | null }> {\n const contingency = { since: await ctx.localNow(profile.ownerId), reason: ctx.config.reasons.contingency };\n const outcome = await ctx.config.issuer.signContingency({ environment: document.environment, signing, document: document.sale, contingency });\n if (!outcome.ok) return { document, error: outcome.error };\n const xmlKey = xmlKeys.signed(outcome.answer.accessKey);\n await ctx.config.storage.put(xmlKey, outcome.answer.signedXml, \"application/xml\");\n return { document: await ctx.advance(document, { kind: \"SIGN_OFFLINE\", answer: outcome.answer, contingency, xmlKey }), error: null };\n}\n\n/** Sign a PENDING contingency document; a failure is deferred (it stays PENDING, the sweep signs it later). */\nexport async function signPending(\n ctx: FiscalContext,\n document: FiscalDocument,\n profile: EmitterProfile,\n signing: SigningMaterial,\n): Promise<FiscalDocument> {\n const signed = await signOffline(ctx, document, profile, signing);\n if (signed.error === null) return signed.document;\n return ctx.advance(document, {\n kind: \"DEFER\",\n reason: \"signing offline failed\",\n error: signed.error,\n // Signing is local: a certificate that does not open (AUTH) will not open on the next try either.\n attention: FINAL_FAILURES.has(signed.error.class) || signed.error.class === \"AUTH\",\n });\n}\n\n/**\n * Move the sale offline: number a second document on the contingency series\n * AND replace this one, in ONE transaction, before anything is signed — so a\n * crash can never leave the online document to be sent again beside its twin.\n * Signing follows; if it fails, the new document waits PENDING for the sweep.\n */\nasync function goOffline(\n ctx: FiscalContext,\n document: FiscalDocument,\n profile: EmitterProfile,\n point: IssuingPoint,\n signing: SigningMaterial,\n): Promise<FiscalDocument> {\n const offline = await ctx.createNumbered({\n profile,\n point,\n subjectId: document.subjectId,\n model: document.model,\n seriesKind: \"CONTINGENCY\",\n draft: draftOf(document.sale),\n replacing: document,\n });\n return signPending(ctx, offline, profile, signing);\n}\n\n/**\n * The signed XML a failed call returned, stored UNDER ITS DIGEST and never\n * over another: each send under a key may carry a different XML (a service\n * upgrade between sends changes `verProc`, say), and only the one SEFAZ\n * authorised may become the `nfeProc`. A lookup reads the protocol's `digVal`\n * and fetches exactly that XML (`xmlKeys.signedByDigest`), so pairing is by\n * digest, not by \"the last one stored\". `xmlKey` points at the latest.\n */\nasync function keepSigned(ctx: FiscalContext, document: FiscalDocument, error: IssuerFailure): Promise<{ xmlKey?: string }> {\n const key = document.accessKey ?? error.accessKey;\n const digest = error.signedXml === null ? null : digestOf(error.signedXml);\n if (error.signedXml === null || key === null || digest === null) return {};\n const xmlKey = xmlKeys.signedByDigest(key, digest);\n await ctx.config.storage.put(xmlKey, error.signedXml, \"application/xml\");\n return { xmlKey };\n}\n\n/**\n * An online NFC-e SEFAZ would now refuse as late, at a point that can go\n * offline. A document a lookup found authorised (its protocol is kept) is\n * SEFAZ's: sending the same call again fetches its XML (the service settles\n * the duplicate by a lookup), and it must never go offline beside its own\n * authorisation.\n */\nfunction staleOnline(ctx: FiscalContext, document: FiscalDocument, point: IssuingPoint): boolean {\n const knownToSefaz = document.status === \"SUBMITTED\" && document.protocol !== null;\n return !knownToSefaz && canGoOffline(document, point) && pastOnlineTolerance(ctx, document);\n}\n\n/** Issue (or re-issue, for a SUBMITTED one) a document on its online series. */\nexport async function submit(\n ctx: FiscalContext,\n document: FiscalDocument,\n profile: EmitterProfile,\n point: IssuingPoint,\n signing: SigningMaterial,\n): Promise<FiscalDocument> {\n if (staleOnline(ctx, document, point)) return goOffline(ctx, document, profile, point, signing);\n const sent = document.status === \"PENDING\" ? await ctx.advance(document, { kind: \"SUBMIT\" }) : document;\n const outcome = await ctx.config.issuer.issue({ model: sent.model, environment: sent.environment, signing, document: sent.sale });\n if (outcome.ok) return accept(ctx, sent, outcome.answer);\n if (FINAL_FAILURES.has(outcome.error.class)) return reject(ctx, sent, outcome.error);\n const retried = await ctx.advance(sent, { kind: \"RETRY\", error: outcome.error, ...(await keepSigned(ctx, sent, outcome.error)) });\n return outcome.error.class === \"CONTINGENCY\" && canGoOffline(retried, point) ? goOffline(ctx, retried, profile, point, signing) : retried;\n}\n\n/** Transmit a document signed offline. */\nexport async function transmit(ctx: FiscalContext, document: FiscalDocument, signing: SigningMaterial): Promise<FiscalDocument> {\n const signedXml = document.xmlKey === null ? null : await ctx.config.storage.get(document.xmlKey);\n if (signedXml === null) throw new FiscalDocumentError(\"NOT_FOUND\", `document ${document.id} has no signed XML in storage.`);\n const outcome = await ctx.config.issuer.transmit({ model: document.model, environment: document.environment, signing, signedXml });\n if (outcome.ok) return accept(ctx, document, outcome.answer);\n if (FINAL_FAILURES.has(outcome.error.class)) return reject(ctx, document, outcome.error);\n return ctx.advance(document, { kind: \"RETRY\", error: outcome.error });\n}\n","/**\n * `createFiscalDocuments` — the document service: the emitter profile, the\n * issuing points, and issuing, cancelling, looking up and sweeping documents\n * over the host's ports. Every SEFAZ step goes through the Issuer port and\n * every state change through the state machine (`./machine`), persisted with\n * its event and its next attempt.\n *\n * The certificate, its password and the CSC are encrypted through the host's\n * cipher the moment they arrive, decrypted by the signing identity for one\n * call, and never logged, answered or put in an error.\n */\n\nimport type { IssuerFailure } from \"../issuer/port\";\nimport { FISCAL_ISSUE } from \"../manifest/permissions\";\nimport type { LookedUpDocument } from \"../sidecar/types\";\nimport { FISCAL_CONTINGENCY_DEADLINE, FiscalContext, assertConfig, assertReason, issuerOf, totalsOf, xmlKeys } from \"./context\";\nimport { FiscalDocumentError } from \"./errors\";\nimport { canTransition } from \"./machine\";\nimport { type Deps, type FiscalDocumentsServiceConfig, createIssuingPoint, saveProfile, uploadCertificate } from \"./service-profile\";\nimport { settleNumber, settleWithXml, storeNfeProc } from \"./settle\";\nimport { signPending, submit, transmit } from \"./steps\";\nimport { type DocumentTotals, type FiscalDocument, type FiscalDocumentModel, isLive } from \"./types\";\n\nexport type { CertificateFacts, FiscalDocumentsServiceConfig } from \"./service-profile\";\n\nexport interface SweepReport {\n readonly advanced: Array<{ readonly documentId: string; readonly status: FiscalDocument[\"status\"] }>;\n readonly failures: Array<{ readonly documentId: string; readonly message: string }>;\n}\n\nexport interface IssueInput {\n readonly ownerId: string;\n readonly subjectId: string;\n readonly issuingPointId: string;\n readonly model: FiscalDocumentModel;\n}\n\n/** How long an NFC-e may wait in contingency before it must be transmitted (24 h); the warning goes out at 20 h. */\nexport const CONTINGENCY_WARNING_AFTER_MS = 20 * 3_600_000;\n\n/** A step's failure that no retry will cure: the document waits for a person. */\nconst NEEDS_A_PERSON = new Set([\"NOT_SUPPORTED\", \"NOT_ISSUABLE\", \"NOT_FOUND\", \"INVALID_INPUT\", \"SERIES_EXHAUSTED\"]);\n\nasync function issuable({ ctx }: Deps, ownerId: string, issuingPointId: string, model: FiscalDocumentModel) {\n const profile = await ctx.requireProfile(ownerId);\n if (profile.documentPolicy !== \"ISSUED_HERE\") {\n throw new FiscalDocumentError(\"NOT_ISSUABLE\", `owner ${ownerId}'s documentPolicy is ${profile.documentPolicy}.`);\n }\n const point = await ctx.requirePoint(ownerId, issuingPointId);\n if (point.model !== model) throw new FiscalDocumentError(\"INVALID_INPUT\", `issuing point ${point.id} issues ${point.model}, not ${model}.`);\n return { profile, point };\n}\n\nasync function liveDocument({ config }: Deps, input: Omit<IssueInput, \"issuingPointId\">): Promise<FiscalDocument | null> {\n const live = (await config.store.listBySubject(input.ownerId, input.subjectId, input.model)).filter(isLive);\n return live[live.length - 1] ?? null;\n}\n\nasync function requireDocument({ config }: Deps, ownerId: string, documentId: string): Promise<FiscalDocument> {\n const document = await config.store.getDocument(ownerId, documentId);\n if (document === null) throw new FiscalDocumentError(\"NOT_FOUND\", `owner ${ownerId} has no document ${documentId}.`);\n return document;\n}\n\n/** Number a new document — or, when the subject already has a live one (a concurrent call won), answer that one. */\nasync function numberOrExisting(deps: Deps, input: Omit<IssueInput, \"issuingPointId\">, create: () => Promise<FiscalDocument>) {\n try {\n return { document: await create(), created: true };\n } catch (error) {\n if (!(error instanceof FiscalDocumentError) || error.code !== \"SUBJECT_HAS_DOCUMENT\") throw error;\n const existing = await liveDocument(deps, input);\n if (existing === null) throw error;\n return { document: existing, created: false };\n }\n}\n\nasync function issue(deps: Deps, input: IssueInput): Promise<FiscalDocument> {\n const { profile, point } = await issuable(deps, input.ownerId, input.issuingPointId, input.model);\n const existing = await liveDocument(deps, input);\n if (existing !== null) return existing;\n const signing = await deps.ctx.material(profile);\n const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: input.subjectId, model: input.model });\n const numbered = await numberOrExisting(deps, input, () =>\n deps.ctx.createNumbered({ profile, point, subjectId: input.subjectId, model: input.model, seriesKind: \"ONLINE\", draft }),\n );\n return numbered.created ? submit(deps.ctx, numbered.document, profile, point, signing) : numbered.document;\n}\n\n/** Sign the sale offline at once (the register knows it is offline). A failure leaves it PENDING for the sweep. */\nasync function issueOffline(deps: Deps, input: Omit<IssueInput, \"model\">): Promise<FiscalDocument> {\n const target = { ...input, model: \"NFCE\" as const };\n const { profile, point } = await issuable(deps, input.ownerId, input.issuingPointId, \"NFCE\");\n const existing = await liveDocument(deps, target);\n if (existing !== null) return existing;\n const signing = await deps.ctx.material(profile);\n const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: input.subjectId, model: \"NFCE\" });\n const numbered = await numberOrExisting(deps, target, () =>\n deps.ctx.createNumbered({ profile, point, subjectId: input.subjectId, model: \"NFCE\", seriesKind: \"CONTINGENCY\", draft }),\n );\n return numbered.created ? signPending(deps.ctx, numbered.document, profile, signing) : numbered.document;\n}\n\n/**\n * A contingency NFC-e SEFAZ rejected on transmission: the buyer holds its\n * DANFE, so the number is never voided. The store corrects the sale (the\n * host's `SaleSource` answers the corrected one) and it is signed again\n * under the SAME series, number and key code, then transmitted by the job.\n */\n/** The fields a buyer's DANFE prints and its QR code encodes, which a resend may never change. */\nfunction printedFieldsChange(document: FiscalDocument, totals: DocumentTotals, buyerTaxId: string | null): boolean {\n return totals.totalCents !== document.totals.totalCents || buyerTaxId !== document.buyerTaxId;\n}\n\n/**\n * A contingency NFC-e SEFAZ rejected on transmission: the buyer holds its\n * DANFE, so the number is never voided. The store corrects the sale (the\n * host's `SaleSource` answers the corrected one) and it is signed again\n * under the SAME series, number and key code, then transmitted by the job.\n * A correction that would change the total or the buyer's document — what\n * the DANFE prints and its QR encodes — is refused: that sale needs a new\n * note, issued by a person (decided on FUT-2237).\n */\nasync function resendContingency(deps: Deps, input: { ownerId: string; documentId: string }): Promise<FiscalDocument> {\n const document = await requireDocument(deps, input.ownerId, input.documentId);\n if (document.status !== \"REJECTED\" || document.seriesKind !== \"CONTINGENCY\" || document.contingency === null) {\n throw new FiscalDocumentError(\"TRANSITION_REFUSED\", `document ${document.id} is not a rejected contingency NFC-e.`);\n }\n const profile = await deps.ctx.requireProfile(input.ownerId);\n const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: document.subjectId, model: document.model });\n const totals = totalsOf(draft);\n const buyerTaxId = draft.buyer?.document.number ?? null;\n if (printedFieldsChange(document, totals, buyerTaxId)) {\n throw new FiscalDocumentError(\n \"RESEND_CHANGES_PRINTED_FIELDS\",\n `the correction changes document ${document.id}'s total or buyer, which its DANFE prints: issue a new note.`,\n );\n }\n const sale = { ...draft, series: document.series, number: document.number, keyCode: document.keyCode, issuedAt: document.issuedAt, issuer: issuerOf(profile) };\n const outcome = await deps.config.issuer.signContingency({\n environment: document.environment,\n signing: await deps.ctx.material(profile),\n document: sale,\n contingency: document.contingency,\n });\n if (!outcome.ok) throw new FiscalDocumentError(\"NOT_ISSUABLE\", `the corrected sale could not be signed: ${outcome.error.class} ${outcome.error.code ?? \"\"}`.trim());\n const xmlKey = xmlKeys.signed(outcome.answer.accessKey);\n await deps.config.storage.put(xmlKey, outcome.answer.signedXml, \"application/xml\");\n return deps.ctx.advance(document, { kind: \"RESIGN\", answer: outcome.answer, sale, totals, buyerTaxId, xmlKey });\n}\n\nasync function cancel(\n deps: Deps,\n input: { ownerId: string; documentId: string; reason: string },\n): Promise<{ document: FiscalDocument; failure: IssuerFailure | null }> {\n assertReason(input.reason, \"reason\");\n const document = await requireDocument(deps, input.ownerId, input.documentId);\n if (document.status !== \"AUTHORIZED\" || document.accessKey === null || document.protocol === null) {\n throw new FiscalDocumentError(\"TRANSITION_REFUSED\", `document ${document.id} is ${document.status}; only an authorised document is cancelled.`);\n }\n const profile = await deps.ctx.requireProfile(input.ownerId);\n const outcome = await deps.config.issuer.cancel({\n model: document.model,\n environment: document.environment,\n signing: await deps.ctx.material(profile),\n accessKey: document.accessKey,\n protocol: document.protocol,\n reason: input.reason,\n });\n if (!outcome.ok) return { document, failure: outcome.error };\n const eventXmlKey = outcome.answer.eventXml === null ? null : xmlKeys.cancel(document.accessKey);\n if (eventXmlKey !== null) await deps.config.storage.put(eventXmlKey, outcome.answer.eventXml ?? \"\", \"application/xml\");\n const cancelled = await deps.ctx.advance(document, { kind: \"CANCEL\", answer: outcome.answer, reason: input.reason, eventXmlKey });\n return { document: cancelled, failure: null };\n}\n\n/** Whether a lookup's answer moves this document (a settled number moves only while it is owed one). */\nfunction lookupMoves(document: FiscalDocument): boolean {\n if (!canTransition(document.status, \"LOOKUP\")) return false;\n if (document.status === \"REPLACED\" || document.status === \"REJECTED\") return document.numberVoid === \"LOOKUP_FIRST\";\n return true;\n}\n\nasync function lookup(\n deps: Deps,\n input: { ownerId: string; documentId: string },\n): Promise<{ document: FiscalDocument; answer: LookedUpDocument | null; failure: IssuerFailure | null }> {\n const document = await requireDocument(deps, input.ownerId, input.documentId);\n if (document.accessKey === null) throw new FiscalDocumentError(\"NOT_FOUND\", `document ${document.id} has no access key yet.`);\n const profile = await deps.ctx.requireProfile(input.ownerId);\n const outcome = await deps.config.issuer.lookup({\n model: document.model,\n environment: document.environment,\n signing: await deps.ctx.material(profile),\n accessKey: document.accessKey,\n });\n if (!outcome.ok) return { document, answer: null, failure: outcome.error };\n if (!lookupMoves(document)) return { document, answer: outcome.answer, failure: null };\n const xmlKey = document.status === \"SUBMITTED\" ? await storeNfeProc(deps.ctx, document, outcome.answer) : undefined;\n const looked = await deps.ctx.advance(document, { kind: \"LOOKUP\", answer: outcome.answer, ...(xmlKey === undefined ? {} : { xmlKey }) });\n // A live REJECTED number found SEFAZ's is back to SUBMITTED: settle it now if its XML is held.\n const after = document.status === \"REJECTED\" ? await settleWithXml(deps.ctx, looked, outcome.answer) : looked;\n return { document: after, answer: outcome.answer, failure: null };\n}\n\n/** One step of the sweep on one document: whatever it is owed next. */\nasync function step({ ctx }: Deps, document: FiscalDocument): Promise<FiscalDocument> {\n const profile = await ctx.requireProfile(document.ownerId);\n const signing = await ctx.material(profile);\n if (document.numberVoid !== null) return settleNumber(ctx, document, profile, signing);\n if (document.status === \"CONTINGENCY\") return transmit(ctx, document, signing);\n if (document.seriesKind === \"CONTINGENCY\") return signPending(ctx, document, profile, signing);\n const point = await ctx.requirePoint(document.ownerId, document.issuingPointId);\n return submit(ctx, document, profile, point, signing);\n}\n\n/** A step that threw is never silent: the document is deferred, or handed to a person when no retry will cure it. */\nasync function deferThrown(deps: Deps, document: FiscalDocument, error: unknown): Promise<void> {\n if (error instanceof FiscalDocumentError && error.code === \"CONFLICT\") return;\n const attention = error instanceof FiscalDocumentError && NEEDS_A_PERSON.has(error.code);\n const reason = error instanceof Error ? error.message : \"unknown failure\";\n const current = (await deps.config.store.getDocument(document.ownerId, document.id)) ?? document;\n await deps.ctx.advance(current, { kind: \"DEFER\", reason, error: null, attention }).catch(() => undefined);\n}\n\nasync function run(deps: Deps, documents: readonly FiscalDocument[]): Promise<SweepReport> {\n const report: SweepReport = { advanced: [], failures: [] };\n for (const document of documents) {\n try {\n const after = await step(deps, document);\n report.advanced.push({ documentId: after.id, status: after.status });\n } catch (error) {\n report.failures.push({ documentId: document.id, message: error instanceof Error ? error.message : \"unknown failure\" });\n await deferThrown(deps, document, error);\n }\n }\n return report;\n}\n\n/** Tell the owner of every NFC-e 20 h into contingency (the transmission deadline is 24 h), once each. */\nasync function warnContingencyDeadlines(deps: Deps, limit: number): Promise<number> {\n const signedBefore = new Date(deps.config.now().getTime() - CONTINGENCY_WARNING_AFTER_MS).toISOString();\n const due = await deps.config.store.listContingencyDeadline({ signedBefore, limit });\n for (const document of due) {\n const warned = await deps.ctx.advance(document, { kind: \"WARN\" });\n await deps.config.notify.emit({\n type: FISCAL_CONTINGENCY_DEADLINE,\n recipient: { tenantId: document.ownerId, permission: FISCAL_ISSUE },\n payload: { documentId: warned.id, subjectId: warned.subjectId, series: warned.series, number: warned.number, since: warned.contingency?.since ?? \"\" },\n });\n }\n return due.length;\n}\n\nexport function createFiscalDocuments(config: FiscalDocumentsServiceConfig) {\n assertConfig(config);\n if (typeof config.cipher?.encrypt !== \"function\") throw new TypeError(\"createFiscalDocuments needs cipher.\");\n if (typeof config.readCertificate !== \"function\") throw new TypeError(\"createFiscalDocuments needs readCertificate.\");\n const deps: Deps = { ctx: new FiscalContext(config), config };\n const { store } = config;\n return {\n getProfile: (ownerId: string) => store.getProfile(ownerId),\n saveProfile: saveProfile.bind(null, deps),\n uploadCertificate: uploadCertificate.bind(null, deps),\n listIssuingPoints: (ownerId: string) => store.listIssuingPoints(ownerId),\n createIssuingPoint: createIssuingPoint.bind(null, deps),\n /** Issue the subject's document, or answer the live one it has. A rejection is final; anything SEFAZ may still answer is the sweep's. */\n issue: issue.bind(null, deps),\n issueOffline: issueOffline.bind(null, deps),\n resendContingency: resendContingency.bind(null, deps),\n /** Cancel an authorised document. A refusal (late, say) answers the issuer's failure and changes nothing. */\n cancel: cancel.bind(null, deps),\n /** Ask SEFAZ what it knows of the key; a state the answer moves is recorded. */\n lookup: lookup.bind(null, deps),\n /** A person takes a document back from `attention`; the sweep tries it again. */\n async release(input: { ownerId: string; documentId: string }): Promise<FiscalDocument> {\n return deps.ctx.advance(await requireDocument(deps, input.ownerId, input.documentId), { kind: \"RELEASE\" });\n },\n getDocument: requireDocument.bind(null, deps),\n listBySubject: (ownerId: string, subjectId: string, model: FiscalDocumentModel) => store.listBySubject(ownerId, subjectId, model),\n async listEvents(ownerId: string, documentId: string) {\n await requireDocument(deps, ownerId, documentId);\n return store.listEvents(documentId);\n },\n /** One pass of the retry sweep: PENDING/SUBMITTED documents and owed numbers whose next attempt has come. */\n sweep: async (limit: number): Promise<SweepReport> => run(deps, await store.listDue({ now: deps.ctx.nowIso(), limit })),\n /** One pass of the contingency transmission, then the 20-hour deadline warnings. */\n async transmitContingency(limit: number): Promise<SweepReport> {\n const report = await run(deps, await store.listContingency({ now: deps.ctx.nowIso(), limit }));\n await warnContingencyDeadlines(deps, limit);\n return report;\n },\n };\n}\n\n\nexport type FiscalDocuments = ReturnType<typeof createFiscalDocuments>;\n","/**\n * The reference {@link FiscalStore}: in memory, for tests and harnesses —\n * the role `createMemory*Store` plays in the packages that own storage seams.\n * It keeps the same promises as the SQL store (`./sql-store`): a draw and the\n * insert built from it commit together (a `build` that throws leaves the\n * counter untouched), a replaced document is advanced before its replacement\n * is inserted, and a subject has at most one live document per model.\n */\n\nimport { FiscalDocumentError } from \"./errors\";\nimport type { FiscalStore, NumberRequest } from \"./ports\";\nimport type { EmitterProfile, IssuingPoint } from \"./profile\";\nimport { type FiscalDocument, type FiscalDocumentEvent, OWED_VOIDS, isLive } from \"./types\";\n\nconst MAX_NUMBER = 999_999_999;\n\nexport interface MemoryFiscalStore extends FiscalStore {\n /** Every event, in order, for assertions. */\n readonly events: FiscalDocumentEvent[];\n /** The next number each counter would hand out, keyed `cnpj|environment|model|series`. */\n readonly counters: Map<string, number>;\n}\n\nfunction counterKey(request: Pick<NumberRequest, \"issuerCnpj\" | \"environment\" | \"model\" | \"series\">): string {\n return `${request.issuerCnpj}|${request.environment}|${request.model}|${request.series}`;\n}\n\ninterface State {\n readonly counters: Map<string, number>;\n readonly seriesOwner: Map<string, string>;\n readonly documents: Map<string, FiscalDocument>;\n readonly events: FiscalDocumentEvent[];\n}\n\n/** Open a series' counter in both environments; a series belongs to one issuing point. */\nfunction openCounter(state: State, point: IssuingPoint, issuerCnpj: string, series: number, first: number): void {\n for (const environment of [\"homologacao\", \"producao\"] as const) {\n const key = counterKey({ issuerCnpj, environment, model: point.model, series });\n const owner = state.seriesOwner.get(key);\n if (owner !== undefined && owner !== point.id) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", `series ${series} already belongs to issuing point ${owner}.`);\n }\n }\n for (const environment of [\"homologacao\", \"producao\"] as const) {\n const key = counterKey({ issuerCnpj, environment, model: point.model, series });\n state.seriesOwner.set(key, point.id);\n state.counters.set(key, first);\n }\n}\n\nfunction isDue(document: FiscalDocument, now: string): boolean {\n if (document.attention || document.nextAttemptAt === null || document.nextAttemptAt > now) return false;\n return document.status === \"PENDING\" || document.status === \"SUBMITTED\" || OWED_VOIDS.includes(document.numberVoid ?? \"INUTILIZED\");\n}\n\nfunction save(state: State, previous: FiscalDocument, transition: { document: FiscalDocument; event: FiscalDocumentEvent }): boolean {\n const stored = state.documents.get(previous.id);\n if (stored === undefined || stored.updatedAt !== previous.updatedAt || stored.status !== previous.status) return false;\n state.documents.set(transition.document.id, transition.document);\n state.events.push(transition.event);\n return true;\n}\n\nfunction hasLive(state: State, document: FiscalDocument): boolean {\n return [...state.documents.values()].some(\n (other) => other.ownerId === document.ownerId && other.subjectId === document.subjectId && other.model === document.model && isLive(other),\n );\n}\n\nexport function createMemoryFiscalStore(): MemoryFiscalStore {\n const profiles = new Map<string, EmitterProfile>();\n const points = new Map<string, IssuingPoint>();\n const state: State = { counters: new Map(), seriesOwner: new Map(), documents: new Map(), events: [] };\n const ordered = (key: (d: FiscalDocument) => string) =>\n [...state.documents.values()].sort((a, b) => key(a).localeCompare(key(b)));\n\n return {\n events: state.events,\n counters: state.counters,\n getProfile: async (ownerId) => profiles.get(ownerId) ?? null,\n saveProfile: async (profile) => void profiles.set(profile.ownerId, profile),\n async getIssuingPoint(ownerId, id) {\n const point = points.get(id);\n return point?.ownerId === ownerId ? point : null;\n },\n listIssuingPoints: async (ownerId) => [...points.values()].filter((point) => point.ownerId === ownerId),\n async createIssuingPoint(point, issuerCnpj, firstNumber) {\n if (points.has(point.id)) throw new FiscalDocumentError(\"INVALID_INPUT\", `issuing point ${point.id} exists.`);\n openCounter(state, point, issuerCnpj, point.onlineSeries, firstNumber.online);\n if (point.contingencySeries !== null) openCounter(state, point, issuerCnpj, point.contingencySeries, firstNumber.contingency);\n points.set(point.id, point);\n },\n async createDocument(request, build, replace) {\n const key = counterKey(request);\n const number = state.counters.get(key);\n if (number === undefined || state.seriesOwner.get(key) !== request.issuingPointId) {\n throw new FiscalDocumentError(\"NOT_FOUND\", `no counter for series ${request.series} on issuing point ${request.issuingPointId}.`);\n }\n if (number > MAX_NUMBER) throw new FiscalDocumentError(\"SERIES_EXHAUSTED\", `series ${request.series} has no number left.`);\n const document = build(number);\n if (state.documents.has(document.id)) throw new FiscalDocumentError(\"INVALID_INPUT\", `document ${document.id} exists.`);\n const snapshot = new Map(state.documents);\n if (replace !== undefined && !save(state, replace.previous, replace.transition)) {\n throw new FiscalDocumentError(\"CONFLICT\", `document ${replace.previous.id} moved before it was replaced.`);\n }\n if (hasLive(state, document)) {\n // The replace and the insert are one transaction: undo the replace.\n state.documents.clear();\n for (const [id, kept] of snapshot) state.documents.set(id, kept);\n if (replace !== undefined) state.events.pop();\n throw new FiscalDocumentError(\"SUBJECT_HAS_DOCUMENT\", `subject ${document.subjectId} already has a live ${document.model}.`);\n }\n state.counters.set(key, number + 1);\n state.documents.set(document.id, document);\n return document;\n },\n async getDocument(ownerId, id) {\n const document = state.documents.get(id);\n return document?.ownerId === ownerId ? document : null;\n },\n listBySubject: async (ownerId, subjectId, model) =>\n ordered((d) => d.createdAt).filter((d) => d.ownerId === ownerId && d.subjectId === subjectId && d.model === model),\n listEvents: async (documentId) => state.events.filter((event) => event.documentId === documentId),\n saveTransition: async (previous, transition) => save(state, previous, transition),\n listDue: async ({ now, limit }) =>\n ordered((d) => d.nextAttemptAt ?? \"\").filter((document) => isDue(document, now)).slice(0, limit),\n listContingency: async ({ now, limit }) =>\n ordered((d) => d.nextAttemptAt ?? \"\")\n .filter((d) => d.status === \"CONTINGENCY\" && !d.attention && d.nextAttemptAt !== null && d.nextAttemptAt <= now)\n .slice(0, limit),\n listContingencyDeadline: async ({ signedBefore, limit }) =>\n ordered((d) => d.createdAt)\n .filter((d) => d.status === \"CONTINGENCY\" && d.deadlineWarnedAt === null && Date.parse(d.contingency?.since ?? \"\") < Date.parse(signedBefore))\n .slice(0, limit),\n listExpiringCertificates: async (before) =>\n [...profiles.values()].filter((p) => p.certificateExpiresAt !== null && p.certificateExpiresAt < before),\n };\n}\n","/**\n * The number draw, as one SQL statement over the package's migration\n * (`fiscal_number_counters`). A host's `FiscalStore.createDocument` runs it\n * and the document INSERT in ONE transaction: the row lock this UPDATE takes\n * serialises concurrent draws on a series, and a failed insert rolls the\n * counter back with it, so a series has no gap a failed write made. The only\n * gaps left are numbers SEFAZ never used (a rejection, a replaced document),\n * which the sweep inutilizes.\n *\n * Parameters: `$1` the issuer's CNPJ, `$2` environment, `$3` model, `$4` series,\n * `$5` issuing point id. No row comes back when the series is not that\n * point's; an exhausted series fails the counter's CHECK (at most\n * 1 000 000 000, the next number after 999 999 999), and the transaction with it.\n */\nexport const FISCAL_NEXT_NUMBER_SQL = `UPDATE \"fiscal_number_counters\"\nSET \"next_number\" = \"next_number\" + 1, \"updated_at\" = CURRENT_TIMESTAMP\nWHERE \"issuer_cnpj\" = $1 AND \"environment\" = $2 AND \"model\" = $3 AND \"series\" = $4 AND \"issuing_point_id\" = $5\nRETURNING \"next_number\" - 1 AS \"number\"`;\n","/**\n * Rows of the package's tables (`prisma/migrations`) to the records the\n * service holds, and back. Raw SQL through the host's Prisma client answers\n * snake_case columns, `Date` for a timestamp, a parsed object for a JSONB\n * column, and a `bigint` or a string for a BIGSERIAL; every one is read here.\n */\n\nimport type { EmitterProfile, IssuingPoint } from \"./profile\";\nimport type { FiscalDocument, FiscalDocumentEvent } from \"./types\";\n\nexport type Row = Record<string, unknown>;\n\n/** A timestamp column as ISO 8601 UTC; the columns are UTC by the Prisma convention. */\nfunction iso(value: unknown): string | null {\n if (value === null || value === undefined) return null;\n const date = value instanceof Date ? value : new Date(`${String(value).replace(\" \", \"T\")}${/Z|[+-]\\d{2}:?\\d{2}$/.test(String(value)) ? \"\" : \"Z\"}`);\n return date.toISOString();\n}\n\nfunction requiredIso(value: unknown): string {\n return iso(value) ?? \"\";\n}\n\n/** A DATE column as `YYYY-MM-DD`. */\nfunction day(value: unknown): string {\n return value instanceof Date ? value.toISOString().slice(0, 10) : String(value).slice(0, 10);\n}\n\nfunction json<T>(value: unknown): T {\n return (typeof value === \"string\" ? JSON.parse(value) : value) as T;\n}\n\nconst text = (value: unknown): string | null => (value === null || value === undefined ? null : String(value));\n\n/** The document's columns, in the order `documentValues` writes them. */\nexport const DOCUMENT_COLUMNS = [\n \"id\", \"owner_id\", \"issuer_cnpj\", \"subject_id\", \"issuing_point_id\", \"model\", \"environment\", \"series_kind\", \"series\",\n \"number\", \"key_code\", \"status\", \"sale\", \"totals\", \"buyer_tax_id\", \"access_key\", \"protocol\", \"status_code\",\n \"status_reason\", \"last_error_class\", \"outcome_unknown\", \"issued_at\", \"authorized_at\", \"contingency\", \"cancelled_at\",\n \"cancel_reason\", \"cancel_protocol\", \"replaced_by_id\", \"number_void\", \"xml_key\", \"event_xml_key\", \"attempts\",\n \"failures\", \"next_attempt_at\", \"attention\", \"deadline_warned_at\", \"created_at\", \"updated_at\",\n] as const;\n\nconst JSON_COLUMNS = new Set([\"sale\", \"totals\", \"contingency\"]);\nconst TIME_COLUMNS = new Set([\"next_attempt_at\", \"deadline_warned_at\", \"created_at\", \"updated_at\"]);\n\n/** The SQL placeholder of a column, with the cast its type needs. */\nexport function placeholder(column: string, index: number): string {\n if (JSON_COLUMNS.has(column)) return `$${index}::jsonb`;\n if (TIME_COLUMNS.has(column)) return `$${index}::timestamp(3)`;\n return `$${index}`;\n}\n\nexport function documentValues(d: FiscalDocument): unknown[] {\n return [\n d.id, d.ownerId, d.issuerCnpj, d.subjectId, d.issuingPointId, d.model, d.environment, d.seriesKind, d.series,\n d.number, d.keyCode, d.status, JSON.stringify(d.sale), JSON.stringify(d.totals), d.buyerTaxId, d.accessKey,\n d.protocol, d.statusCode, d.statusReason, d.lastErrorClass, d.outcomeUnknown, d.issuedAt, d.authorizedAt,\n d.contingency === null ? null : JSON.stringify(d.contingency), d.cancelledAt, d.cancelReason, d.cancelProtocol,\n d.replacedById, d.numberVoid, d.xmlKey, d.eventXmlKey, d.attempts, d.failures, d.nextAttemptAt, d.attention,\n d.deadlineWarnedAt, d.createdAt, d.updatedAt,\n ];\n}\n\nexport function documentOf(row: Row): FiscalDocument {\n return {\n id: String(row[\"id\"]),\n ownerId: String(row[\"owner_id\"]),\n issuerCnpj: String(row[\"issuer_cnpj\"]),\n subjectId: String(row[\"subject_id\"]),\n issuingPointId: String(row[\"issuing_point_id\"]),\n model: row[\"model\"] as FiscalDocument[\"model\"],\n environment: row[\"environment\"] as FiscalDocument[\"environment\"],\n seriesKind: row[\"series_kind\"] as FiscalDocument[\"seriesKind\"],\n series: Number(row[\"series\"]),\n number: Number(row[\"number\"]),\n keyCode: String(row[\"key_code\"]),\n status: row[\"status\"] as FiscalDocument[\"status\"],\n sale: json(row[\"sale\"]),\n totals: json(row[\"totals\"]),\n buyerTaxId: text(row[\"buyer_tax_id\"]),\n accessKey: text(row[\"access_key\"]),\n protocol: text(row[\"protocol\"]),\n statusCode: text(row[\"status_code\"]),\n statusReason: text(row[\"status_reason\"]),\n lastErrorClass: text(row[\"last_error_class\"]) as FiscalDocument[\"lastErrorClass\"],\n outcomeUnknown: row[\"outcome_unknown\"] === true,\n issuedAt: String(row[\"issued_at\"]),\n authorizedAt: text(row[\"authorized_at\"]),\n contingency: row[\"contingency\"] === null ? null : json(row[\"contingency\"]),\n cancelledAt: text(row[\"cancelled_at\"]),\n cancelReason: text(row[\"cancel_reason\"]),\n cancelProtocol: text(row[\"cancel_protocol\"]),\n replacedById: text(row[\"replaced_by_id\"]),\n numberVoid: text(row[\"number_void\"]) as FiscalDocument[\"numberVoid\"],\n xmlKey: text(row[\"xml_key\"]),\n eventXmlKey: text(row[\"event_xml_key\"]),\n attempts: Number(row[\"attempts\"]),\n failures: Number(row[\"failures\"]),\n nextAttemptAt: iso(row[\"next_attempt_at\"]),\n attention: row[\"attention\"] === true,\n deadlineWarnedAt: iso(row[\"deadline_warned_at\"]),\n createdAt: requiredIso(row[\"created_at\"]),\n updatedAt: requiredIso(row[\"updated_at\"]),\n };\n}\n\nexport function eventOf(row: Row): FiscalDocumentEvent {\n return {\n documentId: String(row[\"document_id\"]),\n kind: row[\"kind\"] as FiscalDocumentEvent[\"kind\"],\n fromStatus: row[\"from_status\"] as FiscalDocumentEvent[\"fromStatus\"],\n toStatus: row[\"to_status\"] as FiscalDocumentEvent[\"toStatus\"],\n at: requiredIso(row[\"at\"]),\n errorClass: text(row[\"error_class\"]) as FiscalDocumentEvent[\"errorClass\"],\n code: text(row[\"code\"]),\n answer: row[\"answer\"] === null ? null : json(row[\"answer\"]),\n };\n}\n\nexport const PROFILE_COLUMNS = [\n \"owner_id\", \"cnpj\", \"state_registration\", \"municipal_registration\", \"cnae\", \"legal_name\", \"trade_name\", \"tax_regime\",\n \"regime\", \"regime_effective_from\", \"restaurant_regime\", \"address\", \"environment\", \"document_policy\",\n \"signing_identity\", \"certificate_ciphertext\", \"certificate_password_ciphertext\", \"certificate_expires_at\", \"csc_id\",\n \"csc_ciphertext\", \"consent_recorded_at\", \"updated_at\",\n] as const;\n\nexport function profilePlaceholder(column: string, index: number): string {\n if (column === \"address\") return `$${index}::jsonb`;\n if (column === \"regime_effective_from\") return `$${index}::date`;\n if (column.endsWith(\"_at\")) return `$${index}::timestamp(3)`;\n return `$${index}`;\n}\n\nexport function profileValues(p: EmitterProfile): unknown[] {\n return [\n p.ownerId, p.cnpj, p.stateRegistration, p.municipalRegistration, p.cnae, p.legalName, p.tradeName, p.taxRegime,\n p.regime, p.regimeEffectiveFrom, p.restaurantRegime, JSON.stringify(p.address), p.environment, p.documentPolicy,\n p.signingIdentity, p.certificateCiphertext, p.certificatePasswordCiphertext, p.certificateExpiresAt, p.cscId,\n p.cscCiphertext, p.consentRecordedAt, p.updatedAt,\n ];\n}\n\nexport function profileOf(row: Row): EmitterProfile {\n return {\n ownerId: String(row[\"owner_id\"]),\n cnpj: String(row[\"cnpj\"]),\n stateRegistration: String(row[\"state_registration\"]),\n municipalRegistration: text(row[\"municipal_registration\"]),\n cnae: text(row[\"cnae\"]),\n legalName: String(row[\"legal_name\"]),\n tradeName: text(row[\"trade_name\"]),\n taxRegime: row[\"tax_regime\"] as EmitterProfile[\"taxRegime\"],\n regime: row[\"regime\"] as EmitterProfile[\"regime\"],\n regimeEffectiveFrom: day(row[\"regime_effective_from\"]),\n restaurantRegime: row[\"restaurant_regime\"] === true,\n address: json(row[\"address\"]),\n environment: row[\"environment\"] as EmitterProfile[\"environment\"],\n documentPolicy: row[\"document_policy\"] as EmitterProfile[\"documentPolicy\"],\n signingIdentity: row[\"signing_identity\"] as EmitterProfile[\"signingIdentity\"],\n certificateCiphertext: text(row[\"certificate_ciphertext\"]),\n certificatePasswordCiphertext: text(row[\"certificate_password_ciphertext\"]),\n certificateExpiresAt: iso(row[\"certificate_expires_at\"]),\n cscId: text(row[\"csc_id\"]),\n cscCiphertext: text(row[\"csc_ciphertext\"]),\n consentRecordedAt: iso(row[\"consent_recorded_at\"]),\n updatedAt: requiredIso(row[\"updated_at\"]),\n };\n}\n\nexport function pointOf(row: Row): IssuingPoint {\n return {\n id: String(row[\"id\"]),\n ownerId: String(row[\"owner_id\"]),\n model: row[\"model\"] as IssuingPoint[\"model\"],\n onlineSeries: Number(row[\"online_series\"]),\n contingencySeries: row[\"contingency_series\"] === null ? null : Number(row[\"contingency_series\"]),\n createdAt: requiredIso(row[\"created_at\"]),\n };\n}\n","/**\n * `createPrismaFiscalStore` — the package's own {@link FiscalStore}, over the\n * host's Prisma client and the package's migration. A host passes its client\n * and nothing else: the numbering invariants live here, not in each host.\n *\n * - The draw and the insert are ONE transaction (`FISCAL_NEXT_NUMBER_SQL`):\n * the counter's row lock serialises concurrent draws, and a refused insert\n * gives the number back.\n * - Going offline replaces the online document in that same transaction,\n * before the insert, so a crash leaves exactly one live document.\n * - The per-subject guard is the partial unique index\n * `fiscal_documents_live_subject_key`: a second live document is refused as\n * `SUBJECT_HAS_DOCUMENT`, and nothing is drawn.\n * - A transition is saved only over the row it started from (`updated_at` and\n * `status`), with its event, in one transaction.\n *\n * It speaks raw SQL through the client's `$queryRawUnsafe` /\n * `$executeRawUnsafe` / `$transaction`, so it needs no generated model types\n * and works on the host's client whatever else its schema holds.\n */\n\nimport { FiscalDocumentError } from \"./errors\";\nimport type { Transition } from \"./machine\";\nimport type { FiscalStore, NumberRequest } from \"./ports\";\nimport { FISCAL_NEXT_NUMBER_SQL } from \"./sql\";\nimport {\n DOCUMENT_COLUMNS,\n PROFILE_COLUMNS,\n type Row,\n documentOf,\n documentValues,\n eventOf,\n placeholder,\n pointOf,\n profileOf,\n profilePlaceholder,\n profileValues,\n} from \"./sql-rows\";\nimport type { FiscalDocument } from \"./types\";\n\n/** The two raw-SQL methods of a Prisma client (or of its transaction client). */\nexport interface FiscalSqlClient {\n $queryRawUnsafe<T = unknown>(query: string, ...values: unknown[]): Promise<T>;\n $executeRawUnsafe(query: string, ...values: unknown[]): Promise<number>;\n}\n\n/** A Prisma client: the raw-SQL methods and an interactive transaction. */\nexport interface FiscalPrismaClient extends FiscalSqlClient {\n $transaction<T>(run: (tx: FiscalSqlClient) => Promise<T>): Promise<T>;\n}\n\nconst rows = (client: FiscalSqlClient, query: string, ...values: unknown[]) => client.$queryRawUnsafe<Row[]>(query, ...values);\n\nconst INSERT_DOCUMENT = `INSERT INTO \"fiscal_documents\" (${DOCUMENT_COLUMNS.map((c) => `\"${c}\"`).join(\", \")})\nVALUES (${DOCUMENT_COLUMNS.map((c, i) => placeholder(c, i + 1)).join(\", \")})`;\n\nconst MUTABLE = DOCUMENT_COLUMNS.filter((c) => c !== \"id\" && c !== \"created_at\");\n// $1 the id, $2... the mutable columns, then the row the transition started from.\nconst UPDATE_DOCUMENT = [\n `UPDATE \"fiscal_documents\" SET ${MUTABLE.map((c, i) => `\"${c}\" = ${placeholder(c, i + 2)}`).join(\", \")}`,\n `WHERE \"id\" = $1 AND \"updated_at\" = $${MUTABLE.length + 2}::timestamp(3) AND \"status\" = $${MUTABLE.length + 3}`,\n `RETURNING \"id\"`,\n].join(\"\\n\");\n\nfunction updateValues(document: FiscalDocument, previous: FiscalDocument): unknown[] {\n const all = documentValues(document);\n const mutable = MUTABLE.map((column) => all[DOCUMENT_COLUMNS.indexOf(column)]);\n return [document.id, ...mutable, previous.updatedAt, previous.status];\n}\n\nconst INSERT_EVENT = `INSERT INTO \"fiscal_document_events\" (\"id\", \"document_id\", \"kind\", \"from_status\", \"to_status\", \"at\", \"error_class\", \"code\", \"answer\")\nVALUES ($1, $2, $3, $4, $5, $6::timestamp(3), $7, $8, $9::jsonb)`;\n\nconst UPSERT_PROFILE = `INSERT INTO \"fiscal_emitter_profiles\" (${PROFILE_COLUMNS.map((c) => `\"${c}\"`).join(\", \")})\nVALUES (${PROFILE_COLUMNS.map((c, i) => profilePlaceholder(c, i + 1)).join(\", \")})\nON CONFLICT (\"owner_id\") DO UPDATE SET ${PROFILE_COLUMNS.filter((c) => c !== \"owner_id\").map((c) => `\"${c}\" = EXCLUDED.\"${c}\"`).join(\", \")}`;\n\nconst OWED = `(\"status\" IN ('PENDING', 'SUBMITTED') OR \"number_void\" IN ('LOOKUP_FIRST', 'INUTILIZE', 'CANCEL'))`;\n\n/** A unique-index or CHECK violation, recognised by its constraint's name in whatever error the client raised. */\nfunction violates(error: unknown, constraint: string): boolean {\n const text = error instanceof Error ? `${error.message} ${JSON.stringify((error as { meta?: unknown }).meta ?? \"\")}` : String(error);\n return text.includes(constraint);\n}\n\nasync function saveRow(tx: FiscalSqlClient, previous: FiscalDocument, { document, event }: Transition): Promise<boolean> {\n const updated = await rows(tx, UPDATE_DOCUMENT, ...updateValues(document, previous));\n if (updated.length === 0) return false;\n await tx.$executeRawUnsafe(\n INSERT_EVENT,\n globalThis.crypto.randomUUID(),\n event.documentId,\n event.kind,\n event.fromStatus,\n event.toStatus,\n event.at,\n event.errorClass,\n event.code,\n event.answer === null ? null : JSON.stringify(event.answer),\n );\n return true;\n}\n\nasync function draw(tx: FiscalSqlClient, request: NumberRequest): Promise<number> {\n try {\n const [row] = await rows(tx, FISCAL_NEXT_NUMBER_SQL, request.issuerCnpj, request.environment, request.model, request.series, request.issuingPointId);\n if (row === undefined) {\n throw new FiscalDocumentError(\"NOT_FOUND\", `no counter for series ${request.series} on issuing point ${request.issuingPointId}.`);\n }\n return Number(row[\"number\"]);\n } catch (error) {\n if (violates(error, \"fiscal_number_counters_next_number_check\")) {\n throw new FiscalDocumentError(\"SERIES_EXHAUSTED\", `series ${request.series} has no number left.`);\n }\n throw error;\n }\n}\n\nasync function insertDocument(tx: FiscalSqlClient, document: FiscalDocument): Promise<void> {\n try {\n await tx.$executeRawUnsafe(INSERT_DOCUMENT, ...documentValues(document));\n } catch (error) {\n if (violates(error, \"fiscal_documents_live_subject_key\")) {\n throw new FiscalDocumentError(\"SUBJECT_HAS_DOCUMENT\", `subject ${document.subjectId} already has a live ${document.model}.`);\n }\n throw error;\n }\n}\n\nasync function openCounters(tx: FiscalSqlClient, point: { id: string; model: string }, issuerCnpj: string, series: number, kind: string, first: number) {\n for (const environment of [\"homologacao\", \"producao\"]) {\n await tx.$executeRawUnsafe(\n `INSERT INTO \"fiscal_number_counters\" (\"issuer_cnpj\", \"environment\", \"model\", \"series\", \"issuing_point_id\", \"series_kind\", \"next_number\")\n VALUES ($1, $2, $3, $4, $5, $6, $7)`,\n issuerCnpj, environment, point.model, series, point.id, kind, first,\n );\n }\n}\n\ntype ProfileMethods = Pick<FiscalStore, \"getProfile\" | \"saveProfile\" | \"getIssuingPoint\" | \"listIssuingPoints\" | \"createIssuingPoint\" | \"listExpiringCertificates\">;\n\nfunction profileMethods(db: FiscalPrismaClient): ProfileMethods {\n return {\n async getProfile(ownerId) {\n const [row] = await rows(db, `SELECT * FROM \"fiscal_emitter_profiles\" WHERE \"owner_id\" = $1`, ownerId);\n return row === undefined ? null : profileOf(row);\n },\n async saveProfile(profile) {\n await db.$executeRawUnsafe(UPSERT_PROFILE, ...profileValues(profile));\n },\n async getIssuingPoint(ownerId, id) {\n const [row] = await rows(db, `SELECT * FROM \"fiscal_issuing_points\" WHERE \"id\" = $1 AND \"owner_id\" = $2`, id, ownerId);\n return row === undefined ? null : pointOf(row);\n },\n async listIssuingPoints(ownerId) {\n return (await rows(db, `SELECT * FROM \"fiscal_issuing_points\" WHERE \"owner_id\" = $1 ORDER BY \"created_at\", \"id\"`, ownerId)).map(pointOf);\n },\n createIssuingPoint: (point, issuerCnpj, firstNumber) => createIssuingPoint(db, point, issuerCnpj, firstNumber),\n async listExpiringCertificates(before) {\n return (\n await rows(db, `SELECT * FROM \"fiscal_emitter_profiles\" WHERE \"certificate_expires_at\" < $1::timestamp(3) ORDER BY \"owner_id\"`, before)\n ).map(profileOf);\n },\n };\n}\n\nasync function createIssuingPoint(db: FiscalPrismaClient, ...[point, issuerCnpj, firstNumber]: Parameters<FiscalStore[\"createIssuingPoint\"]>): Promise<void> {\n try {\n await db.$transaction(async (tx) => {\n await tx.$executeRawUnsafe(\n `INSERT INTO \"fiscal_issuing_points\" (\"id\", \"owner_id\", \"model\", \"online_series\", \"contingency_series\", \"created_at\")\n VALUES ($1, $2, $3, $4, $5, $6::timestamp(3))`,\n point.id, point.ownerId, point.model, point.onlineSeries, point.contingencySeries, point.createdAt,\n );\n await openCounters(tx, point, issuerCnpj, point.onlineSeries, \"ONLINE\", firstNumber.online);\n if (point.contingencySeries !== null) {\n await openCounters(tx, point, issuerCnpj, point.contingencySeries, \"CONTINGENCY\", firstNumber.contingency);\n }\n });\n } catch (error) {\n if (violates(error, \"fiscal_number_counters_pkey\")) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", `a series of issuing point ${point.id} already belongs to another issuing point.`);\n }\n if (violates(error, \"fiscal_issuing_points_pkey\")) throw new FiscalDocumentError(\"INVALID_INPUT\", `issuing point ${point.id} exists.`);\n throw error;\n }\n}\n\nfunction documentMethods(db: FiscalPrismaClient): Omit<FiscalStore, keyof ProfileMethods> {\n const documents = async (query: string, ...values: unknown[]) => (await rows(db, query, ...values)).map(documentOf);\n return {\n createDocument: (request, build, replace) =>\n db.$transaction(async (tx) => {\n if (replace !== undefined && !(await saveRow(tx, replace.previous, replace.transition))) {\n throw new FiscalDocumentError(\"CONFLICT\", `document ${replace.previous.id} moved before it was replaced.`);\n }\n const document = build(await draw(tx, request));\n await insertDocument(tx, document);\n return document;\n }),\n async getDocument(ownerId, id) {\n const [document] = await documents(`SELECT * FROM \"fiscal_documents\" WHERE \"id\" = $1 AND \"owner_id\" = $2`, id, ownerId);\n return document ?? null;\n },\n listBySubject: (ownerId, subjectId, model) =>\n documents(\n `SELECT * FROM \"fiscal_documents\" WHERE \"owner_id\" = $1 AND \"subject_id\" = $2 AND \"model\" = $3 ORDER BY \"created_at\", \"id\"`,\n ownerId, subjectId, model,\n ),\n async listEvents(documentId) {\n return (await rows(db, `SELECT * FROM \"fiscal_document_events\" WHERE \"document_id\" = $1 ORDER BY \"seq\"`, documentId)).map(eventOf);\n },\n saveTransition: (previous, transition) => db.$transaction((tx) => saveRow(tx, previous, transition)),\n listDue: ({ now, limit }) =>\n documents(\n `SELECT * FROM \"fiscal_documents\" WHERE \"attention\" = false AND \"next_attempt_at\" <= $1::timestamp(3) AND ${OWED}\n ORDER BY \"next_attempt_at\", \"id\" LIMIT $2`,\n now, limit,\n ),\n listContingency: ({ now, limit }) =>\n documents(\n `SELECT * FROM \"fiscal_documents\" WHERE \"attention\" = false AND \"next_attempt_at\" <= $1::timestamp(3) AND \"status\" = 'CONTINGENCY'\n ORDER BY \"next_attempt_at\", \"id\" LIMIT $2`,\n now, limit,\n ),\n listContingencyDeadline: ({ signedBefore, limit }) =>\n documents(\n `SELECT * FROM \"fiscal_documents\" WHERE \"status\" = 'CONTINGENCY' AND \"deadline_warned_at\" IS NULL\n AND (\"contingency\" ->> 'since')::timestamptz < $1::timestamptz\n ORDER BY \"created_at\", \"id\" LIMIT $2`,\n signedBefore, limit,\n ),\n };\n}\n\nexport function createPrismaFiscalStore(config: { readonly prisma: FiscalPrismaClient }): FiscalStore {\n const db = config?.prisma;\n if (typeof db?.$transaction !== \"function\" || typeof db.$queryRawUnsafe !== \"function\") {\n throw new TypeError(\"createPrismaFiscalStore needs prisma: the host's Prisma client.\");\n }\n return { ...profileMethods(db), ...documentMethods(db) };\n}\n","/**\n * The document mapping's tax half: the engine's breakdown (`computeTax`)\n * onto the `SaleForDocument` lines a host's `SaleSource` answers. The engine\n * decides; this writes what it decided:\n *\n * - one document line per breakdown line, in the breakdown's order — so an\n * exclusion the engine segregated (the service charge passed to the staff\n * at most 15% of the food and drink, class 410019; a platform's retained\n * intermediation, 410020) IS its own item, with its class and no tax\n * (RCBS art. 399 §2), and a service charge the engine did not exclude is a\n * taxed item under the class the host passed;\n * - the IBS/CBS group from the line's figures (`vBC`, the nominal rates, the\n * reduction, the amounts), or no group at all where the engine answered\n * `NONE` (MEI, não contribuinte).\n *\n * What the engine does not know — the product code, NCM, CFOP, unit, the\n * ICMS, PIS and COFINS — arrives per line id from the host. A breakdown line\n * with no details is refused, never invented.\n */\n\nimport type { LineTax, TaxBreakdown } from \"../engine/types\";\nimport type { LineIbsCbs, SaleLine } from \"../sale/types\";\nimport { FiscalDocumentError } from \"./errors\";\n\n/** Everything a document line needs that the breakdown does not carry. */\nexport type LineDetails = Omit<SaleLine, \"id\" | \"quantity\" | \"valueCents\" | \"ibsCbs\">;\n\nconst SEGREGATED = new Set<LineTax[\"source\"]>([\"GORJETA_EXCLUDED\", \"INTERMEDIATION_EXCLUDED\"]);\n\nfunction ibsCbsOf(line: LineTax, breakdown: TaxBreakdown): LineIbsCbs | null {\n if (breakdown.treatment === \"NONE\") return null;\n const code = { cst: line.taxClass.cstIbsCbs, classCode: line.taxClass.cClassTrib };\n if (SEGREGATED.has(line.source)) return { ...code, figures: null };\n return {\n ...code,\n figures: {\n baseCents: line.taxBaseCents,\n reductionBp: line.reductionBp,\n cbsRateBp: line.cbsRateBp,\n cbsCents: line.cbsCents,\n ibsUfRateBp: line.ibsUfRateBp,\n ibsUfCents: line.ibsUfCents,\n ibsMunRateBp: line.ibsMunRateBp,\n ibsMunCents: line.ibsMunCents,\n },\n };\n}\n\nexport function documentLines(breakdown: TaxBreakdown, details: Readonly<Record<string, LineDetails>>): SaleLine[] {\n return breakdown.lines.map((line) => {\n const detail = details[line.lineId];\n if (detail === undefined) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", `breakdown line ${line.lineId} has no document details.`);\n }\n return {\n ...detail,\n id: line.lineId,\n quantity: line.quantity,\n valueCents: line.valueCents,\n ibsCbs: ibsCbsOf(line, breakdown),\n };\n });\n}\n"],"mappings":"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","names":["transition","text","createIssuingPoint","transition"]}
@@ -0,0 +1,118 @@
1
+ import { b as TaxInput, a as TaxBreakdown, R as RatePeriod, L as LineFigures, c as RateTables } from '../types-B1b8LIWX.js';
2
+ export { I as IbsMunRates, d as IbsSphereRates, e as IbsUfRates, f as IsoDate, g as LineSource, h as LineTax, i as RegimeEspecifico, j as RetainedIntermediationInput, S as SellerProfile, k as ServiceChargeInput, l as TaxClass, m as TaxClassCode, n as TaxExclusions, o as TaxLineInput, T as TaxRegime, p as TaxTreatment } from '../types-B1b8LIWX.js';
3
+
4
+ /**
5
+ * `computeTax` — the table mode. Pure: no I/O, no clock, no defaults. The
6
+ * same input gives the same breakdown, stamped with the table's version, so a
7
+ * supply settled in March reproduces its own tax in December after the tables
8
+ * moved.
9
+ */
10
+
11
+ /** The IBS/CBS breakdown of one supply, from the rate tables it is given. */
12
+ declare function computeTax(input: TaxInput): TaxBreakdown;
13
+
14
+ /**
15
+ * Everything the computation decides BEFORE a per-item figure is produced:
16
+ * the regime's treatment on the date, which items are segregated exclusions,
17
+ * each taxed item's reduction and base (`vBC`). Shared by the table mode and
18
+ * the oracle mode, so the two can only ever disagree on the per-item figures —
19
+ * the thing the oracle is there to check.
20
+ */
21
+
22
+ /** The three nominal rates at the destination. */
23
+ interface DestinationRates {
24
+ readonly cbsBp: number;
25
+ readonly ibsUfBp: number;
26
+ readonly ibsMunBp: number;
27
+ }
28
+ /** The three nominal rates of the period at the destination (art. 11 I). */
29
+ declare function ratesAt(period: RatePeriod, destinationIbge: string): DestinationRates;
30
+
31
+ /**
32
+ * The ORACLE mode: the same interface as `computeTax`, with the per-item
33
+ * figures asked of an injected `OfficialCalculator` — the port a host points
34
+ * at the official IBS/CBS calculator (the Receita Federal's Calculadora de
35
+ * Tributos, open source, with an HTTP API and an embeddable component).
36
+ * Everything else — the regime's treatment, the segregated exclusions, each
37
+ * item's base — is the engine's own plan, so running both modes over one
38
+ * fixture set checks exactly the rates, the reductions and the rounding
39
+ * against the official figures.
40
+ *
41
+ * In a tax-inside-price period the base is taken out of the price with the
42
+ * TABLE's rates (the calculator takes a base, not a price), and the
43
+ * calculator's taxes on that base give the net value.
44
+ */
45
+
46
+ /** One item, as the calculator is asked about it. */
47
+ interface OfficialCalculatorItemRequest {
48
+ readonly supplyDate: string;
49
+ readonly destinationIbge: string;
50
+ readonly cClassTrib: string;
51
+ readonly cstIbsCbs: string;
52
+ /** The base after the engine's exclusions (`vBC`). */
53
+ readonly taxBaseCents: number;
54
+ readonly quantity: number;
55
+ }
56
+ /** The calculator's answer for one item: nominal rates, the reduction, and the rounded taxes. */
57
+ type OfficialCalculatorItemAnswer = LineFigures;
58
+ /** The port. The host's adapter owns the transport, the retries and the unit conversion. */
59
+ interface OfficialCalculator {
60
+ /** Stamped on the result next to the tables' version. */
61
+ readonly version: string;
62
+ calculateItem(request: OfficialCalculatorItemRequest): Promise<OfficialCalculatorItemAnswer>;
63
+ }
64
+ /** `computeTax`, with the per-item figures from the official calculator. */
65
+ declare function computeTaxWithOracle(input: TaxInput, calculator: OfficialCalculator): Promise<TaxBreakdown>;
66
+
67
+ /**
68
+ * Where two breakdowns of the same supply disagree — the table mode against
69
+ * the oracle mode, or a stored snapshot against a recomputation. Versions are
70
+ * not compared: they differ by construction.
71
+ */
72
+
73
+ interface BreakdownDisagreement {
74
+ /** `null` for an order-level field. */
75
+ readonly lineId: string | null;
76
+ readonly field: string;
77
+ readonly left: unknown;
78
+ readonly right: unknown;
79
+ }
80
+ /** Every per-line field that differs, by line id; then the order fields that the lines do not already explain. */
81
+ declare function compareBreakdowns(left: TaxBreakdown, right: TaxBreakdown): BreakdownDisagreement[];
82
+
83
+ /**
84
+ * Every refusal the engine makes. A refusal is a THROW, on purpose: the
85
+ * engine has no fallback for an input it cannot read, and a figure computed
86
+ * from a guess would be printed on a fiscal document as a confession of the
87
+ * tax due (LC 214/2025 art. 60 §1).
88
+ */
89
+ type FiscalEngineErrorCode =
90
+ /** A field is missing, out of range or of the wrong shape. */
91
+ "INVALID_INPUT"
92
+ /** The rate table is malformed: a bad rate, a bad date, overlapping periods. */
93
+ | "INVALID_TABLES"
94
+ /** No period of the table covers the date of the supply. */
95
+ | "NO_RATE_PERIOD"
96
+ /** The supply precedes the seller's `regimeEffectiveFrom`. */
97
+ | "REGIME_NOT_IN_EFFECT"
98
+ /** The official calculator answered something that is not integer cents and basis points. */
99
+ | "INVALID_ORACLE_ANSWER";
100
+ declare class FiscalEngineError extends Error {
101
+ readonly code: FiscalEngineErrorCode;
102
+ constructor(code: FiscalEngineErrorCode, message: string);
103
+ }
104
+
105
+ /** round_half_even(baseCents × rateBp/10⁴ × (1 − reductionBp/10⁴)), in cents. */
106
+ declare function roundTaxCents(baseCents: number, rateBp: number, reductionBp: number): number;
107
+
108
+ /**
109
+ * Input and table validation. Every check names the field it refused, and
110
+ * every shape is checked before it is read, so a malformed input — a missing
111
+ * object, an `undefined` where `null` is required, a `null` line — is a
112
+ * `FiscalEngineError`, never a TypeError and never a NaN on a document.
113
+ */
114
+
115
+ /** Refuse a table the engine cannot trust: bad rates, bad dates, overlapping periods. */
116
+ declare function assertRateTables(tables: unknown): asserts tables is RateTables;
117
+
118
+ export { type BreakdownDisagreement, FiscalEngineError, type FiscalEngineErrorCode, LineFigures, type OfficialCalculator, type OfficialCalculatorItemAnswer, type OfficialCalculatorItemRequest, RatePeriod, RateTables, TaxBreakdown, TaxInput, assertRateTables, compareBreakdowns, computeTax, computeTaxWithOracle, ratesAt, roundTaxCents };