@almadar/integrations 2.20.0 → 2.22.0

package/dist/{contracts-DaVfyPnd.d.ts → contracts-CYtxZXrR.d.ts}

@@ -885,6 +885,64 @@ type DatabaseActions = {
         };
     };
 };
+type WikimediaActions = {
+    getPage: {
+        params: {
+            title: string;
+        };
+        result: {
+            title?: string;
+            description?: string;
+            portraitUrl?: string;
+            extract?: string;
+        };
+    };
+};
+type IconifyActions = {
+    svgExists: {
+        params: {
+            path: string;
+        };
+        result: {
+            exists: boolean;
+        };
+    };
+    search: {
+        params: {
+            query: string;
+            limit?: number;
+        };
+        result: {
+            icons: string[];
+        };
+    };
+    getIconBody: {
+        params: {
+            iconId: string;
+        };
+        result: {
+            body: string | null;
+        };
+    };
+};
+type ArxivActions = {
+    search: {
+        params: {
+            query: string;
+            maxResults?: number;
+        };
+        result: {
+            results: Array<{
+                id: string;
+                title: string;
+                summary: string;
+                authors: string[];
+                published: string;
+                url: string;
+            }>;
+        };
+    };
+};
 /**
  * Maps each integration name (as used in `registerIntegration`) to its action
  * map type. Use with `ServiceContract<IntegrationContracts[K]>` to get a fully
@@ -915,6 +973,9 @@ type IntegrationContracts = {
     cli: CLIActions;
     deepagent: DeepAgentActions;
     database: DatabaseActions;
+    wikimedia: WikimediaActions;
+    iconify: IconifyActions;
+    arxiv: ArxivActions;
 };
 /** Integration name literal union. */
 type IntegrationName = keyof IntegrationContracts;
@@ -929,4 +990,4 @@ type IntegrationName = keyof IntegrationContracts;
  */
 type IntegrationActionName<K extends IntegrationName> = keyof IntegrationContracts[K] & string;
 
-export type { CLIActions as C, DatabaseActions as D, EmailActions as E, GitHubActions as G, IntegrationActionName as I, LLMIntegrationActions as L, MLActions as M, OAuthActions as O, QueueActions as Q, RedisActions as R, StorageActions as S, TwilioActions as T, YouTubeActions as Y, DatabaseDriver as a, DatabaseQueryParamValue as b, DatabaseQueryParams as c, DatabaseQueryResult as d, DatabaseRow as e, DeepAgentActions as f, DockerActions as g, IntegrationContracts as h, IntegrationName as i, OtelActions as j, StripeActions as k };
+export type { ArxivActions as A, CLIActions as C, DatabaseActions as D, EmailActions as E, GitHubActions as G, IconifyActions as I, LLMIntegrationActions as L, MLActions as M, OAuthActions as O, QueueActions as Q, RedisActions as R, StorageActions as S, TwilioActions as T, WikimediaActions as W, YouTubeActions as Y, DatabaseDriver as a, DatabaseQueryParamValue as b, DatabaseQueryParams as c, DatabaseQueryResult as d, DatabaseRow as e, DeepAgentActions as f, DockerActions as g, IntegrationActionName as h, IntegrationContracts as i, IntegrationName as j, OtelActions as k, StripeActions as l };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { c as IntegrationLogger, b as IntegrationErrorCode, I as IntegrationConfig, B as BaseIntegration, e as IntegrationParams, f as IntegrationResult } from './BaseIntegration-MA-b4fh8.js';
 export { a as IntegrationError, d as IntegrationParamValue, V as ValidationError, g as ValidationResult, v as validateParams } from './BaseIntegration-MA-b4fh8.js';
-export { C as CLIActions, D as DatabaseActions, a as DatabaseDriver, b as DatabaseQueryParamValue, c as DatabaseQueryParams, d as DatabaseQueryResult, e as DatabaseRow, f as DeepAgentActions, g as DockerActions, E as EmailActions, G as GitHubActions, I as IntegrationActionName, h as IntegrationContracts, i as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, j as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, k as StripeActions, T as TwilioActions, Y as YouTubeActions } from './contracts-DaVfyPnd.js';
+export { A as ArxivActions, C as CLIActions, D as DatabaseActions, a as DatabaseDriver, b as DatabaseQueryParamValue, c as DatabaseQueryParams, d as DatabaseQueryResult, e as DatabaseRow, f as DeepAgentActions, g as DockerActions, E as EmailActions, G as GitHubActions, I as IconifyActions, h as IntegrationActionName, i as IntegrationContracts, j as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, k as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, l as StripeActions, T as TwilioActions, W as WikimediaActions, Y as YouTubeActions } from './contracts-CYtxZXrR.js';
 import { LogMeta } from '@almadar/core';
 export { I as IntegrationFactory, g as getIntegrationFactory, r as resetIntegrationFactory } from './factory-DTdVeyAi.js';
 export { GitHubIntegration } from './integrations/github/index.js';
@@ -600,4 +600,40 @@ declare class DatabaseIntegration extends BaseIntegration {
     private driverFor;
 }
 
-export { type AlmadarCheckoutSession, type AlmadarCustomer, type AlmadarInvoiceFailure, type AlmadarInvoicePayment, type AlmadarPortalSession, type AlmadarStripeEvent, type AlmadarStripeEventOk, type AlmadarSubscription, type AlmadarSubscriptionStatus, type AlmadarTier, BaseIntegration, CLIIntegration, type CancelSubscriptionInput, ConsoleLogger, type CreateCheckoutInput, type CreateCustomerInput, type CreatePortalInput, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationParams, IntegrationResult, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, type SqlGuardResult, StorageIntegration, StripeIntegration, type StripePriceMap, TwilioIntegration, type UpdateSubscriptionInput, type VerifyAndParseInput, YouTubeIntegration, assertReadOnlySelect, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, verifyAndParseStripeEvent, withRetry };
+declare class WikimediaIntegration extends BaseIntegration {
+    private readonly userAgent;
+    private readonly timeoutMs;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
+    /** Look up a title on Wikipedia: description, portrait, lead extract. Empty fields on miss. */
+    private getPage;
+}
+
+declare class IconifyIntegration extends BaseIntegration {
+    private readonly userAgent;
+    private readonly timeoutMs;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
+    private svgExists;
+    private search;
+    private getIconBody;
+    private headOk;
+    private getJson;
+}
+
+interface ArxivResult {
+    id: string;
+    title: string;
+    summary: string;
+    authors: string[];
+    published: string;
+    url: string;
+}
+declare class ArxivIntegration extends BaseIntegration {
+    private readonly timeoutMs;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
+    private search;
+}
+
+export { type AlmadarCheckoutSession, type AlmadarCustomer, type AlmadarInvoiceFailure, type AlmadarInvoicePayment, type AlmadarPortalSession, type AlmadarStripeEvent, type AlmadarStripeEventOk, type AlmadarSubscription, type AlmadarSubscriptionStatus, type AlmadarTier, ArxivIntegration, type ArxivResult, BaseIntegration, CLIIntegration, type CancelSubscriptionInput, ConsoleLogger, type CreateCheckoutInput, type CreateCustomerInput, type CreatePortalInput, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, IconifyIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationParams, IntegrationResult, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, type SqlGuardResult, StorageIntegration, StripeIntegration, type StripePriceMap, TwilioIntegration, type UpdateSubscriptionInput, type VerifyAndParseInput, WikimediaIntegration, YouTubeIntegration, assertReadOnlySelect, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, verifyAndParseStripeEvent, withRetry };

package/dist/index.js

@@ -3414,6 +3414,245 @@ var DatabaseIntegration = class extends BaseIntegration {
 };
 registerIntegration("database", DatabaseIntegration);
 
-export { BaseIntegration, CLIIntegration, ConsoleLogger, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IntegrationError, IntegrationFactory, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, YouTubeIntegration, assertReadOnlySelect, getIntegration, getIntegrationFactory, getRegisteredIntegrations, isKnownIntegration, registerIntegration, resetIntegrationFactory, validateParams, verifyAndParseStripeEvent, withRetry };
+// src/integrations/wikimedia/index.ts
+var WIKI_ENDPOINT = "https://en.wikipedia.org/w/api.php";
+var DEFAULT_UA = "Almadar/1.0 (https://almadar.dev)";
+var DEFAULT_TIMEOUT_MS2 = 6e3;
+var EXTRACT_CHAR_CAP = 2e3;
+var WikimediaIntegration = class extends BaseIntegration {
+  constructor(config) {
+    super(config);
+    this.userAgent = config.env?.WIKIMEDIA_USER_AGENT ?? DEFAULT_UA;
+    this.timeoutMs = Number(config.env?.WIKIMEDIA_TIMEOUT_MS ?? DEFAULT_TIMEOUT_MS2);
+    this.logger.info("Wikimedia integration initialized");
+  }
+  async execute(action, params) {
+    const validation = this.validateParams(action, params);
+    if (!validation.valid) {
+      return {
+        success: false,
+        error: {
+          name: "IntegrationError",
+          message: "Validation failed",
+          code: "VALIDATION_ERROR",
+          details: validation.errors
+        },
+        metadata: this.createMetadata(action, 0)
+      };
+    }
+    const startTime = Date.now();
+    try {
+      let data;
+      switch (action) {
+        case "getPage":
+          data = await this.executeWithRetry(() => this.getPage(params));
+          break;
+        default:
+          throw new Error(`Unknown action: ${action}`);
+      }
+      return { success: true, data, metadata: this.createMetadata(action, Date.now() - startTime) };
+    } catch (error) {
+      return this.handleError(action, error);
+    }
+  }
+  /** Look up a title on Wikipedia: description, portrait, lead extract. Empty fields on miss. */
+  async getPage(params) {
+    const title = String(params.title ?? "").trim();
+    if (!title) return {};
+    const url = `${WIKI_ENDPOINT}?action=query&format=json&redirects=1&prop=pageimages|description|extracts&explaintext=1&exintro=1&piprop=thumbnail&pithumbsize=240&titles=${encodeURIComponent(title)}`;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(url, { headers: { "User-Agent": this.userAgent }, signal: ctrl.signal });
+      if (!res.ok) return {};
+      const data = await res.json();
+      const pages = data.query?.pages;
+      if (!pages) return {};
+      const page = Object.values(pages)[0];
+      if (!page || page.missing !== void 0) return {};
+      const extract = typeof page.extract === "string" ? page.extract.slice(0, EXTRACT_CHAR_CAP).trim() : void 0;
+      return {
+        title: page.title,
+        description: page.description ?? (typeof page.extract === "string" ? page.extract.split(".")[0] : void 0),
+        portraitUrl: page.thumbnail?.source,
+        extract
+      };
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+registerIntegration("wikimedia", WikimediaIntegration);
+
+// src/integrations/iconify/index.ts
+var ICONIFY_API = "https://api.iconify.design";
+var DEFAULT_UA2 = "Almadar/1.0 (https://almadar.dev)";
+var DEFAULT_TIMEOUT_MS3 = 6e3;
+var IconifyIntegration = class extends BaseIntegration {
+  constructor(config) {
+    super(config);
+    this.userAgent = config.env?.ICONIFY_USER_AGENT ?? DEFAULT_UA2;
+    this.timeoutMs = Number(config.env?.ICONIFY_TIMEOUT_MS ?? DEFAULT_TIMEOUT_MS3);
+    this.logger.info("Iconify integration initialized");
+  }
+  async execute(action, params) {
+    const validation = this.validateParams(action, params);
+    if (!validation.valid) {
+      return {
+        success: false,
+        error: {
+          name: "IntegrationError",
+          message: "Validation failed",
+          code: "VALIDATION_ERROR",
+          details: validation.errors
+        },
+        metadata: this.createMetadata(action, 0)
+      };
+    }
+    const startTime = Date.now();
+    try {
+      let data;
+      switch (action) {
+        case "svgExists":
+          data = await this.executeWithRetry(() => this.svgExists(params));
+          break;
+        case "search":
+          data = await this.executeWithRetry(() => this.search(params));
+          break;
+        case "getIconBody":
+          data = await this.executeWithRetry(() => this.getIconBody(params));
+          break;
+        default:
+          throw new Error(`Unknown action: ${action}`);
+      }
+      return { success: true, data, metadata: this.createMetadata(action, Date.now() - startTime) };
+    } catch (error) {
+      return this.handleError(action, error);
+    }
+  }
+  async svgExists(params) {
+    const path = String(params.path ?? "");
+    if (!path) return { exists: false };
+    return { exists: await this.headOk(`${ICONIFY_API}/${path}`) };
+  }
+  async search(params) {
+    const query = String(params.query ?? "");
+    if (!query) return { icons: [] };
+    const limit = Number(params.limit ?? 1);
+    const data = await this.getJson(`${ICONIFY_API}/search?query=${encodeURIComponent(query)}&limit=${limit}`);
+    return { icons: data?.icons ?? [] };
+  }
+  async getIconBody(params) {
+    const iconId = String(params.iconId ?? "");
+    const [prefix, name] = iconId.split(":");
+    if (!prefix || !name) return { body: null };
+    const data = await this.getJson(`${ICONIFY_API}/${prefix}.json?icons=${encodeURIComponent(name)}`);
+    return { body: data?.icons?.[name]?.body ?? data?.aliases?.[name]?.body ?? null };
+  }
+  async headOk(url) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(url, { method: "GET", headers: { "User-Agent": this.userAgent }, signal: ctrl.signal });
+      return res.ok;
+    } catch {
+      return false;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async getJson(url) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(url, { headers: { "User-Agent": this.userAgent }, signal: ctrl.signal });
+      if (!res.ok) return null;
+      return await res.json();
+    } catch {
+      return null;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+registerIntegration("iconify", IconifyIntegration);
+
+// src/integrations/arxiv/index.ts
+var ARXIV_ENDPOINT = "https://export.arxiv.org/api/query";
+var DEFAULT_TIMEOUT_MS4 = 1e4;
+var DEFAULT_MAX_RESULTS = 8;
+function parseAtom(xml) {
+  const entries = [];
+  for (const block of xml.split("<entry>").slice(1)) {
+    const grab = (tag) => {
+      const m = block.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "i"));
+      return m ? m[1].replace(/<[^>]+>/g, "").trim() : "";
+    };
+    const id = grab("id");
+    const title = grab("title").replace(/\s+/g, " ");
+    const summary = grab("summary").replace(/\s+/g, " ");
+    const published = grab("published");
+    const authors = Array.from(block.matchAll(/<author>\s*<name>([^<]+)<\/name>/g)).map((m) => m[1].trim());
+    const linkMatch = block.match(/<link[^>]*rel="alternate"[^>]*href="([^"]+)"/i);
+    const url = linkMatch ? linkMatch[1] : id;
+    if (id || title) entries.push({ id, title, summary, authors, published, url });
+  }
+  return entries;
+}
+var ArxivIntegration = class extends BaseIntegration {
+  constructor(config) {
+    super(config);
+    this.timeoutMs = Number(config.env?.ARXIV_TIMEOUT_MS ?? DEFAULT_TIMEOUT_MS4);
+    this.logger.info("arXiv integration initialized");
+  }
+  async execute(action, params) {
+    const validation = this.validateParams(action, params);
+    if (!validation.valid) {
+      return {
+        success: false,
+        error: {
+          name: "IntegrationError",
+          message: "Validation failed",
+          code: "VALIDATION_ERROR",
+          details: validation.errors
+        },
+        metadata: this.createMetadata(action, 0)
+      };
+    }
+    const startTime = Date.now();
+    try {
+      let data;
+      switch (action) {
+        case "search":
+          data = await this.executeWithRetry(() => this.search(params));
+          break;
+        default:
+          throw new Error(`Unknown action: ${action}`);
+      }
+      return { success: true, data, metadata: this.createMetadata(action, Date.now() - startTime) };
+    } catch (error) {
+      return this.handleError(action, error);
+    }
+  }
+  async search(params) {
+    const query = String(params.query ?? "").trim();
+    if (!query) return { results: [] };
+    const maxResults = Number(params.maxResults ?? DEFAULT_MAX_RESULTS);
+    const url = `${ARXIV_ENDPOINT}?search_query=${encodeURIComponent(`all:${query}`)}&start=0&max_results=${maxResults}&sortBy=relevance`;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(url, { headers: { "Accept": "application/atom+xml" }, signal: ctrl.signal });
+      if (!res.ok) return { results: [] };
+      const xml = await res.text();
+      return { results: parseAtom(xml) };
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+registerIntegration("arxiv", ArxivIntegration);
+
+export { ArxivIntegration, BaseIntegration, CLIIntegration, ConsoleLogger, DatabaseIntegration, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IconifyIntegration, IntegrationError, IntegrationFactory, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, StorageIntegration, StripeIntegration, TwilioIntegration, WikimediaIntegration, YouTubeIntegration, assertReadOnlySelect, getIntegration, getIntegrationFactory, getRegisteredIntegrations, isKnownIntegration, registerIntegration, resetIntegrationFactory, validateParams, verifyAndParseStripeEvent, withRetry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map