@spine-event-engine/proto-tools 2.0.0-snapshot.2

package/dist/src/generation/handler-generator.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { generateHandlerRegistry } from "@spine-event-engine/server/internal/handler-codegen";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { ProtoConfig, ProtoManifest } from "../index.js";
+import { generatedSource } from "./generated-source-policy.js";
+/**
+ * Generates application handler registries.
+ */
+export const HandlerGeneration = Object.freeze({
+    // prettier-ignore
+    /**
+     * Generates an application's conventional handler registry from its TypeScript project.
+     *
+     * @param applicationRoot The application package root.
+     * @returns Nothing.
+     */
+    generate(applicationRoot) {
+        const config = existsSync(join(applicationRoot, "spine-proto.json"))
+            ? ProtoConfig.read(applicationRoot)
+            : undefined;
+        const sources = config?.mode === "application"
+            ? config.modelPackages.flatMap((modelPackage) => {
+                const modelRoot = join(applicationRoot, "node_modules", modelPackage);
+                const manifest = join(modelRoot, "spine-proto-manifest.json");
+                if (existsSync(manifest))
+                    return ProtoManifest.read(modelRoot).protoFiles;
+                const module = join(modelRoot, "dist", "generated", "proto-module.js");
+                return existsSync(module)
+                    ? [...readFileSync(module, "utf8").matchAll(/^ \* Source Proto: (.+)$/gmu)].map((match) => match[1] ?? "")
+                    : [];
+            })
+            : [];
+        if (sources.length === 0)
+            throw new Error("spine-proto: handler generation requires model Proto provenance");
+        generateHandlerRegistry({ appRoot: applicationRoot }, {
+            write(path, source) {
+                writeFileSync(path, generatedSource(source, sources), "utf8");
+            },
+        });
+    },
+});
+//# sourceMappingURL=handler-generator.js.map

package/dist/src/generation/handler-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-generator.js","sourceRoot":"","sources":["../../../src/generation/handler-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,MAAM,CAAC,MAAM,CAAC;IACZ,kBAAkB;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,eAAuB;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;YAClE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC;YACnC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,KAAK,aAAa;YAC5C,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,YAAoB,EAAE,EAAE;gBACpD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;gBACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;gBAC9D,IAAI,UAAU,CAAC,QAAQ,CAAC;oBAAE,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC;gBAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;gBACvE,OAAO,UAAU,CAAC,MAAM,CAAC;oBACvB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC,CAAC,GAAG,CAC3E,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAC1B;oBACH,CAAC,CAAC,EAAE,CAAC;YACT,CAAC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,uBAAuB,CACrB,EAAE,OAAO,EAAE,eAAe,EAAE,EAC5B;YACE,KAAK,CAAC,IAAI,EAAE,MAAM;gBAChB,aAAa,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;YAChE,CAAC;SACF,CACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/src/generation/interface-generator.d.ts

@@ -0,0 +1,21 @@
+import { type Schema } from "@bufbuild/protoplugin";
+import type { InterfaceDeclarationProvider } from "./interface-provider.js";
+import type { ModelSourceView } from "./source-view.js";
+/**
+ * Reads the immutable source-view handoff for the post-Buf interface phase.
+ *
+ * @param cwd Plugin working directory containing its staged `output` tree.
+ * @returns A validated source view, or undefined when no handoff was supplied.
+ */
+export declare function stagedSourceView(cwd?: string): ModelSourceView | undefined;
+/**
+ * Generates file-scoped empty TypeScript interfaces and nominal schema tokens.
+ *
+ * Provider-resolved authored declarations are emitted when a compatible
+ * discovery provider supplies them; unresolved declarations are omitted.
+ */
+export declare const InterfaceGenerator: Readonly<{
+    generateCompanions(schema: Schema): void;
+    generateWithProvider(schema: Schema, provider: InterfaceDeclarationProvider, sourceView?: ModelSourceView): void;
+}>;
+//# sourceMappingURL=interface-generator.d.ts.map

package/dist/src/generation/interface-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-generator.d.ts","sourceRoot":"","sources":["../../../src/generation/interface-generator.ts"],"names":[],"mappings":"AAeA,OAAO,EAAqC,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAKvF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAWxD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,eAAe,GAAG,SAAS,CAsEzF;AAqGD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,4BAA4B,EACtC,UAAU,CAAC,EAAE,eAAe,GAC3B,IAAI,CAAC;CACT,CAsIC,CAAC"}

package/dist/src/generation/interface-generator.js

@@ -0,0 +1,277 @@
+/*
+ * 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 { getOption } from "@bufbuild/protobuf";
+import { createEcmaScriptPlugin, runNodeJs } from "@bufbuild/protoplugin";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync, readFileSync } from "node:fs";
+const authoredProviderModule = (await import(import.meta.url.endsWith(".ts")
+    ? "./authored-interface-provider.ts"
+    : "./authored-interface-provider.js"));
+const { AuthoredInterfaceProvider } = authoredProviderModule;
+const typescriptIdentifier = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+/**
+ * Reads the immutable source-view handoff for the post-Buf interface phase.
+ *
+ * @param cwd Plugin working directory containing its staged `output` tree.
+ * @returns A validated source view, or undefined when no handoff was supplied.
+ */
+export function stagedSourceView(cwd = process.cwd()) {
+    const path = join(cwd, ".spine-source-view.json");
+    if (!existsSync(path))
+        return undefined;
+    const value = JSON.parse(readFileSync(path, "utf8"));
+    if (value === null || typeof value !== "object")
+        throw new Error("spine-proto: invalid staged source view");
+    const view = value;
+    const expectedStage = resolve(cwd, "output");
+    const within = (root, path) => {
+        const pathRelative = relative(root, path);
+        return pathRelative === "" || (!pathRelative.startsWith("..") && !isAbsolute(pathRelative));
+    };
+    if (typeof view.packageRoot !== "string" ||
+        typeof view.stagedGeneratedRoot !== "string" ||
+        typeof view.liveGeneratedRoot !== "string" ||
+        !Array.isArray(view.authoredFiles) ||
+        !Array.isArray(view.compilerFiles))
+        throw new Error("spine-proto: invalid staged source view");
+    const packageRoot = view.packageRoot;
+    const stagedGeneratedRoot = view.stagedGeneratedRoot;
+    const liveGeneratedRoot = view.liveGeneratedRoot;
+    const rawAuthoredFiles = view.authoredFiles;
+    const rawCompilerFiles = view.compilerFiles;
+    const authoredFiles = rawAuthoredFiles.filter((file) => typeof file === "string");
+    const compilerFiles = rawCompilerFiles.filter((file) => typeof file === "string");
+    const liveParent = dirname(liveGeneratedRoot);
+    const liveName = basename(liveGeneratedRoot);
+    const transactionStage = join(liveParent, `.${liveName}.stage-`);
+    const transactionBackup = join(liveParent, `.${liveName}.`);
+    const isTransactionArtifact = (file) => file.startsWith(transactionStage) ||
+        (file.startsWith(transactionBackup) && file.includes(".backup"));
+    if (!isAbsolute(packageRoot) ||
+        resolve(packageRoot) !== packageRoot ||
+        !isAbsolute(stagedGeneratedRoot) ||
+        resolve(stagedGeneratedRoot) !== stagedGeneratedRoot ||
+        stagedGeneratedRoot !== expectedStage ||
+        !isAbsolute(liveGeneratedRoot) ||
+        resolve(liveGeneratedRoot) !== liveGeneratedRoot ||
+        !within(packageRoot, liveGeneratedRoot) ||
+        authoredFiles.length !== rawAuthoredFiles.length ||
+        compilerFiles.length !== rawCompilerFiles.length ||
+        authoredFiles.some((file) => !compilerFiles.includes(file)) ||
+        [...authoredFiles, ...compilerFiles].some((file) => !isAbsolute(file) ||
+            resolve(file) !== file ||
+            !within(packageRoot, file) ||
+            within(liveGeneratedRoot, file) ||
+            within(stagedGeneratedRoot, file) ||
+            isTransactionArtifact(file)))
+        throw new Error("spine-proto: invalid staged source view");
+    return Object.freeze({
+        authoredFiles: Object.freeze(authoredFiles.map((file) => file)),
+        compilerFiles: Object.freeze(compilerFiles.map((file) => file)),
+        liveGeneratedRoot,
+        packageRoot,
+        stagedGeneratedRoot,
+    });
+}
+const reservedTypeScriptWords = new Set([
+    "await",
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "enum",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "implements",
+    "import",
+    "in",
+    "instanceof",
+    "interface",
+    "let",
+    "new",
+    "null",
+    "package",
+    "private",
+    "protected",
+    "public",
+    "return",
+    "super",
+    "switch",
+    "static",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
+]);
+const protoPackage = "@spine-event-engine/proto";
+const packagedOptions = (await import(protoPackage).catch(() => undefined));
+function optionExtension(files, name) {
+    const visited = new Set();
+    const find = (candidates) => {
+        for (const file of candidates) {
+            if (visited.has(file))
+                continue;
+            visited.add(file);
+            const extension = file.extensions.find((candidate) => candidate.name === name);
+            if (extension !== undefined)
+                return extension;
+            const nested = find(file.dependencies);
+            if (nested !== undefined)
+                return nested;
+        }
+        return undefined;
+    };
+    const extension = find(files);
+    if (extension !== undefined)
+        return extension;
+    const packaged = name === "every_is" ? packagedOptions?.every_is : packagedOptions?.is;
+    if (packaged !== undefined)
+        return packaged;
+    throw new Error(`spine-proto: missing (${name}) option descriptor`);
+}
+function companionPath(name) {
+    return `interfaces/${name.replace(/([a-z0-9])([A-Z])/gu, "$1-$2").toLowerCase()}.ts`;
+}
+function collectMessages(messages) {
+    return messages.flatMap((message) => [message, ...collectMessages(message.nestedMessages)]);
+}
+function assertTypeName(name, source) {
+    if (!typescriptIdentifier.test(name) || reservedTypeScriptWords.has(name)) {
+        throw new Error(`spine-proto: ${source}: ts_type must be a non-empty TypeScript identifier`);
+    }
+}
+function validateMessageDeclarations(isOption, file) {
+    for (const message of collectMessages(file.messages)) {
+        const option = getOption(message, isOption);
+        if (option.tsType.length > 0)
+            assertTypeName(option.tsType, `${file.proto.name}:${message.name}`);
+    }
+}
+/**
+ * Generates file-scoped empty TypeScript interfaces and nominal schema tokens.
+ *
+ * Provider-resolved authored declarations are emitted when a compatible
+ * discovery provider supplies them; unresolved declarations are omitted.
+ */
+export const InterfaceGenerator = Object.freeze({
+    generateCompanions(schema) {
+        InterfaceGenerator.generateWithProvider(schema, new AuthoredInterfaceProvider());
+    },
+    generateWithProvider(schema, provider, suppliedSourceView) {
+        const optionFiles = schema.allFiles ?? schema.files;
+        const everyIs = optionExtension(optionFiles, "every_is");
+        const isOption = optionExtension(optionFiles, "is");
+        const sourceView = suppliedSourceView ?? stagedSourceView();
+        const authored = new Map();
+        const generated = new Map();
+        for (const file of schema.files) {
+            validateMessageDeclarations(isOption, file);
+            for (const message of collectMessages(file.messages)) {
+                const declaration = getOption(message, isOption);
+                if (declaration.tsType.length === 0)
+                    continue;
+                const members = authored.get(declaration.tsType) ?? [];
+                members.push(message);
+                authored.set(declaration.tsType, members);
+            }
+            const declaration = getOption(file, everyIs);
+            if (declaration.generate) {
+                assertTypeName(declaration.tsType, file.proto.name);
+                if (generated.has(declaration.tsType))
+                    throw new Error(`spine-proto: ${file.proto.name}: duplicate generated interface name`);
+                generated.set(declaration.tsType, { file, members: collectMessages(file.messages) });
+            }
+            else if (declaration.tsType.length > 0) {
+                const members = authored.get(declaration.tsType) ?? [];
+                members.push(...collectMessages(file.messages));
+                authored.set(declaration.tsType, members);
+            }
+        }
+        for (const name of authored.keys()) {
+            if (generated.has(name))
+                throw new Error(`spine-proto: generated and authored interface names conflict`);
+        }
+        const paths = new Set();
+        for (const name of [...generated.keys(), ...authored.keys()]) {
+            const path = companionPath(name);
+            if (paths.has(path))
+                throw new Error(`spine-proto: duplicate interface companion path ${path}`);
+            paths.add(path);
+        }
+        const resolved = [...authored.entries()].map(([name, members]) => ({
+            name,
+            members,
+            declaration: provider.resolve(name, members, sourceView),
+        }));
+        for (const candidate of generated.values()) {
+            if (candidate.members.length === 0)
+                throw new Error(`${candidate.file.proto.name}: every_is cannot target an empty message set`);
+        }
+        for (const candidate of resolved) {
+            if (candidate.declaration !== undefined &&
+                (candidate.declaration.name !== candidate.name ||
+                    candidate.declaration.importPath.length === 0))
+                throw new Error("spine-proto: authored interface provider returned an irreconcilable declaration");
+        }
+        for (const [name, candidate] of generated) {
+            const members = candidate.members;
+            const output = schema.generateFile(companionPath(name));
+            const define = output.import("MessageInterfaces", "@spine-event-engine/core");
+            const token = output.import("MessageInterface", "@spine-event-engine/core", true);
+            const schemaImports = members.map((member) => output.importSchema(member));
+            output.preamble(candidate.file);
+            output.print("/** Generated file-level message interface. */\n", `export interface ${name} {}\n\n`, "const memberSchemas: readonly [", ...schemaImports.flatMap((member, index) => index === 0 ? ["typeof ", member] : [", typeof ", member]), "] = [", ...schemaImports.flatMap((member, index) => (index === 0 ? [member] : [", ", member])), "];\n\n", "/** Generated nominal runtime token for this message interface. */\n", output.export("const", name), ": ", token, `<${name}, typeof memberSchemas> = `, define, `.define<${name}, typeof memberSchemas>(memberSchemas);\n`);
+        }
+        for (const candidate of resolved) {
+            if (candidate.declaration === undefined)
+                continue;
+            const output = schema.generateFile(companionPath(candidate.name));
+            const define = output.import("MessageInterfaces", "@spine-event-engine/core");
+            const token = output.import("MessageInterface", "@spine-event-engine/core", true);
+            const schemaImports = candidate.members.map((member) => output.importSchema(member));
+            const sourceFile = candidate.members[0]?.file;
+            if (sourceFile === undefined)
+                throw new Error("spine-proto: authored interface has no members");
+            output.preamble(sourceFile);
+            output.print(`import type { ${candidate.declaration.name} as Authored${candidate.name} } from ${JSON.stringify(candidate.declaration.importPath)};\n\n`, `export type ${candidate.name} = Authored${candidate.name};\n\n`, "const memberSchemas: readonly [", ...schemaImports.flatMap((member, index) => index === 0 ? ["typeof ", member] : [", typeof ", member]), "] = [", ...schemaImports.flatMap((member, index) => (index === 0 ? [member] : [", ", member])), `];\n\nexport const ${candidate.name}: `, token, `<Authored${candidate.name}, typeof memberSchemas> = `, define, `.define<Authored${candidate.name}, typeof memberSchemas>(memberSchemas);\n`);
+        }
+    },
+});
+const interfacePlugin = createEcmaScriptPlugin({
+    name: "protoc-gen-spine-interfaces",
+    version: "1.0.0",
+    generateTs: InterfaceGenerator.generateCompanions,
+});
+if (process.argv[1] !== undefined && resolve(process.argv[1]) === fileURLToPath(import.meta.url))
+    runNodeJs(interfacePlugin);
+//# sourceMappingURL=interface-generator.js.map

package/dist/src/generation/interface-generator.js.map

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

package/dist/src/generation/interface-provider.d.ts

@@ -0,0 +1,30 @@
+import type { DescMessage } from "@bufbuild/protobuf";
+import type { ModelSourceView } from "./source-view.js";
+/**
+ * A resolved authored interface declaration supplied by an authored-interface provider.
+ */
+export interface AuthoredInterfaceDeclaration {
+    /**
+     * Public TypeScript identifier of the authored interface.
+     */
+    readonly name: string;
+    /**
+     * Module specifier from which the authored interface is imported.
+     */
+    readonly importPath: string;
+}
+/**
+ * Resolves authored interface declarations for generated message membership.
+ */
+export interface InterfaceDeclarationProvider {
+    /**
+     * Resolves one compatible authored interface declaration, if available.
+     *
+     * @param name The requested generated TypeScript interface name.
+     * @param members Concrete generated message members of that interface.
+     * @param sourceView The validated compiler input view, when generation supplies one.
+     * @returns The authored declaration to alias, or `undefined` when unresolved.
+     */
+    resolve(name: string, members: readonly DescMessage[], sourceView: ModelSourceView | undefined): AuthoredInterfaceDeclaration | undefined;
+}
+//# sourceMappingURL=interface-provider.d.ts.map

package/dist/src/generation/interface-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-provider.d.ts","sourceRoot":"","sources":["../../../src/generation/interface-provider.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAG3C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAItB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAG3C;;;;;;;OAOG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,UAAU,EAAE,eAAe,GAAG,SAAS,GACtC,4BAA4B,GAAG,SAAS,CAAC;CAC7C"}

package/dist/src/generation/interface-provider.js

@@ -0,0 +1,15 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=interface-provider.js.map

package/dist/src/generation/interface-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-provider.js","sourceRoot":"","sources":["../../../src/generation/interface-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/src/generation/rejection-generator.d.ts

@@ -0,0 +1,9 @@
+import { type Schema } from "@bufbuild/protoplugin";
+/**
+ * Generates typed throwable companions for top-level owned rejection messages.
+ */
+export declare const RejectionGenerator: Readonly<{
+    generateCompanions(schema: Schema): void;
+    tsDoc(comment: string | undefined): string;
+}>;
+//# sourceMappingURL=rejection-generator.d.ts.map

package/dist/src/generation/rejection-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rejection-generator.d.ts","sourceRoot":"","sources":["../../../src/generation/rejection-generator.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkD,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpG;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CAC5C,CAoDC,CAAC"}

package/dist/src/generation/rejection-generator.js

@@ -0,0 +1,62 @@
+/*
+ * 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 { createEcmaScriptPlugin, getComments, runNodeJs } from "@bufbuild/protoplugin";
+import { fileURLToPath } from "node:url";
+import { resolve } from "node:path";
+/**
+ * Generates typed throwable companions for top-level owned rejection messages.
+ */
+export const RejectionGenerator = Object.freeze({
+    generateCompanions(schema) {
+        for (const file of schema.files) {
+            const sourceName = file.proto.name.split(/[\\/]/u).at(-1);
+            const usesRejectionName = sourceName === "rejections.proto" || sourceName?.endsWith("_rejections.proto") === true;
+            if (!usesRejectionName || file.proto.name.startsWith("spine/delivery/"))
+                continue;
+            const messages = file.messages.filter((message) => message.parent === undefined);
+            if (messages.length === 0)
+                continue;
+            const output = schema.generateFile(`${file.name}.ts`);
+            const throwable = output.import("RejectionThrowable", "@spine-event-engine/core");
+            const messageInit = output.import("MessageInitShape", "@bufbuild/protobuf", true);
+            output.preamble(file);
+            for (const message of messages) {
+                const messageSchema = output.importSchema(message);
+                output.print(RejectionGenerator.tsDoc(getComments(message).leading), output.export("const", message.name), ": { readonly create: (input: ", messageInit, "<typeof ", messageSchema, ">) => ", throwable, "<typeof ", messageSchema, "> } = {\n  create(input) {\n    return ", throwable, ".create(", messageSchema, ", input);\n  },\n};\n");
+            }
+        }
+    },
+    /**
+     * Renders a leading Proto comment as deterministic TypeScript documentation.
+     */
+    tsDoc(comment) {
+        const lines = (comment ?? "Creates this rejection throwable.")
+            .replaceAll("*/", "*&#47;")
+            .split(/\r?\n/u)
+            .map((line) => line
+            .trim()
+            .replace(/^\/\/\s?/u, "")
+            .replace(/^@/u, "\\@"))
+            .filter(Boolean);
+        return `/**\n * ${lines.join(" ") || "Creates this rejection throwable."}\n */\n`;
+    },
+});
+const rejectionPlugin = createEcmaScriptPlugin({
+    name: "protoc-gen-spine-rejections",
+    version: "1.0.0",
+    generateTs: RejectionGenerator.generateCompanions,
+});
+if (process.argv[1] !== undefined && resolve(process.argv[1]) === fileURLToPath(import.meta.url))
+    runNodeJs(rejectionPlugin);
+//# sourceMappingURL=rejection-generator.js.map

package/dist/src/generation/rejection-generator.js.map

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

package/dist/src/generation/source-view.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Race-safe reads for files owned by a compiler source view.
+ */
+export declare const SourceViewInputs: Readonly<{
+    read(path: string): Buffer;
+}>;
+/**
+ * Stable compiler input view for authored sources and staged generated output.
+ */
+export interface ModelSourceView {
+    /**
+     * Eligible authored TypeScript files, excluding generated publication trees.
+     */
+    readonly authoredFiles: readonly string[];
+    /**
+     * Complete same-module compiler inputs, including declarations and allowed JavaScript.
+     */
+    readonly compilerFiles?: readonly string[];
+    /**
+     * Absolute model package root used to resolve authored imports.
+     */
+    readonly packageRoot: string;
+    /**
+     * Canonical live generated root excluded from authored-interface candidates.
+     */
+    readonly liveGeneratedRoot: string;
+    /**
+     * Redirect root used when compiler imports address generated model sources.
+     */
+    readonly stagedGeneratedRoot: string;
+}
+/**
+ * Internal source view carrying the required publication revalidation digest.
+ */
+export interface PublicationSourceView extends ModelSourceView {
+    /**
+     * Complete same-module compiler inputs captured by the publication transaction.
+     */
+    readonly compilerFiles: readonly string[];
+    /**
+     * Fingerprint of configured authored sources and recursive TypeScript configuration inputs.
+     */
+    readonly inventoryDigest: string;
+}
+/**
+ * Fixed internal handoff retained by a root model-generation transaction.
+ */
+export interface SourceViewPublicationRecord {
+    /**
+     * Fixed internal record format version.
+     */
+    readonly formatVersion: 1;
+    /**
+     * SHA-256 fingerprint of the live authored-source and configuration inventory.
+     */
+    readonly inventoryDigest: string;
+    /**
+     * Canonical live generated root excluded from the inventory.
+     */
+    readonly liveGeneratedRoot: string;
+    /**
+     * Canonical live model package root used to recompute the inventory.
+     */
+    readonly livePackageRoot: string;
+}
+/**
+ * Checks that the immutable authored-source inventory is current before publication.
+ *
+ * @param sourceView Compiler input snapshot captured before generation.
+ */
+export declare function assertSourceViewCurrent(sourceView: PublicationSourceView): void;
+/**
+ * Writes the fixed internal source-view handoff for an outer generation stage.
+ *
+ * @param stageRoot Outer staged model package root.
+ * @param sourceView Captured live-authored/staged-generated source view.
+ */
+export declare function writeViewRecord(stageRoot: string, sourceView: PublicationSourceView): void;
+/**
+ * Reads one bounded root-transaction source-view handoff.
+ *
+ * @param stageRoot Outer staged model package root.
+ * @param expectedLivePackageRoot Canonical selected live model package root.
+ * @param expectedLiveGeneratedRoot Canonical selected live generated root.
+ * @returns Validated immutable internal handoff.
+ */
+export declare function readViewRecord(stageRoot: string, expectedLivePackageRoot: string, expectedLiveGeneratedRoot: string): SourceViewPublicationRecord;
+/**
+ * Rejects a changed live source/configuration inventory captured in a handoff.
+ *
+ * @param record Validated internal root-transaction handoff.
+ */
+export declare function assertViewRecordCurrent(record: SourceViewPublicationRecord): void;
+/**
+ * Creates a live-authored/staged-generated compiler source view.
+ *
+ * @param packageRoot Model package root.
+ * @param generatedRoot Configured live generated root.
+ * @param stagedGeneratedRoot Generated tree inside the current stage.
+ * @returns Authored compiler candidates and the staged generated redirect root.
+ */
+export declare function modelSourceView(packageRoot: string, generatedRoot: string, stagedGeneratedRoot: string): PublicationSourceView;
+//# sourceMappingURL=source-view.d.ts.map

package/dist/src/generation/source-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-view.d.ts","sourceRoot":"","sources":["../../../src/generation/source-view.ts"],"names":[],"mappings":"AAsCA;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B,CA0BC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAG9B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAI1C;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAI3C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAI7B;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAInC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAG5D;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAI1C;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAG1C;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AA0FD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAS/E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAW1F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,uBAAuB,EAAE,MAAM,EAC/B,yBAAyB,EAAE,MAAM,GAChC,2BAA2B,CA4D7B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI,CASjF;AA6DD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,GAC1B,qBAAqB,CAavB"}