@alepha/protobuf 0.14.1 → 0.14.3

package/dist/index.d.ts

@@ -399,6 +399,7 @@ declare class EventManager {
   protected events: Record<string, Array<Hook>>;
   constructor(logFn?: () => LoggerInterface | undefined);
   protected get log(): LoggerInterface | undefined;
+  clear(): void;
   /**
    * Registers a hook for the specified event.
    */
@@ -931,6 +932,34 @@ interface State {
   "alepha.logger"?: LoggerInterface;
   /**
    * If defined, the Alepha container will only register this service and its dependencies.
+   *
+   * @example
+   * ```ts
+   * class MigrateCmd {
+   *   db = $inject(DatabaseProvider);
+   *   alepha = $inject(Alepha);
+   *   env = $env(
+   *     t.object({
+   *       MIGRATE: t.optional(t.boolean()),
+   *     }),
+   *   );
+   *
+   *   constructor() {
+   *     if (this.env.MIGRATE) {
+   *       this.alepha.set("alepha.target", MigrateCmd);
+   *     }
+   *   }
+   *
+   *   ready = $hook({
+   *     on: "ready",
+   *     handler: async () => {
+   *       if (this.env.MIGRATE) {
+   *         await this.db.migrate();
+   *       }
+   *     },
+   *   });
+   * }
+   * ```
    */
   "alepha.target"?: Service;
   /**

package/dist/index.js.map

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

@@ -2,7 +2,7 @@
   "name": "@alepha/protobuf",
   "description": "Protocol Buffers (Protobuf) codec support for Alepha framework.",
   "author": "Nicolas Foures",
-  "version": "0.14.1",
+  "version": "0.14.3",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -18,13 +18,13 @@
     "protobufjs": "^8.0.0"
   },
   "devDependencies": {
-    "alepha": "0.14.1",
-    "tsdown": "^0.18.4",
+    "alepha": "0.14.3",
+    "tsdown": "^0.19.0-beta.5",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16"
   },
   "peerDependencies": {
-    "alepha": "0.14.1"
+    "alepha": "0.14.3"
   },
   "scripts": {
     "lint": "alepha lint",

package/src/providers/ProtobufProvider.spec.ts

@@ -0,0 +1,465 @@
+import { Alepha, t } from "alepha";
+import { describe, test } from "vitest";
+import { AlephaProtobuf, ProtobufProvider } from "../index.ts";
+
+const alepha = Alepha.create().with(AlephaProtobuf);
+const protobuf = alepha.inject(ProtobufProvider);
+
+describe("ProtobufProvider", () => {
+  describe("Basic types", () => {
+    test("should handle primitive types", async ({ expect }) => {
+      const userSchema = t.object({
+        username: t.text(),
+        createdAt: t.datetime(),
+        age: t.integer(),
+        isActive: t.boolean(),
+        score: t.number(),
+        bigNumber: t.bigint(),
+        level: t.integer(),
+        points: t.integer(),
+      });
+
+      const schema = protobuf.createProtobufSchema(userSchema);
+      expect(schema).toBe(
+        `package root;
+syntax = "proto3";
+
+message Target {
+  string username = 1;
+  string createdAt = 2;
+  int32 age = 3;
+  bool isActive = 4;
+  double score = 5;
+  int64 bigNumber = 6;
+  int32 level = 7;
+  int32 points = 8;
+}
+`,
+      );
+    });
+
+    test("should encode and decode primitive types", async ({ expect }) => {
+      const userSchema = t.object({
+        username: t.text(),
+        createdAt: t.datetime(),
+        age: t.integer(),
+        isActive: t.boolean(),
+      });
+
+      const createdAt = new Date().toISOString();
+      const data = {
+        username: "John Doe",
+        createdAt,
+        age: 30,
+        isActive: true,
+      };
+      const buf = alepha.codec.encode(userSchema, data, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+      expect(buf).toBeInstanceOf(Uint8Array);
+
+      const user = alepha.codec.decode(userSchema, buf, {
+        encoder: "protobuf",
+      });
+      // When decoding, dates come back as dayjs objects, so compare the ISO strings
+      expect(user.username).toBe(data.username);
+      expect(user.age).toBe(data.age);
+      expect(user.isActive).toBe(data.isActive);
+      // Compare datetime as ISO strings since dayjs might be used
+      expect(user.createdAt).toBe(createdAt);
+    });
+  });
+
+  describe("Arrays", () => {
+    test("should handle arrays of primitives", async ({ expect }) => {
+      const schema = t.object({
+        tags: t.array(t.text()),
+        scores: t.array(t.number()),
+        flags: t.array(t.boolean()),
+      });
+
+      const protoSchema = protobuf.createProtobufSchema(schema);
+      expect(protoSchema).toBe(
+        `package root;
+syntax = "proto3";
+
+message Target {
+  repeated string tags = 1;
+  repeated double scores = 2;
+  repeated bool flags = 3;
+}
+`,
+      );
+    });
+
+    test("should handle arrays of objects", async ({ expect }) => {
+      const schema = t.object({
+        users: t.array(
+          t.object({
+            name: t.text(),
+            age: t.integer(),
+          }),
+        ),
+      });
+
+      const protoSchema = protobuf.createProtobufSchema(schema);
+      expect(protoSchema).toBe(
+        `package root;
+syntax = "proto3";
+
+message Target_users {
+  string name = 1;
+  int32 age = 2;
+}
+message Target {
+  repeated Target_users users = 1;
+}
+`,
+      );
+    });
+
+    test("should encode and decode arrays", async ({ expect }) => {
+      const schema = t.object({
+        tags: t.array(t.text()),
+        users: t.array(
+          t.object({
+            name: t.text(),
+            age: t.integer(),
+          }),
+        ),
+      });
+
+      const data = {
+        tags: ["admin", "user"],
+        users: [
+          { name: "John", age: 30 },
+          { name: "Jane", age: 25 },
+        ],
+      };
+
+      const buf = alepha.codec.encode(schema, data, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+      expect(buf).toBeInstanceOf(Uint8Array);
+
+      const decoded = alepha.codec.decode(schema, buf, {
+        encoder: "protobuf",
+      });
+      expect(decoded).toEqual(data);
+    });
+  });
+
+  describe("Nested objects", () => {
+    test("should handle nested objects", async ({ expect }) => {
+      const schema = t.object({
+        user: t.object({
+          profile: t.object({
+            name: t.text(),
+            bio: t.text(),
+          }),
+          settings: t.object({
+            theme: t.text(),
+            notifications: t.boolean(),
+          }),
+        }),
+      });
+
+      const protoSchema = protobuf.createProtobufSchema(schema);
+      expect(protoSchema).toBe(
+        `package root;
+syntax = "proto3";
+
+message Target_user_profile {
+  string name = 1;
+  string bio = 2;
+}
+message Target_user_settings {
+  string theme = 1;
+  bool notifications = 2;
+}
+message Target_user {
+  Target_user_profile profile = 1;
+  Target_user_settings settings = 2;
+}
+message Target {
+  Target_user user = 1;
+}
+`,
+      );
+    });
+
+    test("should encode and decode nested objects", async ({ expect }) => {
+      const schema = t.object({
+        user: t.object({
+          profile: t.object({
+            name: t.text(),
+            bio: t.text(),
+          }),
+          age: t.integer(),
+        }),
+      });
+
+      const data = {
+        user: {
+          profile: {
+            name: "John Doe",
+            bio: "Software developer",
+          },
+          age: 30,
+        },
+      };
+
+      const buf = alepha.codec.encode(schema, data, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+      expect(buf).toBeInstanceOf(Uint8Array);
+
+      const decoded = alepha.codec.decode(schema, buf, {
+        encoder: "protobuf",
+      });
+      expect(decoded).toEqual(data);
+    });
+  });
+
+  describe("Optional and nullable types", () => {
+    test("should handle nullable types", async ({ expect }) => {
+      const schema = t.object({
+        name: t.text(),
+        email: t.nullable(t.text()),
+        age: t.nullable(t.integer()),
+      });
+
+      const protoSchema = protobuf.createProtobufSchema(schema);
+      expect(protoSchema).toBe(
+        `package root;
+syntax = "proto3";
+
+message Target {
+  string name = 1;
+  string email = 2;
+  int32 age = 3;
+}
+`,
+      );
+    });
+
+    test("should encode and decode nullable types", async ({ expect }) => {
+      const schema = t.object({
+        name: t.text(),
+        email: t.nullable(t.text()),
+      });
+
+      const data1 = {
+        name: "John",
+        email: "john@example.com",
+      };
+
+      const data2 = {
+        name: "Jane",
+        email: "", // In proto3, null string becomes empty string
+      };
+
+      const buf1 = alepha.codec.encode(schema, data1, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+      const buf2 = alepha.codec.encode(schema, data2, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+
+      const decoded1 = alepha.codec.decode(schema, buf1, {
+        encoder: "protobuf",
+      });
+      const decoded2 = alepha.codec.decode(schema, buf2, {
+        encoder: "protobuf",
+      });
+
+      expect(decoded1).toEqual(data1);
+      expect(decoded2.name).toEqual("Jane");
+      expect(decoded2.email).toEqual(""); // Proto3 default value for string is ""
+    });
+  });
+
+  describe("Enums and special types", () => {
+    test("should handle enums", async ({ expect }) => {
+      const schema = t.object({
+        status: t.enum(["ACTIVE", "INACTIVE", "PENDING"]),
+        role: t.enum(["USER", "ADMIN", "MODERATOR"]),
+      });
+
+      const protoSchema = protobuf.createProtobufSchema(schema);
+      expect(protoSchema).toBe(
+        `package root;
+syntax = "proto3";
+
+enum Status {
+  ACTIVE = 0;
+  INACTIVE = 1;
+  PENDING = 2;
+}
+enum Role {
+  USER = 0;
+  ADMIN = 1;
+  MODERATOR = 2;
+}
+message Target {
+  Status status = 1;
+  Role role = 2;
+}
+`,
+      );
+    });
+
+    test("should handle special string types", async ({ expect }) => {
+      const schema = t.object({
+        id: t.uuid(),
+        createdAt: t.datetime(),
+        birthDate: t.date(),
+        shortText: t.text({ size: "short" }),
+        longText: t.text({ size: "long" }),
+        richText: t.text({ size: "rich" }),
+      });
+
+      const protoSchema = protobuf.createProtobufSchema(schema);
+      expect(protoSchema).toBe(
+        `package root;
+syntax = "proto3";
+
+message Target {
+  string id = 1;
+  string createdAt = 2;
+  string birthDate = 3;
+  string shortText = 4;
+  string longText = 5;
+  string richText = 6;
+}
+`,
+      );
+    });
+
+    test("should encode and decode enums", async ({ expect }) => {
+      const schema = t.object({
+        status: t.enum(["ACTIVE", "INACTIVE"]),
+        name: t.text(),
+      });
+
+      const data = {
+        status: "ACTIVE",
+        name: "Test",
+      };
+
+      const buf = alepha.codec.encode(schema, data, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+      const decoded = alepha.codec.decode(schema, buf, {
+        encoder: "protobuf",
+      });
+
+      expect(decoded).toEqual(data);
+    });
+  });
+
+  describe("Records (maps)", () => {
+    test("should handle records", async ({ expect }) => {
+      const schema = t.object({
+        metadata: t.record(t.text(), t.text()),
+        scores: t.record(t.text(), t.number()),
+      });
+
+      const protoSchema = protobuf.createProtobufSchema(schema);
+      expect(protoSchema).toBe(
+        `package root;
+syntax = "proto3";
+
+message Target {
+  map<string, string> metadata = 1;
+  map<string, double> scores = 2;
+}
+`,
+      );
+    });
+
+    test("should encode and decode records", async ({ expect }) => {
+      const schema = t.object({
+        metadata: t.record(t.text(), t.text()),
+      });
+
+      const data = {
+        metadata: {
+          version: "1.0.0",
+          author: "John Doe",
+        },
+      };
+
+      const buf = alepha.codec.encode(schema, data, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+      const decoded = alepha.codec.decode(schema, buf, {
+        encoder: "protobuf",
+      });
+
+      expect(decoded).toEqual(data);
+    });
+  });
+
+  describe("Complex combinations", () => {
+    test("should handle complex nested structures", async ({ expect }) => {
+      const schema = t.object({
+        user: t.object({
+          id: t.uuid(),
+          profile: t.object({
+            name: t.text(),
+            age: t.nullable(t.integer()),
+            tags: t.array(t.text()),
+          }),
+          posts: t.array(
+            t.object({
+              title: t.text(),
+              content: t.text({ size: "rich" }),
+              metadata: t.record(t.text(), t.text()),
+            }),
+          ),
+        }),
+        status: t.enum(["ACTIVE", "INACTIVE"]),
+      });
+
+      const data = {
+        user: {
+          id: "123e4567-e89b-12d3-a456-426614174000",
+          profile: {
+            name: "John Doe",
+            age: 30,
+            tags: ["developer", "typescript"],
+          },
+          posts: [
+            {
+              title: "Hello World",
+              content: "This is my first post",
+              metadata: {
+                category: "tech",
+                draft: "false",
+              },
+            },
+          ],
+        },
+        status: "ACTIVE",
+      };
+
+      const buf = alepha.codec.encode(schema, data, {
+        as: "binary",
+        encoder: "protobuf",
+      });
+      const decoded = alepha.codec.decode(schema, buf, {
+        encoder: "protobuf",
+      });
+
+      expect(decoded).toEqual(data);
+    });
+  });
+});