@oyinlola141/lattice-serialization 0.1.0

package/README.md

@@ -0,0 +1,19 @@
+# @latticejs/serialization
+
+Serialization framework for Lattice — multiple format support, type preservation, and streaming
+
+## Installation
+
+```bash
+npm install @latticejs/serialization
+```
+
+## Usage
+
+```typescript
+import { /* add usage here */ } from "@latticejs/serialization";
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @oyinlola141/lattice-serialization
+ *
+ * Data translation layer for the Lattice framework.
+ *
+ * Provides JSON serialization with type preservation, a transformer
+ * system for custom types, serialization envelopes for cross-service
+ * communication, and a registry for managing multiple serializers.
+ *
+ * @example
+ * ```typescript
+ * import { createSerializer, JSONSerializer } from "@oyinlola141/lattice-serialization";
+ *
+ * // Fast path (default) — nearly zero overhead over native JSON
+ * const serializer = createSerializer("json");
+ * const json = serializer.serialize({ hello: "world" });
+ * const data = serializer.deserialize(json);
+ *
+ * // Advanced path — type preservation for Date, BigInt, Map, Set, etc.
+ * const advanced = new JSONSerializer();
+ * const result = advanced.serialize(
+ *   { createdAt: new Date(), amount: 100n },
+ *   { preserveTypes: true },
+ * );
+ * ```
+ */
+export type { SerializationFormat, SerializedValue, SerializeOptions, DeserializeOptions, SerializationMetadata, SerializedEnvelope, Serializer, AsyncSerializer, TypeTransformer, UndefinedStrategy, } from "./serializerTypes/index.js";
+export { JSONSerializer } from "./serializerJson/index.js";
+export { TransformerRegistry } from "./serializerTransforms/index.js";
+export { DateTransformer } from "./serializerTransforms/index.js";
+export { BigIntTransformer } from "./serializerTransforms/index.js";
+export { MapTransformer } from "./serializerTransforms/index.js";
+export { SetTransformer } from "./serializerTransforms/index.js";
+export { BufferTransformer } from "./serializerTransformsExt/index.js";
+export { ErrorTransformer } from "./serializerTransformsExt/index.js";
+export { toBase64, fromBase64, encodeUtf8, decodeUtf8, } from "./serializerTransformsExt/index.js";
+export { createEnvelope, unwrapEnvelope, serializeToEnvelope, deserializeFromEnvelope, } from "./serializerEnvelope/index.js";
+export { SerializerRegistry } from "./serializerRegistry/index.js";
+export { createSerializer, createDefaultRegistry } from "./serializerRegistry/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @latticejs/serialization
+ *
+ * Data translation layer for the Lattice framework.
+ *
+ * Provides JSON serialization with type preservation, a transformer
+ * system for custom types, serialization envelopes for cross-service
+ * communication, and a registry for managing multiple serializers.
+ *
+ * @example
+ * ```typescript
+ * import { createSerializer, JSONSerializer } from "@latticejs/serialization";
+ *
+ * // Fast path (default) — nearly zero overhead over native JSON
+ * const serializer = createSerializer("json");
+ * const json = serializer.serialize({ hello: "world" });
+ * const data = serializer.deserialize(json);
+ *
+ * // Advanced path — type preservation for Date, BigInt, Map, Set, etc.
+ * const advanced = new JSONSerializer();
+ * const result = advanced.serialize(
+ *   { createdAt: new Date(), amount: 100n },
+ *   { preserveTypes: true },
+ * );
+ * ```
+ */
+// ─── JSON Serializer ──────────────────────────────────────────
+export { JSONSerializer } from "./serializerJson/index.js";
+// ─── Transformer Registry ─────────────────────────────────────
+export { TransformerRegistry } from "./serializerTransforms/index.js";
+export { DateTransformer } from "./serializerTransforms/index.js";
+export { BigIntTransformer } from "./serializerTransforms/index.js";
+export { MapTransformer } from "./serializerTransforms/index.js";
+export { SetTransformer } from "./serializerTransforms/index.js";
+// ─── Extended Transformers ────────────────────────────────────
+export { BufferTransformer } from "./serializerTransformsExt/index.js";
+export { ErrorTransformer } from "./serializerTransformsExt/index.js";
+export { toBase64, fromBase64, encodeUtf8, decodeUtf8, } from "./serializerTransformsExt/index.js";
+// ─── Envelope ─────────────────────────────────────────────────
+export { createEnvelope, unwrapEnvelope, serializeToEnvelope, deserializeFromEnvelope, } from "./serializerEnvelope/index.js";
+// ─── Registry & Factory ───────────────────────────────────────
+export { SerializerRegistry } from "./serializerRegistry/index.js";
+export { createSerializer, createDefaultRegistry } from "./serializerRegistry/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAgBH,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,iEAAiE;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,iEAAiE;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,oCAAoC,CAAC;AAE5C,iEAAiE;AACjE,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,iEAAiE;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/serializerEnvelope/envelope.core.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @oyinlola141/lattice-serialization — Serialization envelope.
+ *
+ * Wraps serialized data with metadata (format, version, encoding)
+ * so consumers know how to deserialize the payload. Essential for
+ * messaging, queues, RPC, and cross-service communication.
+ */
+import type { SerializedEnvelope, SerializedValue } from "../serializerTypes/index.js";
+/**
+ * Create a serialization envelope wrapping data with metadata.
+ *
+ * @param data - The serialized data payload.
+ * @param format - The serialization format used (default: "json").
+ * @param options - Additional metadata options.
+ * @returns A SerializedEnvelope with metadata and data.
+ */
+export declare function createEnvelope(data: SerializedValue, format?: string, options?: {
+    readonly version?: number;
+    readonly contentType?: string;
+    readonly encoding?: string;
+}): SerializedEnvelope;
+/**
+ * Extract the data from an envelope, validating metadata.
+ *
+ * @param envelope - The envelope to unwrap.
+ * @param expectedFormat - Optional format to validate against.
+ * @returns The raw serialized data.
+ * @throws {Error} when the envelope format doesn't match expectations.
+ */
+export declare function unwrapEnvelope(envelope: SerializedEnvelope, expectedFormat?: string): SerializedValue;
+/**
+ * Serialize a value and wrap it in an envelope.
+ *
+ * @param value - The value to serialize.
+ * @param serializer - The serializer to use.
+ * @param format - The format identifier for metadata.
+ * @returns A SerializedEnvelope containing the serialized data.
+ */
+export declare function serializeToEnvelope<T>(value: T, serializer: {
+    serialize: (v: T) => string;
+}, format?: string): SerializedEnvelope;
+/**
+ * Unwrap an envelope and deserialize the data.
+ *
+ * @param envelope - The envelope to unwrap.
+ * @param deserializer - The deserializer to use.
+ * @param expectedFormat - Optional format to validate against.
+ * @returns The deserialized value.
+ */
+export declare function deserializeFromEnvelope<T>(envelope: SerializedEnvelope, deserializer: {
+    deserialize: <U>(v: string) => U;
+}, expectedFormat?: string): T;
+//# sourceMappingURL=envelope.core.d.ts.map

package/dist/serializerEnvelope/envelope.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.core.d.ts","sourceRoot":"","sources":["../../src/serializerEnvelope/envelope.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAElB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAIrC;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,eAAe,EACrB,MAAM,GAAE,MAAiC,EACzC,OAAO,GAAE;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACvB,GACL,kBAAkB,CAUpB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB,eAAe,CAOjB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EACR,UAAU,EAAE;IAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;CAAE,EAC3C,MAAM,GAAE,MAAiC,GACxC,kBAAkB,CAGpB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,QAAQ,EAAE,kBAAkB,EAC5B,YAAY,EAAE;IAAE,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,CAAA;CAAE,EAClD,cAAc,CAAC,EAAE,MAAM,GACtB,CAAC,CAIH"}

package/dist/serializerEnvelope/envelope.core.js

@@ -0,0 +1,68 @@
+/**
+ * @latticejs/serialization — Serialization envelope.
+ *
+ * Wraps serialized data with metadata (format, version, encoding)
+ * so consumers know how to deserialize the payload. Essential for
+ * messaging, queues, RPC, and cross-service communication.
+ */
+import { SerializationFormat, SerializationContentType, SERIALIZATION_SCHEMA_VERSION } from "@latticejs/constants";
+import { encodeUtf8, decodeUtf8 } from "../serializerTransformsExt/index.js";
+/**
+ * Create a serialization envelope wrapping data with metadata.
+ *
+ * @param data - The serialized data payload.
+ * @param format - The serialization format used (default: "json").
+ * @param options - Additional metadata options.
+ * @returns A SerializedEnvelope with metadata and data.
+ */
+export function createEnvelope(data, format = SerializationFormat.JSON, options = {}) {
+    return {
+        metadata: {
+            format,
+            version: options.version ?? SERIALIZATION_SCHEMA_VERSION,
+            contentType: options.contentType ?? SerializationContentType.JSON,
+            encoding: options.encoding ?? "utf-8",
+        },
+        data,
+    };
+}
+/**
+ * Extract the data from an envelope, validating metadata.
+ *
+ * @param envelope - The envelope to unwrap.
+ * @param expectedFormat - Optional format to validate against.
+ * @returns The raw serialized data.
+ * @throws {Error} when the envelope format doesn't match expectations.
+ */
+export function unwrapEnvelope(envelope, expectedFormat) {
+    if (expectedFormat && envelope.metadata.format !== expectedFormat) {
+        throw new Error(`Envelope format mismatch: expected "${expectedFormat}", got "${envelope.metadata.format}"`);
+    }
+    return envelope.data;
+}
+/**
+ * Serialize a value and wrap it in an envelope.
+ *
+ * @param value - The value to serialize.
+ * @param serializer - The serializer to use.
+ * @param format - The format identifier for metadata.
+ * @returns A SerializedEnvelope containing the serialized data.
+ */
+export function serializeToEnvelope(value, serializer, format = SerializationFormat.JSON) {
+    const data = serializer.serialize(value);
+    return createEnvelope(data, format);
+}
+/**
+ * Unwrap an envelope and deserialize the data.
+ *
+ * @param envelope - The envelope to unwrap.
+ * @param deserializer - The deserializer to use.
+ * @param expectedFormat - Optional format to validate against.
+ * @returns The deserialized value.
+ */
+export function deserializeFromEnvelope(envelope, deserializer, expectedFormat) {
+    const data = unwrapEnvelope(envelope, expectedFormat);
+    const str = typeof data === "string" ? data : decodeUtf8(data);
+    return deserializer.deserialize(str);
+}
+//# sourceMappingURL=envelope.core.js.map

package/dist/serializerEnvelope/envelope.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.core.js","sourceRoot":"","sources":["../../src/serializerEnvelope/envelope.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAqB,EACrB,SAAiB,mBAAmB,CAAC,IAAI,EACzC,UAII,EAAE;IAEN,OAAO;QACL,QAAQ,EAAE;YACR,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,4BAA4B;YACxD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,wBAAwB,CAAC,IAAI;YACjE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO;SACtC;QACD,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA4B,EAC5B,cAAuB;IAEvB,IAAI,cAAc,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CACb,uCAAuC,cAAc,WAAW,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAQ,EACR,UAA2C,EAC3C,SAAiB,mBAAmB,CAAC,IAAI;IAEzC,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA4B,EAC5B,YAAkD,EAClD,cAAuB;IAEvB,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/D,OAAO,YAAY,CAAC,WAAW,CAAI,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/serializerEnvelope/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @oyinlola141/lattice-serialization — Serialization envelope.
+ *
+ * Wraps serialized data with metadata for cross-service communication.
+ */
+export { createEnvelope, unwrapEnvelope, serializeToEnvelope, deserializeFromEnvelope, } from "./envelope.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializerEnvelope/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/serializerEnvelope/index.js

@@ -0,0 +1,7 @@
+/**
+ * @latticejs/serialization — Serialization envelope.
+ *
+ * Wraps serialized data with metadata for cross-service communication.
+ */
+export { createEnvelope, unwrapEnvelope, serializeToEnvelope, deserializeFromEnvelope, } from "./envelope.core.js";
+//# sourceMappingURL=index.js.map

package/dist/serializerEnvelope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serializerEnvelope/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/serializerJson/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @oyinlola141/lattice-serialization — JSON serializer.
+ *
+ * JSON serializer with fast path (native JSON) and advanced path
+ * with type preservation via transformer registry.
+ */
+export { JSONSerializer } from "./jsonSerializer.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializerJson/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/serializerJson/index.js

@@ -0,0 +1,8 @@
+/**
+ * @latticejs/serialization — JSON serializer.
+ *
+ * JSON serializer with fast path (native JSON) and advanced path
+ * with type preservation via transformer registry.
+ */
+export { JSONSerializer } from "./jsonSerializer.core.js";
+//# sourceMappingURL=index.js.map

package/dist/serializerJson/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serializerJson/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/serializerJson/jsonSerializer.core.d.ts

@@ -0,0 +1,26 @@
+/**
+ * JSON serializer with optional type preservation.
+ *
+ * Fast path (default): delegates to native JSON.stringify/parse.
+ * Advanced path (preserveTypes: true): recursive traversal with
+ * transformer-based type preservation.
+ */
+import type { Serializer, SerializeOptions, DeserializeOptions } from "../serializerTypes/index.js";
+import { TransformerRegistry } from "../serializerTransforms/index.js";
+export declare class JSONSerializer implements Serializer<unknown, string> {
+    readonly name = "json";
+    readonly contentType = "application/json";
+    private readonly transformers;
+    constructor(options?: {
+        readonly transformers?: TransformerRegistry;
+    });
+    /** Register a custom type transformer. */
+    registerTransformer(transformer: import("../serializerTypes/index.js").TypeTransformer): void;
+    serialize(value: unknown, options?: SerializeOptions): string;
+    deserialize<T = unknown>(value: string, options?: DeserializeOptions): T;
+    private transformValue;
+    private restoreValue;
+    private assertValidJson;
+    private assertOutputSize;
+}
+//# sourceMappingURL=jsonSerializer.core.d.ts.map

package/dist/serializerJson/jsonSerializer.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSerializer.core.d.ts","sourceRoot":"","sources":["../../src/serializerJson/jsonSerializer.core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAmBvE,qBAAa,cAAe,YAAW,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;IAChE,SAAgB,IAAI,UAAU;IAC9B,SAAgB,WAAW,sBAAsB;IAEjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAEvC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAA;KAAE;IAIrE,0CAA0C;IAC1C,mBAAmB,CAAC,WAAW,EAAE,OAAO,6BAA6B,EAAE,eAAe,GAAG,IAAI;IAI7F,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;IAsB7D,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,CAAC;IAcxE,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;CAQzB"}

package/dist/serializerJson/jsonSerializer.core.js

@@ -0,0 +1,149 @@
+/**
+ * JSON serializer with optional type preservation.
+ *
+ * Fast path (default): delegates to native JSON.stringify/parse.
+ * Advanced path (preserveTypes: true): recursive traversal with
+ * transformer-based type preservation.
+ */
+import { TransformerRegistry } from "../serializerTransforms/index.js";
+import { DateTransformer, BigIntTransformer, MapTransformer, SetTransformer } from "../serializerTransforms/index.js";
+import { BufferTransformer, ErrorTransformer } from "../serializerTransformsExt/index.js";
+import { SerializationLimits, SerializationTags } from "@latticejs/constants";
+import { isPlainObject } from "@latticejs/types";
+import { assertNoCircularReference, assertDepthWithinLimit, assertSizeWithinLimit } from "@latticejs/validation";
+/** Default transformer registry with all built-in transformers. */
+function createDefaultTransformers() {
+    const registry = new TransformerRegistry();
+    registry.register(DateTransformer);
+    registry.register(BigIntTransformer);
+    registry.register(MapTransformer);
+    registry.register(SetTransformer);
+    registry.register(BufferTransformer);
+    registry.register(ErrorTransformer);
+    return registry;
+}
+export class JSONSerializer {
+    name = "json";
+    contentType = "application/json";
+    transformers;
+    constructor(options) {
+        this.transformers = options?.transformers ?? createDefaultTransformers();
+    }
+    /** Register a custom type transformer. */
+    registerTransformer(transformer) {
+        this.transformers.register(transformer);
+    }
+    serialize(value, options) {
+        const maxDepth = options?.maxDepth ?? SerializationLimits.MAX_DEPTH;
+        const maxSize = options?.maxSize ?? SerializationLimits.MAX_SIZE;
+        if (options?.preserveTypes === true) {
+            assertNoCircularReference(value);
+            assertDepthWithinLimit(value, maxDepth);
+            const transformed = this.transformValue(value, 0, maxDepth);
+            const json = options?.pretty
+                ? JSON.stringify(transformed, null, options?.indent ?? 2)
+                : JSON.stringify(transformed);
+            this.assertOutputSize(json, maxSize);
+            return json;
+        }
+        const json = options?.pretty
+            ? JSON.stringify(value, null, options?.indent ?? 2)
+            : JSON.stringify(value);
+        this.assertOutputSize(json, maxSize);
+        return json;
+    }
+    deserialize(value, options) {
+        if (options?.strict === true)
+            this.assertValidJson(value);
+        const parsed = JSON.parse(value);
+        if (options?.preserveTypes === true) {
+            const maxDepth = options?.maxDepth ?? SerializationLimits.MAX_DEPTH;
+            assertDepthWithinLimit(parsed, maxDepth);
+            return this.restoreValue(parsed, 0, maxDepth);
+        }
+        return parsed;
+    }
+    transformValue(value, depth, maxDepth) {
+        if (value === null || value === undefined)
+            return value;
+        if (typeof value === "bigint") {
+            const transformer = this.transformers.findForValue(value);
+            return transformer ? transformer.serialize(value) : value.toString();
+        }
+        if (typeof value !== "object")
+            return value;
+        if (depth >= maxDepth)
+            return value;
+        if (Array.isArray(value)) {
+            return value.map((item) => this.transformValue(item, depth + 1, maxDepth));
+        }
+        const transformer = this.transformers.findForValue(value);
+        if (transformer) {
+            const raw = transformer.serialize(value);
+            return this.transformValue(raw, depth + 1, maxDepth);
+        }
+        if (value instanceof Map) {
+            const entries = [];
+            for (const [k, v] of value) {
+                entries.push([this.transformValue(k, depth + 1, maxDepth), this.transformValue(v, depth + 1, maxDepth)]);
+            }
+            return { [SerializationTags.TYPE]: "Map", [SerializationTags.VALUE]: entries };
+        }
+        if (value instanceof Set) {
+            return {
+                [SerializationTags.TYPE]: "Set",
+                [SerializationTags.VALUE]: [...value].map((v) => this.transformValue(v, depth + 1, maxDepth)),
+            };
+        }
+        if (isPlainObject(value)) {
+            const result = {};
+            for (const key of Object.keys(value)) {
+                result[key] = this.transformValue(value[key], depth + 1, maxDepth);
+            }
+            return result;
+        }
+        return value;
+    }
+    restoreValue(value, depth, maxDepth) {
+        if (value === null || value === undefined)
+            return value;
+        if (typeof value !== "object")
+            return value;
+        if (depth >= maxDepth)
+            return value;
+        if (Array.isArray(value)) {
+            return value.map((item) => this.restoreValue(item, depth + 1, maxDepth));
+        }
+        const obj = value;
+        const typeTag = obj[SerializationTags.TYPE];
+        if (typeof typeTag === "string") {
+            const transformer = this.transformers.get(typeTag);
+            return transformer.deserialize(value);
+        }
+        if (isPlainObject(value)) {
+            const result = {};
+            for (const key of Object.keys(value)) {
+                result[key] = this.restoreValue(value[key], depth + 1, maxDepth);
+            }
+            return result;
+        }
+        return value;
+    }
+    assertValidJson(value) {
+        try {
+            JSON.parse(value);
+        }
+        catch (err) {
+            throw new Error(`Invalid JSON: ${err.message}`);
+        }
+    }
+    assertOutputSize(json, maxSize) {
+        const size = typeof Buffer !== "undefined"
+            ? Buffer.byteLength(json, "utf-8")
+            : new TextEncoder().encode(json).byteLength;
+        if (size > maxSize) {
+            throw new Error(`Serialized payload too large: ${size} bytes (max: ${maxSize})`);
+        }
+    }
+}
+//# sourceMappingURL=jsonSerializer.core.js.map

package/dist/serializerJson/jsonSerializer.core.js.map

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

package/dist/serializerRegistry/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @oyinlola141/lattice-serialization — Serializer registry and factory.
+ *
+ * Central registry for named serializer instances and factory
+ * functions for creating serializers by format.
+ */
+export { SerializerRegistry } from "./serializerRegistry.core.js";
+export { createSerializer, createDefaultRegistry } from "./serializerRegistry.factory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializerRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/serializerRegistry/index.js

@@ -0,0 +1,9 @@
+/**
+ * @latticejs/serialization — Serializer registry and factory.
+ *
+ * Central registry for named serializer instances and factory
+ * functions for creating serializers by format.
+ */
+export { SerializerRegistry } from "./serializerRegistry.core.js";
+export { createSerializer, createDefaultRegistry } from "./serializerRegistry.factory.js";
+//# sourceMappingURL=index.js.map

package/dist/serializerRegistry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serializerRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/serializerRegistry/serializerRegistry.core.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @oyinlola141/lattice-serialization — Serializer registry.
+ *
+ * Central registry for named serializer instances. Other packages
+ * look up serializers by name instead of importing concrete classes.
+ */
+import type { Serializer } from "../serializerTypes/index.js";
+/**
+ * Registry of serializer instances keyed by canonical name.
+ *
+ * Provides a lookup mechanism so consuming packages depend on
+ * interfaces, not concrete serializer implementations.
+ */
+export declare class SerializerRegistry {
+    private readonly serializers;
+    /** Register a serializer. Overwrites any existing registration with the same name. */
+    register(serializer: Serializer): void;
+    /** Unregister a serializer by name. */
+    unregister(name: string): boolean;
+    /** Retrieve a serializer by name. Throws SerializerNotFoundError if not found. */
+    get(name: string): Serializer;
+    /** Returns true when a serializer is registered for the name. */
+    has(name: string): boolean;
+    /** Returns all registered serializer names. */
+    names(): string[];
+    /** Remove all registered serializers. */
+    clear(): void;
+    /** Number of registered serializers. */
+    get size(): number;
+}
+//# sourceMappingURL=serializerRegistry.core.d.ts.map

package/dist/serializerRegistry/serializerRegistry.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializerRegistry.core.d.ts","sourceRoot":"","sources":["../../src/serializerRegistry/serializerRegistry.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9D;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAItC,uCAAuC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,kFAAkF;IAClF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAM7B,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,+CAA+C;IAC/C,KAAK,IAAI,MAAM,EAAE;IAIjB,yCAAyC;IACzC,KAAK,IAAI,IAAI;IAIb,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/serializerRegistry/serializerRegistry.core.js

@@ -0,0 +1,48 @@
+/**
+ * @latticejs/serialization — Serializer registry.
+ *
+ * Central registry for named serializer instances. Other packages
+ * look up serializers by name instead of importing concrete classes.
+ */
+import { SerializerNotFoundError } from "@latticejs/errors";
+/**
+ * Registry of serializer instances keyed by canonical name.
+ *
+ * Provides a lookup mechanism so consuming packages depend on
+ * interfaces, not concrete serializer implementations.
+ */
+export class SerializerRegistry {
+    serializers = new Map();
+    /** Register a serializer. Overwrites any existing registration with the same name. */
+    register(serializer) {
+        this.serializers.set(serializer.name, serializer);
+    }
+    /** Unregister a serializer by name. */
+    unregister(name) {
+        return this.serializers.delete(name);
+    }
+    /** Retrieve a serializer by name. Throws SerializerNotFoundError if not found. */
+    get(name) {
+        const serializer = this.serializers.get(name);
+        if (!serializer)
+            throw new SerializerNotFoundError(name);
+        return serializer;
+    }
+    /** Returns true when a serializer is registered for the name. */
+    has(name) {
+        return this.serializers.has(name);
+    }
+    /** Returns all registered serializer names. */
+    names() {
+        return [...this.serializers.keys()];
+    }
+    /** Remove all registered serializers. */
+    clear() {
+        this.serializers.clear();
+    }
+    /** Number of registered serializers. */
+    get size() {
+        return this.serializers.size;
+    }
+}
+//# sourceMappingURL=serializerRegistry.core.js.map

package/dist/serializerRegistry/serializerRegistry.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializerRegistry.core.js","sourceRoot":"","sources":["../../src/serializerRegistry/serializerRegistry.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACZ,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE7D,sFAAsF;IACtF,QAAQ,CAAC,UAAsB;QAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,uCAAuC;IACvC,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,kFAAkF;IAClF,GAAG,CAAC,IAAY;QACd,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iEAAiE;IACjE,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,+CAA+C;IAC/C,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,yCAAyC;IACzC,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,wCAAwC;IACxC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;CACF"}

package/dist/serializerRegistry/serializerRegistry.factory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @oyinlola141/lattice-serialization — Serializer factory.
+ *
+ * Factory function for creating serializer instances by format name.
+ * Provides a clean public API for creating serializers without
+ * exposing concrete class constructors.
+ */
+import type { Serializer, SerializationFormat } from "../serializerTypes/index.js";
+import { TransformerRegistry } from "../serializerTransforms/index.js";
+import { SerializerRegistry } from "./serializerRegistry.core.js";
+/**
+ * Create a serializer for the given format.
+ *
+ * @param format - The serialization format (e.g., "json").
+ * @param options - Optional configuration for the serializer.
+ * @returns A Serializer instance.
+ * @throws {UnsupportedSerializationFormatError} when the format is not supported.
+ */
+export declare function createSerializer(format: SerializationFormat, options?: {
+    readonly transformers?: TransformerRegistry;
+    readonly pretty?: boolean;
+    readonly preserveTypes?: boolean;
+}): Serializer;
+/**
+ * Create a default serializer registry pre-populated with built-in serializers.
+ *
+ * @returns A SerializerRegistry with "json" registered.
+ */
+export declare function createDefaultRegistry(): SerializerRegistry;
+//# sourceMappingURL=serializerRegistry.factory.d.ts.map