@almadar/integrations 1.0.15 → 2.0.1

package/LICENSE

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

package/dist/index.d.ts

@@ -211,4 +211,158 @@ declare class CLIIntegration extends BaseIntegration {
     private validate;
 }
 
-export { BaseIntegration, CLIIntegration, ConsoleLogger, DeepAgentIntegration, EmailIntegration, GitHubIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationResult, LLMIntegration, type RetryConfig, StripeIntegration, TwilioIntegration, YouTubeIntegration, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, withRetry };
+/**
+ * Redis / Cache integration with in-memory default backend.
+ *
+ * When `REDIS_URL` is provided in `config.env`, a warning is logged and the
+ * integration falls back to the in-memory store (real Redis client support is
+ * not yet implemented). When `REDIS_URL` is absent the in-memory store is
+ * used silently — this is the expected development mode.
+ */
+declare class RedisIntegration extends BaseIntegration {
+    private store;
+    private locks;
+    private channels;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    /** Remove expired entries on access and return whether a key is alive. */
+    private isAlive;
+    /** Generate a unique lock identifier. */
+    private generateLockId;
+    private getKey;
+    private setKey;
+    private deleteKey;
+    private acquireLock;
+    private releaseLock;
+    private incrementKey;
+    private expireKey;
+    private publishMessage;
+    private subscribeChannel;
+}
+
+/**
+ * Queue integration with in-memory backend.
+ *
+ * Provides job queue semantics: enqueue, dequeue, status tracking,
+ * completion, failure, cancellation, and size queries.
+ */
+declare class QueueIntegration extends BaseIntegration {
+    /** Map from queue name to ordered list of job IDs */
+    private queues;
+    /** Map from job ID to job data */
+    private jobs;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    /** Generate a unique job identifier. */
+    private generateJobId;
+    /** Get or create the queue array for a given queue name. */
+    private getQueue;
+    private enqueue;
+    private dequeue;
+    private status;
+    private complete;
+    private failJob;
+    private cancel;
+    private size;
+}
+
+/**
+ * OpenTelemetry integration with in-memory backend.
+ *
+ * Tracks spans and metrics internally for development and testing purposes.
+ * No actual OpenTelemetry SDK dependency is required.
+ */
+declare class OtelIntegration extends BaseIntegration {
+    private spans;
+    private metrics;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    private startSpan;
+    private endSpan;
+    private addEvent;
+    private recordMetric;
+    private getSpan;
+    private getAllMetrics;
+}
+
+/**
+ * OAuth2/OIDC integration with in-memory mock backend.
+ *
+ * This is a development/mock implementation. No actual OAuth library is used.
+ * State tokens, access tokens, and refresh tokens are generated in-memory and
+ * tracked via Maps. Useful for testing OAuth flows without external providers.
+ */
+declare class OAuthIntegration extends BaseIntegration {
+    /** Maps state token -> provider for pending authorization flows */
+    private states;
+    /** Maps access token -> token set */
+    private tokens;
+    /** Maps refresh token -> access token for refresh lookups */
+    private refreshIndex;
+    /** Maps access token -> mock user session */
+    private sessions;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    /** Generate a random hex token of the given byte length. */
+    private generateToken;
+    /** Generate a mock user profile from a provider and access token. */
+    private generateMockUser;
+    private authorize;
+    private token;
+    private refresh;
+    private revoke;
+    private userinfo;
+}
+
+/**
+ * Storage integration with in-memory backend for development/testing.
+ *
+ * Provides S3-compatible object storage operations (upload, download, list,
+ * delete, getSignedUrl) backed by an in-memory Map. No cloud SDK dependencies
+ * are required.
+ */
+declare class StorageIntegration extends BaseIntegration {
+    private objects;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    /** Build a composite key from bucket and object key. */
+    private compositeKey;
+    /** Generate a deterministic etag from content. */
+    private generateEtag;
+    /** Compute the byte size of content. */
+    private computeSize;
+    private upload;
+    private download;
+    private list;
+    private deleteObject;
+    private getSignedUrl;
+}
+
+/**
+ * Docker/Container integration with in-memory backend for development/testing.
+ *
+ * Provides container lifecycle operations (build, run, stop, remove, logs,
+ * status, list) backed by an in-memory Map. No Docker SDK or daemon connection
+ * is required.
+ */
+declare class DockerIntegration extends BaseIntegration {
+    private containers;
+    private images;
+    constructor(config: IntegrationConfig);
+    execute(action: string, params: Record<string, unknown>): Promise<IntegrationResult>;
+    /** Generate a random hex container/image ID. */
+    private generateId;
+    /** Find a container by ID (prefix match supported). */
+    private findContainer;
+    /** Generate realistic log lines for a container. */
+    private generateLogLines;
+    private build;
+    private run;
+    private stop;
+    private removeContainer;
+    private logs;
+    private status;
+    private list;
+}
+
+export { BaseIntegration, CLIIntegration, ConsoleLogger, DeepAgentIntegration, DockerIntegration, EmailIntegration, GitHubIntegration, IntegrationConfig, type IntegrationConstructor, IntegrationErrorCode, IntegrationLogger, IntegrationResult, LLMIntegration, OAuthIntegration, OtelIntegration, QueueIntegration, RedisIntegration, type RetryConfig, StorageIntegration, StripeIntegration, TwilioIntegration, YouTubeIntegration, getIntegration, getRegisteredIntegrations, isKnownIntegration, registerIntegration, withRetry };