@almadar/integrations 2.19.0 → 2.21.0

package/dist/{BaseIntegration-B9lSTRQm.d.ts → BaseIntegration-MA-b4fh8.d.ts}

@@ -146,4 +146,4 @@ declare abstract class BaseIntegration {
     protected executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
 }
 
-export { BaseIntegration as B, type IntegrationConfig as I, type ValidationError as V, IntegrationError as a, type IntegrationErrorCode as b, type IntegrationLogger as c, type IntegrationParams as d, type IntegrationResult as e, type ValidationResult as f, validateParams as v };
+export { BaseIntegration as B, type IntegrationConfig as I, type ValidationError as V, IntegrationError as a, type IntegrationErrorCode as b, type IntegrationLogger as c, type IntegrationParamValue as d, type IntegrationParams as e, type IntegrationResult as f, type ValidationResult as g, validateParams as v };

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

@@ -1,5 +1,29 @@
 import { ServiceParamsValue, ServiceParams } from '@almadar/core';
-import { d as IntegrationParams } from './BaseIntegration-B9lSTRQm.js';
+import { d as IntegrationParamValue, e as IntegrationParams } from './BaseIntegration-MA-b4fh8.js';
+
+/** Scalar value admissible as a SQL bind parameter. */
+type DatabaseQueryParamValue = string | number | boolean | Date | null;
+/** Params for the `query` action. */
+type DatabaseQueryParams = {
+    connectionRef: string;
+    sql: string;
+    params?: DatabaseQueryParamValue[];
+};
+/** One result row, keyed by column name. */
+type DatabaseRow = Record<string, IntegrationParamValue>;
+/** Result of a read-only query. */
+interface DatabaseQueryResult {
+    rows: DatabaseRow[];
+    rowCount: number;
+}
+/**
+ * Driver seam behind the `query` action. Postgres is the first
+ * implementation; MySQL/SQLite slot behind this interface later.
+ */
+interface DatabaseDriver {
+    query(sql: string, params: readonly DatabaseQueryParamValue[]): Promise<DatabaseQueryResult>;
+    end(): Promise<void>;
+}
 
 /**
  * ServiceContract type definitions for all @almadar/integrations.
@@ -848,6 +872,77 @@ type DeepAgentActions = {
         };
     };
 };
+type DatabaseActions = {
+    query: {
+        params: {
+            connectionRef: string;
+            sql: string;
+            params?: DatabaseQueryParamValue[];
+        };
+        result: {
+            rows: DatabaseRow[];
+            rowCount: number;
+        };
+    };
+};
+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
@@ -877,6 +972,10 @@ type IntegrationContracts = {
     otel: OtelActions;
     cli: CLIActions;
     deepagent: DeepAgentActions;
+    database: DatabaseActions;
+    wikimedia: WikimediaActions;
+    iconify: IconifyActions;
+    arxiv: ArxivActions;
 };
 /** Integration name literal union. */
 type IntegrationName = keyof IntegrationContracts;
@@ -891,4 +990,4 @@ type IntegrationName = keyof IntegrationContracts;
  */
 type IntegrationActionName<K extends IntegrationName> = keyof IntegrationContracts[K] & string;
 
-export type { CLIActions as C, DeepAgentActions 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, DockerActions as a, IntegrationContracts as b, IntegrationName as c, OtelActions as d, StripeActions as e };
+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/{factory-TNgVDujm.d.ts → factory-DTdVeyAi.d.ts}

@@ -1,4 +1,4 @@
-import { I as IntegrationConfig, B as BaseIntegration, d as IntegrationParams, e as IntegrationResult } from './BaseIntegration-B9lSTRQm.js';
+import { I as IntegrationConfig, B as BaseIntegration, e as IntegrationParams, f as IntegrationResult } from './BaseIntegration-MA-b4fh8.js';
 
 /**
  * Factory for creating and managing integration instances

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { c as IntegrationLogger, b as IntegrationErrorCode, I as IntegrationConfig, B as BaseIntegration, d as IntegrationParams, e as IntegrationResult } from './BaseIntegration-B9lSTRQm.js';
-export { a as IntegrationError, V as ValidationError, f as ValidationResult, v as validateParams } from './BaseIntegration-B9lSTRQm.js';
-export { C as CLIActions, D as DeepAgentActions, a as DockerActions, E as EmailActions, G as GitHubActions, I as IntegrationActionName, b as IntegrationContracts, c as IntegrationName, L as LLMIntegrationActions, M as MLActions, O as OAuthActions, d as OtelActions, Q as QueueActions, R as RedisActions, S as StorageActions, e as StripeActions, T as TwilioActions, Y as YouTubeActions } from './contracts-B28G_7ur.js';
+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 { 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-TNgVDujm.js';
+export { I as IntegrationFactory, g as getIntegrationFactory, r as resetIntegrationFactory } from './factory-DTdVeyAi.js';
 export { GitHubIntegration } from './integrations/github/index.js';
 
 /**
@@ -560,4 +560,80 @@ declare class DockerIntegration extends BaseIntegration {
     private list;
 }
 
-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, DeepAgentIntegration, DockerIntegration, EmailIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationResult, LLMIntegration, MLIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, StorageIntegration, StripeIntegration, type StripePriceMap, TwilioIntegration, type UpdateSubscriptionInput, type VerifyAndParseInput, YouTubeIntegration, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, verifyAndParseStripeEvent, withRetry };
+/**
+ * Read-only SQL enforcement for the database integration.
+ *
+ * The guard accepts exactly one SELECT statement (optionally CTE-led) and
+ * nothing else. Comments are stripped and string/identifier contents are
+ * blanked before keyword checks, so denied keywords inside literals (e.g.
+ * `WHERE note = 'delete this'`) never false-positive, and comment/quote
+ * tricks cannot smuggle a second statement past the check.
+ */
+interface SqlGuardResult {
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * Verify `sql` is a single read-only SELECT statement.
+ * Returns `{ ok: false, reason }` for anything else.
+ */
+declare function assertReadOnlySelect(sql: string): SqlGuardResult;
+
+/**
+ * Database Integration for Almadar
+ * Read-only SQL queries over external connections (migration fetch seam).
+ */
+
+/**
+ * Generic database integration. One action — `query` — with read-only
+ * enforced in the integration itself (single SELECT only, statement
+ * timeout). `connectionRef` is an environment variable NAME, never the
+ * secret; the connection string is resolved from `process.env` at run time.
+ */
+declare class DatabaseIntegration extends BaseIntegration {
+    private drivers;
+    private statementTimeoutMs;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: IntegrationParams): Promise<IntegrationResult>;
+    private runQuery;
+    /** Resolve (and cache) the driver for a connection reference. */
+    private driverFor;
+}
+
+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 };