@spine-event-engine/server 2.0.0-snapshot.2

package/dist/handler/handler-codegen.js

@@ -0,0 +1,214 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { lstatSync, mkdirSync, opendirSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import ts from "typescript";
+import { BuildHandlerAnalyzer } from "./build-time-handler-analyzer.js";
+import { GeneratedRegistryWriter } from "./generated-registry-writer.js";
+const maxCompilerRoots = 1000;
+const maxDiscoveryEntries = 1000;
+const defaultOperations = {
+    mkdir: (path) => {
+        mkdirSync(path, { recursive: true });
+    },
+    write: (path, source) => {
+        writeFileSync(path, source, "utf8");
+    },
+    rename: renameSync,
+    remove: (path) => {
+        rmSync(path, { force: true });
+    },
+};
+/**
+ * Creates and atomically replaces an application's generated handler registry.
+ *
+ * @param options Application root and generation configuration.
+ * @param operations Optional filesystem operations used for generation.
+ */
+export function generateHandlerRegistry(options, operations = {}) {
+    const appRoot = HandlerFiles.directory(resolve(options.appRoot), "Application root");
+    const project = HandlerFiles.file(appRoot, join(appRoot, "tsconfig.json"), "Project");
+    const generatedRoot = HandlerFiles.path(appRoot, join(appRoot, "generated"), "Generated root");
+    const outputFile = HandlerFiles.path(generatedRoot, join(generatedRoot, "handler/generated-handler-registry.ts"), "Generated output");
+    const { program, sources } = HandlerFiles.program(appRoot, project);
+    const analysis = BuildHandlerAnalyzer.analyze(program, sources);
+    if (analysis.diagnostics.length > 0)
+        throw new Error(HandlerFiles.diagnostics(analysis.diagnostics));
+    const source = new GeneratedRegistryWriter().render(analysis, { outputFile });
+    (operations.mkdir ?? defaultOperations.mkdir)(dirname(outputFile));
+    HandlerFiles.write(outputFile, source, operations);
+}
+const HandlerFiles = Object.freeze({
+    program(appRoot, project) {
+        const config = ts.readConfigFile(project, (path) => ts.sys.readFile(path));
+        if (config.error !== undefined)
+            throw new Error(HandlerFiles.configDiagnostics([config.error]));
+        HandlerFiles.assertIncludes(HandlerFiles.value(config.config, "include"), appRoot);
+        const parsed = ts.parseJsonConfigFileContent(config.config, HandlerFiles.configHost(appRoot, dirname(project)), dirname(project), undefined, project);
+        if (parsed.errors.length > 0)
+            throw new Error(HandlerFiles.configDiagnostics(parsed.errors));
+        if ((parsed.projectReferences?.length ?? 0) > 0)
+            throw new Error("Project references are not supported for handler generation.");
+        if (parsed.fileNames.length > maxCompilerRoots)
+            throw new Error(`Handler source count exceeds ${String(maxCompilerRoots)}.`);
+        const roots = parsed.fileNames.map((file) => HandlerFiles.typeScriptFile(appRoot, file));
+        const program = ts.createProgram({
+            rootNames: roots,
+            options: parsed.options,
+            ...(parsed.projectReferences === undefined
+                ? {}
+                : { projectReferences: parsed.projectReferences }),
+        });
+        const sources = roots
+            .map((root) => program.getSourceFile(root))
+            .filter(HandlerFiles.sourceFile);
+        return { program, sources };
+    },
+    assertIncludes(value, appRoot) {
+        if (!Array.isArray(value))
+            return;
+        for (const include of value) {
+            if (typeof include !== "string")
+                continue;
+            if (include.split(/[\\/]/u).includes(".."))
+                throw new Error(`Handler source must stay within ${appRoot}.`);
+        }
+    },
+    value(value, key) {
+        if (typeof value !== "object" || value === null)
+            return undefined;
+        return value[key];
+    },
+    configHost(appRoot, currentDirectory) {
+        let entries = 0;
+        // TypeScript 6.0.3 exports matchFiles at runtime but omits it from its declarations.
+        const matchFiles = ts.matchFiles;
+        return {
+            useCaseSensitiveFileNames: ts.sys.useCaseSensitiveFileNames,
+            readDirectory: (path, extensions, excludes, includes, depth) => matchFiles(path, extensions, excludes, includes, ts.sys.useCaseSensitiveFileNames, currentDirectory, depth, (directory) => {
+                const resolvedDirectory = resolve(currentDirectory, directory);
+                HandlerFiles.containedPath(appRoot, resolvedDirectory, "Handler discovery directory");
+                const files = [];
+                const directories = [];
+                const handle = opendirSync(resolvedDirectory);
+                try {
+                    let entry;
+                    while ((entry = handle.readSync()) !== null) {
+                        entries += 1;
+                        if (entries > maxDiscoveryEntries)
+                            throw new Error(`Handler discovery entry count exceeds ${String(maxDiscoveryEntries)}.`);
+                        const candidate = join(resolvedDirectory, entry.name);
+                        if (lstatSync(candidate).isSymbolicLink())
+                            throw new Error(`Handler discovery must not traverse symlink: ${candidate}`);
+                        if (entry.isDirectory())
+                            directories.push(entry.name);
+                        else if (entry.isFile())
+                            files.push(entry.name);
+                    }
+                }
+                finally {
+                    handle.closeSync();
+                }
+                return { files, directories };
+            }, (path) => ts.sys.realpath?.(path) ?? path),
+            fileExists: (path) => ts.sys.fileExists(path),
+            readFile: (path) => ts.sys.readFile(path),
+            trace: () => undefined,
+            directoryExists: (path) => ts.sys.directoryExists(path),
+            realpath: (path) => ts.sys.realpath?.(path) ?? path,
+        };
+    },
+    sourceFile(value) {
+        return value !== undefined;
+    },
+    diagnostics(diagnostics) {
+        return diagnostics
+            .map((diagnostic) => {
+            const location = `${diagnostic.sourceFile}:${String(diagnostic.line)}:` + String(diagnostic.column);
+            return `${location} ${diagnostic.code} ${diagnostic.message}`;
+        })
+            .join("\n");
+    },
+    configDiagnostics(diagnostics) {
+        return ts.formatDiagnosticsWithColorAndContext(diagnostics, {
+            getCanonicalFileName: (fileName) => fileName,
+            getCurrentDirectory: () => process.cwd(),
+            getNewLine: () => "\n",
+        });
+    },
+    file(root, value, label) {
+        const path = HandlerFiles.path(root, value, label);
+        if (!lstatSync(path).isFile())
+            throw new Error(`${label} must be a regular file: ${path}`);
+        return path;
+    },
+    typeScriptFile(root, value) {
+        if (!value.endsWith(".ts") || value.endsWith(".d.ts"))
+            throw new Error(`Handler source must be a TypeScript file: ${value}`);
+        return HandlerFiles.file(root, value, "Handler source");
+    },
+    directory(path, label) {
+        HandlerFiles.assertNoSymlinkAncestors(path, label);
+        if (!lstatSync(path).isDirectory())
+            throw new Error(`${label} must be a directory: ${path}`);
+        return path;
+    },
+    path(root, path, label) {
+        const value = relative(root, path);
+        if (value === "" || value.startsWith("..") || isAbsolute(value))
+            throw new Error(`${label} must stay within ${root}.`);
+        HandlerFiles.assertNoSymlinkAncestors(path, label);
+        return path;
+    },
+    containedPath(root, path, label) {
+        const value = relative(root, path);
+        if (value.startsWith("..") || isAbsolute(value))
+            throw new Error(`${label} must stay within ${root}.`);
+        HandlerFiles.assertNoSymlinkAncestors(path, label);
+        return path;
+    },
+    assertNoSymlinkAncestors(path, label) {
+        const parts = resolve(path).split(sep).filter(Boolean);
+        let current = sep;
+        for (const part of parts) {
+            current = join(current, part);
+            try {
+                if (lstatSync(current).isSymbolicLink())
+                    throw new Error(`${label} must not use a symlink path.`);
+            }
+            catch (error) {
+                if (error.code !== "ENOENT")
+                    throw error;
+            }
+        }
+    },
+    write(outputFile, source, operations) {
+        const fileOperations = { ...defaultOperations, ...operations };
+        const stage = join(dirname(outputFile), `.${basename(outputFile)}.${String(process.pid)}.${crypto.randomUUID()}.tmp`);
+        try {
+            fileOperations.write(stage, source);
+            fileOperations.rename(stage, outputFile);
+        }
+        catch (primary) {
+            try {
+                fileOperations.remove(stage);
+            }
+            catch (cleanup) {
+                throw new AggregateError([primary, cleanup], "Generated handler registry publication failed.");
+            }
+            throw primary;
+        }
+    },
+});
+//# sourceMappingURL=handler-codegen.js.map

package/dist/handler/handler-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-codegen.js","sourceRoot":"","sources":["../../src/handler/handler-codegen.ts"],"names":[],"mappings":"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"}

package/dist/handler/handler-decorators.d.ts

@@ -0,0 +1,134 @@
+import type { DescriptorMessageSchema } from "../entity/entity-metadata.js";
+import { type EntityClass, type EntityHandlersMetadata, type EventApplicationOptions, type WhereOptions } from "./handler-metadata.js";
+export type { WhereOptions } from "./handler-metadata.js";
+/**
+ * Describes the standard TypeScript method decorator accepted by Spine handler declarations.
+ *
+ * @typeParam This - Entity instance that owns the decorated method.
+ * @typeParam Parameters - Parameters accepted by the decorated method.
+ * @typeParam Return - Result returned by the decorated method.
+ * @param value Decorated method implementation.
+ * @param context Standard TypeScript decorator context.
+ */
+export type HandlerMethodDecorator = <This extends object, Parameters extends readonly unknown[], Return>(value: HandlerMethodValue<This, Parameters, Return>, context: ClassMethodDecoratorContext<This, HandlerMethodValue<This, Parameters, Return>>) => void;
+/**
+ * Describes an instance method shape accepted by public handler decorators.
+ *
+ * @typeParam This - Entity instance that owns the method.
+ * @typeParam Parameters - Parameters accepted by the method.
+ * @typeParam Return - Result returned by the method.
+ * @param this Entity instance that receives the invocation.
+ * @param parameters Arguments supplied to the handler.
+ * @returns Handler result.
+ */
+export type HandlerMethodValue<This extends object = object, Parameters extends readonly unknown[] = readonly unknown[], Return = unknown> = (this: This, ...parameters: Parameters) => Return;
+/**
+ * Creates a command-assignee declaration.
+ *
+ * Bare `@Assign` is the ordinary application form. Generated handler
+ * registries require a command input and normal event output; a rejection is
+ * valid in neither role, but the handler may throw a generated rejection
+ * throwable. The decorator records metadata only; it does not register the
+ * handler, instantiate the entity, or invoke the method.
+ *
+ * @typeParam This - Entity instance that owns the method.
+ * @typeParam Parameters - Parameters accepted by the method.
+ * @typeParam Return - Result returned by the method.
+ * @param value Decorated method implementation or command schema.
+ * @param context Standard decorator context for bare usage.
+ */
+export declare function Assign<This extends object, Parameters extends readonly unknown[], Return>(value: HandlerMethodValue<This, Parameters, Return>, context: ClassMethodDecoratorContext<This, HandlerMethodValue<This, Parameters, Return>>): void;
+/**
+ * Creates a command-reacting declaration.
+ *
+ * Bare `@Command` is the ordinary application form. Generated registries accept
+ * command inputs; event-to-command handlers also accept event or rejection
+ * inputs. Normal outputs are commands, while rejections are thrown, not
+ * returned. Command reactors may fan out in `HandlerMetadataRegistry`; this
+ * decorator only records the declaration.
+ *
+ * @typeParam This - Entity instance that owns the method.
+ * @typeParam Parameters - Parameters accepted by the method.
+ * @typeParam Return - Result returned by the method.
+ * @param value Decorated method implementation or command schema.
+ * @param context Standard decorator context for bare usage.
+ */
+export declare function Command<This extends object, Parameters extends readonly unknown[], Return>(value: HandlerMethodValue<This, Parameters, Return>, context: ClassMethodDecoratorContext<This, HandlerMethodValue<This, Parameters, Return>>): void;
+/**
+ * Creates an Event/rejection or Entity-state subscriber declaration.
+ *
+ * Bare `@Subscribe` accepts generated Event/rejection or descriptor-marked
+ * Entity-state inputs and returns `void`. Event/rejection inputs produce
+ * event-subscription metadata; Entity state inputs produce state-subscription
+ * metadata. Subscribers are metadata-only declarations bridged by generated
+ * registry and runtime metadata.
+ *
+ * @typeParam This - Entity instance that owns the method.
+ * @typeParam Parameters - Parameters accepted by the method.
+ * @typeParam Return - Result returned by the method.
+ * @param value Decorated method implementation.
+ * @param context Standard decorator context for bare usage.
+ */
+export declare function Subscribe<This extends object, Parameters extends readonly unknown[], Return>(value: HandlerMethodValue<This, Parameters, Return>, context: ClassMethodDecoratorContext<This, HandlerMethodValue<This, Parameters, Return>>): void;
+/**
+ * Creates an event-reactor declaration.
+ *
+ * Bare `@React` accepts generated event or rejection inputs and returns normal
+ * events or explicit `void`; rejections are thrown, not returned. Reactors are
+ * collected as class-owned metadata and may fan out through the caller-owned
+ * handler registry.
+ *
+ * @typeParam This - Entity instance that owns the method.
+ * @typeParam Parameters - Parameters accepted by the method.
+ * @typeParam Return - Result returned by the method.
+ * @param value Decorated method implementation or event schema.
+ * @param context Standard decorator context for bare usage.
+ */
+export declare function React<This extends object, Parameters extends readonly unknown[], Return>(value: HandlerMethodValue<This, Parameters, Return>, context: ClassMethodDecoratorContext<This, HandlerMethodValue<This, Parameters, Return>>): void;
+/**
+ * Creates one Event field equality filter for an Event-consuming handler.
+ *
+ * Generated handler analysis validates the declaration and carries it into
+ * immutable repository metadata. The decorator itself does not inspect or
+ * invoke the handler.
+ *
+ * @param options Event source field and canonical expected value.
+ * @returns Decorator for a public instance handler method.
+ */
+export declare function Where(options: WhereOptions): HandlerMethodDecorator;
+/**
+ * Creates legacy framework event-application metadata.
+ *
+ * New application aggregates must not use `@Apply`; managed aggregates are no
+ * longer event-sourced and the framework owns state transactions. This
+ * decorator is kept only for compatibility code that still needs explicit
+ * schema-bearing event application metadata. The optional `allowImport` flag
+ * is preserved only as part of that legacy metadata shape.
+ *
+ * @param schema Event schema accepted by the decorated method.
+ * @param options Legacy event-application metadata options.
+ * @returns Decorator that records the application metadata.
+ */
+export declare function Apply(schema: DescriptorMessageSchema, options?: EventApplicationOptions): HandlerMethodDecorator;
+/**
+ * Builds schema-bearing decorator declarations for framework compatibility.
+ *
+ * The returned object is the same frozen `EntityHandlersMetadata` contract
+ * produced by `EntityHandlers.define()` and accepted by
+ * `HandlerMetadataRegistry`. Only own prototype methods of `entityType` are
+ * inspected; inherited decorated methods are intentionally not materialized by
+ * this class-owned adapter.
+ *
+ * Application code must not call this function and must not provide its own
+ * handler discovery/materialization. Generated framework registries own schema
+ * inference for bare decorators; this adapter only supports legacy
+ * schema-bearing decorator metadata.
+ *
+ * @typeParam Instance - Entity instance that owns the handlers.
+ * @typeParam StateSchema - Schema that describes the entity state.
+ * @param entityType Entity class whose own decorated methods are read.
+ * @param stateSchema Schema that describes the entity state.
+ * @returns Frozen handler metadata for the decorated methods.
+ */
+export declare function materializeDecoratedEntityHandlers<Instance extends object, StateSchema extends DescriptorMessageSchema>(entityType: EntityClass<Instance>, stateSchema: StateSchema): EntityHandlersMetadata<Instance, StateSchema>;
+//# sourceMappingURL=handler-decorators.d.ts.map

package/dist/handler/handler-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-decorators.d.ts","sourceRoot":"","sources":["../../src/handler/handler-decorators.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAI5B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAiB1D;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,SAAS,MAAM,EACnB,UAAU,SAAS,SAAS,OAAO,EAAE,EACrC,MAAM,EAEN,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EACnD,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,KACrF,IAAI,CAAC;AAEV;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,CAC5B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,UAAU,SAAS,SAAS,OAAO,EAAE,GAAG,SAAS,OAAO,EAAE,EAC1D,MAAM,GAAG,OAAO,IACd,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,UAAU,KAAK,MAAM,CAAC;AAItD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,IAAI,SAAS,MAAM,EAAE,UAAU,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,EACvF,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EACnD,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,GACvF,IAAI,CAAC;AAgBR;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,IAAI,SAAS,MAAM,EAAE,UAAU,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,EACxF,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EACnD,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,GACvF,IAAI,CAAC;AAgBR;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,SAAS,MAAM,EAAE,UAAU,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,EAC1F,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EACnD,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,GACvF,IAAI,CAAC;AAiBR;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,UAAU,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,EACtF,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EACnD,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,GACvF,IAAI,CAAC;AAgBR;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,sBAAsB,CAUnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAExB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,SAAS,MAAM,EACvB,WAAW,SAAS,uBAAuB,EAE3C,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC,EACjC,WAAW,EAAE,WAAW,GACvB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,CAAC,CA0B/C"}

package/dist/handler/handler-decorators.js

@@ -0,0 +1,239 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { EntityHandlers, } from "./handler-metadata.js";
+const handlerDecoratorMetadataKey = Symbol("@spine-event-engine/server.handlerDecorators");
+/**
+ * Creates command-assignment decorator metadata or a schema-bearing decorator.
+ *
+ * @param schemaOrValue Command schema or decorated method implementation.
+ * @param context Standard decorator context for bare usage.
+ * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ */
+export function Assign(schemaOrValue, context) {
+    return DecoratorMetadata.decorateOrCreate("command-assignment", schemaOrValue, context);
+}
+/**
+ * Creates command-reaction decorator metadata or a schema-bearing decorator.
+ *
+ * @param schemaOrValue Command schema or decorated method implementation.
+ * @param context Standard decorator context for bare usage.
+ * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ */
+export function Command(schemaOrValue, context) {
+    return DecoratorMetadata.decorateOrCreate("command-reaction", schemaOrValue, context);
+}
+/**
+ * Creates subscriber decorator metadata or a schema-bearing decorator.
+ *
+ * @param schemaOrValue Event, rejection, or descriptor-marked Entity state
+ * schema, or the decorated method implementation.
+ * @param context Standard decorator context for bare usage.
+ * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ */
+export function Subscribe(schemaOrValue, context) {
+    return DecoratorMetadata.decorateOrCreate("event-subscription", schemaOrValue, context);
+}
+/**
+ * Creates event-reaction decorator metadata or a schema-bearing decorator.
+ *
+ * @param schemaOrValue Event schema or decorated method implementation.
+ * @param context Standard decorator context for bare usage.
+ * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ */
+export function React(schemaOrValue, context) {
+    return DecoratorMetadata.decorateOrCreate("event-reaction", schemaOrValue, context);
+}
+/**
+ * Creates one Event field equality filter for an Event-consuming handler.
+ *
+ * Generated handler analysis validates the declaration and carries it into
+ * immutable repository metadata. The decorator itself does not inspect or
+ * invoke the handler.
+ *
+ * @param options Event source field and canonical expected value.
+ * @returns Decorator for a public instance handler method.
+ */
+export function Where(options) {
+    const snapshot = WhereValues.snapshot(options);
+    return (_value, context) => {
+        void snapshot;
+        DecoratorMetadata.methodName(context);
+    };
+}
+/**
+ * Creates legacy framework event-application metadata.
+ *
+ * New application aggregates must not use `@Apply`; managed aggregates are no
+ * longer event-sourced and the framework owns state transactions. This
+ * decorator is kept only for compatibility code that still needs explicit
+ * schema-bearing event application metadata. The optional `allowImport` flag
+ * is preserved only as part of that legacy metadata shape.
+ *
+ * @param schema Event schema accepted by the decorated method.
+ * @param options Legacy event-application metadata options.
+ * @returns Decorator that records the application metadata.
+ */
+export function Apply(schema, options = {}) {
+    return DecoratorMetadata.create("event-application", schema, options);
+}
+/**
+ * Builds schema-bearing decorator declarations for framework compatibility.
+ *
+ * The returned object is the same frozen `EntityHandlersMetadata` contract
+ * produced by `EntityHandlers.define()` and accepted by
+ * `HandlerMetadataRegistry`. Only own prototype methods of `entityType` are
+ * inspected; inherited decorated methods are intentionally not materialized by
+ * this class-owned adapter.
+ *
+ * Application code must not call this function and must not provide its own
+ * handler discovery/materialization. Generated framework registries own schema
+ * inference for bare decorators; this adapter only supports legacy
+ * schema-bearing decorator metadata.
+ *
+ * @typeParam Instance - Entity instance that owns the handlers.
+ * @typeParam StateSchema - Schema that describes the entity state.
+ * @param entityType Entity class whose own decorated methods are read.
+ * @param stateSchema Schema that describes the entity state.
+ * @returns Frozen handler metadata for the decorated methods.
+ */
+export function materializeDecoratedEntityHandlers(entityType, stateSchema) {
+    const decoratedHandlers = DecoratorMetadata.collect(entityType);
+    return EntityHandlers.define(entityType, stateSchema, (builder) => decoratedHandlers.map((handler) => {
+        const methodName = handler.methodName;
+        switch (handler.kind) {
+            case "command-assignment":
+                return builder.assign(DecoratorMetadata.schema(handler), methodName);
+            case "command-reaction":
+                return builder.command(DecoratorMetadata.schema(handler), methodName);
+            case "event-subscription":
+                return builder.subscribe(DecoratorMetadata.schema(handler), methodName);
+            case "event-reaction":
+                return builder.react(DecoratorMetadata.schema(handler), methodName);
+            case "event-application":
+                return builder.apply(DecoratorMetadata.schema(handler), methodName, {
+                    allowImport: handler.allowImport ?? false,
+                });
+        }
+    }));
+}
+const DecoratorMetadata = Object.freeze({
+    methodName(context) {
+        if (context.static || context.private) {
+            throw new TypeError("Spine handler decorators must be applied to public instance methods.");
+        }
+        if (typeof context.name !== "string") {
+            throw new TypeError("Spine handler decorators require string-named methods.");
+        }
+        return context.name;
+    },
+    decorateOrCreate(kind, schemaOrValue, context) {
+        if (context !== undefined) {
+            DecoratorMetadata.create(kind)(schemaOrValue, context);
+            return undefined;
+        }
+        return DecoratorMetadata.create(kind, schemaOrValue);
+    },
+    create(kind, schema, options = {}) {
+        return (_value, context) => {
+            const methodName = DecoratorMetadata.methodName(context);
+            const record = Object.freeze({
+                kind,
+                ...(schema === undefined ? {} : { schema }),
+                methodName,
+                ...(kind === "event-application" ? { allowImport: options.allowImport ?? false } : {}),
+            });
+            const metadata = DecoratorMetadata.require(context);
+            const previous = DecoratorMetadata.read(metadata);
+            Object.defineProperty(metadata, handlerDecoratorMetadataKey, {
+                configurable: true,
+                enumerable: false,
+                value: Object.freeze([...previous, record]),
+                writable: true,
+            });
+        };
+    },
+    schema(handler) {
+        if (handler.schema === undefined) {
+            throw new TypeError(`Decorated handler "${handler.methodName}" was declared without a schema; ` +
+                "use generated registry metadata or explicit EntityHandlers.define() registration.");
+        }
+        return handler.schema;
+    },
+    collect(entityType) {
+        const metadata = DecoratorMetadata.classMetadata(entityType);
+        if (metadata === undefined) {
+            return Object.freeze([]);
+        }
+        const records = DecoratorMetadata.read(metadata).filter((record) => {
+            const descriptor = Object.getOwnPropertyDescriptor(entityType.prototype, record.methodName);
+            return typeof descriptor?.value === "function";
+        });
+        return Object.freeze(records);
+    },
+    installSymbol() {
+        const existingMetadata = Reflect.get(Symbol, "metadata");
+        if (typeof existingMetadata === "symbol") {
+            return existingMetadata;
+        }
+        const metadata = Symbol("Symbol.metadata");
+        Object.defineProperty(Symbol, "metadata", {
+            configurable: true,
+            enumerable: false,
+            value: metadata,
+            writable: false,
+        });
+        return metadata;
+    },
+    require(context) {
+        if (context.metadata === undefined) {
+            throw new TypeError("Spine handler decorators require standard decorator metadata support.");
+        }
+        return context.metadata;
+    },
+    classMetadata(entityType) {
+        const descriptor = Object.getOwnPropertyDescriptor(entityType, decoratorMetadataSymbol);
+        const metadata = descriptor?.value;
+        if (metadata === null || typeof metadata !== "object") {
+            return undefined;
+        }
+        return metadata;
+    },
+    read(metadata) {
+        if (!Object.hasOwn(metadata, handlerDecoratorMetadataKey)) {
+            return [];
+        }
+        const value = metadata[handlerDecoratorMetadataKey];
+        return Array.isArray(value) ? value : [];
+    },
+});
+const WhereValues = Object.freeze({
+    snapshot(options) {
+        const value = options;
+        if (value === null || typeof value !== "object" || Array.isArray(value)) {
+            throw new TypeError("Where options must be an object.");
+        }
+        const keys = Object.keys(value);
+        if (keys.length !== 2 ||
+            !keys.includes("eventField") ||
+            !keys.includes("equals") ||
+            typeof options.eventField !== "string" ||
+            options.eventField.trim().length === 0 ||
+            typeof options.equals !== "string") {
+            throw new TypeError("Where options require exactly non-empty eventField and string equals.");
+        }
+        return Object.freeze({ eventField: options.eventField, equals: options.equals });
+    },
+});
+const decoratorMetadataSymbol = DecoratorMetadata.installSymbol();
+//# sourceMappingURL=handler-decorators.js.map

package/dist/handler/handler-decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-decorators.js","sourceRoot":"","sources":["../../src/handler/handler-decorators.ts"],"names":[],"mappings":"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"}