@alfe.ai/integrations 0.0.2 → 0.0.3

package/dist/index.d.ts

@@ -58,14 +58,21 @@ interface RegistryIndex {
   version: number;
   integrations: Record<string, RegistryEntry>;
 }
+/**
+ * Fetcher function that returns the raw integrations array from the registry API.
+ * Callers wire this up using their api-client instance so Registry stays dependency-free.
+ */
+type RegistryFetcher = () => Promise<(RegistryEntry & {
+  id: string;
+})[]>;
 declare class Registry {
   private index;
-  private apiUrl;
+  private fetcher;
   /**
-   * @param apiUrl - Base URL for the Alfe API (e.g. "https://api.alfe.ai").
-   *                 Falls back to ALFE_API_URL env var, then the production URL.
+   * @param fetcher - Function that fetches the integrations array from the registry API.
+   *                  Typically backed by api-client's IntegrationsService.getRegistry().
    */
-  constructor(apiUrl?: string);
+  constructor(fetcher: RegistryFetcher);
   /**
    * Load the registry index. Uses cache if already loaded.
    */
@@ -364,6 +371,8 @@ interface IntegrationManagerOptions {
   runtimeAppliers?: Map<string, RuntimeApplier>;
   /** Override lock file path (defaults to ~/.alfe/runtime-lock.json) */
   lockPath?: string;
+  /** Fetcher for the integration registry — should be wired to api-client */
+  registryFetcher: RegistryFetcher;
 }
 interface ManagerResponse {
   ok: boolean;
@@ -400,7 +409,7 @@ declare class IntegrationManager {
   private lockManager;
   /** In-memory secret store — NEVER persisted to disk */
   private secrets;
-  constructor(options?: IntegrationManagerOptions);
+  constructor(options: IntegrationManagerOptions);
   /**
    * Install an integration from the registry.
    *
@@ -714,4 +723,4 @@ declare class IntegrationManagerAdapter implements IIntegrationManager {
   uninstall(integrationId: string): Promise<void>;
 }
 //#endregion
-export { type HookEnvOptions, type HookResult, type IIntegrationManager, type InstalledInfo, Installer, InstallerError, type IntegrationConfigureParams, type IntegrationHealthParams, type IntegrationInfo, type IntegrationInstallParams, IntegrationManager, IntegrationManagerAdapter, type IntegrationManagerOptions, type IntegrationRemoveParams, LockManager, OpenClawApplier, type OpenClawApplierOptions, Registry, type RegistryEntry, type RegistryIndex, RegistryResolveError, type ResolvedIntegration, Resolver, type RuntimeApplier, type RuntimeDesiredState, type RuntimeLockFile, type RuntimePluginEntry, type RuntimeSkillEntry, StateManager, buildHookEnv, resolveInstallsForRuntime, runHook, runHookWithContext };
+export { type HookEnvOptions, type HookResult, type IIntegrationManager, type InstalledInfo, Installer, InstallerError, type IntegrationConfigureParams, type IntegrationHealthParams, type IntegrationInfo, type IntegrationInstallParams, IntegrationManager, IntegrationManagerAdapter, type IntegrationManagerOptions, type IntegrationRemoveParams, LockManager, OpenClawApplier, type OpenClawApplierOptions, Registry, type RegistryEntry, type RegistryFetcher, type RegistryIndex, RegistryResolveError, type ResolvedIntegration, Resolver, type RuntimeApplier, type RuntimeDesiredState, type RuntimeLockFile, type RuntimePluginEntry, type RuntimeSkillEntry, StateManager, buildHookEnv, resolveInstallsForRuntime, runHook, runHookWithContext };

package/dist/index.js

@@ -6,37 +6,27 @@ import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, write
 import { buildConfigValidationSchema, parseManifestFile } from "@alfe.ai/integration-manifest";
 import { createLogger } from "@auriclabs/logger";
 //#region src/registry.ts
-const DEFAULT_API_URL = "https://api.alfe.ai";
-const REGISTRY_PATH = "/integrations/registry";
 var Registry = class {
 	index = null;
-	apiUrl;
+	fetcher;
 	/**
-	* @param apiUrl - Base URL for the Alfe API (e.g. "https://api.alfe.ai").
-	*                 Falls back to ALFE_API_URL env var, then the production URL.
+	* @param fetcher - Function that fetches the integrations array from the registry API.
+	*                  Typically backed by api-client's IntegrationsService.getRegistry().
 	*/
-	constructor(apiUrl) {
-		this.apiUrl = (apiUrl ?? process.env.ALFE_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
+	constructor(fetcher) {
+		this.fetcher = fetcher;
 	}
 	/**
 	* Load the registry index. Uses cache if already loaded.
 	*/
 	async load() {
 		if (this.index) return this.index;
-		const url = `${this.apiUrl}${REGISTRY_PATH}`;
-		const res = await fetch(url);
-		if (!res.ok) throw new Error(`Failed to fetch registry index from ${url}: ${String(res.status)} ${res.statusText}`);
-		const body = await res.json();
-		if (!body.success || !body.data?.integrations) throw new Error(`Invalid registry response from ${url}`);
-		const raw = body.data.integrations;
-		let integrations;
-		if (Array.isArray(raw)) {
-			integrations = {};
-			for (const entry of raw) {
-				const { id, ...rest } = entry;
-				integrations[id] = rest;
-			}
-		} else integrations = raw;
+		const raw = await this.fetcher();
+		const integrations = {};
+		for (const entry of raw) {
+			const { id, ...rest } = entry;
+			integrations[id] = rest;
+		}
 		this.index = {
 			version: 1,
 			integrations
@@ -98,7 +88,7 @@ var Resolver = class {
 	async resolve(id, version) {
 		const entry = await this.registry.get(id);
 		if (!entry) throw new RegistryResolveError(`Integration "${id}" not found in registry`);
-		const resolvedVersion = version ?? entry.latest;
+		const resolvedVersion = version && version.length > 0 ? version : entry.latest;
 		if (!entry.versions.includes(resolvedVersion)) throw new RegistryResolveError(`Version "${resolvedVersion}" not found for integration "${id}". Available versions: ${entry.versions.join(", ")}`);
 		return {
 			id,
@@ -686,12 +676,12 @@ var IntegrationManager = class {
 	/** In-memory secret store — NEVER persisted to disk */
 	secrets = /* @__PURE__ */ new Map();
 	constructor(options) {
-		this.state = new StateManager(options?.statePath);
-		this.registry = new Registry();
+		this.state = new StateManager(options.statePath);
+		this.registry = new Registry(options.registryFetcher);
 		this.resolver = new Resolver(this.registry);
-		this.installer = new Installer(options?.integrationsDir);
-		this.runtimeAppliers = options?.runtimeAppliers ?? /* @__PURE__ */ new Map();
-		this.lockManager = new LockManager(options?.lockPath);
+		this.installer = new Installer(options.integrationsDir);
+		this.runtimeAppliers = options.runtimeAppliers ?? /* @__PURE__ */ new Map();
+		this.lockManager = new LockManager(options.lockPath);
 	}
 	/**
 	* Install an integration from the registry.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",