@2702rebels/wpidata 1.0.0

package/dist/formats/msgpack.cjs

@@ -0,0 +1,30 @@
+const require_utils = require('../utils.cjs');
+let _msgpack_msgpack = require("@msgpack/msgpack");
+
+//#region src/formats/msgpack.ts
+/** Implements {@link DataTransformer} interface for the `msgpack` serialization protocol. */
+var MsgpackDataTransformer = class {
+	inspect(source, name, type, metadata) {
+		if (type === "msgpack") return {
+			source,
+			id: name,
+			dataType: "json",
+			publishedDataType: type,
+			transformer: this,
+			metadata
+		};
+	}
+	schema() {}
+	deserialize(value) {
+		return (0, _msgpack_msgpack.decode)(require_utils.toUint8Array(value));
+	}
+	serialize(value) {
+		return (0, _msgpack_msgpack.encode)(value);
+	}
+	canTransform() {
+		return true;
+	}
+};
+
+//#endregion
+exports.MsgpackDataTransformer = MsgpackDataTransformer;

package/dist/formats/msgpack.d.cts

@@ -0,0 +1,14 @@
+import { DataChannel, DataTransformer, DataTypeImpl } from "../abstractions.cjs";
+
+//#region src/formats/msgpack.d.ts
+/** Implements {@link DataTransformer} interface for the `msgpack` serialization protocol. */
+declare class MsgpackDataTransformer implements DataTransformer {
+  inspect(source: string, name: string, type: string, metadata?: string | Record<string, unknown>): DataChannel | string | undefined;
+  schema(): void;
+  deserialize(value: unknown): DataTypeImpl | undefined;
+  serialize(value: unknown): Uint8Array;
+  canTransform(): boolean;
+}
+//#endregion
+export { MsgpackDataTransformer };
+//# sourceMappingURL=msgpack.d.cts.map

package/dist/formats/msgpack.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack.d.cts","names":[],"sources":["../../src/formats/msgpack.ts"],"sourcesContent":[],"mappings":";;;;cAOa,sBAAA,YAAkC;EAAlC,OAAA,CAAA,MAAA,EAAA,MAAA,EAAA,IAAuB,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA,GAKZ,MALY,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,EAM/B,WAN+B,GAAA,MAAA,GAAA,SAAA;EAKZ,MAAA,CAAA,CAAA,EAAA,IAAA;EACnB,WAAA,CAAA,KAAA,EAAA,OAAA,CAAA,EAiBiC,YAjBjC,GAAA,SAAA;EAiBiC,SAAA,CAAA,KAAA,EAAA,OAAA,CAAA,EAIF,UAJE;EAIF,YAAA,CAAA,CAAA,EAAA,OAAA"}

package/dist/formats/msgpack.d.mts

@@ -0,0 +1,14 @@
+import { DataChannel, DataTransformer, DataTypeImpl } from "../abstractions.mjs";
+
+//#region src/formats/msgpack.d.ts
+/** Implements {@link DataTransformer} interface for the `msgpack` serialization protocol. */
+declare class MsgpackDataTransformer implements DataTransformer {
+  inspect(source: string, name: string, type: string, metadata?: string | Record<string, unknown>): DataChannel | string | undefined;
+  schema(): void;
+  deserialize(value: unknown): DataTypeImpl | undefined;
+  serialize(value: unknown): Uint8Array;
+  canTransform(): boolean;
+}
+//#endregion
+export { MsgpackDataTransformer };
+//# sourceMappingURL=msgpack.d.mts.map

package/dist/formats/msgpack.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack.d.mts","names":[],"sources":["../../src/formats/msgpack.ts"],"sourcesContent":[],"mappings":";;;;cAOa,sBAAA,YAAkC;EAAlC,OAAA,CAAA,MAAA,EAAA,MAAA,EAAA,IAAuB,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA,GAKZ,MALY,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,EAM/B,WAN+B,GAAA,MAAA,GAAA,SAAA;EAKZ,MAAA,CAAA,CAAA,EAAA,IAAA;EACnB,WAAA,CAAA,KAAA,EAAA,OAAA,CAAA,EAiBiC,YAjBjC,GAAA,SAAA;EAiBiC,SAAA,CAAA,KAAA,EAAA,OAAA,CAAA,EAIF,UAJE;EAIF,YAAA,CAAA,CAAA,EAAA,OAAA"}

package/dist/formats/msgpack.mjs

@@ -0,0 +1,31 @@
+import { toUint8Array } from "../utils.mjs";
+import { decode, encode } from "@msgpack/msgpack";
+
+//#region src/formats/msgpack.ts
+/** Implements {@link DataTransformer} interface for the `msgpack` serialization protocol. */
+var MsgpackDataTransformer = class {
+	inspect(source, name, type, metadata) {
+		if (type === "msgpack") return {
+			source,
+			id: name,
+			dataType: "json",
+			publishedDataType: type,
+			transformer: this,
+			metadata
+		};
+	}
+	schema() {}
+	deserialize(value) {
+		return decode(toUint8Array(value));
+	}
+	serialize(value) {
+		return encode(value);
+	}
+	canTransform() {
+		return true;
+	}
+};
+
+//#endregion
+export { MsgpackDataTransformer };
+//# sourceMappingURL=msgpack.mjs.map

package/dist/formats/msgpack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack.mjs","names":[],"sources":["../../src/formats/msgpack.ts"],"sourcesContent":["import { decode, encode } from \"@msgpack/msgpack\";\n\nimport { toUint8Array } from \"../utils\";\n\nimport type { DataChannel, DataTransformer, DataTypeImpl } from \"../abstractions\";\n\n/** Implements {@link DataTransformer} interface for the `msgpack` serialization protocol. */\nexport class MsgpackDataTransformer implements DataTransformer {\n  public inspect(\n    source: string,\n    name: string,\n    type: string,\n    metadata?: string | Record<string, unknown>\n  ): DataChannel | string | undefined {\n    if (type === \"msgpack\") {\n      return {\n        source,\n        id: name,\n        dataType: \"json\",\n        publishedDataType: type,\n        transformer: this,\n        metadata,\n      };\n    }\n\n    return undefined;\n  }\n\n  public schema() {}\n\n  public deserialize(value: unknown): DataTypeImpl | undefined {\n    return decode(toUint8Array(value)) as DataTypeImpl;\n  }\n\n  public serialize(value: unknown): Uint8Array {\n    return encode(value);\n  }\n\n  public canTransform(): boolean {\n    return true;\n  }\n}\n"],"mappings":";;;;;AAOA,IAAa,yBAAb,MAA+D;CAC7D,AAAO,QACL,QACA,MACA,MACA,UACkC;AAClC,MAAI,SAAS,UACX,QAAO;GACL;GACA,IAAI;GACJ,UAAU;GACV,mBAAmB;GACnB,aAAa;GACb;GACD;;CAML,AAAO,SAAS;CAEhB,AAAO,YAAY,OAA0C;AAC3D,SAAO,OAAO,aAAa,MAAM,CAAC;;CAGpC,AAAO,UAAU,OAA4B;AAC3C,SAAO,OAAO,MAAM;;CAGtB,AAAO,eAAwB;AAC7B,SAAO"}

package/dist/formats/protobuf.cjs

@@ -0,0 +1,130 @@
+const require_utils = require('../utils.cjs');
+let protobufjs = require("protobufjs");
+let protobufjs_ext_descriptor = require("protobufjs/ext/descriptor");
+
+//#region src/formats/protobuf.ts
+const error = (message) => {
+	return new Error(message);
+};
+/**
+* Unpacks protobuf serialized data into JSON object.
+*
+* @param name protobuf descriptor name
+* @param data serialized binary data
+* @param repository repository of available descriptors
+*/
+function unpack(name, data, repository) {
+	return repository.root.lookupType(name).decode(data);
+}
+/**
+* Packs JSON object into serialized protobuf data.
+*
+* @param name protobuf descriptor name
+* @param value JSON object to pack
+* @param repository repository of available descriptors
+* @returns ArrayBuffer containing serialized data
+*/
+function pack(name, value, repository) {
+	return repository.root.lookupType(name).encode(value).finish();
+}
+/** Repository of protobuf descriptors. */
+var ProtobufRepository = class {
+	/**
+	* Root namespace.
+	*/
+	root = new protobufjs.Root();
+	/**
+	* Determines whether type can be transformed, indicating that
+	* the parsed type descriptor is present.
+	*
+	* @param name protobuf descriptor name
+	*/
+	canTransform(name) {
+		try {
+			return this.root.lookupType(name) != null;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Unpacks protobuf serialized data into JSON object.
+	*
+	* @param name protobuf descriptor name
+	* @param data serialized binary data
+	*/
+	unpack(name, data) {
+		return unpack(name, data, this);
+	}
+	/**
+	* Packs JSON object into serialized protobuf data.
+	*
+	* @param name protobuf descriptor name
+	* @param value JSON object to pack
+	*/
+	pack(name, value) {
+		return pack(name, value, this);
+	}
+	/**
+	* Parses protobuf file descriptor and adds it to the repository.
+	*
+	* @param data descriptor binary data
+	*/
+	add(data) {
+		const fd = protobufjs_ext_descriptor.FileDescriptorProto.decode(data);
+		if (fd.name == null) throw error(`Failed to parse protobuf file descriptor: missing name`);
+		if (this.root.files.includes(fd.name)) return;
+		const filePackage = fd.package ? this.root.define(fd.package) : this.root;
+		if (fd.name) {
+			filePackage.filename = fd.name;
+			this.root.files.push(fd.name);
+		}
+		if (fd.messageType) for (const messageType of fd.messageType) filePackage.add(protobufjs.Type.fromDescriptor(messageType, fd.syntax));
+		if (fd.enumType) for (const enumType of fd.enumType) filePackage.add(protobufjs.Enum.fromDescriptor(enumType));
+		if (fd.extension) for (const extension of fd.extension) filePackage.add(protobufjs.Field.fromDescriptor(extension));
+		if (fd.service) for (const service of fd.service) filePackage.add(protobufjs.Service.fromDescriptor(service));
+	}
+};
+/** Implements {@link DataTransformer} interface for the `protobuf` serialization protocol. */
+var ProtobufDataTransformer = class {
+	repo = new ProtobufRepository();
+	inspect(source, name, type, metadata) {
+		if (name.startsWith("/.schema/proto:")) {
+			if (type !== "proto:FileDescriptorProto") throw new Error(`Unexpected type '${type}' for protobuf schema entry`);
+			return name.substring(15);
+		}
+		if (type.startsWith("proto:")) return {
+			source,
+			id: name,
+			dataType: "json",
+			publishedDataType: type,
+			transformer: this,
+			structuredType: {
+				name: type.slice(6),
+				format: "protobuf"
+			},
+			metadata
+		};
+	}
+	schema(typeName, value) {
+		this.repo.add(require_utils.toUint8Array(value));
+	}
+	deserialize(value, type) {
+		if (type == null) throw new Error(`Transformation requires type to be specified. This situation should not be possible if the transformer is wired correctly.`);
+		if (this.repo.canTransform(type.name)) return this.repo.unpack(type.name, require_utils.toUint8Array(value));
+	}
+	serialize(value, type) {
+		if (type == null) throw new Error(`Transformation requires type to be specified. This situation should not be possible if the transformer is wired correctly.`);
+		if (value == null || typeof value !== "object") throw new Error("Only JSON objects can be serialized");
+		if (this.repo.canTransform(type.name)) return this.repo.pack(type.name, value);
+		throw new Error(`Protobuf serialization is not supported for '${type.name}'`);
+	}
+	canTransform(type) {
+		return this.repo.canTransform(type);
+	}
+};
+
+//#endregion
+exports.ProtobufDataTransformer = ProtobufDataTransformer;
+exports.ProtobufRepository = ProtobufRepository;
+exports.pack = pack;
+exports.unpack = unpack;

package/dist/formats/protobuf.d.cts

@@ -0,0 +1,68 @@
+import { DataChannel, DataTransformer, DataTypeImpl, StructuredTypeDescriptor } from "../abstractions.cjs";
+import { Root } from "protobufjs";
+
+//#region src/formats/protobuf.d.ts
+
+/**
+ * Unpacks protobuf serialized data into JSON object.
+ *
+ * @param name protobuf descriptor name
+ * @param data serialized binary data
+ * @param repository repository of available descriptors
+ */
+declare function unpack(name: string, data: Uint8Array<ArrayBufferLike>, repository: ProtobufRepository): Record<string, unknown>;
+/**
+ * Packs JSON object into serialized protobuf data.
+ *
+ * @param name protobuf descriptor name
+ * @param value JSON object to pack
+ * @param repository repository of available descriptors
+ * @returns ArrayBuffer containing serialized data
+ */
+declare function pack(name: string, value: Record<string, unknown>, repository: ProtobufRepository): Uint8Array;
+/** Repository of protobuf descriptors. */
+declare class ProtobufRepository {
+  /**
+   * Root namespace.
+   */
+  root: Root;
+  /**
+   * Determines whether type can be transformed, indicating that
+   * the parsed type descriptor is present.
+   *
+   * @param name protobuf descriptor name
+   */
+  canTransform(name: string): boolean;
+  /**
+   * Unpacks protobuf serialized data into JSON object.
+   *
+   * @param name protobuf descriptor name
+   * @param data serialized binary data
+   */
+  unpack(name: string, data: Uint8Array<ArrayBufferLike>): Record<string, unknown>;
+  /**
+   * Packs JSON object into serialized protobuf data.
+   *
+   * @param name protobuf descriptor name
+   * @param value JSON object to pack
+   */
+  pack(name: string, value: Record<string, unknown>): Uint8Array<ArrayBufferLike>;
+  /**
+   * Parses protobuf file descriptor and adds it to the repository.
+   *
+   * @param data descriptor binary data
+   */
+  add(data: Uint8Array<ArrayBufferLike>): void;
+}
+/** Implements {@link DataTransformer} interface for the `protobuf` serialization protocol. */
+declare class ProtobufDataTransformer implements DataTransformer {
+  private readonly repo;
+  inspect(source: string, name: string, type: string, metadata?: string | Record<string, unknown>): DataChannel | string | undefined;
+  schema(typeName: string, value: unknown): void;
+  deserialize(value: unknown, type?: StructuredTypeDescriptor): DataTypeImpl | undefined;
+  serialize(value: unknown, type?: StructuredTypeDescriptor): Uint8Array;
+  canTransform(type: string): boolean;
+}
+//#endregion
+export { ProtobufDataTransformer, ProtobufRepository, pack, unpack };
+//# sourceMappingURL=protobuf.d.cts.map

package/dist/formats/protobuf.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf.d.cts","names":[],"sources":["../../src/formats/protobuf.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqBA;;;;;AAIS,iBAJO,MAAA,CAIP,IAAA,EAAA,MAAA,EAAA,IAAA,EAFD,UAEC,CAFU,eAEV,CAAA,EAAA,UAAA,EADK,kBACL,CAAA,EAAN,MAAM,CAAA,MAAA,EAAA,OAAA,CAAA;AAYT;;;;;AAMA;;;AA0BoC,iBAhCpB,IAAA,CAgCoB,IAAA,EAAA,MAAA,EAAA,KAAA,EAhCM,MAgCN,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,UAAA,EAhC2C,kBAgC3C,CAAA,EAhCgE,UAgChE;;AAUD,cApCtB,kBAAA,CAoCsB;EAAuB;;;EASvC,IAAA,EAzCN,IAyCM;EAAU;AAkD7B;;;;;EAqD0C,YAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA;EAA2B;;;;;;6BA1HjC,WAAW,mBAAgB;;;;;;;4BAU5B,0BAAuB,WAAA;;;;;;YASvC,WAAW;;;cAkDjB,uBAAA,YAAmC;;0EAOxB,0BACnB;;qCA+BuC,2BAA2B;mCAc7B,2BAA2B"}

package/dist/formats/protobuf.d.mts

@@ -0,0 +1,68 @@
+import { DataChannel, DataTransformer, DataTypeImpl, StructuredTypeDescriptor } from "../abstractions.mjs";
+import { Root } from "protobufjs";
+
+//#region src/formats/protobuf.d.ts
+
+/**
+ * Unpacks protobuf serialized data into JSON object.
+ *
+ * @param name protobuf descriptor name
+ * @param data serialized binary data
+ * @param repository repository of available descriptors
+ */
+declare function unpack(name: string, data: Uint8Array<ArrayBufferLike>, repository: ProtobufRepository): Record<string, unknown>;
+/**
+ * Packs JSON object into serialized protobuf data.
+ *
+ * @param name protobuf descriptor name
+ * @param value JSON object to pack
+ * @param repository repository of available descriptors
+ * @returns ArrayBuffer containing serialized data
+ */
+declare function pack(name: string, value: Record<string, unknown>, repository: ProtobufRepository): Uint8Array;
+/** Repository of protobuf descriptors. */
+declare class ProtobufRepository {
+  /**
+   * Root namespace.
+   */
+  root: Root;
+  /**
+   * Determines whether type can be transformed, indicating that
+   * the parsed type descriptor is present.
+   *
+   * @param name protobuf descriptor name
+   */
+  canTransform(name: string): boolean;
+  /**
+   * Unpacks protobuf serialized data into JSON object.
+   *
+   * @param name protobuf descriptor name
+   * @param data serialized binary data
+   */
+  unpack(name: string, data: Uint8Array<ArrayBufferLike>): Record<string, unknown>;
+  /**
+   * Packs JSON object into serialized protobuf data.
+   *
+   * @param name protobuf descriptor name
+   * @param value JSON object to pack
+   */
+  pack(name: string, value: Record<string, unknown>): Uint8Array<ArrayBufferLike>;
+  /**
+   * Parses protobuf file descriptor and adds it to the repository.
+   *
+   * @param data descriptor binary data
+   */
+  add(data: Uint8Array<ArrayBufferLike>): void;
+}
+/** Implements {@link DataTransformer} interface for the `protobuf` serialization protocol. */
+declare class ProtobufDataTransformer implements DataTransformer {
+  private readonly repo;
+  inspect(source: string, name: string, type: string, metadata?: string | Record<string, unknown>): DataChannel | string | undefined;
+  schema(typeName: string, value: unknown): void;
+  deserialize(value: unknown, type?: StructuredTypeDescriptor): DataTypeImpl | undefined;
+  serialize(value: unknown, type?: StructuredTypeDescriptor): Uint8Array;
+  canTransform(type: string): boolean;
+}
+//#endregion
+export { ProtobufDataTransformer, ProtobufRepository, pack, unpack };
+//# sourceMappingURL=protobuf.d.mts.map

package/dist/formats/protobuf.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf.d.mts","names":[],"sources":["../../src/formats/protobuf.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqBA;;;;;AAIS,iBAJO,MAAA,CAIP,IAAA,EAAA,MAAA,EAAA,IAAA,EAFD,UAEC,CAFU,eAEV,CAAA,EAAA,UAAA,EADK,kBACL,CAAA,EAAN,MAAM,CAAA,MAAA,EAAA,OAAA,CAAA;AAYT;;;;;AAMA;;;AA0BoC,iBAhCpB,IAAA,CAgCoB,IAAA,EAAA,MAAA,EAAA,KAAA,EAhCM,MAgCN,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,UAAA,EAhC2C,kBAgC3C,CAAA,EAhCgE,UAgChE;;AAUD,cApCtB,kBAAA,CAoCsB;EAAuB;;;EASvC,IAAA,EAzCN,IAyCM;EAAU;AAkD7B;;;;;EAqD0C,YAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA;EAA2B;;;;;;6BA1HjC,WAAW,mBAAgB;;;;;;;4BAU5B,0BAAuB,WAAA;;;;;;YASvC,WAAW;;;cAkDjB,uBAAA,YAAmC;;0EAOxB,0BACnB;;qCA+BuC,2BAA2B;mCAc7B,2BAA2B"}

package/dist/formats/protobuf.mjs

@@ -0,0 +1,128 @@
+import { toUint8Array } from "../utils.mjs";
+import { Enum, Field, Root, Service, Type } from "protobufjs";
+import { FileDescriptorProto } from "protobufjs/ext/descriptor";
+
+//#region src/formats/protobuf.ts
+const error = (message) => {
+	return new Error(message);
+};
+/**
+* Unpacks protobuf serialized data into JSON object.
+*
+* @param name protobuf descriptor name
+* @param data serialized binary data
+* @param repository repository of available descriptors
+*/
+function unpack(name, data, repository) {
+	return repository.root.lookupType(name).decode(data);
+}
+/**
+* Packs JSON object into serialized protobuf data.
+*
+* @param name protobuf descriptor name
+* @param value JSON object to pack
+* @param repository repository of available descriptors
+* @returns ArrayBuffer containing serialized data
+*/
+function pack(name, value, repository) {
+	return repository.root.lookupType(name).encode(value).finish();
+}
+/** Repository of protobuf descriptors. */
+var ProtobufRepository = class {
+	/**
+	* Root namespace.
+	*/
+	root = new Root();
+	/**
+	* Determines whether type can be transformed, indicating that
+	* the parsed type descriptor is present.
+	*
+	* @param name protobuf descriptor name
+	*/
+	canTransform(name) {
+		try {
+			return this.root.lookupType(name) != null;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Unpacks protobuf serialized data into JSON object.
+	*
+	* @param name protobuf descriptor name
+	* @param data serialized binary data
+	*/
+	unpack(name, data) {
+		return unpack(name, data, this);
+	}
+	/**
+	* Packs JSON object into serialized protobuf data.
+	*
+	* @param name protobuf descriptor name
+	* @param value JSON object to pack
+	*/
+	pack(name, value) {
+		return pack(name, value, this);
+	}
+	/**
+	* Parses protobuf file descriptor and adds it to the repository.
+	*
+	* @param data descriptor binary data
+	*/
+	add(data) {
+		const fd = FileDescriptorProto.decode(data);
+		if (fd.name == null) throw error(`Failed to parse protobuf file descriptor: missing name`);
+		if (this.root.files.includes(fd.name)) return;
+		const filePackage = fd.package ? this.root.define(fd.package) : this.root;
+		if (fd.name) {
+			filePackage.filename = fd.name;
+			this.root.files.push(fd.name);
+		}
+		if (fd.messageType) for (const messageType of fd.messageType) filePackage.add(Type.fromDescriptor(messageType, fd.syntax));
+		if (fd.enumType) for (const enumType of fd.enumType) filePackage.add(Enum.fromDescriptor(enumType));
+		if (fd.extension) for (const extension of fd.extension) filePackage.add(Field.fromDescriptor(extension));
+		if (fd.service) for (const service of fd.service) filePackage.add(Service.fromDescriptor(service));
+	}
+};
+/** Implements {@link DataTransformer} interface for the `protobuf` serialization protocol. */
+var ProtobufDataTransformer = class {
+	repo = new ProtobufRepository();
+	inspect(source, name, type, metadata) {
+		if (name.startsWith("/.schema/proto:")) {
+			if (type !== "proto:FileDescriptorProto") throw new Error(`Unexpected type '${type}' for protobuf schema entry`);
+			return name.substring(15);
+		}
+		if (type.startsWith("proto:")) return {
+			source,
+			id: name,
+			dataType: "json",
+			publishedDataType: type,
+			transformer: this,
+			structuredType: {
+				name: type.slice(6),
+				format: "protobuf"
+			},
+			metadata
+		};
+	}
+	schema(typeName, value) {
+		this.repo.add(toUint8Array(value));
+	}
+	deserialize(value, type) {
+		if (type == null) throw new Error(`Transformation requires type to be specified. This situation should not be possible if the transformer is wired correctly.`);
+		if (this.repo.canTransform(type.name)) return this.repo.unpack(type.name, toUint8Array(value));
+	}
+	serialize(value, type) {
+		if (type == null) throw new Error(`Transformation requires type to be specified. This situation should not be possible if the transformer is wired correctly.`);
+		if (value == null || typeof value !== "object") throw new Error("Only JSON objects can be serialized");
+		if (this.repo.canTransform(type.name)) return this.repo.pack(type.name, value);
+		throw new Error(`Protobuf serialization is not supported for '${type.name}'`);
+	}
+	canTransform(type) {
+		return this.repo.canTransform(type);
+	}
+};
+
+//#endregion
+export { ProtobufDataTransformer, ProtobufRepository, pack, unpack };
+//# sourceMappingURL=protobuf.mjs.map

package/dist/formats/protobuf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf.mjs","names":[],"sources":["../../src/formats/protobuf.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-ts-comment */\n\nimport { Enum, Field, Root, Service, Type } from \"protobufjs\";\nimport { FileDescriptorProto } from \"protobufjs/ext/descriptor\";\n\nimport { toUint8Array } from \"../utils\";\n\nimport type { IFileDescriptorProto } from \"protobufjs/ext/descriptor\";\nimport type { DataChannel, DataTransformer, DataTypeImpl, StructuredTypeDescriptor } from \"../abstractions\";\n\nconst error = (message: string) => {\n  return new Error(message);\n};\n\n/**\n * Unpacks protobuf serialized data into JSON object.\n *\n * @param name protobuf descriptor name\n * @param data serialized binary data\n * @param repository repository of available descriptors\n */\nexport function unpack(\n  name: string,\n  data: Uint8Array<ArrayBufferLike>,\n  repository: ProtobufRepository\n): Record<string, unknown> {\n  const type = repository.root.lookupType(name); // throws on error\n  return type.decode(data) as unknown as Record<string, unknown>;\n}\n/**\n * Packs JSON object into serialized protobuf data.\n *\n * @param name protobuf descriptor name\n * @param value JSON object to pack\n * @param repository repository of available descriptors\n * @returns ArrayBuffer containing serialized data\n */\nexport function pack(name: string, value: Record<string, unknown>, repository: ProtobufRepository): Uint8Array {\n  const type = repository.root.lookupType(name); // throws on error\n  return type.encode(value).finish();\n}\n\n/** Repository of protobuf descriptors. */\nexport class ProtobufRepository {\n  /**\n   * Root namespace.\n   */\n  public root = new Root();\n\n  /**\n   * Determines whether type can be transformed, indicating that\n   * the parsed type descriptor is present.\n   *\n   * @param name protobuf descriptor name\n   */\n  public canTransform(name: string) {\n    try {\n      return this.root.lookupType(name) != null;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Unpacks protobuf serialized data into JSON object.\n   *\n   * @param name protobuf descriptor name\n   * @param data serialized binary data\n   */\n  public unpack(name: string, data: Uint8Array<ArrayBufferLike>) {\n    return unpack(name, data, this);\n  }\n\n  /**\n   * Packs JSON object into serialized protobuf data.\n   *\n   * @param name protobuf descriptor name\n   * @param value JSON object to pack\n   */\n  public pack(name: string, value: Record<string, unknown>) {\n    return pack(name, value, this);\n  }\n\n  /**\n   * Parses protobuf file descriptor and adds it to the repository.\n   *\n   * @param data descriptor binary data\n   */\n  public add(data: Uint8Array<ArrayBufferLike>): void {\n    const fd = FileDescriptorProto.decode(data) as IFileDescriptorProto;\n    if (fd.name == null) {\n      throw error(`Failed to parse protobuf file descriptor: missing name`);\n    }\n\n    // ignore duplicates\n    if (this.root.files.includes(fd.name)) {\n      return;\n      // throw error(`Failed to parse protobuf file descriptor: duplicate '${fd.name}' filename`);\n    }\n\n    const filePackage = fd.package ? this.root.define(fd.package) : this.root;\n\n    if (fd.name) {\n      filePackage.filename = fd.name;\n      this.root.files.push(fd.name);\n    }\n\n    if (fd.messageType) {\n      for (const messageType of fd.messageType) {\n        // @ts-expect-error\n        filePackage.add(Type.fromDescriptor(messageType, fd.syntax));\n      }\n    }\n\n    if (fd.enumType) {\n      for (const enumType of fd.enumType) {\n        // @ts-expect-error\n        filePackage.add(Enum.fromDescriptor(enumType));\n      }\n    }\n\n    if (fd.extension) {\n      for (const extension of fd.extension) {\n        // @ts-expect-error\n        filePackage.add(Field.fromDescriptor(extension));\n      }\n    }\n\n    if (fd.service) {\n      for (const service of fd.service) {\n        // @ts-expect-error\n        filePackage.add(Service.fromDescriptor(service));\n      }\n    }\n  }\n}\n\n/** Implements {@link DataTransformer} interface for the `protobuf` serialization protocol. */\nexport class ProtobufDataTransformer implements DataTransformer {\n  private readonly repo = new ProtobufRepository();\n\n  public inspect(\n    source: string,\n    name: string,\n    type: string,\n    metadata?: string | Record<string, unknown>\n  ): DataChannel | string | undefined {\n    if (name.startsWith(\"/.schema/proto:\")) {\n      if (type !== \"proto:FileDescriptorProto\") {\n        throw new Error(`Unexpected type '${type}' for protobuf schema entry`);\n      }\n\n      return name.substring(15);\n    }\n\n    if (type.startsWith(\"proto:\")) {\n      return {\n        source,\n        id: name,\n        dataType: \"json\",\n        publishedDataType: type,\n        transformer: this,\n        structuredType: {\n          name: type.slice(6),\n          format: \"protobuf\",\n        },\n        metadata,\n      };\n    }\n\n    return undefined;\n  }\n\n  public schema(typeName: string, value: unknown) {\n    this.repo.add(toUint8Array(value));\n  }\n\n  public deserialize(value: unknown, type?: StructuredTypeDescriptor): DataTypeImpl | undefined {\n    if (type == null) {\n      throw new Error(\n        `Transformation requires type to be specified. This situation should not be possible if the transformer is wired correctly.`\n      );\n    }\n\n    if (this.repo.canTransform(type.name)) {\n      return this.repo.unpack(type.name, toUint8Array(value));\n    }\n\n    return undefined;\n  }\n\n  public serialize(value: unknown, type?: StructuredTypeDescriptor): Uint8Array {\n    if (type == null) {\n      throw new Error(\n        `Transformation requires type to be specified. This situation should not be possible if the transformer is wired correctly.`\n      );\n    }\n\n    if (value == null || typeof value !== \"object\") {\n      throw new Error(\"Only JSON objects can be serialized\");\n    }\n\n    if (this.repo.canTransform(type.name)) {\n      return this.repo.pack(type.name, value as Record<string, unknown>);\n    }\n\n    throw new Error(`Protobuf serialization is not supported for '${type.name}'`);\n  }\n\n  public canTransform(type: string): boolean {\n    return this.repo.canTransform(type);\n  }\n}\n"],"mappings":"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"}