@alepha/protobuf 0.10.6 → 0.11.0

package/dist/index.d.ts

@@ -1,23 +1,26 @@
-import { Alepha, Static, TObject, TSchema } from "@alepha/core";
+import * as _alepha_core0 from "@alepha/core";
+import { Alepha, SchemaCodec, StaticDecode, TObject, TSchema } from "@alepha/core";
 import protobufjs, { Type } from "protobufjs";
+import "@alepha/datetime";
 
 //#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: TObject, data: any): Uint8Array;
+  encode(schema: ProtobufSchema, message: any): Uint8Array;
   /**
    * Decode a Uint8Array to an object.
    */
-  decode<T extends TObject>(schema: T, data: Uint8Array): Static<T>;
+  decode<T = any>(schema: ProtobufSchema, data: Uint8Array): T;
   /**
    * Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.
    */
-  parse(schema: ProtobufSchema | TObject, typeName?: string): Type;
+  parse(schema: ProtobufSchema, typeName?: string): Type;
   /**
    * Convert a TypeBox schema to a Protobuf schema as a string.
    */
@@ -33,6 +36,24 @@ declare class ProtobufProvider {
    * 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 {
@@ -40,5 +61,49 @@ interface CreateProtobufSchemaOptions {
   mainMessageName?: string;
 }
 //#endregion
-export { CreateProtobufSchemaOptions, ProtobufProvider, ProtobufSchema };
+//#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(schema: TSchema, value: any): string;
+  encodeToBinary(schema: TSchema, value: any): Uint8Array;
+  decode<T extends TSchema>(schema: T, value: any): StaticDecode<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;
+  /**
+   * Transform types for Protobuf compatibility.
+   * This method is called for each type in the schema tree.
+   */
+  protected transformType(schema: TSchema): TSchema | undefined;
+}
+//#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.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/providers/ProtobufProvider.ts"],"sourcesContent":[],"mappings":";;;;cAWa,gBAAA;EAAA,mBAAgB,MAAA,EACH,MADG;EAAA,mBAAA,OAAA,EAEA,GAFA,CAAA,MAAA,GAEa,OAFb,EAEsB,IAFtB,CAAA;qBACH,QAAA,EAAA,OAEW,UAFX;;;;QAEW,CAAA,MAAA,EAKd,OALc,EAAA,IAAA,EAAA,GAAA,CAAA,EAKO,UALP;;;;QAYK,CAAA,UAAjB,OAAiB,CAAA,CAAA,MAAA,EAAA,CAAA,EAAA,IAAA,EAAS,UAAT,CAAA,EAAsB,MAAtB,CAA6B,CAA7B,CAAA;;;;OAQhC,CAAA,MAAA,EAAA,cAAA,GAAiB,OAAjB,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EAEN,IAFM;;;;sBAmBC,CAAA,MAAA,EADD,OACC,EAAA,OAAA,CAAA,EAAA,2BAAA,CAAA,EAAA,MAAA;;;;EA0KC,UAAA,2BAAc,CAAA,GAAA,EAhJnB,OAgJmB,EAAA,UAAA,EAAA,MAAA,CAAA,EAAA;IAET,OAAA,EAAA,MAAA;;;;;;gCApCc;;KAkCnB,cAAA;UAEK,2BAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/providers/ProtobufProvider.ts","../src/providers/ProtobufSchemaCodec.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;cAIa,gBAAA;6BACc;8BACG,aAAa,SAAS;EAFvC,mBAAgB,QAAA,EAAA,OAGS,UAHT;EACF,mBAAA,eAAA,EAGW,GAHX,CAAA,MAAA,EAAA,MAAA,EAAA,CAAA;EACgB;;;EACL,MAAA,CAAA,MAAA,EAMd,cANc,EAAA,OAAA,EAAA,GAAA,CAAA,EAMiB,UANjB;EACA;;;EAYL,MAAA,CAAA,IAAA,GAAA,CAAA,CAAA,MAAA,EAAA,cAAA,EAAA,IAAA,EAAsB,UAAtB,CAAA,EAAmC,CAAnC;EAAsB;;;EAOW,KAAA,CAAA,MAAA,EAA3C,cAA2C,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAgBtD;;;EA0KoB,oBAAA,CAAA,MAAA,EA1KpB,OA0KoB,EAAA,OAAA,CAAA,EAzKnB,2BAyKmB,CAAA,EAAA,MAAA;EAqCL;;;EAiDf,UAAA,2BAAc,CAAA,GAAA,EA5NjB,OA4NiB,EAAA,UAAA,EAAA,MAAA,CAAA,EAAA;IAET,OAAA,EAAA,MAAA;;;;AC1RjB;;EAEmB,UAAA,WAAA,CAAA,MAAA,EDgMa,OChMb,CAAA,EAAA,MAAA;EAEa;;;;EAUW,UAAA,MAAA,CAAA,MAAA,EDyNhB,OCzNgB,CAAA,EAAA,OAAA;EAA6B;;;EAqD7C,UAAA,aAAA,CAAA,MAAA,ED2KO,OC3KP,CAAA,EAAA,MAAA,EAAA;EAOU;;;;EA1EI,UAAA,YAAA,CAAA,SAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,CAAA,EAAA,MAAA;EAAW;;;;ACZpD;KFoSY,cAAA;UAEK,2BAAA;;;;;;;;;AAzSjB;;;;;;AAIsC,cCWzB,mBAAA,SAA4B,WAAA,CDXH;EAKd,UAAA,gBAAA,ECOI,gBDPJ;EAA+B,UAAA,OAAA,ECQpC,WDRoC;EAOtB,cAAA,CAAA,MAAA,ECGD,ODHC,EAAA,KAAA,EAAA,GAAA,CAAA,EAAA,MAAA;EAAsB,cAAA,CAAA,MAAA,ECQvB,ODRuB,EAAA,KAAA,EAAA,GAAA,CAAA,ECQD,UDRC;EAAa,MAAA,CAAA,UCa1C,ODb0C,CAAA,CAAA,MAAA,ECazB,CDbyB,EAAA,KAAA,EAAA,GAAA,CAAA,ECaT,YDbS,CCaI,CDbJ,CAAA;EAO7C;;;;;EA0LS,UAAA,mBAAA,CAAA,MAAA,ECnKQ,ODmKR,EAAA,KAAA,EAAA,GAAA,CAAA,EAAA,GAAA;EAqCL;;;EAiDf,UAAA,MAAA,CAAc,MAAA,ECrNC,ODqND,CAAA,EAAA,OAAA;EAET;;;qCChNoB;EA1ExB;;;EAImB,UAAA,gBAAA,CAAA,MAAA,EAqFK,OArFL,CAAA,EAAA,GAAA;EAKA;;;;EAKwC,UAAA,aAAA,CAAA,MAAA,EA8GtC,OA9GsC,CAAA,EA8G5B,OA9G4B,GAAA,SAAA;;;;cC1B3D,gBAAc,aAAA,CAAA,QAOzB,aAAA,CAPyB"}

package/dist/index.js

@@ -1,22 +1,24 @@
-import { $inject, Alepha, t } from "@alepha/core";
+import { $inject, $module, Alepha, SchemaCodec, t } from "@alepha/core";
 import protobufjs from "protobufjs";
+import "@alepha/datetime";
 
 //#region src/providers/ProtobufProvider.ts
 var ProtobufProvider = class {
 	alepha = $inject(Alepha);
 	schemas = /* @__PURE__ */ new Map();
 	protobuf = protobufjs;
+	enumDefinitions = /* @__PURE__ */ new Map();
 	/**
 	* Encode an object to a Uint8Array.
 	*/
-	encode(schema, data) {
-		return this.parse(schema).encode(this.alepha.parse(schema, data)).finish();
+	encode(schema, message) {
+		return this.parse(schema).encode(message).finish();
 	}
 	/**
 	* Decode a Uint8Array to an object.
 	*/
 	decode(schema, data) {
-		return this.alepha.parse(schema, this.parse(schema).decode(data));
+		return this.parse(schema).decode(data);
 	}
 	/**
 	* Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.
@@ -24,9 +26,7 @@ var ProtobufProvider = class {
 	parse(schema, typeName = "root.Target") {
 		const exists = this.schemas.get(schema);
 		if (exists) return exists;
-		const pbSchema = typeof schema === "string" ? schema : this.createProtobufSchema(schema);
-		const result = this.protobuf.parse(pbSchema);
-		const type = result.root.lookupType(typeName);
+		const type = this.protobuf.parse(schema).root.lookupType(typeName);
 		this.schemas.set(schema, type);
 		return type;
 	}
@@ -35,12 +35,14 @@ var ProtobufProvider = class {
 	*/
 	createProtobufSchema(schema, options = {}) {
 		const { rootName = "root", mainMessageName = "Target" } = options;
+		this.enumDefinitions.clear();
 		const context = {
 			proto: `package ${rootName};\nsyntax = "proto3";\n\n`,
 			fieldIndex: 1
 		};
 		if (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;
 		}
@@ -59,6 +61,12 @@ var ProtobufProvider = class {
 		let fieldIndex = 1;
 		for (const [key, value] of Object.entries(obj.properties)) {
 			if (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 (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);
@@ -82,6 +90,12 @@ var ProtobufProvider = class {
 			if (t.schema.isUnion(value)) {
 				const nonNullType = value.anyOf.find((type) => !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 (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);
@@ -108,12 +122,17 @@ var ProtobufProvider = class {
 					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++};`);
 		}
-		const message = `message ${parentName} {\n${fields.join("\n")}\n}\n`;
 		return {
-			message,
+			message: `message ${parentName} {\n${fields.join("\n")}\n}\n`,
 			subMessages
 		};
 	}
@@ -135,8 +154,132 @@ var ProtobufProvider = class {
 		if (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 SchemaCodec {
+	protobufProvider = $inject(ProtobufProvider);
+	decoder = new TextDecoder();
+	encodeToString(schema, value) {
+		const binary = this.encodeToBinary(schema, value);
+		return this.decoder.decode(binary);
+	}
+	encodeToBinary(schema, value) {
+		const proto = this.protobufProvider.createProtobufSchema(schema);
+		return this.protobufProvider.encode(proto, this.encode(schema, value));
+	}
+	decode(schema, value) {
+		const proto = this.protobufProvider.createProtobufSchema(schema);
+		const decoded = this.protobufProvider.decode(proto, value);
+		const withDefaults = this.applyProto3Defaults(schema, decoded);
+		return super.decode(schema, withDefaults);
+	}
+	/**
+	* 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 (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 (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 (t.schema.isOptional(schema) || t.schema.isUnion(schema)) return;
+		if (t.schema.isArray(schema)) return [];
+		if (t.schema.isRecord(schema)) return {};
+		if (t.schema.isString(schema)) return "";
+		if (t.schema.isNumber(schema)) return 0;
+		if (t.schema.isInteger(schema)) return 0;
+		if (t.schema.isBigInt(schema)) return BigInt(0);
+		if (t.schema.isBoolean(schema)) return false;
+		if (t.schema.isObject(schema)) return {};
+	}
+	/**
+	* Transform types for Protobuf compatibility.
+	* This method is called for each type in the schema tree.
+	*/
+	transformType(schema) {
+		if (t.schema.isBigInt(schema)) return t.bigint();
+	}
 };
 
 //#endregion
-export { ProtobufProvider };
+//#region src/index.ts
+const AlephaProtobuf = $module({
+	name: "alepha.protobuf",
+	services: [ProtobufProvider, ProtobufSchemaCodec],
+	register: (alepha) => {
+		alepha.with(ProtobufProvider);
+		alepha.codec.register("protobuf", alepha.inject(ProtobufSchemaCodec));
+	}
+});
+
+//#endregion
+export { AlephaProtobuf, ProtobufProvider, ProtobufSchemaCodec };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["fields: string[]","subMessages: string[]","fieldType","valueSchema: TSchema | undefined"],"sources":["../src/providers/ProtobufProvider.ts"],"sourcesContent":["import {\n\t$inject,\n\tAlepha,\n\ttype Static,\n\ttype TObject,\n\ttype TSchema,\n\tt,\n} from \"@alepha/core\";\nimport type { Type } from \"protobufjs\";\nimport protobufjs from \"protobufjs\";\n\nexport class ProtobufProvider {\n\tprotected readonly alepha = $inject(Alepha);\n\tprotected readonly schemas: Map<string | TObject, Type> = new Map();\n\tprotected readonly protobuf: typeof protobufjs = protobufjs;\n\n\t/**\n\t * Encode an object to a Uint8Array.\n\t */\n\tpublic encode(schema: TObject, data: any): Uint8Array {\n\t\treturn this.parse(schema).encode(this.alepha.parse(schema, data)).finish();\n\t}\n\n\t/**\n\t * Decode a Uint8Array to an object.\n\t */\n\tpublic decode<T extends TObject>(schema: T, data: Uint8Array): Static<T> {\n\t\treturn this.alepha.parse(schema, this.parse(schema).decode(data));\n\t}\n\n\t/**\n\t * Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.\n\t */\n\tpublic parse(\n\t\tschema: ProtobufSchema | TObject,\n\t\ttypeName = \"root.Target\",\n\t): Type {\n\t\tconst exists = this.schemas.get(schema);\n\t\tif (exists) return exists;\n\n\t\tconst pbSchema =\n\t\t\ttypeof schema === \"string\" ? schema : this.createProtobufSchema(schema);\n\t\tconst result = this.protobuf.parse(pbSchema);\n\t\tconst type = result.root.lookupType(typeName);\n\t\tthis.schemas.set(schema, type);\n\t\treturn type;\n\t}\n\n\t/**\n\t * Convert a TypeBox schema to a Protobuf schema as a string.\n\t */\n\tpublic createProtobufSchema(\n\t\tschema: TSchema,\n\t\toptions: CreateProtobufSchemaOptions = {},\n\t): string {\n\t\tconst { rootName = \"root\", mainMessageName = \"Target\" } = options;\n\t\tconst context = {\n\t\t\tproto: `package ${rootName};\\nsyntax = \"proto3\";\\n\\n`,\n\t\t\tfieldIndex: 1,\n\t\t};\n\n\t\tif (t.schema.isObject(schema)) {\n\t\t\tconst { message, subMessages } = this.parseObjectWithDependencies(\n\t\t\t\tschema,\n\t\t\t\tmainMessageName,\n\t\t\t);\n\t\t\t// Add all sub-messages first\n\t\t\tcontext.proto += subMessages.join(\"\");\n\t\t\t// Then add the main message\n\t\t\tcontext.proto += message;\n\t\t}\n\n\t\treturn context.proto;\n\t}\n\n\t/**\n\t * Parse an object schema with dependencies (sub-messages).\n\t */\n\tprotected parseObjectWithDependencies(\n\t\tobj: TSchema,\n\t\tparentName: string,\n\t): { message: string; subMessages: string[] } {\n\t\tif (!t.schema.isObject(obj)) {\n\t\t\treturn { message: \"\", subMessages: [] };\n\t\t}\n\n\t\tconst fields: string[] = [];\n\t\tconst subMessages: string[] = [];\n\t\tlet fieldIndex = 1;\n\n\t\tfor (const [key, value] of Object.entries(obj.properties)) {\n\t\t\t// Handle arrays\n\t\t\tif (t.schema.isArray(value)) {\n\t\t\t\tif (t.schema.isObject(value.items)) {\n\t\t\t\t\tconst subMessageName =\n\t\t\t\t\t\t\"title\" in value.items && typeof value.items.title === \"string\"\n\t\t\t\t\t\t\t? value.items.title\n\t\t\t\t\t\t\t: `${parentName}_${key}`;\n\t\t\t\t\tconst { message: subMessage, subMessages: nestedSubMessages } =\n\t\t\t\t\t\tthis.parseObjectWithDependencies(value.items, subMessageName);\n\t\t\t\t\tsubMessages.push(...nestedSubMessages);\n\t\t\t\t\tsubMessages.push(subMessage);\n\t\t\t\t\tfields.push(`  repeated ${subMessageName} ${key} = ${fieldIndex++};`);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tconst itemType = this.convertType(value.items);\n\t\t\t\tfields.push(`  repeated ${itemType} ${key} = ${fieldIndex++};`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Handle nested objects\n\t\t\tif (t.schema.isObject(value)) {\n\t\t\t\tconst subMessageName =\n\t\t\t\t\t\"title\" in value && typeof value.title === \"string\"\n\t\t\t\t\t\t? value.title\n\t\t\t\t\t\t: `${parentName}_${key}`;\n\t\t\t\tconst { message: subMessage, subMessages: nestedSubMessages } =\n\t\t\t\t\tthis.parseObjectWithDependencies(value, subMessageName);\n\t\t\t\tsubMessages.push(...nestedSubMessages);\n\t\t\t\tsubMessages.push(subMessage);\n\t\t\t\tfields.push(`  ${subMessageName} ${key} = ${fieldIndex++};`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Handle union types (nullable fields)\n\t\t\tif (t.schema.isUnion(value)) {\n\t\t\t\tconst nonNullType = value.anyOf.find(\n\t\t\t\t\t(type: TSchema) => !t.schema.isNull(type),\n\t\t\t\t);\n\t\t\t\tif (nonNullType) {\n\t\t\t\t\tif (t.schema.isObject(nonNullType)) {\n\t\t\t\t\t\tconst subMessageName =\n\t\t\t\t\t\t\t\"title\" in nonNullType && typeof nonNullType.title === \"string\"\n\t\t\t\t\t\t\t\t? nonNullType.title\n\t\t\t\t\t\t\t\t: `${parentName}_${key}`;\n\t\t\t\t\t\tconst { message: subMessage, subMessages: nestedSubMessages } =\n\t\t\t\t\t\t\tthis.parseObjectWithDependencies(nonNullType, subMessageName);\n\t\t\t\t\t\tsubMessages.push(...nestedSubMessages);\n\t\t\t\t\t\tsubMessages.push(subMessage);\n\t\t\t\t\t\tfields.push(`  ${subMessageName} ${key} = ${fieldIndex++};`);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst fieldType = this.convertType(nonNullType);\n\t\t\t\t\tfields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Handle records (maps)\n\t\t\tif (t.schema.isRecord(value)) {\n\t\t\t\t// TypeBox records use additionalProperties or patternProperties for the value type\n\t\t\t\tlet valueSchema: TSchema | undefined;\n\t\t\t\tif (\n\t\t\t\t\t\"additionalProperties\" in value &&\n\t\t\t\t\tvalue.additionalProperties &&\n\t\t\t\t\ttypeof value.additionalProperties === \"object\"\n\t\t\t\t) {\n\t\t\t\t\tvalueSchema = value.additionalProperties;\n\t\t\t\t} else if (\n\t\t\t\t\tvalue.patternProperties &&\n\t\t\t\t\ttypeof value.patternProperties === \"object\"\n\t\t\t\t) {\n\t\t\t\t\t// Get the first pattern property (usually \"^(.*)$\" or similar)\n\t\t\t\t\tconst patterns = Object.values(value.patternProperties);\n\t\t\t\t\tif (patterns.length > 0 && typeof patterns[0] === \"object\") {\n\t\t\t\t\t\tvalueSchema = patterns[0] as TSchema;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (valueSchema) {\n\t\t\t\t\tconst valueType = this.convertType(valueSchema);\n\t\t\t\t\tfields.push(`  map<string, ${valueType}> ${key} = ${fieldIndex++};`);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Handle regular fields\n\t\t\tconst fieldType = this.convertType(value);\n\t\t\tfields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);\n\t\t}\n\n\t\tconst message = `message ${parentName} {\\n${fields.join(\"\\n\")}\\n}\\n`;\n\t\treturn { message, subMessages };\n\t}\n\n\t/**\n\t * Convert a primitive TypeBox schema type to a Protobuf spec type.\n\t */\n\tprotected convertType(schema: TSchema): string {\n\t\tif (t.schema.isBoolean(schema)) return \"bool\";\n\t\tif (t.schema.isNumber(schema) && schema.format === \"int64\") return \"int64\";\n\t\tif (t.schema.isNumber(schema)) return \"double\";\n\t\tif (t.schema.isInteger(schema)) return \"int32\";\n\t\tif (t.schema.isBigInt(schema)) return \"int64\";\n\t\tif (t.schema.isString(schema)) return \"string\";\n\n\t\t// Handle union types (nullable)\n\t\tif (t.schema.isUnion(schema)) {\n\t\t\t// Find the non-null type in the union\n\t\t\tconst nonNullType = schema.anyOf.find(\n\t\t\t\t(type: TSchema) => !t.schema.isNull(type),\n\t\t\t);\n\t\t\tif (nonNullType) {\n\t\t\t\treturn this.convertType(nonNullType);\n\t\t\t}\n\t\t}\n\n\t\t// Handle optional types\n\t\tif (t.schema.isOptional(schema)) {\n\t\t\treturn this.convertType(schema);\n\t\t}\n\n\t\t// Handle unsafe types (like enums)\n\t\tif (t.schema.isUnsafe(schema)) {\n\t\t\t// if it's an enum or other unsafe types, default to string\n\t\t\treturn \"string\";\n\t\t}\n\n\t\tthrow new Error(`Unsupported type: ${JSON.stringify(schema)}`);\n\t}\n}\n\nexport type ProtobufSchema = string;\n\nexport interface CreateProtobufSchemaOptions {\n\trootName?: string;\n\tmainMessageName?: string;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["fields: string[]","subMessages: string[]","fieldType","valueSchema: TSchema | undefined","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  SchemaCodec,\n  type StaticDecode,\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(schema: TSchema, value: any): string {\n    const binary = this.encodeToBinary(schema, value);\n    return this.decoder.decode(binary);\n  }\n\n  public encodeToBinary(schema: TSchema, value: any): Uint8Array {\n    const proto = this.protobufProvider.createProtobufSchema(schema);\n    return this.protobufProvider.encode(proto, this.encode(schema, value));\n  }\n\n  public decode<T extends TSchema>(schema: T, value: any): StaticDecode<T> {\n    // First decode from protobuf binary to object\n    const proto = this.protobufProvider.createProtobufSchema(schema);\n    const decoded = this.protobufProvider.decode(proto, value);\n\n    // Apply proto3 default values for missing fields\n    const withDefaults = this.applyProto3Defaults(schema, decoded);\n\n    // Then use the parent decode to validate and transform\n    return super.decode(schema, withDefaults);\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  /**\n   * Transform types for Protobuf compatibility.\n   * This method is called for each type in the schema tree.\n   */\n  protected transformType(schema: TSchema): TSchema | undefined {\n    // For bigint: keep as-is, don't convert to string\n    // The schema is still a string type with format \"int64\", but we override encode/decode\n    if (t.schema.isBigInt(schema)) {\n      return t.bigint();\n    }\n\n    // For other types, use default behavior\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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@alepha/protobuf",
-	"version": "0.10.6",
+	"version": "0.11.0",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -13,12 +13,13 @@
 		"src"
 	],
 	"dependencies": {
-		"@alepha/core": "0.10.6",
+		"@alepha/core": "0.11.0",
+		"@alepha/datetime": "0.11.0",
 		"protobufjs": "^7.5.4"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.2.6",
-		"tsdown": "^0.15.7",
+		"@biomejs/biome": "^2.3.2",
+		"tsdown": "^0.15.11",
 		"typescript": "^5.9.3",
 		"vitest": "^3.2.4"
 	},

package/src/index.ts

@@ -1 +1,15 @@
+import { $module } from "@alepha/core";
+import { ProtobufProvider } from "./providers/ProtobufProvider.ts";
+import { ProtobufSchemaCodec } from "./providers/ProtobufSchemaCodec.ts";
+
 export * from "./providers/ProtobufProvider.ts";
+export * from "./providers/ProtobufSchemaCodec.ts";
+
+export const AlephaProtobuf = $module({
+  name: "alepha.protobuf",
+  services: [ProtobufProvider, ProtobufSchemaCodec],
+  register: (alepha) => {
+    alepha.with(ProtobufProvider);
+    alepha.codec.register("protobuf", alepha.inject(ProtobufSchemaCodec));
+  },
+});

package/src/providers/ProtobufProvider.ts

@@ -1,229 +1,305 @@
-import {
-	$inject,
-	Alepha,
-	type Static,
-	type TObject,
-	type TSchema,
-	t,
-} from "@alepha/core";
+import { $inject, Alepha, type TObject, type TSchema, t } from "@alepha/core";
 import type { Type } from "protobufjs";
 import protobufjs from "protobufjs";
 
 export class ProtobufProvider {
-	protected readonly alepha = $inject(Alepha);
-	protected readonly schemas: Map<string | TObject, Type> = new Map();
-	protected readonly protobuf: typeof protobufjs = protobufjs;
-
-	/**
-	 * Encode an object to a Uint8Array.
-	 */
-	public encode(schema: TObject, data: any): Uint8Array {
-		return this.parse(schema).encode(this.alepha.parse(schema, data)).finish();
-	}
-
-	/**
-	 * Decode a Uint8Array to an object.
-	 */
-	public decode<T extends TObject>(schema: T, data: Uint8Array): Static<T> {
-		return this.alepha.parse(schema, this.parse(schema).decode(data));
-	}
-
-	/**
-	 * Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.
-	 */
-	public parse(
-		schema: ProtobufSchema | TObject,
-		typeName = "root.Target",
-	): Type {
-		const exists = this.schemas.get(schema);
-		if (exists) return exists;
-
-		const pbSchema =
-			typeof schema === "string" ? schema : this.createProtobufSchema(schema);
-		const result = this.protobuf.parse(pbSchema);
-		const type = result.root.lookupType(typeName);
-		this.schemas.set(schema, type);
-		return type;
-	}
-
-	/**
-	 * Convert a TypeBox schema to a Protobuf schema as a string.
-	 */
-	public createProtobufSchema(
-		schema: TSchema,
-		options: CreateProtobufSchemaOptions = {},
-	): string {
-		const { rootName = "root", mainMessageName = "Target" } = options;
-		const context = {
-			proto: `package ${rootName};\nsyntax = "proto3";\n\n`,
-			fieldIndex: 1,
-		};
-
-		if (t.schema.isObject(schema)) {
-			const { message, subMessages } = this.parseObjectWithDependencies(
-				schema,
-				mainMessageName,
-			);
-			// Add all sub-messages first
-			context.proto += subMessages.join("");
-			// Then add the main message
-			context.proto += message;
-		}
-
-		return context.proto;
-	}
-
-	/**
-	 * Parse an object schema with dependencies (sub-messages).
-	 */
-	protected parseObjectWithDependencies(
-		obj: TSchema,
-		parentName: string,
-	): { message: string; subMessages: string[] } {
-		if (!t.schema.isObject(obj)) {
-			return { message: "", subMessages: [] };
-		}
-
-		const fields: string[] = [];
-		const subMessages: string[] = [];
-		let fieldIndex = 1;
-
-		for (const [key, value] of Object.entries(obj.properties)) {
-			// Handle arrays
-			if (t.schema.isArray(value)) {
-				if (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;
-			}
-
-			// Handle nested objects
-			if (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;
-			}
-
-			// Handle union types (nullable fields)
-			if (t.schema.isUnion(value)) {
-				const nonNullType = value.anyOf.find(
-					(type: TSchema) => !t.schema.isNull(type),
-				);
-				if (nonNullType) {
-					if (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 = this.convertType(nonNullType);
-					fields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);
-					continue;
-				}
-			}
-
-			// Handle records (maps)
-			if (t.schema.isRecord(value)) {
-				// TypeBox records use additionalProperties or patternProperties for the value type
-				let valueSchema: TSchema | undefined;
-				if (
-					"additionalProperties" in value &&
-					value.additionalProperties &&
-					typeof value.additionalProperties === "object"
-				) {
-					valueSchema = value.additionalProperties;
-				} else if (
-					value.patternProperties &&
-					typeof value.patternProperties === "object"
-				) {
-					// Get the first pattern property (usually "^(.*)$" or similar)
-					const patterns = Object.values(value.patternProperties);
-					if (patterns.length > 0 && typeof patterns[0] === "object") {
-						valueSchema = patterns[0] as TSchema;
-					}
-				}
-
-				if (valueSchema) {
-					const valueType = this.convertType(valueSchema);
-					fields.push(`  map<string, ${valueType}> ${key} = ${fieldIndex++};`);
-					continue;
-				}
-			}
-
-			// Handle regular fields
-			const fieldType = this.convertType(value);
-			fields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);
-		}
-
-		const message = `message ${parentName} {\n${fields.join("\n")}\n}\n`;
-		return { message, subMessages };
-	}
-
-	/**
-	 * Convert a primitive TypeBox schema type to a Protobuf spec type.
-	 */
-	protected convertType(schema: TSchema): string {
-		if (t.schema.isBoolean(schema)) return "bool";
-		if (t.schema.isNumber(schema) && schema.format === "int64") return "int64";
-		if (t.schema.isNumber(schema)) return "double";
-		if (t.schema.isInteger(schema)) return "int32";
-		if (t.schema.isBigInt(schema)) return "int64";
-		if (t.schema.isString(schema)) return "string";
-
-		// Handle union types (nullable)
-		if (t.schema.isUnion(schema)) {
-			// Find the non-null type in the union
-			const nonNullType = schema.anyOf.find(
-				(type: TSchema) => !t.schema.isNull(type),
-			);
-			if (nonNullType) {
-				return this.convertType(nonNullType);
-			}
-		}
-
-		// Handle optional types
-		if (t.schema.isOptional(schema)) {
-			return this.convertType(schema);
-		}
-
-		// Handle unsafe types (like enums)
-		if (t.schema.isUnsafe(schema)) {
-			// if it's an enum or other unsafe types, default to string
-			return "string";
-		}
-
-		throw new Error(`Unsupported type: ${JSON.stringify(schema)}`);
-	}
+  protected readonly alepha = $inject(Alepha);
+  protected readonly schemas: Map<string | TObject, Type> = new Map();
+  protected readonly protobuf: typeof protobufjs = protobufjs;
+  protected readonly enumDefinitions: Map<string, string[]> = new Map();
+
+  /**
+   * Encode an object to a Uint8Array.
+   */
+  public encode(schema: ProtobufSchema, message: any): Uint8Array {
+    return this.parse(schema).encode(message).finish();
+  }
+
+  /**
+   * Decode a Uint8Array to an object.
+   */
+  public decode<T = any>(schema: ProtobufSchema, data: Uint8Array): T {
+    return this.parse(schema).decode(data) as T;
+  }
+
+  /**
+   * Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.
+   */
+  public parse(schema: ProtobufSchema, typeName = "root.Target"): Type {
+    const exists = this.schemas.get(schema);
+    if (exists) {
+      return exists;
+    }
+
+    const result = this.protobuf.parse(schema);
+    const type = result.root.lookupType(typeName);
+    this.schemas.set(schema, type);
+    return type;
+  }
+
+  /**
+   * Convert a TypeBox schema to a Protobuf schema as a string.
+   */
+  public createProtobufSchema(
+    schema: TSchema,
+    options: CreateProtobufSchemaOptions = {},
+  ): string {
+    const { rootName = "root", mainMessageName = "Target" } = options;
+    // Clear enum definitions for this schema generation
+    this.enumDefinitions.clear();
+
+    const context = {
+      proto: `package ${rootName};\nsyntax = "proto3";\n\n`,
+      fieldIndex: 1,
+    };
+
+    if (t.schema.isObject(schema)) {
+      const { message, subMessages } = this.parseObjectWithDependencies(
+        schema,
+        mainMessageName,
+      );
+
+      // Add all enum definitions first
+      for (const [enumName, values] of this.enumDefinitions) {
+        context.proto += this.generateEnumDefinition(enumName, values);
+      }
+
+      // Add all sub-messages
+      context.proto += subMessages.join("");
+      // Then add the main message
+      context.proto += message;
+    }
+
+    return context.proto;
+  }
+
+  /**
+   * Parse an object schema with dependencies (sub-messages).
+   */
+  protected parseObjectWithDependencies(
+    obj: TSchema,
+    parentName: string,
+  ): { message: string; subMessages: string[] } {
+    if (!t.schema.isObject(obj)) {
+      return { message: "", subMessages: [] };
+    }
+
+    const fields: string[] = [];
+    const subMessages: string[] = [];
+    let fieldIndex = 1;
+
+    for (const [key, value] of Object.entries(obj.properties)) {
+      // Handle arrays
+      if (t.schema.isArray(value)) {
+        // Check if array items are enums
+        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 (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;
+      }
+
+      // Handle nested objects
+      if (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;
+      }
+
+      // Handle union types (nullable fields)
+      if (t.schema.isUnion(value)) {
+        const nonNullType = value.anyOf.find(
+          (type: TSchema) => !t.schema.isNull(type),
+        );
+        if (nonNullType) {
+          // Check if it's an enum
+          if (this.isEnum(nonNullType)) {
+            const enumValues = this.getEnumValues(nonNullType);
+            const enumName = this.registerEnum(key, enumValues);
+            fields.push(`  ${enumName} ${key} = ${fieldIndex++};`);
+            continue;
+          }
+
+          if (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 = this.convertType(nonNullType);
+          fields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);
+          continue;
+        }
+      }
+
+      // Handle records (maps)
+      if (t.schema.isRecord(value)) {
+        // TypeBox records use additionalProperties or patternProperties for the value type
+        let valueSchema: TSchema | undefined;
+        if (
+          "additionalProperties" in value &&
+          value.additionalProperties &&
+          typeof value.additionalProperties === "object"
+        ) {
+          valueSchema = value.additionalProperties;
+        } else if (
+          value.patternProperties &&
+          typeof value.patternProperties === "object"
+        ) {
+          // Get the first pattern property (usually "^(.*)$" or similar)
+          const patterns = Object.values(value.patternProperties);
+          if (patterns.length > 0 && typeof patterns[0] === "object") {
+            valueSchema = patterns[0] as TSchema;
+          }
+        }
+
+        if (valueSchema) {
+          const valueType = this.convertType(valueSchema);
+          fields.push(`  map<string, ${valueType}> ${key} = ${fieldIndex++};`);
+          continue;
+        }
+      }
+
+      // Handle enum fields
+      if (this.isEnum(value)) {
+        const enumValues = this.getEnumValues(value);
+        const enumName = this.registerEnum(key, enumValues);
+        fields.push(`  ${enumName} ${key} = ${fieldIndex++};`);
+        continue;
+      }
+
+      // Handle regular fields
+      const fieldType = this.convertType(value);
+      fields.push(`  ${fieldType} ${key} = ${fieldIndex++};`);
+    }
+
+    const message = `message ${parentName} {\n${fields.join("\n")}\n}\n`;
+    return { message, subMessages };
+  }
+
+  /**
+   * Convert a primitive TypeBox schema type to a Protobuf spec type.
+   */
+  protected convertType(schema: TSchema): string {
+    if (t.schema.isBoolean(schema)) return "bool";
+    if (t.schema.isNumber(schema) && schema.format === "int64") return "int64";
+    if (t.schema.isNumber(schema)) return "double";
+    if (t.schema.isInteger(schema)) return "int32";
+    if (t.schema.isBigInt(schema)) return "int64";
+    if (t.schema.isString(schema)) return "string";
+
+    // Handle union types (nullable)
+    if (t.schema.isUnion(schema)) {
+      // Find the non-null type in the union
+      const nonNullType = schema.anyOf.find(
+        (type: TSchema) => !t.schema.isNull(type),
+      );
+      if (nonNullType) {
+        return this.convertType(nonNullType);
+      }
+    }
+
+    // Handle optional types
+    if (t.schema.isOptional(schema)) {
+      return this.convertType(schema);
+    }
+
+    // Handle unsafe types (like enums)
+    if (t.schema.isUnsafe(schema)) {
+      // if it's an enum or other unsafe types, default to string
+      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.
+   */
+  protected isEnum(schema: TSchema): boolean {
+    return "enum" in schema && Array.isArray(schema.enum);
+  }
+
+  /**
+   * Extract enum values from a TypeBox enum schema.
+   */
+  protected getEnumValues(schema: TSchema): string[] {
+    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.
+   */
+  protected registerEnum(fieldName: string, values: string[]): string {
+    // Capitalize first letter of field name for enum type name
+    const enumName = fieldName.charAt(0).toUpperCase() + fieldName.slice(1);
+
+    // Check if we already have this exact enum registered
+    const valueKey = values.join(",");
+    const existingEnum = Array.from(this.enumDefinitions.entries()).find(
+      ([_, enumValues]) => enumValues.join(",") === valueKey,
+    );
+
+    if (existingEnum) {
+      // Reuse existing enum with same values
+      return existingEnum[0];
+    }
+
+    // Register new enum
+    this.enumDefinitions.set(enumName, values);
+    return enumName;
+  }
+
+  /**
+   * Generate a protobuf enum definition.
+   */
+  protected generateEnumDefinition(enumName: string, values: string[]): string {
+    const enumValues = values
+      .map((value, index) => `  ${value} = ${index};`)
+      .join("\n");
+    return `enum ${enumName} {\n${enumValues}\n}\n`;
+  }
 }
 
 export type ProtobufSchema = string;
 
 export interface CreateProtobufSchemaOptions {
-	rootName?: string;
-	mainMessageName?: string;
+  rootName?: string;
+  mainMessageName?: string;
 }

package/src/providers/ProtobufSchemaCodec.ts

@@ -0,0 +1,154 @@
+import {
+  $inject,
+  SchemaCodec,
+  type StaticDecode,
+  type TSchema,
+  t,
+} from "@alepha/core";
+import "@alepha/datetime";
+import { ProtobufProvider } from "./ProtobufProvider.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)
+ */
+export class ProtobufSchemaCodec extends SchemaCodec {
+  protected protobufProvider = $inject(ProtobufProvider);
+  protected decoder = new TextDecoder();
+
+  public encodeToString(schema: TSchema, value: any): string {
+    const binary = this.encodeToBinary(schema, value);
+    return this.decoder.decode(binary);
+  }
+
+  public encodeToBinary(schema: TSchema, value: any): Uint8Array {
+    const proto = this.protobufProvider.createProtobufSchema(schema);
+    return this.protobufProvider.encode(proto, this.encode(schema, value));
+  }
+
+  public decode<T extends TSchema>(schema: T, value: any): StaticDecode<T> {
+    // First decode from protobuf binary to object
+    const proto = this.protobufProvider.createProtobufSchema(schema);
+    const decoded = this.protobufProvider.decode(proto, value);
+
+    // Apply proto3 default values for missing fields
+    const withDefaults = this.applyProto3Defaults(schema, decoded);
+
+    // Then use the parent decode to validate and transform
+    return super.decode(schema, withDefaults);
+  }
+
+  /**
+   * 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 {
+    if (!value || typeof value !== "object") {
+      return value;
+    }
+
+    if (t.schema.isObject(schema)) {
+      const result: any = { ...value };
+
+      for (const [key, propSchema] of Object.entries(schema.properties)) {
+        if (!(key in result) || result[key] === undefined) {
+          // Apply proto3 default values based on type
+          result[key] = this.getProto3Default(propSchema);
+        } else {
+          // Convert enum integers to strings
+          if (this.isEnum(propSchema)) {
+            result[key] = this.convertEnumValue(propSchema, result[key]);
+          } else if (typeof result[key] === "object" && result[key] !== null) {
+            // Recursively apply defaults to nested objects
+            result[key] = this.applyProto3Defaults(propSchema, result[key]);
+          }
+        }
+      }
+
+      return result;
+    }
+
+    if (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.
+   */
+  protected isEnum(schema: TSchema): boolean {
+    return "enum" in schema && Array.isArray(schema.enum);
+  }
+
+  /**
+   * Convert an enum value from protobuf integer to TypeBox string.
+   */
+  protected convertEnumValue(schema: TSchema, value: any): any {
+    if (
+      typeof value === "number" &&
+      "enum" in schema &&
+      Array.isArray(schema.enum)
+    ) {
+      // Protobuf encodes enums as integers, convert back to string
+      return schema.enum[value];
+    }
+    return value;
+  }
+
+  /**
+   * Get the proto3 default value for a schema type.
+   */
+  protected getProto3Default(schema: TSchema): any {
+    // Handle nullable/optional types - they can be undefined
+    if (t.schema.isOptional(schema) || t.schema.isUnion(schema)) {
+      return undefined;
+    }
+
+    // Handle arrays - default is empty array
+    if (t.schema.isArray(schema)) {
+      return [];
+    }
+
+    // Handle records (maps) - default is empty object
+    if (t.schema.isRecord(schema)) {
+      return {};
+    }
+
+    // Handle primitive types
+    if (t.schema.isString(schema)) return "";
+    if (t.schema.isNumber(schema)) return 0;
+    if (t.schema.isInteger(schema)) return 0;
+    if (t.schema.isBigInt(schema)) return BigInt(0);
+    if (t.schema.isBoolean(schema)) return false;
+
+    // For objects, return empty object (will be filled in recursively)
+    if (t.schema.isObject(schema)) {
+      return {};
+    }
+
+    return undefined;
+  }
+
+  /**
+   * Transform types for Protobuf compatibility.
+   * This method is called for each type in the schema tree.
+   */
+  protected transformType(schema: TSchema): TSchema | undefined {
+    // For bigint: keep as-is, don't convert to string
+    // The schema is still a string type with format "int64", but we override encode/decode
+    if (t.schema.isBigInt(schema)) {
+      return t.bigint();
+    }
+
+    // For other types, use default behavior
+    return undefined;
+  }
+}