@alepha/protobuf 0.11.8 → 0.11.10

package/dist/index.cjs

@@ -0,0 +1,305 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __alepha_core = require("@alepha/core");
+let protobufjs = require("protobufjs");
+protobufjs = __toESM(protobufjs);
+require("@alepha/datetime");
+
+//#region src/providers/ProtobufProvider.ts
+var ProtobufProvider = class {
+	alepha = (0, __alepha_core.$inject)(__alepha_core.Alepha);
+	schemas = /* @__PURE__ */ new Map();
+	protobuf = protobufjs.default;
+	enumDefinitions = /* @__PURE__ */ new Map();
+	/**
+	* Encode an object to a Uint8Array.
+	*/
+	encode(schema, message) {
+		return this.parse(schema).encode(message).finish();
+	}
+	/**
+	* Decode a Uint8Array to an object.
+	*/
+	decode(schema, data) {
+		return this.parse(schema).decode(data);
+	}
+	/**
+	* Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.
+	*/
+	parse(schema, typeName = "root.Target") {
+		const exists = this.schemas.get(schema);
+		if (exists) return exists;
+		const type = this.protobuf.parse(schema).root.lookupType(typeName);
+		this.schemas.set(schema, type);
+		return type;
+	}
+	/**
+	* Convert a TypeBox schema to a Protobuf schema as a string.
+	*/
+	createProtobufSchema(schema, options = {}) {
+		const { rootName = "root", mainMessageName = "Target" } = options;
+		this.enumDefinitions.clear();
+		const context = {
+			proto: `package ${rootName};\nsyntax = "proto3";\n\n`,
+			fieldIndex: 1
+		};
+		if (__alepha_core.t.schema.isObject(schema)) {
+			const { message, subMessages } = this.parseObjectWithDependencies(schema, mainMessageName);
+			for (const [enumName, values] of this.enumDefinitions) context.proto += this.generateEnumDefinition(enumName, values);
+			context.proto += subMessages.join("");
+			context.proto += message;
+		}
+		return context.proto;
+	}
+	/**
+	* Parse an object schema with dependencies (sub-messages).
+	*/
+	parseObjectWithDependencies(obj, parentName) {
+		if (!__alepha_core.t.schema.isObject(obj)) return {
+			message: "",
+			subMessages: []
+		};
+		const fields = [];
+		const subMessages = [];
+		let fieldIndex = 1;
+		for (const [key, value] of Object.entries(obj.properties)) {
+			if (__alepha_core.t.schema.isArray(value)) {
+				if (this.isEnum(value.items)) {
+					const enumValues = this.getEnumValues(value.items);
+					const enumName = this.registerEnum(key, enumValues);
+					fields.push(`  repeated ${enumName} ${key} = ${fieldIndex++};`);
+					continue;
+				}
+				if (__alepha_core.t.schema.isObject(value.items)) {
+					const subMessageName = "title" in value.items && typeof value.items.title === "string" ? value.items.title : `${parentName}_${key}`;
+					const { message: subMessage, subMessages: nestedSubMessages } = this.parseObjectWithDependencies(value.items, subMessageName);
+					subMessages.push(...nestedSubMessages);
+					subMessages.push(subMessage);
+					fields.push(`  repeated ${subMessageName} ${key} = ${fieldIndex++};`);
+					continue;
+				}
+				const itemType = this.convertType(value.items);
+				fields.push(`  repeated ${itemType} ${key} = ${fieldIndex++};`);
+				continue;
+			}
+			if (__alepha_core.t.schema.isObject(value)) {
+				const subMessageName = "title" in value && typeof value.title === "string" ? value.title : `${parentName}_${key}`;
+				const { message: subMessage, subMessages: nestedSubMessages } = this.parseObjectWithDependencies(value, subMessageName);
+				subMessages.push(...nestedSubMessages);
+				subMessages.push(subMessage);
+				fields.push(`  ${subMessageName} ${key} = ${fieldIndex++};`);
+				continue;
+			}
+			if (__alepha_core.t.schema.isUnion(value)) {
+				const nonNullType = value.anyOf.find((type) => !__alepha_core.t.schema.isNull(type));
+				if (nonNullType) {
+					if (this.isEnum(nonNullType)) {
+						const enumValues = this.getEnumValues(nonNullType);
+						const enumName = this.registerEnum(key, enumValues);
+						fields.push(`  ${enumName} ${key} = ${fieldIndex++};`);
+						continue;
+					}
+					if (__alepha_core.t.schema.isObject(nonNullType)) {
+						const subMessageName = "title" in nonNullType && typeof nonNullType.title === "string" ? nonNullType.title : `${parentName}_${key}`;
+						const { message: subMessage, subMessages: nestedSubMessages } = this.parseObjectWithDependencies(nonNullType, subMessageName);
+						subMessages.push(...nestedSubMessages);
+						subMessages.push(subMessage);
+						fields.push(`  ${subMessageName} ${key} = ${fieldIndex++};`);
+						continue;
+					}
+					const fieldType$1 = this.convertType(nonNullType);
+					fields.push(`  ${fieldType$1} ${key} = ${fieldIndex++};`);
+					continue;
+				}
+			}
+			if (__alepha_core.t.schema.isRecord(value)) {
+				let valueSchema;
+				if ("additionalProperties" in value && value.additionalProperties && typeof value.additionalProperties === "object") valueSchema = value.additionalProperties;
+				else if (value.patternProperties && typeof value.patternProperties === "object") {
+					const patterns = Object.values(value.patternProperties);
+					if (patterns.length > 0 && typeof patterns[0] === "object") valueSchema = patterns[0];
+				}
+				if (valueSchema) {
+					const valueType = this.convertType(valueSchema);
+					fields.push(`  map<string, ${valueType}> ${key} = ${fieldIndex++};`);
+					continue;
+				}
+			}
+			if (this.isEnum(value)) {
+				const enumValues = this.getEnumValues(value);
+				const enumName = this.registerEnum(key, enumValues);
+				fields.push(`  ${enumName} ${key} = ${fieldIndex++};`);
+				continue;
+			}
+			const fieldType = this.convertType(value);
+			fields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);
+		}
+		return {
+			message: `message ${parentName} {\n${fields.join("\n")}\n}\n`,
+			subMessages
+		};
+	}
+	/**
+	* Convert a primitive TypeBox schema type to a Protobuf spec type.
+	*/
+	convertType(schema) {
+		if (__alepha_core.t.schema.isBoolean(schema)) return "bool";
+		if (__alepha_core.t.schema.isNumber(schema) && schema.format === "int64") return "int64";
+		if (__alepha_core.t.schema.isNumber(schema)) return "double";
+		if (__alepha_core.t.schema.isInteger(schema)) return "int32";
+		if (__alepha_core.t.schema.isBigInt(schema)) return "int64";
+		if (__alepha_core.t.schema.isString(schema)) return "string";
+		if (__alepha_core.t.schema.isUnion(schema)) {
+			const nonNullType = schema.anyOf.find((type) => !__alepha_core.t.schema.isNull(type));
+			if (nonNullType) return this.convertType(nonNullType);
+		}
+		if (__alepha_core.t.schema.isOptional(schema)) return this.convertType(schema);
+		if (__alepha_core.t.schema.isUnsafe(schema)) return "string";
+		throw new Error(`Unsupported type: ${JSON.stringify(schema)}`);
+	}
+	/**
+	* Check if a schema is an enum type.
+	* TypeBox enums have an "enum" property with an array of values.
+	*/
+	isEnum(schema) {
+		return "enum" in schema && Array.isArray(schema.enum);
+	}
+	/**
+	* Extract enum values from a TypeBox enum schema.
+	*/
+	getEnumValues(schema) {
+		if ("enum" in schema && Array.isArray(schema.enum)) return schema.enum.map(String);
+		return [];
+	}
+	/**
+	* Register an enum and return its type name.
+	* Generates a PascalCase name from the field name.
+	*/
+	registerEnum(fieldName, values) {
+		const enumName = fieldName.charAt(0).toUpperCase() + fieldName.slice(1);
+		const valueKey = values.join(",");
+		const existingEnum = Array.from(this.enumDefinitions.entries()).find(([_, enumValues]) => enumValues.join(",") === valueKey);
+		if (existingEnum) return existingEnum[0];
+		this.enumDefinitions.set(enumName, values);
+		return enumName;
+	}
+	/**
+	* Generate a protobuf enum definition.
+	*/
+	generateEnumDefinition(enumName, values) {
+		return `enum ${enumName} {\n${values.map((value, index) => `  ${value} = ${index};`).join("\n")}\n}\n`;
+	}
+};
+
+//#endregion
+//#region src/providers/ProtobufSchemaCodec.ts
+/**
+* ProtobufSchemaCodec handles encoding/decoding for Protobuf format.
+*
+* Key differences from JSON codec:
+* - BigInt values are kept as BigInt (not converted to string)
+* - Date values are converted to ISO strings for protobuf compatibility
+* - Binary data (Uint8Array) is kept as-is
+* - Proto3 default values are applied when decoding (to handle omitted fields)
+*/
+var ProtobufSchemaCodec = class extends __alepha_core.SchemaCodec {
+	protobufProvider = (0, __alepha_core.$inject)(ProtobufProvider);
+	decoder = new TextDecoder();
+	encodeToString(schema, value) {
+		const binary = this.encodeToBinary(schema, value);
+		if (typeof Buffer !== "undefined") return Buffer.from(binary).toString("base64");
+		else return btoa(String.fromCharCode(...binary));
+	}
+	encodeToBinary(schema, value) {
+		const proto = this.protobufProvider.createProtobufSchema(schema);
+		return this.protobufProvider.encode(proto, value);
+	}
+	decode(schema, value) {
+		const proto = this.protobufProvider.createProtobufSchema(schema);
+		if (value instanceof Uint8Array) return this.applyProto3Defaults(schema, this.protobufProvider.decode(proto, value));
+		if (typeof value === "string") return this.applyProto3Defaults(schema, this.protobufProvider.decode(proto, typeof Buffer !== "undefined" ? Uint8Array.from(Buffer.from(value, "base64")) : Uint8Array.from(atob(value).split("").map((c) => c.charCodeAt(0)))));
+		throw new __alepha_core.AlephaError(`Unsupported value type for Protobuf decoding: ${typeof value}`);
+	}
+	/**
+	* Apply proto3 default values for fields that were omitted during encoding.
+	* Proto3 omits fields with default values, so we need to restore them.
+	* Also converts enum integers back to their string values.
+	*/
+	applyProto3Defaults(schema, value) {
+		if (!value || typeof value !== "object") return value;
+		if (__alepha_core.t.schema.isObject(schema)) {
+			const result = { ...value };
+			for (const [key, propSchema] of Object.entries(schema.properties)) if (!(key in result) || result[key] === void 0) result[key] = this.getProto3Default(propSchema);
+			else if (this.isEnum(propSchema)) result[key] = this.convertEnumValue(propSchema, result[key]);
+			else if (typeof result[key] === "object" && result[key] !== null) result[key] = this.applyProto3Defaults(propSchema, result[key]);
+			return result;
+		}
+		if (__alepha_core.t.schema.isArray(schema) && Array.isArray(value)) return value.map((item) => this.applyProto3Defaults(schema.items, item));
+		return value;
+	}
+	/**
+	* Check if a schema is an enum type.
+	*/
+	isEnum(schema) {
+		return "enum" in schema && Array.isArray(schema.enum);
+	}
+	/**
+	* Convert an enum value from protobuf integer to TypeBox string.
+	*/
+	convertEnumValue(schema, value) {
+		if (typeof value === "number" && "enum" in schema && Array.isArray(schema.enum)) return schema.enum[value];
+		return value;
+	}
+	/**
+	* Get the proto3 default value for a schema type.
+	*/
+	getProto3Default(schema) {
+		if (__alepha_core.t.schema.isOptional(schema) || __alepha_core.t.schema.isUnion(schema)) return;
+		if (__alepha_core.t.schema.isArray(schema)) return [];
+		if (__alepha_core.t.schema.isRecord(schema)) return {};
+		if (__alepha_core.t.schema.isString(schema)) return "";
+		if (__alepha_core.t.schema.isNumber(schema)) return 0;
+		if (__alepha_core.t.schema.isInteger(schema)) return 0;
+		if (__alepha_core.t.schema.isBigInt(schema)) return BigInt(0);
+		if (__alepha_core.t.schema.isBoolean(schema)) return false;
+		if (__alepha_core.t.schema.isObject(schema)) return {};
+	}
+};
+
+//#endregion
+//#region src/index.ts
+const AlephaProtobuf = (0, __alepha_core.$module)({
+	name: "alepha.protobuf",
+	services: [ProtobufProvider, ProtobufSchemaCodec],
+	register: (alepha) => {
+		alepha.with(ProtobufProvider);
+		alepha.codec.register("protobuf", alepha.inject(ProtobufSchemaCodec));
+	}
+});
+
+//#endregion
+exports.AlephaProtobuf = AlephaProtobuf;
+exports.ProtobufProvider = ProtobufProvider;
+exports.ProtobufSchemaCodec = ProtobufSchemaCodec;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Alepha","t","fields: string[]","subMessages: string[]","fieldType","valueSchema: TSchema | undefined","SchemaCodec","AlephaError","t","result: any"],"sources":["../src/providers/ProtobufProvider.ts","../src/providers/ProtobufSchemaCodec.ts","../src/index.ts"],"sourcesContent":["import { $inject, Alepha, type TObject, type TSchema, t } from \"@alepha/core\";\nimport type { Type } from \"protobufjs\";\nimport protobufjs from \"protobufjs\";\n\nexport class ProtobufProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly schemas: Map<string | TObject, Type> = new Map();\n  protected readonly protobuf: typeof protobufjs = protobufjs;\n  protected readonly enumDefinitions: Map<string, string[]> = new Map();\n\n  /**\n   * Encode an object to a Uint8Array.\n   */\n  public encode(schema: ProtobufSchema, message: any): Uint8Array {\n    return this.parse(schema).encode(message).finish();\n  }\n\n  /**\n   * Decode a Uint8Array to an object.\n   */\n  public decode<T = any>(schema: ProtobufSchema, data: Uint8Array): T {\n    return this.parse(schema).decode(data) as T;\n  }\n\n  /**\n   * Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.\n   */\n  public parse(schema: ProtobufSchema, typeName = \"root.Target\"): Type {\n    const exists = this.schemas.get(schema);\n    if (exists) {\n      return exists;\n    }\n\n    const result = this.protobuf.parse(schema);\n    const type = result.root.lookupType(typeName);\n    this.schemas.set(schema, type);\n    return type;\n  }\n\n  /**\n   * Convert a TypeBox schema to a Protobuf schema as a string.\n   */\n  public createProtobufSchema(\n    schema: TSchema,\n    options: CreateProtobufSchemaOptions = {},\n  ): string {\n    const { rootName = \"root\", mainMessageName = \"Target\" } = options;\n    // Clear enum definitions for this schema generation\n    this.enumDefinitions.clear();\n\n    const context = {\n      proto: `package ${rootName};\\nsyntax = \"proto3\";\\n\\n`,\n      fieldIndex: 1,\n    };\n\n    if (t.schema.isObject(schema)) {\n      const { message, subMessages } = this.parseObjectWithDependencies(\n        schema,\n        mainMessageName,\n      );\n\n      // Add all enum definitions first\n      for (const [enumName, values] of this.enumDefinitions) {\n        context.proto += this.generateEnumDefinition(enumName, values);\n      }\n\n      // Add all sub-messages\n      context.proto += subMessages.join(\"\");\n      // Then add the main message\n      context.proto += message;\n    }\n\n    return context.proto;\n  }\n\n  /**\n   * Parse an object schema with dependencies (sub-messages).\n   */\n  protected parseObjectWithDependencies(\n    obj: TSchema,\n    parentName: string,\n  ): { message: string; subMessages: string[] } {\n    if (!t.schema.isObject(obj)) {\n      return { message: \"\", subMessages: [] };\n    }\n\n    const fields: string[] = [];\n    const subMessages: string[] = [];\n    let fieldIndex = 1;\n\n    for (const [key, value] of Object.entries(obj.properties)) {\n      // Handle arrays\n      if (t.schema.isArray(value)) {\n        // Check if array items are enums\n        if (this.isEnum(value.items)) {\n          const enumValues = this.getEnumValues(value.items);\n          const enumName = this.registerEnum(key, enumValues);\n          fields.push(`  repeated ${enumName} ${key} = ${fieldIndex++};`);\n          continue;\n        }\n\n        if (t.schema.isObject(value.items)) {\n          const subMessageName =\n            \"title\" in value.items && typeof value.items.title === \"string\"\n              ? value.items.title\n              : `${parentName}_${key}`;\n          const { message: subMessage, subMessages: nestedSubMessages } =\n            this.parseObjectWithDependencies(value.items, subMessageName);\n          subMessages.push(...nestedSubMessages);\n          subMessages.push(subMessage);\n          fields.push(`  repeated ${subMessageName} ${key} = ${fieldIndex++};`);\n          continue;\n        }\n\n        const itemType = this.convertType(value.items);\n        fields.push(`  repeated ${itemType} ${key} = ${fieldIndex++};`);\n        continue;\n      }\n\n      // Handle nested objects\n      if (t.schema.isObject(value)) {\n        const subMessageName =\n          \"title\" in value && typeof value.title === \"string\"\n            ? value.title\n            : `${parentName}_${key}`;\n        const { message: subMessage, subMessages: nestedSubMessages } =\n          this.parseObjectWithDependencies(value, subMessageName);\n        subMessages.push(...nestedSubMessages);\n        subMessages.push(subMessage);\n        fields.push(`  ${subMessageName} ${key} = ${fieldIndex++};`);\n        continue;\n      }\n\n      // Handle union types (nullable fields)\n      if (t.schema.isUnion(value)) {\n        const nonNullType = value.anyOf.find(\n          (type: TSchema) => !t.schema.isNull(type),\n        );\n        if (nonNullType) {\n          // Check if it's an enum\n          if (this.isEnum(nonNullType)) {\n            const enumValues = this.getEnumValues(nonNullType);\n            const enumName = this.registerEnum(key, enumValues);\n            fields.push(`  ${enumName} ${key} = ${fieldIndex++};`);\n            continue;\n          }\n\n          if (t.schema.isObject(nonNullType)) {\n            const subMessageName =\n              \"title\" in nonNullType && typeof nonNullType.title === \"string\"\n                ? nonNullType.title\n                : `${parentName}_${key}`;\n            const { message: subMessage, subMessages: nestedSubMessages } =\n              this.parseObjectWithDependencies(nonNullType, subMessageName);\n            subMessages.push(...nestedSubMessages);\n            subMessages.push(subMessage);\n            fields.push(`  ${subMessageName} ${key} = ${fieldIndex++};`);\n            continue;\n          }\n          const fieldType = this.convertType(nonNullType);\n          fields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);\n          continue;\n        }\n      }\n\n      // Handle records (maps)\n      if (t.schema.isRecord(value)) {\n        // TypeBox records use additionalProperties or patternProperties for the value type\n        let valueSchema: TSchema | undefined;\n        if (\n          \"additionalProperties\" in value &&\n          value.additionalProperties &&\n          typeof value.additionalProperties === \"object\"\n        ) {\n          valueSchema = value.additionalProperties;\n        } else if (\n          value.patternProperties &&\n          typeof value.patternProperties === \"object\"\n        ) {\n          // Get the first pattern property (usually \"^(.*)$\" or similar)\n          const patterns = Object.values(value.patternProperties);\n          if (patterns.length > 0 && typeof patterns[0] === \"object\") {\n            valueSchema = patterns[0] as TSchema;\n          }\n        }\n\n        if (valueSchema) {\n          const valueType = this.convertType(valueSchema);\n          fields.push(`  map<string, ${valueType}> ${key} = ${fieldIndex++};`);\n          continue;\n        }\n      }\n\n      // Handle enum fields\n      if (this.isEnum(value)) {\n        const enumValues = this.getEnumValues(value);\n        const enumName = this.registerEnum(key, enumValues);\n        fields.push(`  ${enumName} ${key} = ${fieldIndex++};`);\n        continue;\n      }\n\n      // Handle regular fields\n      const fieldType = this.convertType(value);\n      fields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);\n    }\n\n    const message = `message ${parentName} {\\n${fields.join(\"\\n\")}\\n}\\n`;\n    return { message, subMessages };\n  }\n\n  /**\n   * Convert a primitive TypeBox schema type to a Protobuf spec type.\n   */\n  protected convertType(schema: TSchema): string {\n    if (t.schema.isBoolean(schema)) return \"bool\";\n    if (t.schema.isNumber(schema) && schema.format === \"int64\") return \"int64\";\n    if (t.schema.isNumber(schema)) return \"double\";\n    if (t.schema.isInteger(schema)) return \"int32\";\n    if (t.schema.isBigInt(schema)) return \"int64\";\n    if (t.schema.isString(schema)) return \"string\";\n\n    // Handle union types (nullable)\n    if (t.schema.isUnion(schema)) {\n      // Find the non-null type in the union\n      const nonNullType = schema.anyOf.find(\n        (type: TSchema) => !t.schema.isNull(type),\n      );\n      if (nonNullType) {\n        return this.convertType(nonNullType);\n      }\n    }\n\n    // Handle optional types\n    if (t.schema.isOptional(schema)) {\n      return this.convertType(schema);\n    }\n\n    // Handle unsafe types (like enums)\n    if (t.schema.isUnsafe(schema)) {\n      // if it's an enum or other unsafe types, default to string\n      return \"string\";\n    }\n\n    throw new Error(`Unsupported type: ${JSON.stringify(schema)}`);\n  }\n\n  /**\n   * Check if a schema is an enum type.\n   * TypeBox enums have an \"enum\" property with an array of values.\n   */\n  protected isEnum(schema: TSchema): boolean {\n    return \"enum\" in schema && Array.isArray(schema.enum);\n  }\n\n  /**\n   * Extract enum values from a TypeBox enum schema.\n   */\n  protected getEnumValues(schema: TSchema): string[] {\n    if (\"enum\" in schema && Array.isArray(schema.enum)) {\n      return schema.enum.map(String);\n    }\n    return [];\n  }\n\n  /**\n   * Register an enum and return its type name.\n   * Generates a PascalCase name from the field name.\n   */\n  protected registerEnum(fieldName: string, values: string[]): string {\n    // Capitalize first letter of field name for enum type name\n    const enumName = fieldName.charAt(0).toUpperCase() + fieldName.slice(1);\n\n    // Check if we already have this exact enum registered\n    const valueKey = values.join(\",\");\n    const existingEnum = Array.from(this.enumDefinitions.entries()).find(\n      ([_, enumValues]) => enumValues.join(\",\") === valueKey,\n    );\n\n    if (existingEnum) {\n      // Reuse existing enum with same values\n      return existingEnum[0];\n    }\n\n    // Register new enum\n    this.enumDefinitions.set(enumName, values);\n    return enumName;\n  }\n\n  /**\n   * Generate a protobuf enum definition.\n   */\n  protected generateEnumDefinition(enumName: string, values: string[]): string {\n    const enumValues = values\n      .map((value, index) => `  ${value} = ${index};`)\n      .join(\"\\n\");\n    return `enum ${enumName} {\\n${enumValues}\\n}\\n`;\n  }\n}\n\nexport type ProtobufSchema = string;\n\nexport interface CreateProtobufSchemaOptions {\n  rootName?: string;\n  mainMessageName?: string;\n}\n","import {\n  $inject,\n  AlephaError,\n  SchemaCodec,\n  type Static,\n  type TSchema,\n  t,\n} from \"@alepha/core\";\nimport \"@alepha/datetime\";\nimport { ProtobufProvider } from \"./ProtobufProvider.ts\";\n\n/**\n * ProtobufSchemaCodec handles encoding/decoding for Protobuf format.\n *\n * Key differences from JSON codec:\n * - BigInt values are kept as BigInt (not converted to string)\n * - Date values are converted to ISO strings for protobuf compatibility\n * - Binary data (Uint8Array) is kept as-is\n * - Proto3 default values are applied when decoding (to handle omitted fields)\n */\nexport class ProtobufSchemaCodec extends SchemaCodec {\n  protected protobufProvider = $inject(ProtobufProvider);\n  protected decoder = new TextDecoder();\n\n  public encodeToString<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): string {\n    const binary = this.encodeToBinary(schema, value);\n    // convert binary to base64 string for text representation\n    if (typeof Buffer !== \"undefined\") {\n      return Buffer.from(binary).toString(\"base64\");\n    } else {\n      return btoa(String.fromCharCode(...binary));\n    }\n  }\n\n  public encodeToBinary<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): Uint8Array {\n    const proto = this.protobufProvider.createProtobufSchema(schema);\n    return this.protobufProvider.encode(proto, value);\n  }\n\n  public decode<T>(schema: TSchema, value: unknown): T {\n    // First decode from protobuf binary to object\n    const proto = this.protobufProvider.createProtobufSchema(schema);\n\n    if (value instanceof Uint8Array) {\n      return this.applyProto3Defaults(\n        schema,\n        this.protobufProvider.decode(proto, value),\n      );\n    }\n\n    if (typeof value === \"string\") {\n      return this.applyProto3Defaults(\n        schema,\n        this.protobufProvider.decode(\n          proto,\n          typeof Buffer !== \"undefined\"\n            ? Uint8Array.from(Buffer.from(value, \"base64\"))\n            : Uint8Array.from(\n                atob(value)\n                  .split(\"\")\n                  .map((c) => c.charCodeAt(0)),\n              ),\n        ),\n      );\n    }\n\n    throw new AlephaError(\n      `Unsupported value type for Protobuf decoding: ${typeof value}`,\n    );\n  }\n\n  /**\n   * Apply proto3 default values for fields that were omitted during encoding.\n   * Proto3 omits fields with default values, so we need to restore them.\n   * Also converts enum integers back to their string values.\n   */\n  protected applyProto3Defaults(schema: TSchema, value: any): any {\n    if (!value || typeof value !== \"object\") {\n      return value;\n    }\n\n    if (t.schema.isObject(schema)) {\n      const result: any = { ...value };\n\n      for (const [key, propSchema] of Object.entries(schema.properties)) {\n        if (!(key in result) || result[key] === undefined) {\n          // Apply proto3 default values based on type\n          result[key] = this.getProto3Default(propSchema);\n        } else {\n          // Convert enum integers to strings\n          if (this.isEnum(propSchema)) {\n            result[key] = this.convertEnumValue(propSchema, result[key]);\n          } else if (typeof result[key] === \"object\" && result[key] !== null) {\n            // Recursively apply defaults to nested objects\n            result[key] = this.applyProto3Defaults(propSchema, result[key]);\n          }\n        }\n      }\n\n      return result;\n    }\n\n    if (t.schema.isArray(schema) && Array.isArray(value)) {\n      return value.map((item) => this.applyProto3Defaults(schema.items, item));\n    }\n\n    return value;\n  }\n\n  /**\n   * Check if a schema is an enum type.\n   */\n  protected isEnum(schema: TSchema): boolean {\n    return \"enum\" in schema && Array.isArray(schema.enum);\n  }\n\n  /**\n   * Convert an enum value from protobuf integer to TypeBox string.\n   */\n  protected convertEnumValue(schema: TSchema, value: any): any {\n    if (\n      typeof value === \"number\" &&\n      \"enum\" in schema &&\n      Array.isArray(schema.enum)\n    ) {\n      // Protobuf encodes enums as integers, convert back to string\n      return schema.enum[value];\n    }\n    return value;\n  }\n\n  /**\n   * Get the proto3 default value for a schema type.\n   */\n  protected getProto3Default(schema: TSchema): any {\n    // Handle nullable/optional types - they can be undefined\n    if (t.schema.isOptional(schema) || t.schema.isUnion(schema)) {\n      return undefined;\n    }\n\n    // Handle arrays - default is empty array\n    if (t.schema.isArray(schema)) {\n      return [];\n    }\n\n    // Handle records (maps) - default is empty object\n    if (t.schema.isRecord(schema)) {\n      return {};\n    }\n\n    // Handle primitive types\n    if (t.schema.isString(schema)) return \"\";\n    if (t.schema.isNumber(schema)) return 0;\n    if (t.schema.isInteger(schema)) return 0;\n    if (t.schema.isBigInt(schema)) return BigInt(0);\n    if (t.schema.isBoolean(schema)) return false;\n\n    // For objects, return empty object (will be filled in recursively)\n    if (t.schema.isObject(schema)) {\n      return {};\n    }\n\n    return undefined;\n  }\n}\n","import { $module } from \"@alepha/core\";\nimport { ProtobufProvider } from \"./providers/ProtobufProvider.ts\";\nimport { ProtobufSchemaCodec } from \"./providers/ProtobufSchemaCodec.ts\";\n\nexport * from \"./providers/ProtobufProvider.ts\";\nexport * from \"./providers/ProtobufSchemaCodec.ts\";\n\nexport const AlephaProtobuf = $module({\n  name: \"alepha.protobuf\",\n  services: [ProtobufProvider, ProtobufSchemaCodec],\n  register: (alepha) => {\n    alepha.with(ProtobufProvider);\n    alepha.codec.register(\"protobuf\", alepha.inject(ProtobufSchemaCodec));\n  },\n});\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,103 @@
+import * as _alepha_core0 from "@alepha/core";
+import { Alepha, SchemaCodec, Static, TObject, TSchema } from "@alepha/core";
+import protobufjs, { Type } from "protobufjs";
+
+//#region src/providers/ProtobufProvider.d.ts
+declare class ProtobufProvider {
+  protected readonly alepha: Alepha;
+  protected readonly schemas: Map<string | TObject, Type>;
+  protected readonly protobuf: typeof protobufjs;
+  protected readonly enumDefinitions: Map<string, string[]>;
+  /**
+   * Encode an object to a Uint8Array.
+   */
+  encode(schema: ProtobufSchema, message: any): Uint8Array;
+  /**
+   * Decode a Uint8Array to an object.
+   */
+  decode<T = any>(schema: ProtobufSchema, data: Uint8Array): T;
+  /**
+   * Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.
+   */
+  parse(schema: ProtobufSchema, typeName?: string): Type;
+  /**
+   * Convert a TypeBox schema to a Protobuf schema as a string.
+   */
+  createProtobufSchema(schema: TSchema, options?: CreateProtobufSchemaOptions): string;
+  /**
+   * Parse an object schema with dependencies (sub-messages).
+   */
+  protected parseObjectWithDependencies(obj: TSchema, parentName: string): {
+    message: string;
+    subMessages: string[];
+  };
+  /**
+   * Convert a primitive TypeBox schema type to a Protobuf spec type.
+   */
+  protected convertType(schema: TSchema): string;
+  /**
+   * Check if a schema is an enum type.
+   * TypeBox enums have an "enum" property with an array of values.
+   */
+  protected isEnum(schema: TSchema): boolean;
+  /**
+   * Extract enum values from a TypeBox enum schema.
+   */
+  protected getEnumValues(schema: TSchema): string[];
+  /**
+   * Register an enum and return its type name.
+   * Generates a PascalCase name from the field name.
+   */
+  protected registerEnum(fieldName: string, values: string[]): string;
+  /**
+   * Generate a protobuf enum definition.
+   */
+  protected generateEnumDefinition(enumName: string, values: string[]): string;
+}
+type ProtobufSchema = string;
+interface CreateProtobufSchemaOptions {
+  rootName?: string;
+  mainMessageName?: string;
+}
+//#endregion
+//#region src/providers/ProtobufSchemaCodec.d.ts
+/**
+ * ProtobufSchemaCodec handles encoding/decoding for Protobuf format.
+ *
+ * Key differences from JSON codec:
+ * - BigInt values are kept as BigInt (not converted to string)
+ * - Date values are converted to ISO strings for protobuf compatibility
+ * - Binary data (Uint8Array) is kept as-is
+ * - Proto3 default values are applied when decoding (to handle omitted fields)
+ */
+declare class ProtobufSchemaCodec extends SchemaCodec {
+  protected protobufProvider: ProtobufProvider;
+  protected decoder: TextDecoder;
+  encodeToString<T extends TSchema>(schema: T, value: Static<T>): string;
+  encodeToBinary<T extends TSchema>(schema: T, value: Static<T>): Uint8Array;
+  decode<T>(schema: TSchema, value: unknown): T;
+  /**
+   * Apply proto3 default values for fields that were omitted during encoding.
+   * Proto3 omits fields with default values, so we need to restore them.
+   * Also converts enum integers back to their string values.
+   */
+  protected applyProto3Defaults(schema: TSchema, value: any): any;
+  /**
+   * Check if a schema is an enum type.
+   */
+  protected isEnum(schema: TSchema): boolean;
+  /**
+   * Convert an enum value from protobuf integer to TypeBox string.
+   */
+  protected convertEnumValue(schema: TSchema, value: any): any;
+  /**
+   * Get the proto3 default value for a schema type.
+   */
+  protected getProto3Default(schema: TSchema): any;
+}
+//#endregion
+//#region src/index.d.ts
+declare const AlephaProtobuf: _alepha_core0.Service<_alepha_core0.Module>;
+//#endregion
+export { AlephaProtobuf, CreateProtobufSchemaOptions, ProtobufProvider, ProtobufSchema, ProtobufSchemaCodec };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/providers/ProtobufProvider.ts","../src/providers/ProtobufSchemaCodec.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;cAIa,gBAAA;6BACc;EADd,mBAAgB,OAAA,EAEC,GAFD,CAAA,MAAA,GAEc,OAFd,EAEuB,IAFvB,CAAA;EACF,mBAAA,QAAA,EAAA,OAEW,UAFX;EACgB,mBAAA,eAAA,EAEL,GAFK,CAAA,MAAA,EAAA,MAAA,EAAA,CAAA;EAAS;;;EAEd,MAAA,CAAA,MAAA,EAKd,cALc,EAAA,OAAA,EAAA,GAAA,CAAA,EAKiB,UALjB;EAKd;;;EAO+B,MAAA,CAAA,IAAA,GAAA,CAAA,CAAA,MAAA,EAAtB,cAAsB,EAAA,IAAA,EAAA,UAAA,CAAA,EAAa,CAAb;EAAa;;;EAuBxD,KAAA,CAAA,MAAA,EAhBW,cAgBX,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EAhBsD,IAgBtD;EACC;;;EA8Mc,oBAAA,CAAA,MAAA,EA/Mf,OA+Me,EAAA,OAAA,CAAA,EA9Md,2BA8Mc,CAAA,EAAA,MAAA;EAOO;;AA0ClC;EAEiB,UAAA,2BAA2B,CAAA,GAAA,EA9NnC,OA8NmC,EAAA,UAAA,EAAA,MAAA,CAAA,EAAA;;;;ECzR/B;;;EAIqB,UAAA,WAAA,CAAA,MAAA,ED6LF,OC7LE,CAAA,EAAA,MAAA;EACtB;;;;EAaA,UAAA,MAAA,CAAA,MAAA,EDoNe,OCpNf,CAAA,EAAA,OAAA;EACM;;;EAMS,UAAA,aAAA,CAAA,MAAA,EDoNO,OCpNP,CAAA,EAAA,MAAA,EAAA;EAA0B;;;;EA+FhB,UAAA,YAAA,CAAA,SAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,CAAA,EAAA,MAAA;EAxHI;;;;;ACb5B,KFoSD,cAAA,GE7RV,MAAA;UF+Re,2BAAA;;;;;;;;AAzSjB;;;;;;;AASwB,cCOX,mBAAA,SAA4B,WAAA,CDPjB;EAA+B,UAAA,gBAAA,ECQ3B,gBDR2B;EAOtB,UAAA,OAAA,ECEd,WDFc;EAAsB,cAAA,CAAA,UCIrB,ODJqB,CAAA,CAAA,MAAA,ECK3C,CDL2C,EAAA,KAAA,ECM5C,MDN4C,CCMrC,CDNqC,CAAA,CAAA,EAAA,MAAA;EAAa,cAAA,CAAA,UCiBlC,ODjBkC,CAAA,CAAA,MAAA,ECkBxD,CDlBwD,EAAA,KAAA,ECmBzD,MDnByD,CCmBlD,CDnBkD,CAAA,CAAA,ECoB/D,UDpB+D;EAO7C,MAAA,CAAA,CAAA,CAAA,CAAA,MAAA,ECkBI,ODlBJ,EAAA,KAAA,EAAA,OAAA,CAAA,ECkB8B,CDlB9B;EAA2C;;;;;EA+NvC,UAAA,mBAAA,CAAA,MAAA,ECxKa,ODwKb,EAAA,KAAA,EAAA,GAAA,CAAA,EAAA,GAAA;EAOO;;AA0ClC;EAEiB,UAAA,MAAA,CAAA,MAAA,ECvLU,ODuLiB,CAAA,EAAA,OAAA;;;;ECzR/B,UAAA,gBAAoB,CAAA,MAAA,EAyGI,OAzGJ,EAAA,KAAA,EAAA,GAAA,CAAA,EAAA,GAAA;EACL;;;EAIhB,UAAA,gBAAA,CAAA,MAAA,EAmHyB,OAnHzB,CAAA,EAAA,GAAA;;;;cClBC,gBAAc,aAAA,CAAA,QAOzB,aAAA,CAPyB,MAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@alepha/protobuf",
-	"version": "0.11.8",
+	"version": "0.11.10",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -13,15 +13,15 @@
 		"src"
 	],
 	"dependencies": {
-		"@alepha/core": "0.11.8",
-		"@alepha/datetime": "0.11.8",
+		"@alepha/core": "0.11.10",
+		"@alepha/datetime": "0.11.10",
 		"protobufjs": "^7.5.4"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.3.5",
 		"tsdown": "^0.16.4",
 		"typescript": "^5.9.3",
-		"vitest": "^4.0.8"
+		"vitest": "^4.0.9"
 	},
 	"scripts": {
 		"test": "vitest run",
@@ -43,7 +43,8 @@
 	"exports": {
 		".": {
 			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js"
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
 		}
 	}
 }