@procedures/client 0.0.0-stage → 0.1.0

package/dist/procedures/cli/init.js

@@ -0,0 +1,336 @@
+/**
+ * Library Initialization
+ *
+ * Scaffolds a new library with procedure support.
+ * Creates the necessary file structure and configuration.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+// =============================================================================
+// Templates
+// =============================================================================
+function getPackageJsonTemplate(name) {
+    return `{
+  "name": "${name}",
+  "version": "1.0.0",
+  "description": "Library with client procedures",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist",
+    "watch": "tsc -b --watch",
+    "prepare": "npm run build",
+    "postinstall": "client-registry announce || true"
+  },
+  "peerDependencies": {
+    "client": "^1.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "client": "^1.0.0",
+    "typescript": "^5.7.0",
+    "zod": "^3.0.0"
+  }
+}
+`;
+}
+function getTsconfigTemplate() {
+    return `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "exactOptionalPropertyTypes": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+`;
+}
+function getIndexTemplate(name) {
+    const moduleName = name.replace(/[^a-zA-Z0-9]/g, "_").replace(/^_+|_+$/g, "");
+    return `/**
+ * ${name}
+ *
+ * Export your procedures and types from this file.
+ */
+
+// Export procedures
+export { ${moduleName}Procedures } from "./procedures/index.js";
+
+// Export individual procedures for direct use
+export { exampleProcedure } from "./procedures/index.js";
+
+// Export types if needed
+export type { ExampleInput, ExampleOutput } from "./procedures/index.js";
+`;
+}
+function getRegisterTemplate(name) {
+    const moduleName = name.replace(/[^a-zA-Z0-9]/g, "_").replace(/^_+|_+$/g, "");
+    return `/**
+ * Procedure Registration
+ *
+ * This file is imported as a side-effect to register procedures.
+ * The path to this file is declared in package.json under "client.procedures".
+ *
+ * When another app runs \`npx client-registry discover\`, this file will be
+ * automatically imported, causing procedures to be registered.
+ */
+
+import { createAndRegister } from "client/procedures";
+import { ${moduleName}Procedures } from "./procedures/index.js";
+
+/**
+ * Register all procedures from this library.
+ * This runs immediately when this file is imported.
+ */
+export const ${moduleName}Module = createAndRegister("${name}", ${moduleName}Procedures);
+`;
+}
+function getProceduresTemplate(name) {
+    const moduleName = name.replace(/[^a-zA-Z0-9]/g, "_").replace(/^_+|_+$/g, "");
+    return `/**
+ * Procedure Definitions
+ *
+ * Define your procedures here using defineProcedure().
+ */
+
+import { z } from "zod";
+import { defineProcedure } from "client/procedures";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export const ExampleInputSchema = z.object({
+  id: z.string(),
+});
+
+export const ExampleOutputSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  createdAt: z.string(),
+});
+
+export type ExampleInput = z.infer<typeof ExampleInputSchema>;
+export type ExampleOutput = z.infer<typeof ExampleOutputSchema>;
+
+// =============================================================================
+// Procedures
+// =============================================================================
+
+/**
+ * Example procedure - replace with your actual procedures.
+ */
+export const exampleProcedure = defineProcedure({
+  path: ["${name}", "example", "get"],
+  input: ExampleInputSchema,
+  output: ExampleOutputSchema,
+  metadata: {
+    description: "Get an example by ID",
+  },
+  handler: async (input, ctx) => {
+    // Implement your procedure logic here
+    // Access storage via ctx.repository?.getStorage() if needed
+
+    return {
+      id: input.id,
+      name: "Example",
+      createdAt: new Date().toISOString(),
+    };
+  },
+});
+
+/**
+ * Export all procedures as an array for registration.
+ */
+export const ${moduleName}Procedures = [
+  exampleProcedure,
+  // Add more procedures here
+];
+`;
+}
+function getGitignoreTemplate() {
+    return `# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Generated
+__generated__/
+`;
+}
+function getReadmeTemplate(name) {
+    return `# ${name}
+
+A library with client procedures.
+
+## Installation
+
+\`\`\`bash
+npm install ${name}
+\`\`\`
+
+## How It Works
+
+This library automatically registers its procedures when installed:
+
+1. The \`postinstall\` script runs \`client-registry announce\`
+2. This writes to \`.client-registry.json\` at your project root
+3. When you run \`client-registry discover\`, it reads from this registry
+
+This means **zero configuration** for consumers - just install and discover!
+
+## Usage
+
+### In Your App (Consumer)
+
+After installing this library, run discovery to generate imports:
+
+\`\`\`bash
+npx client-registry discover
+\`\`\`
+
+Then import the generated file in your entry point:
+
+\`\`\`typescript
+import "./__generated__/procedures";
+\`\`\`
+
+### Manual Registration (Alternative)
+
+\`\`\`typescript
+import "${name}/register";
+\`\`\`
+
+### Direct Procedure Import
+
+\`\`\`typescript
+import { exampleProcedure } from "${name}";
+\`\`\`
+
+## Development
+
+\`\`\`bash
+# Build
+npm run build
+
+# Watch mode
+npm run watch
+\`\`\`
+
+## License
+
+MIT
+`;
+}
+// =============================================================================
+// File Writing
+// =============================================================================
+async function writeFile(filePath, content, force) {
+    try {
+        // Check if file exists
+        await fs.access(filePath);
+        if (!force) {
+            console.log(`  Skipping (exists): ${path.basename(filePath)}`);
+            return false;
+        }
+        console.log(`  Overwriting: ${path.basename(filePath)}`);
+    }
+    catch {
+        console.log(`  Creating: ${path.basename(filePath)}`);
+    }
+    await fs.writeFile(filePath, content, "utf-8");
+    return true;
+}
+// =============================================================================
+// Main
+// =============================================================================
+/**
+ * Initialize a new library with procedure support.
+ */
+export async function init(options) {
+    const { name, force } = options;
+    // Determine target directory
+    const isCurrentDir = name === ".";
+    const targetDir = isCurrentDir ? process.cwd() : path.join(process.cwd(), name);
+    const packageName = isCurrentDir ? path.basename(process.cwd()) : name;
+    console.log(`\nInitializing ${packageName}...`);
+    // Create directory structure
+    const dirs = [
+        targetDir,
+        path.join(targetDir, "src"),
+        path.join(targetDir, "src", "procedures"),
+    ];
+    for (const dir of dirs) {
+        await fs.mkdir(dir, { recursive: true });
+    }
+    // Write files
+    const files = [
+        [path.join(targetDir, "package.json"), getPackageJsonTemplate(packageName)],
+        [path.join(targetDir, "tsconfig.json"), getTsconfigTemplate()],
+        [path.join(targetDir, "src", "index.ts"), getIndexTemplate(packageName)],
+        [path.join(targetDir, "src", "register.ts"), getRegisterTemplate(packageName)],
+        [path.join(targetDir, "src", "procedures", "index.ts"), getProceduresTemplate(packageName)],
+        [path.join(targetDir, ".gitignore"), getGitignoreTemplate()],
+        [path.join(targetDir, "README.md"), getReadmeTemplate(packageName)],
+    ];
+    for (const [filePath, content] of files) {
+        await writeFile(filePath, content, force);
+    }
+    console.log(`
+Done! Next steps:
+
+  ${isCurrentDir ? "" : `cd ${name}`}
+  npm install
+  npm run build
+
+Your library is ready to define procedures in src/procedures/index.ts
+
+When consumers install your library and run \`npx client-registry discover\`,
+your procedures will be automatically discovered and registered.
+`);
+}
+//# sourceMappingURL=init.js.map

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

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

package/dist/procedures/collection/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Collection Procedures
+ *
+ * Procedure definitions for collection CRUD operations.
+ */
+export { idSchema, collectionNameSchema, valueSchema, getInputSchema, getOutputSchema, setInputSchema, setOutputSchema, deleteInputSchema, deleteOutputSchema, hasInputSchema, hasOutputSchema, getAllInputSchema, getAllOutputSchema, sizeInputSchema, sizeOutputSchema, clearInputSchema, clearOutputSchema, getBatchInputSchema, getBatchOutputSchema, setBatchInputSchema, setBatchOutputSchema, deleteBatchInputSchema, deleteBatchOutputSchema, } from "./schemas.js";
+export type { GetInput, SetInput, DeleteInput, HasInput, GetAllInput, SizeInput, ClearInput, GetBatchInput, SetBatchInput, DeleteBatchInput, } from "./schemas.js";
+export { createCollectionProcedures } from "./procedures.js";
+export type { CollectionStorage, StorageMetadata } from "./storage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/procedures/collection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/collection/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG7D,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/procedures/collection/index.js

@@ -0,0 +1,10 @@
+/**
+ * Collection Procedures
+ *
+ * Procedure definitions for collection CRUD operations.
+ */
+// Schemas
+export { idSchema, collectionNameSchema, valueSchema, getInputSchema, getOutputSchema, setInputSchema, setOutputSchema, deleteInputSchema, deleteOutputSchema, hasInputSchema, hasOutputSchema, getAllInputSchema, getAllOutputSchema, sizeInputSchema, sizeOutputSchema, clearInputSchema, clearOutputSchema, getBatchInputSchema, getBatchOutputSchema, setBatchInputSchema, setBatchOutputSchema, deleteBatchInputSchema, deleteBatchOutputSchema, } from "./schemas.js";
+// Procedures
+export { createCollectionProcedures } from "./procedures.js";
+//# sourceMappingURL=index.js.map

package/dist/procedures/collection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/collection/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU;AACV,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAetB,aAAa;AACb,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/procedures/collection/procedures.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Collection Procedures
+ *
+ * Procedure definitions for collection CRUD operations.
+ * These procedures delegate to storage backends via the repository pattern.
+ */
+import type { AnyProcedure } from "../types.js";
+/**
+ * Create collection procedures for a specific collection name.
+ *
+ * @param collectionName - Name of the collection
+ * @returns Array of procedure definitions
+ *
+ * @example
+ * ```typescript
+ * const userProcedures = createCollectionProcedures('users');
+ * registry.registerAll(userProcedures);
+ * ```
+ */
+export declare function createCollectionProcedures(collectionName: string): AnyProcedure[];
+//# sourceMappingURL=procedures.d.ts.map

package/dist/procedures/collection/procedures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../../src/procedures/collection/procedures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,aAAa,CAAC;AAgElE;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,EAAE,CAgKjF"}

package/dist/procedures/collection/procedures.js

@@ -0,0 +1,198 @@
+/**
+ * Collection Procedures
+ *
+ * Procedure definitions for collection CRUD operations.
+ * These procedures delegate to storage backends via the repository pattern.
+ */
+import { defineProcedure } from "../define.js";
+import { getInputSchema, getOutputSchema, setInputSchema, setOutputSchema, deleteInputSchema, deleteOutputSchema, hasInputSchema, hasOutputSchema, getAllInputSchema, getAllOutputSchema, sizeInputSchema, sizeOutputSchema, clearInputSchema, clearOutputSchema, getBatchInputSchema, getBatchOutputSchema, setBatchInputSchema, setBatchOutputSchema, deleteBatchInputSchema, deleteBatchOutputSchema, } from "./schemas.js";
+// =============================================================================
+// Handler Factory
+// =============================================================================
+/**
+ * Extract collection name from procedure path.
+ * Path format: ['collections', collectionName, operation]
+ */
+function getCollectionFromPath(path) {
+    if (path.length < 3 || path[0] !== "collections") {
+        throw new Error(`Invalid collection procedure path: ${path.join(".")}`);
+    }
+    return path[1];
+}
+/**
+ * Get storage from context, throwing if repository is not available.
+ */
+function getStorage(ctx) {
+    if (!ctx.repository) {
+        throw new Error("Repository not available in procedure context");
+    }
+    const collection = getCollectionFromPath(ctx.path);
+    return ctx.repository.getStorage(collection);
+}
+// =============================================================================
+// Collection Procedure Definitions
+// =============================================================================
+/**
+ * Create collection procedures for a specific collection name.
+ *
+ * @param collectionName - Name of the collection
+ * @returns Array of procedure definitions
+ *
+ * @example
+ * ```typescript
+ * const userProcedures = createCollectionProcedures('users');
+ * registry.registerAll(userProcedures);
+ * ```
+ */
+export function createCollectionProcedures(collectionName) {
+    const basePath = ["collections", collectionName];
+    return [
+        // Get
+        defineProcedure({
+            path: [...basePath, "get"],
+            input: getInputSchema,
+            output: getOutputSchema,
+            metadata: {
+                description: `Get item from ${collectionName} by ID`,
+                tags: ["collections", collectionName, "read"],
+            },
+            handler: async (input, ctx) => {
+                const storage = getStorage(ctx);
+                return storage.get(input.id);
+            },
+        }),
+        // Set
+        defineProcedure({
+            path: [...basePath, "set"],
+            input: setInputSchema,
+            output: setOutputSchema,
+            metadata: {
+                description: `Set item in ${collectionName}`,
+                tags: ["collections", collectionName, "write"],
+            },
+            handler: async (input, ctx) => {
+                const storage = getStorage(ctx);
+                await storage.set(input.id, input.value);
+            },
+        }),
+        // Delete
+        defineProcedure({
+            path: [...basePath, "delete"],
+            input: deleteInputSchema,
+            output: deleteOutputSchema,
+            metadata: {
+                description: `Delete item from ${collectionName}`,
+                tags: ["collections", collectionName, "write"],
+            },
+            handler: async (input, ctx) => {
+                const storage = getStorage(ctx);
+                return storage.delete(input.id);
+            },
+        }),
+        // Has
+        defineProcedure({
+            path: [...basePath, "has"],
+            input: hasInputSchema,
+            output: hasOutputSchema,
+            metadata: {
+                description: `Check if item exists in ${collectionName}`,
+                tags: ["collections", collectionName, "read"],
+            },
+            handler: async (input, ctx) => {
+                const storage = getStorage(ctx);
+                return storage.has(input.id);
+            },
+        }),
+        // GetAll
+        defineProcedure({
+            path: [...basePath, "getAll"],
+            input: getAllInputSchema,
+            output: getAllOutputSchema,
+            metadata: {
+                description: `Get all items from ${collectionName}`,
+                tags: ["collections", collectionName, "read"],
+            },
+            handler: async (_input, ctx) => {
+                const storage = getStorage(ctx);
+                return storage.getAll();
+            },
+        }),
+        // Size
+        defineProcedure({
+            path: [...basePath, "size"],
+            input: sizeInputSchema,
+            output: sizeOutputSchema,
+            metadata: {
+                description: `Get number of items in ${collectionName}`,
+                tags: ["collections", collectionName, "read"],
+            },
+            handler: async (_input, ctx) => {
+                const storage = getStorage(ctx);
+                return storage.size();
+            },
+        }),
+        // Clear
+        defineProcedure({
+            path: [...basePath, "clear"],
+            input: clearInputSchema,
+            output: clearOutputSchema,
+            metadata: {
+                description: `Clear all items from ${collectionName}`,
+                tags: ["collections", collectionName, "write"],
+            },
+            handler: async (_input, ctx) => {
+                const storage = getStorage(ctx);
+                await storage.clear();
+            },
+        }),
+        // GetBatch
+        defineProcedure({
+            path: [...basePath, "getBatch"],
+            input: getBatchInputSchema,
+            output: getBatchOutputSchema,
+            metadata: {
+                description: `Get multiple items from ${collectionName}`,
+                tags: ["collections", collectionName, "read", "batch"],
+            },
+            handler: async (input, ctx) => {
+                const storage = getStorage(ctx);
+                const result = await storage.getBatch(input.ids);
+                // Convert Map to plain object
+                return Object.fromEntries(result);
+            },
+        }),
+        // SetBatch
+        defineProcedure({
+            path: [...basePath, "setBatch"],
+            input: setBatchInputSchema,
+            output: setBatchOutputSchema,
+            metadata: {
+                description: `Set multiple items in ${collectionName}`,
+                tags: ["collections", collectionName, "write", "batch"],
+            },
+            handler: async (input, ctx) => {
+                const storage = getStorage(ctx);
+                const items = input.items.map((item) => [
+                    item.id,
+                    item.value,
+                ]);
+                await storage.setBatch(items);
+            },
+        }),
+        // DeleteBatch
+        defineProcedure({
+            path: [...basePath, "deleteBatch"],
+            input: deleteBatchInputSchema,
+            output: deleteBatchOutputSchema,
+            metadata: {
+                description: `Delete multiple items from ${collectionName}`,
+                tags: ["collections", collectionName, "write", "batch"],
+            },
+            handler: async (input, ctx) => {
+                const storage = getStorage(ctx);
+                return storage.deleteBatch(input.ids);
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=procedures.js.map

package/dist/procedures/collection/procedures.js.map

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