@ductape/sdk 0.0.4-v9 → 0.0.4-v91

package/dist/cache/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Cache Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/cache/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/clients/pricing.client.d.ts

@@ -0,0 +1,3 @@
+import { AxiosInstance } from "axios";
+import { EnvType } from "../types";
+export declare const pricingClient: (auth: string, contentType: string, environment: EnvType) => AxiosInstance;

package/dist/clients/pricing.client.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pricingClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const urls_1 = require("../api/urls");
+const CancelToken = axios_1.default.CancelToken;
+const source = CancelToken.source();
+const requestInterceptor = async (config) => {
+    config.cancelToken = source.token;
+    return config;
+};
+let instance;
+const pricingClient = (auth, contentType, environment) => {
+    if (instance)
+        return instance;
+    instance = axios_1.default.create({
+        baseURL: (0, urls_1.getUrlForEnvironment)(environment, 'pricing'),
+        timeout: 15000,
+        headers: {
+            'Content-Type': contentType,
+            Authorization: auth
+        },
+        withCredentials: false
+    });
+    // @ts-ignore
+    instance.interceptors.request.use(requestInterceptor);
+    return instance;
+};
+exports.pricingClient = pricingClient;
+//# sourceMappingURL=pricing.client.js.map

package/dist/clients/pricing.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.client.js","sourceRoot":"","sources":["../../src/clients/pricing.client.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0D;AAC1D,sCAAmD;AAGnD,MAAM,WAAW,GAAG,eAAK,CAAC,WAAW,CAAC;AACtC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;AACpC,MAAM,kBAAkB,GAAG,KAAK,EAAE,MAAqC,EAAE,EAAE;IACzE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AACF,IAAI,QAAuB,CAAC;AAErB,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,WAAmB,EAAE,WAAoB,EAAE,EAAE;IACvF,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,GAAG,eAAK,CAAC,MAAM,CAAC;QACtB,OAAO,EAAE,IAAA,2BAAoB,EAAC,WAAW,EAAE,SAAS,CAAC;QACrD,OAAO,EAAE,KAAK;QACd,OAAO,EAAE;YACP,cAAc,EAAE,WAAW;YAC3B,aAAa,EAAE,IAAI;SACpB;QACD,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IAEH,aAAa;IACb,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACtD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAfW,QAAA,aAAa,iBAexB"}

package/dist/database/actions/action-manager.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Action Manager
+ *
+ * Manages reusable database actions (query templates).
+ * Actions allow defining common database operations that can be
+ * executed with different input parameters.
+ *
+ * Uses ProductBuilder for persistence to the backend.
+ */
+import { DatabaseActionType } from '../types/enums';
+import { IActionDefinition, IActionTemplate, IActionCreateOptions, IActionUpdateOptions, IActionExecuteOptions, IPlaceholder, IParsedTemplate } from '../types/action.interface';
+import { IWhereClause } from '../types/query.interface';
+/**
+ * DatabaseService reference type (to avoid circular imports)
+ */
+interface IDatabaseServiceRef {
+    getConfig(): {
+        workspace_id: string;
+        public_key: string;
+        user_id: string;
+        token: string;
+        env_type: string;
+    } | null;
+}
+/**
+ * Action Manager for managing reusable database actions
+ * Uses ProductBuilder for persistent storage
+ */
+export declare class ActionManager {
+    private databaseService;
+    private productBuilders;
+    constructor(databaseService: IDatabaseServiceRef);
+    /**
+     * Create a new ProductBuilder instance
+     */
+    private createNewProductBuilder;
+    /**
+     * Get or create a ProductBuilder instance for the given product tag
+     */
+    private getProductBuilder;
+    /**
+     * Create a new database action
+     * @param options Action creation options
+     */
+    create(options: IActionCreateOptions): Promise<void>;
+    /**
+     * Update an existing database action
+     * @param options Action update options
+     */
+    update(options: IActionUpdateOptions): Promise<void>;
+    /**
+     * Fetch a specific database action
+     * @param tag Action tag in format: product:database:action
+     * @returns Action definition or null
+     */
+    fetch(tag: string): Promise<IActionDefinition | null>;
+    /**
+     * Fetch all database actions for a database
+     * @param tag Database tag in format: product:database
+     * @returns Array of action definitions
+     */
+    fetchAll(tag: string): Promise<IActionDefinition[]>;
+    /**
+     * Delete a database action
+     * @param tag Action tag in format: product:database:action
+     */
+    delete(tag: string): Promise<void>;
+    /**
+     * Execute a database action
+     *
+     * Note: Action execution is handled through the ProcessorService.
+     * This method validates the action exists and returns the action definition
+     * for the caller to execute through the appropriate channel.
+     *
+     * @param options Execution options
+     * @returns Action result
+     */
+    execute<T = any>(options: IActionExecuteOptions): Promise<T>;
+    /**
+     * Parse a template and extract placeholders
+     * @param template Action template
+     * @returns Parsed template with placeholder info
+     */
+    parseTemplate(template: IActionTemplate): IParsedTemplate;
+    /**
+     * Extract all placeholders from a template
+     * @param template Action template
+     * @returns Array of placeholder definitions
+     */
+    extractPlaceholders(template: IActionTemplate): IPlaceholder[];
+    /**
+     * Validate input against placeholder requirements
+     * @param template Action template
+     * @param input Input values
+     * @returns True if valid
+     */
+    validateInput(template: IActionTemplate, input: Record<string, any>): boolean;
+    /**
+     * Parse action tag into components
+     * Supports formats:
+     * - product:database:action
+     * - database:action (uses default product)
+     */
+    private parseActionTag;
+    /**
+     * Map internal operation type to ProductDatabaseActionTypes
+     */
+    private mapOperationType;
+    /**
+     * Convert IProductDatabaseAction to IActionDefinition
+     */
+    private convertToActionDefinition;
+    /**
+     * Map ProductDatabaseActionTypes to DatabaseActionType
+     */
+    private mapProductActionType;
+    /**
+     * Parse stored template (may be string or object)
+     */
+    private parseStoredTemplate;
+    /**
+     * Resolve template placeholders with input values
+     */
+    private resolveTemplate;
+    private resolveObject;
+    private resolvePlaceholdersInString;
+}
+/**
+ * Action Builder for fluent action creation
+ */
+export declare class ActionBuilder {
+    private options;
+    /**
+     * Set action name
+     */
+    name(name: string): this;
+    /**
+     * Set action tag
+     */
+    tag(tag: string): this;
+    /**
+     * Set table name
+     */
+    table(tableName: string): this;
+    /**
+     * Set operation type
+     */
+    operation(operation: DatabaseActionType | string): this;
+    /**
+     * Set description
+     */
+    description(description: string): this;
+    /**
+     * Set template
+     */
+    template(template: IActionTemplate): this;
+    /**
+     * Set filter template
+     */
+    filter(filterTemplate: IWhereClause): this;
+    /**
+     * Build the action options
+     */
+    build(): IActionCreateOptions;
+}
+/**
+ * Create a new action builder
+ */
+export declare function createAction(): ActionBuilder;
+export {};

package/dist/database/actions/action-manager.js

@@ -0,0 +1,465 @@
+"use strict";
+/**
+ * Action Manager
+ *
+ * Manages reusable database actions (query templates).
+ * Actions allow defining common database operations that can be
+ * executed with different input parameters.
+ *
+ * Uses ProductBuilder for persistence to the backend.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionBuilder = exports.ActionManager = void 0;
+exports.createAction = createAction;
+const enums_1 = require("../types/enums");
+const database_error_1 = require("../utils/database-error");
+const products_service_1 = __importDefault(require("../../products/services/products.service"));
+const types_1 = require("../../types");
+/**
+ * Placeholder regex pattern: {{variableName}}
+ */
+const PLACEHOLDER_REGEX = /\{\{(\w+)\}\}/g;
+/**
+ * Action Manager for managing reusable database actions
+ * Uses ProductBuilder for persistent storage
+ */
+class ActionManager {
+    constructor(databaseService) {
+        this.productBuilders = new Map();
+        this.databaseService = databaseService;
+    }
+    // ==================== PRODUCT BUILDER MANAGEMENT ====================
+    /**
+     * Create a new ProductBuilder instance
+     */
+    createNewProductBuilder() {
+        const config = this.databaseService.getConfig();
+        if (!config) {
+            throw new database_error_1.DatabaseError('DatabaseService not configured. Please provide config when initializing.', enums_1.DatabaseErrorType.CONFIGURATION_ERROR);
+        }
+        return new products_service_1.default({
+            workspace_id: config.workspace_id,
+            public_key: config.public_key,
+            user_id: config.user_id,
+            token: config.token,
+            env_type: config.env_type,
+        });
+    }
+    /**
+     * Get or create a ProductBuilder instance for the given product tag
+     */
+    async getProductBuilder(productTag) {
+        let builder = this.productBuilders.get(productTag);
+        if (!builder) {
+            builder = this.createNewProductBuilder();
+            await builder.initializeProductByTag(productTag);
+            this.productBuilders.set(productTag, builder);
+        }
+        return builder;
+    }
+    // ==================== ACTION CRUD ====================
+    /**
+     * Create a new database action
+     * @param options Action creation options
+     */
+    async create(options) {
+        // Parse the tag to extract product and database info
+        const { productTag, databaseTag, actionTag } = this.parseActionTag(options.tag);
+        const builder = await this.getProductBuilder(productTag);
+        // Convert IActionCreateOptions to IProductDatabaseAction format
+        const actionData = {
+            name: options.name,
+            tag: `${databaseTag}:${actionTag}`,
+            tableName: options.tableName,
+            type: this.mapOperationType(options.operation),
+            description: options.description,
+            template: options.template,
+            filterTemplate: options.filterTemplate,
+        };
+        await builder.createDatabaseAction(actionData);
+    }
+    /**
+     * Update an existing database action
+     * @param options Action update options
+     */
+    async update(options) {
+        const { productTag, databaseTag, actionTag } = this.parseActionTag(options.tag);
+        const builder = await this.getProductBuilder(productTag);
+        // Convert IActionUpdateOptions to IProductDatabaseAction format
+        const actionData = {
+            tag: `${databaseTag}:${actionTag}`,
+        };
+        if (options.name)
+            actionData.name = options.name;
+        if (options.description)
+            actionData.description = options.description;
+        if (options.template)
+            actionData.template = options.template;
+        if (options.filterTemplate)
+            actionData.filterTemplate = options.filterTemplate;
+        await builder.updateDatabaseAction(actionData);
+    }
+    /**
+     * Fetch a specific database action
+     * @param tag Action tag in format: product:database:action
+     * @returns Action definition or null
+     */
+    async fetch(tag) {
+        const { productTag, databaseTag, actionTag } = this.parseActionTag(tag);
+        const builder = await this.getProductBuilder(productTag);
+        const action = await builder.fetchDatabaseAction(`${databaseTag}:${actionTag}`);
+        if (!action)
+            return null;
+        return this.convertToActionDefinition(action, databaseTag);
+    }
+    /**
+     * Fetch all database actions for a database
+     * @param tag Database tag in format: product:database
+     * @returns Array of action definitions
+     */
+    async fetchAll(tag) {
+        const parts = tag.split(':');
+        if (parts.length < 2) {
+            throw new database_error_1.DatabaseError(`Invalid database tag format. Expected: 'product:database', got: '${tag}'`, enums_1.DatabaseErrorType.VALIDATION_ERROR);
+        }
+        const [productTag, databaseTag] = parts;
+        const builder = await this.getProductBuilder(productTag);
+        const actions = await builder.fetchDatabaseActions(databaseTag);
+        return actions.map(action => this.convertToActionDefinition(action, databaseTag));
+    }
+    /**
+     * Delete a database action
+     * @param tag Action tag in format: product:database:action
+     */
+    async delete(tag) {
+        const { productTag, databaseTag, actionTag } = this.parseActionTag(tag);
+        const builder = await this.getProductBuilder(productTag);
+        await builder.deleteDatabaseAction(`${databaseTag}:${actionTag}`);
+    }
+    // ==================== ACTION EXECUTION ====================
+    /**
+     * Execute a database action
+     *
+     * Note: Action execution is handled through the ProcessorService.
+     * This method validates the action exists and returns the action definition
+     * for the caller to execute through the appropriate channel.
+     *
+     * @param options Execution options
+     * @returns Action result
+     */
+    async execute(options) {
+        const builder = await this.getProductBuilder(options.product);
+        // Fetch the action to get its definition
+        const actionTag = `${options.database}:${options.action}`;
+        const action = await builder.fetchDatabaseAction(actionTag);
+        if (!action) {
+            throw new database_error_1.DatabaseError(`Action with tag '${actionTag}' not found`, enums_1.DatabaseErrorType.NOT_FOUND);
+        }
+        // For now, return the action definition with resolved template
+        // Actual execution happens through ProcessorService or direct adapter calls
+        const resolvedTemplate = this.resolveTemplate(this.parseStoredTemplate(action.template), options.input);
+        // Return action metadata - actual execution should be done through ProcessorService
+        return {
+            action: this.convertToActionDefinition(action, options.database),
+            resolvedTemplate,
+            input: options.input,
+            message: 'Use ProcessorService or direct adapter connection for actual execution',
+        };
+    }
+    // ==================== TEMPLATE PARSING ====================
+    /**
+     * Parse a template and extract placeholders
+     * @param template Action template
+     * @returns Parsed template with placeholder info
+     */
+    parseTemplate(template) {
+        const placeholders = this.extractPlaceholders(template);
+        return {
+            original: template,
+            placeholders,
+            resolve: (input) => this.resolveTemplate(template, input),
+        };
+    }
+    /**
+     * Extract all placeholders from a template
+     * @param template Action template
+     * @returns Array of placeholder definitions
+     */
+    extractPlaceholders(template) {
+        const placeholders = [];
+        const seen = new Set();
+        const extractFromValue = (value) => {
+            if (typeof value === 'string') {
+                let match;
+                while ((match = PLACEHOLDER_REGEX.exec(value)) !== null) {
+                    if (!seen.has(match[1])) {
+                        seen.add(match[1]);
+                        placeholders.push({ name: match[1] });
+                    }
+                }
+                // Reset regex lastIndex
+                PLACEHOLDER_REGEX.lastIndex = 0;
+            }
+            else if (Array.isArray(value)) {
+                value.forEach(extractFromValue);
+            }
+            else if (value && typeof value === 'object') {
+                Object.values(value).forEach(extractFromValue);
+            }
+        };
+        extractFromValue(template);
+        return placeholders;
+    }
+    /**
+     * Validate input against placeholder requirements
+     * @param template Action template
+     * @param input Input values
+     * @returns True if valid
+     */
+    validateInput(template, input) {
+        const parsed = this.parseTemplate(template);
+        for (const placeholder of parsed.placeholders) {
+            if (placeholder.required && !(placeholder.name in input)) {
+                throw database_error_1.DatabaseError.validationError(`Missing required input: ${placeholder.name}`);
+            }
+            if (placeholder.validation && placeholder.name in input) {
+                const regex = new RegExp(placeholder.validation);
+                if (!regex.test(String(input[placeholder.name]))) {
+                    throw database_error_1.DatabaseError.validationError(`Invalid input for ${placeholder.name}: does not match validation pattern`);
+                }
+            }
+        }
+        return true;
+    }
+    // ==================== PRIVATE HELPER METHODS ====================
+    /**
+     * Parse action tag into components
+     * Supports formats:
+     * - product:database:action
+     * - database:action (uses default product)
+     */
+    parseActionTag(tag) {
+        var _a;
+        const parts = tag.split(':');
+        if (parts.length === 3) {
+            return {
+                productTag: parts[0],
+                databaseTag: parts[1],
+                actionTag: parts[2],
+            };
+        }
+        else if (parts.length === 2) {
+            // For backward compatibility, try to infer product from first builder
+            const firstBuilder = this.productBuilders.values().next().value;
+            if (firstBuilder) {
+                return {
+                    productTag: ((_a = firstBuilder.getProductTag) === null || _a === void 0 ? void 0 : _a.call(firstBuilder)) || parts[0],
+                    databaseTag: parts[0],
+                    actionTag: parts[1],
+                };
+            }
+            throw new database_error_1.DatabaseError(`Invalid action tag format. Expected: 'product:database:action' or 'database:action' (with initialized product), got: '${tag}'`, enums_1.DatabaseErrorType.VALIDATION_ERROR);
+        }
+        throw new database_error_1.DatabaseError(`Invalid action tag format. Expected: 'product:database:action', got: '${tag}'`, enums_1.DatabaseErrorType.VALIDATION_ERROR);
+    }
+    /**
+     * Map internal operation type to ProductDatabaseActionTypes
+     */
+    mapOperationType(operation) {
+        const opType = typeof operation === 'string' ? operation.toUpperCase() : operation;
+        switch (opType) {
+            case enums_1.DatabaseActionType.QUERY:
+            case 'QUERY':
+            case 'READ':
+                return types_1.DatabaseActionTypes.READ;
+            case enums_1.DatabaseActionType.INSERT:
+            case 'INSERT':
+            case 'CREATE':
+                return types_1.DatabaseActionTypes.CREATE;
+            case enums_1.DatabaseActionType.UPDATE:
+            case 'UPDATE':
+                return types_1.DatabaseActionTypes.UPDATE;
+            case enums_1.DatabaseActionType.DELETE:
+            case 'DELETE':
+                return types_1.DatabaseActionTypes.DELETE;
+            case enums_1.DatabaseActionType.AGGREGATE:
+            case 'AGGREGATE':
+                return types_1.DatabaseActionTypes.AGGREGATE;
+            case 'COUNT':
+                return types_1.DatabaseActionTypes.COUNT;
+            default:
+                return types_1.DatabaseActionTypes.READ;
+        }
+    }
+    /**
+     * Convert IProductDatabaseAction to IActionDefinition
+     */
+    convertToActionDefinition(action, databaseTag) {
+        return {
+            name: action.name,
+            tag: `${databaseTag}:${action.tag}`,
+            tableName: action.tableName,
+            operation: this.mapProductActionType(action.type),
+            description: action.description,
+            template: this.parseStoredTemplate(action.template),
+            filterTemplate: action.filterTemplate ? this.parseStoredTemplate(action.filterTemplate) : undefined,
+        };
+    }
+    /**
+     * Map ProductDatabaseActionTypes to DatabaseActionType
+     */
+    mapProductActionType(type) {
+        switch (type) {
+            case types_1.DatabaseActionTypes.READ:
+                return enums_1.DatabaseActionType.QUERY;
+            case types_1.DatabaseActionTypes.CREATE:
+                return enums_1.DatabaseActionType.INSERT;
+            case types_1.DatabaseActionTypes.UPDATE:
+                return enums_1.DatabaseActionType.UPDATE;
+            case types_1.DatabaseActionTypes.DELETE:
+                return enums_1.DatabaseActionType.DELETE;
+            case types_1.DatabaseActionTypes.AGGREGATE:
+                return enums_1.DatabaseActionType.AGGREGATE;
+            case types_1.DatabaseActionTypes.COUNT:
+                return enums_1.DatabaseActionType.AGGREGATE;
+            default:
+                return enums_1.DatabaseActionType.QUERY;
+        }
+    }
+    /**
+     * Parse stored template (may be string or object)
+     */
+    parseStoredTemplate(template) {
+        if (typeof template === 'string') {
+            try {
+                return JSON.parse(template);
+            }
+            catch (_a) {
+                // If it's not JSON, treat as raw query
+                return { query: template };
+            }
+        }
+        return template;
+    }
+    /**
+     * Resolve template placeholders with input values
+     */
+    resolveTemplate(template, input) {
+        return this.resolveObject(template, input);
+    }
+    resolveObject(obj, input) {
+        if (obj === null || obj === undefined)
+            return obj;
+        if (typeof obj === 'string') {
+            return this.resolvePlaceholdersInString(obj, input);
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(item => this.resolveObject(item, input));
+        }
+        if (typeof obj === 'object' && !(obj instanceof Date)) {
+            const resolved = {};
+            for (const [key, value] of Object.entries(obj)) {
+                resolved[key] = this.resolveObject(value, input);
+            }
+            return resolved;
+        }
+        return obj;
+    }
+    resolvePlaceholdersInString(str, input) {
+        // Check if the entire string is a single placeholder
+        const singleMatch = str.match(/^\{\{(\w+)\}\}$/);
+        if (singleMatch) {
+            const key = singleMatch[1];
+            return key in input ? input[key] : str;
+        }
+        // Replace multiple placeholders in string
+        return str.replace(PLACEHOLDER_REGEX, (match, key) => {
+            return key in input ? String(input[key]) : match;
+        });
+    }
+}
+exports.ActionManager = ActionManager;
+/**
+ * Action Builder for fluent action creation
+ */
+class ActionBuilder {
+    constructor() {
+        this.options = {};
+    }
+    /**
+     * Set action name
+     */
+    name(name) {
+        this.options.name = name;
+        return this;
+    }
+    /**
+     * Set action tag
+     */
+    tag(tag) {
+        this.options.tag = tag;
+        return this;
+    }
+    /**
+     * Set table name
+     */
+    table(tableName) {
+        this.options.tableName = tableName;
+        return this;
+    }
+    /**
+     * Set operation type
+     */
+    operation(operation) {
+        this.options.operation = operation;
+        return this;
+    }
+    /**
+     * Set description
+     */
+    description(description) {
+        this.options.description = description;
+        return this;
+    }
+    /**
+     * Set template
+     */
+    template(template) {
+        this.options.template = template;
+        return this;
+    }
+    /**
+     * Set filter template
+     */
+    filter(filterTemplate) {
+        this.options.filterTemplate = filterTemplate;
+        return this;
+    }
+    /**
+     * Build the action options
+     */
+    build() {
+        if (!this.options.name)
+            throw new Error('Action name is required');
+        if (!this.options.tag)
+            throw new Error('Action tag is required');
+        if (!this.options.tableName)
+            throw new Error('Table name is required');
+        if (!this.options.operation)
+            throw new Error('Operation type is required');
+        if (!this.options.template)
+            throw new Error('Template is required');
+        return this.options;
+    }
+}
+exports.ActionBuilder = ActionBuilder;
+/**
+ * Create a new action builder
+ */
+function createAction() {
+    return new ActionBuilder();
+}
+//# sourceMappingURL=action-manager.js.map