@altopelago/aeon-aes 0.12.1 → 0.13.0

package/README.md

@@ -1,6 +1,7 @@
 # @altopelago/aeon-aes
 
-Assignment Event Stream emission, portable projection, and Telex v1 codec.
+Assignment Event Stream emission, portable projection, Telex v1 codec, and
+reader-only Film v1 decoding.
 
 ## Installation
 
@@ -26,6 +27,8 @@ if (result.errors.length === 0) {
 - 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
@@ -43,6 +46,9 @@ if (result.errors.length === 0) {
 - `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
@@ -65,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/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"}