@ductape/sdk 0.4.4 → 0.4.6

package/dist/database/atomic-batch.d.ts

@@ -0,0 +1,58 @@
+import type { ITransaction } from './types/transaction.interface';
+export interface AtomicBatchOperation {
+    name: string;
+    operation: 'insert' | 'update' | 'delete' | 'upsert';
+    table: string;
+    data?: Record<string, unknown> | Record<string, unknown>[];
+    where?: Record<string, unknown>;
+    conflictKeys?: string[];
+    returning?: boolean;
+    /** Exact primitive count, not matched count. MongoDB update counts modified documents. */
+    expectedCount?: number;
+    /** Output label -> JSON pointer into this operation's actual primitive result. */
+    project?: Record<string, string>;
+}
+export interface AtomicBatchOptions {
+    product: string;
+    env: string;
+    database: string;
+    /** Original opaque session, forwarded unchanged to every operation. */
+    session?: string;
+    /** Explicit maintenance classification; does not grant or bypass access. */
+    system?: {
+        reason: string;
+    };
+    transaction?: ITransaction;
+    operations: AtomicBatchOperation[];
+}
+export interface AtomicBatchResult {
+    status: 'committed' | 'pending';
+    transactionId: string;
+    results: Record<string, unknown>;
+}
+export declare class AtomicBatchError extends Error {
+    readonly code: 'BATCH_VALIDATION' | 'BATCH_PREFLIGHT_FAILED' | 'BATCH_GUARD_FAILED' | 'BATCH_OPERATION_FAILED' | 'BATCH_COMMIT_UNKNOWN';
+    readonly outcome: 'not_started' | 'aborted' | 'rollback_unknown' | 'commit_unknown';
+    readonly operation?: string;
+    readonly transactionId?: string;
+    readonly diagnostic?: {
+        phase: 'preflight';
+        providerCode?: number;
+    };
+    constructor(code: 'BATCH_VALIDATION' | 'BATCH_PREFLIGHT_FAILED' | 'BATCH_GUARD_FAILED' | 'BATCH_OPERATION_FAILED' | 'BATCH_COMMIT_UNKNOWN', outcome: 'not_started' | 'aborted' | 'rollback_unknown' | 'commit_unknown', operation?: string, transactionId?: string, diagnostic?: {
+        phase: 'preflight';
+        providerCode?: number;
+    });
+}
+export interface AtomicBatchHost {
+    preflight(options: AtomicBatchOptions): Promise<void>;
+    executeNative?(options: AtomicBatchOptions): Promise<AtomicBatchResult | undefined>;
+    begin(options: AtomicBatchOptions): Promise<ITransaction>;
+    validateTransaction?(options: AtomicBatchOptions, transaction: ITransaction): Promise<void>;
+    execute(operation: AtomicBatchOperation, options: AtomicBatchOptions, transaction: ITransaction): Promise<{
+        count: number;
+    }>;
+}
+export declare function validateAtomicBatch(options: AtomicBatchOptions): void;
+/** Sequential ACID executor. No automatic write replay and no provider callbacks. */
+export declare function executeAtomicBatch(host: AtomicBatchHost, options: AtomicBatchOptions): Promise<AtomicBatchResult>;

package/dist/database/atomic-batch.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtomicBatchError = void 0;
+exports.validateAtomicBatch = validateAtomicBatch;
+exports.executeAtomicBatch = executeAtomicBatch;
+class AtomicBatchError extends Error {
+    constructor(code, outcome, operation, transactionId, diagnostic) {
+        // Never copy provider errors here: they can contain parameters and credentials.
+        super(`${code}: ${outcome}${operation ? ` (${operation})` : ''}`);
+        this.code = code;
+        this.outcome = outcome;
+        this.operation = operation;
+        this.transactionId = transactionId;
+        this.diagnostic = diagnostic;
+        this.name = 'AtomicBatchError';
+    }
+}
+exports.AtomicBatchError = AtomicBatchError;
+const forbidden = new Set(['__proto__', 'constructor', 'prototype']);
+function fail() { throw new AtomicBatchError('BATCH_VALIDATION', 'not_started'); }
+function record(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value)
+        && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+function keys(value, allowed) {
+    if (Object.keys(value).some(key => !allowed.includes(key) || forbidden.has(key)))
+        fail();
+}
+function pointer(value, path) {
+    if (path === '')
+        return value;
+    if (!path.startsWith('/') || /~(?![01])/u.test(path))
+        fail();
+    for (const encoded of path.slice(1).split('/')) {
+        const key = encoded.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (forbidden.has(key) || value === null || typeof value !== 'object' || !Object.prototype.hasOwnProperty.call(value, key))
+            fail();
+        value = value[key];
+    }
+    return value;
+}
+function walk(value, visit, depth = 0) {
+    if (depth > 32)
+        fail();
+    if (Array.isArray(value))
+        return value.map(item => walk(item, visit, depth + 1));
+    if (record(value)) {
+        if (Object.prototype.hasOwnProperty.call(value, '$batchRef')) {
+            keys(value, ['$batchRef']);
+            const ref = value.$batchRef;
+            if (!record(ref))
+                fail();
+            keys(ref, ['operation', 'path']);
+            if (typeof ref.operation !== 'string' || typeof ref.path !== 'string')
+                fail();
+            return visit(ref);
+        }
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => {
+            if (forbidden.has(key))
+                fail();
+            return [key, walk(child, visit, depth + 1)];
+        }));
+    }
+    if (value !== null && typeof value === 'object')
+        fail();
+    if (typeof value === 'function' || typeof value === 'symbol' || typeof value === 'bigint' || value === undefined)
+        fail();
+    if (typeof value === 'number' && !Number.isFinite(value))
+        fail();
+    return value;
+}
+function validateAtomicBatch(options) {
+    if (!record(options))
+        fail();
+    keys(options, ['product', 'env', 'database', 'session', 'system', 'transaction', 'operations']);
+    for (const value of [options.product, options.env, options.database])
+        if (typeof value !== 'string' || !value.trim())
+            fail();
+    if (options.session !== undefined && (typeof options.session !== 'string' || !options.session.trim()))
+        fail();
+    if (options.system !== undefined) {
+        if (!record(options.system))
+            fail();
+        keys(options.system, ['reason']);
+        if (typeof options.system.reason !== 'string' || !options.system.reason.trim())
+            fail();
+    }
+    if (!!options.session === !!options.system)
+        fail();
+    if (!Array.isArray(options.operations) || !options.operations.length || options.operations.length > 100)
+        fail();
+    const prior = new Set();
+    for (const op of options.operations) {
+        if (!record(op))
+            fail();
+        keys(op, ['name', 'operation', 'table', 'data', 'where', 'conflictKeys', 'returning', 'expectedCount', 'project']);
+        if (typeof op.name !== 'string' || !/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/.test(op.name) || prior.has(op.name) || forbidden.has(op.name))
+            fail();
+        if (typeof op.table !== 'string' || !op.table.trim() || op.table.startsWith('_ductape_') || op.table.startsWith('system.'))
+            fail();
+        if (!['insert', 'update', 'delete', 'upsert'].includes(op.operation))
+            fail();
+        if (op.operation !== 'delete' && !record(op.data) && !(op.operation === 'insert' && Array.isArray(op.data) && op.data.length && op.data.every(record)))
+            fail();
+        if (['update', 'delete'].includes(op.operation) && (!record(op.where) || !Object.keys(op.where).length))
+            fail();
+        if (op.operation === 'upsert' && (!Array.isArray(op.conflictKeys) || !op.conflictKeys.length || op.conflictKeys.some(key => typeof key !== 'string' || !key || forbidden.has(key))))
+            fail();
+        if (op.returning !== undefined && typeof op.returning !== 'boolean')
+            fail();
+        if (op.expectedCount !== undefined && (!Number.isSafeInteger(op.expectedCount) || op.expectedCount < 0))
+            fail();
+        if (op.project !== undefined && (!record(op.project) || Object.values(op.project).some(path => typeof path !== 'string' || (path !== '' && !path.startsWith('/')))))
+            fail();
+        walk(op, ref => { if (!prior.has(ref.operation))
+            fail(); return null; });
+        prior.add(op.name);
+    }
+    if (Buffer.byteLength(JSON.stringify(options.operations)) > 1024 * 1024)
+        fail();
+}
+/** Sequential ACID executor. No automatic write replay and no provider callbacks. */
+async function executeAtomicBatch(host, options) {
+    var _a, _b, _c, _d;
+    validateAtomicBatch(options);
+    // Snapshot caller-owned inputs before awaiting; preserve the opaque session and transaction.
+    options = Object.assign(Object.assign({}, options), { operations: JSON.parse(JSON.stringify(options.operations)) });
+    // References are resolved later, so use a JSON snapshot retaining their declarative form.
+    try {
+        await host.preflight(options);
+    }
+    catch (error) {
+        if (error instanceof AtomicBatchError)
+            throw error;
+        const code = error === null || error === void 0 ? void 0 : error.code;
+        throw new AtomicBatchError('BATCH_PREFLIGHT_FAILED', 'not_started', undefined, (_a = options.transaction) === null || _a === void 0 ? void 0 : _a.id, Object.assign({ phase: 'preflight' }, (typeof code === 'number' && Number.isSafeInteger(code) ? { providerCode: code } : {})));
+    }
+    const native = await ((_b = host.executeNative) === null || _b === void 0 ? void 0 : _b.call(host, options));
+    if (native)
+        return native;
+    const transaction = (_c = options.transaction) !== null && _c !== void 0 ? _c : await host.begin(options);
+    const results = Object.create(null);
+    const projected = Object.create(null);
+    let operation;
+    let guard = false;
+    try {
+        await ((_d = host.validateTransaction) === null || _d === void 0 ? void 0 : _d.call(host, options, transaction));
+        for (const source of options.operations) {
+            operation = source.name;
+            if (!transaction.isActive())
+                throw new Error('inactive transaction');
+            const op = walk(source, ref => pointer(results[ref.operation], ref.path));
+            const result = await host.execute(op, options, transaction);
+            if (op.expectedCount !== undefined && result.count !== op.expectedCount) {
+                guard = true;
+                throw new Error('count guard failed');
+            }
+            results[op.name] = result;
+            projected[op.name] = op.project ? Object.fromEntries(Object.entries(op.project).map(([key, path]) => [key, pointer(result, path)])) : result;
+        }
+    }
+    catch (_e) {
+        let outcome = transaction.status === 'rolled_back' ? 'aborted' : 'rollback_unknown';
+        try {
+            if (transaction.isActive()) {
+                await transaction.rollback();
+                outcome = 'aborted';
+            }
+        }
+        catch ( /* Preserve uncertainty, not the provider payload. */_f) { /* Preserve uncertainty, not the provider payload. */ }
+        throw new AtomicBatchError(guard ? 'BATCH_GUARD_FAILED' : 'BATCH_OPERATION_FAILED', outcome, operation, transaction.id);
+    }
+    if (options.transaction)
+        return { status: 'pending', transactionId: transaction.id, results: projected };
+    try {
+        await transaction.commit();
+    }
+    catch (_g) {
+        throw new AtomicBatchError('BATCH_COMMIT_UNKNOWN', 'commit_unknown', undefined, transaction.id);
+    }
+    return { status: 'committed', transactionId: transaction.id, results: projected };
+}
+//# sourceMappingURL=atomic-batch.js.map

package/dist/database/atomic-batch.js.map

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

package/dist/database/atomic-pipeline.d.ts

@@ -0,0 +1,27 @@
+import { AtomicBatchOptions, AtomicBatchResult } from './atomic-batch';
+import { IMongoPipelineOptions, IMongoPipelineResult } from './types/pipeline.interface';
+import { ITransaction } from './types/transaction.interface';
+import { SqlContext } from './sql-context';
+export interface AtomicPipelineOptions extends AtomicBatchOptions {
+    /** Exactly one bounded, ownership-filtered MongoDB aggregation. */
+    context: {
+        table: string;
+        pipeline?: IMongoPipelineOptions['pipeline'];
+        sql?: SqlContext;
+        maxTimeMS?: number;
+        expectedCount: number;
+    };
+}
+export interface AtomicPipelineResult<T> extends AtomicBatchResult {
+    context: IMongoPipelineResult<T>;
+}
+/** Intentionally constrained initial contract; no callbacks or hidden sequential reads. */
+export declare function validateAtomicContext(context: AtomicPipelineOptions['context']): void;
+/** Resolve explicit context references only; batch references remain for the write executor. */
+export declare function resolveContext(value: unknown, context: unknown): any;
+export declare function executeAtomicPipeline<T>(options: AtomicPipelineOptions, host: {
+    preflight(options: AtomicPipelineOptions): Promise<void>;
+    begin(): Promise<ITransaction>;
+    read(transaction: ITransaction): Promise<IMongoPipelineResult<T>>;
+    write(options: AtomicBatchOptions): Promise<AtomicBatchResult>;
+}): Promise<AtomicPipelineResult<T>>;

package/dist/database/atomic-pipeline.js

@@ -0,0 +1,118 @@
+"use strict";
+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.validateAtomicContext = validateAtomicContext;
+exports.resolveContext = resolveContext;
+exports.executeAtomicPipeline = executeAtomicPipeline;
+const atomic_batch_1 = require("./atomic-batch");
+const pipeline_interface_1 = require("./types/pipeline.interface");
+const sql_context_1 = require("./sql-context");
+/** Intentionally constrained initial contract; no callbacks or hidden sequential reads. */
+function validateAtomicContext(context) {
+    if (!context || !context.table || !Number.isSafeInteger(context.expectedCount) || context.expectedCount < 0 || context.expectedCount > 100)
+        throw new atomic_batch_1.AtomicBatchError('BATCH_VALIDATION', 'not_started');
+    if (context.sql) {
+        if (context.pipeline)
+            throw new Error('Choose SQL context or MongoDB pipeline, not both');
+        (0, sql_context_1.compileSqlContext)(context.table, context.sql, true);
+        return;
+    }
+    (0, pipeline_interface_1.validateReadPipeline)(context.pipeline);
+    const validate = (pipeline, depth) => {
+        if (depth > 4 || !pipeline.length || pipeline.length > 32)
+            throw new Error('Pipeline stage/depth limit exceeded');
+        const match = pipeline[0].$match;
+        if (!match || typeof match !== 'object' || !Object.keys(match).length)
+            throw new Error('Each context/lookup requires an explicit ownership match');
+        if (!pipeline.some(stage => stage.$project && typeof stage.$project === 'object'))
+            throw new Error('Each context/lookup requires a projection');
+        const limit = pipeline[pipeline.length - 1].$limit;
+        if (!Number.isInteger(limit) || Number(limit) < 1 || Number(limit) > 100)
+            throw new Error('Each context/lookup must end with a limit of 1-100');
+        for (const stage of pipeline) {
+            const key = Object.keys(stage)[0];
+            if (!['$match', '$project', '$limit', '$sort', '$lookup', '$set', '$addFields', '$unwind'].includes(key))
+                throw new Error(`Unsupported atomic context stage: ${key}`);
+            if (key === '$lookup') {
+                const lookup = stage.$lookup;
+                if (!Array.isArray(lookup === null || lookup === void 0 ? void 0 : lookup.pipeline))
+                    throw new Error('Lookup requires a filtered pipeline');
+                validate(lookup.pipeline, depth + 1);
+            }
+        }
+    };
+    validate(context.pipeline, 0);
+}
+/** Resolve explicit context references only; batch references remain for the write executor. */
+function resolveContext(value, context) {
+    if (Array.isArray(value))
+        return value.map(item => resolveContext(item, context));
+    if (!value || typeof value !== 'object')
+        return value;
+    const object = value;
+    if ('$contextRef' in object) {
+        if (Object.keys(object).length !== 1 || typeof object.$contextRef !== 'string' || !object.$contextRef.startsWith('/'))
+            throw new Error('Invalid context reference');
+        let result = context;
+        for (const part of object.$contextRef.split('/').slice(1)) {
+            if (/~(?![01])/.test(part))
+                throw new Error('Invalid context pointer');
+            const key = part.replace(/~1/g, '/').replace(/~0/g, '~');
+            if (['__proto__', 'prototype', 'constructor'].includes(key) || !result || !Object.prototype.hasOwnProperty.call(result, key))
+                throw new Error('Missing context reference');
+            result = result[key];
+        }
+        return result;
+    }
+    return Object.fromEntries(Object.entries(object).map(([key, child]) => [key, resolveContext(child, context)]));
+}
+async function executeAtomicPipeline(options, host) {
+    var _a;
+    const { context } = options, batch = __rest(options, ["context"]);
+    (0, atomic_batch_1.validateAtomicBatch)(batch);
+    validateAtomicContext(context);
+    if (Buffer.byteLength(JSON.stringify({ context, operations: batch.operations })) > 1024 * 1024)
+        throw new atomic_batch_1.AtomicBatchError('BATCH_VALIDATION', 'not_started');
+    await host.preflight(options);
+    const transaction = (_a = options.transaction) !== null && _a !== void 0 ? _a : await host.begin();
+    let result;
+    let read;
+    try {
+        read = await host.read(transaction);
+        if (read.count !== context.expectedCount)
+            throw new atomic_batch_1.AtomicBatchError('BATCH_GUARD_FAILED', 'not_started');
+        const operations = resolveContext(batch.operations, read);
+        result = await host.write(Object.assign(Object.assign({}, batch), { operations, transaction }));
+    }
+    catch (error) {
+        let outcome = transaction.status === 'rolled_back' ? 'aborted' : 'rollback_unknown';
+        try {
+            if (transaction.isActive()) {
+                await transaction.rollback();
+                outcome = 'aborted';
+            }
+        }
+        catch ( /* No replay. */_b) { /* No replay. */ }
+        throw new atomic_batch_1.AtomicBatchError(error instanceof atomic_batch_1.AtomicBatchError ? error.code : 'BATCH_OPERATION_FAILED', outcome, undefined, transaction.id);
+    }
+    if (!options.transaction) {
+        try {
+            await transaction.commit();
+        }
+        catch (_c) {
+            throw new atomic_batch_1.AtomicBatchError('BATCH_COMMIT_UNKNOWN', 'commit_unknown', undefined, transaction.id);
+        }
+    }
+    return Object.assign(Object.assign({}, result), { status: options.transaction ? 'pending' : 'committed', context: read });
+}
+//# sourceMappingURL=atomic-pipeline.js.map

package/dist/database/atomic-pipeline.js.map

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

package/dist/database/databases.service.d.ts

@@ -8,8 +8,11 @@
  * Supported databases: PostgreSQL, MySQL, MongoDB, DynamoDB, MariaDB, Cassandra
  */
 import { IConnectionConfig, IConnectionResult, IConnectionContext, IDatabaseConfig } from './types/connection.interface';
+import { IMongoPipelineOptions, IMongoPipelineResult } from './types/pipeline.interface';
+import { AtomicPipelineOptions, AtomicPipelineResult } from './atomic-pipeline';
 import { IQueryOptions, IQueryResult, IRawQueryOptions, IRawQueryResult } from './types/query.interface';
 import { IInsertOptions, IInsertResult, IUpdateOptions, IUpdateResult, IDeleteOptions, IDeleteResult, IUpsertOptions, IUpsertResult } from './types/write.interface';
+import { AtomicBatchOptions, AtomicBatchResult } from './atomic-batch';
 import { ITransactionOptions, ITransaction, ITransactionCallback } from './types/transaction.interface';
 import { IAggregateOptions, IAggregateResult, ICountOptions, ISumOptions, IAvgOptions, IMinMaxOptions, IGroupByOptions, IGroupByResult } from './types/aggregation.interface';
 import { ICreateTableOptions, ITableDefinition, IAlterTableOperation, ITableSchema, ITableInfo, ICreateIndexOptions, IDropIndexOptions, IListIndexesOptions, IIndexInfo, IIndexStatistics, SimpleFieldType, ISimpleFieldDefinition, ISimpleSchemaDefinition, ISimpleCreateOptions, ISimpleDropOptions, ISimpleIndexOptions } from './types/schema.interface';
@@ -67,6 +70,7 @@ export declare class DatabaseService {
     private currentContext;
     private adapterFactory;
     private transactionManager;
+    private readonly transactionScopes;
     private schemaManagers;
     private migrationEngines;
     private actionManager;
@@ -542,6 +546,8 @@ export declare class DatabaseService {
      *   where: { status: 'completed' },
      * });
      */
+    atomicPipeline<T = Record<string, unknown>>(options: AtomicPipelineOptions): Promise<AtomicPipelineResult<T>>;
+    aggregatePipeline<T = Record<string, unknown>>(options: IMongoPipelineOptions): Promise<IMongoPipelineResult<T>>;
     aggregate(options: IAggregateOptions): Promise<IAggregateResult>;
     /**
      * Group records and perform aggregations
@@ -605,6 +611,8 @@ export declare class DatabaseService {
      * }
      */
     beginTransaction(options: ITransactionOptions): Promise<ITransaction>;
+    /** Bounded ACID batch. Unsupported adapters and configured triggers fail closed. */
+    atomicBatch(options: AtomicBatchOptions): Promise<AtomicBatchResult>;
     /**
      * Create a new table
      *
@@ -1391,6 +1399,7 @@ export declare class DatabaseConnection {
     min(options: Omit<IMinMaxOptions, 'database' | 'env'>): Promise<any>;
     max(options: Omit<IMinMaxOptions, 'database' | 'env'>): Promise<any>;
     aggregate(options: Omit<IAggregateOptions, 'database' | 'env'>): Promise<IAggregateResult>;
+    aggregatePipeline<T = Record<string, unknown>>(options: Omit<IMongoPipelineOptions, 'product' | 'database' | 'env'>): Promise<IMongoPipelineResult<T>>;
     groupBy<T = any>(options: Omit<IGroupByOptions, 'database' | 'env'>): Promise<IGroupByResult<T>[]>;
     /**
      * Trigger operations scoped to this connection