@alepha/protobuf 0.10.7 → 0.11.1

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-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 {
@@ -10,15 +12,15 @@ declare class ProtobufProvider {
   /**
    * 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.
    */
@@ -59,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,EACF,MADE;EACF,mBAAA,OAAA,EACG,GADH,CAAA,MAAA,GACgB,OADhB,EACyB,IADzB,CAAA;EACgB,mBAAA,QAAA,EAAA,OACL,UADK;EAAS,mBAAA,eAAA,EAEd,GAFc,CAAA,MAAA,EAAA,MAAA,EAAA,CAAA;EAAtB;;;EAON,MAAA,CAAA,MAAA,EAAA,OAAA,EAAA,IAAA,EAAA,GAAA,CAAA,EAAqB,UAArB;EAAqB;;;EAOO,MAAA,CAAA,UAA1B,OAA0B,CAAA,CAAA,MAAA,EAAT,CAAS,EAAA,IAAA,EAAA,UAAA,CAAA,EAAa,MAAb,CAAoB,CAApB,CAAA;EAAoB;;;EAQ3C,KAAA,CAAA,MAAA,EAAjB,cAAiB,GAAA,OAAA,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EAExB,IAFwB;EAExB;;;EAoDI,oBAAA,CAAA,MAAA,EApCG,OAoCH,EAAA,OAAA,CAAA,EAnCI,2BAmCJ,CAAA,EAAA,MAAA;EAsIuB;;;EA4CS,UAAA,2BAAA,CAAA,GAAA,EAlLhC,OAkLgC,EAAA,UAAA,EAAA,MAAA,CAAA,EAAA;IA0C7B,OAAA,EAAA,MAAc;IAET,WAAA,EAAA,MAAA,EAAA;;;;;gCAxFe;;;;;2BAqCL;;;;kCAOO;;;;;;;;;;;KA0CtB,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,5 +1,6 @@
-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 {
@@ -10,14 +11,14 @@ var ProtobufProvider = class {
 	/**
 	* 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.
@@ -25,8 +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 type = this.protobuf.parse(pbSchema).root.lookupType(typeName);
+		const type = this.protobuf.parse(schema).root.lookupType(typeName);
 		this.schemas.set(schema, type);
 		return type;
 	}
@@ -189,5 +189,97 @@ var ProtobufProvider = class {
 };
 
 //#endregion
-export { ProtobufProvider };
+//#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
+//#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  $inject,\n  Alepha,\n  type Static,\n  type TObject,\n  type TSchema,\n  t,\n} 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: TObject, data: any): Uint8Array {\n    return this.parse(schema).encode(this.alepha.parse(schema, data)).finish();\n  }\n\n  /**\n   * Decode a Uint8Array to an object.\n   */\n  public decode<T extends TObject>(schema: T, data: Uint8Array): Static<T> {\n    return this.alepha.parse(schema, this.parse(schema).decode(data));\n  }\n\n  /**\n   * Parse a TypeBox schema to a Protobuf Type schema ready for encoding/decoding.\n   */\n  public parse(\n    schema: ProtobufSchema | TObject,\n    typeName = \"root.Target\",\n  ): Type {\n    const exists = this.schemas.get(schema);\n    if (exists) return exists;\n\n    const pbSchema =\n      typeof schema === \"string\" ? schema : this.createProtobufSchema(schema);\n    const result = this.protobuf.parse(pbSchema);\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"],"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.7",
+	"version": "0.11.1",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -13,20 +13,21 @@
 		"src"
 	],
 	"dependencies": {
-		"@alepha/core": "0.10.7",
+		"@alepha/core": "0.11.1",
+		"@alepha/datetime": "0.11.1",
 		"protobufjs": "^7.5.4"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.2.6",
-		"tsdown": "^0.15.9",
+		"@biomejs/biome": "^2.3.2",
+		"tsdown": "^0.15.11",
 		"typescript": "^5.9.3",
 		"vitest": "^3.2.4"
 	},
 	"scripts": {
 		"test": "vitest run",
-		"lint": "biome check --write --unsafe",
-		"build": "tsdown -c ../../tsdown.config.ts",
-		"check": "tsc"
+		"lint": "biome check --fix",
+		"build": "tsdown -c=../../tsdown.config.ts",
+		"typecheck": "tsc --noEmit"
 	},
 	"homepage": "https://github.com/feunard/alepha",
 	"repository": {

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,11 +1,4 @@
-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";
 
@@ -18,30 +11,27 @@ export class ProtobufProvider {
   /**
    * Encode an object to a Uint8Array.
    */
-  public encode(schema: TObject, data: any): Uint8Array {
-    return this.parse(schema).encode(this.alepha.parse(schema, data)).finish();
+  public encode(schema: ProtobufSchema, message: any): Uint8Array {
+    return this.parse(schema).encode(message).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));
+  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 | TObject,
-    typeName = "root.Target",
-  ): Type {
+  public parse(schema: ProtobufSchema, typeName = "root.Target"): Type {
     const exists = this.schemas.get(schema);
-    if (exists) return exists;
+    if (exists) {
+      return exists;
+    }
 
-    const pbSchema =
-      typeof schema === "string" ? schema : this.createProtobufSchema(schema);
-    const result = this.protobuf.parse(pbSchema);
+    const result = this.protobuf.parse(schema);
     const type = result.root.lookupType(typeName);
     this.schemas.set(schema, type);
     return type;

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;
+  }
+}