@noosphere/registry 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,304 @@
+# @noosphere/registry
+
+Container and Verifier registry manager for Noosphere SDK.
+
+## Features
+
+- **Local Registry**: JSON-based local registry (`.noosphere/registry.json`)
+- **Remote Sync**: Automatically sync from GitHub public registry
+- **Container Discovery**: Find and search compute containers
+- **Verifier Discovery**: Find proof verifiers by contract address
+- **Custom Entries**: Add your own containers and verifiers
+- **Cache Management**: Configurable TTL for remote sync
+
+## Installation
+
+```bash
+npm install @noosphere/registry
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { RegistryManager } from '@noosphere/registry';
+
+// Create registry manager
+const registry = new RegistryManager({
+  localPath: './.noosphere/registry.json',  // Optional
+  remotePath: 'https://raw.githubusercontent.com/hpp-io/noosphere-registry/main/registry.json',  // Optional
+  autoSync: true,      // Sync from remote on load
+  cacheTTL: 3600000,   // 1 hour cache
+});
+
+// Load registry
+await registry.load();
+
+// Get container by ID
+const container = registry.getContainer('0x123...');
+console.log(container.name);        // "stable-diffusion-xl"
+console.log(container.imageName);   // "runpod/stable-diffusion"
+console.log(container.requirements); // { gpu: true, memory: "16GB" }
+
+// Search containers
+const aiContainers = registry.searchContainers('ai');
+
+// List all active containers
+const containers = registry.listContainers();
+
+// Get verifier by contract address
+const verifier = registry.getVerifier('0x0165878A594ca255338adfa4d48449f69242Eb8F');
+console.log(verifier.name);  // "Immediate Finalize Verifier"
+
+// Check if proof generation is required
+if (verifier.requiresProof && verifier.proofService) {
+  console.log('Proof service:', verifier.proofService.imageName);
+  console.log('Proof service port:', verifier.proofService.port);
+}
+```
+
+### Adding Custom Containers
+
+```typescript
+await registry.addContainer({
+  id: '0xabc...',
+  name: 'my-custom-model',
+  imageName: 'myrepo/my-model',
+  port: 8000,
+  requirements: {
+    gpu: true,
+    memory: '8GB',
+    cpu: 4,
+  },
+  statusCode: 'ACTIVE',
+  description: 'My custom AI model',
+  tags: ['ai', 'custom'],
+});
+```
+
+### Adding Custom Verifiers
+
+```typescript
+// Verifier with integrated proof generation service
+await registry.addVerifier({
+  id: 'custom-verifier-id',
+  name: 'My Custom Verifier',
+  verifierAddress: '0x222...',  // Onchain verifier contract address
+  requiresProof: true,
+  proofService: {
+    imageName: 'myrepo/my-proof-service',
+    port: 3000,
+    command: 'npm start',
+    env: {
+      RPC_URL: 'https://...',
+      VERIFIER_ADDRESS: '0x222...',
+    },
+    requirements: {
+      memory: '2GB',
+      cpu: 2,
+    },
+  },
+  statusCode: 'ACTIVE',
+  description: 'Custom proof verification with integrated proof generation',
+});
+
+// Simple verifier without proof generation
+await registry.addVerifier({
+  id: 'simple-verifier-id',
+  name: 'Simple Verifier',
+  verifierAddress: '0x333...',
+  requiresProof: false,
+  statusCode: 'ACTIVE',
+  description: 'Simple verification without proof generation',
+});
+```
+
+### Registry Statistics
+
+```typescript
+const stats = registry.getStats();
+console.log(stats);
+// {
+//   totalContainers: 10,
+//   activeContainers: 8,
+//   totalVerifiers: 2,
+//   activeVerifiers: 2,
+//   lastSync: '2024-12-26T00:00:00.000Z'
+// }
+```
+
+## Registry Format
+
+### Container Metadata
+
+```typescript
+interface ContainerMetadata {
+  id: string;              // Unique ID (keccak256 hash)
+  name: string;            // Human-readable name
+  imageName: string;       // Docker image name
+  port?: number;           // Exposed port
+  command?: string;        // Docker command
+  env?: Record<string, string>;  // Environment variables
+  volumes?: string[];      // Volume mounts
+  requirements?: {
+    gpu?: boolean;
+    memory?: string;       // "16GB"
+    cpu?: number;
+  };
+  payments?: {
+    basePrice: string;     // "0.01"
+    token: string;         // "ETH"
+    per: string;           // "inference"
+  };
+  statusCode: 'ACTIVE' | 'INACTIVE' | 'DEPRECATED';
+  verified?: boolean;      // Community verified
+  description?: string;
+  tags?: string[];
+  createdAt?: string;
+  updatedAt?: string;
+}
+```
+
+### Verifier Metadata
+
+```typescript
+interface ProofServiceConfig {
+  imageName: string;       // Docker image for proof generation service
+  port: number;            // Exposed port
+  command?: string;        // Docker command
+  env?: Record<string, string>;      // Environment variables
+  volumes?: string[];      // Volume mounts
+  requirements?: {
+    memory?: string;       // "2GB"
+    cpu?: number;
+    gpu?: boolean;
+  };
+}
+
+interface VerifierMetadata {
+  id: string;              // UUID
+  name: string;
+  verifierAddress: string; // Onchain contract address (used as key)
+  requiresProof?: boolean; // Whether this verifier requires proof generation
+  proofService?: ProofServiceConfig; // Proof generation service configuration
+
+  // Deprecated: Use proofService instead
+  imageName?: string;      // Docker image for proof generation
+  port?: number;
+  command?: string;
+  env?: Record<string, string>;
+  volumes?: string[];
+
+  payments?: {
+    basePrice: string;
+    token: string;
+    per: string;
+  };
+  statusCode: 'ACTIVE' | 'INACTIVE' | 'DEPRECATED';
+  verified?: boolean;
+  description?: string;
+  createdAt?: string;
+  updatedAt?: string;
+}
+```
+
+## Working with Proof Generation
+
+When a verifier requires proof generation, you'll need to start the proof service container and interact with it:
+
+```typescript
+import { RegistryManager } from '@noosphere/registry';
+
+// Load registry
+const registry = new RegistryManager();
+await registry.load();
+
+// Get verifier for a subscription
+const verifier = registry.getVerifier('0x0165878A594ca255338adfa4d48449f69242Eb8F');
+
+// Check if proof generation is required
+if (verifier.requiresProof && verifier.proofService) {
+  // Start proof service container
+  const proofContainer = await containerManager.start({
+    imageName: verifier.proofService.imageName,
+    port: verifier.proofService.port,
+    command: verifier.proofService.command,
+    env: {
+      ...verifier.proofService.env,
+      RPC_URL: process.env.RPC_URL,
+      CHAIN_ID: process.env.CHAIN_ID,
+      VERIFIER_ADDRESS: verifier.verifierAddress,
+    },
+  });
+
+  // Generate proof
+  const proof = await fetch(`http://localhost:${verifier.proofService.port}/generate-proof`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      requestId,
+      subscriptionId,
+      interval: commitment.interval,
+      output: computeResult,
+    }),
+  }).then(r => r.json());
+
+  console.log('Proof generated:', proof);
+  // Proof service typically handles on-chain submission automatically
+}
+```
+
+See the [community registry integration guide](https://github.com/hpp-io/noosphere-registry/blob/main/VERIFIER_INTEGRATION.md) for complete examples.
+
+## Local Registry Path
+
+Default: `.noosphere/registry.json`
+
+The registry file is automatically created with example entries if it doesn't exist.
+
+## Remote Registry
+
+Default: `https://raw.githubusercontent.com/hpp-io/noosphere-registry/main/registry.json`
+
+The remote registry is a community-maintained list of verified containers and verifiers.
+
+### Merge Strategy
+
+- Remote entries are added to local registry
+- **Local entries take precedence** (not overwritten by remote)
+- Manual additions are saved locally only
+
+## Registry Priority
+
+1. **Local registry** (highest priority)
+2. **Remote registry** (synced from GitHub)
+
+This allows you to:
+- Use community-verified containers
+- Override remote entries locally
+- Add private/custom containers
+
+## Example Registry
+
+See `examples/registry-example.json` for a complete example with:
+- Echo service (for testing)
+- Stable Diffusion XL (image generation)
+- Llama 3 8B (text generation)
+- Whisper Large V3 (speech-to-text)
+- ZK-SNARK verifiers
+
+## Contributing
+
+To contribute containers/verifiers to the public registry:
+
+1. Fork `hpp-io/noosphere-registry`
+2. Add your entry to `registry.json`
+3. Submit a pull request with:
+   - Container/Verifier metadata
+   - Verification that it works
+   - Documentation
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,235 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  RegistryManager: () => RegistryManager
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/RegistryManager.ts
+var import_promises = __toESM(require("fs/promises"));
+var import_path = __toESM(require("path"));
+var import_node_fetch = __toESM(require("node-fetch"));
+var RegistryManager = class {
+  constructor(config = {}) {
+    this.containers = /* @__PURE__ */ new Map();
+    this.verifiers = /* @__PURE__ */ new Map();
+    this.lastSync = 0;
+    this.config = {
+      localPath: config.localPath || import_path.default.join(process.cwd(), ".noosphere", "registry.json"),
+      remotePath: config.remotePath || "https://raw.githubusercontent.com/hpp-io/noosphere-registry/main/registry.json",
+      autoSync: config.autoSync ?? true,
+      cacheTTL: config.cacheTTL || 36e5
+      // 1 hour default
+    };
+  }
+  /**
+   * Load registry from local and optionally sync from remote
+   */
+  async load() {
+    await this.loadLocal();
+    if (this.config.autoSync) {
+      try {
+        await this.sync();
+      } catch (error) {
+        console.warn("Failed to sync remote registry:", error);
+        console.log("Continuing with local registry only");
+      }
+    }
+    console.log(`\u2713 Loaded ${this.containers.size} containers and ${this.verifiers.size} verifiers`);
+  }
+  /**
+   * Load local registry file
+   */
+  async loadLocal() {
+    try {
+      const data = await import_promises.default.readFile(this.config.localPath, "utf-8");
+      const registry = JSON.parse(data);
+      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {
+        this.containers.set(id, metadata);
+      });
+      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {
+        this.verifiers.set(id, metadata);
+      });
+      console.log(`\u2713 Loaded local registry from ${this.config.localPath}`);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        console.log("No local registry found, will create default");
+        await this.createDefaultRegistry();
+      } else {
+        throw error;
+      }
+    }
+  }
+  /**
+   * Sync registry from remote GitHub repository
+   */
+  async sync() {
+    const now = Date.now();
+    if (now - this.lastSync < this.config.cacheTTL) {
+      console.log("Registry cache is fresh, skipping sync");
+      return;
+    }
+    console.log(`Syncing registry from ${this.config.remotePath}...`);
+    try {
+      const response = await (0, import_node_fetch.default)(this.config.remotePath);
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+      const registry = await response.json();
+      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {
+        if (!this.containers.has(id)) {
+          this.containers.set(id, metadata);
+        }
+      });
+      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {
+        if (!this.verifiers.has(id)) {
+          this.verifiers.set(id, metadata);
+        }
+      });
+      this.lastSync = now;
+      console.log(`\u2713 Synced registry (version: ${registry.version})`);
+    } catch (error) {
+      console.error("Failed to sync remote registry:", error);
+      throw error;
+    }
+  }
+  /**
+   * Get container by ID
+   */
+  getContainer(id) {
+    return this.containers.get(id);
+  }
+  /**
+   * Get all containers
+   */
+  listContainers() {
+    return Array.from(this.containers.values()).filter((c) => c.statusCode === "ACTIVE");
+  }
+  /**
+   * Search containers by name or tag
+   */
+  searchContainers(query) {
+    const lowerQuery = query.toLowerCase();
+    return this.listContainers().filter(
+      (c) => c.name.toLowerCase().includes(lowerQuery) || c.description?.toLowerCase().includes(lowerQuery) || c.tags?.some((tag) => tag.toLowerCase().includes(lowerQuery))
+    );
+  }
+  /**
+   * Get verifier by contract address
+   */
+  getVerifier(verifierAddress) {
+    return this.verifiers.get(verifierAddress);
+  }
+  /**
+   * Get verifier by ID
+   */
+  getVerifierById(id) {
+    return Array.from(this.verifiers.values()).find((v) => v.id === id);
+  }
+  /**
+   * Get all verifiers
+   */
+  listVerifiers() {
+    return Array.from(this.verifiers.values()).filter((v) => v.statusCode === "ACTIVE");
+  }
+  /**
+   * Add custom container to local registry
+   */
+  async addContainer(container) {
+    this.containers.set(container.id, container);
+    await this.saveLocal();
+    console.log(`\u2713 Added container: ${container.name} (${container.id})`);
+  }
+  /**
+   * Add custom verifier to local registry
+   */
+  async addVerifier(verifier) {
+    this.verifiers.set(verifier.verifierAddress, verifier);
+    await this.saveLocal();
+    console.log(`\u2713 Added verifier: ${verifier.name} (${verifier.verifierAddress})`);
+  }
+  /**
+   * Remove container from local registry
+   */
+  async removeContainer(id) {
+    if (this.containers.delete(id)) {
+      await this.saveLocal();
+      console.log(`\u2713 Removed container: ${id}`);
+    }
+  }
+  /**
+   * Remove verifier from local registry
+   */
+  async removeVerifier(verifierAddress) {
+    if (this.verifiers.delete(verifierAddress)) {
+      await this.saveLocal();
+      console.log(`\u2713 Removed verifier: ${verifierAddress}`);
+    }
+  }
+  /**
+   * Save local registry to disk
+   */
+  async saveLocal() {
+    const registry = {
+      containers: Object.fromEntries(this.containers),
+      verifiers: Object.fromEntries(this.verifiers),
+      version: "1.0.0",
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await import_promises.default.mkdir(import_path.default.dirname(this.config.localPath), { recursive: true });
+    await import_promises.default.writeFile(this.config.localPath, JSON.stringify(registry, null, 2));
+  }
+  /**
+   * Create default registry with example entries
+   */
+  async createDefaultRegistry() {
+    await this.saveLocal();
+    console.log("\u2713 Created empty local registry (will sync from remote)");
+  }
+  /**
+   * Get registry statistics
+   */
+  getStats() {
+    return {
+      totalContainers: this.containers.size,
+      activeContainers: this.listContainers().length,
+      totalVerifiers: this.verifiers.size,
+      activeVerifiers: this.listVerifiers().length,
+      lastSync: this.lastSync ? new Date(this.lastSync).toISOString() : "Never"
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RegistryManager
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/RegistryManager.ts"],"sourcesContent":["export { RegistryManager } from './RegistryManager';\nexport * from './types';\n","import fs from 'fs/promises';\nimport path from 'path';\nimport fetch from 'node-fetch';\nimport type { ContainerMetadata, VerifierMetadata, RegistryConfig, RegistryIndex } from './types';\n\nexport class RegistryManager {\n  private containers = new Map<string, ContainerMetadata>();\n  private verifiers = new Map<string, VerifierMetadata>();\n  private config: Required<RegistryConfig>;\n  private lastSync: number = 0;\n\n  constructor(config: RegistryConfig = {}) {\n    this.config = {\n      localPath: config.localPath || path.join(process.cwd(), '.noosphere', 'registry.json'),\n      remotePath:\n        config.remotePath ||\n        'https://raw.githubusercontent.com/hpp-io/noosphere-registry/main/registry.json',\n      autoSync: config.autoSync ?? true,\n      cacheTTL: config.cacheTTL || 3600000, // 1 hour default\n    };\n  }\n\n  /**\n   * Load registry from local and optionally sync from remote\n   */\n  async load(): Promise<void> {\n    // Load local registry\n    await this.loadLocal();\n\n    // Sync from remote if enabled\n    if (this.config.autoSync) {\n      try {\n        await this.sync();\n      } catch (error) {\n        console.warn('Failed to sync remote registry:', error);\n        console.log('Continuing with local registry only');\n      }\n    }\n\n    console.log(`✓ Loaded ${this.containers.size} containers and ${this.verifiers.size} verifiers`);\n  }\n\n  /**\n   * Load local registry file\n   */\n  private async loadLocal(): Promise<void> {\n    try {\n      const data = await fs.readFile(this.config.localPath, 'utf-8');\n      const registry: RegistryIndex = JSON.parse(data);\n\n      // Load containers\n      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {\n        this.containers.set(id, metadata);\n      });\n\n      // Load verifiers\n      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {\n        this.verifiers.set(id, metadata);\n      });\n\n      console.log(`✓ Loaded local registry from ${this.config.localPath}`);\n    } catch (error: any) {\n      if (error.code === 'ENOENT') {\n        console.log('No local registry found, will create default');\n        await this.createDefaultRegistry();\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Sync registry from remote GitHub repository\n   */\n  async sync(): Promise<void> {\n    const now = Date.now();\n\n    // Check cache TTL\n    if (now - this.lastSync < this.config.cacheTTL) {\n      console.log('Registry cache is fresh, skipping sync');\n      return;\n    }\n\n    console.log(`Syncing registry from ${this.config.remotePath}...`);\n\n    try {\n      const response = await fetch(this.config.remotePath);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const registry = (await response.json()) as RegistryIndex;\n\n      // Merge remote registry (remote entries are added, local overrides are kept)\n      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {\n        if (!this.containers.has(id)) {\n          // Only add if not already in local registry (local takes precedence)\n          this.containers.set(id, metadata);\n        }\n      });\n\n      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {\n        if (!this.verifiers.has(id)) {\n          this.verifiers.set(id, metadata);\n        }\n      });\n\n      this.lastSync = now;\n      console.log(`✓ Synced registry (version: ${registry.version})`);\n    } catch (error) {\n      console.error('Failed to sync remote registry:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get container by ID\n   */\n  getContainer(id: string): ContainerMetadata | undefined {\n    return this.containers.get(id);\n  }\n\n  /**\n   * Get all containers\n   */\n  listContainers(): ContainerMetadata[] {\n    return Array.from(this.containers.values()).filter((c) => c.statusCode === 'ACTIVE');\n  }\n\n  /**\n   * Search containers by name or tag\n   */\n  searchContainers(query: string): ContainerMetadata[] {\n    const lowerQuery = query.toLowerCase();\n    return this.listContainers().filter(\n      (c) =>\n        c.name.toLowerCase().includes(lowerQuery) ||\n        c.description?.toLowerCase().includes(lowerQuery) ||\n        c.tags?.some((tag) => tag.toLowerCase().includes(lowerQuery))\n    );\n  }\n\n  /**\n   * Get verifier by contract address\n   */\n  getVerifier(verifierAddress: string): VerifierMetadata | undefined {\n    return this.verifiers.get(verifierAddress);\n  }\n\n  /**\n   * Get verifier by ID\n   */\n  getVerifierById(id: string): VerifierMetadata | undefined {\n    return Array.from(this.verifiers.values()).find((v) => v.id === id);\n  }\n\n  /**\n   * Get all verifiers\n   */\n  listVerifiers(): VerifierMetadata[] {\n    return Array.from(this.verifiers.values()).filter((v) => v.statusCode === 'ACTIVE');\n  }\n\n  /**\n   * Add custom container to local registry\n   */\n  async addContainer(container: ContainerMetadata): Promise<void> {\n    this.containers.set(container.id, container);\n    await this.saveLocal();\n    console.log(`✓ Added container: ${container.name} (${container.id})`);\n  }\n\n  /**\n   * Add custom verifier to local registry\n   */\n  async addVerifier(verifier: VerifierMetadata): Promise<void> {\n    this.verifiers.set(verifier.verifierAddress, verifier);\n    await this.saveLocal();\n    console.log(`✓ Added verifier: ${verifier.name} (${verifier.verifierAddress})`);\n  }\n\n  /**\n   * Remove container from local registry\n   */\n  async removeContainer(id: string): Promise<void> {\n    if (this.containers.delete(id)) {\n      await this.saveLocal();\n      console.log(`✓ Removed container: ${id}`);\n    }\n  }\n\n  /**\n   * Remove verifier from local registry\n   */\n  async removeVerifier(verifierAddress: string): Promise<void> {\n    if (this.verifiers.delete(verifierAddress)) {\n      await this.saveLocal();\n      console.log(`✓ Removed verifier: ${verifierAddress}`);\n    }\n  }\n\n  /**\n   * Save local registry to disk\n   */\n  private async saveLocal(): Promise<void> {\n    const registry: RegistryIndex = {\n      containers: Object.fromEntries(this.containers),\n      verifiers: Object.fromEntries(this.verifiers),\n      version: '1.0.0',\n      updatedAt: new Date().toISOString(),\n    };\n\n    await fs.mkdir(path.dirname(this.config.localPath), { recursive: true });\n    await fs.writeFile(this.config.localPath, JSON.stringify(registry, null, 2));\n  }\n\n  /**\n   * Create default registry with example entries\n   */\n  private async createDefaultRegistry(): Promise<void> {\n    // Create empty registry - will be populated from remote sync\n    // No default containers or verifiers\n    await this.saveLocal();\n    console.log('✓ Created empty local registry (will sync from remote)');\n  }\n\n  /**\n   * Get registry statistics\n   */\n  getStats(): {\n    totalContainers: number;\n    activeContainers: number;\n    totalVerifiers: number;\n    activeVerifiers: number;\n    lastSync: string;\n  } {\n    return {\n      totalContainers: this.containers.size,\n      activeContainers: this.listContainers().length,\n      totalVerifiers: this.verifiers.size,\n      activeVerifiers: this.listVerifiers().length,\n      lastSync: this.lastSync ? new Date(this.lastSync).toISOString() : 'Never',\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,sBAAe;AACf,kBAAiB;AACjB,wBAAkB;AAGX,IAAM,kBAAN,MAAsB;AAAA,EAM3B,YAAY,SAAyB,CAAC,GAAG;AALzC,SAAQ,aAAa,oBAAI,IAA+B;AACxD,SAAQ,YAAY,oBAAI,IAA8B;AAEtD,SAAQ,WAAmB;AAGzB,SAAK,SAAS;AAAA,MACZ,WAAW,OAAO,aAAa,YAAAA,QAAK,KAAK,QAAQ,IAAI,GAAG,cAAc,eAAe;AAAA,MACrF,YACE,OAAO,cACP;AAAA,MACF,UAAU,OAAO,YAAY;AAAA,MAC7B,UAAU,OAAO,YAAY;AAAA;AAAA,IAC/B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAsB;AAE1B,UAAM,KAAK,UAAU;AAGrB,QAAI,KAAK,OAAO,UAAU;AACxB,UAAI;AACF,cAAM,KAAK,KAAK;AAAA,MAClB,SAAS,OAAO;AACd,gBAAQ,KAAK,mCAAmC,KAAK;AACrD,gBAAQ,IAAI,qCAAqC;AAAA,MACnD;AAAA,IACF;AAEA,YAAQ,IAAI,iBAAY,KAAK,WAAW,IAAI,mBAAmB,KAAK,UAAU,IAAI,YAAY;AAAA,EAChG;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,YAA2B;AACvC,QAAI;AACF,YAAM,OAAO,MAAM,gBAAAC,QAAG,SAAS,KAAK,OAAO,WAAW,OAAO;AAC7D,YAAM,WAA0B,KAAK,MAAM,IAAI;AAG/C,aAAO,QAAQ,SAAS,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,QAAQ,MAAM;AACpE,aAAK,WAAW,IAAI,IAAI,QAAQ;AAAA,MAClC,CAAC;AAGD,aAAO,QAAQ,SAAS,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,QAAQ,MAAM;AACnE,aAAK,UAAU,IAAI,IAAI,QAAQ;AAAA,MACjC,CAAC;AAED,cAAQ,IAAI,qCAAgC,KAAK,OAAO,SAAS,EAAE;AAAA,IACrE,SAAS,OAAY;AACnB,UAAI,MAAM,SAAS,UAAU;AAC3B,gBAAQ,IAAI,8CAA8C;AAC1D,cAAM,KAAK,sBAAsB;AAAA,MACnC,OAAO;AACL,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAsB;AAC1B,UAAM,MAAM,KAAK,IAAI;AAGrB,QAAI,MAAM,KAAK,WAAW,KAAK,OAAO,UAAU;AAC9C,cAAQ,IAAI,wCAAwC;AACpD;AAAA,IACF;AAEA,YAAQ,IAAI,yBAAyB,KAAK,OAAO,UAAU,KAAK;AAEhE,QAAI;AACF,YAAM,WAAW,UAAM,kBAAAC,SAAM,KAAK,OAAO,UAAU;AACnD,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI,MAAM,QAAQ,SAAS,MAAM,KAAK,SAAS,UAAU,EAAE;AAAA,MACnE;AAEA,YAAM,WAAY,MAAM,SAAS,KAAK;AAGtC,aAAO,QAAQ,SAAS,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,QAAQ,MAAM;AACpE,YAAI,CAAC,KAAK,WAAW,IAAI,EAAE,GAAG;AAE5B,eAAK,WAAW,IAAI,IAAI,QAAQ;AAAA,QAClC;AAAA,MACF,CAAC;AAED,aAAO,QAAQ,SAAS,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,QAAQ,MAAM;AACnE,YAAI,CAAC,KAAK,UAAU,IAAI,EAAE,GAAG;AAC3B,eAAK,UAAU,IAAI,IAAI,QAAQ;AAAA,QACjC;AAAA,MACF,CAAC;AAED,WAAK,WAAW;AAChB,cAAQ,IAAI,oCAA+B,SAAS,OAAO,GAAG;AAAA,IAChE,SAAS,OAAO;AACd,cAAQ,MAAM,mCAAmC,KAAK;AACtD,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,IAA2C;AACtD,WAAO,KAAK,WAAW,IAAI,EAAE;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAsC;AACpC,WAAO,MAAM,KAAK,KAAK,WAAW,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,eAAe,QAAQ;AAAA,EACrF;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAiB,OAAoC;AACnD,UAAM,aAAa,MAAM,YAAY;AACrC,WAAO,KAAK,eAAe,EAAE;AAAA,MAC3B,CAAC,MACC,EAAE,KAAK,YAAY,EAAE,SAAS,UAAU,KACxC,EAAE,aAAa,YAAY,EAAE,SAAS,UAAU,KAChD,EAAE,MAAM,KAAK,CAAC,QAAQ,IAAI,YAAY,EAAE,SAAS,UAAU,CAAC;AAAA,IAChE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,iBAAuD;AACjE,WAAO,KAAK,UAAU,IAAI,eAAe;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,IAA0C;AACxD,WAAO,MAAM,KAAK,KAAK,UAAU,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAoC;AAClC,WAAO,MAAM,KAAK,KAAK,UAAU,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,eAAe,QAAQ;AAAA,EACpF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,WAA6C;AAC9D,SAAK,WAAW,IAAI,UAAU,IAAI,SAAS;AAC3C,UAAM,KAAK,UAAU;AACrB,YAAQ,IAAI,2BAAsB,UAAU,IAAI,KAAK,UAAU,EAAE,GAAG;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,UAA2C;AAC3D,SAAK,UAAU,IAAI,SAAS,iBAAiB,QAAQ;AACrD,UAAM,KAAK,UAAU;AACrB,YAAQ,IAAI,0BAAqB,SAAS,IAAI,KAAK,SAAS,eAAe,GAAG;AAAA,EAChF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,IAA2B;AAC/C,QAAI,KAAK,WAAW,OAAO,EAAE,GAAG;AAC9B,YAAM,KAAK,UAAU;AACrB,cAAQ,IAAI,6BAAwB,EAAE,EAAE;AAAA,IAC1C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,iBAAwC;AAC3D,QAAI,KAAK,UAAU,OAAO,eAAe,GAAG;AAC1C,YAAM,KAAK,UAAU;AACrB,cAAQ,IAAI,4BAAuB,eAAe,EAAE;AAAA,IACtD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,YAA2B;AACvC,UAAM,WAA0B;AAAA,MAC9B,YAAY,OAAO,YAAY,KAAK,UAAU;AAAA,MAC9C,WAAW,OAAO,YAAY,KAAK,SAAS;AAAA,MAC5C,SAAS;AAAA,MACT,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC;AAEA,UAAM,gBAAAD,QAAG,MAAM,YAAAD,QAAK,QAAQ,KAAK,OAAO,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;AACvE,UAAM,gBAAAC,QAAG,UAAU,KAAK,OAAO,WAAW,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA,EAC7E;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,wBAAuC;AAGnD,UAAM,KAAK,UAAU;AACrB,YAAQ,IAAI,6DAAwD;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA,EAKA,WAME;AACA,WAAO;AAAA,MACL,iBAAiB,KAAK,WAAW;AAAA,MACjC,kBAAkB,KAAK,eAAe,EAAE;AAAA,MACxC,gBAAgB,KAAK,UAAU;AAAA,MAC/B,iBAAiB,KAAK,cAAc,EAAE;AAAA,MACtC,UAAU,KAAK,WAAW,IAAI,KAAK,KAAK,QAAQ,EAAE,YAAY,IAAI;AAAA,IACpE;AAAA,EACF;AACF;","names":["path","fs","fetch"]}

package/dist/index.d.mts

@@ -0,0 +1,151 @@
+interface ContainerMetadata {
+    id: string;
+    name: string;
+    imageName: string;
+    port?: number;
+    command?: string;
+    env?: Record<string, string>;
+    volumes?: string[];
+    payments?: {
+        basePrice: string;
+        token: string;
+        per: string;
+    };
+    requirements?: {
+        memory?: string;
+        cpu?: number;
+        gpu?: boolean;
+    };
+    statusCode: 'ACTIVE' | 'INACTIVE' | 'DEPRECATED';
+    verified?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    description?: string;
+    tags?: string[];
+}
+interface ProofServiceConfig {
+    imageName: string;
+    port: number;
+    command?: string;
+    env?: Record<string, string>;
+    volumes?: string[];
+    requirements?: {
+        memory?: string;
+        cpu?: number;
+        gpu?: boolean;
+    };
+}
+interface VerifierMetadata {
+    id: string;
+    name: string;
+    verifierAddress: string;
+    requiresProof?: boolean;
+    proofService?: ProofServiceConfig;
+    imageName?: string;
+    port?: number;
+    command?: string;
+    env?: Record<string, string>;
+    volumes?: string[];
+    payments?: {
+        basePrice: string;
+        token: string;
+        per: string;
+    };
+    statusCode: 'ACTIVE' | 'INACTIVE' | 'DEPRECATED';
+    verified?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    description?: string;
+}
+interface RegistryConfig {
+    localPath?: string;
+    remotePath?: string;
+    autoSync?: boolean;
+    cacheTTL?: number;
+}
+interface RegistryIndex {
+    containers: Record<string, ContainerMetadata>;
+    verifiers: Record<string, VerifierMetadata>;
+    version: string;
+    updatedAt: string;
+}
+
+declare class RegistryManager {
+    private containers;
+    private verifiers;
+    private config;
+    private lastSync;
+    constructor(config?: RegistryConfig);
+    /**
+     * Load registry from local and optionally sync from remote
+     */
+    load(): Promise<void>;
+    /**
+     * Load local registry file
+     */
+    private loadLocal;
+    /**
+     * Sync registry from remote GitHub repository
+     */
+    sync(): Promise<void>;
+    /**
+     * Get container by ID
+     */
+    getContainer(id: string): ContainerMetadata | undefined;
+    /**
+     * Get all containers
+     */
+    listContainers(): ContainerMetadata[];
+    /**
+     * Search containers by name or tag
+     */
+    searchContainers(query: string): ContainerMetadata[];
+    /**
+     * Get verifier by contract address
+     */
+    getVerifier(verifierAddress: string): VerifierMetadata | undefined;
+    /**
+     * Get verifier by ID
+     */
+    getVerifierById(id: string): VerifierMetadata | undefined;
+    /**
+     * Get all verifiers
+     */
+    listVerifiers(): VerifierMetadata[];
+    /**
+     * Add custom container to local registry
+     */
+    addContainer(container: ContainerMetadata): Promise<void>;
+    /**
+     * Add custom verifier to local registry
+     */
+    addVerifier(verifier: VerifierMetadata): Promise<void>;
+    /**
+     * Remove container from local registry
+     */
+    removeContainer(id: string): Promise<void>;
+    /**
+     * Remove verifier from local registry
+     */
+    removeVerifier(verifierAddress: string): Promise<void>;
+    /**
+     * Save local registry to disk
+     */
+    private saveLocal;
+    /**
+     * Create default registry with example entries
+     */
+    private createDefaultRegistry;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        totalContainers: number;
+        activeContainers: number;
+        totalVerifiers: number;
+        activeVerifiers: number;
+        lastSync: string;
+    };
+}
+
+export { type ContainerMetadata, type ProofServiceConfig, type RegistryConfig, type RegistryIndex, RegistryManager, type VerifierMetadata };

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+interface ContainerMetadata {
+    id: string;
+    name: string;
+    imageName: string;
+    port?: number;
+    command?: string;
+    env?: Record<string, string>;
+    volumes?: string[];
+    payments?: {
+        basePrice: string;
+        token: string;
+        per: string;
+    };
+    requirements?: {
+        memory?: string;
+        cpu?: number;
+        gpu?: boolean;
+    };
+    statusCode: 'ACTIVE' | 'INACTIVE' | 'DEPRECATED';
+    verified?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    description?: string;
+    tags?: string[];
+}
+interface ProofServiceConfig {
+    imageName: string;
+    port: number;
+    command?: string;
+    env?: Record<string, string>;
+    volumes?: string[];
+    requirements?: {
+        memory?: string;
+        cpu?: number;
+        gpu?: boolean;
+    };
+}
+interface VerifierMetadata {
+    id: string;
+    name: string;
+    verifierAddress: string;
+    requiresProof?: boolean;
+    proofService?: ProofServiceConfig;
+    imageName?: string;
+    port?: number;
+    command?: string;
+    env?: Record<string, string>;
+    volumes?: string[];
+    payments?: {
+        basePrice: string;
+        token: string;
+        per: string;
+    };
+    statusCode: 'ACTIVE' | 'INACTIVE' | 'DEPRECATED';
+    verified?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    description?: string;
+}
+interface RegistryConfig {
+    localPath?: string;
+    remotePath?: string;
+    autoSync?: boolean;
+    cacheTTL?: number;
+}
+interface RegistryIndex {
+    containers: Record<string, ContainerMetadata>;
+    verifiers: Record<string, VerifierMetadata>;
+    version: string;
+    updatedAt: string;
+}
+
+declare class RegistryManager {
+    private containers;
+    private verifiers;
+    private config;
+    private lastSync;
+    constructor(config?: RegistryConfig);
+    /**
+     * Load registry from local and optionally sync from remote
+     */
+    load(): Promise<void>;
+    /**
+     * Load local registry file
+     */
+    private loadLocal;
+    /**
+     * Sync registry from remote GitHub repository
+     */
+    sync(): Promise<void>;
+    /**
+     * Get container by ID
+     */
+    getContainer(id: string): ContainerMetadata | undefined;
+    /**
+     * Get all containers
+     */
+    listContainers(): ContainerMetadata[];
+    /**
+     * Search containers by name or tag
+     */
+    searchContainers(query: string): ContainerMetadata[];
+    /**
+     * Get verifier by contract address
+     */
+    getVerifier(verifierAddress: string): VerifierMetadata | undefined;
+    /**
+     * Get verifier by ID
+     */
+    getVerifierById(id: string): VerifierMetadata | undefined;
+    /**
+     * Get all verifiers
+     */
+    listVerifiers(): VerifierMetadata[];
+    /**
+     * Add custom container to local registry
+     */
+    addContainer(container: ContainerMetadata): Promise<void>;
+    /**
+     * Add custom verifier to local registry
+     */
+    addVerifier(verifier: VerifierMetadata): Promise<void>;
+    /**
+     * Remove container from local registry
+     */
+    removeContainer(id: string): Promise<void>;
+    /**
+     * Remove verifier from local registry
+     */
+    removeVerifier(verifierAddress: string): Promise<void>;
+    /**
+     * Save local registry to disk
+     */
+    private saveLocal;
+    /**
+     * Create default registry with example entries
+     */
+    private createDefaultRegistry;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        totalContainers: number;
+        activeContainers: number;
+        totalVerifiers: number;
+        activeVerifiers: number;
+        lastSync: string;
+    };
+}
+
+export { type ContainerMetadata, type ProofServiceConfig, type RegistryConfig, type RegistryIndex, RegistryManager, type VerifierMetadata };

package/dist/index.js

@@ -0,0 +1,198 @@
+// src/RegistryManager.ts
+import fs from "fs/promises";
+import path from "path";
+import fetch from "node-fetch";
+var RegistryManager = class {
+  constructor(config = {}) {
+    this.containers = /* @__PURE__ */ new Map();
+    this.verifiers = /* @__PURE__ */ new Map();
+    this.lastSync = 0;
+    this.config = {
+      localPath: config.localPath || path.join(process.cwd(), ".noosphere", "registry.json"),
+      remotePath: config.remotePath || "https://raw.githubusercontent.com/hpp-io/noosphere-registry/main/registry.json",
+      autoSync: config.autoSync ?? true,
+      cacheTTL: config.cacheTTL || 36e5
+      // 1 hour default
+    };
+  }
+  /**
+   * Load registry from local and optionally sync from remote
+   */
+  async load() {
+    await this.loadLocal();
+    if (this.config.autoSync) {
+      try {
+        await this.sync();
+      } catch (error) {
+        console.warn("Failed to sync remote registry:", error);
+        console.log("Continuing with local registry only");
+      }
+    }
+    console.log(`\u2713 Loaded ${this.containers.size} containers and ${this.verifiers.size} verifiers`);
+  }
+  /**
+   * Load local registry file
+   */
+  async loadLocal() {
+    try {
+      const data = await fs.readFile(this.config.localPath, "utf-8");
+      const registry = JSON.parse(data);
+      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {
+        this.containers.set(id, metadata);
+      });
+      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {
+        this.verifiers.set(id, metadata);
+      });
+      console.log(`\u2713 Loaded local registry from ${this.config.localPath}`);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        console.log("No local registry found, will create default");
+        await this.createDefaultRegistry();
+      } else {
+        throw error;
+      }
+    }
+  }
+  /**
+   * Sync registry from remote GitHub repository
+   */
+  async sync() {
+    const now = Date.now();
+    if (now - this.lastSync < this.config.cacheTTL) {
+      console.log("Registry cache is fresh, skipping sync");
+      return;
+    }
+    console.log(`Syncing registry from ${this.config.remotePath}...`);
+    try {
+      const response = await fetch(this.config.remotePath);
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+      const registry = await response.json();
+      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {
+        if (!this.containers.has(id)) {
+          this.containers.set(id, metadata);
+        }
+      });
+      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {
+        if (!this.verifiers.has(id)) {
+          this.verifiers.set(id, metadata);
+        }
+      });
+      this.lastSync = now;
+      console.log(`\u2713 Synced registry (version: ${registry.version})`);
+    } catch (error) {
+      console.error("Failed to sync remote registry:", error);
+      throw error;
+    }
+  }
+  /**
+   * Get container by ID
+   */
+  getContainer(id) {
+    return this.containers.get(id);
+  }
+  /**
+   * Get all containers
+   */
+  listContainers() {
+    return Array.from(this.containers.values()).filter((c) => c.statusCode === "ACTIVE");
+  }
+  /**
+   * Search containers by name or tag
+   */
+  searchContainers(query) {
+    const lowerQuery = query.toLowerCase();
+    return this.listContainers().filter(
+      (c) => c.name.toLowerCase().includes(lowerQuery) || c.description?.toLowerCase().includes(lowerQuery) || c.tags?.some((tag) => tag.toLowerCase().includes(lowerQuery))
+    );
+  }
+  /**
+   * Get verifier by contract address
+   */
+  getVerifier(verifierAddress) {
+    return this.verifiers.get(verifierAddress);
+  }
+  /**
+   * Get verifier by ID
+   */
+  getVerifierById(id) {
+    return Array.from(this.verifiers.values()).find((v) => v.id === id);
+  }
+  /**
+   * Get all verifiers
+   */
+  listVerifiers() {
+    return Array.from(this.verifiers.values()).filter((v) => v.statusCode === "ACTIVE");
+  }
+  /**
+   * Add custom container to local registry
+   */
+  async addContainer(container) {
+    this.containers.set(container.id, container);
+    await this.saveLocal();
+    console.log(`\u2713 Added container: ${container.name} (${container.id})`);
+  }
+  /**
+   * Add custom verifier to local registry
+   */
+  async addVerifier(verifier) {
+    this.verifiers.set(verifier.verifierAddress, verifier);
+    await this.saveLocal();
+    console.log(`\u2713 Added verifier: ${verifier.name} (${verifier.verifierAddress})`);
+  }
+  /**
+   * Remove container from local registry
+   */
+  async removeContainer(id) {
+    if (this.containers.delete(id)) {
+      await this.saveLocal();
+      console.log(`\u2713 Removed container: ${id}`);
+    }
+  }
+  /**
+   * Remove verifier from local registry
+   */
+  async removeVerifier(verifierAddress) {
+    if (this.verifiers.delete(verifierAddress)) {
+      await this.saveLocal();
+      console.log(`\u2713 Removed verifier: ${verifierAddress}`);
+    }
+  }
+  /**
+   * Save local registry to disk
+   */
+  async saveLocal() {
+    const registry = {
+      containers: Object.fromEntries(this.containers),
+      verifiers: Object.fromEntries(this.verifiers),
+      version: "1.0.0",
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await fs.mkdir(path.dirname(this.config.localPath), { recursive: true });
+    await fs.writeFile(this.config.localPath, JSON.stringify(registry, null, 2));
+  }
+  /**
+   * Create default registry with example entries
+   */
+  async createDefaultRegistry() {
+    await this.saveLocal();
+    console.log("\u2713 Created empty local registry (will sync from remote)");
+  }
+  /**
+   * Get registry statistics
+   */
+  getStats() {
+    return {
+      totalContainers: this.containers.size,
+      activeContainers: this.listContainers().length,
+      totalVerifiers: this.verifiers.size,
+      activeVerifiers: this.listVerifiers().length,
+      lastSync: this.lastSync ? new Date(this.lastSync).toISOString() : "Never"
+    };
+  }
+};
+export {
+  RegistryManager
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/RegistryManager.ts"],"sourcesContent":["import fs from 'fs/promises';\nimport path from 'path';\nimport fetch from 'node-fetch';\nimport type { ContainerMetadata, VerifierMetadata, RegistryConfig, RegistryIndex } from './types';\n\nexport class RegistryManager {\n  private containers = new Map<string, ContainerMetadata>();\n  private verifiers = new Map<string, VerifierMetadata>();\n  private config: Required<RegistryConfig>;\n  private lastSync: number = 0;\n\n  constructor(config: RegistryConfig = {}) {\n    this.config = {\n      localPath: config.localPath || path.join(process.cwd(), '.noosphere', 'registry.json'),\n      remotePath:\n        config.remotePath ||\n        'https://raw.githubusercontent.com/hpp-io/noosphere-registry/main/registry.json',\n      autoSync: config.autoSync ?? true,\n      cacheTTL: config.cacheTTL || 3600000, // 1 hour default\n    };\n  }\n\n  /**\n   * Load registry from local and optionally sync from remote\n   */\n  async load(): Promise<void> {\n    // Load local registry\n    await this.loadLocal();\n\n    // Sync from remote if enabled\n    if (this.config.autoSync) {\n      try {\n        await this.sync();\n      } catch (error) {\n        console.warn('Failed to sync remote registry:', error);\n        console.log('Continuing with local registry only');\n      }\n    }\n\n    console.log(`✓ Loaded ${this.containers.size} containers and ${this.verifiers.size} verifiers`);\n  }\n\n  /**\n   * Load local registry file\n   */\n  private async loadLocal(): Promise<void> {\n    try {\n      const data = await fs.readFile(this.config.localPath, 'utf-8');\n      const registry: RegistryIndex = JSON.parse(data);\n\n      // Load containers\n      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {\n        this.containers.set(id, metadata);\n      });\n\n      // Load verifiers\n      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {\n        this.verifiers.set(id, metadata);\n      });\n\n      console.log(`✓ Loaded local registry from ${this.config.localPath}`);\n    } catch (error: any) {\n      if (error.code === 'ENOENT') {\n        console.log('No local registry found, will create default');\n        await this.createDefaultRegistry();\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Sync registry from remote GitHub repository\n   */\n  async sync(): Promise<void> {\n    const now = Date.now();\n\n    // Check cache TTL\n    if (now - this.lastSync < this.config.cacheTTL) {\n      console.log('Registry cache is fresh, skipping sync');\n      return;\n    }\n\n    console.log(`Syncing registry from ${this.config.remotePath}...`);\n\n    try {\n      const response = await fetch(this.config.remotePath);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const registry = (await response.json()) as RegistryIndex;\n\n      // Merge remote registry (remote entries are added, local overrides are kept)\n      Object.entries(registry.containers || {}).forEach(([id, metadata]) => {\n        if (!this.containers.has(id)) {\n          // Only add if not already in local registry (local takes precedence)\n          this.containers.set(id, metadata);\n        }\n      });\n\n      Object.entries(registry.verifiers || {}).forEach(([id, metadata]) => {\n        if (!this.verifiers.has(id)) {\n          this.verifiers.set(id, metadata);\n        }\n      });\n\n      this.lastSync = now;\n      console.log(`✓ Synced registry (version: ${registry.version})`);\n    } catch (error) {\n      console.error('Failed to sync remote registry:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get container by ID\n   */\n  getContainer(id: string): ContainerMetadata | undefined {\n    return this.containers.get(id);\n  }\n\n  /**\n   * Get all containers\n   */\n  listContainers(): ContainerMetadata[] {\n    return Array.from(this.containers.values()).filter((c) => c.statusCode === 'ACTIVE');\n  }\n\n  /**\n   * Search containers by name or tag\n   */\n  searchContainers(query: string): ContainerMetadata[] {\n    const lowerQuery = query.toLowerCase();\n    return this.listContainers().filter(\n      (c) =>\n        c.name.toLowerCase().includes(lowerQuery) ||\n        c.description?.toLowerCase().includes(lowerQuery) ||\n        c.tags?.some((tag) => tag.toLowerCase().includes(lowerQuery))\n    );\n  }\n\n  /**\n   * Get verifier by contract address\n   */\n  getVerifier(verifierAddress: string): VerifierMetadata | undefined {\n    return this.verifiers.get(verifierAddress);\n  }\n\n  /**\n   * Get verifier by ID\n   */\n  getVerifierById(id: string): VerifierMetadata | undefined {\n    return Array.from(this.verifiers.values()).find((v) => v.id === id);\n  }\n\n  /**\n   * Get all verifiers\n   */\n  listVerifiers(): VerifierMetadata[] {\n    return Array.from(this.verifiers.values()).filter((v) => v.statusCode === 'ACTIVE');\n  }\n\n  /**\n   * Add custom container to local registry\n   */\n  async addContainer(container: ContainerMetadata): Promise<void> {\n    this.containers.set(container.id, container);\n    await this.saveLocal();\n    console.log(`✓ Added container: ${container.name} (${container.id})`);\n  }\n\n  /**\n   * Add custom verifier to local registry\n   */\n  async addVerifier(verifier: VerifierMetadata): Promise<void> {\n    this.verifiers.set(verifier.verifierAddress, verifier);\n    await this.saveLocal();\n    console.log(`✓ Added verifier: ${verifier.name} (${verifier.verifierAddress})`);\n  }\n\n  /**\n   * Remove container from local registry\n   */\n  async removeContainer(id: string): Promise<void> {\n    if (this.containers.delete(id)) {\n      await this.saveLocal();\n      console.log(`✓ Removed container: ${id}`);\n    }\n  }\n\n  /**\n   * Remove verifier from local registry\n   */\n  async removeVerifier(verifierAddress: string): Promise<void> {\n    if (this.verifiers.delete(verifierAddress)) {\n      await this.saveLocal();\n      console.log(`✓ Removed verifier: ${verifierAddress}`);\n    }\n  }\n\n  /**\n   * Save local registry to disk\n   */\n  private async saveLocal(): Promise<void> {\n    const registry: RegistryIndex = {\n      containers: Object.fromEntries(this.containers),\n      verifiers: Object.fromEntries(this.verifiers),\n      version: '1.0.0',\n      updatedAt: new Date().toISOString(),\n    };\n\n    await fs.mkdir(path.dirname(this.config.localPath), { recursive: true });\n    await fs.writeFile(this.config.localPath, JSON.stringify(registry, null, 2));\n  }\n\n  /**\n   * Create default registry with example entries\n   */\n  private async createDefaultRegistry(): Promise<void> {\n    // Create empty registry - will be populated from remote sync\n    // No default containers or verifiers\n    await this.saveLocal();\n    console.log('✓ Created empty local registry (will sync from remote)');\n  }\n\n  /**\n   * Get registry statistics\n   */\n  getStats(): {\n    totalContainers: number;\n    activeContainers: number;\n    totalVerifiers: number;\n    activeVerifiers: number;\n    lastSync: string;\n  } {\n    return {\n      totalContainers: this.containers.size,\n      activeContainers: this.listContainers().length,\n      totalVerifiers: this.verifiers.size,\n      activeVerifiers: this.listVerifiers().length,\n      lastSync: this.lastSync ? new Date(this.lastSync).toISOString() : 'Never',\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@noosphere/registry",
+  "version": "0.1.0-alpha.0",
+  "description": "Container and Verifier registry for Noosphere SDK",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "noosphere",
+    "registry",
+    "container",
+    "verifier"
+  ],
+  "author": "Noosphere Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hpp-io/noosphere-sdk.git",
+    "directory": "packages/registry"
+  },
+  "bugs": {
+    "url": "https://github.com/hpp-io/noosphere-sdk/issues"
+  },
+  "homepage": "https://github.com/hpp-io/noosphere-sdk/tree/main/packages/registry#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.10.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  }
+}