@almadar/integrations 2.23.0 → 2.25.0

package/dist/mocks/index.d.ts

@@ -1,5 +1,5 @@
 import { B as BaseIntegration, I as IntegrationConfig, e as IntegrationParams, f as IntegrationResult } from '../BaseIntegration-MA-b4fh8.js';
-import { I as IntegrationFactory } from '../factory-DTdVeyAi.js';
+import { a as IntegrationFactory } from '../factory-BPVhvv5q.js';
 import '@almadar/core';
 
 /**

package/dist/mocks/index.js

@@ -251,56 +251,80 @@ function getIntegration(name) {
 }
 
 // src/factory.ts
+function instanceKey(name, principal) {
+  return principal ? `${name}\0${principal}` : name;
+}
 var IntegrationFactory = class {
   constructor() {
     this.instances = /* @__PURE__ */ new Map();
     this.configs = /* @__PURE__ */ new Map();
   }
   /**
-   * Configure an integration (doesn't instantiate yet)
+   * Configure an integration (doesn't instantiate yet). A `principal` scopes
+   * the config to that principal; the app-wide config (no principal) is the
+   * fallback for every principal.
    */
-  configure(name, config) {
-    this.configs.set(name, { name, ...config });
+  configure(name, config, principal) {
+    this.configs.set(instanceKey(name, principal), { name, ...config });
   }
   /**
-   * Get or create an integration instance
+   * Get or create an integration instance. Principal-scoped lookups fall
+   * back to the app-wide config when no per-principal config exists.
    */
-  get(name) {
-    if (this.instances.has(name)) {
-      return this.instances.get(name);
+  get(name, principal) {
+    const key = instanceKey(name, principal);
+    const cached = this.instances.get(key);
+    if (cached) {
+      return cached;
     }
     const Constructor = getIntegration(name);
     if (!Constructor) {
       throw new Error(`Unknown integration: ${name}. Make sure it's imported.`);
     }
-    const config = this.configs.get(name);
+    const config = this.configs.get(key) ?? this.configs.get(name);
     if (!config) {
       throw new Error(
         `Integration not configured: ${name}. Call configure() first.`
       );
     }
     const instance = new Constructor(config);
-    this.instances.set(name, instance);
+    this.instances.set(key, instance);
     return instance;
   }
   /**
    * Execute an action on an integration
    */
-  async execute(integration, action, params) {
-    const instance = this.get(integration);
+  async execute(integration, action, params, context) {
+    const instance = this.get(integration, context?.principal);
     return await instance.execute(action, params);
   }
   /**
    * Check if integration is configured
    */
-  isConfigured(name) {
-    return this.configs.has(name);
+  isConfigured(name, principal) {
+    return this.configs.has(instanceKey(name, principal)) || this.configs.has(name);
   }
   /**
    * Register an integration instance directly (used by mock infrastructure)
    */
-  registerInstance(name, instance) {
-    this.instances.set(name, instance);
+  registerInstance(name, instance, principal) {
+    this.instances.set(instanceKey(name, principal), instance);
+  }
+  /**
+   * Drop the cached instance(s) for a name so the next `get` rebuilds from
+   * the current config — how a credential change goes live without restart.
+   * Configs are kept; without a name, every instance is dropped.
+   */
+  invalidate(name) {
+    if (name === void 0) {
+      this.instances.clear();
+      return;
+    }
+    for (const key of this.instances.keys()) {
+      if (key === name || key.startsWith(`${name}\0`)) {
+        this.instances.delete(key);
+      }
+    }
   }
   /**
    * Clear all instances (useful for testing)

package/dist/mocks/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/logger.ts","../../src/core/validation.ts","../../src/core/retry.ts","../../src/core/BaseIntegration.ts","../../src/types.ts","../../src/mocks/MockIntegration.ts","../../src/registry.ts","../../src/factory.ts","../../src/mocks/MockIntegrationFactory.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { createLogger, type Logger } from '@almadar/logger';\nimport type { IntegrationLogger, LogMeta } from '../types';\n\n/**\n * Console-based logger implementation.\n *\n * Routes through `@almadar/logger`'s shared gate so namespace filtering\n * (`ALMADAR_DEBUG`, `globalThis.__ALMADAR_DEBUG__`) and the production\n * level default (WARN+) apply uniformly with the rest of `@almadar/*`.\n *\n * The constructor's `level` argument is retained for backwards\n * compatibility but is now a no-op — the active level is owned by the\n * shared logger (compile-time + env). To filter integration logs at\n * runtime, set `globalThis.__ALMADAR_DEBUG__ = 'almadar:integrations:*'`.\n */\nexport class ConsoleLogger implements IntegrationLogger {\n  private readonly log: Logger;\n\n  constructor(_level: 'debug' | 'info' | 'warn' | 'error' = 'info') {\n    void _level;\n    this.log = createLogger('almadar:integrations');\n  }\n\n  debug(message: string, meta?: LogMeta): void {\n    this.log.debug(message, meta);\n  }\n  info(message: string, meta?: LogMeta): void {\n    this.log.info(message, meta);\n  }\n  warn(message: string, meta?: LogMeta): void {\n    this.log.warn(message, meta);\n  }\n  error(message: string, meta?: LogMeta): void {\n    this.log.error(message, meta);\n  }\n}\n","import type { ValidationResult, ValidationError, IntegrationParams } from '../types';\n\n// Import integrators registry from the package main export (JSON is inlined in the bundle)\nimport { integratorsRegistry } from '@almadar/core/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: IntegrationParams,\n): ValidationResult {\n  const typedRegistry = integratorsRegistry 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  IntegrationParams,\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: IntegrationParams,\n  ): Promise<IntegrationResult>;\n\n  /**\n   * Validate action params against registry\n   */\n  protected validateParams(\n    action: string,\n    params: IntegrationParams,\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: error instanceof Error ? error : new Error(String(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\nimport type { LogMeta } from '@almadar/core';\n\n/** Re-export LogMeta from @almadar/core as the canonical log metadata type. */\nexport type { LogMeta };\n\n/**\n * Logger interface\n */\nexport interface IntegrationLogger {\n  debug(message: string, meta?: LogMeta): void;\n  info(message: string, meta?: LogMeta): void;\n  warn(message: string, meta?: LogMeta): void;\n  error(message: string, meta?: LogMeta): void;\n}\n\n/**\n * Integration action parameters.\n * Each integration's execute() method receives params as this type.\n * Individual methods cast to specific param shapes from their contracts.\n *\n * Per-key value union is widened to admit `@almadar/core`'s `FieldValue`\n * shape (entity / payload values flowing into call-service args): `Date`\n * for date fields, `IntegrationParams[]` for nested object arrays, and a\n * raw-value array catch-all so `string[]` / `number[]` / mixed payload\n * arrays satisfy the index signature without requiring `as unknown as`\n * casts at the call site. Adapters narrow these to their canonical input\n * types (typically JSON-string serialisation for `Date`).\n */\nexport type IntegrationParamValue =\n  | string\n  | number\n  | boolean\n  | Date\n  | null\n  | undefined\n  | ReadonlyArray<IntegrationParamValue>\n  | { readonly [key: string]: IntegrationParamValue };\n\nexport interface IntegrationParams {\n  [key: string]: IntegrationParamValue;\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, IntegrationParams } 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: IntegrationParams }> =\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: IntegrationParams }> {\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: IntegrationParams,\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 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, IntegrationParams } 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: IntegrationParams,\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   * Register an integration instance directly (used by mock infrastructure)\n   */\n  registerInstance(name: string, instance: BaseIntegration): void {\n    this.instances.set(name, instance);\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 { MockIntegration } from './MockIntegration';\nimport { registerIntegration } from '../registry';\nimport type { IntegrationParams } from '../types';\n\n/**\n * Mock integration factory for testing\n */\nexport class MockIntegrationFactory extends IntegrationFactory {\n  constructor() {\n    super();\n    \n    // Register mock integration for all known services\n    const services = ['stripe', 'youtube', 'twilio', 'email', 'llm', 'deepagent'];\n    services.forEach((service) => {\n      registerIntegration(`mock-${service}`, MockIntegration);\n      \n      // Configure with mock config\n      this.configure(service, {\n        env: {},\n      });\n    });\n  }\n\n  /**\n   * Set mock response for an integration action\n   */\n  setMockResponse(integration: string, action: string, data: unknown): void {\n    const instance = this.get(integration) as MockIntegration;\n    instance.setResponse(action, data);\n  }\n\n  /**\n   * Get calls made to an integration\n   */\n  getMockCalls(\n    integration: string,\n  ): Array<{ action: string; params: IntegrationParams }> {\n    const instance = this.get(integration) as MockIntegration;\n    return instance.getCalls();\n  }\n\n  /**\n   * Clear calls for an integration\n   */\n  clearMockCalls(integration: string): void {\n    const instance = this.get(integration) as MockIntegration;\n    instance.clearCalls();\n  }\n}\n"]}
+{"version":3,"sources":["../../src/core/logger.ts","../../src/core/validation.ts","../../src/core/retry.ts","../../src/core/BaseIntegration.ts","../../src/types.ts","../../src/mocks/MockIntegration.ts","../../src/registry.ts","../../src/factory.ts","../../src/mocks/MockIntegrationFactory.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { createLogger, type Logger } from '@almadar/logger';\nimport type { IntegrationLogger, LogMeta } from '../types';\n\n/**\n * Console-based logger implementation.\n *\n * Routes through `@almadar/logger`'s shared gate so namespace filtering\n * (`ALMADAR_DEBUG`, `globalThis.__ALMADAR_DEBUG__`) and the production\n * level default (WARN+) apply uniformly with the rest of `@almadar/*`.\n *\n * The constructor's `level` argument is retained for backwards\n * compatibility but is now a no-op — the active level is owned by the\n * shared logger (compile-time + env). To filter integration logs at\n * runtime, set `globalThis.__ALMADAR_DEBUG__ = 'almadar:integrations:*'`.\n */\nexport class ConsoleLogger implements IntegrationLogger {\n  private readonly log: Logger;\n\n  constructor(_level: 'debug' | 'info' | 'warn' | 'error' = 'info') {\n    void _level;\n    this.log = createLogger('almadar:integrations');\n  }\n\n  debug(message: string, meta?: LogMeta): void {\n    this.log.debug(message, meta);\n  }\n  info(message: string, meta?: LogMeta): void {\n    this.log.info(message, meta);\n  }\n  warn(message: string, meta?: LogMeta): void {\n    this.log.warn(message, meta);\n  }\n  error(message: string, meta?: LogMeta): void {\n    this.log.error(message, meta);\n  }\n}\n","import type { ValidationResult, ValidationError, IntegrationParams } from '../types';\n\n// Import integrators registry from the package main export (JSON is inlined in the bundle)\nimport { integratorsRegistry } from '@almadar/core/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: IntegrationParams,\n): ValidationResult {\n  const typedRegistry = integratorsRegistry 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  IntegrationParams,\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: IntegrationParams,\n  ): Promise<IntegrationResult>;\n\n  /**\n   * Validate action params against registry\n   */\n  protected validateParams(\n    action: string,\n    params: IntegrationParams,\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: error instanceof Error ? error : new Error(String(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\nimport type { LogMeta } from '@almadar/core';\n\n/** Re-export LogMeta from @almadar/core as the canonical log metadata type. */\nexport type { LogMeta };\n\n/**\n * Logger interface\n */\nexport interface IntegrationLogger {\n  debug(message: string, meta?: LogMeta): void;\n  info(message: string, meta?: LogMeta): void;\n  warn(message: string, meta?: LogMeta): void;\n  error(message: string, meta?: LogMeta): void;\n}\n\n/**\n * Integration action parameters.\n * Each integration's execute() method receives params as this type.\n * Individual methods cast to specific param shapes from their contracts.\n *\n * Per-key value union is widened to admit `@almadar/core`'s `FieldValue`\n * shape (entity / payload values flowing into call-service args): `Date`\n * for date fields, `IntegrationParams[]` for nested object arrays, and a\n * raw-value array catch-all so `string[]` / `number[]` / mixed payload\n * arrays satisfy the index signature without requiring `as unknown as`\n * casts at the call site. Adapters narrow these to their canonical input\n * types (typically JSON-string serialisation for `Date`).\n */\nexport type IntegrationParamValue =\n  | string\n  | number\n  | boolean\n  | Date\n  | null\n  | undefined\n  | ReadonlyArray<IntegrationParamValue>\n  | { readonly [key: string]: IntegrationParamValue };\n\nexport interface IntegrationParams {\n  [key: string]: IntegrationParamValue;\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, IntegrationParams } 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: IntegrationParams }> =\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: IntegrationParams }> {\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: IntegrationParams,\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 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, IntegrationParams } from './types';\nimport { BaseIntegration } from './core/BaseIntegration';\nimport { getIntegration } from './registry';\n\n/**\n * Optional per-call context for principal-scoped resolution (W4). The\n * default — absent — means the tenant/app-wide credential set; a `principal`\n * selects a per-principal configuration when one was registered. Additive:\n * every existing call site is untouched.\n */\nexport interface IntegrationCallContext {\n  principal?: string;\n}\n\n/** Cache key for (name, principal?) — NUL never appears in either part. */\nfunction instanceKey(name: string, principal?: string): string {\n  return principal ? `${name}\\u0000${principal}` : name;\n}\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). A `principal` scopes\n   * the config to that principal; the app-wide config (no principal) is the\n   * fallback for every principal.\n   */\n  configure(name: string, config: Omit<IntegrationConfig, 'name'>, principal?: string): void {\n    this.configs.set(instanceKey(name, principal), { name, ...config });\n  }\n\n  /**\n   * Get or create an integration instance. Principal-scoped lookups fall\n   * back to the app-wide config when no per-principal config exists.\n   */\n  get(name: string, principal?: string): BaseIntegration {\n    const key = instanceKey(name, principal);\n    const cached = this.instances.get(key);\n    if (cached) {\n      return cached;\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 — per-principal first, app-wide fallback\n    const config = this.configs.get(key) ?? 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(key, 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: IntegrationParams,\n    context?: IntegrationCallContext,\n  ): Promise<IntegrationResult> {\n    const instance = this.get(integration, context?.principal);\n    return await instance.execute(action, params);\n  }\n\n  /**\n   * Check if integration is configured\n   */\n  isConfigured(name: string, principal?: string): boolean {\n    return this.configs.has(instanceKey(name, principal)) || this.configs.has(name);\n  }\n\n  /**\n   * Register an integration instance directly (used by mock infrastructure)\n   */\n  registerInstance(name: string, instance: BaseIntegration, principal?: string): void {\n    this.instances.set(instanceKey(name, principal), instance);\n  }\n\n  /**\n   * Drop the cached instance(s) for a name so the next `get` rebuilds from\n   * the current config — how a credential change goes live without restart.\n   * Configs are kept; without a name, every instance is dropped.\n   */\n  invalidate(name?: string): void {\n    if (name === undefined) {\n      this.instances.clear();\n      return;\n    }\n    for (const key of this.instances.keys()) {\n      if (key === name || key.startsWith(`${name}\\u0000`)) {\n        this.instances.delete(key);\n      }\n    }\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 { MockIntegration } from './MockIntegration';\nimport { registerIntegration } from '../registry';\nimport type { IntegrationParams } from '../types';\n\n/**\n * Mock integration factory for testing\n */\nexport class MockIntegrationFactory extends IntegrationFactory {\n  constructor() {\n    super();\n    \n    // Register mock integration for all known services\n    const services = ['stripe', 'youtube', 'twilio', 'email', 'llm', 'deepagent'];\n    services.forEach((service) => {\n      registerIntegration(`mock-${service}`, MockIntegration);\n      \n      // Configure with mock config\n      this.configure(service, {\n        env: {},\n      });\n    });\n  }\n\n  /**\n   * Set mock response for an integration action\n   */\n  setMockResponse(integration: string, action: string, data: unknown): void {\n    const instance = this.get(integration) as MockIntegration;\n    instance.setResponse(action, data);\n  }\n\n  /**\n   * Get calls made to an integration\n   */\n  getMockCalls(\n    integration: string,\n  ): Array<{ action: string; params: IntegrationParams }> {\n    const instance = this.get(integration) as MockIntegration;\n    return instance.getCalls();\n  }\n\n  /**\n   * Clear calls for an integration\n   */\n  clearMockCalls(integration: string): void {\n    const instance = this.get(integration) as MockIntegration;\n    instance.clearCalls();\n  }\n}\n"]}

package/dist/runtime/index.d.ts

@@ -1,6 +1,6 @@
-import { I as IntegrationFactory } from '../factory-DTdVeyAi.js';
+import { I as IntegrationCallContext, a as IntegrationFactory } from '../factory-BPVhvv5q.js';
 import { e as IntegrationParams } from '../BaseIntegration-MA-b4fh8.js';
-import { j as IntegrationName, h as IntegrationActionName, i as IntegrationContracts } from '../contracts-CLTh6gjT.js';
+import { o as IntegrationName, m as IntegrationActionName, n as IntegrationContracts, e as CredentialStore } from '../store-CW1v7Apc.js';
 import '@almadar/core';
 
 /**
@@ -21,10 +21,10 @@ import '@almadar/core';
 interface CallServiceHandler {
     <S extends IntegrationName, A extends IntegrationActionName<S>>(service: S, action: A, params: IntegrationContracts[S][A] extends {
         params: infer P;
-    } ? P : IntegrationParams | undefined): Promise<IntegrationContracts[S][A] extends {
+    } ? P : IntegrationParams | undefined, context?: IntegrationCallContext): Promise<IntegrationContracts[S][A] extends {
         result: infer R;
     } ? R : unknown>;
-    (service: string, action: string, params: IntegrationParams | undefined): Promise<unknown>;
+    (service: string, action: string, params: IntegrationParams | undefined, context?: IntegrationCallContext): Promise<unknown>;
 }
 /**
  * Create a callService effect handler for @almadar/runtime.
@@ -48,7 +48,20 @@ declare function createCallServiceHandler(factory: IntegrationFactory): CallServ
  */
 declare class RuntimeIntegrationManager {
     private factory;
+    private credentialStore;
+    private storeEnvBase;
     constructor();
+    /**
+     * W4: configure with the tenant credential store layered over the env —
+     * store → env → unconfigured. Installs the store as the process-wide
+     * `resolveCredentialRef` source, warms it, and re-configures whenever a
+     * credential changes (dropping cached instances so new keys go live
+     * without a restart). Mock mode short-circuits inside `configureFromEnv`
+     * exactly as before, so verify harnesses are unaffected.
+     */
+    configureFromStore(store: CredentialStore, envOverride?: Record<string, string | undefined>): Promise<void>;
+    /** Re-derive configs from base env + warmed store values; drop stale instances. */
+    private refreshFromStore;
     /**
      * Wrap `factory.execute` so an unknown/unconfigured service echoes its
      * params instead of throwing. This makes the manager safe to install as a
@@ -58,13 +71,19 @@ declare class RuntimeIntegrationManager {
      * events fire — only the two "not set up" errors (`Unknown integration`,
      * `Integration not configured`) are caught. Subsumes the broader wrapper
      * that previously lived inside `configureMockMode`.
+     *
+     * In production the fallback is OFF: a missing key must surface as the
+     * circuit's failure event and a degraded health check, never a fake success.
      */
     private installNotConfiguredFallback;
     /**
      * Configure from environment variables.
      * In mock mode (USE_MOCK_DATA=true), all services return realistic mock data.
+     *
+     * Pass an explicit env map to configure hermetically (verify harnesses,
+     * per-tenant resolution); defaults to `process.env`.
      */
-    configureFromEnv(): void;
+    configureFromEnv(envOverride?: Record<string, string | undefined>): void;
     /**
      * Configure mock mode: register MockIntegration for all known services
      * with auto-generated responses from the services registry.