@procedures/client 0.0.0-stage → 0.2.0

package/dist/procedures/cli/announce.js

@@ -0,0 +1,392 @@
+/**
+ * Procedure Announcement (Self-Registration)
+ *
+ * When a package with procedures is installed, it "announces" itself
+ * by writing to a registry file at the root of the project.
+ *
+ * This enables true bottom-up propagation:
+ * - Each package with procedures has `"postinstall": "client-registry announce"`
+ * - On install, it walks up to find the root and registers itself
+ * - `client-registry discover` reads this registry instead of scanning
+ *
+ * The registry file (.client-registry.json) accumulates entries from
+ * all packages as they're installed, making discovery instant.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+// =============================================================================
+// Path Utilities
+// =============================================================================
+/**
+ * Find the root of the project (topmost directory with package.json that isn't in node_modules).
+ */
+async function findProjectRoot(startDir) {
+    let current = path.resolve(startDir);
+    let lastValidRoot = null;
+    while (true) {
+        const pkgPath = path.join(current, "package.json");
+        try {
+            await fs.access(pkgPath);
+            // Check if we're inside node_modules
+            const isInNodeModules = current.includes("node_modules");
+            if (!isInNodeModules) {
+                // This is a valid root candidate
+                lastValidRoot = current;
+            }
+        }
+        catch {
+            // No package.json here
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Reached filesystem root
+            break;
+        }
+        current = parent;
+    }
+    return lastValidRoot;
+}
+/**
+ * Find the package that contains the current directory.
+ * This is the package that depends on client and is being installed.
+ */
+async function findContainingPackage(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        const pkgPath = path.join(current, "package.json");
+        try {
+            const content = await fs.readFile(pkgPath, "utf-8");
+            const pkg = JSON.parse(content);
+            return { dir: current, pkg };
+        }
+        catch {
+            // No package.json here, go up
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Reached filesystem root
+            break;
+        }
+        current = parent;
+    }
+    return null;
+}
+// =============================================================================
+// Registry Operations
+// =============================================================================
+const REGISTRY_FILENAME = ".client-registry.json";
+/**
+ * Read the registry file, or return an empty registry if the file does not exist.
+ *
+ * Any other failure is an error. Before, every failure gave an empty registry, so a read that
+ * failed (a corrupt file, a file that Windows held for a moment) made the next write remove
+ * every entry.
+ */
+async function readRegistry(rootDir) {
+    const registryPath = path.join(rootDir, REGISTRY_FILENAME);
+    let content;
+    try {
+        content = await retryOnWindowsContention(() => fs.readFile(registryPath, "utf-8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { schemaVersion: 1, packages: {} };
+        }
+        throw error;
+    }
+    return JSON.parse(content);
+}
+/**
+ * Run a file operation again when Windows reports that another process holds the file for a
+ * moment (EPERM, EACCES, EBUSY): a rename over a file that a reader has open fails that way.
+ */
+async function retryOnWindowsContention(operation) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (attempt >= 20 || !isLockContention(error) || error.code === "EEXIST")
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, 10 * attempt));
+        }
+    }
+}
+/**
+ * Write the registry file: to a temporary file, then a rename, so a reader never sees a part.
+ */
+async function writeRegistry(rootDir, registry) {
+    const registryPath = path.join(rootDir, REGISTRY_FILENAME);
+    const content = JSON.stringify(registry, null, 2) + "\n";
+    const temporary = `${registryPath}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+    try {
+        await fs.writeFile(temporary, content, "utf-8");
+        await retryOnWindowsContention(() => fs.rename(temporary, registryPath));
+    }
+    catch (error) {
+        await fs.rm(temporary, { force: true });
+        throw error;
+    }
+}
+/** A lock older than this belongs to a process that stopped: it is removed. */
+const STALE_LOCK_MS = 10_000;
+/**
+ * True when another writer holds the lock. On Windows, a lock file that its owner is deleting
+ * cannot be opened until the delete completes: `open` fails with EPERM (or EACCES, EBUSY), not
+ * EEXIST.
+ */
+function isLockContention(error) {
+    const code = error.code;
+    if (code === "EEXIST")
+        return true;
+    return process.platform === "win32" && (code === "EPERM" || code === "EACCES" || code === "EBUSY");
+}
+/**
+ * Read, change and write the registry under a lock file. Package managers run postinstall
+ * scripts in parallel: without the lock, two announcements read the same registry, and the
+ * second write loses the first entry (deep dive CORE-17).
+ */
+async function updateRegistry(rootDir, change) {
+    const lockPath = path.join(rootDir, `${REGISTRY_FILENAME}.lock`);
+    const deadline = Date.now() + 30_000;
+    for (;;) {
+        try {
+            const handle = await fs.open(lockPath, "wx");
+            await handle.close();
+            break;
+        }
+        catch (error) {
+            if (!isLockContention(error) || Date.now() > deadline)
+                throw error;
+            try {
+                const { mtimeMs } = await fs.stat(lockPath);
+                if (Date.now() - mtimeMs > STALE_LOCK_MS)
+                    await fs.rm(lockPath, { force: true });
+            }
+            catch {
+                // The lock went away: try again
+            }
+            await new Promise((resolve) => setTimeout(resolve, 10 + Math.random() * 20));
+        }
+    }
+    try {
+        const registry = await readRegistry(rootDir);
+        if (change(registry)) {
+            await writeRegistry(rootDir, registry);
+        }
+    }
+    finally {
+        await fs.rm(lockPath, { force: true });
+    }
+}
+// =============================================================================
+// Main
+// =============================================================================
+/**
+ * Announce this package's procedures to the project registry.
+ *
+ * Called from a package's postinstall script to register its procedures.
+ *
+ * With `propagate: true` (`client-registry announce --propagate`), it also adds the postinstall script
+ * to the package that depends on this one, for transitive discovery:
+ * - When client is installed in package D, client's postinstall adds postinstall to D
+ * - When D is installed in C, D's postinstall adds postinstall to C
+ * - When C is installed in B, C's postinstall adds postinstall to B
+ *
+ * The propagation edits the package.json of the consumer, so it happens only when asked.
+ * Without it, each package that has its own postinstall script still registers itself.
+ */
+export async function announce(options) {
+    const { verbose } = options;
+    // Find the package we're in (the one whose postinstall is running)
+    const containing = await findContainingPackage(options.cwd ?? process.cwd());
+    if (!containing) {
+        if (verbose) {
+            console.log("[client] No package.json found, skipping announcement");
+        }
+        return;
+    }
+    const { dir: packageDir, pkg } = containing;
+    // Propagate the postinstall script to the parent package only when asked: it edits the
+    // consumer's package.json (deep dive CORE-17)
+    if (options.propagate) {
+        await propagatePostinstallToParent(packageDir, pkg, verbose);
+    }
+    // If this package has procedures, register them
+    if (pkg.client?.procedures) {
+        await registerProcedures(packageDir, pkg, verbose);
+    }
+    else if (verbose) {
+        console.log(`[client] ${pkg.name} does not declare procedures`);
+    }
+}
+/**
+ * Register this package's procedures at the project root.
+ */
+async function registerProcedures(packageDir, pkg, verbose) {
+    // Find the project root
+    const projectRoot = await findProjectRoot(packageDir);
+    if (!projectRoot) {
+        if (verbose) {
+            console.log("[client] Could not find project root, skipping registration");
+        }
+        return;
+    }
+    // Don't register if we ARE the project root (we're the app, not a dependency)
+    if (path.resolve(packageDir) === path.resolve(projectRoot)) {
+        if (verbose) {
+            console.log(`[client] ${pkg.name} is the project root, skipping self-registration`);
+        }
+        return;
+    }
+    // Add/update our entry, under the lock
+    const entry = {
+        proceduresPath: pkg.client.procedures,
+        registeredAt: new Date().toISOString(),
+    };
+    if (pkg.version) {
+        entry.version = pkg.version;
+    }
+    await updateRegistry(projectRoot, (registry) => {
+        registry.packages[pkg.name] = entry;
+        return true;
+    });
+    if (verbose) {
+        console.log(`[client] Registered ${pkg.name} -> ${pkg.client.procedures}`);
+    }
+}
+/**
+ * Propagate postinstall to the parent package.
+ * This ensures the chain continues when this package is installed elsewhere.
+ */
+async function propagatePostinstallToParent(packageDir, pkg, verbose) {
+    // Find parent package (the one that depends on this package)
+    const parent = await findParentPackage(packageDir);
+    if (!parent) {
+        if (verbose) {
+            console.log(`[client] No parent package found for ${pkg.name}`);
+        }
+        return;
+    }
+    const { dir: parentDir, pkg: parentPkg } = parent;
+    // Don't modify packages inside node_modules of other packages
+    // We only want to modify the immediate dependent
+    if (isNestedNodeModules(parentDir)) {
+        if (verbose) {
+            console.log(`[client] Parent ${parentPkg.name} is nested in node_modules, skipping`);
+        }
+        return;
+    }
+    await ensurePostinstall(parentDir, parentPkg, verbose);
+}
+/**
+ * Find the parent package (the one that depends on the current package).
+ * Walks up from node_modules to find the containing project.
+ */
+async function findParentPackage(packageDir) {
+    let current = path.dirname(packageDir);
+    while (true) {
+        // Skip node_modules directories
+        const basename = path.basename(current);
+        if (basename === "node_modules") {
+            current = path.dirname(current);
+            continue;
+        }
+        const pkgPath = path.join(current, "package.json");
+        try {
+            const content = await fs.readFile(pkgPath, "utf-8");
+            const pkg = JSON.parse(content);
+            return { dir: current, pkg };
+        }
+        catch {
+            // No package.json here
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return null;
+}
+/**
+ * Check if a path is inside nested node_modules (e.g., node_modules/a/node_modules/b).
+ */
+function isNestedNodeModules(dir) {
+    const normalized = dir.replace(/\\/g, "/");
+    const parts = normalized.split("/node_modules/");
+    return parts.length > 2;
+}
+/**
+ * Ensure a package has the postinstall script for propagation.
+ */
+async function ensurePostinstall(packageDir, pkg, verbose) {
+    const pkgPath = path.join(packageDir, "package.json");
+    let fullPkg;
+    try {
+        fullPkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+    }
+    catch {
+        if (verbose) {
+            console.log(`[client] Could not read ${pkgPath}`);
+        }
+        return;
+    }
+    const scripts = (fullPkg["scripts"] ?? {});
+    const postinstall = scripts["postinstall"] ?? "";
+    // Check if postinstall already includes client-registry announce
+    if (postinstall.includes("client-registry announce")) {
+        if (verbose) {
+            console.log(`[client] ${pkg.name} already has client-registry announce in postinstall`);
+        }
+        return;
+    }
+    // Add client-registry announce to postinstall (cross-platform, no shell-specific syntax)
+    // The CLI handles errors internally and always exits 0
+    const newPostinstall = postinstall
+        ? `${postinstall} && client-registry announce`
+        : "client-registry announce";
+    scripts["postinstall"] = newPostinstall;
+    fullPkg["scripts"] = scripts;
+    try {
+        await fs.writeFile(pkgPath, JSON.stringify(fullPkg, null, 2) + "\n", "utf-8");
+        if (verbose) {
+            console.log(`[client] Added postinstall to ${pkg.name}`);
+        }
+    }
+    catch (error) {
+        if (verbose) {
+            console.log(`[client] Could not write to ${pkgPath}: ${error}`);
+        }
+    }
+}
+/**
+ * Remove this package from the registry (for uninstall).
+ */
+export async function unannounce(options) {
+    const { verbose } = options;
+    const containing = await findContainingPackage(options.cwd ?? process.cwd());
+    if (!containing)
+        return;
+    const { dir: packageDir, pkg } = containing;
+    const projectRoot = await findProjectRoot(packageDir);
+    if (!projectRoot)
+        return;
+    await updateRegistry(projectRoot, (registry) => {
+        if (!registry.packages[pkg.name])
+            return false;
+        delete registry.packages[pkg.name];
+        if (verbose) {
+            console.log(`[client] Unregistered ${pkg.name}`);
+        }
+        return true;
+    });
+}
+/**
+ * Get the registry for use by discover command.
+ */
+export async function getRegistry(rootDir) {
+    return readRegistry(rootDir);
+}
+export { REGISTRY_FILENAME };
+//# sourceMappingURL=announce.js.map

package/dist/procedures/cli/announce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce.js","sourceRoot":"","sources":["../../../src/procedures/cli/announce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA2ClC,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,aAAa,GAAkB,IAAI,CAAC;IAExC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAEzB,qCAAqC;YACrC,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAEzD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,iCAAiC;gBACjC,aAAa,GAAG,OAAO,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,0BAA0B;YAC1B,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAAC,QAAgB;IACnD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;YAC/C,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,0BAA0B;YAC1B,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAElD;;;;;;GAMG;AACH,KAAK,UAAU,YAAY,CAAC,OAAe;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAC3D,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,wBAAwB,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,wBAAwB,CAAI,SAA2B;IACpE,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACjH,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,QAAkB;IAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACzD,MAAM,SAAS,GAAG,GAAG,YAAY,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9F,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,wBAAwB,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;IACnD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC;AACrG,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,MAAuC;IACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,iBAAiB,OAAO,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IACrC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACnE,IAAI,CAAC;gBACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5C,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,aAAa;oBAAE,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnF,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrB,MAAM,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,mEAAmE;IACnE,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC;IAE5C,uFAAuF;IACvF,8CAA8C;IAC9C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,4BAA4B,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,gDAAgD;IAChD,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QAC3B,MAAM,kBAAkB,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,8BAA8B,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAAC,UAAkB,EAAE,GAAgB,EAAE,OAAgB;IACtF,wBAAwB;IACxB,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO;IACT,CAAC;IAED,8EAA8E;IAC9E,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3D,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,kDAAkD,CAAC,CAAC;QACtF,CAAC;QACD,OAAO;IACT,CAAC;IAED,uCAAuC;IACvC,MAAM,KAAK,GAAkB;QAC3B,cAAc,EAAE,GAAG,CAAC,MAAO,CAAC,UAAW;QACvC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACvC,CAAC;IACF,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC9B,CAAC;IACD,MAAM,cAAc,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC7C,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,MAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,4BAA4B,CAAC,UAAkB,EAAE,GAAgB,EAAE,OAAgB;IAChG,6DAA6D;IAC7D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,wCAAwC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAElD,8DAA8D;IAC9D,iDAAiD;IACjD,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,IAAI,sCAAsC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IACjD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvC,OAAO,IAAI,EAAE,CAAC;QACZ,gCAAgC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;YAC/C,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACtC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,UAAkB,EAAE,GAAgB,EAAE,OAAgB;IACrF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAEtD,IAAI,OAAgC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAA4B,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAA2B,CAAC;IACrE,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAEjD,iEAAiE;IACjE,IAAI,WAAW,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,sDAAsD,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO;IACT,CAAC;IAED,yFAAyF;IACzF,uDAAuD;IACvD,MAAM,cAAc,GAAG,WAAW;QAChC,CAAC,CAAC,GAAG,WAAW,8BAA8B;QAC9C,CAAC,CAAC,0BAA0B,CAAC;IAE/B,OAAO,CAAC,aAAa,CAAC,GAAG,cAAc,CAAC;IACxC,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9E,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAwB;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,UAAU;QAAE,OAAO;IAExB,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC;IAC5C,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,MAAM,cAAc,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC7C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/C,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/procedures/cli/discover.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Procedure Discovery
+ *
+ * Generates a TypeScript file with static imports for all discovered procedures.
+ *
+ * Fast path: Reads from .client-registry.json (populated by `client-registry announce`)
+ * Fallback: Scans node_modules for packages with `client.procedures`
+ *
+ * This is compile-time discovery - the generated file contains static imports
+ * that get compiled/bundled with your application.
+ */
+export interface DiscoverOptions {
+    /** Output file path */
+    output: string;
+    /** Root directory to scan from */
+    root: string;
+    /** Watch mode for development */
+    watch: boolean;
+    /** Check if generated file is up-to-date (CI mode) */
+    check: boolean;
+    /** Verbose logging */
+    verbose: boolean;
+}
+/** A package that declares procedures. */
+export interface DiscoveredPackage {
+    name: string;
+    proceduresPath: string;
+    /** The module specifier that the generated file imports */
+    importPath: string;
+}
+/**
+ * The specifier that imports the procedures file of a package. With an `exports` map, a bare
+ * `pkg/dist/register.js` import fails unless the map exports that path: the function looks for
+ * the subpath (also a `./*` pattern) whose target is the file: for the packages of this
+ * repository, `./register`. When the map has none, it imports the package root. (Before, the
+ * generated import ignored the map, and failed: deep dive CORE-17.)
+ *
+ * @param name - Package name
+ * @param manifest - The package.json of the package
+ * @param proceduresPath - The `client.procedures` field
+ * @returns The module specifier for the generated import
+ */
+export declare function procedureImportPath(name: string, manifest: {
+    exports?: unknown;
+}, proceduresPath: string): string;
+/**
+ * Discover packages with procedure declarations: the dependencies of the root package and
+ * their dependencies, in `node_modules`.
+ *
+ * @param rootDir - The folder of the root package.json
+ * @param verbose - Log each package
+ * @returns The packages that declare procedures, sorted by name
+ */
+export declare function discoverPackages(rootDir: string, verbose: boolean): Promise<DiscoveredPackage[]>;
+/**
+ * Generate the TypeScript file content.
+ *
+ * @param packages - The discovered packages
+ * @returns The file content: one side-effect import for each package
+ */
+export declare function generateCode(packages: DiscoveredPackage[]): string;
+/**
+ * Run procedure discovery.
+ */
+export declare function discover(options: DiscoverOptions): Promise<void>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/procedures/cli/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/procedures/cli/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAyBjH;AAMD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqF9B;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAiClE;AAmDD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2FtE"}