@ductape/sdk 0.0.4-v5 → 0.0.4-v51

package/dist/database/adapters/base.adapter.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Base database adapter interface
+ * All database-specific adapters must implement this interface
+ */
+import { DatabaseType, IConnection, IDatabaseConfig, ITransaction, ISavepoint, ITransactionOptions } from '../types/database.types';
+import { IQueryOptions, IInsertOptions, IUpdateOptions, IDeleteOptions, IUpsertOptions, IRawQueryOptions } from '../types/query.types';
+import { ICountOptions, ISumOptions, IAvgOptions, IMinOptions, IMaxOptions, IGroupByOptions, IAggregateOptions, IGroupByResult } from '../types/aggregation.types';
+import { ITableSchema, IColumnAlteration, ICreateTableOptions, IAlterTableOptions } from '../types/schema.types';
+import { ICreateIndexOptions, IDropIndexOptions, IListIndexesOptions, IIndexInfo, IIndexStatistics } from '../types/index.types';
+import { IMigrationDefinition, IMigrationExecutionOptions, IMigrationHistory, IMigrationResult } from '../types/migration.types';
+import { IQueryResult, IInsertResult, IUpdateResult, IDeleteResult, IUpsertResult, ISchemaOperationResult, IIndexOperationResult, IRawQueryResult, IConnectionTestResult } from '../types/result.types';
+/**
+ * Base database adapter abstract class
+ * Provides common functionality and defines required methods
+ */
+export declare abstract class BaseDatabaseAdapter {
+    /** Database type this adapter handles */
+    abstract readonly type: DatabaseType;
+    /**
+     * Create and establish a database connection
+     */
+    abstract connect(config: IDatabaseConfig): Promise<IConnection>;
+    /**
+     * Close a database connection
+     */
+    abstract disconnect(connection: IConnection): Promise<void>;
+    /**
+     * Test database connection
+     */
+    abstract testConnection(connection: IConnection): Promise<IConnectionTestResult>;
+    /**
+     * Begin a new transaction
+     */
+    abstract beginTransaction(connection: IConnection, options?: ITransactionOptions): Promise<ITransaction>;
+    /**
+     * Commit a transaction
+     */
+    abstract commitTransaction(connection: IConnection, transaction: ITransaction): Promise<void>;
+    /**
+     * Rollback a transaction
+     */
+    abstract rollbackTransaction(connection: IConnection, transaction: ITransaction): Promise<void>;
+    /**
+     * Create a savepoint within a transaction
+     */
+    abstract createSavepoint(connection: IConnection, transaction: ITransaction, savepointName: string): Promise<ISavepoint>;
+    /**
+     * Rollback to a savepoint
+     */
+    abstract rollbackToSavepoint(connection: IConnection, transaction: ITransaction, savepoint: ISavepoint): Promise<void>;
+    /**
+     * Release a savepoint
+     */
+    abstract releaseSavepoint(connection: IConnection, transaction: ITransaction, savepoint: ISavepoint): Promise<void>;
+    /**
+     * Execute a callback within a transaction
+     * Automatically commits on success or rolls back on error
+     */
+    executeTransaction<T>(connection: IConnection, callback: (transaction: ITransaction) => Promise<T>, options?: ITransactionOptions): Promise<T>;
+    /**
+     * Execute a select query
+     */
+    abstract query<T = any>(connection: IConnection, options: IQueryOptions): Promise<IQueryResult<T>>;
+    /**
+     * Insert records
+     */
+    abstract insert<T = any>(connection: IConnection, options: IInsertOptions): Promise<IInsertResult<T>>;
+    /**
+     * Update records
+     */
+    abstract update<T = any>(connection: IConnection, options: IUpdateOptions): Promise<IUpdateResult<T>>;
+    /**
+     * Delete records
+     */
+    abstract delete<T = any>(connection: IConnection, options: IDeleteOptions): Promise<IDeleteResult<T>>;
+    /**
+     * Upsert records (insert or update)
+     */
+    abstract upsert<T = any>(connection: IConnection, options: IUpsertOptions): Promise<IUpsertResult<T>>;
+    /**
+     * Execute raw SQL/query
+     */
+    abstract executeRaw<T = any>(connection: IConnection, options: IRawQueryOptions): Promise<IRawQueryResult<T>>;
+    /**
+     * Count records
+     */
+    abstract count(connection: IConnection, options: ICountOptions): Promise<number>;
+    /**
+     * Sum column values
+     */
+    abstract sum(connection: IConnection, options: ISumOptions): Promise<number>;
+    /**
+     * Get average of column values
+     */
+    abstract avg(connection: IConnection, options: IAvgOptions): Promise<number>;
+    /**
+     * Get minimum value
+     */
+    abstract min(connection: IConnection, options: IMinOptions): Promise<number | string>;
+    /**
+     * Get maximum value
+     */
+    abstract max(connection: IConnection, options: IMaxOptions): Promise<number | string>;
+    /**
+     * Group by and aggregate
+     */
+    abstract groupBy(connection: IConnection, options: IGroupByOptions): Promise<IGroupByResult[]>;
+    /**
+     * Multiple aggregations in one query
+     */
+    abstract aggregate(connection: IConnection, options: IAggregateOptions): Promise<Record<string, any>>;
+    /**
+     * Create a table/collection
+     */
+    abstract createTable(connection: IConnection, schema: ITableSchema, options?: ICreateTableOptions): Promise<ISchemaOperationResult>;
+    /**
+     * Drop a table/collection
+     */
+    abstract dropTable(connection: IConnection, tableName: string): Promise<ISchemaOperationResult>;
+    /**
+     * Alter table (add/modify/drop columns)
+     */
+    abstract alterTable(connection: IConnection, tableName: string, alterations: IColumnAlteration[], options?: IAlterTableOptions): Promise<ISchemaOperationResult>;
+    /**
+     * Get table schema
+     */
+    abstract getTableSchema(connection: IConnection, tableName: string): Promise<ITableSchema>;
+    /**
+     * List all tables/collections
+     */
+    abstract listTables(connection: IConnection): Promise<string[]>;
+    /**
+     * Check if table exists
+     */
+    abstract tableExists(connection: IConnection, tableName: string): Promise<boolean>;
+    /**
+     * Create an index
+     */
+    abstract createIndex(connection: IConnection, options: ICreateIndexOptions): Promise<IIndexOperationResult>;
+    /**
+     * Drop an index
+     */
+    abstract dropIndex(connection: IConnection, options: IDropIndexOptions): Promise<IIndexOperationResult>;
+    /**
+     * List indexes for a table
+     */
+    abstract listIndexes(connection: IConnection, options: IListIndexesOptions): Promise<IIndexInfo[]>;
+    /**
+     * Get index statistics
+     */
+    abstract getIndexStatistics(connection: IConnection, tableName: string, indexName?: string): Promise<IIndexStatistics[]>;
+    /**
+     * Run a migration
+     */
+    abstract runMigration(connection: IConnection, migration: IMigrationDefinition, options: IMigrationExecutionOptions): Promise<IMigrationResult>;
+    /**
+     * Rollback a migration
+     */
+    abstract rollbackMigration(connection: IConnection, migration: IMigrationDefinition, options: IMigrationExecutionOptions): Promise<IMigrationResult>;
+    /**
+     * Get migration history
+     */
+    abstract getMigrationHistory(connection: IConnection, options: IMigrationExecutionOptions): Promise<IMigrationHistory[]>;
+    /**
+     * Escape identifier (table/column name)
+     */
+    abstract escapeIdentifier(identifier: string): string;
+    /**
+     * Escape value
+     */
+    abstract escapeValue(value: any): string;
+    /**
+     * Get database version
+     */
+    abstract getDatabaseVersion(connection: IConnection): Promise<string>;
+}

package/dist/database/adapters/base.adapter.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Base database adapter interface
+ * All database-specific adapters must implement this interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseDatabaseAdapter = void 0;
+/**
+ * Base database adapter abstract class
+ * Provides common functionality and defines required methods
+ */
+class BaseDatabaseAdapter {
+    /**
+     * Execute a callback within a transaction
+     * Automatically commits on success or rolls back on error
+     */
+    async executeTransaction(connection, callback, options) {
+        const transaction = await this.beginTransaction(connection, options);
+        try {
+            const result = await callback(transaction);
+            await this.commitTransaction(connection, transaction);
+            return result;
+        }
+        catch (error) {
+            await this.rollbackTransaction(connection, transaction);
+            throw error;
+        }
+    }
+}
+exports.BaseDatabaseAdapter = BaseDatabaseAdapter;
+//# sourceMappingURL=base.adapter.js.map

package/dist/database/adapters/base.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.adapter.js","sourceRoot":"","sources":["../../../src/database/adapters/base.adapter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2DH;;;GAGG;AACH,MAAsB,mBAAmB;IAoEvC;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CACtB,UAAuB,EACvB,QAAmD,EACnD,OAA6B;QAE7B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC3C,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YACxD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CAmOF;AA1TD,kDA0TC"}

package/dist/database/adapters/dynamodb.adapter.d.ts

@@ -0,0 +1,91 @@
+/**
+ * DynamoDB Database Adapter
+ * Implements database operations for Amazon DynamoDB
+ */
+import { BaseDatabaseAdapter } from './base.adapter';
+import { DatabaseType, IConnection, IDatabaseConfig, ITransaction, ISavepoint, ITransactionOptions } from '../types/database.types';
+import { IQueryOptions, IInsertOptions, IUpdateOptions, IDeleteOptions, IUpsertOptions, IRawQueryOptions } from '../types/query.types';
+import { ICountOptions, ISumOptions, IAvgOptions, IMinOptions, IMaxOptions, IGroupByOptions, IAggregateOptions, IGroupByResult } from '../types/aggregation.types';
+import { ITableSchema, IColumnAlteration, ICreateTableOptions, IAlterTableOptions } from '../types/schema.types';
+import { ICreateIndexOptions, IDropIndexOptions, IListIndexesOptions, IIndexInfo, IIndexStatistics } from '../types/index.types';
+import { IMigrationDefinition, IMigrationExecutionOptions, IMigrationHistory, IMigrationResult } from '../types/migration.types';
+import { IQueryResult, IInsertResult, IUpdateResult, IDeleteResult, IUpsertResult, ISchemaOperationResult, IIndexOperationResult, IRawQueryResult, IConnectionTestResult } from '../types/result.types';
+/**
+ * DynamoDB Database Adapter
+ */
+export declare class DynamoDBAdapter extends BaseDatabaseAdapter {
+    readonly type = DatabaseType.DYNAMODB;
+    connect(config: IDatabaseConfig): Promise<IConnection>;
+    disconnect(connection: IConnection): Promise<void>;
+    testConnection(connection: IConnection): Promise<IConnectionTestResult>;
+    beginTransaction(connection: IConnection, options?: ITransactionOptions): Promise<ITransaction>;
+    commitTransaction(_connection: IConnection, transaction: ITransaction): Promise<void>;
+    rollbackTransaction(_connection: IConnection, transaction: ITransaction): Promise<void>;
+    createSavepoint(_connection: IConnection, _transaction: ITransaction, _savepointName: string): Promise<ISavepoint>;
+    rollbackToSavepoint(_connection: IConnection, _transaction: ITransaction, _savepoint: ISavepoint): Promise<void>;
+    releaseSavepoint(_connection: IConnection, _transaction: ITransaction, _savepoint: ISavepoint): Promise<void>;
+    query<T = any>(connection: IConnection, options: IQueryOptions): Promise<IQueryResult<T>>;
+    insert<T = any>(connection: IConnection, options: IInsertOptions): Promise<IInsertResult<T>>;
+    update<T = any>(connection: IConnection, options: IUpdateOptions): Promise<IUpdateResult<T>>;
+    delete<T = any>(connection: IConnection, options: IDeleteOptions): Promise<IDeleteResult<T>>;
+    upsert<T = any>(connection: IConnection, options: IUpsertOptions): Promise<IUpsertResult<T>>;
+    executeRaw<T = any>(connection: IConnection, options: IRawQueryOptions): Promise<IRawQueryResult<T>>;
+    count(connection: IConnection, options: ICountOptions): Promise<number>;
+    sum(connection: IConnection, options: ISumOptions): Promise<number>;
+    avg(connection: IConnection, options: IAvgOptions): Promise<number>;
+    min(connection: IConnection, options: IMinOptions): Promise<number | string>;
+    max(connection: IConnection, options: IMaxOptions): Promise<number | string>;
+    groupBy(connection: IConnection, options: IGroupByOptions): Promise<IGroupByResult[]>;
+    aggregate(connection: IConnection, options: IAggregateOptions): Promise<Record<string, any>>;
+    createTable(connection: IConnection, schema: ITableSchema, options?: ICreateTableOptions): Promise<ISchemaOperationResult>;
+    dropTable(connection: IConnection, tableName: string): Promise<ISchemaOperationResult>;
+    alterTable(connection: IConnection, tableName: string, alterations: IColumnAlteration[], options?: IAlterTableOptions): Promise<ISchemaOperationResult>;
+    getTableSchema(connection: IConnection, tableName: string): Promise<ITableSchema>;
+    listTables(connection: IConnection): Promise<string[]>;
+    tableExists(connection: IConnection, tableName: string): Promise<boolean>;
+    createIndex(connection: IConnection, options: ICreateIndexOptions): Promise<IIndexOperationResult>;
+    dropIndex(connection: IConnection, options: IDropIndexOptions): Promise<IIndexOperationResult>;
+    listIndexes(connection: IConnection, options: IListIndexesOptions): Promise<IIndexInfo[]>;
+    getIndexStatistics(connection: IConnection, tableName: string, indexName?: string): Promise<IIndexStatistics[]>;
+    /**
+     * Execute a migration operation
+     * Note: DynamoDB is schema-less, so column operations are skipped
+     */
+    private executeMigrationOperation;
+    runMigration(connection: IConnection, migration: IMigrationDefinition, options: IMigrationExecutionOptions): Promise<IMigrationResult>;
+    rollbackMigration(connection: IConnection, migration: IMigrationDefinition, options: IMigrationExecutionOptions): Promise<IMigrationResult>;
+    getMigrationHistory(connection: IConnection, options: IMigrationExecutionOptions): Promise<IMigrationHistory[]>;
+    /**
+     * Ensure migration tracking table exists
+     */
+    private ensureMigrationTable;
+    /**
+     * Record migration execution
+     */
+    private recordMigration;
+    /**
+     * Remove migration from history
+     */
+    private removeMigration;
+    private hasPartitionKeyInWhere;
+    private buildQueryParams;
+    private buildScanParams;
+    /**
+     * Build DynamoDB key condition expression (for Query operations)
+     * Supports both simplified syntax (GT, LT, etc.) and legacy $ prefix operators
+     */
+    private buildKeyConditionExpression;
+    /**
+     * Build DynamoDB filter expression (for Scan and Query operations)
+     * Supports both simplified syntax (GT, LT, AND, OR, etc.) and legacy $ prefix operators
+     */
+    private buildFilterExpression;
+    private buildUpdateExpression;
+    private extractKeyFromWhere;
+    private chunkArray;
+    private mapColumnTypeToDynamoDB;
+    private mapDynamoDBTypeToColumnType;
+    escapeIdentifier(identifier: string): string;
+    escapeValue(value: any): string;
+    getDatabaseVersion(connection: IConnection): Promise<string>;
+}