@almadar/integrations 2.2.1 → 2.4.0

package/LICENSE

@@ -1,21 +1,72 @@
-MIT License
-
-Copyright (c) 2026 Almadar Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Almadar FZE
+Licensed Work:        KFlow Builder / Almadar
+                      The Licensed Work is (c) 2025-2026 Almadar FZE.
+Additional Use Grant: You may make production use of the Licensed Work for
+                      non-commercial purposes and for internal evaluation.
+                      Production use for commercial purposes requires a
+                      commercial license from the Licensor.
+Change Date:          2030-02-01
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+---
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+ADDITIONAL TERMS:
+
+Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
+
+TRADEMARKS:
+
+"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
+Almadar FZE. You may not use these trademarks without prior written
+permission from Almadar FZE.
+
+For licensing inquiries: licensing@almadar.io

package/README.md

@@ -287,4 +287,4 @@ class MyIntegration extends BaseIntegration {
 
 ## License
 
-MIT
+BSL 1.1 (Business Source License). Converts to Apache 2.0 on 2030-02-01. Non-production use is free.

package/dist/runtime/index.d.ts

@@ -3,15 +3,28 @@ import '../BaseIntegration-DNSuiUnG.js';
 
 /**
  * Runtime integration manager
- * Auto-configures integrations from environment variables
+ * Auto-configures integrations from environment variables.
+ * When USE_MOCK_DATA=true, registers mock integrations for all services
+ * using response shapes from services-registry.json.
  */
 declare class RuntimeIntegrationManager {
     private factory;
     constructor();
     /**
-     * Configure from environment variables
+     * Configure from environment variables.
+     * In mock mode (USE_MOCK_DATA=true), all services return realistic mock data.
      */
     configureFromEnv(): void;
+    /**
+     * Configure mock mode: register MockIntegration for all known services
+     * with auto-generated responses from the services registry.
+     */
+    private configureMockMode;
+    /**
+     * Load services registry from @almadar/patterns.
+     * Returns a map of service name to { actions: [...] }.
+     */
+    private loadServicesRegistry;
     /**
      * Get effect handler for runtime
      */

package/dist/runtime/index.js

@@ -1,3 +1,8 @@
+import { createRequire } from 'module';
+import { integratorsRegistry } from '@almadar/patterns';
+
+// src/runtime/RuntimeIntegrationManager.ts
+
 // src/registry.ts
 var INTEGRATION_REGISTRY = {};
 function getIntegration(name) {
@@ -65,6 +70,258 @@ var IntegrationFactory = class {
   }
 };
 
+// src/core/logger.ts
+var ConsoleLogger = class {
+  constructor(level = "info") {
+    this.level = level;
+  }
+  debug(message, meta) {
+    if (this.shouldLog("debug")) {
+      console.debug(`[DEBUG] ${message}`, meta || "");
+    }
+  }
+  info(message, meta) {
+    if (this.shouldLog("info")) {
+      console.log(`[INFO] ${message}`, meta || "");
+    }
+  }
+  warn(message, meta) {
+    if (this.shouldLog("warn")) {
+      console.warn(`[WARN] ${message}`, meta || "");
+    }
+  }
+  error(message, meta) {
+    if (this.shouldLog("error")) {
+      console.error(`[ERROR] ${message}`, meta || "");
+    }
+  }
+  shouldLog(level) {
+    const levels = ["debug", "info", "warn", "error"];
+    return levels.indexOf(level) >= levels.indexOf(this.level);
+  }
+};
+function validateParams(integration, action, params) {
+  const typedRegistry = integratorsRegistry;
+  const registry = typedRegistry.integrators[integration];
+  if (!registry) {
+    return {
+      valid: false,
+      errors: [
+        {
+          param: "integration",
+          message: `Unknown integration: ${integration}`
+        }
+      ]
+    };
+  }
+  const actionDef = registry.actions.find((a) => a.name === action);
+  if (!actionDef) {
+    return {
+      valid: false,
+      errors: [{ param: "action", message: `Unknown action: ${action}` }]
+    };
+  }
+  const errors = [];
+  for (const paramDef of actionDef.params) {
+    if (paramDef.required && !(paramDef.name in params)) {
+      errors.push({
+        param: paramDef.name,
+        message: `Missing required parameter: ${paramDef.name}`
+      });
+    }
+    if (paramDef.name in params) {
+      const value = params[paramDef.name];
+      const expectedType = paramDef.type;
+      const actualType = typeof value;
+      if (expectedType === "number" && actualType !== "number") {
+        errors.push({
+          param: paramDef.name,
+          message: `Expected ${expectedType}, got ${actualType}`
+        });
+      }
+      if (expectedType === "string" && actualType !== "string") {
+        errors.push({
+          param: paramDef.name,
+          message: `Expected ${expectedType}, got ${actualType}`
+        });
+      }
+      if (expectedType === "array" && !Array.isArray(value)) {
+        errors.push({
+          param: paramDef.name,
+          message: `Expected array, got ${actualType}`
+        });
+      }
+      if (expectedType === "object" && (actualType !== "object" || Array.isArray(value) || value === null)) {
+        errors.push({
+          param: paramDef.name,
+          message: `Expected object, got ${actualType}`
+        });
+      }
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+// src/core/retry.ts
+async function withRetry(fn, config) {
+  const {
+    maxAttempts,
+    backoffMs,
+    maxBackoffMs = 3e4,
+    retryableErrors
+  } = config;
+  let lastError;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (error && typeof error === "object" && "code" in error && retryableErrors) {
+        const integrationError = error;
+        if (!retryableErrors.includes(integrationError.code)) {
+          throw error;
+        }
+      }
+      if (attempt === maxAttempts) {
+        throw error;
+      }
+      const delay = Math.min(
+        backoffMs * Math.pow(2, attempt - 1),
+        maxBackoffMs
+      );
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+  }
+  throw lastError;
+}
+
+// src/core/BaseIntegration.ts
+var BaseIntegration = class {
+  constructor(config) {
+    this.config = config;
+    this.logger = config.logger || new ConsoleLogger();
+  }
+  /**
+   * Validate action params against registry
+   */
+  validateParams(action, params) {
+    return validateParams(this.config.name, action, params);
+  }
+  /**
+   * Handle errors uniformly
+   */
+  handleError(action, error) {
+    this.logger.error(`Integration error in ${this.config.name}.${action}`, {
+      error
+    });
+    const integrationError = error instanceof Error ? error : new Error(String(error));
+    return {
+      success: false,
+      error: integrationError,
+      metadata: this.createMetadata(action, 0, 0)
+    };
+  }
+  /**
+   * Create metadata for result
+   */
+  createMetadata(action, duration, retries = 0) {
+    return {
+      integration: this.config.name,
+      action,
+      duration,
+      retries,
+      timestamp: Date.now()
+    };
+  }
+  /**
+   * Execute with retry logic
+   */
+  async executeWithRetry(fn) {
+    if (!this.config.retry) {
+      return fn();
+    }
+    return withRetry(fn, {
+      maxAttempts: this.config.retry.maxAttempts,
+      backoffMs: this.config.retry.backoffMs,
+      maxBackoffMs: this.config.retry.maxBackoffMs,
+      retryableErrors: [
+        "TIMEOUT_ERROR",
+        "NETWORK_ERROR",
+        "RATE_LIMIT_ERROR"
+      ]
+    });
+  }
+};
+
+// src/types.ts
+var IntegrationError = class extends Error {
+  constructor(message, code = "UNKNOWN_ERROR", details) {
+    super(message);
+    this.name = "IntegrationError";
+    this.code = code;
+    this.details = details;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      integration: this.integration,
+      action: this.action,
+      details: this.details
+    };
+  }
+};
+
+// src/mocks/MockIntegration.ts
+var MockIntegration = class extends BaseIntegration {
+  constructor(config) {
+    super(config);
+    this.responses = /* @__PURE__ */ new Map();
+    this.calls = [];
+  }
+  /**
+   * Set mock response for an action
+   */
+  setResponse(action, data) {
+    this.responses.set(action, data);
+  }
+  /**
+   * Get all calls made to this integration
+   */
+  getCalls() {
+    return this.calls;
+  }
+  /**
+   * Clear all calls
+   */
+  clearCalls() {
+    this.calls = [];
+  }
+  async execute(action, params) {
+    this.calls.push({ action, params });
+    const data = this.responses.get(action);
+    if (!data) {
+      return {
+        success: false,
+        error: new IntegrationError(
+          `No mock response for action: ${action}`,
+          "UNKNOWN_ERROR"
+        ),
+        metadata: this.createMetadata(action, 0)
+      };
+    }
+    return {
+      success: true,
+      data,
+      metadata: this.createMetadata(action, 0)
+    };
+  }
+};
+
 // src/runtime/effectHandler.ts
 function createCallServiceHandler(factory) {
   return async (service, action, params) => {
@@ -77,15 +334,45 @@ function createCallServiceHandler(factory) {
 }
 
 // src/runtime/RuntimeIntegrationManager.ts
+function generateMockFromShape(shape) {
+  const data = {};
+  for (const [key, type] of Object.entries(shape)) {
+    switch (type) {
+      case "string":
+        data[key] = `mock_${key}`;
+        break;
+      case "number":
+        data[key] = 42;
+        break;
+      case "boolean":
+        data[key] = true;
+        break;
+      case "object":
+        data[key] = {};
+        break;
+      case "string[]":
+        data[key] = [];
+        break;
+      default:
+        data[key] = `mock_${key}`;
+    }
+  }
+  return data;
+}
 var RuntimeIntegrationManager = class {
   constructor() {
     this.factory = new IntegrationFactory();
   }
   /**
-   * Configure from environment variables
+   * Configure from environment variables.
+   * In mock mode (USE_MOCK_DATA=true), all services return realistic mock data.
    */
   configureFromEnv() {
     const env = process.env;
+    if (env.USE_MOCK_DATA === "true") {
+      this.configureMockMode();
+      return;
+    }
     if (env.STRIPE_SECRET_KEY) {
       this.factory.configure("stripe", {
         env: {
@@ -160,6 +447,50 @@ var RuntimeIntegrationManager = class {
       });
     }
   }
+  /**
+   * Configure mock mode: register MockIntegration for all known services
+   * with auto-generated responses from the services registry.
+   */
+  configureMockMode() {
+    const registry = this.loadServicesRegistry();
+    for (const [serviceName, service] of Object.entries(registry)) {
+      const mock = new MockIntegration({ name: serviceName, env: {} });
+      for (const action of service.actions) {
+        if (action.responseShape && Object.keys(action.responseShape).length > 0) {
+          mock.setResponse(action.name, generateMockFromShape(action.responseShape));
+        } else {
+          mock.setResponse(action.name, { success: true, _mock: true, _action: action.name });
+        }
+      }
+      this.factory.configure(serviceName, { env: {} });
+      this.factory.instances.set(serviceName, mock);
+    }
+    const originalExecute = this.factory.execute.bind(this.factory);
+    this.factory.execute = async (integration, action, params) => {
+      try {
+        return await originalExecute(integration, action, params);
+      } catch {
+        return {
+          success: true,
+          data: { ...params, _mock: true, _service: integration, _action: action },
+          metadata: { integration, action, duration: 0, retries: 0, timestamp: Date.now() }
+        };
+      }
+    };
+  }
+  /**
+   * Load services registry from @almadar/patterns.
+   * Returns a map of service name to { actions: [...] }.
+   */
+  loadServicesRegistry() {
+    try {
+      const esmRequire = createRequire(import.meta.url);
+      const registry = esmRequire("@almadar/patterns/services-registry.json");
+      return registry.services;
+    } catch {
+      return {};
+    }
+  }
   /**
    * Get effect handler for runtime
    */

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/registry.ts","../../src/factory.ts","../../src/runtime/effectHandler.ts","../../src/runtime/RuntimeIntegrationManager.ts"],"names":[],"mappings":";AAaO,IAAM,uBAA+D,EAAC;AAetE,SAAS,eACd,IAAA,EACoC;AACpC,EAAA,OAAO,qBAAqB,IAAI,CAAA;AAClC;;;ACzBO,IAAM,qBAAN,MAAyB;AAAA,EAAzB,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,SAAA,uBAA8C,GAAA,EAAI;AAC1D,IAAA,IAAA,CAAQ,OAAA,uBAA8C,GAAA,EAAI;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAK1D,SAAA,CAAU,MAAc,MAAA,EAA+C;AACrE,IAAA,IAAA,CAAK,QAAQ,GAAA,CAAI,IAAA,EAAM,EAAE,IAAA,EAAM,GAAG,QAAQ,CAAA;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,IAAA,EAA+B;AAEjC,IAAA,IAAI,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAAA,IAChC;AAGA,IAAA,MAAM,WAAA,GAAc,eAAe,IAAI,CAAA;AACvC,IAAA,IAAI,CAAC,WAAA,EAAa;AAChB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,IAAI,CAAA,0BAAA,CAA4B,CAAA;AAAA,IAC1E;AAGA,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA;AACpC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,+BAA+B,IAAI,CAAA,yBAAA;AAAA,OACrC;AAAA,IACF;AAGA,IAAA,MAAM,QAAA,GAAW,IAAI,WAAA,CAAY,MAAM,CAAA;AACvC,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,IAAA,EAAM,QAAQ,CAAA;AAEjC,IAAA,OAAO,QAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAA,CACJ,WAAA,EACA,MAAA,EACA,MAAA,EAC4B;AAC5B,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,CAAI,WAAW,CAAA;AACrC,IAAA,OAAO,MAAM,QAAA,CAAS,OAAA,CAAQ,MAAA,EAAQ,MAAM,CAAA;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,IAAA,EAAuB;AAClC,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AACrB,IAAA,IAAA,CAAK,QAAQ,KAAA,EAAM;AAAA,EACrB;AACF,CAAA;;;AC3EO,SAAS,yBAAyB,OAAA,EAA6B;AACpE,EAAA,OAAO,OACL,OAAA,EACA,MAAA,EACA,MAAA,KACqB;AACrB,IAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,OAAA,CAAQ,SAAS,MAAA,EAAQ,MAAA,IAAU,EAAE,CAAA;AAElE,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,MAAM,MAAA,CAAO,KAAA;AAAA,IACf;AAEA,IAAA,OAAO,MAAA,CAAO,IAAA;AAAA,EAChB,CAAA;AACF;;;ACbO,IAAM,4BAAN,MAAgC;AAAA,EAGrC,WAAA,GAAc;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,kBAAA,EAAmB;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAA,GAAyB;AACvB,IAAA,MAAM,MAAM,OAAA,CAAQ,GAAA;AAGpB,IAAA,IAAI,IAAI,iBAAA,EAAmB;AACzB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,QAAA,EAAU;AAAA,QAC/B,GAAA,EAAK;AAAA,UACH,mBAAmB,GAAA,CAAI;AAAA;AACzB,OACD,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,IAAI,eAAA,EAAiB;AACvB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,SAAA,EAAW;AAAA,QAChC,GAAA,EAAK;AAAA,UACH,iBAAiB,GAAA,CAAI;AAAA;AACvB,OACD,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,GAAA,CAAI,kBAAA,IAAsB,GAAA,CAAI,iBAAA,EAAmB;AACnD,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,QAAA,EAAU;AAAA,QAC/B,GAAA,EAAK;AAAA,UACH,oBAAoB,GAAA,CAAI,kBAAA;AAAA,UACxB,mBAAmB,GAAA,CAAI,iBAAA;AAAA,UACvB,mBAAA,EAAqB,IAAI,mBAAA,IAAuB;AAAA;AAClD,OACD,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,IAAI,gBAAA,EAAkB;AACxB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,OAAA,EAAS;AAAA,QAC9B,GAAA,EAAK;AAAA,UACH,QAAA,EAAU,UAAA;AAAA,UACV,kBAAkB,GAAA,CAAI,gBAAA;AAAA,UACtB,UAAA,EAAY,IAAI,UAAA,IAAc;AAAA;AAChC,OACD,CAAA;AAAA,IACH,CAAA,MAAA,IAES,IAAI,cAAA,EAAgB;AAC3B,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,OAAA,EAAS;AAAA,QAC9B,GAAA,EAAK;AAAA,UACH,QAAA,EAAU,QAAA;AAAA,UACV,gBAAgB,GAAA,CAAI,cAAA;AAAA,UACpB,UAAA,EAAY,IAAI,UAAA,IAAc;AAAA;AAChC,OACD,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,IAAI,iBAAA,EAAmB;AACzB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,KAAA,EAAO;AAAA,QAC5B,GAAA,EAAK;AAAA,UACH,QAAA,EAAU,WAAA;AAAA,UACV,mBAAmB,GAAA,CAAI;AAAA;AACzB,OACD,CAAA;AAAA,IACH,CAAA,MAAA,IAES,IAAI,cAAA,EAAgB;AAC3B,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,KAAA,EAAO;AAAA,QAC5B,GAAA,EAAK;AAAA,UACH,QAAA,EAAU,QAAA;AAAA,UACV,gBAAgB,GAAA,CAAI;AAAA;AACtB,OACD,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,IAAI,iBAAA,EAAmB;AACzB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,WAAA,EAAa;AAAA,QAClC,GAAA,EAAK;AAAA,UACH,mBAAmB,GAAA,CAAI,iBAAA;AAAA,UACvB,iBAAA,EAAmB,IAAI,iBAAA,IAAqB;AAAA;AAC9C,OACD,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,IAAI,YAAA,EAAc;AACpB,MAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,QAAA,EAAU;AAAA,QAC/B,GAAA,EAAK;AAAA,UACH,cAAc,GAAA,CAAI,YAAA;AAAA,UAClB,YAAA,EAAc,IAAI,YAAA,IAAgB,EAAA;AAAA,UAClC,WAAA,EAAa,IAAI,WAAA,IAAe,EAAA;AAAA,UAChC,eAAA,EAAiB,IAAI,eAAA,IAAmB;AAAA;AAC1C,OACD,CAAA;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,qBAAA,GAAwB;AACtB,IAAA,OAAO,wBAAA,CAAyB,KAAK,OAAO,CAAA;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAiC;AAC/B,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AACF","file":"index.js","sourcesContent":["import type { IntegrationConfig } from './types';\nimport { BaseIntegration } from './core/BaseIntegration';\n\n/**\n * Integration constructor type\n */\nexport type IntegrationConstructor = new (\n  config: IntegrationConfig,\n) => BaseIntegration;\n\n/**\n * Integration registry (populated as integrations are imported)\n */\nexport const INTEGRATION_REGISTRY: Record<string, IntegrationConstructor> = {};\n\n/**\n * Register an integration\n */\nexport function registerIntegration(\n  name: string,\n  constructor: IntegrationConstructor,\n): void {\n  INTEGRATION_REGISTRY[name] = constructor;\n}\n\n/**\n * Get integration constructor by name\n */\nexport function getIntegration(\n  name: string,\n): IntegrationConstructor | undefined {\n  return INTEGRATION_REGISTRY[name];\n}\n\n/**\n * Check if integration is known\n */\nexport function isKnownIntegration(name: string): boolean {\n  return name in INTEGRATION_REGISTRY;\n}\n\n/**\n * Get all registered integration names\n */\nexport function getRegisteredIntegrations(): string[] {\n  return Object.keys(INTEGRATION_REGISTRY);\n}\n","import type { IntegrationConfig, IntegrationResult } from './types';\nimport { BaseIntegration } from './core/BaseIntegration';\nimport { getIntegration } from './registry';\n\n/**\n * Factory for creating and managing integration instances\n */\nexport class IntegrationFactory {\n  private instances: Map<string, BaseIntegration> = new Map();\n  private configs: Map<string, IntegrationConfig> = new Map();\n\n  /**\n   * Configure an integration (doesn't instantiate yet)\n   */\n  configure(name: string, config: Omit<IntegrationConfig, 'name'>): void {\n    this.configs.set(name, { name, ...config });\n  }\n\n  /**\n   * Get or create an integration instance\n   */\n  get(name: string): BaseIntegration {\n    // Return existing instance\n    if (this.instances.has(name)) {\n      return this.instances.get(name)!;\n    }\n\n    // Get constructor\n    const Constructor = getIntegration(name);\n    if (!Constructor) {\n      throw new Error(`Unknown integration: ${name}. Make sure it's imported.`);\n    }\n\n    // Get config\n    const config = this.configs.get(name);\n    if (!config) {\n      throw new Error(\n        `Integration not configured: ${name}. Call configure() first.`,\n      );\n    }\n\n    // Create instance\n    const instance = new Constructor(config);\n    this.instances.set(name, instance);\n\n    return instance;\n  }\n\n  /**\n   * Execute an action on an integration\n   */\n  async execute(\n    integration: string,\n    action: string,\n    params: Record<string, unknown>,\n  ): Promise<IntegrationResult> {\n    const instance = this.get(integration);\n    return await instance.execute(action, params);\n  }\n\n  /**\n   * Check if integration is configured\n   */\n  isConfigured(name: string): boolean {\n    return this.configs.has(name);\n  }\n\n  /**\n   * Clear all instances (useful for testing)\n   */\n  clear(): void {\n    this.instances.clear();\n  }\n\n  /**\n   * Clear all instances and configs\n   */\n  reset(): void {\n    this.instances.clear();\n    this.configs.clear();\n  }\n}\n\nlet _factory: IntegrationFactory | null = null;\n\nexport function getIntegrationFactory(): IntegrationFactory {\n  if (!_factory) {\n    _factory = new IntegrationFactory();\n  }\n  return _factory;\n}\n\nexport function resetIntegrationFactory(): void {\n  _factory?.reset();\n  _factory = null;\n}\n","import { IntegrationFactory } from '../factory';\nimport type { IntegrationResult } from '../types';\n\n/**\n * Create a callService effect handler for @almadar/runtime\n */\nexport function createCallServiceHandler(factory: IntegrationFactory) {\n  return async (\n    service: string,\n    action: string,\n    params: Record<string, unknown> | undefined,\n  ): Promise<unknown> => {\n    const result = await factory.execute(service, action, params || {});\n\n    if (!result.success) {\n      throw result.error;\n    }\n\n    return result.data;\n  };\n}\n","import { IntegrationFactory } from '../factory';\nimport { createCallServiceHandler } from './effectHandler';\n\n/**\n * Runtime integration manager\n * Auto-configures integrations from environment variables\n */\nexport class RuntimeIntegrationManager {\n  private factory: IntegrationFactory;\n\n  constructor() {\n    this.factory = new IntegrationFactory();\n  }\n\n  /**\n   * Configure from environment variables\n   */\n  configureFromEnv(): void {\n    const env = process.env;\n\n    // Stripe\n    if (env.STRIPE_SECRET_KEY) {\n      this.factory.configure('stripe', {\n        env: {\n          STRIPE_SECRET_KEY: env.STRIPE_SECRET_KEY,\n        },\n      });\n    }\n\n    // YouTube\n    if (env.YOUTUBE_API_KEY) {\n      this.factory.configure('youtube', {\n        env: {\n          YOUTUBE_API_KEY: env.YOUTUBE_API_KEY,\n        },\n      });\n    }\n\n    // Twilio\n    if (env.TWILIO_ACCOUNT_SID && env.TWILIO_AUTH_TOKEN) {\n      this.factory.configure('twilio', {\n        env: {\n          TWILIO_ACCOUNT_SID: env.TWILIO_ACCOUNT_SID,\n          TWILIO_AUTH_TOKEN: env.TWILIO_AUTH_TOKEN,\n          TWILIO_PHONE_NUMBER: env.TWILIO_PHONE_NUMBER || '',\n        },\n      });\n    }\n\n    // Email (SendGrid)\n    if (env.SENDGRID_API_KEY) {\n      this.factory.configure('email', {\n        env: {\n          PROVIDER: 'sendgrid',\n          SENDGRID_API_KEY: env.SENDGRID_API_KEY,\n          FROM_EMAIL: env.FROM_EMAIL || 'noreply@example.com',\n        },\n      });\n    }\n    // Email (Resend)\n    else if (env.RESEND_API_KEY) {\n      this.factory.configure('email', {\n        env: {\n          PROVIDER: 'resend',\n          RESEND_API_KEY: env.RESEND_API_KEY,\n          FROM_EMAIL: env.FROM_EMAIL || 'noreply@example.com',\n        },\n      });\n    }\n\n    // LLM (Anthropic)\n    if (env.ANTHROPIC_API_KEY) {\n      this.factory.configure('llm', {\n        env: {\n          PROVIDER: 'anthropic',\n          ANTHROPIC_API_KEY: env.ANTHROPIC_API_KEY,\n        },\n      });\n    }\n    // LLM (OpenAI)\n    else if (env.OPENAI_API_KEY) {\n      this.factory.configure('llm', {\n        env: {\n          PROVIDER: 'openai',\n          OPENAI_API_KEY: env.OPENAI_API_KEY,\n        },\n      });\n    }\n\n    // DeepAgent\n    if (env.DEEPAGENT_API_URL) {\n      this.factory.configure('deepagent', {\n        env: {\n          DEEPAGENT_API_URL: env.DEEPAGENT_API_URL,\n          DEEPAGENT_API_KEY: env.DEEPAGENT_API_KEY || '',\n        },\n      });\n    }\n\n    // GitHub\n    if (env.GITHUB_TOKEN) {\n      this.factory.configure('github', {\n        env: {\n          GITHUB_TOKEN: env.GITHUB_TOKEN,\n          GITHUB_OWNER: env.GITHUB_OWNER || '',\n          GITHUB_REPO: env.GITHUB_REPO || '',\n          GITHUB_WORK_DIR: env.GITHUB_WORK_DIR || '',\n        },\n      });\n    }\n  }\n\n  /**\n   * Get effect handler for runtime\n   */\n  getCallServiceHandler() {\n    return createCallServiceHandler(this.factory);\n  }\n\n  /**\n   * Get factory (for advanced usage)\n   */\n  getFactory(): IntegrationFactory {\n    return this.factory;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/registry.ts","../../src/factory.ts","../../src/core/logger.ts","../../src/core/validation.ts","../../src/core/retry.ts","../../src/core/BaseIntegration.ts","../../src/types.ts","../../src/mocks/MockIntegration.ts","../../src/runtime/effectHandler.ts","../../src/runtime/RuntimeIntegrationManager.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { IntegrationConfig } from './types';\nimport { BaseIntegration } from './core/BaseIntegration';\n\n/**\n * Integration constructor type\n */\nexport type IntegrationConstructor = new (\n  config: IntegrationConfig,\n) => BaseIntegration;\n\n/**\n * Integration registry (populated as integrations are imported)\n */\nexport const INTEGRATION_REGISTRY: Record<string, IntegrationConstructor> = {};\n\n/**\n * Register an integration\n */\nexport function registerIntegration(\n  name: string,\n  constructor: IntegrationConstructor,\n): void {\n  INTEGRATION_REGISTRY[name] = constructor;\n}\n\n/**\n * Get integration constructor by name\n */\nexport function getIntegration(\n  name: string,\n): IntegrationConstructor | undefined {\n  return INTEGRATION_REGISTRY[name];\n}\n\n/**\n * Check if integration is known\n */\nexport function isKnownIntegration(name: string): boolean {\n  return name in INTEGRATION_REGISTRY;\n}\n\n/**\n * Get all registered integration names\n */\nexport function getRegisteredIntegrations(): string[] {\n  return Object.keys(INTEGRATION_REGISTRY);\n}\n","import type { IntegrationConfig, IntegrationResult } from './types';\nimport { BaseIntegration } from './core/BaseIntegration';\nimport { getIntegration } from './registry';\n\n/**\n * Factory for creating and managing integration instances\n */\nexport class IntegrationFactory {\n  private instances: Map<string, BaseIntegration> = new Map();\n  private configs: Map<string, IntegrationConfig> = new Map();\n\n  /**\n   * Configure an integration (doesn't instantiate yet)\n   */\n  configure(name: string, config: Omit<IntegrationConfig, 'name'>): void {\n    this.configs.set(name, { name, ...config });\n  }\n\n  /**\n   * Get or create an integration instance\n   */\n  get(name: string): BaseIntegration {\n    // Return existing instance\n    if (this.instances.has(name)) {\n      return this.instances.get(name)!;\n    }\n\n    // Get constructor\n    const Constructor = getIntegration(name);\n    if (!Constructor) {\n      throw new Error(`Unknown integration: ${name}. Make sure it's imported.`);\n    }\n\n    // Get config\n    const config = this.configs.get(name);\n    if (!config) {\n      throw new Error(\n        `Integration not configured: ${name}. Call configure() first.`,\n      );\n    }\n\n    // Create instance\n    const instance = new Constructor(config);\n    this.instances.set(name, instance);\n\n    return instance;\n  }\n\n  /**\n   * Execute an action on an integration\n   */\n  async execute(\n    integration: string,\n    action: string,\n    params: Record<string, unknown>,\n  ): Promise<IntegrationResult> {\n    const instance = this.get(integration);\n    return await instance.execute(action, params);\n  }\n\n  /**\n   * Check if integration is configured\n   */\n  isConfigured(name: string): boolean {\n    return this.configs.has(name);\n  }\n\n  /**\n   * Clear all instances (useful for testing)\n   */\n  clear(): void {\n    this.instances.clear();\n  }\n\n  /**\n   * Clear all instances and configs\n   */\n  reset(): void {\n    this.instances.clear();\n    this.configs.clear();\n  }\n}\n\nlet _factory: IntegrationFactory | null = null;\n\nexport function getIntegrationFactory(): IntegrationFactory {\n  if (!_factory) {\n    _factory = new IntegrationFactory();\n  }\n  return _factory;\n}\n\nexport function resetIntegrationFactory(): void {\n  _factory?.reset();\n  _factory = null;\n}\n","import { IntegrationLogger } from '../types';\n\n/**\n * Console-based logger implementation\n */\nexport class ConsoleLogger implements IntegrationLogger {\n  private level: 'debug' | 'info' | 'warn' | 'error';\n\n  constructor(level: 'debug' | 'info' | 'warn' | 'error' = 'info') {\n    this.level = level;\n  }\n\n  debug(message: string, meta?: Record<string, unknown>): void {\n    if (this.shouldLog('debug')) {\n      console.debug(`[DEBUG] ${message}`, meta || '');\n    }\n  }\n\n  info(message: string, meta?: Record<string, unknown>): void {\n    if (this.shouldLog('info')) {\n      console.log(`[INFO] ${message}`, meta || '');\n    }\n  }\n\n  warn(message: string, meta?: Record<string, unknown>): void {\n    if (this.shouldLog('warn')) {\n      console.warn(`[WARN] ${message}`, meta || '');\n    }\n  }\n\n  error(message: string, meta?: Record<string, unknown>): void {\n    if (this.shouldLog('error')) {\n      console.error(`[ERROR] ${message}`, meta || '');\n    }\n  }\n\n  private shouldLog(level: string): boolean {\n    const levels = ['debug', 'info', 'warn', 'error'];\n    return levels.indexOf(level) >= levels.indexOf(this.level);\n  }\n}\n","import type { ValidationResult, ValidationError } from '../types';\n\n// Import integrators registry from the package main export (JSON is inlined in the bundle)\nimport { integratorsRegistry } from '@almadar/patterns';\n\ninterface ActionParam {\n  name: string;\n  type: string;\n  required?: boolean;\n  description?: string;\n}\n\ninterface ActionDef {\n  name: string;\n  description?: string;\n  params: ActionParam[];\n}\n\ninterface IntegratorEntry {\n  name: string;\n  description?: string;\n  category?: string;\n  actions: ActionDef[];\n}\n\ntype IntegratorsRegistry = Record<string, {\n  version?: string;\n  exportedAt?: string;\n  integrators: Record<string, IntegratorEntry>;\n}>;\n\n/**\n * Validate action params against registry schema\n */\nexport function validateParams(\n  integration: string,\n  action: string,\n  params: Record<string, unknown>,\n): ValidationResult {\n  const typedRegistry = integratorsRegistry as unknown as IntegratorsRegistry[string];\n  const registry = typedRegistry.integrators[integration];\n\n  if (!registry) {\n    return {\n      valid: false,\n      errors: [\n        {\n          param: 'integration',\n          message: `Unknown integration: ${integration}`,\n        },\n      ],\n    };\n  }\n\n  const actionDef = registry.actions.find((a: ActionDef) => a.name === action);\n\n  if (!actionDef) {\n    return {\n      valid: false,\n      errors: [{ param: 'action', message: `Unknown action: ${action}` }],\n    };\n  }\n\n  const errors: ValidationError[] = [];\n\n  // Check required params\n  for (const paramDef of actionDef.params) {\n    if (paramDef.required && !(paramDef.name in params)) {\n      errors.push({\n        param: paramDef.name,\n        message: `Missing required parameter: ${paramDef.name}`,\n      });\n    }\n\n    // Type validation\n    if (paramDef.name in params) {\n      const value = params[paramDef.name];\n      const expectedType = paramDef.type;\n      const actualType = typeof value;\n\n      if (expectedType === 'number' && actualType !== 'number') {\n        errors.push({\n          param: paramDef.name,\n          message: `Expected ${expectedType}, got ${actualType}`,\n        });\n      }\n\n      if (expectedType === 'string' && actualType !== 'string') {\n        errors.push({\n          param: paramDef.name,\n          message: `Expected ${expectedType}, got ${actualType}`,\n        });\n      }\n\n      if (expectedType === 'array' && !Array.isArray(value)) {\n        errors.push({\n          param: paramDef.name,\n          message: `Expected array, got ${actualType}`,\n        });\n      }\n\n      if (\n        expectedType === 'object' &&\n        (actualType !== 'object' || Array.isArray(value) || value === null)\n      ) {\n        errors.push({\n          param: paramDef.name,\n          message: `Expected object, got ${actualType}`,\n        });\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n","import type { IntegrationError, IntegrationErrorCode } from '../types';\n\n/**\n * Retry configuration\n */\nexport interface RetryConfig {\n  maxAttempts: number;\n  backoffMs: number;\n  maxBackoffMs?: number;\n  retryableErrors?: IntegrationErrorCode[];\n}\n\n/**\n * Execute a function with retry logic\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  config: RetryConfig,\n): Promise<T> {\n  const {\n    maxAttempts,\n    backoffMs,\n    maxBackoffMs = 30000,\n    retryableErrors,\n  } = config;\n\n  let lastError: unknown;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error;\n\n      // Check if error is retryable\n      if (\n        error &&\n        typeof error === 'object' &&\n        'code' in error &&\n        retryableErrors\n      ) {\n        const integrationError = error as IntegrationError;\n        if (!retryableErrors.includes(integrationError.code)) {\n          throw error;\n        }\n      }\n\n      // Last attempt, throw\n      if (attempt === maxAttempts) {\n        throw error;\n      }\n\n      // Wait before retry (exponential backoff)\n      const delay = Math.min(\n        backoffMs * Math.pow(2, attempt - 1),\n        maxBackoffMs,\n      );\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n\n  throw lastError;\n}\n","import type {\n  IntegrationConfig,\n  IntegrationResult,\n  IntegrationLogger,\n  IntegrationError,\n} from '../types';\nimport { ConsoleLogger } from './logger';\nimport { validateParams } from './validation';\nimport { withRetry } from './retry';\n\n/**\n * Base class for all integrations\n */\nexport abstract class BaseIntegration {\n  protected config: IntegrationConfig;\n  protected logger: IntegrationLogger;\n\n  constructor(config: IntegrationConfig) {\n    this.config = config;\n    this.logger = config.logger || new ConsoleLogger();\n  }\n\n  /**\n   * Execute an action\n   */\n  abstract execute(\n    action: string,\n    params: Record<string, unknown>,\n  ): Promise<IntegrationResult>;\n\n  /**\n   * Validate action params against registry\n   */\n  protected validateParams(\n    action: string,\n    params: Record<string, unknown>,\n  ): ReturnType<typeof validateParams> {\n    return validateParams(this.config.name, action, params);\n  }\n\n  /**\n   * Handle errors uniformly\n   */\n  protected handleError(action: string, error: unknown): IntegrationResult {\n    this.logger.error(`Integration error in ${this.config.name}.${action}`, {\n      error,\n    });\n\n    const integrationError =\n      error instanceof Error\n        ? error\n        : new Error(String(error));\n\n    return {\n      success: false,\n      error: integrationError as IntegrationError,\n      metadata: this.createMetadata(action, 0, 0),\n    };\n  }\n\n  /**\n   * Create metadata for result\n   */\n  protected createMetadata(\n    action: string,\n    duration: number,\n    retries: number = 0,\n  ): IntegrationResult['metadata'] {\n    return {\n      integration: this.config.name,\n      action,\n      duration,\n      retries,\n      timestamp: Date.now(),\n    };\n  }\n\n  /**\n   * Execute with retry logic\n   */\n  protected async executeWithRetry<T>(\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    if (!this.config.retry) {\n      return fn();\n    }\n\n    return withRetry(fn, {\n      maxAttempts: this.config.retry.maxAttempts,\n      backoffMs: this.config.retry.backoffMs,\n      maxBackoffMs: this.config.retry.maxBackoffMs,\n      retryableErrors: [\n        'TIMEOUT_ERROR',\n        'NETWORK_ERROR',\n        'RATE_LIMIT_ERROR',\n      ],\n    });\n  }\n}\n","/**\n * Core types for Almadar integrations\n */\n\n/**\n * Configuration for an integration instance\n */\nexport interface IntegrationConfig {\n  /** Integration name (matches registry) */\n  name: string;\n\n  /** Environment variables (API keys, secrets) */\n  env: Record<string, string>;\n\n  /** Optional logger */\n  logger?: IntegrationLogger;\n\n  /** Optional rate limiting config */\n  rateLimit?: {\n    requestsPerSecond: number;\n    burstSize: number;\n  };\n\n  /** Optional timeout (ms) */\n  timeout?: number;\n\n  /** Optional retry config */\n  retry?: {\n    maxAttempts: number;\n    backoffMs: number;\n    maxBackoffMs?: number;\n  };\n}\n\n/**\n * Result of an integration action call\n */\nexport interface IntegrationResult<T = unknown> {\n  /** Success flag */\n  success: boolean;\n\n  /** Response data (on success) */\n  data?: T;\n\n  /** Error (on failure) */\n  error?: IntegrationError;\n\n  /** Metadata (timing, retries, etc.) */\n  metadata: {\n    integration: string;\n    action: string;\n    duration: number;\n    retries: number;\n    timestamp: number;\n  };\n}\n\n/**\n * Integration error codes\n */\nexport type IntegrationErrorCode =\n  | 'VALIDATION_ERROR'\n  | 'AUTH_ERROR'\n  | 'RATE_LIMIT_ERROR'\n  | 'TIMEOUT_ERROR'\n  | 'NETWORK_ERROR'\n  | 'SERVICE_ERROR'\n  | 'UNKNOWN_ERROR';\n\n/**\n * Integration error\n */\nexport class IntegrationError extends Error {\n  code: IntegrationErrorCode;\n  integration?: string;\n  action?: string;\n  details?: unknown;\n\n  constructor(\n    message: string,\n    code: IntegrationErrorCode = 'UNKNOWN_ERROR',\n    details?: unknown,\n  ) {\n    super(message);\n    this.name = 'IntegrationError';\n    this.code = code;\n    this.details = details;\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      integration: this.integration,\n      action: this.action,\n      details: this.details,\n    };\n  }\n}\n\n/**\n * Logger interface\n */\nexport interface IntegrationLogger {\n  debug(message: string, meta?: Record<string, unknown>): void;\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: ValidationError[];\n}\n\n/**\n * Validation error\n */\nexport interface ValidationError {\n  param: string;\n  message: string;\n}\n","import { BaseIntegration } from '../core/BaseIntegration';\nimport type { IntegrationConfig, IntegrationResult } from '../types';\nimport { IntegrationError } from '../types';\n\n/**\n * Mock integration for testing\n */\nexport class MockIntegration extends BaseIntegration {\n  private responses: Map<string, unknown> = new Map();\n  private calls: Array<{ action: string; params: Record<string, unknown> }> =\n    [];\n\n  constructor(config: IntegrationConfig) {\n    super(config);\n  }\n\n  /**\n   * Set mock response for an action\n   */\n  setResponse(action: string, data: unknown): void {\n    this.responses.set(action, data);\n  }\n\n  /**\n   * Get all calls made to this integration\n   */\n  getCalls(): Array<{ action: string; params: Record<string, unknown> }> {\n    return this.calls;\n  }\n\n  /**\n   * Clear all calls\n   */\n  clearCalls(): void {\n    this.calls = [];\n  }\n\n  async execute(\n    action: string,\n    params: Record<string, unknown>,\n  ): Promise<IntegrationResult> {\n    // Record the call\n    this.calls.push({ action, params });\n\n    const data = this.responses.get(action);\n\n    if (!data) {\n      return {\n        success: false,\n        error: new IntegrationError(\n          `No mock response for action: ${action}`,\n          'UNKNOWN_ERROR',\n        ),\n        metadata: this.createMetadata(action, 0),\n      };\n    }\n\n    return {\n      success: true,\n      data,\n      metadata: this.createMetadata(action, 0),\n    };\n  }\n}\n","import { IntegrationFactory } from '../factory';\nimport type { IntegrationResult } from '../types';\n\n/**\n * Create a callService effect handler for @almadar/runtime\n */\nexport function createCallServiceHandler(factory: IntegrationFactory) {\n  return async (\n    service: string,\n    action: string,\n    params: Record<string, unknown> | undefined,\n  ): Promise<unknown> => {\n    const result = await factory.execute(service, action, params || {});\n\n    if (!result.success) {\n      throw result.error;\n    }\n\n    return result.data;\n  };\n}\n","import { createRequire } from 'node:module';\nimport { IntegrationFactory } from '../factory';\nimport { MockIntegration } from '../mocks/MockIntegration';\nimport { createCallServiceHandler } from './effectHandler';\nimport type { IntegrationResult } from '../types';\n\n/**\n * Generate mock data from a responseShape definition.\n * Maps type strings to realistic placeholder values.\n */\nfunction generateMockFromShape(shape: Record<string, string>): Record<string, unknown> {\n  const data: Record<string, unknown> = {};\n  for (const [key, type] of Object.entries(shape)) {\n    switch (type) {\n      case 'string': data[key] = `mock_${key}`; break;\n      case 'number': data[key] = 42; break;\n      case 'boolean': data[key] = true; break;\n      case 'object': data[key] = {}; break;\n      case 'string[]': data[key] = []; break;\n      default: data[key] = `mock_${key}`;\n    }\n  }\n  return data;\n}\n\n/**\n * Runtime integration manager\n * Auto-configures integrations from environment variables.\n * When USE_MOCK_DATA=true, registers mock integrations for all services\n * using response shapes from services-registry.json.\n */\nexport class RuntimeIntegrationManager {\n  private factory: IntegrationFactory;\n\n  constructor() {\n    this.factory = new IntegrationFactory();\n  }\n\n  /**\n   * Configure from environment variables.\n   * In mock mode (USE_MOCK_DATA=true), all services return realistic mock data.\n   */\n  configureFromEnv(): void {\n    const env = process.env;\n\n    if (env.USE_MOCK_DATA === 'true') {\n      this.configureMockMode();\n      return;\n    }\n\n    // Stripe\n    if (env.STRIPE_SECRET_KEY) {\n      this.factory.configure('stripe', {\n        env: {\n          STRIPE_SECRET_KEY: env.STRIPE_SECRET_KEY,\n        },\n      });\n    }\n\n    // YouTube\n    if (env.YOUTUBE_API_KEY) {\n      this.factory.configure('youtube', {\n        env: {\n          YOUTUBE_API_KEY: env.YOUTUBE_API_KEY,\n        },\n      });\n    }\n\n    // Twilio\n    if (env.TWILIO_ACCOUNT_SID && env.TWILIO_AUTH_TOKEN) {\n      this.factory.configure('twilio', {\n        env: {\n          TWILIO_ACCOUNT_SID: env.TWILIO_ACCOUNT_SID,\n          TWILIO_AUTH_TOKEN: env.TWILIO_AUTH_TOKEN,\n          TWILIO_PHONE_NUMBER: env.TWILIO_PHONE_NUMBER || '',\n        },\n      });\n    }\n\n    // Email (SendGrid)\n    if (env.SENDGRID_API_KEY) {\n      this.factory.configure('email', {\n        env: {\n          PROVIDER: 'sendgrid',\n          SENDGRID_API_KEY: env.SENDGRID_API_KEY,\n          FROM_EMAIL: env.FROM_EMAIL || 'noreply@example.com',\n        },\n      });\n    }\n    // Email (Resend)\n    else if (env.RESEND_API_KEY) {\n      this.factory.configure('email', {\n        env: {\n          PROVIDER: 'resend',\n          RESEND_API_KEY: env.RESEND_API_KEY,\n          FROM_EMAIL: env.FROM_EMAIL || 'noreply@example.com',\n        },\n      });\n    }\n\n    // LLM (Anthropic)\n    if (env.ANTHROPIC_API_KEY) {\n      this.factory.configure('llm', {\n        env: {\n          PROVIDER: 'anthropic',\n          ANTHROPIC_API_KEY: env.ANTHROPIC_API_KEY,\n        },\n      });\n    }\n    // LLM (OpenAI)\n    else if (env.OPENAI_API_KEY) {\n      this.factory.configure('llm', {\n        env: {\n          PROVIDER: 'openai',\n          OPENAI_API_KEY: env.OPENAI_API_KEY,\n        },\n      });\n    }\n\n    // DeepAgent\n    if (env.DEEPAGENT_API_URL) {\n      this.factory.configure('deepagent', {\n        env: {\n          DEEPAGENT_API_URL: env.DEEPAGENT_API_URL,\n          DEEPAGENT_API_KEY: env.DEEPAGENT_API_KEY || '',\n        },\n      });\n    }\n\n    // GitHub\n    if (env.GITHUB_TOKEN) {\n      this.factory.configure('github', {\n        env: {\n          GITHUB_TOKEN: env.GITHUB_TOKEN,\n          GITHUB_OWNER: env.GITHUB_OWNER || '',\n          GITHUB_REPO: env.GITHUB_REPO || '',\n          GITHUB_WORK_DIR: env.GITHUB_WORK_DIR || '',\n        },\n      });\n    }\n  }\n\n  /**\n   * Configure mock mode: register MockIntegration for all known services\n   * with auto-generated responses from the services registry.\n   */\n  private configureMockMode(): void {\n    // Load registry and populate mocks\n    const registry = this.loadServicesRegistry();\n\n    for (const [serviceName, service] of Object.entries(registry)) {\n      const mock = new MockIntegration({ name: serviceName, env: {} });\n\n      for (const action of service.actions) {\n        if (action.responseShape && Object.keys(action.responseShape).length > 0) {\n          mock.setResponse(action.name, generateMockFromShape(action.responseShape));\n        } else {\n          // No responseShape defined: return generic success\n          mock.setResponse(action.name, { success: true, _mock: true, _action: action.name });\n        }\n      }\n\n      this.factory.configure(serviceName, { env: {} });\n      // Inject mock instance directly into the factory\n      (this.factory as unknown as { instances: Map<string, unknown> }).instances.set(serviceName, mock);\n    }\n\n    // Wrap factory.execute with a fallback for unknown services (e.g., custom-bearer-api).\n    // Unknown services return an echo response with the input params.\n    const originalExecute = this.factory.execute.bind(this.factory);\n    this.factory.execute = async (\n      integration: string,\n      action: string,\n      params: Record<string, unknown>,\n    ): Promise<IntegrationResult> => {\n      try {\n        return await originalExecute(integration, action, params);\n      } catch {\n        // Unknown/unconfigured service in mock mode: echo params\n        return {\n          success: true,\n          data: { ...params, _mock: true, _service: integration, _action: action },\n          metadata: { integration, action, duration: 0, retries: 0, timestamp: Date.now() },\n        };\n      }\n    };\n  }\n\n  /**\n   * Load services registry from @almadar/patterns.\n   * Returns a map of service name to { actions: [...] }.\n   */\n  private loadServicesRegistry(): Record<string, { actions: Array<{ name: string; responseShape: Record<string, string> }> }> {\n    try {\n      const esmRequire = createRequire(import.meta.url);\n      const registry = esmRequire('@almadar/patterns/services-registry.json') as {\n        services: Record<string, { actions: Array<{ name: string; responseShape: Record<string, string> }> }>;\n      };\n      return registry.services;\n    } catch {\n      // Registry not available (e.g., not installed). Return empty - fallback mock handles everything.\n      return {};\n    }\n  }\n\n  /**\n   * Get effect handler for runtime\n   */\n  getCallServiceHandler() {\n    return createCallServiceHandler(this.factory);\n  }\n\n  /**\n   * Get factory (for advanced usage)\n   */\n  getFactory(): IntegrationFactory {\n    return this.factory;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/integrations",
-  "version": "2.2.1",
+  "version": "2.4.0",
   "description": "External service integrations for Almadar applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@almadar/core": ">=2.1.0",
-    "@almadar/llm": ">=2.5.0",
+    "@almadar/llm": ">=2.5.1",
     "@almadar/patterns": ">=2.0.0",
     "@sendgrid/mail": "^8.1.4",
     "dotenv": "^16.4.0",
@@ -58,7 +58,7 @@
     "url": "https://github.com/almadar-io/almadar-integrations.git",
     "directory": "docs/packages/integrations"
   },
-  "license": "MIT",
+  "license": "BSL-1.1",
   "keywords": [
     "almadar",
     "integrations",