@elaraai/east 1.0.44 → 1.0.46

package/dist/src/serialization/beast2/v4/container.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Beast2 v4 container codec — the globally-sectioned format.
+ *
+ * File layout: magic(8) + type_table_section + string_table_section +
+ * source_map_section + value_table_section + value_stream.
+ * Type table: flat array of unique types, referenced by varint index.
+ * String table: flat array of unique strings, referenced by varint index.
+ * Value stream: type-driven positional encoding, no inline type tags.
+ * Functions: IR encoded directly — EastTypeType values are regular variants.
+ *
+ * See v4/SPEC.md for the wire specification. Version-agnostic entry points
+ * (magic dispatch across v4/v5) live in `../index.ts`.
+ */
+import { type EastTypeValue } from "../../../type_of_type.js";
+import type { EastType, ValueTypeOf } from "../../../types.js";
+import type { SourceMap } from "../../../location.js";
+import { type Beast2DecodeOptions } from "../shared.js";
+export declare const MAGIC_BYTES: Uint8Array<ArrayBuffer>;
+/**
+ * Builds a v4-container encoder closure for the given type.
+ *
+ * @param type - the root East type (as `EastType` or `EastTypeValue`)
+ * @param options - optional explicit source map to embed
+ * @returns a reusable function encoding values of `type` to v4 beast2 bytes
+ */
+export declare function encodeBeast2V4For(type: EastTypeValue, options?: {
+    sourceMap?: SourceMap | null;
+}): (value: any) => Uint8Array;
+export declare function encodeBeast2V4For<T extends EastType>(type: T, options?: {
+    sourceMap?: SourceMap | null;
+}): (value: ValueTypeOf<T>) => Uint8Array;
+/**
+ * Builds a v4-container decoder closure for the given type.
+ *
+ * @param type - the expected root East type (as `EastType` or `EastTypeValue`)
+ * @param options - decode options (platform functions for decoded functions)
+ * @returns a reusable function decoding v4 beast2 bytes to values of `type`
+ */
+export declare function decodeBeast2V4For(type: EastTypeValue, options?: Beast2DecodeOptions): (data: Uint8Array) => any;
+export declare function decodeBeast2V4For<T extends EastType>(type: T, options?: Beast2DecodeOptions): (data: Uint8Array) => ValueTypeOf<T>;
+/**
+ * Decodes a v4 IRType blob and returns both the IR value and the decoded
+ * source map. Backs the version-agnostic `decodeEastIR` / `decodeAsyncEastIR`.
+ *
+ * @param data - a v4 beast2 blob whose root is a Function/AsyncFunction IR
+ * @returns the decoded IR value and the blob's source map (or `null`)
+ */
+export declare function decodeIRWithSourceMapV4(data: Uint8Array): {
+    ir: any;
+    sourceMap: SourceMap | null;
+};
+/**
+ * Decodes a self-describing v4 blob using its embedded root type.
+ *
+ * @param data - a v4 beast2 blob
+ * @param options - decode options (platform functions for decoded functions)
+ * @returns the blob's root type and decoded value
+ */
+export declare function decodeBeast2V4(data: Uint8Array, options?: Beast2DecodeOptions): {
+    type: EastTypeValue;
+    value: any;
+};
+//# sourceMappingURL=container.d.ts.map

package/dist/src/serialization/beast2/v4/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/beast2/v4/container.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAc/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,KAAK,mBAAmB,EAA2G,MAAM,cAAc,CAAC;AASjK,eAAO,MAAM,WAAW,yBAAmE,CAAC;AAqnB5F;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,UAAU,CAAA;AAC9H,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,UAAU,CAAA;AA4EjJ;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,GAAG,CAAA;AAChH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,CAAA;AAuCnI;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,EAAE,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,CAqBlG;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAwBnH"}