@flaks/onerecord 0.1.2 → 0.3.0

package/dist/safety/walk-graph.js

@@ -0,0 +1,100 @@
+import { mergeLimits } from './limits.js';
+/**
+ * Recursive graph walker with safety-limit enforcement.
+ *
+ * If `visitor` is provided, called once per visited value (object,
+ * array element, scalar) during the walk, BEFORE limit checks for
+ * children. Used by:
+ *  - `preValidate` (no visitor; safety-limit enforcement only).
+ *  - `src/dispatch/graph-walk.ts` (visitor collects {@id, @type,
+ *    parent-field info} for cross-node analysis).
+ *
+ * Single traversal; dispatch mode does not double-walk.
+ *
+ * Error kinds emitted (each wrapped in `metaSlice`):
+ *  - node_count_limit_exceeded
+ *  - depth_limit_exceeded
+ *  - string_too_long
+ *  - array_too_long
+ *
+ * Behavior is byte-equivalent to the inline walk that `preValidate`
+ * used through v0.1.x; this module exists to make the visitor reusable.
+ */
+export function walkGraph(input, opts = {}, visitor) {
+    const limits = mergeLimits(opts.limits);
+    const metaSlice = opts.meta ? { meta: opts.meta } : {};
+    let nodes = 0;
+    function walk(v, depth, path) {
+        nodes++;
+        if (nodes > limits.maxNodes) {
+            return {
+                ok: false,
+                error: {
+                    kind: 'node_count_limit_exceeded',
+                    count: nodes,
+                    limit: limits.maxNodes,
+                    ...metaSlice,
+                },
+            };
+        }
+        if (depth > limits.maxDepth) {
+            return {
+                ok: false,
+                error: {
+                    kind: 'depth_limit_exceeded',
+                    depth,
+                    limit: limits.maxDepth,
+                    path,
+                    ...metaSlice,
+                },
+            };
+        }
+        if (visitor)
+            visitor(v, path, depth);
+        if (typeof v === 'string') {
+            if (v.length > limits.maxStringLength) {
+                return {
+                    ok: false,
+                    error: {
+                        kind: 'string_too_long',
+                        length: v.length,
+                        limit: limits.maxStringLength,
+                        path,
+                        ...metaSlice,
+                    },
+                };
+            }
+            return { ok: true, value: true };
+        }
+        if (v === null || typeof v !== 'object')
+            return { ok: true, value: true };
+        if (Array.isArray(v)) {
+            if (v.length > limits.maxArrayLength) {
+                return {
+                    ok: false,
+                    error: {
+                        kind: 'array_too_long',
+                        length: v.length,
+                        limit: limits.maxArrayLength,
+                        path,
+                        ...metaSlice,
+                    },
+                };
+            }
+            for (let i = 0; i < v.length; i++) {
+                const r = walk(v[i], depth + 1, `${path}[${i}]`);
+                if (!r.ok)
+                    return r;
+            }
+            return { ok: true, value: true };
+        }
+        for (const k of Object.getOwnPropertyNames(v)) {
+            const r = walk(v[k], depth + 1, `${path}.${k}`);
+            if (!r.ok)
+                return r;
+        }
+        return { ok: true, value: true };
+    }
+    return walk(input, 0, '$');
+}
+//# sourceMappingURL=walk-graph.js.map

package/dist/safety/walk-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-graph.js","sourceRoot":"","sources":["../../src/safety/walk-graph.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -9,6 +9,7 @@ export type { AccessDelegationRequest, JsonLdAccessDelegationRequest, } from '..
 export type { AccountNumber, JsonLdAccountNumber } from '../classes/account-number/index.js';
 export type { Address, JsonLdAddress } from '../classes/address/index.js';
 export type { Booking, JsonLdBooking } from '../classes/booking/index.js';
+export type { CO2Emissions, JsonLdCO2Emissions } from '../classes/co2-emissions/index.js';
 export type { BookingOption, JsonLdBookingOption } from '../classes/booking-option/index.js';
 export type { BookingOptionRequest, JsonLdBookingOptionRequest, } from '../classes/booking-option-request/index.js';
 export type { BookingPreferences, JsonLdBookingPreferences, } from '../classes/booking-preferences/index.js';
@@ -18,13 +19,17 @@ export type { BookingShipment, JsonLdBookingShipment } from '../classes/booking-
 export type { BookingTimes, JsonLdBookingTimes } from '../classes/booking-times/index.js';
 export type { Change, JsonLdChange } from '../classes/change/index.js';
 export type { ChangeRequest, JsonLdChangeRequest } from '../classes/change-request/index.js';
+export type { Company, JsonLdCompany } from '../classes/company/index.js';
+export type { CustomsInformation, JsonLdCustomsInformation, } from '../classes/customs-information/index.js';
 export type { HandlingService, JsonLdHandlingService } from '../classes/handling-service/index.js';
+export type { Insurance, JsonLdInsurance } from '../classes/insurance/index.js';
+export type { JsonLdLineItemPackage, LineItemPackage } from '../classes/line-item-package/index.js';
 export type { JsonLdLocation, Location } from '../classes/location/index.js';
 export type { JsonLdLogisticsEvent, LogisticsEvent } from '../classes/logistics-event/index.js';
 export type { JsonLdMovementTime, MovementTime } from '../classes/movement-time/index.js';
 export type { JsonLdNotification, Notification } from '../classes/notification/index.js';
 export type { JsonLdOperation, Operation } from '../classes/operation/index.js';
-export type { JsonLdOrganization, Organization } from '../classes/organization/index.js';
+export type { JsonLdOtherCharge, OtherCharge } from '../classes/other-charge/index.js';
 export type { JsonLdParty, Party } from '../classes/party/index.js';
 export type { JsonLdPerson, Person } from '../classes/person/index.js';
 export type { JsonLdPiece, Piece } from '../classes/piece/index.js';
@@ -33,7 +38,11 @@ export type { JsonLdShipment, Shipment } from '../classes/shipment/index.js';
 export type { JsonLdSubscription, Subscription } from '../classes/subscription/index.js';
 export type { JsonLdSubscriptionRequest, SubscriptionRequest, } from '../classes/subscription-request/index.js';
 export type { JsonLdTransportMovement, TransportMovement, } from '../classes/transport-movement/index.js';
+export type { JsonLdRegulatedEntity, RegulatedEntity, } from '../classes/regulated-entity/index.js';
+export type { JsonLdSecurityDeclaration, SecurityDeclaration, } from '../classes/security-declaration/index.js';
+export type { JsonLdULD, ULD } from '../classes/uld/index.js';
 export type { JsonLdVerification, UnverifiedVerification, Verification, } from '../classes/verification/index.js';
 export type { JsonLdVerificationRequest, VerificationRequest, } from '../classes/verification-request/index.js';
 export type { JsonLdWaybill, Waybill } from '../classes/waybill/index.js';
+export type { JsonLdWaybillLineItem, WaybillLineItem, } from '../classes/waybill-line-item/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,11 +1,13 @@
 export { CARGO_CONTEXT_IRI, API_CONTEXT_IRI, ALLOWED_CONTEXTS, assertContextAllowed, } from './context.js';
-export declare const __VERSION__: "0.0.0-prerelease";
-export declare const CARGO_ONTOLOGY_VERSION: "3.2";
+export declare const __VERSION__: "0.3.0";
+export declare const CARGO_ONTOLOGY_VERSION: "3.2.0";
 export declare const API_SPEC_VERSION: "2.2.0";
 import type { ServerInformation } from './classes/server-information/index.js';
 /**
- * Hard-fail if the consumer's expected ontology version does not match
- * the mapper's pin. Use at consumer startup to surface mismatch loudly.
+ * Hard-fail if the consumer's expected ontology version is not in the
+ * accepted set. Use at consumer startup to surface mismatch loudly.
+ * Accepts '3.2.0' (canonical) and '3.2' (legacy alias). Rejects all others
+ * including '3.2.1' (master-only, not endorsed).
  */
 export declare function assertOntologyVersion(expected: string): void;
 export interface ServerCompatibility {
@@ -18,6 +20,9 @@ export interface ServerCompatibility {
  * Inspect a deserialized `ServerInformation` and report compatibility with
  * this mapper's ontology pin. Returns structured result rather than throwing
  * so consumers can warn-and-continue or hard-fail per their policy.
+ *
+ * Compatible iff `cargoOntologyVersion` is in the accepted set
+ * ('3.2.0' or '3.2'). null or any other value (including '3.2.1') → false.
  */
 export declare function checkServerInformation(si: ServerInformation): ServerCompatibility;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,eAAO,MAAM,WAAW,EAAG,kBAA2B,CAAA;AACtD,eAAO,MAAM,sBAAsB,EAAG,KAAc,CAAA;AACpD,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAA;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAG9E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAY5D;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAA;IACnB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,GAAG,mBAAmB,CAuBjF"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,eAAO,MAAM,WAAW,EAAG,OAAgB,CAAA;AAC3C,eAAO,MAAM,sBAAsB,EAAG,OAAgB,CAAA;AACtD,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAA;AAUhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAG9E;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAY5D;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAA;IACnB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,GAAG,mBAAmB,CAuBjF"}

package/dist/version.js

@@ -1,14 +1,23 @@
 // src/version.ts
 export { CARGO_CONTEXT_IRI, API_CONTEXT_IRI, ALLOWED_CONTEXTS, assertContextAllowed, } from './context.js';
-export const __VERSION__ = '0.0.0-prerelease';
-export const CARGO_ONTOLOGY_VERSION = '3.2';
+export const __VERSION__ = '0.3.0';
+export const CARGO_ONTOLOGY_VERSION = '3.2.0';
 export const API_SPEC_VERSION = '2.2.0';
 /**
- * Hard-fail if the consumer's expected ontology version does not match
- * the mapper's pin. Use at consumer startup to surface mismatch loudly.
+ * Exact-alias accepted set for ontology version checks.
+ * '3.2' is the legacy short-form alias for '3.2.0' (same endorsed standard).
+ * '3.2.1' is master-only (not endorsed) and is intentionally rejected.
+ * NOT a prefix/startsWith check — only the listed exact strings pass.
+ */
+const ACCEPTED_ONTOLOGY_VERSIONS = new Set(['3.2.0', '3.2']);
+/**
+ * Hard-fail if the consumer's expected ontology version is not in the
+ * accepted set. Use at consumer startup to surface mismatch loudly.
+ * Accepts '3.2.0' (canonical) and '3.2' (legacy alias). Rejects all others
+ * including '3.2.1' (master-only, not endorsed).
  */
 export function assertOntologyVersion(expected) {
-    if (expected !== CARGO_ONTOLOGY_VERSION) {
+    if (!ACCEPTED_ONTOLOGY_VERSIONS.has(expected)) {
         const error = {
             kind: 'incompatible_ontology_version',
             serverVersion: expected,
@@ -21,6 +30,9 @@ export function assertOntologyVersion(expected) {
  * Inspect a deserialized `ServerInformation` and report compatibility with
  * this mapper's ontology pin. Returns structured result rather than throwing
  * so consumers can warn-and-continue or hard-fail per their policy.
+ *
+ * Compatible iff `cargoOntologyVersion` is in the accepted set
+ * ('3.2.0' or '3.2'). null or any other value (including '3.2.1') → false.
  */
 export function checkServerInformation(si) {
     const serverOntologyVersion = si.cargoOntologyVersion ?? null;
@@ -32,7 +44,7 @@ export function checkServerInformation(si) {
             reason: 'ServerInformation did not advertise cargoOntologyVersion',
         };
     }
-    if (serverOntologyVersion !== CARGO_ONTOLOGY_VERSION) {
+    if (!ACCEPTED_ONTOLOGY_VERSIONS.has(serverOntologyVersion)) {
         return {
             compatible: false,
             mapperOntologyVersion: CARGO_ONTOLOGY_VERSION,

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,MAAM,CAAC,MAAM,WAAW,GAAG,kBAA2B,CAAA;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAc,CAAA;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAgB,CAAA;AAMhD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,IAAI,QAAQ,KAAK,sBAAsB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAe;YACxB,IAAI,EAAE,+BAA+B;YACrC,aAAa,EAAE,QAAQ;YACvB,aAAa,EAAE,sBAAsB;SACtC,CAAA;QACD,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,WAAW,sBAAsB,EAAE,EACtF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;AACH,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAqB;IAC1D,MAAM,qBAAqB,GAAG,EAAE,CAAC,oBAAoB,IAAI,IAAI,CAAA;IAC7D,IAAI,qBAAqB,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,qBAAqB,EAAE,sBAAsB;YAC7C,qBAAqB,EAAE,IAAI;YAC3B,MAAM,EAAE,0DAA0D;SACnE,CAAA;IACH,CAAC;IACD,IAAI,qBAAqB,KAAK,sBAAsB,EAAE,CAAC;QACrD,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,qBAAqB,EAAE,sBAAsB;YAC7C,qBAAqB;YACrB,MAAM,EAAE,uCAAuC,qBAAqB,sBAAsB,sBAAsB,EAAE;SACnH,CAAA;IACH,CAAC;IACD,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,qBAAqB,EAAE,sBAAsB;QAC7C,qBAAqB;KACtB,CAAA;AACH,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,MAAM,CAAC,MAAM,WAAW,GAAG,OAAgB,CAAA;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAgB,CAAA;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAgB,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;AAK5D;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAe;YACxB,IAAI,EAAE,+BAA+B;YACrC,aAAa,EAAE,QAAQ;YACvB,aAAa,EAAE,sBAAsB;SACtC,CAAA;QACD,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,WAAW,sBAAsB,EAAE,EACtF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;AACH,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAqB;IAC1D,MAAM,qBAAqB,GAAG,EAAE,CAAC,oBAAoB,IAAI,IAAI,CAAA;IAC7D,IAAI,qBAAqB,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,qBAAqB,EAAE,sBAAsB;YAC7C,qBAAqB,EAAE,IAAI;YAC3B,MAAM,EAAE,0DAA0D;SACnE,CAAA;IACH,CAAC;IACD,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC3D,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,qBAAqB,EAAE,sBAAsB;YAC7C,qBAAqB;YACrB,MAAM,EAAE,uCAAuC,qBAAqB,sBAAsB,sBAAsB,EAAE;SACnH,CAAA;IACH,CAAC;IACD,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,qBAAqB,EAAE,sBAAsB;QAC7C,qBAAqB;KACtB,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flaks/onerecord",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "Zero-dependency Zod-first JSON-LD mapper for IATA OneRecord cargo data model 3.2 + API spec 2.2.0",
   "type": "module",
   "license": "Apache-2.0",
@@ -61,13 +61,10 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:bench": "vitest bench",
-    "test:contract": "vitest run test/contract",
+    "test:contract": "vitest run --config vitest.contract.config.ts",
     "test:property": "vitest run test/property",
-    "audit:bun": "bun audit",
-    "audit:osv": "npx --yes osv-scanner@latest --lockfile=bun.lock",
-    "audit": "bun run audit:bun; bun run audit:osv",
-    "secrets:scan": "npx --yes gitleaks@latest detect --source . --no-banner",
-    "api:check": "npx --yes @arethetypeswrong/cli@latest --pack ."
+    "audit": "bun audit",
+    "api:check": "attw --pack . --ignore-rules no-resolution cjs-resolves-to-esm"
   },
   "dependencies": {
     "zod": "^4.0.0"
@@ -79,10 +76,13 @@
     "@vitest/coverage-v8": "^2.1.0",
     "fast-check": "^3.22.0",
     "typescript": "^5.6.0",
-    "vitest": "^2.1.0",
-    "xlsx": "^0.18.5"
+    "vitest": "^2.1.0"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "overrides": {
+    "vite": "^6.4.2",
+    "esbuild": "^0.25.0"
   }
 }