@ductape/sdk 0.0.4-v9 → 0.0.4-v90

package/dist/models/models.service.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Model Service
+ *
+ * Service for managing LLM model configurations.
+ * Models can be referenced by tag in agent definitions for centralized
+ * API key management and configuration.
+ */
+import ProductBuilder from '../products/services/products.service';
+import { IProductLLMModel } from '../types/productsBuilder.types';
+/**
+ * Configuration for ModelService
+ */
+export interface IModelServiceConfig {
+    workspace_id: string;
+    user_id: string;
+    env_type: string;
+}
+/**
+ * Input for creating a model
+ */
+export interface ICreateModelInput extends Omit<IProductLLMModel, '_id' | 'created_at' | 'updated_at'> {
+    product: string;
+}
+/**
+ * Input for updating a model
+ */
+export interface IUpdateModelInput extends Partial<Omit<IProductLLMModel, '_id' | 'created_at' | 'updated_at'>> {
+    product: string;
+    tag: string;
+}
+/**
+ * Input for fetching a model
+ */
+export interface IFetchModelInput {
+    product: string;
+    tag: string;
+}
+/**
+ * Input for fetching all models
+ */
+export interface IFetchAllModelsInput {
+    product: string;
+}
+/**
+ * Input for deleting a model
+ */
+export interface IDeleteModelInput {
+    product: string;
+    tag: string;
+}
+/**
+ * Model Service
+ *
+ * Provides CRUD operations for LLM model configurations.
+ */
+export declare class ModelService {
+    private config;
+    private productBuilders;
+    private getProductBuilder;
+    constructor(config: IModelServiceConfig, getProductBuilder: (productTag: string) => Promise<ProductBuilder>);
+    /**
+     * Update service configuration
+     */
+    updateConfig(config: IModelServiceConfig): void;
+    /**
+     * Create a new LLM model configuration
+     *
+     * @example
+     * ```typescript
+     * await ductape.model.create({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     *   name: 'Claude Sonnet',
+     *   provider: 'anthropic',
+     *   model: 'claude-sonnet-4-20250514',
+     *   temperature: 0.7,
+     *   envs: [
+     *     { slug: 'dev', apiKey: process.env.ANTHROPIC_API_KEY },
+     *     { slug: 'prd', apiKey: process.env.ANTHROPIC_PROD_KEY },
+     *   ],
+     * });
+     * ```
+     */
+    create(input: ICreateModelInput): Promise<IProductLLMModel>;
+    /**
+     * Update an existing LLM model configuration
+     *
+     * @example
+     * ```typescript
+     * await ductape.model.update({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     *   temperature: 0.5,
+     *   envs: [
+     *     { slug: 'prd', apiKey: 'new-api-key' },
+     *   ],
+     * });
+     * ```
+     */
+    update(input: IUpdateModelInput): Promise<IProductLLMModel>;
+    /**
+     * Fetch a specific LLM model configuration by tag
+     *
+     * @example
+     * ```typescript
+     * const model = await ductape.model.fetch({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     * });
+     * ```
+     */
+    fetch(input: IFetchModelInput): Promise<IProductLLMModel | null>;
+    /**
+     * Fetch all LLM model configurations for a product
+     *
+     * @example
+     * ```typescript
+     * const models = await ductape.model.fetchAll({
+     *   product: 'my-product',
+     * });
+     * ```
+     */
+    fetchAll(input: IFetchAllModelsInput): Promise<IProductLLMModel[]>;
+    /**
+     * Delete an LLM model configuration
+     *
+     * @example
+     * ```typescript
+     * await ductape.model.delete({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     * });
+     * ```
+     */
+    delete(input: IDeleteModelInput): Promise<void>;
+}
+export default ModelService;

package/dist/models/models.service.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Model Service
+ *
+ * Service for managing LLM model configurations.
+ * Models can be referenced by tag in agent definitions for centralized
+ * API key management and configuration.
+ */
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelService = void 0;
+const processor_utils_1 = require("../processor/utils/processor.utils");
+const validators_1 = require("../products/validators");
+const secrets_1 = require("../secrets");
+/**
+ * Model Service
+ *
+ * Provides CRUD operations for LLM model configurations.
+ */
+class ModelService {
+    constructor(config, getProductBuilder) {
+        this.config = null;
+        this.productBuilders = new Map();
+        this.config = config;
+        this.getProductBuilder = getProductBuilder;
+    }
+    /**
+     * Update service configuration
+     */
+    updateConfig(config) {
+        this.config = config;
+    }
+    /**
+     * Create a new LLM model configuration
+     *
+     * @example
+     * ```typescript
+     * await ductape.model.create({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     *   name: 'Claude Sonnet',
+     *   provider: 'anthropic',
+     *   model: 'claude-sonnet-4-20250514',
+     *   temperature: 0.7,
+     *   envs: [
+     *     { slug: 'dev', apiKey: process.env.ANTHROPIC_API_KEY },
+     *     { slug: 'prd', apiKey: process.env.ANTHROPIC_PROD_KEY },
+     *   ],
+     * });
+     * ```
+     */
+    async create(input) {
+        const { product } = input, modelData = __rest(input, ["product"]);
+        const productBuilder = await this.getProductBuilder(product);
+        // Check if model already exists
+        const existing = await productBuilder.fetchModel(modelData.tag);
+        if (existing) {
+            throw new Error(`Model with tag '${modelData.tag}' already exists`);
+        }
+        // Validate input
+        await validators_1.CreateProductModelSchema.validateAsync(modelData);
+        // Encrypt API keys (skip if it's a secret reference)
+        const privateKey = productBuilder.fetchPrivateKey();
+        const processedEnvs = modelData.envs.map(env => {
+            if (env.apiKey && privateKey) {
+                // Don't encrypt if it's a $Secret{key} reference - store as-is for runtime resolution
+                if ((0, secrets_1.isSecretReference)(env.apiKey).isSecret) {
+                    return env;
+                }
+                return Object.assign(Object.assign({}, env), { apiKey: (0, processor_utils_1.encrypt)(env.apiKey, privateKey) });
+            }
+            return env;
+        });
+        // Validate all product envs are covered
+        const productEnvs = await productBuilder.fetchEnvs();
+        for (const env of productEnvs) {
+            const found = processedEnvs.find(e => e.slug === env.slug);
+            if (!found) {
+                throw new Error(`Product env '${env.slug}' is not defined. Please provide API key configuration for all environments.`);
+            }
+        }
+        const data = Object.assign(Object.assign({}, modelData), { envs: processedEnvs });
+        await productBuilder.createModel(data);
+        // Return the created model
+        return (await productBuilder.fetchModel(modelData.tag));
+    }
+    /**
+     * Update an existing LLM model configuration
+     *
+     * @example
+     * ```typescript
+     * await ductape.model.update({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     *   temperature: 0.5,
+     *   envs: [
+     *     { slug: 'prd', apiKey: 'new-api-key' },
+     *   ],
+     * });
+     * ```
+     */
+    async update(input) {
+        const { product, tag } = input, updateData = __rest(input, ["product", "tag"]);
+        const productBuilder = await this.getProductBuilder(product);
+        // Check model exists
+        const existing = await productBuilder.fetchModel(tag);
+        if (!existing) {
+            throw new Error(`Model with tag '${tag}' not found`);
+        }
+        // Validate input
+        await validators_1.UpdateProductModelSchema.validateAsync(updateData);
+        // If updating envs, encrypt API keys (skip if it's a secret reference)
+        if (updateData.envs) {
+            const privateKey = productBuilder.fetchPrivateKey();
+            updateData.envs = updateData.envs.map(env => {
+                if (env.apiKey && privateKey) {
+                    // Don't encrypt if it's a $Secret{key} reference - store as-is for runtime resolution
+                    if ((0, secrets_1.isSecretReference)(env.apiKey).isSecret) {
+                        return env;
+                    }
+                    return Object.assign(Object.assign({}, env), { apiKey: (0, processor_utils_1.encrypt)(env.apiKey, privateKey) });
+                }
+                return env;
+            });
+        }
+        await productBuilder.updateModel(tag, updateData);
+        // Return updated model
+        return (await productBuilder.fetchModel(tag));
+    }
+    /**
+     * Fetch a specific LLM model configuration by tag
+     *
+     * @example
+     * ```typescript
+     * const model = await ductape.model.fetch({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     * });
+     * ```
+     */
+    async fetch(input) {
+        const { product, tag } = input;
+        const productBuilder = await this.getProductBuilder(product);
+        return productBuilder.fetchModel(tag);
+    }
+    /**
+     * Fetch all LLM model configurations for a product
+     *
+     * @example
+     * ```typescript
+     * const models = await ductape.model.fetchAll({
+     *   product: 'my-product',
+     * });
+     * ```
+     */
+    async fetchAll(input) {
+        const { product } = input;
+        const productBuilder = await this.getProductBuilder(product);
+        return productBuilder.fetchModels();
+    }
+    /**
+     * Delete an LLM model configuration
+     *
+     * @example
+     * ```typescript
+     * await ductape.model.delete({
+     *   product: 'my-product',
+     *   tag: 'claude-sonnet',
+     * });
+     * ```
+     */
+    async delete(input) {
+        const { product, tag } = input;
+        const productBuilder = await this.getProductBuilder(product);
+        // Check model exists
+        const existing = await productBuilder.fetchModel(tag);
+        if (!existing) {
+            throw new Error(`Model with tag '${tag}' not found`);
+        }
+        await productBuilder.deleteModel(tag);
+    }
+}
+exports.ModelService = ModelService;
+exports.default = ModelService;
+//# sourceMappingURL=models.service.js.map

package/dist/models/models.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.service.js","sourceRoot":"","sources":["../../src/models/models.service.ts"],"names":[],"mappings":"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"}

package/dist/notifications/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ductape Notifications Module
+ *
+ * A unified interface for sending notifications through multiple channels:
+ * - Push notifications (Firebase, Expo)
+ * - Email (SMTP)
+ * - SMS (Twilio, Nexmo, Plivo)
+ * - Callbacks (HTTP webhooks)
+ *
+ * @module notifications
+ */
+export { NotificationsService, notificationsService } from './notifications.service';
+export { NotificationChannelType, PushNotificationProvider, SmsProvider, EmailProvider, IFirebaseCredential, IPushNotificationHandler, IPushNotificationInput, IPushOptions, IEmailHandler, ISmtpConfig, IMailgunConfig, ISendGridConfig, IPostmarkConfig, IBrevoConfig, IEmailInput, IEmailOptions, ISmsHandler, ISmsInput, ISmsOptions, ICallbackHandler, ICallbackInput, ICallbackOptions, INotificationTemplate, INotificationEnvConfig, INotificationDefinition, INotificationsServiceConfig, INotificationResult, IMultiChannelNotificationResult, INotificationOptions, } from './types';

package/dist/notifications/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Ductape Notifications Module
+ *
+ * A unified interface for sending notifications through multiple channels:
+ * - Push notifications (Firebase, Expo)
+ * - Email (SMTP)
+ * - SMS (Twilio, Nexmo, Plivo)
+ * - Callbacks (HTTP webhooks)
+ *
+ * @module notifications
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailProvider = exports.SmsProvider = exports.PushNotificationProvider = exports.NotificationChannelType = exports.notificationsService = exports.NotificationsService = void 0;
+// ==================== MAIN SERVICE ====================
+var notifications_service_1 = require("./notifications.service");
+Object.defineProperty(exports, "NotificationsService", { enumerable: true, get: function () { return notifications_service_1.NotificationsService; } });
+Object.defineProperty(exports, "notificationsService", { enumerable: true, get: function () { return notifications_service_1.notificationsService; } });
+// ==================== TYPES ====================
+var types_1 = require("./types");
+// Enums
+Object.defineProperty(exports, "NotificationChannelType", { enumerable: true, get: function () { return types_1.NotificationChannelType; } });
+Object.defineProperty(exports, "PushNotificationProvider", { enumerable: true, get: function () { return types_1.PushNotificationProvider; } });
+Object.defineProperty(exports, "SmsProvider", { enumerable: true, get: function () { return types_1.SmsProvider; } });
+Object.defineProperty(exports, "EmailProvider", { enumerable: true, get: function () { return types_1.EmailProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,yDAAyD;AAEzD,iEAAqF;AAA5E,6HAAA,oBAAoB,OAAA;AAAE,6HAAA,oBAAoB,OAAA;AAEnD,kDAAkD;AAElD,iCA+CiB;AA9Cf,QAAQ;AACR,gHAAA,uBAAuB,OAAA;AACvB,iHAAA,wBAAwB,OAAA;AACxB,oGAAA,WAAW,OAAA;AACX,sGAAA,aAAa,OAAA"}

package/dist/notifications/notifications.service.d.ts

@@ -0,0 +1,265 @@
+/**
+ * NotificationsService - Main Notifications Service Class
+ *
+ * Provides a unified interface for sending notifications through multiple channels:
+ * - Push notifications (Firebase, Expo)
+ * - Email (SMTP)
+ * - SMS (Twilio, Nexmo, Plivo)
+ * - Callbacks (HTTP webhooks)
+ */
+import { IDispatchResult } from '../types/processor.types';
+import { INotificationsServiceConfig, INotificationResult, IMultiChannelNotificationResult, IPushOptions, IEmailOptions, ISmsOptions, ICallbackOptions, INotificationOptions } from './types';
+/**
+ * NotificationsService - Send notifications through push, email, SMS, and callbacks
+ *
+ * @example
+ * ```typescript
+ * const notifications = new NotificationsService({
+ *   workspace_id: 'ws-123',
+ *   public_key: 'pk-123',
+ *   user_id: 'user-123',
+ *   token: 'token-123',
+ *   env_type: 'production',
+ * });
+ *
+ * // Send push notification
+ * await notifications.push({
+ *   product: 'my-product',
+ *   env: 'production',
+ *   notification: 'alerts:welcome-message',
+ *   input: {
+ *     device_tokens: ['token1', 'token2'],
+ *     title: { name: 'John' },
+ *     body: { message: 'Welcome!' },
+ *   },
+ * });
+ *
+ * // Send email
+ * await notifications.email({
+ *   product: 'my-product',
+ *   env: 'production',
+ *   notification: 'emails:order-confirmation',
+ *   input: {
+ *     recipients: ['user@example.com'],
+ *     subject: { orderId: '12345' },
+ *     template: { orderDetails: '...' },
+ *   },
+ * });
+ * ```
+ */
+export declare class NotificationsService {
+    /** Service configuration */
+    private config;
+    /** ProductBuilder instances cache (keyed by product tag) */
+    private productBuilders;
+    /** LogService instance for logging operations */
+    private logService;
+    /** Current product ID for logging */
+    private productId;
+    private _privateKey;
+    /** Cache manager for 3-tier caching */
+    private cacheManager;
+    /** Private keys per product for cache encryption */
+    private privateKeys;
+    /**
+     * Create a new NotificationsService instance
+     * @param config - Configuration for authentication and workspace context
+     */
+    constructor(config: INotificationsServiceConfig & {
+        private_key: string;
+    });
+    /**
+     * Create a new ProductBuilder instance
+     */
+    private createNewProductBuilder;
+    /**
+     * Get or create a ProductBuilder instance for the given product tag
+     */
+    private getProductBuilder;
+    /**
+     * Initialize logging service
+     */
+    private initializeLogService;
+    /**
+     * Validate cache tag exists in product and return cache configuration
+     */
+    private validateCache;
+    /**
+     * Create a new ProcessorService instance
+     */
+    private createNewProcessor;
+    /**
+     * Parse notification tag to extract notification and message tags
+     * Format: notification_tag:message_tag
+     */
+    private parseNotificationTag;
+    /**
+     * Build INotificationRequest from channel-specific input
+     */
+    private buildNotificationRequest;
+    /**
+     * Send a push notification
+     *
+     * @param options - Push notification options
+     * @returns Notification result
+     *
+     * @example
+     * ```typescript
+     * const result = await notifications.push({
+     *   product: 'my-product',
+     *   env: 'production',
+     *   notification: 'alerts:welcome',
+     *   input: {
+     *     device_tokens: ['device-token-1', 'device-token-2'],
+     *     title: { name: 'John' },
+     *     body: { message: 'Welcome to our app!' },
+     *     data: { action: 'open_home' },
+     *   },
+     * });
+     * ```
+     */
+    push(options: IPushOptions): Promise<INotificationResult>;
+    /**
+     * Send an email
+     *
+     * @param options - Email options
+     * @returns Notification result
+     *
+     * @example
+     * ```typescript
+     * const result = await notifications.email({
+     *   product: 'my-product',
+     *   env: 'production',
+     *   notification: 'emails:order-confirmation',
+     *   input: {
+     *     recipients: ['user@example.com', 'admin@example.com'],
+     *     subject: { orderId: '12345' },
+     *     template: {
+     *       customerName: 'John Doe',
+     *       orderTotal: '$99.99',
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    email(options: IEmailOptions): Promise<INotificationResult>;
+    /**
+     * Send an SMS
+     *
+     * @param options - SMS options
+     * @returns Notification result
+     *
+     * @example
+     * ```typescript
+     * const result = await notifications.sms({
+     *   product: 'my-product',
+     *   env: 'production',
+     *   notification: 'sms:verification',
+     *   input: {
+     *     recipients: ['+1234567890', '+0987654321'],
+     *     body: { code: '123456' },
+     *   },
+     * });
+     * ```
+     */
+    sms(options: ISmsOptions): Promise<INotificationResult>;
+    /**
+     * Send a callback (HTTP webhook)
+     *
+     * @param options - Callback options
+     * @returns Notification result
+     *
+     * @example
+     * ```typescript
+     * const result = await notifications.callback({
+     *   product: 'my-product',
+     *   env: 'production',
+     *   notification: 'webhooks:order-created',
+     *   input: {
+     *     body: {
+     *       orderId: '12345',
+     *       status: 'created',
+     *       timestamp: Date.now(),
+     *     },
+     *     headers: {
+     *       'X-Custom-Header': 'value',
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    callback(options: ICallbackOptions): Promise<INotificationResult>;
+    /**
+     * Send notifications to multiple channels at once
+     *
+     * @param options - Multi-channel notification options
+     * @returns Results for each channel
+     *
+     * @example
+     * ```typescript
+     * const result = await notifications.send({
+     *   product: 'my-product',
+     *   env: 'production',
+     *   notification: 'alerts:order-placed',
+     *   push_notification: {
+     *     device_tokens: ['token1'],
+     *     title: { order: 'New Order' },
+     *     body: { message: 'Order #12345 placed' },
+     *   },
+     *   email: {
+     *     recipients: ['user@example.com'],
+     *     subject: { orderId: '12345' },
+     *     template: { orderDetails: '...' },
+     *   },
+     *   sms: {
+     *     recipients: ['+1234567890'],
+     *     body: { message: 'Order #12345 placed' },
+     *   },
+     * });
+     * ```
+     */
+    send(options: INotificationOptions): Promise<IMultiChannelNotificationResult>;
+    /**
+     * Schedule a notification to be sent at a later time
+     *
+     * @param options - Notification options with scheduling
+     * @returns Dispatch result with job ID
+     *
+     * @example
+     * ```typescript
+     * const result = await notifications.dispatch({
+     *   product: 'my-product',
+     *   env: 'production',
+     *   notification: 'reminders:payment-due',
+     *   input: {
+     *     push_notification: {
+     *       device_tokens: ['token1'],
+     *       title: { name: 'Payment' },
+     *       body: { message: 'Your payment is due' },
+     *     },
+     *   },
+     *   schedule: {
+     *     start_at: Date.now() + 86400000, // 24 hours from now
+     *   },
+     * });
+     * ```
+     */
+    dispatch(options: INotificationOptions & {
+        schedule: {
+            start_at?: number | string;
+            cron?: string;
+            every?: number;
+            limit?: number;
+            endDate?: number | string;
+            tz?: string;
+        };
+        retries?: number;
+    }): Promise<IDispatchResult>;
+}
+/**
+ * Factory function for creating NotificationsService instances
+ */
+export declare function notificationsService(config: INotificationsServiceConfig & {
+    private_key: string;
+}): NotificationsService;
+export default NotificationsService;