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

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

@@ -0,0 +1,244 @@
+/*
+ * 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 { closeSync, constants, existsSync, fstatSync, lstatSync, openSync, readFileSync, realpathSync, } from "node:fs";
+import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
+import ts from "typescript";
+const nonRegularInputDiagnostic = "spine-proto: source view contains non-regular TypeScript input";
+const SourceSnapshotFiles = Object.freeze({
+    read(path) {
+        let descriptor;
+        try {
+            descriptor = openSync(path, constants.O_RDONLY | constants.O_NONBLOCK | constants.O_NOFOLLOW);
+            if (!fstatSync(descriptor).isFile())
+                throw new Error(nonRegularInputDiagnostic);
+            return readFileSync(descriptor, "utf8");
+        }
+        catch (error) {
+            if (error instanceof Error && error.message === nonRegularInputDiagnostic)
+                throw error;
+            throw new Error(nonRegularInputDiagnostic, { cause: error });
+        }
+        finally {
+            if (descriptor !== undefined)
+                closeSync(descriptor);
+        }
+    },
+});
+/**
+ * Resolves authored TypeScript interfaces from the validated model source view.
+ */
+export class AuthoredInterfaceProvider {
+    // prettier-ignore
+    programs = new WeakMap();
+    // prettier-ignore
+    /**
+     * Resolves one compatible authored interface from the staged model Program.
+     *
+     * @param name Requested TypeScript interface identifier.
+     * @param members Generated messages that must satisfy the interface.
+     * @param sourceView Validated authored/staged compiler input.
+     * @returns The authored declaration import, or undefined without a source view.
+     */
+    resolve(name, members, sourceView) {
+        if (sourceView === undefined)
+            return undefined;
+        const program = this.program(sourceView);
+        const authoredSources = new Set(sourceView.authoredFiles.map((file) => resolve(file)));
+        const discoveryRoots = program
+            .getRootFileNames()
+            .filter((file) => authoredSources.has(resolve(file)));
+        const declaration = this.declaration(program, discoveryRoots, name);
+        const checker = program.getTypeChecker();
+        this.assertNamedModuleExport(checker, declaration, name);
+        this.assertLocalParents(checker, declaration, name, new Set(), authoredSources);
+        const interfaceType = checker.getTypeAtLocation(declaration);
+        for (const member of members) {
+            const type = this.messageType(program, checker, sourceView, member);
+            if (!checker.isTypeAssignableTo(type, interfaceType))
+                throw new Error(`spine-proto: authored interface ${name}: incompatible message ${member.typeName}`);
+        }
+        return Object.freeze({
+            importPath: this.importPath(sourceView, name, declaration.getSourceFile().fileName),
+            name,
+        });
+    }
+    program(sourceView) {
+        const cached = this.programs.get(sourceView);
+        if (cached !== undefined)
+            return cached;
+        this.assertSourceView(sourceView);
+        const configFile = join(sourceView.packageRoot, "tsconfig.json");
+        if (!existsSync(configFile))
+            throw new Error("spine-proto: authored interface discovery requires tsconfig.json");
+        const readSourceViewText = (path) => SourceSnapshotFiles.read(path);
+        const config = ts.readConfigFile(configFile, readSourceViewText);
+        if (config.error !== undefined)
+            throw new Error("spine-proto: authored interface discovery could not read tsconfig.json");
+        const parsed = ts.parseJsonConfigFileContent(config.config, { ...ts.sys, readFile: readSourceViewText }, sourceView.packageRoot, undefined, configFile);
+        if (parsed.errors.length > 0)
+            throw new Error("spine-proto: authored interface discovery has invalid tsconfig.json");
+        const configuredFiles = new Set(parsed.fileNames.map((file) => resolve(file)));
+        const authoredFiles = sourceView.authoredFiles.filter((file) => configuredFiles.has(resolve(file)));
+        const compilerFiles = sourceView.compilerFiles ?? sourceView.authoredFiles;
+        const capturedAuthored = new Map(compilerFiles.map((file) => [resolve(file), SourceSnapshotFiles.read(file)]));
+        const host = ts.createCompilerHost(parsed.options);
+        const redirect = (path) => {
+            const liveRelative = relative(sourceView.liveGeneratedRoot, resolve(path));
+            return liveRelative === "" || (!liveRelative.startsWith("..") && !isAbsolute(liveRelative))
+                ? join(sourceView.stagedGeneratedRoot, liveRelative)
+                : path;
+        };
+        const readFile = host.readFile.bind(host);
+        const fileExists = host.fileExists.bind(host);
+        host.readFile = (path) => capturedAuthored.get(resolve(path)) ?? readFile(redirect(path));
+        host.fileExists = (path) => capturedAuthored.has(resolve(path)) || fileExists(redirect(path));
+        const program = ts.createProgram({
+            options: parsed.options,
+            ...(parsed.projectReferences === undefined
+                ? {}
+                : { projectReferences: parsed.projectReferences }),
+            rootNames: [...authoredFiles, ...this.stagedFiles(sourceView.stagedGeneratedRoot)],
+            host,
+        });
+        this.programs.set(sourceView, program);
+        return program;
+    }
+    stagedFiles(root) {
+        return ts.sys.readDirectory(root, [".cts", ".mts", ".ts", ".tsx"], undefined, ["**/*"]);
+    }
+    assertSourceView(sourceView) {
+        const packageRoot = realpathSync(sourceView.packageRoot);
+        const canonicalPath = (path) => resolve(packageRoot, relative(sourceView.packageRoot, resolve(path)));
+        const liveGeneratedRoot = canonicalPath(sourceView.liveGeneratedRoot);
+        const parent = dirname(liveGeneratedRoot);
+        const generatedName = basename(liveGeneratedRoot);
+        const stage = join(parent, `.${generatedName}.stage-`);
+        const backup = join(parent, `.${generatedName}.`);
+        const dist = join(packageRoot, "dist");
+        const authoredFiles = new Set(sourceView.authoredFiles.map((file) => resolve(file)));
+        const isDeclaration = (path) => [".d.cts", ".d.mts", ".d.ts"].some((extension) => path.endsWith(extension));
+        const within = (root, path) => {
+            const pathRelative = relative(root, path);
+            return pathRelative === "" || (!pathRelative.startsWith("..") && !isAbsolute(pathRelative));
+        };
+        for (const file of sourceView.compilerFiles ?? sourceView.authoredFiles) {
+            const candidate = canonicalPath(file);
+            if (candidate === dist || candidate.startsWith(`${dist}/`))
+                throw new Error("spine-proto: authored interface discovery source path escapes model module");
+            if (lstatSync(file).isSymbolicLink() ||
+                !within(packageRoot, realpathSync(file)) ||
+                candidate === liveGeneratedRoot ||
+                candidate.startsWith(`${liveGeneratedRoot}/`) ||
+                candidate.startsWith(stage) ||
+                (candidate.startsWith(backup) && candidate.includes(".backup")) ||
+                (authoredFiles.has(resolve(file)) && isDeclaration(candidate)))
+                throw new Error("spine-proto: authored interface discovery source path escapes model module");
+        }
+    }
+    declaration(program, discoveryRoots, name) {
+        const sources = discoveryRoots
+            .map((file) => program.getSourceFile(file))
+            .filter((source) => source !== undefined);
+        const candidates = discoveryRoots.flatMap((file) => {
+            const source = program.getSourceFile(file);
+            if (source === undefined)
+                return [];
+            return source.statements.filter((statement) => ts.isInterfaceDeclaration(statement) && statement.name.text === name);
+        });
+        if (candidates.length === 0) {
+            if (sources.some((source) => source.statements.some((statement) => ts.isTypeAliasDeclaration(statement) && statement.name.text === name)))
+                throw new Error(`spine-proto: authored interface ${name}: declaration is not an interface`);
+            if (sources.some((source) => this.nestedInterface(source, name)))
+                throw new Error(`spine-proto: authored interface ${name}: nested interface is not supported`);
+            throw new Error(`spine-proto: authored interface ${name}: missing top-level interface`);
+        }
+        if (candidates.length > 1)
+            throw new Error(`spine-proto: authored interface ${name}: ambiguous top-level interface`);
+        const declaration = candidates[0];
+        if (declaration === undefined)
+            throw new Error(`spine-proto: authored interface ${name}: missing top-level interface`);
+        if (declaration.typeParameters !== undefined && declaration.typeParameters.length > 0)
+            throw new Error(`spine-proto: authored interface ${name}: generic interface is unbound`);
+        return declaration;
+    }
+    nestedInterface(source, name) {
+        let nested = false;
+        const visit = (node) => {
+            if (node !== source && ts.isInterfaceDeclaration(node) && node.name.text === name)
+                nested = true;
+            ts.forEachChild(node, visit);
+        };
+        ts.forEachChild(source, visit);
+        return nested;
+    }
+    assertNamedModuleExport(checker, declaration, name) {
+        const module = checker.getSymbolAtLocation(declaration.getSourceFile());
+        if (module === undefined ||
+            !checker.getExportsOfModule(module).some((candidate) => candidate.name === name))
+            throw new Error(`spine-proto: authored interface ${name}: declaration must be a named module export`);
+    }
+    messageType(program, checker, sourceView, member) {
+        const proto = member.file.proto.name;
+        const generated = join(sourceView.stagedGeneratedRoot, `${proto.slice(0, -".proto".length)}_pb.ts`);
+        const source = program.getSourceFile(generated);
+        if (source === undefined)
+            throw new Error(`spine-proto: authored interface ${member.name}: missing staged generated message`);
+        const module = checker.getSymbolAtLocation(source);
+        const packagePrefix = `${member.file.proto.package}.`;
+        const generatedName = member.typeName.startsWith(packagePrefix)
+            ? member.typeName.slice(packagePrefix.length).replaceAll(".", "_")
+            : member.name;
+        const symbol = module === undefined
+            ? undefined
+            : checker.getExportsOfModule(module).find((value) => value.name === generatedName);
+        if (symbol === undefined)
+            throw new Error(`spine-proto: authored interface ${member.name}: missing staged generated message`);
+        return checker.getDeclaredTypeOfSymbol(symbol);
+    }
+    assertLocalParents(checker, declaration, name, active, localSources) {
+        const clauses = Object.getOwnPropertyDescriptor(declaration, "heritageClauses")?.value;
+        if (clauses === undefined)
+            return;
+        for (const clause of clauses) {
+            for (const parent of clause.types) {
+                const referenced = checker.getSymbolAtLocation(parent.expression);
+                const symbol = referenced !== undefined && (referenced.flags & ts.SymbolFlags.Alias) !== 0
+                    ? checker.getAliasedSymbol(referenced)
+                    : referenced;
+                if (symbol === undefined)
+                    throw new Error(`spine-proto: authored interface ${name}: extends parent must stay in the model module`);
+                if (active.has(symbol))
+                    throw new Error(`spine-proto: authored interface ${name}: cyclic extends chain`);
+                active.add(symbol);
+                const parentDeclaration = symbol.declarations?.find(ts.isInterfaceDeclaration);
+                if (parentDeclaration === undefined)
+                    throw new Error(`spine-proto: authored interface ${name}: extends parent must stay in the model module`);
+                if (parentDeclaration.typeParameters !== undefined &&
+                    parentDeclaration.typeParameters.length > 0)
+                    throw new Error(`spine-proto: authored interface ${name}: generic extends parent is not supported`);
+                if (!localSources.has(resolve(parentDeclaration.getSourceFile().fileName)))
+                    throw new Error(`spine-proto: authored interface ${name}: extends parent must stay in the model module`);
+                this.assertLocalParents(checker, parentDeclaration, name, active, localSources);
+                active.delete(symbol);
+            }
+        }
+    }
+    importPath(sourceView, name, source) {
+        const output = join(sourceView.liveGeneratedRoot, "interfaces", `${name}.ts`);
+        const extension = extname(source);
+        const path = `${relative(dirname(output), source.slice(0, -extension.length))}.js`;
+        return path.startsWith(".") ? path : `./${path}`;
+    }
+}
+//# sourceMappingURL=authored-interface-provider.js.map

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

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

package/dist/src/generation/generated-source-policy.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Renders a deterministic generated-file notice.
+ */
+export declare const generatedNotice: (sources: readonly string[]) => string;
+/**
+ * Renders the deterministic generated-file notice for script consumers.
+ */
+export declare const generatedFileNotice: (sources: readonly string[]) => string;
+/**
+ * Applies generated provenance to TypeScript source.
+ */
+export declare const generatedSource: (source: string, sources: readonly string[]) => string;
+/**
+ * Applies generated provenance using the script-compatible name.
+ */
+export declare const generatedTypeScript: (source: string, sources: readonly string[]) => string;
+/**
+ * Normalizes generated TypeScript files below a directory.
+ */
+export declare const normalizeGeneratedTree: (root: string, sources: readonly string[]) => void;
+//# sourceMappingURL=generated-source-policy.d.ts.map

package/dist/src/generation/generated-source-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-source-policy.d.ts","sourceRoot":"","sources":["../../../src/generation/generated-source-policy.ts"],"names":[],"mappings":"AA+IA;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,MAC7B,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,MAAwB,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,MAC7C,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,MACjE,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,IAC3C,CAAC"}

package/dist/src/generation/generated-source-policy.js

@@ -0,0 +1,126 @@
+/*
+ * 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.
+ */
+/* Shared publishable generated-TypeScript provenance policy. */
+import { readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Renders a deterministic generated-file notice.
+ * @param sources Stable source Proto import paths.
+ * @returns The generated-file notice.
+ */
+const generatedPolicy = Object.freeze({
+    generatedNotice(sources) {
+        const paths = [...new Set(sources)].sort();
+        if (paths.length === 0 || !paths.every(generatedPolicy.stableProtoPath))
+            throw new Error(`spine-proto: generated source requires stable Proto provenance ${JSON.stringify(paths)}`);
+        return [
+            "/*",
+            " * Generated by Spine TypeScript. Do not edit manually.",
+            ...paths.map((path) => ` * Source Proto: ${path}`),
+            " */",
+            "",
+            "",
+        ].join("\n");
+    },
+    /* Applies generated provenance to TypeScript source. */
+    generatedSource(source, sources) {
+        let copiedPreamble = source.replace(/^\/\*\n \* Generated by Spine TypeScript\. Do not edit manually\.\n(?: \* Source Proto: .*\n)+ \*\/\n*/u, "");
+        const leadingBlock = /^\/\*[\s\S]*?\*\/\s*/u.exec(copiedPreamble)?.[0];
+        if (leadingBlock !== undefined &&
+            /copyright|licen[cs](?:ed|e)|proprietary|confidential/iu.test(leadingBlock))
+            copiedPreamble = copiedPreamble.slice(leadingBlock.length);
+        const leadingLines = /^(?:(?:\/\/[^\n]*\n)+)/u.exec(copiedPreamble)?.[0];
+        if (leadingLines !== undefined &&
+            /copyright|licen[cs](?:ed|e)|proprietary|confidential/iu.test(leadingLines))
+            copiedPreamble = `${leadingLines
+                .split("\n")
+                .filter((line) => line.startsWith("// @generated"))
+                .join("\n")}\n${copiedPreamble.slice(leadingLines.length)}`;
+        const withoutCopyright = copiedPreamble;
+        const lines = withoutCopyright.split("\n");
+        const generatedAt = lines.findIndex((line) => line.startsWith("// @generated"));
+        const body = generatedAt !== -1 && lines.slice(0, generatedAt).some((line) => line.includes("CodeMatters"))
+            ? lines.slice(generatedAt).join("\n")
+            : withoutCopyright;
+        const provenance = ` * Generated from Proto: ${[...new Set(sources)].sort().join(", ")}.`;
+        return `${generatedPolicy.generatedNotice(sources)}${body.replace(/(^|\n)(\/\*\*[\s\S]*?\*\/\n)?(export (?:declare )?(?:const|interface|enum|type|class|function) )/gu, (_match, prefix, documentation, declaration) => {
+            const cleaned = (documentation ?? "").replace(/ \* Generated from Proto: .*\.\n/gu, "");
+            const oneLine = /^\/\*\*[ \t]*([^\n]*?)[ \t]*\*\/\n$/u.exec(cleaned);
+            const normalized = oneLine === null ? cleaned : `/**\n * ${oneLine[1] ?? ""}\n */\n`;
+            return cleaned === ""
+                ? `${prefix}/**\n${provenance}\n */\n${declaration}`
+                : `${prefix}${normalized.replace(/ \*\/\n$/u, `${provenance}\n */\n`)}${declaration}`;
+        })}`;
+    },
+    /* Normalizes generated TypeScript files below a directory. */
+    normalizeGeneratedTree(root, sources) {
+        generatedPolicy.normalizeGeneratedTreeAt(root, sources, 0, { entries: 0 });
+    },
+    normalizeGeneratedTreeAt(root, sources, depth, state) {
+        if (depth > 64 || state.entries > 1_000)
+            throw new Error("spine-proto: generated source traversal exceeds bounded inventory");
+        for (const entry of readdirSync(root, { withFileTypes: true })) {
+            state.entries += 1;
+            if (state.entries > 1_000)
+                throw new Error("spine-proto: generated source traversal exceeds bounded inventory");
+            const path = join(root, entry.name);
+            if (entry.isDirectory())
+                generatedPolicy.normalizeGeneratedTreeAt(path, sources, depth + 1, state);
+            else if (entry.isFile() &&
+                (/(?:_pb|rejections|_columns|proto-module|generated-handler-registry)\.ts$/u.test(path) ||
+                    /[\\/]interfaces[\\/].+\.ts$/u.test(path))) {
+                const source = readFileSync(path, "utf8");
+                const derived = [
+                    ...source.matchAll(/from "(?:[^" ]+\/generated\/)?([^" ]+)_pb\.js"/gu),
+                ].map((match) => (match[1] ?? "").replace(/^\.\//u, "").replace(/^.*?spine\//u, "spine/") + ".proto");
+                const generated = [...source.matchAll(/@generated from file ([^\s)]+)/gu)].map((match) => match[1] ?? "");
+                const provenance = generated.length > 0 ? generated : derived.length > 0 ? derived : sources;
+                if (provenance.length > 0)
+                    writeFileSync(path, generatedPolicy.generatedSource(source, provenance), "utf8");
+            }
+        }
+    },
+    stableProtoPath(path) {
+        const components = path.split("/");
+        return (typeof path === "string" &&
+            path.length > 0 &&
+            path.endsWith(".proto") &&
+            !path.startsWith("/") &&
+            !/^[A-Za-z]:/u.test(path) &&
+            !components.some((part) => part === "" || part === "." || part === "..") &&
+            !path.includes("\\") &&
+            !components.some((part) => part === "tmp" || part === "temp" || /^\.(?:generated|stage|backup)(?:-|$)/u.test(part)));
+    },
+});
+/**
+ * Renders a deterministic generated-file notice.
+ */
+export const generatedNotice = generatedPolicy.generatedNotice;
+/**
+ * Renders the deterministic generated-file notice for script consumers.
+ */
+export const generatedFileNotice = generatedNotice;
+/**
+ * Applies generated provenance to TypeScript source.
+ */
+export const generatedSource = generatedPolicy.generatedSource;
+/**
+ * Applies generated provenance using the script-compatible name.
+ */
+export const generatedTypeScript = generatedSource;
+/**
+ * Normalizes generated TypeScript files below a directory.
+ */
+export const normalizeGeneratedTree = generatedPolicy.normalizeGeneratedTree;
+//# sourceMappingURL=generated-source-policy.js.map

package/dist/src/generation/generated-source-policy.js.map

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

package/dist/src/generation/generation-reuse.mjs

@@ -0,0 +1,84 @@
+/*
+ * 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, readFileSync, readdirSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+
+export const generationMarkerFile = ".spine-proto-generation.json";
+
+function canonicalJson(value) {
+  if (Array.isArray(value)) return value.map(canonicalJson);
+  if (typeof value === "object" && value !== null)
+    return Object.fromEntries(
+      Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, nested]) => [key, canonicalJson(nested)]),
+    );
+  return value;
+}
+
+function markerId(root) {
+  try {
+    const marker = JSON.parse(readFileSync(join(root, generationMarkerFile), "utf8"));
+    return typeof marker.generationId === "string" && marker.generationId.length > 0
+      ? marker.generationId
+      : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function treeContents(root) {
+  const files = [];
+  const pending = [[root, 0]];
+  let entries = 0;
+  while (pending.length > 0) {
+    const [directory, depth] = pending.pop();
+    if (depth > 64) throw new Error("generated TypeScript traversal exceeds bounded inventory");
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+      entries += 1;
+      if (entries > 1_000)
+        throw new Error("generated TypeScript traversal exceeds bounded inventory");
+      const path = join(directory, entry.name);
+      if (lstatSync(path).isSymbolicLink())
+        throw new Error("generated TypeScript traversal must not contain symlinks");
+      if (entry.isDirectory()) pending.push([path, depth + 1]);
+      else if (entry.isFile() && entry.name !== generationMarkerFile)
+        files.push([relative(root, path).split(sep).join("/"), readFileSync(path, "utf8")]);
+    }
+  }
+  return files.sort(([left], [right]) => left.localeCompare(right));
+}
+
+export function reusableGenerationId(liveManifestPath, liveRoot, stagedManifest, stagedRoot) {
+  try {
+    const liveManifest = JSON.parse(readFileSync(liveManifestPath, "utf8"));
+    const { generationId: liveGenerationId, ...liveContents } = liveManifest;
+    const { generationId: stagedGenerationId, ...stagedContents } = stagedManifest;
+    if (
+      liveManifest.formatVersion !== 2 ||
+      typeof liveGenerationId !== "string" ||
+      liveGenerationId.length === 0 ||
+      markerId(liveRoot) !== liveGenerationId ||
+      markerId(stagedRoot) !== stagedGenerationId ||
+      JSON.stringify(canonicalJson(liveContents)) !==
+        JSON.stringify(canonicalJson(stagedContents)) ||
+      JSON.stringify(treeContents(liveRoot)) !== JSON.stringify(treeContents(stagedRoot))
+    )
+      return undefined;
+    return liveGenerationId;
+  } catch {
+    return undefined;
+  }
+}