@procedures/client 0.2.3 → 0.4.0

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

@@ -1,67 +0,0 @@
-/**
- * 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.
- */
-export interface AnnounceOptions {
-    /** Be verbose about what's happening */
-    verbose: boolean;
-    /** The folder to start from (default: the current folder) */
-    cwd?: string | undefined;
-    /**
-     * Add `client-registry announce` to the postinstall script of the package that depends on this one.
-     * This edits a package.json that belongs to the consumer, so it happens only when asked
-     * (`client-registry announce --propagate`). Default: false.
-     */
-    propagate?: boolean | undefined;
-}
-interface RegistryEntry {
-    /** Path to procedures file relative to package */
-    proceduresPath: string;
-    /** When this entry was added */
-    registeredAt: string;
-    /** Package version */
-    version?: string;
-}
-interface Registry {
-    /** Schema version for future compatibility */
-    schemaVersion: 1;
-    /** Map of package name to registry entry */
-    packages: Record<string, RegistryEntry>;
-}
-declare const REGISTRY_FILENAME = ".client-registry.json";
-/**
- * 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 declare function announce(options: AnnounceOptions): Promise<void>;
-/**
- * Remove this package from the registry (for uninstall).
- */
-export declare function unannounce(options: AnnounceOptions): Promise<void>;
-/**
- * Get the registry for use by discover command.
- */
-export declare function getRegistry(rootDir: string): Promise<Registry>;
-export { REGISTRY_FILENAME };
-export type { Registry, RegistryEntry };
-//# sourceMappingURL=announce.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"announce.d.ts","sourceRoot":"","sources":["../../../src/procedures/cli/announce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAED,UAAU,aAAa;IACrB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,QAAQ;IAChB,8CAA8C;IAC9C,aAAa,EAAE,CAAC,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAkFD,QAAA,MAAM,iBAAiB,0BAA0B,CAAC;AA0GlD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BtE;AAiKD;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEpE;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC"}

package/dist/procedures/cli/announce.js

@@ -1,392 +0,0 @@
-/**
- * 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

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

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

@@ -1,66 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}