@hexaijs/plugin-contracts-generator 0.2.0 → 0.2.1

package/dist/runtime/index.d.ts

@@ -10,7 +10,7 @@ interface MessageClass<T = any> {
     getSchemaVersion(): Version;
     getType(): string;
     from(rawPayload: Record<string, unknown>, header?: MessageHeaders): T;
-    new (payload: any, headers?: any): T;
+    new (payload: any, options?: any): T;
 }
 declare class MessageRegistry {
     private readonly registry;

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/message-registry.ts"],"names":[],"mappings":";AAmBO,IAAM,kBAAN,MAAsB;AAAA,EACR,QAAA,uBAAe,GAAA,EAA0B;AAAA,EAE1D,SAAS,YAAA,EAAkC;AACvC,IAAA,MAAM,IAAA,GAAO,aAAa,OAAA,EAAQ;AAClC,IAAA,MAAM,OAAA,GAAU,aAAa,gBAAA,EAAiB;AAC9C,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAEjC,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAG,CAAA,EAAG;AACxB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,OAAO,IAAA,EAAM,OAAO,CAAC,CAAA,uBAAA,CAAyB,CAAA;AAAA,IACrE;AAEA,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAA,EAAK,YAAY,CAAA;AACnC,IAAA,OAAO,IAAA;AAAA,EACX;AAAA,EAEA,SAAA,CAAa,QAAwB,IAAA,EAAkC;AACnE,IAAA,MAAM,EAAE,IAAA,EAAM,aAAA,EAAc,GAAI,MAAA;AAChC,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,IAAA,EAAM,aAAa,CAAA;AACvC,IAAA,MAAM,YAAA,GAAe,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAG,CAAA;AAE1C,IAAA,IAAI,CAAC,YAAA,EAAc;AACf,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,OAAO,IAAA,EAAM,aAAa,CAAC,CAAA,mBAAA,CAAqB,CAAA;AAAA,IACvE;AAEA,IAAA,OAAO,YAAA,CAAa,IAAA,CAAK,IAAA,EAAM,MAAM,CAAA;AAAA,EACzC;AAAA,EAEA,GAAA,CAAI,MAAc,OAAA,EAA4B;AAC1C,IAAA,OAAO,KAAK,QAAA,CAAS,GAAA,CAAI,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAC,CAAA;AAAA,EACnD;AAAA,EAEA,IAAA,GAAe;AACX,IAAA,OAAO,KAAK,QAAA,CAAS,IAAA;AAAA,EACzB;AACJ;AAEA,SAAS,OAAA,CAAQ,MAAc,OAAA,EAA2B;AACtD,EAAA,OAAO,YAAY,MAAA,GAAY,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,GAAK,IAAA;AAC1D;AAEA,SAAS,MAAA,CAAO,MAAc,OAAA,EAA2B;AACrD,EAAA,OAAO,OAAA,KAAY,SAAY,CAAA,CAAA,EAAI,IAAI,OAAO,OAAO,CAAA,CAAA,CAAA,GAAM,IAAI,IAAI,CAAA,CAAA,CAAA;AACvE","file":"index.js","sourcesContent":["type Version = string | number | undefined;\n\nexport interface MessageHeaders {\n    id: string;\n    type: string;\n    schemaVersion?: Version;\n    createdAt: Date;\n    [key: string]: unknown;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface MessageClass<T = any> {\n    getSchemaVersion(): Version;\n    getType(): string;\n    from(rawPayload: Record<string, unknown>, header?: MessageHeaders): T;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    new (payload: any, headers?: any): T;\n}\n\nexport class MessageRegistry {\n    private readonly registry = new Map<string, MessageClass>();\n\n    register(messageClass: MessageClass): this {\n        const type = messageClass.getType();\n        const version = messageClass.getSchemaVersion();\n        const key = makeKey(type, version);\n\n        if (this.registry.has(key)) {\n            throw new Error(`${format(type, version)} is already registered.`);\n        }\n\n        this.registry.set(key, messageClass);\n        return this;\n    }\n\n    dehydrate<T>(header: MessageHeaders, body: Record<string, unknown>): T {\n        const { type, schemaVersion } = header;\n        const key = makeKey(type, schemaVersion);\n        const messageClass = this.registry.get(key);\n\n        if (!messageClass) {\n            throw new Error(`${format(type, schemaVersion)} is not registered.`);\n        }\n\n        return messageClass.from(body, header) as T;\n    }\n\n    has(type: string, version?: Version): boolean {\n        return this.registry.has(makeKey(type, version));\n    }\n\n    size(): number {\n        return this.registry.size;\n    }\n}\n\nfunction makeKey(type: string, version?: Version): string {\n    return version !== undefined ? `${type}:${version}` : type;\n}\n\nfunction format(type: string, version?: Version): string {\n    return version !== undefined ? `'${type}' (v${version})` : `'${type}'`;\n}\n"]}
+{"version":3,"sources":["../../src/runtime/message-registry.ts"],"names":[],"mappings":";AAmBO,IAAM,kBAAN,MAAsB;AAAA,EACR,QAAA,uBAAe,GAAA,EAA0B;AAAA,EAE1D,SAAS,YAAA,EAAkC;AACvC,IAAA,MAAM,IAAA,GAAO,aAAa,OAAA,EAAQ;AAClC,IAAA,MAAM,OAAA,GAAU,aAAa,gBAAA,EAAiB;AAC9C,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAEjC,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAG,CAAA,EAAG;AACxB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,OAAO,IAAA,EAAM,OAAO,CAAC,CAAA,uBAAA,CAAyB,CAAA;AAAA,IACrE;AAEA,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAA,EAAK,YAAY,CAAA;AACnC,IAAA,OAAO,IAAA;AAAA,EACX;AAAA,EAEA,SAAA,CAAa,QAAwB,IAAA,EAAkC;AACnE,IAAA,MAAM,EAAE,IAAA,EAAM,aAAA,EAAc,GAAI,MAAA;AAChC,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,IAAA,EAAM,aAAa,CAAA;AACvC,IAAA,MAAM,YAAA,GAAe,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAG,CAAA;AAE1C,IAAA,IAAI,CAAC,YAAA,EAAc;AACf,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,OAAO,IAAA,EAAM,aAAa,CAAC,CAAA,mBAAA,CAAqB,CAAA;AAAA,IACvE;AAEA,IAAA,OAAO,YAAA,CAAa,IAAA,CAAK,IAAA,EAAM,MAAM,CAAA;AAAA,EACzC;AAAA,EAEA,GAAA,CAAI,MAAc,OAAA,EAA4B;AAC1C,IAAA,OAAO,KAAK,QAAA,CAAS,GAAA,CAAI,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAC,CAAA;AAAA,EACnD;AAAA,EAEA,IAAA,GAAe;AACX,IAAA,OAAO,KAAK,QAAA,CAAS,IAAA;AAAA,EACzB;AACJ;AAEA,SAAS,OAAA,CAAQ,MAAc,OAAA,EAA2B;AACtD,EAAA,OAAO,YAAY,MAAA,GAAY,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,GAAK,IAAA;AAC1D;AAEA,SAAS,MAAA,CAAO,MAAc,OAAA,EAA2B;AACrD,EAAA,OAAO,OAAA,KAAY,SAAY,CAAA,CAAA,EAAI,IAAI,OAAO,OAAO,CAAA,CAAA,CAAA,GAAM,IAAI,IAAI,CAAA,CAAA,CAAA;AACvE","file":"index.js","sourcesContent":["type Version = string | number | undefined;\n\nexport interface MessageHeaders {\n    id: string;\n    type: string;\n    schemaVersion?: Version;\n    createdAt: Date;\n    [key: string]: unknown;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface MessageClass<T = any> {\n    getSchemaVersion(): Version;\n    getType(): string;\n    from(rawPayload: Record<string, unknown>, header?: MessageHeaders): T;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    new (payload: any, options?: any): T;\n}\n\nexport class MessageRegistry {\n    private readonly registry = new Map<string, MessageClass>();\n\n    register(messageClass: MessageClass): this {\n        const type = messageClass.getType();\n        const version = messageClass.getSchemaVersion();\n        const key = makeKey(type, version);\n\n        if (this.registry.has(key)) {\n            throw new Error(`${format(type, version)} is already registered.`);\n        }\n\n        this.registry.set(key, messageClass);\n        return this;\n    }\n\n    dehydrate<T>(header: MessageHeaders, body: Record<string, unknown>): T {\n        const { type, schemaVersion } = header;\n        const key = makeKey(type, schemaVersion);\n        const messageClass = this.registry.get(key);\n\n        if (!messageClass) {\n            throw new Error(`${format(type, schemaVersion)} is not registered.`);\n        }\n\n        return messageClass.from(body, header) as T;\n    }\n\n    has(type: string, version?: Version): boolean {\n        return this.registry.has(makeKey(type, version));\n    }\n\n    size(): number {\n        return this.registry.size;\n    }\n}\n\nfunction makeKey(type: string, version?: Version): string {\n    return version !== undefined ? `${type}:${version}` : type;\n}\n\nfunction format(type: string, version?: Version): string {\n    return version !== undefined ? `'${type}' (v${version})` : `'${type}'`;\n}\n"]}

package/package.json

@@ -3,7 +3,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.2.0",
+    "version": "0.2.1",
     "type": "module",
     "description": "Collect domain events and commands from bounded contexts and generate frontend-compatible contracts package",
     "license": "MIT",
@@ -31,10 +31,6 @@
             "types": "./dist/index.d.ts",
             "import": "./dist/index.js"
         },
-        "./decorators": {
-            "types": "./dist/decorators/index.d.ts",
-            "import": "./dist/decorators/index.js"
-        },
         "./runtime": {
             "types": "./dist/runtime/index.d.ts",
             "import": "./dist/runtime/index.js"
@@ -49,9 +45,9 @@
         "build": "tsup"
     },
     "dependencies": {
+        "@hexaijs/contracts": "workspace:^",
         "glob": "^10.3.0",
-        "minimatch": "^9.0.0",
-        "reflect-metadata": "^0.2.2"
+        "minimatch": "^9.0.0"
     },
     "peerDependencies": {
         "@hexaijs/cli": "^0.2.0",

package/dist/decorators/index.d.ts

@@ -1,144 +0,0 @@
-/**
- * Decorators for marking Domain Events and Commands.
- * These decorators have no runtime effect - the Message Parser
- * statically analyzes source code to find and extract them.
- */
-
-interface PublicEventOptions {
-    /**
-     * Event version for versioned events
-     * @example @PublicEvent({ version: 2 })
-     */
-    version?: number;
-    /**
-     * Business context this event belongs to
-     * If not specified, inferred from package name
-     * @example @PublicEvent({ context: 'lecture' })
-     */
-    context?: string;
-}
-interface PublicCommandOptions {
-    /**
-     * Business context this command belongs to
-     * If not specified, inferred from package name
-     * @example @PublicCommand({ context: 'auth' })
-     */
-    context?: string;
-    /**
-     * Explicit response type name for this command
-     * If specified, the parser will look for this type in the same file
-     * @example @PublicCommand({ response: 'CreateUserResult' })
-     */
-    response?: string;
-}
-interface PublicQueryOptions {
-    /**
-     * Business context this query belongs to
-     * If not specified, inferred from package name
-     * @example @PublicQuery({ context: 'catalog' })
-     */
-    context?: string;
-    /**
-     * Explicit response type name for this query
-     * If specified, the parser will look for this type in the same file
-     * @example @PublicQuery({ response: 'UserProfile' })
-     */
-    response?: string;
-}
-declare const PUBLIC_EVENT_METADATA: unique symbol;
-declare const PUBLIC_COMMAND_METADATA: unique symbol;
-declare const PUBLIC_QUERY_METADATA: unique symbol;
-/**
- * Marks a class as a Domain Event for extraction to public contracts
- *
- * @example
- * ```typescript
- * @PublicEvent()
- * export class UserRegistered extends Message {
- *   constructor(
- *     public readonly userId: string,
- *     public readonly email: string,
- *   ) {
- *     super();
- *   }
- * }
- * ```
- *
- * @example With options
- * ```typescript
- * @PublicEvent({ version: 2, context: 'auth' })
- * export class UserRegisteredV2 extends Message {
- *   // ...
- * }
- * ```
- */
-declare function PublicEvent(options?: PublicEventOptions): ClassDecorator;
-/**
- * Marks a class as a Command for extraction to public contracts
- *
- * @example
- * ```typescript
- * @PublicCommand()
- * export class CreateUser extends Request<CreateUserResult> {
- *   constructor(
- *     public readonly email: string,
- *     public readonly name: string,
- *   ) {
- *     super();
- *   }
- * }
- * ```
- *
- * @example With context option
- * ```typescript
- * @PublicCommand({ context: 'auth' })
- * export class CreateUser extends Request<CreateUserResult> {
- *   // ...
- * }
- * ```
- *
- * @example With explicit response type
- * ```typescript
- * @PublicCommand({ response: 'DialogueCreatedResult' })
- * export class BeginDialogueRequest extends Request<DialogueCreatedResult> {
- *   // ...
- * }
- * export type DialogueCreatedResult = { dialogueId: string };
- * ```
- */
-declare function PublicCommand(options?: PublicCommandOptions): ClassDecorator;
-/**
- * Marks a class as a Query for extraction to public contracts
- *
- * @example
- * ```typescript
- * @PublicQuery()
- * export class GetUserProfile extends Request<UserProfile> {
- *   constructor(
- *     public readonly userId: string,
- *   ) {
- *     super();
- *   }
- * }
- * ```
- *
- * @example With context option
- * ```typescript
- * @PublicQuery({ context: 'catalog' })
- * export class GetProductDetails extends Request<ProductDetails> {
- *   // ...
- * }
- * ```
- *
- * @example With explicit response type
- * ```typescript
- * @PublicQuery({ response: 'UserProfileResult' })
- * export class GetUserProfile extends Request<UserProfileResult> {
- *   // ...
- * }
- * export type UserProfileResult = { name: string; email: string };
- * ```
- */
-declare function PublicQuery(options?: PublicQueryOptions): ClassDecorator;
-
-export { PUBLIC_COMMAND_METADATA, PUBLIC_EVENT_METADATA, PUBLIC_QUERY_METADATA, PublicCommand, type PublicCommandOptions, PublicEvent, type PublicEventOptions, PublicQuery, type PublicQueryOptions };

package/dist/decorators/index.js

@@ -1,28 +0,0 @@
-import 'reflect-metadata';
-
-// src/decorators/index.ts
-var PUBLIC_EVENT_METADATA = /* @__PURE__ */ Symbol("publicEvent");
-var PUBLIC_COMMAND_METADATA = /* @__PURE__ */ Symbol("publicCommand");
-var PUBLIC_QUERY_METADATA = /* @__PURE__ */ Symbol("publicQuery");
-function PublicEvent(options = {}) {
-  return (target) => {
-    Reflect.defineMetadata(PUBLIC_EVENT_METADATA, options, target);
-    return target;
-  };
-}
-function PublicCommand(options = {}) {
-  return (target) => {
-    Reflect.defineMetadata(PUBLIC_COMMAND_METADATA, options, target);
-    return target;
-  };
-}
-function PublicQuery(options = {}) {
-  return (target) => {
-    Reflect.defineMetadata(PUBLIC_QUERY_METADATA, options, target);
-    return target;
-  };
-}
-
-export { PUBLIC_COMMAND_METADATA, PUBLIC_EVENT_METADATA, PUBLIC_QUERY_METADATA, PublicCommand, PublicEvent, PublicQuery };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;AAuDO,IAAM,qBAAA,0BAA+B,aAAa;AAClD,IAAM,uBAAA,0BAAiC,eAAe;AACtD,IAAM,qBAAA,0BAA+B,aAAa;AA0BlD,SAAS,WAAA,CAAY,OAAA,GAA8B,EAAC,EAAmB;AAC5E,EAAA,OAAO,CAAC,MAAA,KAAW;AACjB,IAAA,OAAA,CAAQ,cAAA,CAAe,qBAAA,EAAuB,OAAA,EAAS,MAAM,CAAA;AAC7D,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF;AAmCO,SAAS,aAAA,CAAc,OAAA,GAAgC,EAAC,EAAmB;AAChF,EAAA,OAAO,CAAC,MAAA,KAAW;AACjB,IAAA,OAAA,CAAQ,cAAA,CAAe,uBAAA,EAAyB,OAAA,EAAS,MAAM,CAAA;AAC/D,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF;AAmCO,SAAS,WAAA,CAAY,OAAA,GAA8B,EAAC,EAAmB;AAC5E,EAAA,OAAO,CAAC,MAAA,KAAW;AACjB,IAAA,OAAA,CAAQ,cAAA,CAAe,qBAAA,EAAuB,OAAA,EAAS,MAAM,CAAA;AAC7D,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF","file":"index.js","sourcesContent":["/**\n * Decorators for marking Domain Events and Commands.\n * These decorators have no runtime effect - the Message Parser\n * statically analyzes source code to find and extract them.\n */\nimport \"reflect-metadata\";\n\nexport interface PublicEventOptions {\n  /**\n   * Event version for versioned events\n   * @example @PublicEvent({ version: 2 })\n   */\n  version?: number;\n\n  /**\n   * Business context this event belongs to\n   * If not specified, inferred from package name\n   * @example @PublicEvent({ context: 'lecture' })\n   */\n  context?: string;\n}\n\nexport interface PublicCommandOptions {\n  /**\n   * Business context this command belongs to\n   * If not specified, inferred from package name\n   * @example @PublicCommand({ context: 'auth' })\n   */\n  context?: string;\n\n  /**\n   * Explicit response type name for this command\n   * If specified, the parser will look for this type in the same file\n   * @example @PublicCommand({ response: 'CreateUserResult' })\n   */\n  response?: string;\n}\n\n\nexport interface PublicQueryOptions {\n  /**\n   * Business context this query belongs to\n   * If not specified, inferred from package name\n   * @example @PublicQuery({ context: 'catalog' })\n   */\n  context?: string;\n\n  /**\n   * Explicit response type name for this query\n   * If specified, the parser will look for this type in the same file\n   * @example @PublicQuery({ response: 'UserProfile' })\n   */\n  response?: string;\n}\n\nexport const PUBLIC_EVENT_METADATA = Symbol('publicEvent');\nexport const PUBLIC_COMMAND_METADATA = Symbol('publicCommand');\nexport const PUBLIC_QUERY_METADATA = Symbol('publicQuery');\n\n/**\n * Marks a class as a Domain Event for extraction to public contracts\n *\n * @example\n * ```typescript\n * @PublicEvent()\n * export class UserRegistered extends Message {\n *   constructor(\n *     public readonly userId: string,\n *     public readonly email: string,\n *   ) {\n *     super();\n *   }\n * }\n * ```\n *\n * @example With options\n * ```typescript\n * @PublicEvent({ version: 2, context: 'auth' })\n * export class UserRegisteredV2 extends Message {\n *   // ...\n * }\n * ```\n */\nexport function PublicEvent(options: PublicEventOptions = {}): ClassDecorator {\n  return (target) => {\n    Reflect.defineMetadata(PUBLIC_EVENT_METADATA, options, target);\n    return target;\n  };\n}\n\n/**\n * Marks a class as a Command for extraction to public contracts\n *\n * @example\n * ```typescript\n * @PublicCommand()\n * export class CreateUser extends Request<CreateUserResult> {\n *   constructor(\n *     public readonly email: string,\n *     public readonly name: string,\n *   ) {\n *     super();\n *   }\n * }\n * ```\n *\n * @example With context option\n * ```typescript\n * @PublicCommand({ context: 'auth' })\n * export class CreateUser extends Request<CreateUserResult> {\n *   // ...\n * }\n * ```\n *\n * @example With explicit response type\n * ```typescript\n * @PublicCommand({ response: 'DialogueCreatedResult' })\n * export class BeginDialogueRequest extends Request<DialogueCreatedResult> {\n *   // ...\n * }\n * export type DialogueCreatedResult = { dialogueId: string };\n * ```\n */\nexport function PublicCommand(options: PublicCommandOptions = {}): ClassDecorator {\n  return (target) => {\n    Reflect.defineMetadata(PUBLIC_COMMAND_METADATA, options, target);\n    return target;\n  };\n}\n\n\n/**\n * Marks a class as a Query for extraction to public contracts\n *\n * @example\n * ```typescript\n * @PublicQuery()\n * export class GetUserProfile extends Request<UserProfile> {\n *   constructor(\n *     public readonly userId: string,\n *   ) {\n *     super();\n *   }\n * }\n * ```\n *\n * @example With context option\n * ```typescript\n * @PublicQuery({ context: 'catalog' })\n * export class GetProductDetails extends Request<ProductDetails> {\n *   // ...\n * }\n * ```\n *\n * @example With explicit response type\n * ```typescript\n * @PublicQuery({ response: 'UserProfileResult' })\n * export class GetUserProfile extends Request<UserProfileResult> {\n *   // ...\n * }\n * export type UserProfileResult = { name: string; email: string };\n * ```\n */\nexport function PublicQuery(options: PublicQueryOptions = {}): ClassDecorator {\n  return (target) => {\n    Reflect.defineMetadata(PUBLIC_QUERY_METADATA, options, target);\n    return target;\n  };\n}\n"]}