@almadar/integrations 2.30.0 → 2.32.0

package/dist/{BaseIntegration-C_5q54DM.d.ts → BaseIntegration-BYlbMFlf.d.ts}

@@ -112,6 +112,12 @@ interface ValidationError {
     message: string;
 }
 
+/** Thrown by an integration's dispatch default/miss arm — contract↔dispatch parity marker. */
+declare class UnknownActionError extends Error {
+    integration: string;
+    action: string;
+    constructor(integration: string, action: string);
+}
 /**
  * Validate action params against registry schema
  */
@@ -207,4 +213,4 @@ declare abstract class BaseIntegration {
     protected executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
 }
 
-export { BaseIntegration as B, type IntegrationCallContext as I, type ValidationError as V, type IntegrationConfig as a, IntegrationError as b, type IntegrationErrorCode as c, IntegrationFactory as d, type IntegrationLogger as e, type IntegrationParamValue as f, type IntegrationParams as g, type IntegrationResult as h, type ValidationResult as i, getIntegrationFactory as j, resetIntegrationFactory as r, validateParams as v };
+export { BaseIntegration as B, type IntegrationCallContext as I, UnknownActionError as U, type ValidationError as V, type IntegrationConfig as a, IntegrationError as b, type IntegrationErrorCode as c, IntegrationFactory as d, type IntegrationLogger as e, type IntegrationParamValue as f, type IntegrationParams as g, type IntegrationResult as h, type ValidationResult as i, getIntegrationFactory as j, resetIntegrationFactory as r, validateParams as v };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { e as IntegrationLogger, c as IntegrationErrorCode, a as IntegrationConfig, B as BaseIntegration, d as IntegrationFactory, g as IntegrationParams, h as IntegrationResult, I as IntegrationCallContext } from './BaseIntegration-C_5q54DM.js';
-export { b as IntegrationError, f as IntegrationParamValue, V as ValidationError, i as ValidationResult, j as getIntegrationFactory, r as resetIntegrationFactory, v as validateParams } from './BaseIntegration-C_5q54DM.js';
-import { e as CredentialStore, d as CredentialPersistence, H as HookDeclaration } from './store-eq1-GfDi.js';
-export { A as ArxivActions, C as CLIActions, a as CREDENTIAL_ENTITY_TYPE, b as CREDENTIAL_MASTER_KEY_ENV, c as CredentialEntry, D as DatabaseActions, f as DatabaseDriver, g as DatabaseQueryParamValue, h as DatabaseQueryParams, i as DatabaseQueryResult, j as DatabaseRow, k as DeepAgentActions, l as DockerActions, E as EmailActions, G as GitHubActions, I as IconifyActions, m as IntegrationActionName, n as IntegrationContracts, o as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, p as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, q as StripeActions, T as TwilioActions, W as WebhookActions, r as WikimediaActions, Y as YouTubeActions, s as serviceHooks } from './store-eq1-GfDi.js';
+import { e as IntegrationLogger, c as IntegrationErrorCode, a as IntegrationConfig, B as BaseIntegration, d as IntegrationFactory, g as IntegrationParams, h as IntegrationResult, I as IntegrationCallContext } from './BaseIntegration-BYlbMFlf.js';
+export { b as IntegrationError, f as IntegrationParamValue, U as UnknownActionError, V as ValidationError, i as ValidationResult, j as getIntegrationFactory, r as resetIntegrationFactory, v as validateParams } from './BaseIntegration-BYlbMFlf.js';
+import { e as CredentialStore, d as CredentialPersistence, H as HookDeclaration } from './store-C03XILaI.js';
+export { A as ArxivActions, C as CLIActions, a as CREDENTIAL_ENTITY_TYPE, b as CREDENTIAL_MASTER_KEY_ENV, c as CredentialEntry, D as DatabaseActions, f as DatabaseDriver, g as DatabaseQueryParamValue, h as DatabaseQueryParams, i as DatabaseQueryResult, j as DatabaseRow, k as DeepAgentActions, l as DockerActions, E as EmailActions, G as GitHubActions, I as IconifyActions, m as IntegrationActionName, n as IntegrationContracts, o as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, p as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, q as StripeActions, T as TwilioActions, W as WebhookActions, r as WikimediaActions, Y as YouTubeActions, s as allCredentialEnvVars, t as declaredCredentialEnvVars, u as serviceHooks } from './store-C03XILaI.js';
 import { LogMeta, EntityRow, EventPayload } from '@almadar/core';
 export { GitHubIntegration } from './integrations/github/index.js';
 

package/dist/index.js

@@ -160,6 +160,22 @@ var serviceCredentials = {
     { envVar: "ARXIV_TIMEOUT_MS", required: false, description: "Per-request timeout (ms)" }
   ]
 };
+function allCredentialEnvVars() {
+  const vars = /* @__PURE__ */ new Set();
+  for (const decls of Object.values(serviceCredentials)) {
+    for (const { envVar } of decls) vars.add(envVar);
+  }
+  return vars;
+}
+var STORE_BOOTSTRAP_ENV_VARS = /* @__PURE__ */ new Set([
+  "ALMADAR_CREDENTIAL_MASTER_KEY",
+  "ALMADAR_CREDENTIAL_MASTER_KEY_PREVIOUS"
+]);
+function declaredCredentialEnvVars() {
+  const vars = allCredentialEnvVars();
+  for (const bootstrapVar of STORE_BOOTSTRAP_ENV_VARS) vars.delete(bootstrapVar);
+  return vars;
+}
 var serviceHooks = {
   calendar: [
     {
@@ -193,6 +209,14 @@ var ConsoleLogger = class {
   }
 };
 var RESERVED_ENVELOPE_KEYS = /* @__PURE__ */ new Set(["emit", "onSuccess", "onError", "timeout"]);
+var UnknownActionError = class extends Error {
+  constructor(integration, action) {
+    super(`Unknown ${integration} action: ${action}`);
+    this.name = "UnknownActionError";
+    this.integration = integration;
+    this.action = action;
+  }
+};
 function validateParams(integration, action, params) {
   const typedRegistry = integratorsRegistry;
   const registry = typedRegistry.integrators[integration];
@@ -995,7 +1019,7 @@ var StripeIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.refund(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -1222,7 +1246,7 @@ var YouTubeIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.getChannel(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -1324,7 +1348,7 @@ var TwilioIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.sendWhatsApp(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -1406,7 +1430,7 @@ var EmailIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.send(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -1506,7 +1530,7 @@ var WebhookIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.send(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -1597,7 +1621,7 @@ var PushIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.send(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -1747,7 +1771,7 @@ var CalendarIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.stopWatch(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2013,7 +2037,7 @@ var DriveIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.shareFile(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2151,7 +2175,7 @@ var MetaAdsIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.listCampaigns(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2250,7 +2274,7 @@ var AccountingIntegration = class extends BaseIntegration {
           data = this.exportRows(params.entries, JOURNAL_COLUMNS, "journal");
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2332,7 +2356,7 @@ var BankingIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.listTransactions(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2456,7 +2480,7 @@ var EsignIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.downloadDocument(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2610,7 +2634,7 @@ var LLMIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.embed(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2776,7 +2800,7 @@ var MLIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.infer(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -2913,7 +2937,7 @@ var DeepAgentIntegration = class extends BaseIntegration {
           );
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -3215,10 +3239,10 @@ async function getPRComments(params, config) {
   return data;
 }
 async function listIssues(params, config) {
-  const { state = "open", labels = [], limit = 30 } = params;
+  const { state = "open", labels = [], per_page = 30 } = params;
   const queryParams = new URLSearchParams({
     state,
-    per_page: Math.min(limit, 100).toString()
+    per_page: Math.min(per_page, 100).toString()
   });
   if (labels.length > 0) {
     queryParams.append("labels", labels.join(","));
@@ -3235,6 +3259,52 @@ async function getIssue(params, config) {
   const { data: comments } = await githubFetch(commentsEndpoint, config);
   return { issue, comments };
 }
+async function listCommits(config, options) {
+  const params = new URLSearchParams();
+  if (options?.path) params.set("path", options.path);
+  if (options?.ref) params.set("sha", options.ref);
+  if (options?.perPage) params.set("per_page", options.perPage.toString());
+  if (options?.page) params.set("page", options.page.toString());
+  const queryStr = params.toString();
+  const endpoint = `/repos/${config.owner}/${config.repo}/commits${queryStr ? `?${queryStr}` : ""}`;
+  const { data } = await githubFetch(endpoint, config);
+  return data.map((item) => ({
+    sha: item.sha,
+    message: item.commit.message,
+    author: item.commit.author,
+    stats: item.stats
+  }));
+}
+async function getFile(params, token) {
+  const { owner, repo, path, ref } = params;
+  const config = { token};
+  const query = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+  const endpoint = `/repos/${owner}/${repo}/contents/${path}${query}`;
+  const { data } = await githubFetch(endpoint, config);
+  const content = data.encoding === "base64" ? Buffer.from(data.content, "base64").toString("utf-8") : data.content;
+  return { path: data.path, content, sha: data.sha, size: data.size };
+}
+async function listCommitsSummary(params, token) {
+  const { owner, repo, path, ref, per_page } = params;
+  const config = { token, owner, repo };
+  const commits = await listCommits(config, { path, ref, perPage: per_page });
+  return commits.map((commit2) => ({
+    sha: commit2.sha,
+    message: commit2.message,
+    author: commit2.author.name,
+    date: commit2.author.date
+  }));
+}
+async function createIssue(params, token) {
+  const { owner, repo, title, body, labels } = params;
+  const config = { token};
+  const endpoint = `/repos/${owner}/${repo}/issues`;
+  const { data } = await githubFetch(endpoint, config, {
+    method: "POST",
+    body: JSON.stringify({ title, body, labels })
+  });
+  return { number: data.number, title: data.title, url: data.url };
+}
 function parseRepoUrl(repoUrl) {
   try {
     const url = new URL(repoUrl);
@@ -3332,8 +3402,23 @@ var GitHubIntegration = class extends BaseIntegration {
             () => this.getIssue(params)
           );
           break;
+        case "getFile":
+          data = await this.executeWithRetry(
+            () => this.getFile(params)
+          );
+          break;
+        case "listCommits":
+          data = await this.executeWithRetry(
+            () => this.listCommits(params)
+          );
+          break;
+        case "createIssue":
+          data = await this.executeWithRetry(
+            () => this.createIssue(params)
+          );
+          break;
         default:
-          throw new Error(`Unknown GitHub action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -3412,7 +3497,7 @@ var GitHubIntegration = class extends BaseIntegration {
    * List issues
    */
   async listIssues(params) {
-    this.logger.debug("Listing issues", { state: params.state, labels: params.labels?.join(", "), limit: params.limit });
+    this.logger.debug("Listing issues", { state: params.state, labels: params.labels?.join(", "), per_page: params.per_page });
     const apiConfig = this.getAPIConfig();
     const issues = await listIssues(params, apiConfig);
     return { issues };
@@ -3426,6 +3511,29 @@ var GitHubIntegration = class extends BaseIntegration {
     const result = await getIssue(params, apiConfig);
     return result;
   }
+  /**
+   * Get a file's content plus metadata (owner/repo are per-call, not the
+   * configured default repo)
+   */
+  async getFile(params) {
+    this.logger.debug("Getting file", { owner: params.owner, repo: params.repo, path: params.path });
+    return getFile(params, this.token);
+  }
+  /**
+   * List commits (owner/repo are per-call, not the configured default repo)
+   */
+  async listCommits(params) {
+    this.logger.debug("Listing commits", { owner: params.owner, repo: params.repo, path: params.path });
+    const commits = await listCommitsSummary(params, this.token);
+    return { commits };
+  }
+  /**
+   * Create an issue (owner/repo are per-call, not the configured default repo)
+   */
+  async createIssue(params) {
+    this.logger.debug("Creating issue", { owner: params.owner, repo: params.repo, title: params.title });
+    return createIssue(params, this.token);
+  }
   /**
    * Get API config for GitHub API calls
    */
@@ -3457,7 +3565,7 @@ var CLIIntegration = class extends BaseIntegration {
           data = await this.validate(params);
           break;
         default:
-          throw new Error(`Unknown CLI action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -3585,7 +3693,7 @@ var RedisIntegration = class extends BaseIntegration {
           );
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -3791,7 +3899,7 @@ var QueueIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.size(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -3998,7 +4106,7 @@ var OtelIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.getAllMetrics());
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -4198,7 +4306,7 @@ var OAuthIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.real ? this.oidcUserinfo(params) : this.userinfo(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -4516,7 +4624,7 @@ var CredentialsIntegration = class extends BaseIntegration {
           break;
         }
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -4726,7 +4834,7 @@ var StorageIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.getSignedUrl(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -5019,7 +5127,7 @@ var DockerIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.list(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -5437,7 +5545,7 @@ var DatabaseIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.runQuery(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -5516,7 +5624,7 @@ var WikimediaIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.getPage(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return { success: true, data, metadata: this.createMetadata(action, Date.now() - startTime) };
     } catch (error) {
@@ -5591,7 +5699,7 @@ var IconifyIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.getIconBody(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return { success: true, data, metadata: this.createMetadata(action, Date.now() - startTime) };
     } catch (error) {
@@ -5695,7 +5803,7 @@ var ArxivIntegration = class extends BaseIntegration {
           data = await this.executeWithRetry(() => this.search(params));
           break;
         default:
-          throw new Error(`Unknown action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return { success: true, data, metadata: this.createMetadata(action, Date.now() - startTime) };
     } catch (error) {
@@ -5721,6 +5829,6 @@ var ArxivIntegration = class extends BaseIntegration {
 };
 registerIntegration("arxiv", ArxivIntegration);
 
-export { AccountingIntegration, ArxivIntegration, BankingIntegration, BaseIntegration, CLIIntegration, CREDENTIALS_FILE_ENV, CREDENTIAL_ENTITY_TYPE, CREDENTIAL_MASTER_KEY_ENV, CalendarIntegration, ConsoleLogger, CredentialStore, CredentialsIntegration, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, DriveIntegration, EmailIntegration, EsignIntegration, FileCredentialPersistence, GitHubIntegration, IconifyIntegration, InMemoryPendingGrantStore, IntegrationError, IntegrationFactory, LLMIntegration, MLIntegration, MetaAdsIntegration, OAuthIntegration, OtelIntegration, PushIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, WebhookIntegration, WikimediaIntegration, YouTubeIntegration, allHookDeclarations, assertReadOnlySelect, getActiveFactory, getInstalledCredentialStore, getIntegration, getIntegrationFactory, getRegisteredIntegrations, googleCalendarHookProvider, installActiveFactory, installCredentialStore, installPendingGrantStore, isKnownIntegration, parseCalendarPushNotification, registerIntegration, registeredHookProviders, resetIntegrationFactory, resolveCredentialRef, serviceHooks, uninstallCredentialStore, validateParams, verifyAndParseStripeEvent, withRetry };
+export { AccountingIntegration, ArxivIntegration, BankingIntegration, BaseIntegration, CLIIntegration, CREDENTIALS_FILE_ENV, CREDENTIAL_ENTITY_TYPE, CREDENTIAL_MASTER_KEY_ENV, CalendarIntegration, ConsoleLogger, CredentialStore, CredentialsIntegration, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, DriveIntegration, EmailIntegration, EsignIntegration, FileCredentialPersistence, GitHubIntegration, IconifyIntegration, InMemoryPendingGrantStore, IntegrationError, IntegrationFactory, LLMIntegration, MLIntegration, MetaAdsIntegration, OAuthIntegration, OtelIntegration, PushIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, UnknownActionError, WebhookIntegration, WikimediaIntegration, YouTubeIntegration, allCredentialEnvVars, allHookDeclarations, assertReadOnlySelect, declaredCredentialEnvVars, getActiveFactory, getInstalledCredentialStore, getIntegration, getIntegrationFactory, getRegisteredIntegrations, googleCalendarHookProvider, installActiveFactory, installCredentialStore, installPendingGrantStore, isKnownIntegration, parseCalendarPushNotification, registerIntegration, registeredHookProviders, resetIntegrationFactory, resolveCredentialRef, serviceHooks, uninstallCredentialStore, validateParams, verifyAndParseStripeEvent, withRetry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map