@beliq/sdk 0.4.5 → 0.4.6

package/CHANGELOG.md

@@ -4,6 +4,23 @@
 resolves 0.4.x and never reaches 0.5.0. Additive spec syncs ship as patches for
 that reason, and a minor is reserved for a change that needs consumers to opt in.
 
+## 0.4.6 - 2026-10-06
+
+- The vendored `openapi.json` carries the four fields `POST /v1/parse` answers
+  with and the previous copy did not. `warnings` is always present, and empty
+  when the parser read every element that holds something: `PARSE_NOT_RETURNED`
+  lists what the document carries beyond the parsed `invoice`, by path and
+  count, and `PARSE_VALUE_NOT_FOUND` names a field no value could be read for.
+  `profileUrn` (BT-24) and `businessProcessId` (BT-23) carry what the document
+  states, and the latter is not the `businessProcessId` a `generate()` invoice
+  takes, which is an input limited to the three French Flux 2 codes.
+  `franceCtcDetected` is true when BT-23 is one of the French cadre de
+  facturation codes or BT-24 is the EXTENDED-CTC-FR URN, and absent otherwise.
+- `ParseResult` picks all four up from the regenerated schema, and
+  `ParseWarning` and `ParseWarningCode` are exported beside it, the way
+  `ValidationIssue` is exported beside `ValidationResult`, so a caller can
+  annotate a warning without indexing into the result type.
+
 ## 0.4.5 - 2026-10-03
 
 - `LIVE_GENERATE_STANDARDS` carries all eight standards `POST /v1/generate`

package/dist/index.d.cts

@@ -1087,6 +1087,9 @@ interface operations {
                         data?: {
                             format: "cii" | "ubl";
                             profileDetected?: string;
+                            profileUrn?: string;
+                            businessProcessId?: string;
+                            franceCtcDetected?: boolean;
                             invoice: {
                                 number: string;
                                 issueDate: string;
@@ -1356,6 +1359,16 @@ interface operations {
                                     gv?: "1" | "2";
                                 };
                             };
+                            warnings: {
+                                code: "PARSE_NOT_RETURNED" | "PARSE_VALUE_NOT_FOUND";
+                                message: string;
+                                field?: string;
+                                terms?: string[];
+                                elements?: {
+                                    path: string;
+                                    count: number;
+                                }[];
+                            }[];
                         };
                         error?: {
                             code: "VALIDATION_ERROR" | "INVALID_INVOICE" | "PROFILE_STANDARD_MISMATCH" | "DOCUMENT_TYPE_STANDARD_MISMATCH" | "PARSE_FAILED" | "AUTHENTICATION_REQUIRED" | "INVALID_API_KEY" | "INSUFFICIENT_ROLE" | "QUOTA_EXCEEDED" | "RATE_LIMITED" | "ACCOUNT_THROTTLED" | "ENGINE_UNAVAILABLE" | "INTERNAL_ERROR" | "NOT_FOUND" | "CONVERSION_UNSUPPORTED_PAIR" | "CONVERSION_LOSSY_FAILCLOSED" | "CONVERSION_TOOL_UNAVAILABLE" | "CONVERSION_TOOL_ERROR" | "PDF_TEMPLATE_AUTH_REQUIRED" | "PDF_TEMPLATE_NOT_FOUND" | "PDF_TEMPLATE_INVALID" | "TRANSMISSION_DISABLED" | "TRANSMISSION_NO_PROVIDER" | "IDEMPOTENCY_KEY_REUSED" | "INVALID_IDEMPOTENCY_KEY" | "SENDER_NOT_REGISTERED" | "CONTENT_ALREADY_SENT" | "INBOX_UNKNOWN_PROVIDER" | "INBOX_VERIFICATION_FAILED" | "INBOX_SIGNATURE_EXPIRED" | "ENROLLMENT_MODE_UNSUPPORTED" | "ENROLLMENT_REFUSED" | "RECIPIENT_NOT_ROUTABLE" | "SENDER_COUNTRY_MISSING" | "DOCUMENT_PARTY_MISMATCH" | "FRENCH_DOMESTIC_FLOW" | "FRANCE_CTC_BLOCKING_FINDINGS" | "FRANCE_CTC_NOT_JUDGED" | "FRANCE_INVOICE_NUMBER_BURNED" | "UNSUPPORTED_SYNTAX" | "MALFORMED_DOCUMENT" | "EMPTY_DOCUMENT" | "MISSING_CUSTOMIZATION_ID" | "MISSING_PROCESS_ID";
@@ -1941,6 +1954,9 @@ type Severity = ValidationIssue['severity'];
 type ValidationFormat = ValidationResult['format'];
 /** Structured invoice extracted from a document (POST /v1/parse). */
 type ParseResult = Json200Data<'parseInvoice'>;
+/** One warning about what the document holds and the parsed invoice does not. */
+type ParseWarning = ParseResult['warnings'][number];
+type ParseWarningCode = ParseWarning['code'];
 /** The JSON-mode generate envelope (Accept: application/json): the seal. */
 type GenerateResponse = Json200Data<'generateInvoice'>;
 /** One row of the ruleset fingerprint (key, version, file hash). */
@@ -2104,4 +2120,4 @@ declare class BeliqApiError extends Error {
     });
 }
 
-export { type AccountInfo, type ApiError, type ApiErrorCode, Beliq, BeliqApiError, type BeliqOptions, type ConvertMeta, type ConvertOptions, type ConvertResult, type ConvertSourceFormat, type ConvertTargetFormat, DocumentInput, type DocumentOptions, type FacturxProfile, type GenerateBody, type GenerateInput, type GenerateMeta, type GenerateProfile, type GenerateResponse, type GenerateResult, type Invoice, type ParseFormat, type ParseOptions, type ParseResult, type RulesetArtifact, type Severity, type Standard, type ValidateFormat, type ValidateOptions, type ValidationFormat, type ValidationIssue, type ValidationResult };
+export { type AccountInfo, type ApiError, type ApiErrorCode, Beliq, BeliqApiError, type BeliqOptions, type ConvertMeta, type ConvertOptions, type ConvertResult, type ConvertSourceFormat, type ConvertTargetFormat, DocumentInput, type DocumentOptions, type FacturxProfile, type GenerateBody, type GenerateInput, type GenerateMeta, type GenerateProfile, type GenerateResponse, type GenerateResult, type Invoice, type ParseFormat, type ParseOptions, type ParseResult, type ParseWarning, type ParseWarningCode, type RulesetArtifact, type Severity, type Standard, type ValidateFormat, type ValidateOptions, type ValidationFormat, type ValidationIssue, type ValidationResult };

package/dist/index.d.ts

@@ -1087,6 +1087,9 @@ interface operations {
                         data?: {
                             format: "cii" | "ubl";
                             profileDetected?: string;
+                            profileUrn?: string;
+                            businessProcessId?: string;
+                            franceCtcDetected?: boolean;
                             invoice: {
                                 number: string;
                                 issueDate: string;
@@ -1356,6 +1359,16 @@ interface operations {
                                     gv?: "1" | "2";
                                 };
                             };
+                            warnings: {
+                                code: "PARSE_NOT_RETURNED" | "PARSE_VALUE_NOT_FOUND";
+                                message: string;
+                                field?: string;
+                                terms?: string[];
+                                elements?: {
+                                    path: string;
+                                    count: number;
+                                }[];
+                            }[];
                         };
                         error?: {
                             code: "VALIDATION_ERROR" | "INVALID_INVOICE" | "PROFILE_STANDARD_MISMATCH" | "DOCUMENT_TYPE_STANDARD_MISMATCH" | "PARSE_FAILED" | "AUTHENTICATION_REQUIRED" | "INVALID_API_KEY" | "INSUFFICIENT_ROLE" | "QUOTA_EXCEEDED" | "RATE_LIMITED" | "ACCOUNT_THROTTLED" | "ENGINE_UNAVAILABLE" | "INTERNAL_ERROR" | "NOT_FOUND" | "CONVERSION_UNSUPPORTED_PAIR" | "CONVERSION_LOSSY_FAILCLOSED" | "CONVERSION_TOOL_UNAVAILABLE" | "CONVERSION_TOOL_ERROR" | "PDF_TEMPLATE_AUTH_REQUIRED" | "PDF_TEMPLATE_NOT_FOUND" | "PDF_TEMPLATE_INVALID" | "TRANSMISSION_DISABLED" | "TRANSMISSION_NO_PROVIDER" | "IDEMPOTENCY_KEY_REUSED" | "INVALID_IDEMPOTENCY_KEY" | "SENDER_NOT_REGISTERED" | "CONTENT_ALREADY_SENT" | "INBOX_UNKNOWN_PROVIDER" | "INBOX_VERIFICATION_FAILED" | "INBOX_SIGNATURE_EXPIRED" | "ENROLLMENT_MODE_UNSUPPORTED" | "ENROLLMENT_REFUSED" | "RECIPIENT_NOT_ROUTABLE" | "SENDER_COUNTRY_MISSING" | "DOCUMENT_PARTY_MISMATCH" | "FRENCH_DOMESTIC_FLOW" | "FRANCE_CTC_BLOCKING_FINDINGS" | "FRANCE_CTC_NOT_JUDGED" | "FRANCE_INVOICE_NUMBER_BURNED" | "UNSUPPORTED_SYNTAX" | "MALFORMED_DOCUMENT" | "EMPTY_DOCUMENT" | "MISSING_CUSTOMIZATION_ID" | "MISSING_PROCESS_ID";
@@ -1941,6 +1954,9 @@ type Severity = ValidationIssue['severity'];
 type ValidationFormat = ValidationResult['format'];
 /** Structured invoice extracted from a document (POST /v1/parse). */
 type ParseResult = Json200Data<'parseInvoice'>;
+/** One warning about what the document holds and the parsed invoice does not. */
+type ParseWarning = ParseResult['warnings'][number];
+type ParseWarningCode = ParseWarning['code'];
 /** The JSON-mode generate envelope (Accept: application/json): the seal. */
 type GenerateResponse = Json200Data<'generateInvoice'>;
 /** One row of the ruleset fingerprint (key, version, file hash). */
@@ -2104,4 +2120,4 @@ declare class BeliqApiError extends Error {
     });
 }
 
-export { type AccountInfo, type ApiError, type ApiErrorCode, Beliq, BeliqApiError, type BeliqOptions, type ConvertMeta, type ConvertOptions, type ConvertResult, type ConvertSourceFormat, type ConvertTargetFormat, DocumentInput, type DocumentOptions, type FacturxProfile, type GenerateBody, type GenerateInput, type GenerateMeta, type GenerateProfile, type GenerateResponse, type GenerateResult, type Invoice, type ParseFormat, type ParseOptions, type ParseResult, type RulesetArtifact, type Severity, type Standard, type ValidateFormat, type ValidateOptions, type ValidationFormat, type ValidationIssue, type ValidationResult };
+export { type AccountInfo, type ApiError, type ApiErrorCode, Beliq, BeliqApiError, type BeliqOptions, type ConvertMeta, type ConvertOptions, type ConvertResult, type ConvertSourceFormat, type ConvertTargetFormat, DocumentInput, type DocumentOptions, type FacturxProfile, type GenerateBody, type GenerateInput, type GenerateMeta, type GenerateProfile, type GenerateResponse, type GenerateResult, type Invoice, type ParseFormat, type ParseOptions, type ParseResult, type ParseWarning, type ParseWarningCode, type RulesetArtifact, type Severity, type Standard, type ValidateFormat, type ValidateOptions, type ValidationFormat, type ValidationIssue, type ValidationResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beliq/sdk",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Official beliq SDK: generate, validate, parse, and convert EU-compliant e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS) against authority-pinned, drift-checked rules.",
   "keywords": [
     "beliq",
@@ -69,8 +69,8 @@
     "clean": "rm -rf dist",
     "build": "npm run clean && tsup",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src test",
-    "lint:fix": "eslint src test --fix",
+    "lint": "eslint src test scripts",
+    "lint:fix": "eslint src test scripts --fix",
     "scrub:check": "bash scripts/scrub-check.sh",
     "sync:spec": "node scripts/sync-spec.mjs",
     "gen:types": "node scripts/gen-types.mjs",