@ductape/sdk 0.4.5 → 0.4.6

package/dist/database/sql-context.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileSqlContext = compileSqlContext;
+function compileSqlContext(table, context, postgres) {
+    var _a;
+    const id = (value) => {
+        if (typeof value !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(value))
+            throw new Error('Invalid SQL context identifier');
+        return postgres ? `"${value}"` : '`' + value + '`';
+    };
+    const aliases = new Set(['root']);
+    for (const join of context.joins || []) {
+        id(join.alias);
+        if (aliases.has(join.alias))
+            throw new Error('Duplicate SQL alias');
+        aliases.add(join.alias);
+    }
+    const field = (value) => {
+        if (typeof value !== 'string')
+            throw new Error('Invalid SQL field');
+        const parts = value.split('.');
+        if (parts.length !== 2 || !aliases.has(parts[0]))
+            throw new Error('Use alias.column for SQL fields');
+        return parts.map(id).join('.');
+    };
+    const params = [];
+    const where = (values) => {
+        if (!values || !Object.keys(values).length)
+            throw new Error('Explicit ownership predicates required');
+        return Object.entries(values).map(([key, value]) => {
+            if (value === null)
+                return `${field(key)} IS NULL`;
+            if (!['string', 'number', 'boolean'].includes(typeof value) || (typeof value === 'number' && !Number.isFinite(value)))
+                throw new Error('SQL context predicates require scalar values');
+            params.push(value);
+            return `${field(key)} = ${postgres ? '$' + params.length : '?'}`;
+        }).join(' AND ');
+    };
+    if (!context.select || !Object.keys(context.select).length || Object.keys(context.select).length > 100
+        || !Number.isInteger(context.limit) || context.limit < 1 || context.limit > 100 || (((_a = context.joins) === null || _a === void 0 ? void 0 : _a.length) || 0) > 8)
+        throw new Error('SQL context bounds exceeded');
+    const select = Object.entries(context.select).map(([alias, column]) => `${field(column)} AS ${id(alias)}`).join(', ');
+    const joins = (context.joins || []).map(join => {
+        if (!join.on || !Object.keys(join.on).length || (join.kind && !['left', 'inner'].includes(join.kind)))
+            throw new Error('Invalid context join');
+        const on = Object.entries(join.on).map(([a, b]) => `${field(a)} = ${field(b)}`).join(' AND ');
+        return `${join.kind === 'inner' ? 'INNER' : 'LEFT'} JOIN ${id(join.table)} AS ${id(join.alias)} ON (${on}) AND (${where(join.where)})`;
+    }).join(' ');
+    return { query: `SELECT ${select} FROM ${id(table)} AS ${id('root')} ${joins} WHERE ${where(context.where)} LIMIT ${context.limit}`, params };
+}
+//# sourceMappingURL=sql-context.js.map

package/dist/database/sql-context.js.map

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

package/dist/database/types/index.d.ts

@@ -13,3 +13,4 @@ export { IActionDefinition, IActionTemplate, IActionOrderBy, IActionCreateOption
 export { PreSaveOperationType, IPreSaveOperation, IPreSaveBaseOptions, IPreSaveEncryptOptions, IPreSaveHashOptions, IPreSaveMaskOptions, IPreSaveValidateOptions, IPreSaveTransformOptions, IPreSaveSlugOptions, IPreSaveTruncateOptions, IPreSaveRoundOptions, IPreSaveClampOptions, IPreSaveDefaultOptions, IPreSaveComputeOptions, IPreSaveSimpleOptions, IValidationRule, IValidationError, IPreSaveConfig, IPreSaveResult, IAppliedOperation, ISchemaPreSaveConfig, } from './presave.interface';
 export { TriggerEvent, TriggerTiming, TriggerActionType, ConditionOperator, ITriggerActionBase, ITriggerDatabaseAction, ITriggerStorageAction, ITriggerNotificationAction, ITriggerBrokerAction, ITriggerCacheAction, ITriggerFeatureAction, ITriggerActionExecuteAction, ITriggerAgentAction, ITriggerResilienceAction, ITriggerLogAction, ITriggerSessionAction, ITriggerVectorAction, ITriggerCustomAction, ITriggerHttpAction, ITriggerAction, IConditionClause, ITriggerCondition, ITriggerContext, ITriggerRetry, ITriggerDefinition, ITriggerActionResult, ITriggerResult, ITriggerConfig, ISchemaTriggerConfig, } from './trigger.interface';
 export { IFetchDatabaseDashboardOptions, IDatabaseDashboardMetrics, } from './dashboard.interface';
+export type { IMongoPipelineOptions, IMongoPipelineResult } from './pipeline.interface';

package/dist/database/types/pipeline.interface.d.ts

@@ -0,0 +1,19 @@
+import { ITransaction } from './transaction.interface';
+/** MongoDB read pipeline. Ownership predicates must be supplied for roots and lookups. */
+export interface IMongoPipelineOptions {
+    product: string;
+    env: string;
+    database: string;
+    table: string;
+    pipeline: Record<string, unknown>[];
+    session?: string;
+    transaction?: ITransaction;
+    maxTimeMS?: number;
+    allowDiskUse?: boolean;
+}
+export interface IMongoPipelineResult<T> {
+    data: T[];
+    /** Number of returned documents, not an independent total-count query. */
+    count: number;
+}
+export declare function validateReadPipeline(pipeline: unknown): asserts pipeline is Record<string, unknown>[];

package/dist/database/types/pipeline.interface.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateReadPipeline = validateReadPipeline;
+function validateReadPipeline(pipeline) {
+    if (!Array.isArray(pipeline))
+        throw new Error('MongoDB pipeline must be an array');
+    const visit = (value) => {
+        if (!value || typeof value !== 'object')
+            return;
+        for (const [key, child] of Object.entries(value)) {
+            if (key === '$out' || key === '$merge')
+                throw new Error('aggregatePipeline is read-only');
+            visit(child);
+        }
+    };
+    for (const stage of pipeline) {
+        if (!stage || typeof stage !== 'object' || Array.isArray(stage) || Object.keys(stage).length !== 1)
+            throw new Error('Each MongoDB pipeline stage must have exactly one operator');
+        visit(stage);
+    }
+}
+//# sourceMappingURL=pipeline.interface.js.map

package/dist/database/types/pipeline.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.interface.js","sourceRoot":"","sources":["../../../src/database/types/pipeline.interface.ts"],"names":[],"mappings":";;AAqBA,oDAcC;AAdD,SAAgB,oBAAoB,CAAC,QAAiB;IACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,CAAC,KAAc,EAAQ,EAAE;QACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO;QAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC1F,KAAK,CAAC,KAAK,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;YAChG,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -236,6 +236,9 @@ export { AgentExecutor, AgentContext, ToolRegistry, MemoryManager, createLLMProv
 export type { IAgentServiceConfig, IDefineAgentOptions, IDefinedAgent, IRunAgentOptions, IAgentExecutionResult, IDispatchAgentOptions, IDispatchAgentResult, ISendAgentSignalOptions, IAgentStatusOptions, IAgentState, IListAgentExecutionsOptions, IAgentExecutionListResult, IAgentTool, IAgentToolSchema, IToolParam, IToolCallResult, ILLMConfig, LLMProvider, IAgentMemoryConfig, IAgentTerminationConfig, IAgentStreamEvent, IAgentToolContext, IConversationMessage, ITokenUsage, AgentStatus, IHumanInLoopConfig, IApprovalRequest, IApprovalResponse, IMultiAgentWorkflow, MultiAgentMode, } from './agents';
 export { deriveDatabaseActionOutputContract, validateDatabaseActionOutput } from './database';
 export { AtomicBatchOptions, AtomicBatchOperation, AtomicBatchResult, AtomicBatchError } from './database/atomic-batch';
+export type { IMongoPipelineOptions, IMongoPipelineResult } from './database/types/pipeline.interface';
+export type { AtomicPipelineOptions, AtomicPipelineResult } from './database/atomic-pipeline';
+export type { SqlContext } from './database/sql-context';
 export type { IActionResult, IQueryActionResult, IInsertActionResult, IUpdateActionResult, IDeleteActionResult, IRawActionResult, IDatabaseActionSchemaNode, IDatabaseActionOutputContract, IDatabaseActionOutputValidation, IDatabaseTableColumnMetadata, } from './database';
 export { StorageService, StorageError } from './storage';
 export { uploadBlobToCloud, downloadBlobFromCloud, deleteBlobFromCloud, listBlobsInCloud, generateSignedUrl, } from './storage';
@@ -1925,6 +1928,8 @@ export default class Ductape implements IDuctape {
         /**
          * Perform multiple aggregations in one query
          */
+        aggregatePipeline: <T = Record<string, unknown>>(options: Parameters<DatabaseService["aggregatePipeline"]>[0]) => Promise<import("./database").IMongoPipelineResult<T>>;
+        atomicPipeline: <T = Record<string, unknown>>(options: Parameters<DatabaseService["atomicPipeline"]>[0]) => Promise<import("./database/atomic-pipeline").AtomicPipelineResult<T>>;
         aggregate: (options: Parameters<DatabaseService["aggregate"]>[0]) => Promise<import("./database").IAggregateResult>;
         /**
          * Begin a database transaction
@@ -4408,7 +4413,7 @@ export default class Ductape implements IDuctape {
                 refreshedAt?: number;
                 error?: string;
             };
-            connections: "degraded" | "ready" | "warming";
+            connections: "ready" | "warming" | "degraded";
         };
         warmup: {
             databases: {

package/dist/index.js

@@ -2490,6 +2490,14 @@ class Ductape {
             /**
              * Perform multiple aggregations in one query
              */
+            aggregatePipeline: async (options) => {
+                const service = await this.createNewDatabaseService();
+                return service.aggregatePipeline(options);
+            },
+            atomicPipeline: async (options) => {
+                const service = await this.createNewDatabaseService();
+                return service.atomicPipeline(options);
+            },
             aggregate: async (options) => {
                 const service = await this.createNewDatabaseService();
                 return service.aggregate(options);