ttsc 0.26.2 → 0.28.0

package/lib/plugin/internal/capabilityResolutionCache.js

@@ -0,0 +1,224 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCapabilityResolution = readCapabilityResolution;
+exports.writeCapabilityResolution = writeCapabilityResolution;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const buildSourcePlugin_1 = require("./buildSourcePlugin");
+const loadProjectPlugins_1 = require("./loadProjectPlugins");
+/**
+ * Cache format tag.
+ *
+ * Moves when the entry shape or the validation rule changes, so an older entry
+ * is discarded rather than read under new rules.
+ */
+const FORMAT = "ttsc-capability-resolution-v1";
+/**
+ * The character that joins fields a path could otherwise forge.
+ *
+ * A path cannot contain it, which is the whole reason it is the separator: with
+ * a space, a file named `a 1 2` states the same string as a one-byte file named
+ * `a`, and an edit to either would read as no edit at all. Built rather than
+ * written literally, because a source file carrying a raw NUL is one Git
+ * classifies as binary — which silently exempts it from this repository's
+ * end-of-line contract and leaves it with no textual diff for a reviewer.
+ */
+const SEPARATOR = String.fromCharCode(0);
+/**
+ * Read the recorded answer for a project, or `null` when there is none that is
+ * still true.
+ *
+ * Fail-closed by construction: every path that cannot prove the entry — a
+ * missing file, a parse failure, a format bump, a moved input, a rebuilt plugin
+ * source, a binary that is gone — returns `null`, and `null` means "walk the
+ * project properly". A cache that guessed here would answer "no plugin declares
+ * this capability" for a project that had just configured one, which is a wrong
+ * answer indistinguishable from the correct answer for the common case.
+ */
+function readCapabilityResolution(options) {
+    const file = resolutionFile(options);
+    if (file === null)
+        return null;
+    let entry;
+    try {
+        entry = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+    }
+    catch {
+        return null;
+    }
+    if (!isEntry(entry) || entry.version !== formatVersion(options.version))
+        return null;
+    // An entry recording nothing proves nothing. Discovery always reads at least
+    // the project's own manifest, so an empty input set is a malformed entry
+    // rather than a project with no inputs.
+    if (entry.hostInputs.length === 0)
+        return null;
+    if (!sameMap(entry.hostInputHashes, (0, loadProjectPlugins_1.hashHostInputPaths)(entry.hostInputs)) ||
+        !sameMap(entry.hostInputRealpaths, (0, loadProjectPlugins_1.realpathHostInputPaths)(entry.hostInputs)))
+        return null;
+    for (const [source, fingerprint] of Object.entries(entry.sources))
+        if (fingerprintDirectory(source) !== fingerprint)
+            return null;
+    for (const plugin of entry.plugins)
+        if (!node_fs_1.default.existsSync(plugin.binary))
+            return null;
+    return entry;
+}
+/**
+ * Record the answer and the state it was true for.
+ *
+ * A write failure is not reported. The cache is an optimization over a walk
+ * that still works, and a read-only or full disk is a reason to be slower, not
+ * a reason for `resolveCapabilityPlugins` to start throwing at a caller whose
+ * contract is that it never does.
+ */
+function writeCapabilityResolution(options, answer) {
+    const file = resolutionFile(options);
+    if (file === null)
+        return;
+    const hostInputs = [
+        ...new Set(answer.hostInputs
+            .filter((input) => input !== "")
+            .map((input) => node_path_1.default.resolve(input))),
+    ].sort();
+    if (hostInputs.length === 0)
+        return;
+    const entry = {
+        hostInputHashes: (0, loadProjectPlugins_1.hashHostInputPaths)(hostInputs),
+        hostInputRealpaths: (0, loadProjectPlugins_1.realpathHostInputPaths)(hostInputs),
+        hostInputs,
+        manifest: answer.manifest,
+        plugins: [...answer.plugins],
+        projectContext: answer.projectContext,
+        sources: Object.fromEntries([...new Set(answer.plugins.map((plugin) => plugin.source))]
+            .filter((source) => source !== "")
+            .map((source) => [source, fingerprintDirectory(source)])),
+        version: formatVersion(options.version),
+    };
+    try {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(file), { recursive: true });
+        // Written beside the target and renamed, so a reader never sees half an
+        // entry: a truncated JSON parses as a failure and falls back, but a
+        // partially written one could parse and be believed.
+        const staging = `${file}.${String(process.pid)}.tmp`;
+        node_fs_1.default.writeFileSync(staging, JSON.stringify(entry), "utf8");
+        node_fs_1.default.renameSync(staging, file);
+    }
+    catch {
+        return;
+    }
+}
+function formatVersion(version) {
+    return `${FORMAT}:${version}`;
+}
+/**
+ * Where the entry for this project lives, or `null` when no cache root can be
+ * resolved.
+ *
+ * Keyed on the project rather than on the capability: the walk it replaces
+ * discovers every configured plugin, so one entry answers for all of them and a
+ * second consumer asking about a different capability costs nothing.
+ */
+function resolutionFile(options) {
+    let root;
+    try {
+        root = (0, buildSourcePlugin_1.resolveSourceBuildCachePaths)(node_path_1.default.resolve(options.cwd), undefined, options.env ?? process.env).root;
+    }
+    catch {
+        return null;
+    }
+    const key = node_crypto_1.default
+        .createHash("sha256")
+        .update(node_path_1.default.resolve(options.cwd))
+        .update(SEPARATOR)
+        .update(options.tsconfig)
+        .digest("hex");
+    return node_path_1.default.join(root, "capabilities", `${key}.json`);
+}
+/** Whether the parsed value has every field the validation reads. */
+function isEntry(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const entry = value;
+    return (typeof entry.version === "string" &&
+        Array.isArray(entry.hostInputs) &&
+        entry.hostInputs.every((input) => typeof input === "string") &&
+        isRecord(entry.hostInputHashes) &&
+        isRecord(entry.hostInputRealpaths) &&
+        isRecord(entry.sources) &&
+        typeof entry.manifest === "string" &&
+        (entry.projectContext === null ||
+            typeof entry.projectContext === "string") &&
+        Array.isArray(entry.plugins) &&
+        entry.plugins.every((plugin) => typeof plugin === "object" &&
+            plugin !== null &&
+            typeof plugin.binary === "string" &&
+            typeof plugin.source === "string" &&
+            isRecord(plugin.capabilities)));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Whether two snapshots describe the same state.
+ *
+ * Compared both ways: an input that has appeared is as much a change as one
+ * that has moved, and a recorded key the fresh snapshot lacks means the two
+ * were taken over different input sets.
+ */
+function sameMap(recorded, current) {
+    const keys = Object.keys(recorded);
+    if (keys.length !== Object.keys(current).length)
+        return false;
+    return keys.every((key) => Object.prototype.hasOwnProperty.call(current, key) &&
+        recorded[key] === current[key]);
+}
+/**
+ * A directory's shape and the state of every file in it.
+ *
+ * Size and modification time rather than content: a plugin's Go source is
+ * hundreds of files, this runs on the fast path, and the question it answers is
+ * only whether the build cache would now key on something else. Bounded in
+ * depth, and blind to `node_modules` and dot directories, for the same reason
+ * the build that reads this source is.
+ */
+function fingerprintDirectory(directory, depth = 0) {
+    const hash = node_crypto_1.default.createHash("sha256");
+    for (const line of directoryState(directory, depth).sort())
+        hash.update(line).update("\n");
+    return hash.digest("hex");
+}
+function directoryState(directory, depth) {
+    if (depth > 16)
+        return [];
+    let entries;
+    try {
+        entries = node_fs_1.default.readdirSync(directory, { withFileTypes: true });
+    }
+    catch {
+        return [`${directory}${SEPARATOR}absent`];
+    }
+    const states = [];
+    for (const entry of entries) {
+        const child = node_path_1.default.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            states.push(...directoryState(child, depth + 1));
+            continue;
+        }
+        try {
+            const stat = node_fs_1.default.statSync(child);
+            states.push([child, String(stat.size), String(stat.mtimeMs)].join(SEPARATOR));
+        }
+        catch {
+            states.push(`${child}${SEPARATOR}absent`);
+        }
+    }
+    return states;
+}
+//# sourceMappingURL=capabilityResolutionCache.js.map

package/lib/plugin/internal/capabilityResolutionCache.js.map

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

package/lib/plugin/internal/loadProjectPlugins.d.ts

@@ -7,17 +7,18 @@ import type { ITtscParsedProjectConfig } from "../../structures/internal/ITtscPa
  * Reads the project config, discovers plugin entries (from tsconfig and package
  * auto-discovery), validates and composes their descriptors, then invokes
  * `buildSourcePlugin` to compile each Go source package into a cached binary.
- * Returns the ordered set of loaded native plugins alongside the parsed project
- * config.
+ * Returns the ordered native plugins, parsed project config, and exact
+ * JavaScript-host files that universally influence the loaded selection.
  *
  * @param options.binary - Absolute path to the ttsc native helper binary.
  * @param options.cacheDir - Override the plugin binary cache directory.
  * @param options.cwd - Working directory for resolving relative paths.
  * @param options.entries - Explicit plugin entries; `false` disables all
  *   plugins (skips both tsconfig entries and package auto-discovery).
- * @param options.env - Effective environment for source-plugin builds and the
- *   `ttsx` descriptor child (`{ ...process.env, ...context.env }`). Defaults to
- *   `process.env` for CLI callers, so ambient behavior is unchanged.
+ * @param options.env - Effective environment for source-plugin builds and
+ *   isolated descriptor evaluators, including the `ttsx` fallback (`{
+ *   ...process.env, ...context.env }`). Defaults to `process.env` for CLI
+ *   callers, so ambient behavior is unchanged.
  * @param options.file - Path to the tsconfig/jsconfig file.
  * @param options.pluginConfigDir - Caller-declared anchor for plugin
  *   config-file discovery (see `ITtscPluginFactoryContext.pluginConfigDir`).
@@ -36,9 +37,18 @@ export declare function loadProjectPlugins(options: {
     projectRoot?: string;
     tsconfig?: string;
 }): {
+    hostInputHashes: Record<string, string | null>;
+    hostInputRealpaths: Record<string, string | null>;
+    hostInputs: string[];
     nativePlugins: ITtscLoadedNativePlugin[];
     project: ITtscParsedProjectConfig;
 };
+export declare function hashHostInputPaths(files: readonly string[]): Record<string, string | null>;
+/** Physical path selected by a host input, or null while it is unresolved. */
+export declare function realpathHostInput(file: string): string | null;
+export declare function realpathHostInputPaths(files: readonly string[]): Record<string, string | null>;
+/** Return config ancestry and the manifest controlling package discovery. */
+export declare function collectProjectHostInputs(project: ITtscParsedProjectConfig, includePluginDiscovery?: boolean): string[];
 /**
  * Return `true` when the project has at least one enabled plugin entry.
  *
@@ -48,6 +58,8 @@ export declare function loadProjectPlugins(options: {
  * @param entries - Explicit entries; `false` always returns `false`.
  */
 export declare function hasProjectPluginEntries(project: ITtscParsedProjectConfig, entries?: readonly ITtscProjectPluginConfig[] | false): boolean;
+/** CommonJS evaluator emitted into a clean Node process for every load. */
+export declare const COMMONJS_PLUGIN_DESCRIPTOR_SHIM_SOURCE: string;
 /**
  * The descriptor shim's emitted source.
  *