@rocketmq/schema 0.1.0 → 0.1.2

package/.turbo/turbo-build.log

@@ -1,21 +1,23 @@
 
 
-> @rocketmq/schema@0.1.0 build /home/edilson/learnspace/rocketmq-broker/client-ts/packages/schema
+> @rocketmq/schema@0.1.2 build /home/edilson/learnspace/rocketmq-broker/rocketmq.js/packages/schema
 > tsup
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.1
-CLI Using tsup config: /home/edilson/learnspace/rocketmq-broker/client-ts/packages/schema/tsup.config.ts
+CLI Using tsup config: /home/edilson/learnspace/rocketmq-broker/rocketmq.js/packages/schema/tsup.config.ts
 CLI Target: es2022
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 3.21 KB
-CJS ⚡️ Build success in 10ms
-ESM dist/index.js 2.11 KB
-ESM ⚡️ Build success in 10ms
+CJS dist/index.cjs     6.92 KB
+CJS dist/index.cjs.map 13.75 KB
+CJS ⚡️ Build success in 24ms
+ESM dist/index.js     5.83 KB
+ESM dist/index.js.map 13.45 KB
+ESM ⚡️ Build success in 25ms
 DTS Build start
-DTS ⚡️ Build success in 932ms
-DTS dist/index.d.ts  4.01 KB
-DTS dist/index.d.cts 4.01 KB
+DTS ⚡️ Build success in 558ms
+DTS dist/index.d.ts  4.39 KB
+DTS dist/index.d.cts 4.39 KB

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @rocketmq/schema
+
+## 0.1.2
+
+### Patch Changes
+
+- docs: comprehensive README and API docs like Python SDK

package/README.md

@@ -0,0 +1,35 @@
+# @rocketmq/schema
+
+Decorator-based schema definition system for RocketMQ.
+
+Provides the `@Schema()` and `@Field()` decorators used to define queue payload structures. This package automatically collects metadata that the `@rocketmq/core` SDK uses to generate Protobuf schemas for broker-side validation.
+
+## Installation
+
+```bash
+npm install @rocketmq/schema
+```
+
+## Usage
+
+```typescript
+import { Schema, Field } from '@rocketmq/schema';
+
+@Schema()
+export class User {
+  @Field()
+  id!: string;
+
+  @Field()
+  name!: string;
+
+  @Field({ type: 'int32' })
+  age!: number;
+}
+```
+
+This package is re-exported by `@rocketmq/core`, so you can just import from there in most applications.
+
+## License
+
+Apache 2.0

package/dist/index.cjs

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -29,12 +30,34 @@ module.exports = __toCommonJS(index_exports);
 
 // src/registry.ts
 var SchemaRegistry = class {
+  static {
+    __name(this, "SchemaRegistry");
+  }
   /** Queue name → schema entry. */
   byQueue = /* @__PURE__ */ new Map();
   /** Class constructor → field metadata (populated by decorators). */
   fieldStore = /* @__PURE__ */ new Map();
   /** Class constructor → subject prefix (populated by @Schema("subject")). */
   subjectStore = /* @__PURE__ */ new Map();
+  /** Set of all decorated schema constructors. */
+  allSchemas = /* @__PURE__ */ new Set();
+  /** Tracks a constructor as a decorated schema. */
+  registerSchema(ctor) {
+    this.allSchemas.add(ctor);
+  }
+  /** Returns true if a constructor is a registered schema. */
+  isSchema(ctor) {
+    return this.allSchemas.has(ctor);
+  }
+  /** Looks up a schema constructor by its class name. */
+  getSchemaByName(name) {
+    for (const ctor of this.allSchemas) {
+      if (ctor.name === name) {
+        return ctor;
+      }
+    }
+    return void 0;
+  }
   /** Binds a queue name to a fully resolved schema entry. */
   register(queueName, entry) {
     this.byQueue.set(queueName, entry);
@@ -45,7 +68,9 @@ var SchemaRegistry = class {
   }
   /** Returns all registered schema entries. */
   listAll() {
-    return [...this.byQueue.values()];
+    return [
+      ...this.byQueue.values()
+    ];
   }
   /** Stores the subject prefix set by @Schema("subject"). */
   setSubject(ctor, subject) {
@@ -71,9 +96,59 @@ var SchemaRegistry = class {
 };
 var defaultRegistry = new SchemaRegistry();
 
+// src/inference.ts
+function inferFromReflectMetadata(target, key) {
+  const R = Reflect;
+  if (!R.getMetadata) return "string";
+  const designType = R.getMetadata("design:type", target, key);
+  if (!designType) return "string";
+  return inferFromConstructor(designType);
+}
+__name(inferFromReflectMetadata, "inferFromReflectMetadata");
+function inferFromConstructor(ctor) {
+  if (ctor === Number) return "double";
+  if (ctor === Boolean) return "bool";
+  if (ctor === Date) return "google.protobuf.Timestamp";
+  if (ctor === Array || ctor === Object) return "bytes";
+  if (defaultRegistry.isSchema(ctor)) return ctor.name;
+  return "string";
+}
+__name(inferFromConstructor, "inferFromConstructor");
+function inferFromValue(value) {
+  if (value instanceof Date) return "google.protobuf.Timestamp";
+  if (value && typeof value === "object") {
+    const proto = Object.getPrototypeOf(value);
+    if (proto && proto.constructor && defaultRegistry.isSchema(proto.constructor)) {
+      return proto.constructor.name;
+    }
+    return "bytes";
+  }
+  switch (typeof value) {
+    case "number":
+      return "double";
+    case "boolean":
+      return "bool";
+    default:
+      return "string";
+  }
+}
+__name(inferFromValue, "inferFromValue");
+
 // src/decorators.ts
+var import_reflect_metadata = require("reflect-metadata");
+var SCHEMA_SYMBOL = /* @__PURE__ */ Symbol.for("rocketmq:schema");
 function Schema(subject) {
-  return function(target, _ctx) {
+  return function(target, _ctxOrUndefined) {
+    Object.defineProperty(target, SCHEMA_SYMBOL, {
+      value: true,
+      enumerable: false,
+      writable: false
+    });
+    const R = Reflect;
+    if (R.defineMetadata) {
+      R.defineMetadata(SCHEMA_SYMBOL, true, target);
+    }
+    defaultRegistry.registerSchema(target);
     defaultRegistry.getOrCreateFields(target);
     if (subject) {
       defaultRegistry.setSubject(target, subject);
@@ -81,21 +156,61 @@ function Schema(subject) {
     return target;
   };
 }
+__name(Schema, "Schema");
 function Field(opts) {
-  return function(_value, ctx) {
-    const name = String(ctx.name);
+  return function(targetOrValue, keyOrCtx) {
+    if (targetOrValue === void 0 || typeof keyOrCtx === "object") {
+      return handleTC39Field(opts, keyOrCtx);
+    }
+    handleExperimentalField(opts, targetOrValue, keyOrCtx);
+  };
+}
+__name(Field, "Field");
+function handleExperimentalField(opts, target, propertyKey) {
+  const ctor = target.constructor;
+  const name = String(propertyKey);
+  const fields = defaultRegistry.getOrCreateFields(ctor);
+  if (fields.some((f) => f.name === name)) return;
+  const R = Reflect;
+  const reflectedType = R.getMetadata ? R.getMetadata("design:type", target, propertyKey) : void 0;
+  const protoType = opts?.type ?? inferFromReflectMetadata(target, propertyKey);
+  fields.push({
+    name,
+    protoType,
+    number: fields.length + 1,
+    reflectedType,
+    ...opts
+  });
+}
+__name(handleExperimentalField, "handleExperimentalField");
+function handleTC39Field(opts, ctx) {
+  const name = String(ctx.name);
+  if (opts?.type) {
     ctx.addInitializer(function() {
-      const ctor = this.constructor;
-      const fields = defaultRegistry.getOrCreateFields(ctor);
-      if (fields.some((f) => f.name === name)) return;
-      fields.push({
-        name,
-        protoType: opts?.type ?? "string",
-        number: fields.length + 1
-      });
+      registerTC39Field(this, name, opts.type, opts);
     });
+    return;
+  }
+  return function(initialValue) {
+    registerTC39Field(this, name, inferFromValue(initialValue), opts, initialValue);
+    return initialValue;
   };
 }
+__name(handleTC39Field, "handleTC39Field");
+function registerTC39Field(instance, name, protoType, opts, initialValue) {
+  const ctor = instance.constructor;
+  const fields = defaultRegistry.getOrCreateFields(ctor);
+  if (fields.some((f) => f.name === name)) return;
+  const reflectedType = initialValue && typeof initialValue === "object" ? Object.getPrototypeOf(initialValue).constructor : void 0;
+  fields.push({
+    name,
+    protoType,
+    number: fields.length + 1,
+    reflectedType,
+    ...opts
+  });
+}
+__name(registerTC39Field, "registerTC39Field");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Field,
@@ -103,3 +218,4 @@ function Field(opts) {
   SchemaRegistry,
   defaultRegistry
 });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/registry.ts","../src/inference.ts","../src/decorators.ts"],"sourcesContent":["export type { ProtoType, FieldOptions, FieldMeta, SchemaEntry } from './metadata.js';\nexport { SchemaRegistry, defaultRegistry } from './registry.js';\nexport { Schema, Field } from './decorators.js';\nexport type { Constructor } from './types.js';\n","/**\n * In-memory schema registry.\n *\n * Replaces the module-level Map globals from the original schema.ts.\n * Injectable via constructor so tests can use isolated instances.\n */\n\nimport type { FieldMeta, SchemaEntry } from './metadata.js';\nimport type { Constructor } from './types.js';\n\nexport class SchemaRegistry {\n  /** Queue name → schema entry. */\n  private byQueue = new Map<string, SchemaEntry>();\n\n  /** Class constructor → field metadata (populated by decorators). */\n  private fieldStore = new Map<Constructor, FieldMeta[]>();\n\n  /** Class constructor → subject prefix (populated by @Schema(\"subject\")). */\n  private subjectStore = new Map<Constructor, string>();\n\n  /** Set of all decorated schema constructors. */\n  private allSchemas = new Set<Constructor>();\n\n  /** Tracks a constructor as a decorated schema. */\n  registerSchema(ctor: Constructor): void {\n    this.allSchemas.add(ctor);\n  }\n\n  /** Returns true if a constructor is a registered schema. */\n  isSchema(ctor: Constructor): boolean {\n    return this.allSchemas.has(ctor);\n  }\n\n  /** Looks up a schema constructor by its class name. */\n  getSchemaByName(name: string): Constructor | undefined {\n    for (const ctor of this.allSchemas) {\n      if (ctor.name === name) {\n        return ctor;\n      }\n    }\n    return undefined;\n  }\n\n  /** Binds a queue name to a fully resolved schema entry. */\n  register(queueName: string, entry: SchemaEntry): void {\n    this.byQueue.set(queueName, entry);\n  }\n\n  /** Returns the schema entry for a queue, or undefined if unregistered. */\n  lookup(queueName: string): SchemaEntry | undefined {\n    return this.byQueue.get(queueName);\n  }\n\n  /** Returns all registered schema entries. */\n  listAll(): SchemaEntry[] {\n    return [...this.byQueue.values()];\n  }\n\n  /** Stores the subject prefix set by @Schema(\"subject\"). */\n  setSubject(ctor: Constructor, subject: string): void {\n    this.subjectStore.set(ctor, subject);\n  }\n\n  /** Returns the subject prefix for a class, if any. */\n  getSubject(ctor: Constructor): string | undefined {\n    return this.subjectStore.get(ctor);\n  }\n\n  /** Returns the mutable field list for a class, creating it if absent. */\n  getOrCreateFields(ctor: Constructor): FieldMeta[] {\n    let fields = this.fieldStore.get(ctor);\n    if (!fields) {\n      fields = [];\n      this.fieldStore.set(ctor, fields);\n    }\n    return fields;\n  }\n\n  /** Returns the field metadata for a class (read-only snapshot). */\n  getFields(ctor: Constructor): readonly FieldMeta[] {\n    return this.fieldStore.get(ctor) ?? [];\n  }\n}\n\n/**\n * Default singleton registry used by decorators.\n *\n * Exported so @Schema() and @Field() can register metadata at class\n * definition time without requiring explicit wiring. The core package\n * reads from this same instance during publish/consume.\n */\nexport const defaultRegistry = new SchemaRegistry();\n","import { defaultRegistry } from './registry.js';\nimport type { Constructor } from './types.js';\n\n/** Infers proto type from reflect metadata. */\nexport function inferFromReflectMetadata(target: object, key: string | symbol): string {\n  const R = Reflect as unknown as {\n    getMetadata?: (key: string, target: object, prop: string | symbol) => Constructor | undefined;\n  };\n  if (!R.getMetadata) return 'string';\n\n  const designType = R.getMetadata('design:type', target, key);\n  if (!designType) return 'string';\n\n  return inferFromConstructor(designType);\n}\n\n/** Infers type from primitive or schema constructors. */\nexport function inferFromConstructor(ctor: Constructor): string {\n  if (ctor === Number) return 'double';\n  if (ctor === Boolean) return 'bool';\n  if (ctor === Date) return 'google.protobuf.Timestamp';\n  if (ctor === Array || ctor === Object) return 'bytes';\n  if (defaultRegistry.isSchema(ctor)) return ctor.name;\n  return 'string';\n}\n\n/** Infers type from runtime value (TC39). */\nexport function inferFromValue(value: unknown): string {\n  if (value instanceof Date) return 'google.protobuf.Timestamp';\n  if (value && typeof value === 'object') {\n    const proto = Object.getPrototypeOf(value);\n    if (proto && proto.constructor && defaultRegistry.isSchema(proto.constructor)) {\n      return proto.constructor.name;\n    }\n    return 'bytes';\n  }\n  switch (typeof value) {\n    case 'number':\n      return 'double';\n    case 'boolean':\n      return 'bool';\n    default:\n      return 'string';\n  }\n}\n","/**\n * Dual-mode decorators: works with BOTH experimental decorators\n * (reflect-metadata) AND TC39 stage 3 decorators.\n */\n\nimport { inferFromReflectMetadata, inferFromValue } from './inference.js';\nimport type { FieldOptions } from './metadata.js';\nimport { defaultRegistry } from './registry.js';\nimport type { Constructor } from './types.js';\n\nimport 'reflect-metadata';\n\nconst SCHEMA_SYMBOL = Symbol.for('rocketmq:schema');\n\n/** Checks if a constructor is decorated as a schema class. */\nexport function isSchemaClass(ctor: unknown): boolean {\n  if (typeof ctor !== 'function') return false;\n  const R = Reflect as unknown as {\n    hasOwnMetadata?: (k: unknown, t: unknown) => boolean;\n  };\n  return (\n    SCHEMA_SYMBOL in ctor ||\n    (R.hasOwnMetadata !== undefined && R.hasOwnMetadata(SCHEMA_SYMBOL, ctor))\n  );\n}\n\n/** Marks a class as a schema definition. */\nexport function Schema(subject?: string) {\n  return function <T extends Constructor>(target: T, _ctxOrUndefined?: ClassDecoratorContext): T {\n    Object.defineProperty(target, SCHEMA_SYMBOL, {\n      value: true,\n      enumerable: false,\n      writable: false,\n    });\n    const R = Reflect as unknown as {\n      defineMetadata?: (k: unknown, v: unknown, t: unknown) => void;\n    };\n    if (R.defineMetadata) {\n      R.defineMetadata(SCHEMA_SYMBOL, true, target);\n    }\n    defaultRegistry.registerSchema(target);\n    defaultRegistry.getOrCreateFields(target);\n    if (subject) {\n      defaultRegistry.setSubject(target, subject);\n    }\n    return target;\n  };\n}\n\n/** Marks a property as a schema field. */\nexport function Field(opts?: FieldOptions) {\n  return function (\n    targetOrValue: object | undefined,\n    keyOrCtx: string | symbol | ClassFieldDecoratorContext,\n    // WHY void: Node16 moduleResolution enforces TS1271 — decorator return must be void|any.\n    // The TC39 initializer return is consumed by the runtime, not the decorator call site.\n  ): void {\n    if (targetOrValue === undefined || typeof keyOrCtx === 'object') {\n      // WHY cast: TC39 path returns an initializer function at runtime,\n      // but the .d.ts must declare void to satisfy experimental decorator constraints.\n      return handleTC39Field(opts, keyOrCtx as ClassFieldDecoratorContext) as void;\n    }\n    handleExperimentalField(opts, targetOrValue, keyOrCtx as string | symbol);\n  };\n}\n\n/** Experimental decorator path. */\nfunction handleExperimentalField(\n  opts: FieldOptions | undefined,\n  target: object,\n  propertyKey: string | symbol,\n): void {\n  const ctor = target.constructor as Constructor;\n  const name = String(propertyKey);\n  const fields = defaultRegistry.getOrCreateFields(ctor);\n\n  if (fields.some((f) => f.name === name)) return;\n\n  const R = Reflect as unknown as {\n    getMetadata?: (k: string, t: object, p: string | symbol) => Constructor | undefined;\n  };\n  const reflectedType = R.getMetadata\n    ? R.getMetadata('design:type', target, propertyKey)\n    : undefined;\n  const protoType = opts?.type ?? inferFromReflectMetadata(target, propertyKey);\n\n  fields.push({\n    name,\n    protoType,\n    number: fields.length + 1,\n    reflectedType,\n    ...opts,\n  });\n}\n\n/* v8 ignore start */\n/** TC39 stage 3 decorator path. */\nfunction handleTC39Field(\n  opts: FieldOptions | undefined,\n  ctx: ClassFieldDecoratorContext,\n): ((this: unknown, initialValue: unknown) => unknown) | void {\n  const name = String(ctx.name);\n\n  if (opts?.type) {\n    ctx.addInitializer(function (this: unknown) {\n      registerTC39Field(this, name, opts.type!, opts);\n    });\n    return;\n  }\n\n  return function (this: unknown, initialValue: unknown): unknown {\n    registerTC39Field(this, name, inferFromValue(initialValue), opts, initialValue);\n    return initialValue;\n  };\n}\n\n/** Internal TC39 helper to register field inside initializer. */\nfunction registerTC39Field(\n  instance: unknown,\n  name: string,\n  protoType: string,\n  opts: FieldOptions | undefined,\n  initialValue?: unknown,\n): void {\n  const ctor = (instance as Record<string, unknown>).constructor as Constructor;\n  const fields = defaultRegistry.getOrCreateFields(ctor);\n  if (fields.some((f) => f.name === name)) return;\n\n  const reflectedType =\n    initialValue && typeof initialValue === 'object'\n      ? (Object.getPrototypeOf(initialValue).constructor as Constructor)\n      : undefined;\n\n  fields.push({\n    name,\n    protoType,\n    number: fields.length + 1,\n    reflectedType,\n    ...opts,\n  });\n}\n"],"mappings":"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","names":["SchemaRegistry","byQueue","Map","fieldStore","subjectStore","allSchemas","Set","registerSchema","ctor","add","isSchema","has","getSchemaByName","name","undefined","register","queueName","entry","set","lookup","get","listAll","values","setSubject","subject","getSubject","getOrCreateFields","fields","getFields","defaultRegistry","inferFromReflectMetadata","target","key","R","Reflect","getMetadata","designType","inferFromConstructor","ctor","Number","Boolean","Date","Array","Object","defaultRegistry","isSchema","name","inferFromValue","value","proto","getPrototypeOf","SCHEMA_SYMBOL","Symbol","for","Schema","subject","target","_ctxOrUndefined","Object","defineProperty","SCHEMA_SYMBOL","value","enumerable","writable","R","Reflect","defineMetadata","defaultRegistry","registerSchema","getOrCreateFields","setSubject","Field","opts","targetOrValue","keyOrCtx","undefined","handleTC39Field","handleExperimentalField","propertyKey","ctor","name","String","fields","some","f","reflectedType","getMetadata","protoType","type","inferFromReflectMetadata","push","number","length","ctx","addInitializer","registerTC39Field","initialValue","inferFromValue","instance","getPrototypeOf"]}

package/dist/index.d.cts

@@ -1,26 +1,45 @@
+/**
+ * Core type definitions for the schema package.
+ */
+/**
+ * Represents a class constructor.
+ * Used to replace the generic 'Function' type for stricter type safety.
+ */
+type Constructor<T = object> = new (...args: any[]) => T;
+
 /**
  * Protobuf wire types supported by the schema decorator system.
  *
  * Maps 1:1 to proto3 scalar types so the SDK can generate
  * `.proto` definitions without requiring protobuf knowledge.
- *
- * Usage:
- *   @Field({ type: "int32" }) qty!: number;
  */
 type ProtoType = 'string' | 'int32' | 'int64' | 'uint32' | 'uint64' | 'float' | 'double' | 'bool' | 'bytes';
+/** Additional configuration options passed to the @Field() decorator. */
+interface FieldOptions {
+    /** Explicit proto3 type override (scalar or custom message name). */
+    type?: string;
+    /** Emits 'repeated' prefix for arrays. */
+    repeated?: boolean;
+    /** Emits 'optional' prefix for optional presence. */
+    optional?: boolean;
+    /** Inline comment written above the field. */
+    comment?: string;
+}
 /** Metadata captured by the @Field() decorator for a single class property. */
-interface FieldMeta {
+interface FieldMeta extends FieldOptions {
     /** Property name on the decorated class. */
     name: string;
-    /** Proto3 scalar type. Defaults to "string" when omitted. */
-    protoType: ProtoType;
+    /** Proto3 type. Defaults to "string" when omitted. */
+    protoType: string;
     /** 1-based field number for proto ordering. */
     number: number;
+    /** Constructor captured by reflect-metadata (String, Number, Boolean, Date, etc.). */
+    reflectedType?: Constructor;
 }
 /** Collected metadata for a decorated schema class. */
 interface SchemaEntry {
     /** Class constructor reference. */
-    ctor: Function;
+    ctor: Constructor;
     /** Human-readable schema name (defaults to class name). */
     name: string;
     /** Optional subject prefix for registry-based validation. */
@@ -34,11 +53,6 @@ interface SchemaEntry {
  *
  * Replaces the module-level Map globals from the original schema.ts.
  * Injectable via constructor so tests can use isolated instances.
- *
- * Usage:
- *   const registry = new SchemaRegistry();
- *   registry.register("orders", entry);
- *   const entry = registry.lookup("orders");
  */
 
 declare class SchemaRegistry {
@@ -48,6 +62,14 @@ declare class SchemaRegistry {
     private fieldStore;
     /** Class constructor → subject prefix (populated by @Schema("subject")). */
     private subjectStore;
+    /** Set of all decorated schema constructors. */
+    private allSchemas;
+    /** Tracks a constructor as a decorated schema. */
+    registerSchema(ctor: Constructor): void;
+    /** Returns true if a constructor is a registered schema. */
+    isSchema(ctor: Constructor): boolean;
+    /** Looks up a schema constructor by its class name. */
+    getSchemaByName(name: string): Constructor | undefined;
     /** Binds a queue name to a fully resolved schema entry. */
     register(queueName: string, entry: SchemaEntry): void;
     /** Returns the schema entry for a queue, or undefined if unregistered. */
@@ -55,13 +77,13 @@ declare class SchemaRegistry {
     /** Returns all registered schema entries. */
     listAll(): SchemaEntry[];
     /** Stores the subject prefix set by @Schema("subject"). */
-    setSubject(ctor: Function, subject: string): void;
+    setSubject(ctor: Constructor, subject: string): void;
     /** Returns the subject prefix for a class, if any. */
-    getSubject(ctor: Function): string | undefined;
+    getSubject(ctor: Constructor): string | undefined;
     /** Returns the mutable field list for a class, creating it if absent. */
-    getOrCreateFields(ctor: Function): FieldMeta[];
+    getOrCreateFields(ctor: Constructor): FieldMeta[];
     /** Returns the field metadata for a class (read-only snapshot). */
-    getFields(ctor: Function): readonly FieldMeta[];
+    getFields(ctor: Constructor): readonly FieldMeta[];
 }
 /**
  * Default singleton registry used by decorators.
@@ -73,37 +95,13 @@ declare class SchemaRegistry {
 declare const defaultRegistry: SchemaRegistry;
 
 /**
- * TC39 stage 3 decorators for schema definition.
- *
- * Collects field names and types from decorated classes into the
- * default SchemaRegistry so the SDK can generate proto3 definitions
- * and validate payloads at runtime.
- *
- * Usage:
- *   @Schema("notifications")
- *   class Notification {
- *     @Field() id!: string;
- *     @Field({ type: "int64" }) timestamp!: number;
- *   }
+ * Dual-mode decorators: works with BOTH experimental decorators
+ * (reflect-metadata) AND TC39 stage 3 decorators.
  */
 
-/**
- * Marks a class as a schema definition.
- *
- * @param subject - Optional subject prefix for registry-based validation
- *                  (e.g. "notifications" → "notifications-value").
- */
-declare function Schema(subject?: string): <T extends new (...args: unknown[]) => object>(target: T, _ctx: ClassDecoratorContext) => T;
-interface FieldOptions {
-    /** Proto3 scalar type. Defaults to "string". */
-    type?: ProtoType;
-}
-/**
- * Marks a property as a schema field (TC39 stage 3 field decorator).
- *
- * Defers registration to `addInitializer` so the class constructor is
- * fully defined before we read `this.constructor`.
- */
-declare function Field(opts?: FieldOptions): (_value: undefined, ctx: ClassFieldDecoratorContext) => void;
+/** Marks a class as a schema definition. */
+declare function Schema(subject?: string): <T extends Constructor>(target: T, _ctxOrUndefined?: ClassDecoratorContext) => T;
+/** Marks a property as a schema field. */
+declare function Field(opts?: FieldOptions): (targetOrValue: object | undefined, keyOrCtx: string | symbol | ClassFieldDecoratorContext) => void;
 
-export { Field, type FieldMeta, type ProtoType, Schema, type SchemaEntry, SchemaRegistry, defaultRegistry };
+export { type Constructor, Field, type FieldMeta, type FieldOptions, type ProtoType, Schema, type SchemaEntry, SchemaRegistry, defaultRegistry };

package/dist/index.d.ts

@@ -1,26 +1,45 @@
+/**
+ * Core type definitions for the schema package.
+ */
+/**
+ * Represents a class constructor.
+ * Used to replace the generic 'Function' type for stricter type safety.
+ */
+type Constructor<T = object> = new (...args: any[]) => T;
+
 /**
  * Protobuf wire types supported by the schema decorator system.
  *
  * Maps 1:1 to proto3 scalar types so the SDK can generate
  * `.proto` definitions without requiring protobuf knowledge.
- *
- * Usage:
- *   @Field({ type: "int32" }) qty!: number;
  */
 type ProtoType = 'string' | 'int32' | 'int64' | 'uint32' | 'uint64' | 'float' | 'double' | 'bool' | 'bytes';
+/** Additional configuration options passed to the @Field() decorator. */
+interface FieldOptions {
+    /** Explicit proto3 type override (scalar or custom message name). */
+    type?: string;
+    /** Emits 'repeated' prefix for arrays. */
+    repeated?: boolean;
+    /** Emits 'optional' prefix for optional presence. */
+    optional?: boolean;
+    /** Inline comment written above the field. */
+    comment?: string;
+}
 /** Metadata captured by the @Field() decorator for a single class property. */
-interface FieldMeta {
+interface FieldMeta extends FieldOptions {
     /** Property name on the decorated class. */
     name: string;
-    /** Proto3 scalar type. Defaults to "string" when omitted. */
-    protoType: ProtoType;
+    /** Proto3 type. Defaults to "string" when omitted. */
+    protoType: string;
     /** 1-based field number for proto ordering. */
     number: number;
+    /** Constructor captured by reflect-metadata (String, Number, Boolean, Date, etc.). */
+    reflectedType?: Constructor;
 }
 /** Collected metadata for a decorated schema class. */
 interface SchemaEntry {
     /** Class constructor reference. */
-    ctor: Function;
+    ctor: Constructor;
     /** Human-readable schema name (defaults to class name). */
     name: string;
     /** Optional subject prefix for registry-based validation. */
@@ -34,11 +53,6 @@ interface SchemaEntry {
  *
  * Replaces the module-level Map globals from the original schema.ts.
  * Injectable via constructor so tests can use isolated instances.
- *
- * Usage:
- *   const registry = new SchemaRegistry();
- *   registry.register("orders", entry);
- *   const entry = registry.lookup("orders");
  */
 
 declare class SchemaRegistry {
@@ -48,6 +62,14 @@ declare class SchemaRegistry {
     private fieldStore;
     /** Class constructor → subject prefix (populated by @Schema("subject")). */
     private subjectStore;
+    /** Set of all decorated schema constructors. */
+    private allSchemas;
+    /** Tracks a constructor as a decorated schema. */
+    registerSchema(ctor: Constructor): void;
+    /** Returns true if a constructor is a registered schema. */
+    isSchema(ctor: Constructor): boolean;
+    /** Looks up a schema constructor by its class name. */
+    getSchemaByName(name: string): Constructor | undefined;
     /** Binds a queue name to a fully resolved schema entry. */
     register(queueName: string, entry: SchemaEntry): void;
     /** Returns the schema entry for a queue, or undefined if unregistered. */
@@ -55,13 +77,13 @@ declare class SchemaRegistry {
     /** Returns all registered schema entries. */
     listAll(): SchemaEntry[];
     /** Stores the subject prefix set by @Schema("subject"). */
-    setSubject(ctor: Function, subject: string): void;
+    setSubject(ctor: Constructor, subject: string): void;
     /** Returns the subject prefix for a class, if any. */
-    getSubject(ctor: Function): string | undefined;
+    getSubject(ctor: Constructor): string | undefined;
     /** Returns the mutable field list for a class, creating it if absent. */
-    getOrCreateFields(ctor: Function): FieldMeta[];
+    getOrCreateFields(ctor: Constructor): FieldMeta[];
     /** Returns the field metadata for a class (read-only snapshot). */
-    getFields(ctor: Function): readonly FieldMeta[];
+    getFields(ctor: Constructor): readonly FieldMeta[];
 }
 /**
  * Default singleton registry used by decorators.
@@ -73,37 +95,13 @@ declare class SchemaRegistry {
 declare const defaultRegistry: SchemaRegistry;
 
 /**
- * TC39 stage 3 decorators for schema definition.
- *
- * Collects field names and types from decorated classes into the
- * default SchemaRegistry so the SDK can generate proto3 definitions
- * and validate payloads at runtime.
- *
- * Usage:
- *   @Schema("notifications")
- *   class Notification {
- *     @Field() id!: string;
- *     @Field({ type: "int64" }) timestamp!: number;
- *   }
+ * Dual-mode decorators: works with BOTH experimental decorators
+ * (reflect-metadata) AND TC39 stage 3 decorators.
  */
 
-/**
- * Marks a class as a schema definition.
- *
- * @param subject - Optional subject prefix for registry-based validation
- *                  (e.g. "notifications" → "notifications-value").
- */
-declare function Schema(subject?: string): <T extends new (...args: unknown[]) => object>(target: T, _ctx: ClassDecoratorContext) => T;
-interface FieldOptions {
-    /** Proto3 scalar type. Defaults to "string". */
-    type?: ProtoType;
-}
-/**
- * Marks a property as a schema field (TC39 stage 3 field decorator).
- *
- * Defers registration to `addInitializer` so the class constructor is
- * fully defined before we read `this.constructor`.
- */
-declare function Field(opts?: FieldOptions): (_value: undefined, ctx: ClassFieldDecoratorContext) => void;
+/** Marks a class as a schema definition. */
+declare function Schema(subject?: string): <T extends Constructor>(target: T, _ctxOrUndefined?: ClassDecoratorContext) => T;
+/** Marks a property as a schema field. */
+declare function Field(opts?: FieldOptions): (targetOrValue: object | undefined, keyOrCtx: string | symbol | ClassFieldDecoratorContext) => void;
 
-export { Field, type FieldMeta, type ProtoType, Schema, type SchemaEntry, SchemaRegistry, defaultRegistry };
+export { type Constructor, Field, type FieldMeta, type FieldOptions, type ProtoType, Schema, type SchemaEntry, SchemaRegistry, defaultRegistry };

package/dist/index.js

@@ -1,11 +1,36 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
 // src/registry.ts
 var SchemaRegistry = class {
+  static {
+    __name(this, "SchemaRegistry");
+  }
   /** Queue name → schema entry. */
   byQueue = /* @__PURE__ */ new Map();
   /** Class constructor → field metadata (populated by decorators). */
   fieldStore = /* @__PURE__ */ new Map();
   /** Class constructor → subject prefix (populated by @Schema("subject")). */
   subjectStore = /* @__PURE__ */ new Map();
+  /** Set of all decorated schema constructors. */
+  allSchemas = /* @__PURE__ */ new Set();
+  /** Tracks a constructor as a decorated schema. */
+  registerSchema(ctor) {
+    this.allSchemas.add(ctor);
+  }
+  /** Returns true if a constructor is a registered schema. */
+  isSchema(ctor) {
+    return this.allSchemas.has(ctor);
+  }
+  /** Looks up a schema constructor by its class name. */
+  getSchemaByName(name) {
+    for (const ctor of this.allSchemas) {
+      if (ctor.name === name) {
+        return ctor;
+      }
+    }
+    return void 0;
+  }
   /** Binds a queue name to a fully resolved schema entry. */
   register(queueName, entry) {
     this.byQueue.set(queueName, entry);
@@ -16,7 +41,9 @@ var SchemaRegistry = class {
   }
   /** Returns all registered schema entries. */
   listAll() {
-    return [...this.byQueue.values()];
+    return [
+      ...this.byQueue.values()
+    ];
   }
   /** Stores the subject prefix set by @Schema("subject"). */
   setSubject(ctor, subject) {
@@ -42,9 +69,59 @@ var SchemaRegistry = class {
 };
 var defaultRegistry = new SchemaRegistry();
 
+// src/inference.ts
+function inferFromReflectMetadata(target, key) {
+  const R = Reflect;
+  if (!R.getMetadata) return "string";
+  const designType = R.getMetadata("design:type", target, key);
+  if (!designType) return "string";
+  return inferFromConstructor(designType);
+}
+__name(inferFromReflectMetadata, "inferFromReflectMetadata");
+function inferFromConstructor(ctor) {
+  if (ctor === Number) return "double";
+  if (ctor === Boolean) return "bool";
+  if (ctor === Date) return "google.protobuf.Timestamp";
+  if (ctor === Array || ctor === Object) return "bytes";
+  if (defaultRegistry.isSchema(ctor)) return ctor.name;
+  return "string";
+}
+__name(inferFromConstructor, "inferFromConstructor");
+function inferFromValue(value) {
+  if (value instanceof Date) return "google.protobuf.Timestamp";
+  if (value && typeof value === "object") {
+    const proto = Object.getPrototypeOf(value);
+    if (proto && proto.constructor && defaultRegistry.isSchema(proto.constructor)) {
+      return proto.constructor.name;
+    }
+    return "bytes";
+  }
+  switch (typeof value) {
+    case "number":
+      return "double";
+    case "boolean":
+      return "bool";
+    default:
+      return "string";
+  }
+}
+__name(inferFromValue, "inferFromValue");
+
 // src/decorators.ts
+import "reflect-metadata";
+var SCHEMA_SYMBOL = /* @__PURE__ */ Symbol.for("rocketmq:schema");
 function Schema(subject) {
-  return function(target, _ctx) {
+  return function(target, _ctxOrUndefined) {
+    Object.defineProperty(target, SCHEMA_SYMBOL, {
+      value: true,
+      enumerable: false,
+      writable: false
+    });
+    const R = Reflect;
+    if (R.defineMetadata) {
+      R.defineMetadata(SCHEMA_SYMBOL, true, target);
+    }
+    defaultRegistry.registerSchema(target);
     defaultRegistry.getOrCreateFields(target);
     if (subject) {
       defaultRegistry.setSubject(target, subject);
@@ -52,24 +129,65 @@ function Schema(subject) {
     return target;
   };
 }
+__name(Schema, "Schema");
 function Field(opts) {
-  return function(_value, ctx) {
-    const name = String(ctx.name);
+  return function(targetOrValue, keyOrCtx) {
+    if (targetOrValue === void 0 || typeof keyOrCtx === "object") {
+      return handleTC39Field(opts, keyOrCtx);
+    }
+    handleExperimentalField(opts, targetOrValue, keyOrCtx);
+  };
+}
+__name(Field, "Field");
+function handleExperimentalField(opts, target, propertyKey) {
+  const ctor = target.constructor;
+  const name = String(propertyKey);
+  const fields = defaultRegistry.getOrCreateFields(ctor);
+  if (fields.some((f) => f.name === name)) return;
+  const R = Reflect;
+  const reflectedType = R.getMetadata ? R.getMetadata("design:type", target, propertyKey) : void 0;
+  const protoType = opts?.type ?? inferFromReflectMetadata(target, propertyKey);
+  fields.push({
+    name,
+    protoType,
+    number: fields.length + 1,
+    reflectedType,
+    ...opts
+  });
+}
+__name(handleExperimentalField, "handleExperimentalField");
+function handleTC39Field(opts, ctx) {
+  const name = String(ctx.name);
+  if (opts?.type) {
     ctx.addInitializer(function() {
-      const ctor = this.constructor;
-      const fields = defaultRegistry.getOrCreateFields(ctor);
-      if (fields.some((f) => f.name === name)) return;
-      fields.push({
-        name,
-        protoType: opts?.type ?? "string",
-        number: fields.length + 1
-      });
+      registerTC39Field(this, name, opts.type, opts);
     });
+    return;
+  }
+  return function(initialValue) {
+    registerTC39Field(this, name, inferFromValue(initialValue), opts, initialValue);
+    return initialValue;
   };
 }
+__name(handleTC39Field, "handleTC39Field");
+function registerTC39Field(instance, name, protoType, opts, initialValue) {
+  const ctor = instance.constructor;
+  const fields = defaultRegistry.getOrCreateFields(ctor);
+  if (fields.some((f) => f.name === name)) return;
+  const reflectedType = initialValue && typeof initialValue === "object" ? Object.getPrototypeOf(initialValue).constructor : void 0;
+  fields.push({
+    name,
+    protoType,
+    number: fields.length + 1,
+    reflectedType,
+    ...opts
+  });
+}
+__name(registerTC39Field, "registerTC39Field");
 export {
   Field,
   Schema,
   SchemaRegistry,
   defaultRegistry
 };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registry.ts","../src/inference.ts","../src/decorators.ts"],"sourcesContent":["/**\n * In-memory schema registry.\n *\n * Replaces the module-level Map globals from the original schema.ts.\n * Injectable via constructor so tests can use isolated instances.\n */\n\nimport type { FieldMeta, SchemaEntry } from './metadata.js';\nimport type { Constructor } from './types.js';\n\nexport class SchemaRegistry {\n  /** Queue name → schema entry. */\n  private byQueue = new Map<string, SchemaEntry>();\n\n  /** Class constructor → field metadata (populated by decorators). */\n  private fieldStore = new Map<Constructor, FieldMeta[]>();\n\n  /** Class constructor → subject prefix (populated by @Schema(\"subject\")). */\n  private subjectStore = new Map<Constructor, string>();\n\n  /** Set of all decorated schema constructors. */\n  private allSchemas = new Set<Constructor>();\n\n  /** Tracks a constructor as a decorated schema. */\n  registerSchema(ctor: Constructor): void {\n    this.allSchemas.add(ctor);\n  }\n\n  /** Returns true if a constructor is a registered schema. */\n  isSchema(ctor: Constructor): boolean {\n    return this.allSchemas.has(ctor);\n  }\n\n  /** Looks up a schema constructor by its class name. */\n  getSchemaByName(name: string): Constructor | undefined {\n    for (const ctor of this.allSchemas) {\n      if (ctor.name === name) {\n        return ctor;\n      }\n    }\n    return undefined;\n  }\n\n  /** Binds a queue name to a fully resolved schema entry. */\n  register(queueName: string, entry: SchemaEntry): void {\n    this.byQueue.set(queueName, entry);\n  }\n\n  /** Returns the schema entry for a queue, or undefined if unregistered. */\n  lookup(queueName: string): SchemaEntry | undefined {\n    return this.byQueue.get(queueName);\n  }\n\n  /** Returns all registered schema entries. */\n  listAll(): SchemaEntry[] {\n    return [...this.byQueue.values()];\n  }\n\n  /** Stores the subject prefix set by @Schema(\"subject\"). */\n  setSubject(ctor: Constructor, subject: string): void {\n    this.subjectStore.set(ctor, subject);\n  }\n\n  /** Returns the subject prefix for a class, if any. */\n  getSubject(ctor: Constructor): string | undefined {\n    return this.subjectStore.get(ctor);\n  }\n\n  /** Returns the mutable field list for a class, creating it if absent. */\n  getOrCreateFields(ctor: Constructor): FieldMeta[] {\n    let fields = this.fieldStore.get(ctor);\n    if (!fields) {\n      fields = [];\n      this.fieldStore.set(ctor, fields);\n    }\n    return fields;\n  }\n\n  /** Returns the field metadata for a class (read-only snapshot). */\n  getFields(ctor: Constructor): readonly FieldMeta[] {\n    return this.fieldStore.get(ctor) ?? [];\n  }\n}\n\n/**\n * Default singleton registry used by decorators.\n *\n * Exported so @Schema() and @Field() can register metadata at class\n * definition time without requiring explicit wiring. The core package\n * reads from this same instance during publish/consume.\n */\nexport const defaultRegistry = new SchemaRegistry();\n","import { defaultRegistry } from './registry.js';\nimport type { Constructor } from './types.js';\n\n/** Infers proto type from reflect metadata. */\nexport function inferFromReflectMetadata(target: object, key: string | symbol): string {\n  const R = Reflect as unknown as {\n    getMetadata?: (key: string, target: object, prop: string | symbol) => Constructor | undefined;\n  };\n  if (!R.getMetadata) return 'string';\n\n  const designType = R.getMetadata('design:type', target, key);\n  if (!designType) return 'string';\n\n  return inferFromConstructor(designType);\n}\n\n/** Infers type from primitive or schema constructors. */\nexport function inferFromConstructor(ctor: Constructor): string {\n  if (ctor === Number) return 'double';\n  if (ctor === Boolean) return 'bool';\n  if (ctor === Date) return 'google.protobuf.Timestamp';\n  if (ctor === Array || ctor === Object) return 'bytes';\n  if (defaultRegistry.isSchema(ctor)) return ctor.name;\n  return 'string';\n}\n\n/** Infers type from runtime value (TC39). */\nexport function inferFromValue(value: unknown): string {\n  if (value instanceof Date) return 'google.protobuf.Timestamp';\n  if (value && typeof value === 'object') {\n    const proto = Object.getPrototypeOf(value);\n    if (proto && proto.constructor && defaultRegistry.isSchema(proto.constructor)) {\n      return proto.constructor.name;\n    }\n    return 'bytes';\n  }\n  switch (typeof value) {\n    case 'number':\n      return 'double';\n    case 'boolean':\n      return 'bool';\n    default:\n      return 'string';\n  }\n}\n","/**\n * Dual-mode decorators: works with BOTH experimental decorators\n * (reflect-metadata) AND TC39 stage 3 decorators.\n */\n\nimport { inferFromReflectMetadata, inferFromValue } from './inference.js';\nimport type { FieldOptions } from './metadata.js';\nimport { defaultRegistry } from './registry.js';\nimport type { Constructor } from './types.js';\n\nimport 'reflect-metadata';\n\nconst SCHEMA_SYMBOL = Symbol.for('rocketmq:schema');\n\n/** Checks if a constructor is decorated as a schema class. */\nexport function isSchemaClass(ctor: unknown): boolean {\n  if (typeof ctor !== 'function') return false;\n  const R = Reflect as unknown as {\n    hasOwnMetadata?: (k: unknown, t: unknown) => boolean;\n  };\n  return (\n    SCHEMA_SYMBOL in ctor ||\n    (R.hasOwnMetadata !== undefined && R.hasOwnMetadata(SCHEMA_SYMBOL, ctor))\n  );\n}\n\n/** Marks a class as a schema definition. */\nexport function Schema(subject?: string) {\n  return function <T extends Constructor>(target: T, _ctxOrUndefined?: ClassDecoratorContext): T {\n    Object.defineProperty(target, SCHEMA_SYMBOL, {\n      value: true,\n      enumerable: false,\n      writable: false,\n    });\n    const R = Reflect as unknown as {\n      defineMetadata?: (k: unknown, v: unknown, t: unknown) => void;\n    };\n    if (R.defineMetadata) {\n      R.defineMetadata(SCHEMA_SYMBOL, true, target);\n    }\n    defaultRegistry.registerSchema(target);\n    defaultRegistry.getOrCreateFields(target);\n    if (subject) {\n      defaultRegistry.setSubject(target, subject);\n    }\n    return target;\n  };\n}\n\n/** Marks a property as a schema field. */\nexport function Field(opts?: FieldOptions) {\n  return function (\n    targetOrValue: object | undefined,\n    keyOrCtx: string | symbol | ClassFieldDecoratorContext,\n    // WHY void: Node16 moduleResolution enforces TS1271 — decorator return must be void|any.\n    // The TC39 initializer return is consumed by the runtime, not the decorator call site.\n  ): void {\n    if (targetOrValue === undefined || typeof keyOrCtx === 'object') {\n      // WHY cast: TC39 path returns an initializer function at runtime,\n      // but the .d.ts must declare void to satisfy experimental decorator constraints.\n      return handleTC39Field(opts, keyOrCtx as ClassFieldDecoratorContext) as void;\n    }\n    handleExperimentalField(opts, targetOrValue, keyOrCtx as string | symbol);\n  };\n}\n\n/** Experimental decorator path. */\nfunction handleExperimentalField(\n  opts: FieldOptions | undefined,\n  target: object,\n  propertyKey: string | symbol,\n): void {\n  const ctor = target.constructor as Constructor;\n  const name = String(propertyKey);\n  const fields = defaultRegistry.getOrCreateFields(ctor);\n\n  if (fields.some((f) => f.name === name)) return;\n\n  const R = Reflect as unknown as {\n    getMetadata?: (k: string, t: object, p: string | symbol) => Constructor | undefined;\n  };\n  const reflectedType = R.getMetadata\n    ? R.getMetadata('design:type', target, propertyKey)\n    : undefined;\n  const protoType = opts?.type ?? inferFromReflectMetadata(target, propertyKey);\n\n  fields.push({\n    name,\n    protoType,\n    number: fields.length + 1,\n    reflectedType,\n    ...opts,\n  });\n}\n\n/* v8 ignore start */\n/** TC39 stage 3 decorator path. */\nfunction handleTC39Field(\n  opts: FieldOptions | undefined,\n  ctx: ClassFieldDecoratorContext,\n): ((this: unknown, initialValue: unknown) => unknown) | void {\n  const name = String(ctx.name);\n\n  if (opts?.type) {\n    ctx.addInitializer(function (this: unknown) {\n      registerTC39Field(this, name, opts.type!, opts);\n    });\n    return;\n  }\n\n  return function (this: unknown, initialValue: unknown): unknown {\n    registerTC39Field(this, name, inferFromValue(initialValue), opts, initialValue);\n    return initialValue;\n  };\n}\n\n/** Internal TC39 helper to register field inside initializer. */\nfunction registerTC39Field(\n  instance: unknown,\n  name: string,\n  protoType: string,\n  opts: FieldOptions | undefined,\n  initialValue?: unknown,\n): void {\n  const ctor = (instance as Record<string, unknown>).constructor as Constructor;\n  const fields = defaultRegistry.getOrCreateFields(ctor);\n  if (fields.some((f) => f.name === name)) return;\n\n  const reflectedType =\n    initialValue && typeof initialValue === 'object'\n      ? (Object.getPrototypeOf(initialValue).constructor as Constructor)\n      : undefined;\n\n  fields.push({\n    name,\n    protoType,\n    number: fields.length + 1,\n    reflectedType,\n    ...opts,\n  });\n}\n"],"mappings":"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","names":["SchemaRegistry","byQueue","Map","fieldStore","subjectStore","allSchemas","Set","registerSchema","ctor","add","isSchema","has","getSchemaByName","name","undefined","register","queueName","entry","set","lookup","get","listAll","values","setSubject","subject","getSubject","getOrCreateFields","fields","getFields","defaultRegistry","inferFromReflectMetadata","target","key","R","Reflect","getMetadata","designType","inferFromConstructor","ctor","Number","Boolean","Date","Array","Object","defaultRegistry","isSchema","name","inferFromValue","value","proto","getPrototypeOf","SCHEMA_SYMBOL","Symbol","for","Schema","subject","target","_ctxOrUndefined","Object","defineProperty","SCHEMA_SYMBOL","value","enumerable","writable","R","Reflect","defineMetadata","defaultRegistry","registerSchema","getOrCreateFields","setSubject","Field","opts","targetOrValue","keyOrCtx","undefined","handleTC39Field","handleExperimentalField","propertyKey","ctor","name","String","fields","some","f","reflectedType","getMetadata","protoType","type","inferFromReflectMetadata","push","number","length","ctx","addInitializer","registerTC39Field","initialValue","inferFromValue","instance","getPrototypeOf"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocketmq/schema",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "exports": {
     ".": {
@@ -8,6 +8,9 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "dependencies": {
+    "reflect-metadata": "^0.2.2"
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run"

package/src/decorators.test.ts

@@ -7,9 +7,22 @@
  */
 
 import { describe, it, expect } from 'vitest';
-import { Schema, Field } from './decorators.js';
+import { Schema, Field, isSchemaClass } from './decorators.js';
 import { defaultRegistry } from './registry.js';
 
+describe('isSchemaClass', () => {
+  it('detects valid and invalid schemas', () => {
+    @Schema()
+    class A {}
+    expect(isSchemaClass(A)).toBe(true);
+
+    class B {}
+    expect(isSchemaClass(B)).toBe(false);
+    expect(isSchemaClass(null)).toBe(false);
+    expect(isSchemaClass(123)).toBe(false);
+  });
+});
+
 describe('@Schema() decorator', () => {
   it('registers field list for a decorated class', () => {
     @Schema()

package/src/decorators.ts

@@ -1,35 +1,45 @@
 /**
- * TC39 stage 3 decorators for schema definition.
- *
- * Collects field names and types from decorated classes into the
- * default SchemaRegistry so the SDK can generate proto3 definitions
- * and validate payloads at runtime.
- *
- * Usage:
- *   @Schema("notifications")
- *   class Notification {
- *     @Field() id!: string;
- *     @Field({ type: "int64" }) timestamp!: number;
- *   }
+ * Dual-mode decorators: works with BOTH experimental decorators
+ * (reflect-metadata) AND TC39 stage 3 decorators.
  */
 
-import type { ProtoType } from './metadata.js';
+import { inferFromReflectMetadata, inferFromValue } from './inference.js';
+import type { FieldOptions } from './metadata.js';
 import { defaultRegistry } from './registry.js';
+import type { Constructor } from './types.js';
 
-/**
- * Marks a class as a schema definition.
- *
- * @param subject - Optional subject prefix for registry-based validation
- *                  (e.g. "notifications" → "notifications-value").
- */
+import 'reflect-metadata';
+
+const SCHEMA_SYMBOL = Symbol.for('rocketmq:schema');
+
+/** Checks if a constructor is decorated as a schema class. */
+export function isSchemaClass(ctor: unknown): boolean {
+  if (typeof ctor !== 'function') return false;
+  const R = Reflect as unknown as {
+    hasOwnMetadata?: (k: unknown, t: unknown) => boolean;
+  };
+  return (
+    SCHEMA_SYMBOL in ctor ||
+    (R.hasOwnMetadata !== undefined && R.hasOwnMetadata(SCHEMA_SYMBOL, ctor))
+  );
+}
+
+/** Marks a class as a schema definition. */
 export function Schema(subject?: string) {
-  return function <T extends new (...args: unknown[]) => object>(
-    target: T,
-    _ctx: ClassDecoratorContext,
-  ): T {
-    // Ensure the field list exists even if no @Field() was used
+  return function <T extends Constructor>(target: T, _ctxOrUndefined?: ClassDecoratorContext): T {
+    Object.defineProperty(target, SCHEMA_SYMBOL, {
+      value: true,
+      enumerable: false,
+      writable: false,
+    });
+    const R = Reflect as unknown as {
+      defineMetadata?: (k: unknown, v: unknown, t: unknown) => void;
+    };
+    if (R.defineMetadata) {
+      R.defineMetadata(SCHEMA_SYMBOL, true, target);
+    }
+    defaultRegistry.registerSchema(target);
     defaultRegistry.getOrCreateFields(target);
-
     if (subject) {
       defaultRegistry.setSubject(target, subject);
     }
@@ -37,33 +47,95 @@ export function Schema(subject?: string) {
   };
 }
 
-interface FieldOptions {
-  /** Proto3 scalar type. Defaults to "string". */
-  type?: ProtoType;
+/** Marks a property as a schema field. */
+export function Field(opts?: FieldOptions) {
+  return function (
+    targetOrValue: object | undefined,
+    keyOrCtx: string | symbol | ClassFieldDecoratorContext,
+    // WHY void: Node16 moduleResolution enforces TS1271 — decorator return must be void|any.
+    // The TC39 initializer return is consumed by the runtime, not the decorator call site.
+  ): void {
+    if (targetOrValue === undefined || typeof keyOrCtx === 'object') {
+      // WHY cast: TC39 path returns an initializer function at runtime,
+      // but the .d.ts must declare void to satisfy experimental decorator constraints.
+      return handleTC39Field(opts, keyOrCtx as ClassFieldDecoratorContext) as void;
+    }
+    handleExperimentalField(opts, targetOrValue, keyOrCtx as string | symbol);
+  };
 }
 
-/**
- * Marks a property as a schema field (TC39 stage 3 field decorator).
- *
- * Defers registration to `addInitializer` so the class constructor is
- * fully defined before we read `this.constructor`.
- */
-export function Field(opts?: FieldOptions) {
-  return function (_value: undefined, ctx: ClassFieldDecoratorContext) {
-    const name = String(ctx.name);
+/** Experimental decorator path. */
+function handleExperimentalField(
+  opts: FieldOptions | undefined,
+  target: object,
+  propertyKey: string | symbol,
+): void {
+  const ctor = target.constructor as Constructor;
+  const name = String(propertyKey);
+  const fields = defaultRegistry.getOrCreateFields(ctor);
 
-    ctx.addInitializer(function (this: unknown) {
-      const ctor = (this as Record<string, unknown>).constructor as Function;
-      const fields = defaultRegistry.getOrCreateFields(ctor);
+  if (fields.some((f) => f.name === name)) return;
+
+  const R = Reflect as unknown as {
+    getMetadata?: (k: string, t: object, p: string | symbol) => Constructor | undefined;
+  };
+  const reflectedType = R.getMetadata
+    ? R.getMetadata('design:type', target, propertyKey)
+    : undefined;
+  const protoType = opts?.type ?? inferFromReflectMetadata(target, propertyKey);
+
+  fields.push({
+    name,
+    protoType,
+    number: fields.length + 1,
+    reflectedType,
+    ...opts,
+  });
+}
 
-      // Prevent duplicate registrations from multiple instantiations
-      if (fields.some((f) => f.name === name)) return;
+/* v8 ignore start */
+/** TC39 stage 3 decorator path. */
+function handleTC39Field(
+  opts: FieldOptions | undefined,
+  ctx: ClassFieldDecoratorContext,
+): ((this: unknown, initialValue: unknown) => unknown) | void {
+  const name = String(ctx.name);
 
-      fields.push({
-        name,
-        protoType: opts?.type ?? 'string',
-        number: fields.length + 1,
-      });
+  if (opts?.type) {
+    ctx.addInitializer(function (this: unknown) {
+      registerTC39Field(this, name, opts.type!, opts);
     });
+    return;
+  }
+
+  return function (this: unknown, initialValue: unknown): unknown {
+    registerTC39Field(this, name, inferFromValue(initialValue), opts, initialValue);
+    return initialValue;
   };
 }
+
+/** Internal TC39 helper to register field inside initializer. */
+function registerTC39Field(
+  instance: unknown,
+  name: string,
+  protoType: string,
+  opts: FieldOptions | undefined,
+  initialValue?: unknown,
+): void {
+  const ctor = (instance as Record<string, unknown>).constructor as Constructor;
+  const fields = defaultRegistry.getOrCreateFields(ctor);
+  if (fields.some((f) => f.name === name)) return;
+
+  const reflectedType =
+    initialValue && typeof initialValue === 'object'
+      ? (Object.getPrototypeOf(initialValue).constructor as Constructor)
+      : undefined;
+
+  fields.push({
+    name,
+    protoType,
+    number: fields.length + 1,
+    reflectedType,
+    ...opts,
+  });
+}

package/src/index.ts

@@ -1,3 +1,4 @@
-export type { ProtoType, FieldMeta, SchemaEntry } from './metadata.js';
+export type { ProtoType, FieldOptions, FieldMeta, SchemaEntry } from './metadata.js';
 export { SchemaRegistry, defaultRegistry } from './registry.js';
 export { Schema, Field } from './decorators.js';
+export type { Constructor } from './types.js';

package/src/inference.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { inferFromConstructor, inferFromValue, inferFromReflectMetadata } from './inference.js';
+import { defaultRegistry } from './registry.js';
+
+describe('inference', () => {
+  describe('inferFromConstructor', () => {
+    it('infers proto types from JS constructors', () => {
+      expect(inferFromConstructor(Number)).toBe('double');
+      expect(inferFromConstructor(Boolean)).toBe('bool');
+      expect(inferFromConstructor(Date)).toBe('google.protobuf.Timestamp');
+      expect(inferFromConstructor(Array)).toBe('bytes');
+      expect(inferFromConstructor(Object)).toBe('bytes');
+      expect(inferFromConstructor(String)).toBe('string');
+    });
+
+    it('infers from schema constructors', () => {
+      class NestedSchema {}
+      defaultRegistry.registerSchema(NestedSchema);
+      expect(inferFromConstructor(NestedSchema)).toBe('NestedSchema');
+    });
+  });
+
+  describe('inferFromValue', () => {
+    it('infers proto types from JS values', () => {
+      expect(inferFromValue(1)).toBe('double');
+      expect(inferFromValue(true)).toBe('bool');
+      expect(inferFromValue(new Date())).toBe('google.protobuf.Timestamp');
+      expect(inferFromValue([])).toBe('bytes');
+      expect(inferFromValue({})).toBe('bytes');
+      expect(inferFromValue('hello')).toBe('string');
+      expect(inferFromValue(undefined)).toBe('string');
+    });
+
+    it('infers from schema instances', () => {
+      class NestedSchema {}
+      defaultRegistry.registerSchema(NestedSchema);
+      expect(inferFromValue(new NestedSchema())).toBe('NestedSchema');
+    });
+  });
+
+  describe('inferFromReflectMetadata', () => {
+    it('falls back to string if design:type is missing', () => {
+      expect(inferFromReflectMetadata({}, 'key')).toBe('string');
+    });
+  });
+});

package/src/inference.ts

@@ -0,0 +1,45 @@
+import { defaultRegistry } from './registry.js';
+import type { Constructor } from './types.js';
+
+/** Infers proto type from reflect metadata. */
+export function inferFromReflectMetadata(target: object, key: string | symbol): string {
+  const R = Reflect as unknown as {
+    getMetadata?: (key: string, target: object, prop: string | symbol) => Constructor | undefined;
+  };
+  if (!R.getMetadata) return 'string';
+
+  const designType = R.getMetadata('design:type', target, key);
+  if (!designType) return 'string';
+
+  return inferFromConstructor(designType);
+}
+
+/** Infers type from primitive or schema constructors. */
+export function inferFromConstructor(ctor: Constructor): string {
+  if (ctor === Number) return 'double';
+  if (ctor === Boolean) return 'bool';
+  if (ctor === Date) return 'google.protobuf.Timestamp';
+  if (ctor === Array || ctor === Object) return 'bytes';
+  if (defaultRegistry.isSchema(ctor)) return ctor.name;
+  return 'string';
+}
+
+/** Infers type from runtime value (TC39). */
+export function inferFromValue(value: unknown): string {
+  if (value instanceof Date) return 'google.protobuf.Timestamp';
+  if (value && typeof value === 'object') {
+    const proto = Object.getPrototypeOf(value);
+    if (proto && proto.constructor && defaultRegistry.isSchema(proto.constructor)) {
+      return proto.constructor.name;
+    }
+    return 'bytes';
+  }
+  switch (typeof value) {
+    case 'number':
+      return 'double';
+    case 'boolean':
+      return 'bool';
+    default:
+      return 'string';
+  }
+}

package/src/metadata.ts

@@ -1,11 +1,10 @@
+import type { Constructor } from './types.js';
+
 /**
  * Protobuf wire types supported by the schema decorator system.
  *
  * Maps 1:1 to proto3 scalar types so the SDK can generate
  * `.proto` definitions without requiring protobuf knowledge.
- *
- * Usage:
- *   @Field({ type: "int32" }) qty!: number;
  */
 export type ProtoType =
   | 'string'
@@ -18,20 +17,34 @@ export type ProtoType =
   | 'bool'
   | 'bytes';
 
+/** Additional configuration options passed to the @Field() decorator. */
+export interface FieldOptions {
+  /** Explicit proto3 type override (scalar or custom message name). */
+  type?: string;
+  /** Emits 'repeated' prefix for arrays. */
+  repeated?: boolean;
+  /** Emits 'optional' prefix for optional presence. */
+  optional?: boolean;
+  /** Inline comment written above the field. */
+  comment?: string;
+}
+
 /** Metadata captured by the @Field() decorator for a single class property. */
-export interface FieldMeta {
+export interface FieldMeta extends FieldOptions {
   /** Property name on the decorated class. */
   name: string;
-  /** Proto3 scalar type. Defaults to "string" when omitted. */
-  protoType: ProtoType;
+  /** Proto3 type. Defaults to "string" when omitted. */
+  protoType: string;
   /** 1-based field number for proto ordering. */
   number: number;
+  /** Constructor captured by reflect-metadata (String, Number, Boolean, Date, etc.). */
+  reflectedType?: Constructor;
 }
 
 /** Collected metadata for a decorated schema class. */
 export interface SchemaEntry {
   /** Class constructor reference. */
-  ctor: Function;
+  ctor: Constructor;
   /** Human-readable schema name (defaults to class name). */
   name: string;
   /** Optional subject prefix for registry-based validation. */

package/src/registry.test.ts

@@ -43,6 +43,22 @@ describe('SchemaRegistry', () => {
     });
   });
 
+  describe('schema constructors', () => {
+    it('tracks decorated schemas via isSchema', () => {
+      class A {}
+      registry.registerSchema(A);
+      expect(registry.isSchema(A)).toBe(true);
+      expect(registry.isSchema(class B {})).toBe(false);
+    });
+
+    it('looks up schema constructor by name', () => {
+      class FooSchema {}
+      registry.registerSchema(FooSchema);
+      expect(registry.getSchemaByName('FooSchema')).toBe(FooSchema);
+      expect(registry.getSchemaByName('BarSchema')).toBeUndefined();
+    });
+  });
+
   describe('listAll', () => {
     it('returns empty array when nothing registered', () => {
       expect(registry.listAll()).toEqual([]);

package/src/registry.ts

@@ -3,24 +3,43 @@
  *
  * Replaces the module-level Map globals from the original schema.ts.
  * Injectable via constructor so tests can use isolated instances.
- *
- * Usage:
- *   const registry = new SchemaRegistry();
- *   registry.register("orders", entry);
- *   const entry = registry.lookup("orders");
  */
 
 import type { FieldMeta, SchemaEntry } from './metadata.js';
+import type { Constructor } from './types.js';
 
 export class SchemaRegistry {
   /** Queue name → schema entry. */
   private byQueue = new Map<string, SchemaEntry>();
 
   /** Class constructor → field metadata (populated by decorators). */
-  private fieldStore = new Map<Function, FieldMeta[]>();
+  private fieldStore = new Map<Constructor, FieldMeta[]>();
 
   /** Class constructor → subject prefix (populated by @Schema("subject")). */
-  private subjectStore = new Map<Function, string>();
+  private subjectStore = new Map<Constructor, string>();
+
+  /** Set of all decorated schema constructors. */
+  private allSchemas = new Set<Constructor>();
+
+  /** Tracks a constructor as a decorated schema. */
+  registerSchema(ctor: Constructor): void {
+    this.allSchemas.add(ctor);
+  }
+
+  /** Returns true if a constructor is a registered schema. */
+  isSchema(ctor: Constructor): boolean {
+    return this.allSchemas.has(ctor);
+  }
+
+  /** Looks up a schema constructor by its class name. */
+  getSchemaByName(name: string): Constructor | undefined {
+    for (const ctor of this.allSchemas) {
+      if (ctor.name === name) {
+        return ctor;
+      }
+    }
+    return undefined;
+  }
 
   /** Binds a queue name to a fully resolved schema entry. */
   register(queueName: string, entry: SchemaEntry): void {
@@ -38,17 +57,17 @@ export class SchemaRegistry {
   }
 
   /** Stores the subject prefix set by @Schema("subject"). */
-  setSubject(ctor: Function, subject: string): void {
+  setSubject(ctor: Constructor, subject: string): void {
     this.subjectStore.set(ctor, subject);
   }
 
   /** Returns the subject prefix for a class, if any. */
-  getSubject(ctor: Function): string | undefined {
+  getSubject(ctor: Constructor): string | undefined {
     return this.subjectStore.get(ctor);
   }
 
   /** Returns the mutable field list for a class, creating it if absent. */
-  getOrCreateFields(ctor: Function): FieldMeta[] {
+  getOrCreateFields(ctor: Constructor): FieldMeta[] {
     let fields = this.fieldStore.get(ctor);
     if (!fields) {
       fields = [];
@@ -58,7 +77,7 @@ export class SchemaRegistry {
   }
 
   /** Returns the field metadata for a class (read-only snapshot). */
-  getFields(ctor: Function): readonly FieldMeta[] {
+  getFields(ctor: Constructor): readonly FieldMeta[] {
     return this.fieldStore.get(ctor) ?? [];
   }
 }

package/src/types.ts

@@ -0,0 +1,10 @@
+/**
+ * Core type definitions for the schema package.
+ */
+
+/**
+ * Represents a class constructor.
+ * Used to replace the generic 'Function' type for stricter type safety.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type Constructor<T = object> = new (...args: any[]) => T;

package/tsup.config.ts

@@ -5,4 +5,5 @@ export default defineConfig({
   format: ["esm", "cjs"],
   dts: true,
   clean: true,
+  sourcemap: true,
 });