@12-apps/fiscal 1.1.0 → 1.3.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 (49) hide show
  1. package/README.md +26 -0
  2. package/dist/{chunk-RRFKYVLZ.js → chunk-GGYJPFBJ.js} +2 -2
  3. package/dist/{chunk-27B4HNO6.js → chunk-GKT3X5CF.js} +38 -2
  4. package/dist/chunk-GKT3X5CF.js.map +1 -0
  5. package/dist/{chunk-X6MRDUYH.js → chunk-H33BK623.js} +1 -1
  6. package/dist/{chunk-X6MRDUYH.js.map → chunk-H33BK623.js.map} +1 -1
  7. package/dist/{chunk-FOFIN5M7.js → chunk-JVQKJNOC.js} +1 -1
  8. package/dist/{chunk-FOFIN5M7.js.map → chunk-JVQKJNOC.js.map} +1 -1
  9. package/dist/{chunk-HQ2NXSTX.js → chunk-MEBG7FGG.js} +2 -2
  10. package/dist/{chunk-ALABGVPO.js → chunk-MGTROA7K.js} +2 -2
  11. package/dist/{chunk-V5ZQAAJT.js → chunk-V6G2OFLA.js} +8 -5
  12. package/dist/chunk-V6G2OFLA.js.map +1 -0
  13. package/dist/{context-ChnWR4Kb.d.ts → context-yc1C2__K.d.ts} +1 -1
  14. package/dist/danfe/index.js +2 -2
  15. package/dist/documents/index.d.ts +25 -7
  16. package/dist/documents/index.js +60 -3
  17. package/dist/documents/index.js.map +1 -1
  18. package/dist/http.d.ts +6 -3
  19. package/dist/http.js +4 -4
  20. package/dist/issuer/index.d.ts +2 -2
  21. package/dist/issuer/index.js +1 -1
  22. package/dist/jobs.d.ts +3 -3
  23. package/dist/jobs.js +3 -3
  24. package/dist/manifest/server.d.ts +3 -3
  25. package/dist/manifest/server.js +6 -6
  26. package/dist/notifications.d.ts +2 -2
  27. package/dist/notifications.js +2 -2
  28. package/dist/{port-DpRFK56U.d.ts → port-B1-ipIL4.d.ts} +1 -1
  29. package/dist/sale/index.d.ts +28 -2
  30. package/dist/{service-KTjH7AxW.d.ts → service-BB9lWdyg.d.ts} +30 -3
  31. package/dist/sidecar/index.d.ts +3 -1
  32. package/dist/sidecar/index.js +1 -1
  33. package/package.json +1 -1
  34. package/sidecar/README.md +13 -0
  35. package/sidecar/schema/sale-for-document.schema.json +21 -0
  36. package/sidecar/src/Nfe/DocumentMapper.php +46 -1
  37. package/src/documents/context.ts +1 -1
  38. package/src/documents/errors.ts +14 -1
  39. package/src/documents/helpers.ts +49 -0
  40. package/src/documents/index.ts +3 -2
  41. package/src/documents/service.ts +98 -1
  42. package/src/http.ts +3 -0
  43. package/src/sale/types.ts +27 -1
  44. package/src/sidecar/types.ts +3 -1
  45. package/dist/chunk-27B4HNO6.js.map +0 -1
  46. package/dist/chunk-V5ZQAAJT.js.map +0 -1
  47. /package/dist/{chunk-RRFKYVLZ.js.map → chunk-GGYJPFBJ.js.map} +0 -0
  48. /package/dist/{chunk-HQ2NXSTX.js.map → chunk-MEBG7FGG.js.map} +0 -0
  49. /package/dist/{chunk-ALABGVPO.js.map → chunk-MGTROA7K.js.map} +0 -0
@@ -13,7 +13,7 @@
13
13
  import type { IssuerFailure } from "../issuer/port";
14
14
  import { FISCAL_ISSUE } from "../manifest/permissions";
15
15
  import type { LookedUpDocument } from "../sidecar/types";
16
- import { FISCAL_CONTINGENCY_DEADLINE, FiscalContext, assertConfig, assertReason, issuerOf, totalsOf, xmlKeys } from "./context";
16
+ import { FISCAL_CONTINGENCY_DEADLINE, FiscalContext, assertConfig, assertDraftFits, assertReason, issuerOf, totalsOf, xmlKeys } from "./context";
17
17
  import { FiscalDocumentError } from "./errors";
18
18
  import { canTransition } from "./machine";
19
19
  import { type Deps, type FiscalDocumentsServiceConfig, createIssuingPoint, saveProfile, uploadCertificate } from "./service-profile";
@@ -80,6 +80,7 @@ async function issue(deps: Deps, input: IssueInput): Promise<FiscalDocument> {
80
80
  if (existing !== null) return existing;
81
81
  const signing = await deps.ctx.material(profile);
82
82
  const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: input.subjectId, model: input.model });
83
+ assertDraftFits(draft, input.model);
83
84
  const numbered = await numberOrExisting(deps, input, () =>
84
85
  deps.ctx.createNumbered({ profile, point, subjectId: input.subjectId, model: input.model, seriesKind: "ONLINE", draft }),
85
86
  );
@@ -94,6 +95,7 @@ async function issueOffline(deps: Deps, input: Omit<IssueInput, "model">): Promi
94
95
  if (existing !== null) return existing;
95
96
  const signing = await deps.ctx.material(profile);
96
97
  const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: input.subjectId, model: "NFCE" });
98
+ assertDraftFits(draft, "NFCE");
97
99
  const numbered = await numberOrExisting(deps, target, () =>
98
100
  deps.ctx.createNumbered({ profile, point, subjectId: input.subjectId, model: "NFCE", seriesKind: "CONTINGENCY", draft }),
99
101
  );
@@ -127,6 +129,7 @@ async function resendContingency(deps: Deps, input: { ownerId: string; documentI
127
129
  }
128
130
  const profile = await deps.ctx.requireProfile(input.ownerId);
129
131
  const draft = await deps.config.sales.saleFor({ ownerId: input.ownerId, subjectId: document.subjectId, model: document.model });
132
+ assertDraftFits(draft, document.model);
130
133
  const totals = totalsOf(draft);
131
134
  const buyerTaxId = draft.buyer?.document.number ?? null;
132
135
  if (printedFieldsChange(document, totals, buyerTaxId)) {
@@ -173,6 +176,95 @@ async function cancel(
173
176
  return { document: cancelled, failure: null };
174
177
  }
175
178
 
179
+ /** SEFAZ's refusals of a cancel that came too late: "prazo de cancelamento superior ao previsto". */
180
+ export const LATE_CANCEL_CODES = ["501"] as const;
181
+
182
+ const isLateCancel = (code: string | null): boolean => code !== null && (LATE_CANCEL_CODES as readonly string[]).includes(code);
183
+
184
+ export interface CancelOrReturnInput {
185
+ readonly ownerId: string;
186
+ readonly documentId: string;
187
+ /** SEFAZ's 15–255 characters, sent with the cancel. */
188
+ readonly reason: string;
189
+ /** The NF-e (model 55) issuing point a return is numbered on. */
190
+ readonly returnPointId: string;
191
+ }
192
+
193
+ export interface CancelOrReturnResult {
194
+ /**
195
+ * `CANCELLED` inside the window; `RETURNED` past it (the return may itself
196
+ * still be SUBMITTED: the sweep settles it like any document); `REFUSED`
197
+ * when the issuer refused the cancel for any other reason (nothing changed).
198
+ */
199
+ readonly outcome: "CANCELLED" | "RETURNED" | "REFUSED";
200
+ /** The document asked about, as it stands: CANCELLED, or still AUTHORIZED beside its return. */
201
+ readonly document: FiscalDocument;
202
+ readonly returnDocument: FiscalDocument | null;
203
+ readonly failure: IssuerFailure | null;
204
+ }
205
+
206
+ /** The subject's live return NF-e that quotes this key, if one was issued already. */
207
+ async function liveReturnOf(deps: Deps, document: FiscalDocument): Promise<FiscalDocument | null> {
208
+ const returns = (await deps.config.store.listBySubject(document.ownerId, document.subjectId, "NFE")).filter(isLive);
209
+ const quoting = returns.filter((candidate) => returnsDocument(candidate, document));
210
+ return quoting[quoting.length - 1] ?? null;
211
+ }
212
+
213
+ /**
214
+ * Cancel an authorised document; when SEFAZ refuses the cancel as LATE (501),
215
+ * issue the buyer's return instead: an NF-e of entry on `returnPointId`, the
216
+ * host's `SaleSource` answering the return sale for the document's subject
217
+ * (`model: "NFE"`), which must quote this document's key. The document itself
218
+ * stays AUTHORIZED: a return never cancels it.
219
+ *
220
+ * Idempotent: a document already cancelled, or already answered with a live
221
+ * return, is answered as it stands, with no call to the issuer. A return the
222
+ * sale source does not quote is refused before a number is drawn.
223
+ */
224
+ async function cancelOrReturn(deps: Deps, input: CancelOrReturnInput): Promise<CancelOrReturnResult> {
225
+ assertReason(input.reason, "reason");
226
+ const document = await requireDocument(deps, input.ownerId, input.documentId);
227
+ if (document.status === "CANCELLED") return { outcome: "CANCELLED", document, returnDocument: null, failure: null };
228
+ const existing = document.accessKey === null ? null : await liveReturnOf(deps, document);
229
+ if (existing !== null) return { outcome: "RETURNED", document, returnDocument: existing, failure: null };
230
+ const cancelled = await cancel(deps, input);
231
+ if (cancelled.failure === null) return { outcome: "CANCELLED", document: cancelled.document, returnDocument: null, failure: null };
232
+ const late = cancelled.failure.class === "REJECTED" && isLateCancel(cancelled.failure.code);
233
+ if (!late) return { outcome: "REFUSED", document: cancelled.document, returnDocument: null, failure: cancelled.failure };
234
+ return { outcome: "RETURNED", document: cancelled.document, returnDocument: await issueReturn(deps, document, input.returnPointId), failure: cancelled.failure };
235
+ }
236
+
237
+ /** Whether `candidate` is a buyer's return NF-e of entry quoting `document`. */
238
+ function returnsDocument(candidate: Pick<FiscalDocument, "model" | "sale">, document: FiscalDocument): boolean {
239
+ const quotes = (candidate.sale.referencedDocuments ?? []).some((reference) => reference.accessKey === document.accessKey);
240
+ return candidate.model === "NFE" && candidate.sale.purpose === "RETURN" && quotes;
241
+ }
242
+
243
+ /**
244
+ * The return of a late-cancelled NFC-e. Refused, before any number is drawn,
245
+ * for anything but an NFC-e, for a subject that already holds a live NF-e that
246
+ * is not this return (the live index allows one per subject and model), and
247
+ * for a sale source whose return does not quote the document.
248
+ */
249
+ async function issueReturn(deps: Deps, document: FiscalDocument, returnPointId: string): Promise<FiscalDocument> {
250
+ if (document.model !== "NFCE") {
251
+ throw new FiscalDocumentError("RETURN_OF_NFCE_ONLY", `document ${document.id} is an ${document.model}: only an NFC-e is answered with a buyer's return.`);
252
+ }
253
+ const live = (await deps.config.store.listBySubject(document.ownerId, document.subjectId, "NFE")).filter(isLive);
254
+ if (live.length > 0) {
255
+ throw new FiscalDocumentError("SUBJECT_HAS_DOCUMENT", `subject ${document.subjectId} already holds a live NF-e that is not document ${document.id}'s return.`);
256
+ }
257
+ const draft = await deps.config.sales.saleFor({ ownerId: document.ownerId, subjectId: document.subjectId, model: "NFE" });
258
+ if (!returnsDocument({ model: "NFE", sale: draft as FiscalDocument["sale"] }, document)) {
259
+ throw new FiscalDocumentError("INVALID_INPUT", `the return the sale source answered for subject ${document.subjectId} does not quote document ${document.id}.`);
260
+ }
261
+ const returned = await issue(deps, { ownerId: document.ownerId, subjectId: document.subjectId, issuingPointId: returnPointId, model: "NFE" });
262
+ if (returned.id === document.id || !returnsDocument(returned, document)) {
263
+ throw new FiscalDocumentError("CONFLICT", `subject ${document.subjectId}'s live NF-e is not document ${document.id}'s return.`);
264
+ }
265
+ return returned;
266
+ }
267
+
176
268
  /** Whether a lookup's answer moves this document (a settled number moves only while it is owed one). */
177
269
  function lookupMoves(document: FiscalDocument): boolean {
178
270
  if (!canTransition(document.status, "LOOKUP")) return false;
@@ -269,6 +361,11 @@ export function createFiscalDocuments(config: FiscalDocumentsServiceConfig) {
269
361
  resendContingency: resendContingency.bind(null, deps),
270
362
  /** Cancel an authorised document. A refusal (late, say) answers the issuer's failure and changes nothing. */
271
363
  cancel: cancel.bind(null, deps),
364
+ /**
365
+ * Cancel an authorised document, or — when SEFAZ says the cancel is too late
366
+ * (501) — issue the buyer's return NF-e of entry quoting it. Idempotent.
367
+ */
368
+ cancelOrReturn: cancelOrReturn.bind(null, deps),
272
369
  /** Ask SEFAZ what it knows of the key; a state the answer moves is recorded. */
273
370
  lookup: lookup.bind(null, deps),
274
371
  /** A person takes a document back from `attention`; the sweep tries it again. */
package/src/http.ts CHANGED
@@ -72,6 +72,9 @@ export const FISCAL_ERROR_STATUS = {
72
72
  SUBJECT_HAS_DOCUMENT: 409,
73
73
  NOT_PRINTABLE: 409,
74
74
  RESEND_CHANGES_PRINTED_FIELDS: 422,
75
+ RETURN_NEEDS_REFERENCE: 422,
76
+ RETURN_ON_NFCE: 422,
77
+ RETURN_OF_NFCE_ONLY: 422,
75
78
  } as const satisfies Record<FiscalDocumentErrorCode, number>;
76
79
 
77
80
  /**
package/src/sale/types.ts CHANGED
@@ -5,7 +5,10 @@
5
5
  * Money is integer CENTS, rates integer BASIS POINTS (1 bp = 0.01%) — the
6
6
  * engine's conventions (`@12-apps/fiscal/engine`) — and quantities carry at
7
7
  * most four decimals. Every field is required; an absent value is `null`,
8
- * never a missing key, so a host cannot forget one silently.
8
+ * never a missing key, so a host cannot forget one silently. The two
9
+ * exceptions came with the return document (FUT-2238), `operation` and
10
+ * `referencedDocuments`: they are optional so that a document built before
11
+ * them stays valid and yields the same XML, byte for byte.
9
12
  *
10
13
  * The JSON schema the service validates against is
11
14
  * `@12-apps/fiscal/sidecar/schema/sale-for-document.schema.json`; a test keeps
@@ -216,6 +219,16 @@ export interface SalePayment {
216
219
 
217
220
  /** `finNFe` 1–4. */
218
221
  export type DocumentPurpose = "NORMAL" | "COMPLEMENTARY" | "ADJUSTMENT" | "RETURN";
222
+ /**
223
+ * `tpNF`: `OUT` (1) a sale or any outgoing document; `IN` (0) an entry, such as
224
+ * a buyer's goods coming back. An NFC-e is always `OUT`.
225
+ */
226
+ export type DocumentOperation = "OUT" | "IN";
227
+ /** `NFref/refNFe`: an earlier NF-e or NFC-e this document refers to. */
228
+ export interface ReferencedDocument {
229
+ /** The 44-character access key (`isValidAccessKey` in `@12-apps/fiscal/documents`). */
230
+ readonly accessKey: string;
231
+ }
219
232
  /** `idDest` 1–3. */
220
233
  export type OperationDestination = "INTERNAL" | "INTERSTATE" | "FOREIGN";
221
234
  /** `indPres` 1, 2, 3, 4, 5, 9. */
@@ -267,6 +280,19 @@ export interface SaleForDocument {
267
280
  /** `natOp`. */
268
281
  readonly operationNature: string;
269
282
  readonly purpose: DocumentPurpose;
283
+ /**
284
+ * `tpNF`. Absent is `OUT`. A buyer's return is an NF-e (model 55) with
285
+ * `purpose: "RETURN"` and `operation: "IN"`; an NFC-e has neither.
286
+ */
287
+ readonly operation?: DocumentOperation;
288
+ /**
289
+ * `NFref`, at most 500, in order. Absent is none. A `RETURN` quotes the
290
+ * document it returns here, or it is refused (`RETURN_NEEDS_REFERENCE`); an
291
+ * NFC-e quotes none (SEFAZ 708). For a buyer's return the host sets CFOP
292
+ * 1202 (within the state) or 2202 (between states) on every line, and a
293
+ * single `NO_PAYMENT` payment; the package checks neither.
294
+ */
295
+ readonly referencedDocuments?: readonly ReferencedDocument[];
270
296
  readonly destination: OperationDestination;
271
297
  readonly presence: BuyerPresence;
272
298
  /** `indFinal`. */
@@ -216,7 +216,9 @@ export interface SidecarErrorBody {
216
216
  * The SEFAZ `cStat` when SEFAZ answered (always for `REJECTED`); for
217
217
  * `INVALID`, a named code where one applies (`NT_2026_008_NOT_SUPPORTED`:
218
218
  * a document issued on or after 2027-01-01, which needs NT 2026.008's
219
- * `vProdLiq`); `null` otherwise.
219
+ * `vProdLiq`; `RETURN_ON_NFCE`: a return asked of an NFC-e, which has no
220
+ * return purpose; `RETURN_NEEDS_REFERENCE`: a return quoting no
221
+ * `referencedDocuments`); `null` otherwise.
220
222
  */
221
223
  readonly code: string | null;
222
224
  readonly message: string;
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/documents/machine-steps.ts","../src/documents/machine.ts","../src/documents/helpers.ts","../src/documents/context.ts"],"sourcesContent":["/**\n * What each input does to a document's fields — the state machine's body\n * (`./machine` holds its table and its one entry point). Pure functions; a\n * refusal throws `TRANSITION_REFUSED`.\n */\n\nimport type {\n CancelledDocument,\n ContingencyEntry,\n ContingencySignedDocument,\n InutilizedRange,\n IssuedDocument,\n LookedUpDocument,\n SidecarErrorBody,\n} from \"../sidecar/types\";\nimport type { SaleForDocument } from \"../sale/types\";\nimport { FiscalDocumentError } from \"./errors\";\nimport { type DocumentEventKind, type DocumentTotals, type FiscalDocument, type NumberVoid, isLive } from \"./types\";\n\nexport type SidecarError = SidecarErrorBody[\"error\"];\n\n/** Failures in a row after which a document waits for a person. */\nexport const MAX_FAILURES = 8;\n\n/** What the machine is fed. Each carries the service's answer, which the event keeps. */\nexport type DocumentInput =\n | { readonly kind: \"SUBMIT\" }\n | { readonly kind: \"AUTHORIZE\"; readonly answer: IssuedDocument; readonly xmlKey: string }\n | { readonly kind: \"DENY\"; readonly answer: IssuedDocument; readonly xmlKey: string }\n | { readonly kind: \"REJECT\"; readonly error: SidecarError }\n /** `xmlKey`: where the signed XML the failed call returned was stored, when it returned one. */\n | { readonly kind: \"RETRY\"; readonly error: SidecarError; readonly xmlKey?: string }\n | {\n readonly kind: \"SIGN_OFFLINE\";\n readonly answer: ContingencySignedDocument;\n readonly contingency: ContingencyEntry;\n readonly xmlKey: string;\n }\n | { readonly kind: \"REPLACE\"; readonly replacedById: string }\n | { readonly kind: \"CANCEL\"; readonly answer: CancelledDocument; readonly reason: string; readonly eventXmlKey: string | null }\n /**\n * `xmlKey`: the `nfeProc` assembled from the stored signed XML and the\n * lookup's protocol. Without it a lookup never makes a SUBMITTED document\n * final: an authorised document always has its XML.\n */\n | { readonly kind: \"LOOKUP\"; readonly answer: LookedUpDocument; readonly xmlKey?: string }\n | { readonly kind: \"INUTILIZE\"; readonly answer: InutilizedRange; readonly eventXmlKey: string | null }\n /**\n * A step that made no progress (a settlement refused or unanswered, a step\n * that threw). It counts a failure; `attention` hands the document to a\n * person at once (SEFAZ refused it: retrying would only repeat the refusal).\n */\n | { readonly kind: \"DEFER\"; readonly reason: string; readonly error: SidecarError | null; readonly attention: boolean }\n /** A rejected contingency NFC-e, corrected by the store and signed again under the same number. */\n | {\n readonly kind: \"RESIGN\";\n readonly answer: ContingencySignedDocument;\n readonly sale: SaleForDocument;\n readonly totals: DocumentTotals;\n readonly buyerTaxId: string | null;\n readonly xmlKey: string;\n }\n /** A person took a document back from `attention`: the sweep may try again. */\n | { readonly kind: \"RELEASE\" }\n /** The 24-hour contingency deadline warning went out. */\n | { readonly kind: \"WARN\" };\n\ntype InputOf<K extends DocumentEventKind> = Extract<DocumentInput, { kind: K }>;\ntype Step = { readonly [K in DocumentEventKind]: (document: FiscalDocument, input: InputOf<K>) => Partial<FiscalDocument> };\n\nexport function refuse(document: FiscalDocument, kind: DocumentEventKind, why: string): never {\n throw new FiscalDocumentError(\n \"TRANSITION_REFUSED\",\n `${kind} is refused on document ${document.id} in ${document.status}: ${why}.`,\n );\n}\n\n/** Progress: the failure count, the person's flag and the unknown outcome are settled. */\nconst SETTLED = { failures: 0, attention: false } as const;\n\nfunction issuedFields(answer: IssuedDocument, xmlKey: string): Partial<FiscalDocument> {\n return {\n ...SETTLED,\n accessKey: answer.accessKey,\n protocol: answer.protocol,\n authorizedAt: answer.authorizedAt,\n statusCode: answer.statusCode,\n statusReason: answer.statusReason,\n lastErrorClass: null,\n outcomeUnknown: false,\n xmlKey,\n };\n}\n\n/**\n * A failed call. `outcomeUnknown` is STICKY: once a request may have reached\n * SEFAZ unanswered, only a definitive answer or a lookup clears it — a later\n * \"nothing was sent this time\" says nothing about the first send.\n */\nfunction failedFields(document: FiscalDocument, error: SidecarError): Partial<FiscalDocument> {\n return {\n accessKey: document.accessKey ?? error.accessKey,\n statusCode: error.code,\n statusReason: error.message,\n lastErrorClass: error.class,\n outcomeUnknown: document.outcomeUnknown || error.outcomeUnknown,\n };\n}\n\nfunction failure(document: FiscalDocument, attention: boolean): Partial<FiscalDocument> {\n const failures = document.failures + 1;\n return { failures, attention: attention || failures >= MAX_FAILURES };\n}\n\n/** What a lookup says is owed on a number SEFAZ may hold. */\nfunction voidAfterLookup(answer: LookedUpDocument): NumberVoid {\n if (answer.status === \"AUTHORIZED\") return \"CANCEL\";\n if (answer.status === \"CANCELLED\") return \"CANCELLED\";\n if (answer.status === \"DENIED\") return \"DENIED\";\n return \"INUTILIZE\";\n}\n\nfunction lookupOfSettledNumber(document: FiscalDocument, answer: LookedUpDocument): Partial<FiscalDocument> {\n if (document.numberVoid !== \"LOOKUP_FIRST\") refuse(document, \"LOOKUP\", \"its number is already settled\");\n if (isLive(document) && (answer.status === \"AUTHORIZED\" || answer.status === \"DENIED\")) {\n // The sale's own document, still SEFAZ's: never cancelled, never voided,\n // never left REJECTED. It goes back to SUBMITTED, owing work, with the\n // protocol kept — the next step settles it with its XML (the service does\n // at once when it holds the XML the protocol certifies; otherwise the\n // sweep sends the same call again, which the fiscal service settles).\n // Its failures keep counting, so a loop of refusals reaches a person.\n return {\n status: \"SUBMITTED\",\n numberVoid: null,\n outcomeUnknown: false,\n protocol: answer.protocol ?? document.protocol,\n statusCode: answer.statusCode,\n statusReason: answer.statusReason,\n };\n }\n return {\n ...SETTLED,\n numberVoid: voidAfterLookup(answer),\n outcomeUnknown: false,\n // The protocol SEFAZ answered is what a cancel of this number must quote.\n protocol: answer.protocol ?? document.protocol,\n statusCode: answer.statusCode,\n statusReason: answer.statusReason,\n };\n}\n\n/**\n * A lookup of a SUBMITTED document. It settles it as AUTHORIZED or DENIED\n * only with the XML in hand (`xmlKey`); otherwise it keeps what SEFAZ said —\n * the protocol marks the number as SEFAZ's — and the document stays\n * SUBMITTED, for the sweep to fetch the XML by sending the same call again.\n */\nfunction lookupOfSubmitted(document: FiscalDocument, answer: LookedUpDocument, xmlKey: string | undefined): Partial<FiscalDocument> {\n const known = { statusCode: answer.statusCode, statusReason: answer.statusReason, outcomeUnknown: false };\n // A key found cancelled elsewhere is left to the next issue call, which the service settles: CANCELLED is entered only from AUTHORIZED.\n const settles = answer.status === \"AUTHORIZED\" || answer.status === \"DENIED\";\n if (!settles || answer.protocol === null || document.accessKey === null) return known;\n if (xmlKey === undefined) return { ...known, protocol: answer.protocol };\n return { ...known, ...SETTLED, status: answer.status, protocol: answer.protocol, lastErrorClass: null, xmlKey };\n}\n\nfunction lookupFields(document: FiscalDocument, answer: LookedUpDocument, xmlKey?: string): Partial<FiscalDocument> {\n if (document.status === \"REPLACED\" || document.status === \"REJECTED\") return lookupOfSettledNumber(document, answer);\n if (document.status === \"SUBMITTED\") return lookupOfSubmitted(document, answer, xmlKey);\n if (answer.status === \"CANCELLED\") return { status: \"CANCELLED\", statusCode: answer.statusCode, statusReason: answer.statusReason };\n return { statusCode: answer.statusCode, statusReason: answer.statusReason };\n}\n\nfunction cancelFields(document: FiscalDocument, input: InputOf<\"CANCEL\">): Partial<FiscalDocument> {\n const recorded = {\n ...SETTLED,\n cancelledAt: input.answer.registeredAt,\n cancelReason: input.reason,\n cancelProtocol: input.answer.protocol,\n eventXmlKey: input.eventXmlKey,\n };\n if (document.status === \"AUTHORIZED\") {\n return { ...recorded, status: \"CANCELLED\", statusCode: input.answer.statusCode, statusReason: input.answer.statusReason };\n }\n if (document.numberVoid !== \"CANCEL\") refuse(document, \"CANCEL\", \"a voided number is cancelled only when found authorised\");\n return { ...recorded, numberVoid: \"CANCELLED\" };\n}\n\n/** A rejected online number may have been authorised by an unanswered first send: look it up first. */\n/**\n * A rejected online number may have been authorised by an unanswered first\n * send — or a lookup already found it authorised (its protocol is kept, and\n * a re-send for the XML met a 704 or a different XML under the key): either\n * way it is looked up, never voided blindly.\n */\nfunction rejectFields(document: FiscalDocument, error: SidecarError): Partial<FiscalDocument> {\n const failed = failedFields(document, error);\n if (document.seriesKind === \"CONTINGENCY\") return { status: \"REJECTED\", ...failed, ...SETTLED, numberVoid: null };\n // Known to be SEFAZ's: a refused re-send is one more failure of the same document, not a settlement.\n if (document.protocol !== null) return { status: \"REJECTED\", ...failed, ...failure(document, false), numberVoid: \"LOOKUP_FIRST\" };\n return { status: \"REJECTED\", ...failed, ...SETTLED, numberVoid: failed.outcomeUnknown === true ? \"LOOKUP_FIRST\" : \"INUTILIZE\" };\n}\n\nexport const STEPS: Step = {\n SUBMIT: () => ({ status: \"SUBMITTED\" }),\n AUTHORIZE: (_document, input) => ({ status: \"AUTHORIZED\", ...issuedFields(input.answer, input.xmlKey) }),\n DENY: (_document, input) => ({ status: \"DENIED\", ...issuedFields(input.answer, input.xmlKey) }),\n REJECT: (document, input) => rejectFields(document, input.error),\n RETRY: (document, input) => ({\n ...failedFields(document, input.error),\n ...failure(document, false),\n ...(input.xmlKey === undefined ? {} : { xmlKey: input.xmlKey }),\n }),\n SIGN_OFFLINE: (document, input) => {\n if (document.seriesKind !== \"CONTINGENCY\") refuse(document, input.kind, \"only a contingency-series number is signed offline\");\n return { ...SETTLED, status: \"CONTINGENCY\", accessKey: input.answer.accessKey, contingency: input.contingency, xmlKey: input.xmlKey };\n },\n REPLACE: (document, input) => ({\n ...SETTLED,\n status: \"REPLACED\",\n replacedById: input.replacedById,\n // A SUBMITTED document may have reached SEFAZ whatever was recorded (a process\n // that died mid-call, a receipt with no protocol yet): its key is always\n // known, so it is looked up before its number is voided. Only a PENDING one\n // was never sent.\n numberVoid: document.status === \"SUBMITTED\" ? \"LOOKUP_FIRST\" : \"INUTILIZE\",\n }),\n CANCEL: cancelFields,\n LOOKUP: (document, input) => lookupFields(document, input.answer, input.xmlKey),\n INUTILIZE: (document, input) => {\n if (document.numberVoid !== \"INUTILIZE\") refuse(document, input.kind, \"its number is not owed an inutilization\");\n return { ...SETTLED, numberVoid: \"INUTILIZED\", eventXmlKey: input.eventXmlKey };\n },\n DEFER: (document, input) => ({\n ...failure(document, input.attention),\n ...(input.error === null ? {} : { lastErrorClass: input.error.class, statusCode: input.error.code }),\n statusReason: input.error?.message ?? input.reason,\n }),\n RESIGN: (document, input) => {\n if (document.seriesKind !== \"CONTINGENCY\") refuse(document, input.kind, \"only a rejected contingency NFC-e is resent\");\n return {\n ...SETTLED,\n status: \"CONTINGENCY\",\n sale: input.sale,\n totals: input.totals,\n buyerTaxId: input.buyerTaxId,\n accessKey: input.answer.accessKey,\n xmlKey: input.xmlKey,\n statusCode: null,\n statusReason: null,\n lastErrorClass: null,\n };\n },\n RELEASE: (document) => {\n if (!document.attention) refuse(document, \"RELEASE\", \"it is not waiting for a person\");\n return SETTLED;\n },\n // `deadlineWarnedAt` is the transition's own time, set by `transition`.\n WARN: () => ({}),\n};\n","/**\n * The fiscal document state machine: pure functions from a document and one\n * input to the next document and the event that records the step.\n *\n * ```\n * PENDING ──SUBMIT──▶ SUBMITTED ──AUTHORIZE──▶ AUTHORIZED ──CANCEL──▶ CANCELLED\n * │ │ ├──DENY─────▶ DENIED\n * │ │ ├──REJECT───▶ REJECTED\n * │ │ └──RETRY────▶ SUBMITTED\n * │ └──REPLACE──▶ REPLACED\n * ├──REPLACE──▶ REPLACED\n * └──SIGN_OFFLINE──▶ CONTINGENCY ──AUTHORIZE | DENY | REJECT | RETRY──▶ …\n * ▲ REJECTED (contingency) ──RESIGN──┘\n * ```\n *\n * A document is one number, so going offline is a SECOND document on the\n * issuing point's contingency series (`PENDING → CONTINGENCY`), and the first\n * one is `REPLACED`. Every input yields an event; a refused one throws\n * {@link FiscalDocumentError} `TRANSITION_REFUSED` and changes nothing:\n * `CANCELLED` is entered only from `AUTHORIZED`, and `AUTHORIZED` never from a\n * final state. A rejected contingency NFC-e is the one way back: the store\n * corrects it and it is signed again under the same number (`RESIGN`).\n *\n * `DEFER`, `RELEASE` and `WARN` record what the sweep and a person did without\n * changing the state: a failed step counts toward {@link MAX_FAILURES}, after\n * which the document waits for a person (`attention`).\n */\n\nimport { type DocumentInput, STEPS, refuse } from \"./machine-steps\";\nimport type { DocumentEventKind, FiscalDocument, FiscalDocumentEvent, FiscalDocumentStatus } from \"./types\";\n\nexport { MAX_FAILURES } from \"./machine-steps\";\nexport type { DocumentInput } from \"./machine-steps\";\n\nconst ANY: readonly FiscalDocumentStatus[] = [\n \"PENDING\", \"SUBMITTED\", \"AUTHORIZED\", \"REJECTED\", \"DENIED\", \"CONTINGENCY\", \"CANCELLED\", \"REPLACED\",\n];\n\n/** From which states each input is accepted. */\nexport const DOCUMENT_TRANSITIONS: Readonly<Record<DocumentEventKind, readonly FiscalDocumentStatus[]>> = {\n SUBMIT: [\"PENDING\"],\n AUTHORIZE: [\"SUBMITTED\", \"CONTINGENCY\"],\n DENY: [\"SUBMITTED\", \"CONTINGENCY\"],\n REJECT: [\"SUBMITTED\", \"CONTINGENCY\"],\n RETRY: [\"SUBMITTED\", \"CONTINGENCY\"],\n SIGN_OFFLINE: [\"PENDING\"],\n REPLACE: [\"PENDING\", \"SUBMITTED\"],\n CANCEL: [\"AUTHORIZED\", \"REPLACED\", \"REJECTED\"],\n LOOKUP: [\"SUBMITTED\", \"AUTHORIZED\", \"REPLACED\", \"REJECTED\"],\n INUTILIZE: [\"REJECTED\", \"REPLACED\"],\n DEFER: ANY,\n RESIGN: [\"REJECTED\"],\n RELEASE: ANY,\n WARN: [\"CONTINGENCY\"],\n};\n\n/** The states nothing but a lookup, a cancel or an inutilization of the number may follow. */\nexport const FINAL_STATUSES: readonly FiscalDocumentStatus[] = [\"REJECTED\", \"DENIED\", \"CANCELLED\", \"REPLACED\"];\n\nexport interface Transition {\n readonly document: FiscalDocument;\n readonly event: FiscalDocumentEvent;\n}\n\nconst SECRET_KEY = /^(pfx|pfxBase64|password|passphrase|certificate|csc|token|privateKey)$/i;\n\n/**\n * A copy of an answer with every secret-named key dropped. The service never\n * echoes one; this is the second lock, so an event row can never hold one.\n */\nexport function scrubSecrets(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(scrubSecrets);\n if (value === null || typeof value !== \"object\") return value;\n const out: Record<string, unknown> = {};\n for (const [key, inner] of Object.entries(value)) {\n if (!SECRET_KEY.test(key)) out[key] = scrubSecrets(inner);\n }\n return out;\n}\n\nfunction answerOf(input: DocumentInput): unknown {\n if (\"answer\" in input) return input.answer;\n if (\"error\" in input && input.error !== null) return { error: input.error };\n if (input.kind === \"DEFER\") return { reason: input.reason };\n return null;\n}\n\nfunction eventOf(document: FiscalDocument, input: DocumentInput, toStatus: FiscalDocumentStatus, at: string): FiscalDocumentEvent {\n const error = \"error\" in input ? input.error : null;\n const answer = \"answer\" in input ? input.answer : null;\n return {\n documentId: document.id,\n kind: input.kind,\n fromStatus: document.status,\n toStatus,\n at,\n errorClass: error?.class ?? null,\n code: error?.code ?? (answer !== null && \"statusCode\" in answer ? answer.statusCode : null),\n answer: scrubSecrets(answerOf(input)),\n };\n}\n\nconst COUNTED = new Set<DocumentEventKind>([\"SUBMIT\", \"RETRY\", \"SIGN_OFFLINE\", \"RESIGN\"]);\n\n/**\n * Apply one input. Throws `TRANSITION_REFUSED` (and changes nothing) when the\n * document's state does not accept it. `at` is the caller's clock, ISO 8601.\n */\nexport function transition(document: FiscalDocument, input: DocumentInput, at: string): Transition {\n if (!DOCUMENT_TRANSITIONS[input.kind].includes(document.status)) {\n refuse(document, input.kind, `accepted only from ${DOCUMENT_TRANSITIONS[input.kind].join(\", \")}`);\n }\n const step = STEPS[input.kind] as (document: FiscalDocument, input: DocumentInput) => Partial<FiscalDocument>;\n const updated: FiscalDocument = {\n ...document,\n ...step(document, input),\n ...(input.kind === \"WARN\" ? { deadlineWarnedAt: at } : {}),\n attempts: document.attempts + (COUNTED.has(input.kind) ? 1 : 0),\n updatedAt: at,\n };\n return { document: updated, event: eventOf(document, input, updated.status, at) };\n}\n\n/** Whether an input would be accepted, without applying it. */\nexport function canTransition(status: FiscalDocumentStatus, kind: DocumentEventKind): boolean {\n return DOCUMENT_TRANSITIONS[kind].includes(status);\n}\n\n","/**\n * The pure helpers the document service builds a document with: the local\n * clock, the key code, the access key, the issuer block, the totals, the\n * storage keys. No port, no state.\n */\n\nimport type { DocumentIssuer, SaleForDocument, Uf } from \"../sale/types\";\nimport { FiscalDocumentError } from \"./errors\";\nimport type { SaleDraft } from \"./ports\";\nimport type { EmitterProfile } from \"./profile\";\nimport type { DocumentTotals, FiscalDocument, FiscalDocumentModel, SeriesKind } from \"./types\";\n\n/** `2026-11-20T12:30:00-03:00`: the instant as the owner's wall clock. */\nexport function localIso(at: Date, offset: string): string {\n const match = /^([+-])(\\d{2}):(\\d{2})$/.exec(offset);\n if (match === null) throw new FiscalDocumentError(\"INVALID_INPUT\", `utcOffset answered \"${offset}\", not ±HH:MM.`);\n const minutes = (match[1] === \"-\" ? -1 : 1) * (Number(match[2]) * 60 + Number(match[3]));\n return `${new Date(at.getTime() + minutes * 60_000).toISOString().slice(0, 19)}${offset}`;\n}\n\nconst UNBIASED_LIMIT = Math.floor(2 ** 32 / 100_000_000) * 100_000_000;\n\n/** `cNF`: eight random digits, never equal to the number's own eight (the layout's rule). */\nexport function drawKeyCode(number: number): string {\n const own = String(number % 100_000_000).padStart(8, \"0\");\n for (;;) {\n const [value] = globalThis.crypto.getRandomValues(new Uint32Array(1));\n // Rejection sampling: values at or above the last whole multiple of 10^8 would bias the low codes.\n if (value === undefined || value >= UNBIASED_LIMIT) continue;\n const code = String(value % 100_000_000).padStart(8, \"0\");\n if (code !== own) return code;\n }\n}\n\nconst FILLED_BY_THE_PACKAGE = new Set([\"series\", \"number\", \"keyCode\", \"issuer\", \"issuedAt\"]);\n\n/** A stored sale back to the draft it was built from (for a second document of the same sale). */\nexport function draftOf(sale: SaleForDocument): SaleDraft {\n return Object.fromEntries(Object.entries(sale).filter(([key]) => !FILLED_BY_THE_PACKAGE.has(key))) as unknown as SaleDraft;\n}\n\nexport function issuerOf(profile: EmitterProfile): DocumentIssuer {\n return {\n cnpj: profile.cnpj,\n stateRegistration: profile.stateRegistration,\n legalName: profile.legalName,\n tradeName: profile.tradeName,\n taxRegime: profile.taxRegime,\n address: profile.address,\n };\n}\n\nexport function totalsOf(sale: SaleDraft): DocumentTotals {\n const sum = (pick: (line: SaleDraft[\"lines\"][number]) => number) => sale.lines.reduce((total, line) => total + pick(line), 0);\n const discountCents = sum((line) => line.discountCents);\n return {\n totalCents: sum((line) => line.valueCents) - discountCents,\n discountCents,\n cbsCents: sum((line) => line.ibsCbs?.figures?.cbsCents ?? 0),\n ibsUfCents: sum((line) => line.ibsCbs?.figures?.ibsUfCents ?? 0),\n ibsMunCents: sum((line) => line.ibsCbs?.figures?.ibsMunCents ?? 0),\n };\n}\n\n/** `text` without any trailing run of `char`, in linear time (no regex backtracking). */\nexport function trimEnd(text: string, char: string): string {\n let end = text.length;\n while (end > 0 && text[end - 1] === char) end -= 1;\n return text.slice(0, end);\n}\n\n/** Storage keys, by access key: one folder per document, whatever its owner. */\nexport const xmlKeys = {\n signed: (accessKey: string) => `fiscal/${accessKey}/signed.xml`,\n /** One signed XML per digest: every XML a failed call returned under a key is kept, none overwritten. */\n signedByDigest: (accessKey: string, digest: string) =>\n `fiscal/${accessKey}/signed-${trimEnd(digest.replace(/\\+/g, \"-\").replace(/\\//g, \"_\"), \"=\")}.xml`,\n authorized: (accessKey: string) => `fiscal/${accessKey}/authorized.xml`,\n cancel: (accessKey: string) => `fiscal/${accessKey}/cancel.xml`,\n inutilization: (document: FiscalDocument) =>\n `fiscal/inutilization/${document.environment}/${document.model}/${document.ownerId}/${document.series}-${document.number}.xml`,\n};\n\n/** The IBGE code of each federative unit: the access key's first two digits. */\nconst UF_CODES: Readonly<Record<Uf, string>> = {\n RO: \"11\", AC: \"12\", AM: \"13\", RR: \"14\", PA: \"15\", AP: \"16\", TO: \"17\", MA: \"21\", PI: \"22\", CE: \"23\", RN: \"24\", PB: \"25\",\n PE: \"26\", AL: \"27\", SE: \"28\", BA: \"29\", MG: \"31\", ES: \"32\", RJ: \"33\", SP: \"35\", PR: \"41\", SC: \"42\", RS: \"43\", MS: \"50\",\n MT: \"51\", GO: \"52\", DF: \"53\",\n};\n\n/** The access key's modulo-11 check digit (weights 2–9 from the right). */\nfunction keyCheckDigit(body: string): number {\n let sum = 0;\n let weight = 2;\n for (let i = body.length - 1; i >= 0; i -= 1) {\n sum += (body.charCodeAt(i) - 48) * weight;\n weight = weight === 9 ? 2 : weight + 1;\n }\n const rest = sum % 11;\n return rest < 2 ? 0 : 11 - rest;\n}\n\n/**\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 { computeAccessKey, draftOf, drawKeyCode, 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 +0,0 @@
1
- {"version":3,"sources":["../src/http.ts"],"sourcesContent":["/**\n * `createApiFiscal` — the fiscal HTTP surface as framework-neutral route\n * descriptors (the wiring contract's `http` capability, restated here\n * structurally: this package imports nothing from the contract at runtime,\n * and its manifest suite pins the twins).\n *\n * The package owns the paths, the bodies it reads (`./documents/profile-input`,\n * unknown keys refused), the `{ data }` envelope, the permission each route\n * needs and the status a refusal earns ({@link FISCAL_ERROR_STATUS}). The host\n * owns resolving WHO is calling into the opaque `ownerId` of its tenant, the\n * guards that check the declared permission, and every word a person reads:\n * an error answers a `code` for the host to word, never a sentence for a user.\n *\n * Nothing secret leaves: the profile answers `hasCertificate` / `hasCsc`, never\n * a ciphertext, and the certificate upload answers the profile view.\n */\n\nimport { type DanfeNfceLabels } from \"./danfe/labels\";\nimport { type PaperWidth, renderDanfeNfce } from \"./danfe/render\";\nimport { FiscalDocumentError, type FiscalDocumentErrorCode } from \"./documents/errors\";\nimport type { DocumentStorage } from \"./documents/ports\";\nimport { parseCertificateUpload, parseIssuingPointInput, parseProfileInput } from \"./documents/profile-input\";\nimport { viewOf } from \"./documents/profile\";\nimport type { FiscalDocuments } from \"./documents/service\";\nimport { FISCAL_DOCUMENT_MODELS, type FiscalDocumentModel } from \"./documents/types\";\nimport { FISCAL_CANCEL, FISCAL_ISSUE, FISCAL_MANAGE, FISCAL_READ } from \"./manifest/permissions\";\n\n/** The caller, as the host's adapter resolved it. */\nexport interface FiscalHttpActor {\n /** The emitter profile's owner: the host's tenant, mapped to an opaque id. */\n readonly ownerId: string;\n}\n\n/** Structural twin of the wiring contract's `WireRequest<FiscalHttpActor>`. */\nexport interface FiscalHttpRequest {\n actor: FiscalHttpActor;\n params: Record<string, string | undefined>;\n query: Record<string, string | undefined>;\n body?: unknown;\n}\n\n/** Structural twin of the wiring contract's `WireResponse`. */\nexport interface FiscalHttpResponse {\n status: number;\n body: unknown;\n}\n\n/** Structural twin of the wiring contract's `WireRoute<FiscalHttpActor>`. */\nexport interface FiscalRoute {\n method: \"GET\" | \"POST\" | \"PUT\";\n path: string;\n permission: string;\n handle(request: FiscalHttpRequest): Promise<FiscalHttpResponse>;\n}\n\nexport interface FiscalApiConfig {\n readonly documents: FiscalDocuments;\n /** Where the XMLs are, to render a DANFE from. */\n readonly storage: DocumentStorage;\n /** The DANFE's words: the host's, or `@12-apps/fiscal/danfe/pt-BR`. */\n readonly danfeLabels: DanfeNfceLabels;\n}\n\nexport const FISCAL_ERROR_STATUS = {\n INVALID_INPUT: 400,\n NOT_FOUND: 404,\n NOT_ISSUABLE: 409,\n NOT_SUPPORTED: 501,\n TRANSITION_REFUSED: 409,\n SERIES_EXHAUSTED: 409,\n CONFLICT: 409,\n SUBJECT_HAS_DOCUMENT: 409,\n NOT_PRINTABLE: 409,\n RESEND_CHANGES_PRINTED_FIELDS: 422,\n} 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":[]}