@12-apps/fiscal 1.1.0 → 1.2.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 (42) hide show
  1. package/README.md +12 -0
  2. package/dist/{chunk-X6MRDUYH.js → chunk-2LBQRYPV.js} +1 -1
  3. package/dist/{chunk-X6MRDUYH.js.map → chunk-2LBQRYPV.js.map} +1 -1
  4. package/dist/{chunk-HQ2NXSTX.js → chunk-5S2PJHAE.js} +2 -2
  5. package/dist/{chunk-RRFKYVLZ.js → chunk-G3V7IYNF.js} +2 -2
  6. package/dist/{chunk-FOFIN5M7.js → chunk-JVQKJNOC.js} +1 -1
  7. package/dist/{chunk-FOFIN5M7.js.map → chunk-JVQKJNOC.js.map} +1 -1
  8. package/dist/{chunk-27B4HNO6.js → chunk-N5DCKYFR.js} +38 -2
  9. package/dist/chunk-N5DCKYFR.js.map +1 -0
  10. package/dist/{chunk-V5ZQAAJT.js → chunk-NVRYAAQ4.js} +7 -5
  11. package/dist/chunk-NVRYAAQ4.js.map +1 -0
  12. package/dist/{chunk-ALABGVPO.js → chunk-WTGASIZE.js} +2 -2
  13. package/dist/danfe/index.js +2 -2
  14. package/dist/documents/index.d.ts +14 -2
  15. package/dist/documents/index.js +9 -3
  16. package/dist/documents/index.js.map +1 -1
  17. package/dist/http.d.ts +2 -0
  18. package/dist/http.js +4 -4
  19. package/dist/issuer/index.js +1 -1
  20. package/dist/jobs.js +3 -3
  21. package/dist/manifest/server.js +6 -6
  22. package/dist/notifications.js +2 -2
  23. package/dist/sale/index.d.ts +28 -2
  24. package/dist/sidecar/index.d.ts +3 -1
  25. package/dist/sidecar/index.js +1 -1
  26. package/package.json +1 -1
  27. package/sidecar/README.md +13 -0
  28. package/sidecar/schema/sale-for-document.schema.json +21 -0
  29. package/sidecar/src/Nfe/DocumentMapper.php +46 -1
  30. package/src/documents/context.ts +1 -1
  31. package/src/documents/errors.ts +8 -1
  32. package/src/documents/helpers.ts +49 -0
  33. package/src/documents/index.ts +1 -0
  34. package/src/documents/service.ts +4 -1
  35. package/src/http.ts +2 -0
  36. package/src/sale/types.ts +27 -1
  37. package/src/sidecar/types.ts +3 -1
  38. package/dist/chunk-27B4HNO6.js.map +0 -1
  39. package/dist/chunk-V5ZQAAJT.js.map +0 -1
  40. /package/dist/{chunk-HQ2NXSTX.js.map → chunk-5S2PJHAE.js.map} +0 -0
  41. /package/dist/{chunk-RRFKYVLZ.js.map → chunk-G3V7IYNF.js.map} +0 -0
  42. /package/dist/{chunk-ALABGVPO.js.map → chunk-WTGASIZE.js.map} +0 -0
package/README.md CHANGED
@@ -198,6 +198,18 @@ nothing leaves `REJECTED`, `DENIED`, `REPLACED` or `CANCELLED` for `AUTHORIZED`
198
198
  that changes the total or the buyer's document — what the DANFE the buyer
199
199
  holds prints and its QR encodes — is refused (`RESEND_CHANGES_PRINTED_FIELDS`):
200
200
  that sale needs a new note, issued by a person.
201
+ - **A buyer's return is an NF-e of entry.** An NFC-e has no return purpose,
202
+ so the return is a model-55 document with `purpose: "RETURN"`,
203
+ `operation: "IN"` (`tpNF` 0) and the NFC-e's key in `referencedDocuments`
204
+ (`NFref/refNFe`). Before a number is drawn, `issue()` refuses a return on an
205
+ NFC-e (`RETURN_ON_NFCE`), a return quoting nothing
206
+ (`RETURN_NEEDS_REFERENCE`), an NFC-e of entry, an NFC-e quoting any document
207
+ (SEFAZ would reject it with 708 and burn the number) and a reference that is
208
+ not an access key (`INVALID_INPUT`). The host sets CFOP 1202 (within the
209
+ state) or 2202 (between states) on every line, and a single `NO_PAYMENT`
210
+ payment; the package checks neither. `isValidAccessKey` checks a typed key: 44
211
+ characters, the CNPJ inside it alphanumeric or not, the modulo-11 check
212
+ digit. A sale without the two fields is issued exactly as before.
201
213
  - **An authorised document always has its XML.** A lookup that finds a
202
214
  SUBMITTED document authorised joins the signed XML the service returned to
203
215
  the lookup's `protNFe`; without both, the document stays SUBMITTED (its
@@ -18,4 +18,4 @@ var FiscalDocumentError = class extends Error {
18
18
  export {
19
19
  FiscalDocumentError
20
20
  };
21
- //# sourceMappingURL=chunk-X6MRDUYH.js.map
21
+ //# sourceMappingURL=chunk-2LBQRYPV.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/documents/errors.ts"],"sourcesContent":["/**\n * Every refusal the document module makes, as a typed error with a `code`.\n * A message never carries a certificate, a password or a CSC: the module\n * never holds one long enough to quote it.\n */\n\nexport type FiscalDocumentErrorCode =\n /** The state machine has no such transition from the document's state. */\n | \"TRANSITION_REFUSED\"\n /** An input is missing, malformed or out of range. */\n | \"INVALID_INPUT\"\n /** No emitter profile, issuing point or document under that id. */\n | \"NOT_FOUND\"\n /** The profile does not let the package issue (`documentPolicy`), or lacks what issuing needs. */\n | \"NOT_ISSUABLE\"\n /** The signing identity is declared but not built yet (`PLATFORM`). */\n | \"NOT_SUPPORTED\"\n /** A series' counter passed 999 999 999. */\n | \"SERIES_EXHAUSTED\"\n /** Another worker advanced the document first; re-read it. */\n | \"CONFLICT\"\n /** The subject already has a live document of that model (the per-subject guard). */\n | \"SUBJECT_HAS_DOCUMENT\"\n /** The document's state has no paper to print (only AUTHORIZED, or CONTINGENCY awaiting transmission). */\n | \"NOT_PRINTABLE\"\n /**\n * A resend of a rejected contingency NFC-e would change what the buyer's\n * DANFE prints and its QR encodes (the total, the buyer's document): such a\n * sale needs a new note, issued by a person.\n */\n | \"RESEND_CHANGES_PRINTED_FIELDS\";\n\nexport class FiscalDocumentError extends Error {\n readonly code: FiscalDocumentErrorCode;\n\n constructor(code: FiscalDocumentErrorCode, message: string) {\n super(`[fiscal/documents] ${code}: ${message}`);\n this.name = \"FiscalDocumentError\";\n this.code = code;\n }\n}\n"],"mappings":";;;;;AAgCO,IAAM,sBAAN,cAAkC,MAAM;AAAA,EAhC/C,OAgC+C;AAAA;AAAA;AAAA,EACpC;AAAA,EAET,YAAY,MAA+B,SAAiB;AAC1D,UAAM,sBAAsB,IAAI,KAAK,OAAO,EAAE;AAC9C,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}
1
+ {"version":3,"sources":["../src/documents/errors.ts"],"sourcesContent":["/**\n * Every refusal the document module makes, as a typed error with a `code`.\n * A message never carries a certificate, a password or a CSC: the module\n * never holds one long enough to quote it.\n */\n\nexport type FiscalDocumentErrorCode =\n /** The state machine has no such transition from the document's state. */\n | \"TRANSITION_REFUSED\"\n /** An input is missing, malformed or out of range. */\n | \"INVALID_INPUT\"\n /** No emitter profile, issuing point or document under that id. */\n | \"NOT_FOUND\"\n /** The profile does not let the package issue (`documentPolicy`), or lacks what issuing needs. */\n | \"NOT_ISSUABLE\"\n /** The signing identity is declared but not built yet (`PLATFORM`). */\n | \"NOT_SUPPORTED\"\n /** A series' counter passed 999 999 999. */\n | \"SERIES_EXHAUSTED\"\n /** Another worker advanced the document first; re-read it. */\n | \"CONFLICT\"\n /** The subject already has a live document of that model (the per-subject guard). */\n | \"SUBJECT_HAS_DOCUMENT\"\n /** The document's state has no paper to print (only AUTHORIZED, or CONTINGENCY awaiting transmission). */\n | \"NOT_PRINTABLE\"\n /**\n * A resend of a rejected contingency NFC-e would change what the buyer's\n * DANFE prints and its QR encodes (the total, the buyer's document): such a\n * sale needs a new note, issued by a person.\n */\n | \"RESEND_CHANGES_PRINTED_FIELDS\"\n /** A `RETURN` quotes no document (`referencedDocuments` is absent or empty). */\n | \"RETURN_NEEDS_REFERENCE\"\n /**\n * A `RETURN` asked of an NFC-e. An NFC-e has no return purpose: the return is\n * an NF-e (model 55) of entry that references the NFC-e's key.\n */\n | \"RETURN_ON_NFCE\";\n\nexport class FiscalDocumentError extends Error {\n readonly code: FiscalDocumentErrorCode;\n\n constructor(code: FiscalDocumentErrorCode, message: string) {\n super(`[fiscal/documents] ${code}: ${message}`);\n this.name = \"FiscalDocumentError\";\n this.code = code;\n }\n}\n"],"mappings":";;;;;AAuCO,IAAM,sBAAN,cAAkC,MAAM;AAAA,EAvC/C,OAuC+C;AAAA;AAAA;AAAA,EACpC;AAAA,EAET,YAAY,MAA+B,SAAiB;AAC1D,UAAM,sBAAsB,IAAI,KAAK,OAAO,EAAE;AAC9C,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  FISCAL_CERTIFICATE_EXPIRING
3
- } from "./chunk-27B4HNO6.js";
3
+ } from "./chunk-N5DCKYFR.js";
4
4
  import {
5
5
  FISCAL_MANAGE
6
6
  } from "./chunk-3SDXLSG4.js";
@@ -82,4 +82,4 @@ export {
82
82
  daysLeft,
83
83
  FISCAL_JOBS
84
84
  };
85
- //# sourceMappingURL=chunk-HQ2NXSTX.js.map
85
+ //# sourceMappingURL=chunk-5S2PJHAE.js.map
@@ -3,7 +3,7 @@ import {
3
3
  } from "./chunk-XQGW5HUG.js";
4
4
  import {
5
5
  FiscalDocumentError
6
- } from "./chunk-X6MRDUYH.js";
6
+ } from "./chunk-2LBQRYPV.js";
7
7
  import {
8
8
  __name
9
9
  } from "./chunk-7QVYU63E.js";
@@ -189,4 +189,4 @@ export {
189
189
  parseCertificateUpload,
190
190
  parseIssuingPointInput
191
191
  };
192
- //# sourceMappingURL=chunk-RRFKYVLZ.js.map
192
+ //# sourceMappingURL=chunk-G3V7IYNF.js.map
@@ -11,4 +11,4 @@ var SIDECAR_ERROR_CLASSES = [
11
11
  export {
12
12
  SIDECAR_ERROR_CLASSES
13
13
  };
14
- //# sourceMappingURL=chunk-FOFIN5M7.js.map
14
+ //# sourceMappingURL=chunk-JVQKJNOC.js.map
@@ -1 +1 @@
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`); `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":[]}
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":[]}
@@ -7,7 +7,7 @@ import {
7
7
  } from "./chunk-3SDXLSG4.js";
8
8
  import {
9
9
  FiscalDocumentError
10
- } from "./chunk-X6MRDUYH.js";
10
+ } from "./chunk-2LBQRYPV.js";
11
11
  import {
12
12
  __name
13
13
  } from "./chunk-7QVYU63E.js";
@@ -359,6 +359,40 @@ function keyCheckDigit(body) {
359
359
  return rest < 2 ? 0 : 11 - rest;
360
360
  }
361
361
  __name(keyCheckDigit, "keyCheckDigit");
362
+ var ACCESS_KEY_SHAPE = /^[0-9]{6}[0-9A-Z]{12}[0-9]{26}$/;
363
+ var MAX_REFERENCED_DOCUMENTS = 500;
364
+ function isValidAccessKey(key) {
365
+ if (!ACCESS_KEY_SHAPE.test(key)) return false;
366
+ return keyCheckDigit(key.slice(0, 43)) === Number(key.slice(43));
367
+ }
368
+ __name(isValidAccessKey, "isValidAccessKey");
369
+ function assertDraftFits(draft, model) {
370
+ const references = draft.referencedDocuments ?? [];
371
+ if (model === "NFCE") assertNfceDraftFits(draft, references.length);
372
+ if (draft.purpose === "RETURN" && references.length === 0) {
373
+ throw new FiscalDocumentError("RETURN_NEEDS_REFERENCE", "a return must reference the document it returns (referencedDocuments).");
374
+ }
375
+ if (references.length > MAX_REFERENCED_DOCUMENTS) {
376
+ throw new FiscalDocumentError("INVALID_INPUT", `at most ${MAX_REFERENCED_DOCUMENTS} referenced documents, not ${references.length}.`);
377
+ }
378
+ const bad = references.findIndex((reference) => !isValidAccessKey(reference.accessKey));
379
+ if (bad !== -1) {
380
+ throw new FiscalDocumentError("INVALID_INPUT", `referencedDocuments[${bad}].accessKey is not a 44-character access key.`);
381
+ }
382
+ }
383
+ __name(assertDraftFits, "assertDraftFits");
384
+ function assertNfceDraftFits(draft, referenceCount) {
385
+ if (draft.purpose === "RETURN") {
386
+ throw new FiscalDocumentError("RETURN_ON_NFCE", "an NFC-e has no return purpose: issue an NF-e (model 55) of entry referencing it.");
387
+ }
388
+ if (draft.operation === "IN") {
389
+ throw new FiscalDocumentError("INVALID_INPUT", 'an NFC-e is an outgoing document: operation must be "OUT".');
390
+ }
391
+ if (referenceCount > 0) {
392
+ throw new FiscalDocumentError("INVALID_INPUT", "an NFC-e references no document (SEFAZ 708): referencedDocuments must be empty.");
393
+ }
394
+ }
395
+ __name(assertNfceDraftFits, "assertNfceDraftFits");
362
396
  function computeAccessKey(input) {
363
397
  const { sale } = input;
364
398
  const body = [
@@ -562,6 +596,8 @@ export {
562
596
  issuerOf,
563
597
  totalsOf,
564
598
  xmlKeys,
599
+ isValidAccessKey,
600
+ assertDraftFits,
565
601
  computeAccessKey,
566
602
  FISCAL_DOCUMENT_REJECTED,
567
603
  FISCAL_CERTIFICATE_EXPIRING,
@@ -571,4 +607,4 @@ export {
571
607
  assertReason,
572
608
  FiscalContext
573
609
  };
574
- //# sourceMappingURL=chunk-27B4HNO6.js.map
610
+ //# sourceMappingURL=chunk-N5DCKYFR.js.map
@@ -0,0 +1 @@
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":"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","names":[]}
@@ -1,12 +1,12 @@
1
1
  import {
2
2
  renderDanfeNfce
3
- } from "./chunk-ALABGVPO.js";
3
+ } from "./chunk-WTGASIZE.js";
4
4
  import {
5
5
  parseCertificateUpload,
6
6
  parseIssuingPointInput,
7
7
  parseProfileInput,
8
8
  viewOf
9
- } from "./chunk-RRFKYVLZ.js";
9
+ } from "./chunk-G3V7IYNF.js";
10
10
  import {
11
11
  FISCAL_DOCUMENT_MODELS
12
12
  } from "./chunk-XQGW5HUG.js";
@@ -18,7 +18,7 @@ import {
18
18
  } from "./chunk-3SDXLSG4.js";
19
19
  import {
20
20
  FiscalDocumentError
21
- } from "./chunk-X6MRDUYH.js";
21
+ } from "./chunk-2LBQRYPV.js";
22
22
  import {
23
23
  __name
24
24
  } from "./chunk-7QVYU63E.js";
@@ -34,7 +34,9 @@ var FISCAL_ERROR_STATUS = {
34
34
  CONFLICT: 409,
35
35
  SUBJECT_HAS_DOCUMENT: 409,
36
36
  NOT_PRINTABLE: 409,
37
- RESEND_CHANGES_PRINTED_FIELDS: 422
37
+ RESEND_CHANGES_PRINTED_FIELDS: 422,
38
+ RETURN_NEEDS_REFERENCE: 422,
39
+ RETURN_ON_NFCE: 422
38
40
  };
39
41
  var PRINTABLE = /* @__PURE__ */ new Set(["AUTHORIZED", "CONTINGENCY"]);
40
42
  var ok = /* @__PURE__ */ __name((data, status = 200) => ({ status, body: { data } }), "ok");
@@ -207,4 +209,4 @@ export {
207
209
  FISCAL_ERROR_STATUS,
208
210
  createApiFiscal
209
211
  };
210
- //# sourceMappingURL=chunk-V5ZQAAJT.js.map
212
+ //# sourceMappingURL=chunk-NVRYAAQ4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/http.ts"],"sourcesContent":["/**\n * `createApiFiscal` — the fiscal HTTP surface as framework-neutral route\n * descriptors (the wiring contract's `http` capability, restated here\n * structurally: this package imports nothing from the contract at runtime,\n * and its manifest suite pins the twins).\n *\n * The package owns the paths, the bodies it reads (`./documents/profile-input`,\n * unknown keys refused), the `{ data }` envelope, the permission each route\n * needs and the status a refusal earns ({@link FISCAL_ERROR_STATUS}). The host\n * owns resolving WHO is calling into the opaque `ownerId` of its tenant, the\n * guards that check the declared permission, and every word a person reads:\n * an error answers a `code` for the host to word, never a sentence for a user.\n *\n * Nothing secret leaves: the profile answers `hasCertificate` / `hasCsc`, never\n * a ciphertext, and the certificate upload answers the profile view.\n */\n\nimport { type DanfeNfceLabels } from \"./danfe/labels\";\nimport { type PaperWidth, renderDanfeNfce } from \"./danfe/render\";\nimport { FiscalDocumentError, type FiscalDocumentErrorCode } from \"./documents/errors\";\nimport type { DocumentStorage } from \"./documents/ports\";\nimport { parseCertificateUpload, parseIssuingPointInput, parseProfileInput } from \"./documents/profile-input\";\nimport { viewOf } from \"./documents/profile\";\nimport type { FiscalDocuments } from \"./documents/service\";\nimport { FISCAL_DOCUMENT_MODELS, type FiscalDocumentModel } from \"./documents/types\";\nimport { FISCAL_CANCEL, FISCAL_ISSUE, FISCAL_MANAGE, FISCAL_READ } from \"./manifest/permissions\";\n\n/** The caller, as the host's adapter resolved it. */\nexport interface FiscalHttpActor {\n /** The emitter profile's owner: the host's tenant, mapped to an opaque id. */\n readonly ownerId: string;\n}\n\n/** Structural twin of the wiring contract's `WireRequest<FiscalHttpActor>`. */\nexport interface FiscalHttpRequest {\n actor: FiscalHttpActor;\n params: Record<string, string | undefined>;\n query: Record<string, string | undefined>;\n body?: unknown;\n}\n\n/** Structural twin of the wiring contract's `WireResponse`. */\nexport interface FiscalHttpResponse {\n status: number;\n body: unknown;\n}\n\n/** Structural twin of the wiring contract's `WireRoute<FiscalHttpActor>`. */\nexport interface FiscalRoute {\n method: \"GET\" | \"POST\" | \"PUT\";\n path: string;\n permission: string;\n handle(request: FiscalHttpRequest): Promise<FiscalHttpResponse>;\n}\n\nexport interface FiscalApiConfig {\n readonly documents: FiscalDocuments;\n /** Where the XMLs are, to render a DANFE from. */\n readonly storage: DocumentStorage;\n /** The DANFE's words: the host's, or `@12-apps/fiscal/danfe/pt-BR`. */\n readonly danfeLabels: DanfeNfceLabels;\n}\n\nexport const FISCAL_ERROR_STATUS = {\n INVALID_INPUT: 400,\n NOT_FOUND: 404,\n NOT_ISSUABLE: 409,\n NOT_SUPPORTED: 501,\n TRANSITION_REFUSED: 409,\n SERIES_EXHAUSTED: 409,\n CONFLICT: 409,\n SUBJECT_HAS_DOCUMENT: 409,\n NOT_PRINTABLE: 409,\n RESEND_CHANGES_PRINTED_FIELDS: 422,\n RETURN_NEEDS_REFERENCE: 422,\n RETURN_ON_NFCE: 422,\n} as const satisfies Record<FiscalDocumentErrorCode, number>;\n\n/**\n * The states with paper: an authorised document, and one signed offline and\n * not yet transmitted (its DANFE is what the buyer takes). A denied,\n * cancelled, rejected or replaced document is not a valid DANFE.\n */\nconst PRINTABLE = new Set([\"AUTHORIZED\", \"CONTINGENCY\"]);\n\nconst ok = (data: unknown, status = 200): FiscalHttpResponse => ({ status, body: { data } });\n\nasync function answering(run: () => Promise<FiscalHttpResponse>): Promise<FiscalHttpResponse> {\n try {\n return await run();\n } catch (error) {\n if (error instanceof FiscalDocumentError) {\n return { status: FISCAL_ERROR_STATUS[error.code], body: { error: error.code, message: error.message } };\n }\n throw error;\n }\n}\n\nfunction record(body: unknown): Record<string, unknown> {\n if (body === null || typeof body !== \"object\" || Array.isArray(body)) {\n throw new FiscalDocumentError(\"INVALID_INPUT\", \"the body must be an object.\");\n }\n return body as Record<string, unknown>;\n}\n\nfunction stringField(body: Record<string, unknown>, key: string): string {\n const value = body[key];\n if (typeof value !== \"string\" || value === \"\") throw new FiscalDocumentError(\"INVALID_INPUT\", `${key} is required.`);\n return value;\n}\n\nfunction param(request: FiscalHttpRequest, key: string): string {\n const value = request.params[key];\n if (value === undefined || value === \"\") throw new FiscalDocumentError(\"INVALID_INPUT\", `${key} is required.`);\n return value;\n}\n\nconst ISSUE_KEYS = new Set([\"subjectId\", \"issuingPointId\", \"model\", \"offline\"]);\n\nfunction issueBody(body: unknown): { subjectId: string; issuingPointId: string; model: FiscalDocumentModel; offline: boolean } {\n const fields = record(body);\n const unknown = Object.keys(fields).filter((key) => !ISSUE_KEYS.has(key));\n if (unknown.length > 0) throw new FiscalDocumentError(\"INVALID_INPUT\", `unknown keys: ${unknown.join(\", \")}.`);\n const model = fields[\"model\"];\n if (!FISCAL_DOCUMENT_MODELS.includes(model as FiscalDocumentModel)) throw new FiscalDocumentError(\"INVALID_INPUT\", \"model must be NFE or NFCE.\");\n const offline = fields[\"offline\"] ?? false;\n if (typeof offline !== \"boolean\") throw new FiscalDocumentError(\"INVALID_INPUT\", \"offline must be a boolean.\");\n if (offline && model !== \"NFCE\") throw new FiscalDocumentError(\"INVALID_INPUT\", \"only an NFC-e is issued offline.\");\n return { subjectId: stringField(fields, \"subjectId\"), issuingPointId: stringField(fields, \"issuingPointId\"), model: model as FiscalDocumentModel, offline };\n}\n\nfunction profileRoutes({ documents }: FiscalApiConfig): FiscalRoute[] {\n return [\n {\n method: \"GET\",\n path: \"/fiscal/profile\",\n permission: FISCAL_READ,\n handle: ({ actor }) =>\n answering(async () => {\n const profile = await documents.getProfile(actor.ownerId);\n return ok(profile === null ? null : viewOf(profile));\n }),\n },\n {\n method: \"PUT\",\n path: \"/fiscal/profile\",\n permission: FISCAL_MANAGE,\n handle: ({ actor, body }) => answering(async () => ok(viewOf(await documents.saveProfile(actor.ownerId, parseProfileInput(body))))),\n },\n {\n method: \"PUT\",\n path: \"/fiscal/profile/certificate\",\n permission: FISCAL_MANAGE,\n handle: ({ actor, body }) =>\n answering(async () => ok(viewOf(await documents.uploadCertificate(actor.ownerId, parseCertificateUpload(body))))),\n },\n {\n method: \"GET\",\n path: \"/fiscal/issuing-points\",\n permission: FISCAL_READ,\n handle: ({ actor }) => answering(async () => ok(await documents.listIssuingPoints(actor.ownerId))),\n },\n {\n method: \"POST\",\n path: \"/fiscal/issuing-points\",\n permission: FISCAL_MANAGE,\n handle: ({ actor, body }) =>\n answering(async () => ok(await documents.createIssuingPoint(actor.ownerId, parseIssuingPointInput(body)), 201)),\n },\n ];\n}\n\n/** The DANFE of a printable document, as ESC/POS-ready lines. */\nfunction danfeRoute({ documents, storage, danfeLabels }: FiscalApiConfig): FiscalRoute {\n return {\n method: \"GET\",\n path: \"/fiscal/documents/:documentId/danfe\",\n permission: FISCAL_READ,\n handle: (request) =>\n answering(async () => {\n const paper = Number(request.query[\"paper\"] ?? \"80\");\n if (paper !== 58 && paper !== 80) throw new FiscalDocumentError(\"INVALID_INPUT\", \"paper must be 58 or 80.\");\n const document = await documents.getDocument(request.actor.ownerId, param(request, \"documentId\"));\n if (!PRINTABLE.has(document.status)) {\n throw new FiscalDocumentError(\"NOT_PRINTABLE\", `document ${document.id} is ${document.status}: only an AUTHORIZED or CONTINGENCY document prints.`);\n }\n const xml = document.model === \"NFCE\" && document.xmlKey !== null ? await storage.get(document.xmlKey) : null;\n if (xml === null) throw new FiscalDocumentError(\"NOT_FOUND\", `document ${document.id} has no NFC-e XML to print.`);\n return ok(renderDanfeNfce({ xml, paperWidth: paper as PaperWidth, labels: danfeLabels }));\n }),\n };\n}\n\nfunction documentRoutes(config: FiscalApiConfig): FiscalRoute[] {\n const { documents } = config;\n return [\n {\n method: \"POST\",\n path: \"/fiscal/documents\",\n permission: FISCAL_ISSUE,\n handle: ({ actor, body }) =>\n answering(async () => {\n const { offline, ...input } = issueBody(body);\n const document = offline\n ? await documents.issueOffline({ ownerId: actor.ownerId, subjectId: input.subjectId, issuingPointId: input.issuingPointId })\n : await documents.issue({ ownerId: actor.ownerId, ...input });\n return ok(document);\n }),\n },\n {\n method: \"GET\",\n path: \"/fiscal/documents/:documentId\",\n permission: FISCAL_READ,\n handle: (request) =>\n answering(async () => {\n const documentId = param(request, \"documentId\");\n const document = await documents.getDocument(request.actor.ownerId, documentId);\n return ok({ document, events: await documents.listEvents(request.actor.ownerId, documentId) });\n }),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/cancel\",\n permission: FISCAL_CANCEL,\n handle: (request) =>\n answering(async () => {\n const reason = stringField(record(request.body), \"reason\");\n const result = await documents.cancel({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\"), reason });\n return result.failure === null\n ? ok(result.document)\n : { status: 422, body: { error: \"ISSUER_FAILURE\", failure: result.failure, data: result.document } };\n }),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/resend\",\n permission: FISCAL_ISSUE,\n handle: (request) =>\n answering(async () =>\n ok(await documents.resendContingency({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\") })),\n ),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/release\",\n permission: FISCAL_ISSUE,\n handle: (request) =>\n answering(async () => ok(await documents.release({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\") }))),\n },\n {\n method: \"POST\",\n path: \"/fiscal/documents/:documentId/lookup\",\n permission: FISCAL_READ,\n handle: (request) =>\n answering(async () => ok(await documents.lookup({ ownerId: request.actor.ownerId, documentId: param(request, \"documentId\") }))),\n },\n danfeRoute(config),\n ];\n}\n\nexport function createApiFiscal(config: FiscalApiConfig): { routes: readonly FiscalRoute[] } {\n if (config?.documents === undefined) throw new TypeError(\"createApiFiscal needs documents.\");\n if (config.storage === undefined) throw new TypeError(\"createApiFiscal needs storage.\");\n if (config.danfeLabels === undefined) throw new TypeError(\"createApiFiscal needs danfeLabels.\");\n return { routes: [...profileRoutes(config), ...documentRoutes(config)] };\n}\n"],"mappings":"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","names":[]}
@@ -6,7 +6,7 @@ import {
6
6
  } from "./chunk-PNTKG3DZ.js";
7
7
  import {
8
8
  FiscalDocumentError
9
- } from "./chunk-X6MRDUYH.js";
9
+ } from "./chunk-2LBQRYPV.js";
10
10
  import {
11
11
  __name
12
12
  } from "./chunk-7QVYU63E.js";
@@ -244,4 +244,4 @@ export {
244
244
  wrap,
245
245
  renderDanfeNfce
246
246
  };
247
- //# sourceMappingURL=chunk-ALABGVPO.js.map
247
+ //# sourceMappingURL=chunk-WTGASIZE.js.map
@@ -4,9 +4,9 @@ import {
4
4
  money,
5
5
  renderDanfeNfce,
6
6
  wrap
7
- } from "../chunk-ALABGVPO.js";
7
+ } from "../chunk-WTGASIZE.js";
8
8
  import "../chunk-PNTKG3DZ.js";
9
- import "../chunk-X6MRDUYH.js";
9
+ import "../chunk-2LBQRYPV.js";
10
10
  import "../chunk-7QVYU63E.js";
11
11
  export {
12
12
  DANFE_COLUMNS,
@@ -36,7 +36,14 @@ type FiscalDocumentErrorCode =
36
36
  * DANFE prints and its QR encodes (the total, the buyer's document): such a
37
37
  * sale needs a new note, issued by a person.
38
38
  */
39
- | "RESEND_CHANGES_PRINTED_FIELDS";
39
+ | "RESEND_CHANGES_PRINTED_FIELDS"
40
+ /** A `RETURN` quotes no document (`referencedDocuments` is absent or empty). */
41
+ | "RETURN_NEEDS_REFERENCE"
42
+ /**
43
+ * A `RETURN` asked of an NFC-e. An NFC-e has no return purpose: the return is
44
+ * an NF-e (model 55) of entry that references the NFC-e's key.
45
+ */
46
+ | "RETURN_ON_NFCE";
40
47
  declare class FiscalDocumentError extends Error {
41
48
  readonly code: FiscalDocumentErrorCode;
42
49
  constructor(code: FiscalDocumentErrorCode, message: string);
@@ -63,6 +70,11 @@ declare const xmlKeys: {
63
70
  cancel: (accessKey: string) => string;
64
71
  inutilization: (document: FiscalDocument) => string;
65
72
  };
73
+ /**
74
+ * Whether `key` is an access key as the layout writes one: 44 characters, the
75
+ * CNPJ inside it alphanumeric or not, and its modulo-11 check digit right.
76
+ */
77
+ declare function isValidAccessKey(key: string): boolean;
66
78
  /**
67
79
  * The 44-character access key a document will carry, computed as the layout
68
80
  * does: cUF, AAMM of `dhEmi`, CNPJ, model, series, number, `tpEmis` (1 online,
@@ -166,4 +178,4 @@ declare function createPrismaFiscalStore(config: {
166
178
  type LineDetails = Omit<SaleLine, "id" | "quantity" | "valueCents" | "ibsCbs">;
167
179
  declare function documentLines(breakdown: TaxBreakdown, details: Readonly<Record<string, LineDetails>>): SaleLine[];
168
180
 
169
- export { FISCAL_NEXT_NUMBER_SQL, FiscalDocument, FiscalDocumentError, type FiscalDocumentErrorCode, FiscalDocumentEvent, FiscalDocumentModel, type FiscalPrismaClient, type FiscalSqlClient, FiscalStore, type LineDetails, type MemoryFiscalStore, SaleDraft, SeriesKind, computeAccessKey, createMemoryFiscalStore, createPrismaFiscalStore, documentLines, draftOf, drawKeyCode, localIso, xmlKeys };
181
+ export { FISCAL_NEXT_NUMBER_SQL, FiscalDocument, FiscalDocumentError, type FiscalDocumentErrorCode, FiscalDocumentEvent, FiscalDocumentModel, type FiscalPrismaClient, type FiscalSqlClient, FiscalStore, type LineDetails, type MemoryFiscalStore, SaleDraft, SeriesKind, computeAccessKey, createMemoryFiscalStore, createPrismaFiscalStore, documentLines, draftOf, drawKeyCode, isValidAccessKey, localIso, xmlKeys };
@@ -5,7 +5,7 @@ import {
5
5
  parseIssuingPointInput,
6
6
  parseProfileInput,
7
7
  viewOf
8
- } from "../chunk-RRFKYVLZ.js";
8
+ } from "../chunk-G3V7IYNF.js";
9
9
  import {
10
10
  element
11
11
  } from "../chunk-PNTKG3DZ.js";
@@ -19,18 +19,20 @@ import {
19
19
  FiscalContext,
20
20
  MAX_FAILURES,
21
21
  assertConfig,
22
+ assertDraftFits,
22
23
  assertReason,
23
24
  canTransition,
24
25
  computeAccessKey,
25
26
  draftOf,
26
27
  drawKeyCode,
28
+ isValidAccessKey,
27
29
  issuerOf,
28
30
  localIso,
29
31
  scrubSecrets,
30
32
  totalsOf,
31
33
  transition,
32
34
  xmlKeys
33
- } from "../chunk-27B4HNO6.js";
35
+ } from "../chunk-N5DCKYFR.js";
34
36
  import {
35
37
  FISCAL_DOCUMENT_MODELS,
36
38
  FISCAL_DOCUMENT_STATUSES,
@@ -42,7 +44,7 @@ import {
42
44
  } from "../chunk-3SDXLSG4.js";
43
45
  import {
44
46
  FiscalDocumentError
45
- } from "../chunk-X6MRDUYH.js";
47
+ } from "../chunk-2LBQRYPV.js";
46
48
  import {
47
49
  __name
48
50
  } from "../chunk-7QVYU63E.js";
@@ -400,6 +402,7 @@ async function issue(deps, input) {
400
402
  if (existing !== null) return existing;
401
403
  const signing = await deps.ctx.material(profile);
402
404
  const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: input.subjectId, model: input.model });
405
+ assertDraftFits(draft, input.model);
403
406
  const numbered = await numberOrExisting(
404
407
  deps,
405
408
  input,
@@ -415,6 +418,7 @@ async function issueOffline(deps, input) {
415
418
  if (existing !== null) return existing;
416
419
  const signing = await deps.ctx.material(profile);
417
420
  const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: input.subjectId, model: "NFCE" });
421
+ assertDraftFits(draft, "NFCE");
418
422
  const numbered = await numberOrExisting(
419
423
  deps,
420
424
  target,
@@ -434,6 +438,7 @@ async function resendContingency(deps, input) {
434
438
  }
435
439
  const profile = await deps.ctx.requireProfile(input.ownerId);
436
440
  const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: document.subjectId, model: document.model });
441
+ assertDraftFits(draft, document.model);
437
442
  const totals = totalsOf(draft);
438
443
  const buyerTaxId = draft.buyer?.document.number ?? null;
439
444
  if (printedFieldsChange(document, totals, buyerTaxId)) {
@@ -1216,6 +1221,7 @@ export {
1216
1221
  draftOf,
1217
1222
  drawKeyCode,
1218
1223
  isLive,
1224
+ isValidAccessKey,
1219
1225
  localIso,
1220
1226
  parseCertificateUpload,
1221
1227
  parseIssuingPointInput,