@altopelago/aeon-aes 0.12.0 → 0.13.0

package/README.md

@@ -1,6 +1,7 @@
 # @altopelago/aeon-aes
 
-Assignment Event Stream emission and supporting AEON path utilities.
+Assignment Event Stream emission, portable projection, Telex v1 codec, and
+reader-only Film v1 decoding.
 
 ## Installation
 
@@ -25,12 +26,33 @@ if (result.errors.length === 0) {
 - emits Assignment Events from AEON source or parsed syntax
 - formats and works with canonical AEON paths
 - exposes event-level data used by AEOS validation, finalization, and tooling
+- parses, validates, encodes, and canonicalizes `telex.aes` v1 streams
+- decodes one-shot and incremental `film.aes` v1 streams, withholding complete
+  acceptance until portable AES validation succeeds
+- splits compact Telex datatypes into `datatype`, `generics`, and `clarifiers`
 
 ## API
 
 - `emitAssignmentEvents(input, options?)`
+- `projectPortableEvents(events)` emits the default body-only portable
+  projection
+- `adaptTypeScriptAssignmentEventsToPortableAes(events, options?)` returns the
+  named `aeon.typescript.assignment-events.v0-to-aes.events.v1` compatibility
+  result and its conversion report; optional exact `sourceBytes` derive a
+  SHA-256 origin and convert native UTF-16 ranges to UTF-8 byte spans;
+  `includeHeaders: true` selects `aeon.document.v1`
+- `parseTelex(input, options?)`
+- `encodeTelex(records, options?)`
+- `canonicalizeTelex(input, options?)`
+- `validateTelex(input, options?)`
+- `validateTelexRecords(records, options?)`
+- `decodeFilmSyntax(input, options?)` for provisional inspection
+- `decodeFilm(input, options?)` for complete validated reads
+- `IncrementalFilmDecoder`
 - canonical path helpers
 - Assignment Event Stream types
+  - emitted native events carry `sourcePlane: 'header' | 'body'`; consumers
+    must not infer control-plane identity from an `aeon:` key prefix
 - reconstructed candidate AES types:
   - `CandidateAES`
   - `CandidateAssignmentEvent`
@@ -39,7 +61,8 @@ if (result.errors.length === 0) {
 
 ## When To Use It
 
-Use this package when you need direct access to emitted AEON assignment events.
+Use this package when you need direct access to assignment events or the
+encoding-neutral portable AES/Telex boundary.
 If you want the stable application-facing entry point, prefer `@altopelago/aeon-core`.
 
 ## Notes
@@ -48,5 +71,11 @@ If you want the stable application-facing entry point, prefer `@altopelago/aeon-
 - Candidate AES types describe reconstructed validation input for speculative
   post-commit state. They do not define substrate materialization policy.
 - This package does not materialize application objects.
+- Film support is reader-only. No Film encoder or durable-writer surface is
+  exported.
+- Film byte limits (`maxInputBytes`, `maxRecordBytes`, `maxFieldBytes`, and
+  `maxBufferedBytes`) are format-local. Shared event and structural limits may
+  be supplied flat or through `aesLimits`; Telex framing limits are never
+  imported as Film byte policy.
 - Schema validation belongs in `@altopelago/aeos-core`.
 - JSON or map materialization belongs in `@altopelago/aeon-finalize`.

package/dist/events.d.ts

@@ -15,6 +15,8 @@ export interface AssignmentEvent {
     readonly normalizedPath?: string;
     /** Local key name (e.g., "host") */
     readonly key: string;
+    /** Source document plane; independent of the textual key prefix. */
+    readonly sourcePlane?: 'header' | 'body';
     /** Optional structural occurrence identity from the source binding. */
     readonly structuralId?: string | null;
     /** Original AST value node - NOT evaluated or transformed */
@@ -30,9 +32,12 @@ export interface AssignmentEvent {
  * Attribute entry
  */
 export interface AttributeEntry {
+    readonly structuralId?: string | null;
     readonly value: Value;
     readonly datatype?: string;
     readonly annotations?: ReadonlyMap<string, AttributeEntry>;
+    /** Native UTF-16 source range retained for explicit portable conversion. */
+    readonly span?: Span;
 }
 /**
  * Event emission result

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAa,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACH,KAAK,aAAa,EAElB,KAAK,oBAAoB,EACzB,mBAAmB,EAEtB,MAAM,YAAY,CAAC;AAGpB;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC9D;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,kBAAkB,GAAG,mBAAmB,CAAC,EAAE,CAAC;CAC1E;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAE,MAAsB,EAKpE;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACtB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,oBAAyB,GACnC,mBAAmB,CAyBrB;AA0DD,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAa,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACH,KAAK,aAAa,EAElB,KAAK,oBAAoB,EACzB,mBAAmB,EAEtB,MAAM,YAAY,CAAC;AAGpB;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3D,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,kBAAkB,GAAG,mBAAmB,CAAC,EAAE,CAAC;CAC1E;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAE,MAAsB,EAKpE;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACtB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,oBAAyB,GACnC,mBAAmB,CAyBrB;AA6DD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/events.js

@@ -58,6 +58,7 @@ function createEvent(cb) {
         path: cb.path,
         normalizedPath: formatNormalizedPath(cb.path),
         key: binding.key,
+        sourcePlane: cb.sourcePlane,
         ...(binding.structuralId !== null ? { structuralId: binding.structuralId } : {}),
         value: binding.value,
         span: cb.span,
@@ -81,7 +82,9 @@ function buildAnnotations(attributes) {
     for (const attr of attributes) {
         for (const [key, entry] of attr.entries) {
             const attrEntry = {
+                ...(entry.structuralId !== null ? { structuralId: entry.structuralId } : {}),
                 value: entry.value,
+                ...(entry.span !== undefined ? { span: entry.span } : {}),
             };
             if (entry.datatype) {
                 attrEntry.datatype = formatDatatypeAnnotation(entry.datatype);

package/dist/events.js.map

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

package/dist/film-internal.d.ts

@@ -0,0 +1,137 @@
+export declare const FILM_VERSION = "1";
+export declare const FILM_V1_PREAMBLE: readonly number[];
+export declare const DEFAULT_FILM_LIMITS: Readonly<{
+    maxInputBytes: 67108864;
+    maxRecordBytes: 16777216;
+    maxFieldBytes: 4194304;
+    maxBufferedBytes: 16777216;
+}>;
+export declare class FilmDecodeError extends Error {
+    constructor(code: any, message: any, details?: {});
+}
+/** Normalize the Film-local limits selected by the consumer. */
+export declare function normalizeFilmLimits(options?: {}): Readonly<{
+    maxInputBytes: any;
+    maxRecordBytes: any;
+    maxFieldBytes: any;
+    maxBufferedBytes: any;
+}>;
+/**
+ * Decode canonical Film framing and records into owned JavaScript values.
+ * The result is provisional: portable AES semantics have not yet been
+ * accepted. Use decodeFilm for replay, ingestion, or mutation inputs.
+ */
+export declare function decodeFilmSyntax(input: any, options?: {}): {
+    profile: string;
+    profileExplicit: boolean;
+    projection: string | null;
+    projectionExplicit: boolean;
+    records: {
+        [x: string]: string;
+        kind: string;
+    }[];
+};
+/** Decode Film and return an owned stream only after complete AES validation. */
+export declare function decodeFilm(input: any, options?: {}): {
+    profile: string;
+    profileExplicit: boolean;
+    projection: string | null;
+    projectionExplicit: boolean;
+    records: {
+        [x: string]: string;
+        kind: string;
+    }[];
+};
+/**
+ * Incremental Film decoder. Complete records may be inspected provisionally,
+ * but only a successful push with `{ final: true }` returns `status=complete`.
+ */
+export declare class IncrementalFilmDecoder {
+    constructor(options?: {});
+    push(input: any, options?: {}): {
+        records: any[];
+        status?: any;
+        stream?: {
+            profile: any;
+            profileExplicit: any;
+            projection: any;
+            projectionExplicit: any;
+            records: any;
+        } | null;
+        bufferedBytes?: any;
+        inputBytes?: any;
+    } | {
+        status: any;
+        records: any;
+        stream: {
+            profile: any;
+            profileExplicit: any;
+            projection: any;
+            projectionExplicit: any;
+            records: any;
+        } | null;
+        bufferedBytes: any;
+        inputBytes: any;
+    };
+    pushBounded(input: any, final: any): {
+        status: any;
+        records: any;
+        stream: {
+            profile: any;
+            profileExplicit: any;
+            projection: any;
+            projectionExplicit: any;
+            records: any;
+        } | null;
+        bufferedBytes: any;
+        inputBytes: any;
+    };
+    finish(): {
+        records: any[];
+        status?: any;
+        stream?: {
+            profile: any;
+            profileExplicit: any;
+            projection: any;
+            projectionExplicit: any;
+            records: any;
+        } | null;
+        bufferedBytes?: any;
+        inputBytes?: any;
+    } | {
+        status: any;
+        records: any;
+        stream: {
+            profile: any;
+            profileExplicit: any;
+            projection: any;
+            projectionExplicit: any;
+            records: any;
+        } | null;
+        bufferedBytes: any;
+        inputBytes: any;
+    };
+    consume(length: any): void;
+    retainIncompleteBuffer(): void;
+    bufferLimitDetails(): {
+        offset: any;
+        record: any;
+        component: string;
+    };
+    currentStream(): any;
+    result(status: any, records: any): {
+        status: any;
+        records: any;
+        stream: {
+            profile: any;
+            profileExplicit: any;
+            projection: any;
+            projectionExplicit: any;
+            records: any;
+        } | null;
+        bufferedBytes: any;
+        inputBytes: any;
+    };
+}
+export declare function filmV1IsDraft(): boolean;
+//# sourceMappingURL=film-internal.d.ts.map

package/dist/film-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"film-internal.d.ts","sourceRoot":"","sources":["../src/film-internal.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,gBAAgB,mBAAgD,CAAC;AAE9E,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAC;AA8CH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,IAAI,KAAA,EAAE,OAAO,KAAA,EAAE,OAAO,KAAK,EAStC;CACF;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,OAAO,KAAK;;;;;GAQ/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,KAAA,EAAE,OAAO,KAAK;;;;;;;;;EAqEnD;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,KAAK,KAAA,EAAE,OAAO,KAAK;;;;;;;;;EAI7C;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,YAAY,OAAO,KAAK,EAYvB;IAED,IAAI,CAAC,KAAK,KAAA,EAAE,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;MAwCvB;IAED,WAAW,CAAC,KAAK,KAAA,EAAE,KAAK,KAAA;;;;;;;;;;;;MAiIvB;IAED,MAAM;;;;;;;;;;;;;;;;;;;;;;;;MAEL;IAED,OAAO,CAAC,MAAM,KAAA,QAKb;IAED,sBAAsB,SAQrB;IAED,kBAAkB;;;;MAMjB;IAED,aAAa,QAKZ;IAED,MAAM,CAAC,MAAM,KAAA,EAAE,OAAO,KAAA;;;;;;;;;;;;MAQrB;CACF;AAyHD,wBAAgB,aAAa,YAE5B"}