@procedures/pnpm 0.0.0-stage → 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Type definitions for client-pnpm procedures
+ *
+ * client-pnpm wraps pnpm commands as procedures using client-shell.
+ */
+import { z } from "zod";
+export interface PnpmCommandOutput {
+    /** Exit code of the command */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** Whether command succeeded (exit code 0) */
+    success: boolean;
+    /** Duration in milliseconds */
+    duration: number;
+}
+export declare const PnpmInstallInputSchema: z.ZodObject<{
+    packages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dev: z.ZodOptional<z.ZodBoolean>;
+    frozen: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}>;
+export type PnpmInstallInput = z.infer<typeof PnpmInstallInputSchema>;
+export declare const PnpmAddInputSchema: z.ZodObject<{
+    packages: z.ZodArray<z.ZodString>;
+    dev: z.ZodOptional<z.ZodBoolean>;
+    global: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}>;
+export type PnpmAddInput = z.infer<typeof PnpmAddInputSchema>;
+export declare const PnpmRemoveInputSchema: z.ZodObject<{
+    packages: z.ZodArray<z.ZodString>;
+    global: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}>;
+export type PnpmRemoveInput = z.infer<typeof PnpmRemoveInputSchema>;
+export declare const PnpmLinkInputSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    global: z.ZodOptional<z.ZodBoolean>;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}>;
+export type PnpmLinkInput = z.infer<typeof PnpmLinkInputSchema>;
+export declare const PnpmRunInputSchema: z.ZodObject<{
+    script: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}>;
+export type PnpmRunInput = z.infer<typeof PnpmRunInputSchema>;
+export declare const PnpmStorePathInputSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+}>;
+export type PnpmStorePathInput = z.infer<typeof PnpmStorePathInputSchema>;
+export interface PnpmStorePathOutput {
+    /** Absolute path to the pnpm store */
+    path: string;
+    /** Whether store exists */
+    exists: boolean;
+    /** Platform (win32, darwin, linux) */
+    platform: string;
+}
+/** The result of a pnpm command: add, install, remove, link and run give it. */
+export declare const PnpmCommandOutputSchema: z.ZodType<PnpmCommandOutput>;
+export declare const PnpmStorePathOutputSchema: z.ZodType<PnpmStorePathOutput>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,98 @@
+/**
+ * Type definitions for client-pnpm procedures
+ *
+ * client-pnpm wraps pnpm commands as procedures using client-shell.
+ */
+import { z } from "zod";
+// =============================================================================
+// pnpm.install Types
+// =============================================================================
+export const PnpmInstallInputSchema = z.object({
+    /** Packages to install. If not provided, installs from package.json */
+    packages: z.array(z.string()).optional().describe("Packages to install. If not provided, installs from package.json"),
+    /** Save as dev dependency */
+    dev: z.boolean().optional().describe("Save as dev dependency"),
+    /** Use frozen lockfile (--frozen-lockfile) */
+    frozen: z.boolean().optional().describe("Use frozen lockfile (--frozen-lockfile)"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Timeout in milliseconds */
+    timeout: z.number().optional().describe("Timeout in milliseconds"),
+});
+// =============================================================================
+// pnpm.add Types
+// =============================================================================
+export const PnpmAddInputSchema = z.object({
+    /** Packages to add */
+    packages: z.array(z.string()).describe("Packages to add"),
+    /** Save as dev dependency */
+    dev: z.boolean().optional().describe("Save as dev dependency"),
+    /** Install globally */
+    global: z.boolean().optional().describe("Install globally"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Timeout in milliseconds */
+    timeout: z.number().optional().describe("Timeout in milliseconds"),
+});
+// =============================================================================
+// pnpm.remove Types
+// =============================================================================
+export const PnpmRemoveInputSchema = z.object({
+    /** Packages to remove */
+    packages: z.array(z.string()).describe("Packages to remove"),
+    /** Remove from global */
+    global: z.boolean().optional().describe("Remove from global"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Timeout in milliseconds */
+    timeout: z.number().optional().describe("Timeout in milliseconds"),
+});
+// =============================================================================
+// pnpm.link Types
+// =============================================================================
+export const PnpmLinkInputSchema = z.object({
+    /** Path to package to link. If not provided, links current directory globally */
+    path: z.string().optional().describe("Path to package to link. If not provided, links current directory globally"),
+    /** Link globally */
+    global: z.boolean().optional().describe("Link globally"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Timeout in milliseconds */
+    timeout: z.number().optional().describe("Timeout in milliseconds"),
+});
+// =============================================================================
+// pnpm.run Types
+// =============================================================================
+export const PnpmRunInputSchema = z.object({
+    /** Script name to run */
+    script: z.string().describe("Script name to run"),
+    /** Additional arguments to pass to the script */
+    args: z.array(z.string()).optional().describe("Additional arguments to pass to the script"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Timeout in milliseconds */
+    timeout: z.number().optional().describe("Timeout in milliseconds"),
+});
+// =============================================================================
+// pnpm.store.path Types - Get pnpm store path for snapshot/restore
+// =============================================================================
+export const PnpmStorePathInputSchema = z.object({
+    /** Working directory (affects store path on some configurations) */
+    cwd: z.string().optional().describe("Working directory (affects store path on some configurations)"),
+});
+// Output schemas (roadmap 2.1). Loose objects: a field that a schema does not name stays in the
+// result (a strict schema would remove it when the output is validated).
+/** The result of a pnpm command: add, install, remove, link and run give it. */
+export const PnpmCommandOutputSchema = z.looseObject({
+    exitCode: z.number().describe("The exit code of pnpm (0 is success)"),
+    stdout: z.string().describe("The standard output of pnpm"),
+    stderr: z.string().describe("The standard error of pnpm"),
+    success: z.boolean().describe("True when the exit code is 0"),
+    duration: z.number().describe("The time of the command, in milliseconds"),
+});
+export const PnpmStorePathOutputSchema = z.looseObject({
+    path: z.string().describe("The absolute path of the pnpm store"),
+    exists: z.boolean().describe("True when the store folder exists"),
+    platform: z.string().describe("The platform (win32, darwin, linux)"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,82 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/pnpm",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "pnpm commands as typed procedures: install, add, remove, run and link, run with argv and option-injection guards.",
+  "keywords": [
+    "pnpm",
+    "package-manager",
+    "monorepo",
+    "procedures"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client-pnpm"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    },
+    "./register.js": {
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@procedures/client": "0.2.0",
+    "@procedures/shell": "0.2.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }

package/src/index.ts

@@ -0,0 +1,57 @@
+/**
+ * @procedures/pnpm
+ *
+ * Wraps pnpm commands as procedures using client-shell.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from "@procedures/client";
+ *
+ * // Install dependencies
+ * await client.call(["pnpm", "install"], {});
+ *
+ * // Add a package
+ * await client.call(["pnpm", "add"], {
+ *   packages: ["lodash"],
+ *   dev: true,
+ * });
+ *
+ * // Link a package
+ * await client.call(["pnpm", "link"], {
+ *   path: "../other-package",
+ * });
+ * ```
+ */
+
+// Types
+export type {
+  PnpmInstallInput,
+  PnpmAddInput,
+  PnpmRemoveInput,
+  PnpmLinkInput,
+  PnpmRunInput,
+  PnpmCommandOutput,
+} from "./types.js";
+
+export {
+  PnpmInstallInputSchema,
+  PnpmAddInputSchema,
+  PnpmRemoveInputSchema,
+  PnpmLinkInputSchema,
+  PnpmRunInputSchema,
+} from "./types.js";
+
+// Procedures
+export {
+  pnpmInstall,
+  pnpmAdd,
+  pnpmRemove,
+  pnpmLink,
+  pnpmRun,
+} from "./procedures/pnpm/index.js";
+
+// How the procedures find pnpm (no shell): other packages that run pnpm use it too
+export { resolvePnpm } from "./procedures/pnpm/shared.js";
+
+// Registration
+export { registerPnpmProcedures } from "./module.js";

package/src/module.ts

@@ -0,0 +1,162 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for pnpm operations
+ *
+ * Provides pnpm.install, pnpm.add, pnpm.remove, pnpm.link, pnpm.run procedures.
+ */
+
+
+import { createProcedure, zodAdapter, defineModule, type ProcedureModule, PROCEDURE_REGISTRY, registerModules, type ProcedureRegistry } from "@procedures/client";
+import shellModule from "@procedures/shell/module";
+import { pnpmInstall, pnpmAdd, pnpmRemove, pnpmLink, pnpmRun, pnpmStorePath } from "./procedures/pnpm/index.js";
+import {
+  PnpmInstallInputSchema,
+  PnpmAddInputSchema,
+  PnpmRemoveInputSchema,
+  PnpmLinkInputSchema,
+  PnpmRunInputSchema,
+  type PnpmInstallInput,
+  type PnpmAddInput,
+  type PnpmRemoveInput,
+  type PnpmLinkInput,
+  type PnpmRunInput,
+  type PnpmCommandOutput,
+  PnpmStorePathInputSchema,
+  type PnpmStorePathInput,
+  type PnpmStorePathOutput,
+  PnpmCommandOutputSchema,
+  PnpmStorePathOutputSchema,
+} from "./types.js";
+import type { ProcedureContext } from "@procedures/client";
+
+// =============================================================================
+// Procedures
+// =============================================================================
+
+const pnpmInstallProcedure = createProcedure()
+  .path(["pnpm", "install"])
+  .input(zodAdapter<PnpmInstallInput>(PnpmInstallInputSchema))
+  .output(zodAdapter<PnpmCommandOutput>(PnpmCommandOutputSchema))
+  .meta({
+    description: "Install packages using pnpm",
+    // pnpm reads the npm registry, rewrites node_modules and the lockfile, and runs the
+    // lifecycle scripts and the pnpmfile of the project
+    effects: { reads: ["fs", "network"], writes: ["fs", "process"] },
+    shorts: { cwd: "C", dev: "D", frozen: "F" },
+    output: "json",
+  })
+  .handler(async (input: PnpmInstallInput, ctx: ProcedureContext): Promise<PnpmCommandOutput> => {
+    return pnpmInstall(input, ctx);
+  })
+  .build();
+
+const pnpmAddProcedure = createProcedure()
+  .path(["pnpm", "add"])
+  .input(zodAdapter<PnpmAddInput>(PnpmAddInputSchema))
+  .output(zodAdapter<PnpmCommandOutput>(PnpmCommandOutputSchema))
+  .meta({
+    description: "Add packages using pnpm",
+    effects: { reads: ["fs", "network"], writes: ["fs", "process"] },
+    args: ["packages"],
+    shorts: { cwd: "C", dev: "D", global: "g" },
+    output: "json",
+  })
+  .handler(async (input: PnpmAddInput, ctx: ProcedureContext): Promise<PnpmCommandOutput> => {
+    return pnpmAdd(input, ctx);
+  })
+  .build();
+
+const pnpmRemoveProcedure = createProcedure()
+  .path(["pnpm", "remove"])
+  .input(zodAdapter<PnpmRemoveInput>(PnpmRemoveInputSchema))
+  .output(zodAdapter<PnpmCommandOutput>(PnpmCommandOutputSchema))
+  .meta({
+    description: "Remove packages using pnpm",
+    // pnpm resolves the remaining dependencies again, so it can read the npm registry
+    effects: { reads: ["fs", "network"], writes: ["fs", "process"] },
+    args: ["packages"],
+    shorts: { cwd: "C", global: "g" },
+    output: "json",
+  })
+  .handler(async (input: PnpmRemoveInput, ctx: ProcedureContext): Promise<PnpmCommandOutput> => {
+    return pnpmRemove(input, ctx);
+  })
+  .build();
+
+const pnpmLinkProcedure = createProcedure()
+  .path(["pnpm", "link"])
+  .input(zodAdapter<PnpmLinkInput>(PnpmLinkInputSchema))
+  .output(zodAdapter<PnpmCommandOutput>(PnpmCommandOutputSchema))
+  .meta({
+    description: "Link packages using pnpm",
+    effects: { reads: ["fs", "network"], writes: ["fs", "process"] },
+    shorts: { cwd: "C", global: "g" },
+    output: "json",
+  })
+  .handler(async (input: PnpmLinkInput, ctx: ProcedureContext): Promise<PnpmCommandOutput> => {
+    return pnpmLink(input, ctx);
+  })
+  .build();
+
+const pnpmRunProcedure = createProcedure()
+  .path(["pnpm", "run"])
+  .input(zodAdapter<PnpmRunInput>(PnpmRunInputSchema))
+  .output(zodAdapter<PnpmCommandOutput>(PnpmCommandOutputSchema))
+  .meta({
+    description: "Run package scripts using pnpm",
+    // A package script is code of the project: it can do anything
+    effects: { reads: ["fs"], writes: ["process"] },
+    args: ["script"],
+    shorts: { cwd: "C" },
+    output: "json",
+  })
+  .handler(async (input: PnpmRunInput, ctx: ProcedureContext): Promise<PnpmCommandOutput> => {
+    return pnpmRun(input, ctx);
+  })
+  .build();
+
+const pnpmStorePathProcedure = createProcedure()
+  .path(["pnpm", "store", "path"])
+  .input(zodAdapter<PnpmStorePathInput>(PnpmStorePathInputSchema))
+  .output(zodAdapter<PnpmStorePathOutput>(PnpmStorePathOutputSchema))
+  .meta({
+    description: "Get pnpm store path for snapshot/restore",
+    // `pnpm store path` only reads the configuration of pnpm
+    effects: { reads: ["fs"], writes: [] },
+    args: [],
+    shorts: { cwd: "C" },
+    output: "json",
+  })
+  .handler(async (input: PnpmStorePathInput): Promise<PnpmStorePathOutput> => {
+    return pnpmStorePath(input);
+  })
+  .build();
+
+// =============================================================================
+// Registration
+// =============================================================================
+
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export const pnpmModule: ProcedureModule = defineModule("@procedures/pnpm", [
+    pnpmInstallProcedure,
+    pnpmAddProcedure,
+    pnpmRemoveProcedure,
+    pnpmLinkProcedure,
+    pnpmRunProcedure,
+    pnpmStorePathProcedure,
+  ], [shellModule]);
+
+export default pnpmModule;
+
+/**
+ * This function registers the procedures of @procedures/pnpm, and of the modules that it requires, in
+ * a registry. The default is the global registry. Importing this file registers nothing: the
+ * `./register` entry starts this function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export function registerPnpmProcedures(registry: ProcedureRegistry = PROCEDURE_REGISTRY): void {
+  registerModules(registry, [pnpmModule]);
+}

package/src/procedures/pnpm/add.ts

@@ -0,0 +1,40 @@
+/**
+ * pnpm.add procedure
+ *
+ * Add packages using pnpm.
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { pnpmArg, runPnpm } from "./shared.js";
+import type { PnpmAddInput, PnpmCommandOutput } from "../../types.js";
+
+/**
+ * Add packages using pnpm
+ *
+ * @example
+ * // Add a package
+ * await client.call(["pnpm", "add"], {
+ *   packages: ["lodash"],
+ * });
+ *
+ * @example
+ * // Add as dev dependency
+ * await client.call(["pnpm", "add"], {
+ *   packages: ["vitest", "@types/node"],
+ *   dev: true,
+ * });
+ */
+export async function pnpmAdd(
+  input: PnpmAddInput,
+  ctx: ProcedureContext
+): Promise<PnpmCommandOutput> {
+  {
+    const args: string[] = ["add", ...input.packages.map((p) => pnpmArg("package", p))];
+
+    // Add flags
+    if (input.dev) args.push("--save-dev");
+    if (input.global) args.push("--global");
+
+    return runPnpm(args, input, ctx);
+  }
+}

package/src/procedures/pnpm/index.ts

@@ -0,0 +1,10 @@
+/**
+ * pnpm Procedures
+ */
+
+export { pnpmInstall } from "./install.js";
+export { pnpmAdd } from "./add.js";
+export { pnpmRemove } from "./remove.js";
+export { pnpmLink } from "./link.js";
+export { pnpmRun } from "./run.js";
+export { pnpmStorePath } from "./store.js";

package/src/procedures/pnpm/install.ts

@@ -0,0 +1,43 @@
+/**
+ * pnpm.install procedure
+ *
+ * Install packages using pnpm.
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { pnpmArg, runPnpm } from "./shared.js";
+import type { PnpmInstallInput, PnpmCommandOutput } from "../../types.js";
+
+/**
+ * Install packages using pnpm
+ *
+ * @example
+ * // Install all dependencies from package.json
+ * await client.call(["pnpm", "install"], {});
+ *
+ * @example
+ * // Install specific packages as dev dependencies
+ * await client.call(["pnpm", "install"], {
+ *   packages: ["vitest", "@types/node"],
+ *   dev: true,
+ * });
+ */
+export async function pnpmInstall(
+  input: PnpmInstallInput,
+  ctx: ProcedureContext
+): Promise<PnpmCommandOutput> {
+  {
+    const args: string[] = ["install"];
+
+    // Add packages if specified
+    if (input.packages && input.packages.length > 0) {
+      args.push(...input.packages.map((p) => pnpmArg("package", p)));
+    }
+
+    // Add flags
+    if (input.dev) args.push("--save-dev");
+    if (input.frozen) args.push("--frozen-lockfile");
+
+    return runPnpm(args, input, ctx);
+  }
+}

package/src/procedures/pnpm/link.ts

@@ -0,0 +1,43 @@
+/**
+ * pnpm.link procedure
+ *
+ * Link packages using pnpm.
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { pnpmArg, runPnpm } from "./shared.js";
+import type { PnpmLinkInput, PnpmCommandOutput } from "../../types.js";
+
+/**
+ * Link packages using pnpm
+ *
+ * @example
+ * // Link current directory globally
+ * await client.call(["pnpm", "link"], {
+ *   global: true,
+ * });
+ *
+ * @example
+ * // Link a specific path
+ * await client.call(["pnpm", "link"], {
+ *   path: "../other-package",
+ * });
+ */
+export async function pnpmLink(
+  input: PnpmLinkInput,
+  ctx: ProcedureContext
+): Promise<PnpmCommandOutput> {
+  {
+    const args: string[] = ["link"];
+
+    // Add path if specified
+    if (input.path !== undefined) {
+      args.push(pnpmArg("path", input.path));
+    }
+
+    // Add flags
+    if (input.global) args.push("--global");
+
+    return runPnpm(args, input, ctx);
+  }
+}

package/src/procedures/pnpm/remove.ts

@@ -0,0 +1,32 @@
+/**
+ * pnpm.remove procedure
+ *
+ * Remove packages using pnpm.
+ */
+
+import type { ProcedureContext } from "@procedures/client";
+import { pnpmArg, runPnpm } from "./shared.js";
+import type { PnpmRemoveInput, PnpmCommandOutput } from "../../types.js";
+
+/**
+ * Remove packages using pnpm
+ *
+ * @example
+ * // Remove packages
+ * await client.call(["pnpm", "remove"], {
+ *   packages: ["lodash"],
+ * });
+ */
+export async function pnpmRemove(
+  input: PnpmRemoveInput,
+  ctx: ProcedureContext
+): Promise<PnpmCommandOutput> {
+  {
+    const args: string[] = ["remove", ...input.packages.map((p) => pnpmArg("package", p))];
+
+    // Add flags
+    if (input.global) args.push("--global");
+
+    return runPnpm(args, input, ctx);
+  }
+}