@ductape/sdk 0.1.19 → 0.1.21

package/dist/products/bootstrap-cache.d.ts

@@ -0,0 +1,22 @@
+import type { RedisClientType } from 'redis';
+import type { IBootstrapWorkflowStep } from '../api/services/productsApi.service';
+/** TTL for bootstrap cache (same component version = same bootstrap). 5 minutes. */
+export declare const BOOTSTRAP_CACHE_TTL_MS: number;
+export declare const BOOTSTRAP_REDIS_PREFIX = "ductape:bootstrap:";
+export type BootstrapDomain = 'action' | 'notification' | 'storage' | 'session' | 'database' | 'broker' | 'graph' | 'vector' | 'resilience' | 'intelligence' | 'workflow';
+export declare function buildBootstrapCacheKey(domain: BootstrapDomain, workspaceId: string, parts: Array<string | undefined | null>): string;
+export declare function hashWorkflowSteps(steps: IBootstrapWorkflowStep[]): string;
+/**
+ * Tiered bootstrap response cache: in-memory first, optional Redis (encrypted with workspace key).
+ * Keys: domain:workspaceId:product:env:tag…
+ */
+export declare class BootstrapCache {
+    private readonly workspaceId;
+    private readonly redisClient?;
+    private readonly encryptionKey?;
+    private readonly internal;
+    constructor(workspaceId: string, redisClient?: RedisClientType, encryptionKey?: string | null);
+    get<T>(key: string): Promise<T | null>;
+    set(key: string, data: unknown): void;
+    clear(): void;
+}

package/dist/products/bootstrap-cache.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BootstrapCache = exports.BOOTSTRAP_REDIS_PREFIX = exports.BOOTSTRAP_CACHE_TTL_MS = void 0;
+exports.buildBootstrapCacheKey = buildBootstrapCacheKey;
+exports.hashWorkflowSteps = hashWorkflowSteps;
+const crypto_1 = require("crypto");
+const processor_utils_1 = require("../processor/utils/processor.utils");
+/** TTL for bootstrap cache (same component version = same bootstrap). 5 minutes. */
+exports.BOOTSTRAP_CACHE_TTL_MS = 5 * 60 * 1000;
+exports.BOOTSTRAP_REDIS_PREFIX = 'ductape:bootstrap:';
+function buildBootstrapCacheKey(domain, workspaceId, parts) {
+    const scope = parts
+        .map((p) => (p == null ? '' : String(p)))
+        .join(':');
+    return `${exports.BOOTSTRAP_REDIS_PREFIX}${domain}:${workspaceId}:${scope}`;
+}
+function hashWorkflowSteps(steps) {
+    const stable = [...steps].sort((a, b) => a.step_tag.localeCompare(b.step_tag));
+    return (0, crypto_1.createHash)('sha256').update(JSON.stringify(stable)).digest('hex').slice(0, 16);
+}
+/**
+ * Tiered bootstrap response cache: in-memory first, optional Redis (encrypted with workspace key).
+ * Keys: domain:workspaceId:product:env:tag…
+ */
+class BootstrapCache {
+    constructor(workspaceId, redisClient, encryptionKey) {
+        this.workspaceId = workspaceId;
+        this.redisClient = redisClient;
+        this.encryptionKey = encryptionKey;
+        this.internal = new Map();
+    }
+    async get(key) {
+        const now = Date.now();
+        const entry = this.internal.get(key);
+        if (entry && now - entry.storedAt < exports.BOOTSTRAP_CACHE_TTL_MS) {
+            return entry.data;
+        }
+        if (entry) {
+            this.internal.delete(key);
+        }
+        if (!this.redisClient || !this.encryptionKey) {
+            return null;
+        }
+        try {
+            const redis = this.redisClient;
+            const raw = await redis.get(key);
+            if (!raw)
+                return null;
+            const decrypted = (0, processor_utils_1.decrypt)(raw, this.encryptionKey);
+            const data = JSON.parse(decrypted);
+            this.internal.set(key, { data, storedAt: now });
+            return data;
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    set(key, data) {
+        const now = Date.now();
+        this.internal.set(key, { data, storedAt: now });
+        if (!this.redisClient || !this.encryptionKey)
+            return;
+        const ttlSeconds = Math.ceil(exports.BOOTSTRAP_CACHE_TTL_MS / 1000);
+        try {
+            const redis = this.redisClient;
+            const encrypted = (0, processor_utils_1.encrypt)(JSON.stringify(data), this.encryptionKey);
+            redis.setEx(key, ttlSeconds, encrypted).catch(() => undefined);
+        }
+        catch (_a) {
+            // ignore
+        }
+    }
+    clear() {
+        this.internal.clear();
+    }
+}
+exports.BootstrapCache = BootstrapCache;
+//# sourceMappingURL=bootstrap-cache.js.map

package/dist/products/bootstrap-cache.js.map

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

package/dist/products/services/products.service.d.ts

@@ -1,4 +1,4 @@
-import { IBootstrapActionParams, IBootstrapActionResponse, IBootstrapNotificationParams, IBootstrapNotificationResponse, IBootstrapStorageParams, IBootstrapStorageResponse, IBootstrapWorkflowParams, IGenerateExecutablePayloadParams, IGenerateExecutablePayloadResponse } from '../../api/services/productsApi.service';
+import { IBootstrapActionParams, IBootstrapActionResponse, IBootstrapNotificationParams, IBootstrapNotificationResponse, IBootstrapStorageParams, IBootstrapStorageResponse, IBootstrapSessionParams, IBootstrapSessionResponse, IBootstrapDatabaseParams, IBootstrapDatabaseResponse, IBootstrapBrokerParams, IBootstrapBrokerResponse, IBootstrapGraphParams, IBootstrapGraphResponse, IBootstrapVectorParams, IBootstrapVectorResponse, IBootstrapResilienceParams, IBootstrapResilienceResponse, IBootstrapIntelligenceParams, IBootstrapIntelligenceResponse, IBootstrapWorkflowParams, IGenerateExecutablePayloadParams, IGenerateExecutablePayloadResponse } from '../../api/services/productsApi.service';
 import { IApp, IAppAccess, IAppAction, IAppWebhook, ISample, IVersion } from '../../types/appBuilder.types';
 import { IBuilderInit } from '../../types/index.types';
 import { IActionDataParserInput, IActionRequest, ICreateProductsBuilder, IFeatureEvent, IFeatureInput, IFeatureSequence, IProduct, IProductApp, IProductCache, IProductDatabase, IProductDatabaseAction, IProductEnv, IProductFeature, IProductFunction, IProductJobs, IParseActionEventInput, IParseInputStringInput, IParseInputStringMetaData, IProductStorage, IDbActionRequest, INotificationRequest, IProductQuota, IProductFallback, IProductDatabaseMigration, IQuotaOptions, IFallbackOptions, IProductSession, IFetchFilesPayload, IFetchUsersPayload, IProductAppHealth, IProductGraph, IProductWorkflow, IProductVector, IProductAgent, IProductLLMModel, IProductDatabaseTrigger, IProductVectorAction } from '../../types/productsBuilder.types';
@@ -10,7 +10,7 @@ export interface IProductsBuilderService {
     fetchWorkspaceId(): string;
     fetchProductId(): string;
     fetchThirdPartyAppByAccessTag(access_tag: string): Promise<(IApp & IVersion) | null>;
-    createProduct(data: ICreateProductsBuilder): Promise<void>;
+    createProduct(data: ICreateProductsBuilder): Promise<IProduct>;
     updateProduct(data: Partial<IProduct>): Promise<void>;
     initializeProduct(product_id: string): Promise<void>;
     fetchProduct(): Promise<IProduct>;
@@ -19,6 +19,13 @@ export interface IProductsBuilderService {
     applyBootstrapActionResult(result: IBootstrapActionResponse, product_tag?: string): void;
     bootstrapNotification(params: IBootstrapNotificationParams): Promise<IBootstrapNotificationResponse>;
     bootstrapStorage(params: IBootstrapStorageParams): Promise<IBootstrapStorageResponse>;
+    bootstrapSession(params: IBootstrapSessionParams): Promise<IBootstrapSessionResponse>;
+    bootstrapDatabase(params: IBootstrapDatabaseParams): Promise<IBootstrapDatabaseResponse>;
+    bootstrapBroker(params: IBootstrapBrokerParams): Promise<IBootstrapBrokerResponse>;
+    bootstrapGraph(params: IBootstrapGraphParams): Promise<IBootstrapGraphResponse>;
+    bootstrapVector(params: IBootstrapVectorParams): Promise<IBootstrapVectorResponse>;
+    bootstrapResilience(params: IBootstrapResilienceParams): Promise<IBootstrapResilienceResponse>;
+    bootstrapIntelligence(params: IBootstrapIntelligenceParams): Promise<IBootstrapIntelligenceResponse>;
     bootstrapWorkflow(params: Omit<IBootstrapWorkflowParams, 'workspace_id'>): Promise<Record<string, unknown>>;
     generateExecutablePayload(params: IGenerateExecutablePayloadParams): Promise<IGenerateExecutablePayloadResponse>;
     createEnv(data: Partial<IProductEnv>): Promise<void>;
@@ -127,7 +134,7 @@ export interface IProductsBuilderService {
     fetchWorkflow(tag: string): Promise<IProductWorkflow | null>;
     fetchWorkflows(): Promise<Array<IProductWorkflow>>;
     deleteWorkflow(tag: string): Promise<void>;
-    createAppAccessTag(app_tag: string): Promise<IAppAccess>;
+    createAppAccessTag(app_tag: string, known_app_id?: string): Promise<IAppAccess>;
     extractStages(input: string): Array<string | number>;
     updateDataValidation(tag: string, update: Partial<IParsedSample>): Promise<boolean>;
     fetchStorageFiles(filter: IFetchFilesPayload): Promise<Array<IFileURLPayload>>;
@@ -160,10 +167,13 @@ export default class ProductsBuilderService implements IProductsBuilderService {
     /** In-memory cache for the current product run (cleared on init) to avoid repeated API calls in workflows */
     private brokerCache;
     private envCache;
+    private readonly bootstrapCache;
     /** Only log when DUCTAPE_DEBUG is set (avoids sync I/O cost in workflow hot path) */
     private static _debug;
     private _debugLog;
     constructor({ workspace_id, public_key, user_id, token, env_type, redis_client, queues, access_key, workspace_private_key }: IBuilderInit);
+    private applyBootstrapProductContext;
+    private cachedBootstrap;
     fetchPrivateKey(): string;
     fetchWorkspaceId(): string;
     fetchProductId(): string;
@@ -177,6 +187,14 @@ export default class ProductsBuilderService implements IProductsBuilderService {
         healthcheck?: string;
         check_interval?: number;
     }): Promise<void>;
+    /** Validate a quota/fallback action provider (app action or product workflow). */
+    validateQuotaFallbackProvider(option: {
+        type?: string;
+        app?: string | null;
+        event: string;
+        healthcheck?: string;
+        check_interval?: number;
+    }): Promise<void>;
     /** Keep in-memory product component arrays in sync after component CRUD (components API can lag). */
     private mergeProductComponent;
     /**
@@ -199,8 +217,22 @@ export default class ProductsBuilderService implements IProductsBuilderService {
         }>;
         onFailure?: any;
     }): Promise<void>;
+    updateHealthcheckFromSchema(schema: {
+        tag: string;
+        name?: string;
+        description?: string;
+        probe?: any;
+        interval: number;
+        retries: number;
+        envs: Array<{
+            slug: string;
+            input?: any;
+            [k: string]: any;
+        }>;
+        onFailure?: any;
+    }): Promise<void>;
     updateDataValidation(selector: string, update: Partial<IParsedSample>): Promise<boolean>;
-    createProduct(data: ICreateProductsBuilder): Promise<void>;
+    createProduct(data: ICreateProductsBuilder): Promise<IProduct>;
     initializeWorkspace(subCheck?: boolean): Promise<void>;
     /**
      * Get the workspace private key for secrets encryption
@@ -222,6 +254,13 @@ export default class ProductsBuilderService implements IProductsBuilderService {
     applyBootstrapActionResult(result: IBootstrapActionResponse, product_tag?: string): void;
     bootstrapNotification(params: IBootstrapNotificationParams): Promise<IBootstrapNotificationResponse>;
     bootstrapStorage(params: IBootstrapStorageParams): Promise<IBootstrapStorageResponse>;
+    bootstrapSession(params: IBootstrapSessionParams): Promise<IBootstrapSessionResponse>;
+    bootstrapDatabase(params: IBootstrapDatabaseParams): Promise<IBootstrapDatabaseResponse>;
+    bootstrapBroker(params: IBootstrapBrokerParams): Promise<IBootstrapBrokerResponse>;
+    bootstrapGraph(params: IBootstrapGraphParams): Promise<IBootstrapGraphResponse>;
+    bootstrapVector(params: IBootstrapVectorParams): Promise<IBootstrapVectorResponse>;
+    bootstrapResilience(params: IBootstrapResilienceParams): Promise<IBootstrapResilienceResponse>;
+    bootstrapIntelligence(params: IBootstrapIntelligenceParams): Promise<IBootstrapIntelligenceResponse>;
     /**
      * Bootstrap workflow - fetch all action/notification/storage data for multiple steps in one API call
      */
@@ -407,7 +446,8 @@ export default class ProductsBuilderService implements IProductsBuilderService {
     private validateVariablesValues;
     private validateAppEnvs;
     private validateAppAuth;
-    createAppAccessTag(app_tag: string): Promise<IAppAccess>;
+    createAppAccessTag(app_tag: string, known_app_id?: string): Promise<IAppAccess>;
+    private accessAppIsLive;
     addApp(app: IProductApp, throwErrorIfExists?: boolean): Promise<void>;
     fetchAppWebhooks(access_tag: string): Promise<Array<IAppWebhook>>;
     updateApp(access_tag: string, data: Partial<IProductApp>): Promise<void>;
@@ -494,6 +534,9 @@ export default class ProductsBuilderService implements IProductsBuilderService {
     updateDatabase(tag: string, data: Partial<IProductDatabase>): Promise<void>;
     fetchDatabases(): Promise<Array<IProductDatabase>>;
     fetchDatabase(tag: string): Promise<IProductDatabase | null>;
+    /** Resolve database config from in-memory product cache, falling back to API fetch. */
+    private resolveDatabaseConfig;
+    private normalizeDatabaseTriggers;
     deleteDatabase(tag: string): Promise<void>;
     createGraph(data: Partial<IProductGraph>, throwErrorIfExists?: boolean): Promise<void>;
     updateGraph(tag: string, data: Partial<IProductGraph>): Promise<void>;