@ductape/sdk 0.0.4-v43 → 0.0.4-v44

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

@@ -34,11 +34,11 @@ export interface IAggregationOperation {
 export interface ICountOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Where clause */
     where?: WhereClause;
@@ -53,11 +53,11 @@ export interface ICountOptions {
 export interface ISumOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Column to sum */
     column: string;
@@ -70,11 +70,11 @@ export interface ISumOptions {
 export interface IAvgOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Column to average */
     column: string;
@@ -87,11 +87,11 @@ export interface IAvgOptions {
 export interface IMinOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Column to find minimum */
     column: string;
@@ -104,11 +104,11 @@ export interface IMinOptions {
 export interface IMaxOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Column to find maximum */
     column: string;
@@ -121,11 +121,11 @@ export interface IMaxOptions {
 export interface IGroupByOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Columns to group by */
     groupBy: string[];
@@ -148,11 +148,11 @@ export interface IGroupByOptions {
 export interface IAggregateOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Aggregation operations */
     operations: Record<string, IAggregationOperation>;

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

@@ -84,7 +84,8 @@ export declare enum DatabaseErrorType {
     VALIDATION_ERROR = "validation_error",
     MIGRATION_ERROR = "migration_error",
     SCHEMA_ERROR = "schema_error",
-    INDEX_ERROR = "index_error"
+    INDEX_ERROR = "index_error",
+    TRANSACTION_ERROR = "TRANSACTION_ERROR"
 }
 /**
  * Database error class

package/dist/database/types/database.types.js

@@ -37,6 +37,7 @@ var DatabaseErrorType;
     DatabaseErrorType["MIGRATION_ERROR"] = "migration_error";
     DatabaseErrorType["SCHEMA_ERROR"] = "schema_error";
     DatabaseErrorType["INDEX_ERROR"] = "index_error";
+    DatabaseErrorType["TRANSACTION_ERROR"] = "TRANSACTION_ERROR";
 })(DatabaseErrorType || (exports.DatabaseErrorType = DatabaseErrorType = {}));
 /**
  * Database error class

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

@@ -1 +1 @@
-{"version":3,"file":"database.types.js","sourceRoot":"","sources":["../../../src/database/types/database.types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;GAEG;AACH,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;AACnB,CAAC,EANW,YAAY,4BAAZ,YAAY,QAMvB;AAED;;GAEG;AACH,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,iDAA6B,CAAA;IAC7B,6CAAyB,CAAA;IACzB,2CAAuB,CAAA;IACvB,mCAAe,CAAA;AACjB,CAAC,EALW,gBAAgB,gCAAhB,gBAAgB,QAK3B;AAiED;;GAEG;AACH,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,0DAAqC,CAAA;IACrC,gDAA2B,CAAA;IAC3B,0DAAqC,CAAA;IACrC,wDAAmC,CAAA;IACnC,kDAA6B,CAAA;IAC7B,gDAA2B,CAAA;AAC7B,CAAC,EAPW,iBAAiB,iCAAjB,iBAAiB,QAO5B;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YACS,IAAuB,EAC9B,OAAe,EACR,aAAqB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAmB;QAEvB,kBAAa,GAAb,aAAa,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AATD,sCASC;AAED;;GAEG;AACH,IAAY,yBAKX;AALD,WAAY,yBAAyB;IACnC,kEAAqC,CAAA;IACrC,8DAAiC,CAAA;IACjC,gEAAmC,CAAA;IACnC,0DAA6B,CAAA;AAC/B,CAAC,EALW,yBAAyB,yCAAzB,yBAAyB,QAKpC;AAED;;GAEG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,4CAAuB,CAAA;IACvB,gDAA2B,CAAA;IAC3B,sCAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}
+{"version":3,"file":"database.types.js","sourceRoot":"","sources":["../../../src/database/types/database.types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;GAEG;AACH,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;AACnB,CAAC,EANW,YAAY,4BAAZ,YAAY,QAMvB;AAED;;GAEG;AACH,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,iDAA6B,CAAA;IAC7B,6CAAyB,CAAA;IACzB,2CAAuB,CAAA;IACvB,mCAAe,CAAA;AACjB,CAAC,EALW,gBAAgB,gCAAhB,gBAAgB,QAK3B;AAiED;;GAEG;AACH,IAAY,iBAQX;AARD,WAAY,iBAAiB;IAC3B,0DAAqC,CAAA;IACrC,gDAA2B,CAAA;IAC3B,0DAAqC,CAAA;IACrC,wDAAmC,CAAA;IACnC,kDAA6B,CAAA;IAC7B,gDAA2B,CAAA;IAC3B,4DAAuC,CAAA;AACzC,CAAC,EARW,iBAAiB,iCAAjB,iBAAiB,QAQ5B;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YACS,IAAuB,EAC9B,OAAe,EACR,aAAqB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAmB;QAEvB,kBAAa,GAAb,aAAa,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AATD,sCASC;AAED;;GAEG;AACH,IAAY,yBAKX;AALD,WAAY,yBAAyB;IACnC,kEAAqC,CAAA;IACrC,8DAAiC,CAAA;IACjC,gEAAmC,CAAA;IACnC,0DAA6B,CAAA;AAC/B,CAAC,EALW,yBAAyB,yCAAzB,yBAAyB,QAKpC;AAED;;GAEG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,4CAAuB,CAAA;IACvB,gDAA2B,CAAA;IAC3B,sCAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}

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

@@ -64,11 +64,11 @@ export interface IIndexDefinition {
 export interface ICreateIndexOptions {
     /** Table name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Index definition */
     index: IIndexDefinition;
@@ -87,11 +87,11 @@ export interface IDropIndexOptions {
     indexName: string;
     /** Table name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Drop if exists */
     ifExists?: boolean;
@@ -108,11 +108,11 @@ export interface IDropIndexOptions {
 export interface IListIndexesOptions {
     /** Table name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Include system indexes */
     includeSystem?: boolean;
@@ -179,11 +179,11 @@ export interface IAnalyzeIndexOptions {
     indexName?: string;
     /** Table name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
 }
 /**
@@ -194,11 +194,11 @@ export interface IRebuildIndexOptions {
     indexName: string;
     /** Table name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Rebuild concurrently (PostgreSQL) */
     concurrent?: boolean;

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

@@ -94,11 +94,11 @@ export interface IMigrationHistory {
     tag: string;
     /** Migration name */
     name: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Status */
     status: MigrationStatus;
@@ -135,11 +135,11 @@ export interface IMigrationGenerationOptions {
  * Migration execution options
  */
 export interface IMigrationExecutionOptions {
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Run specific migration tag */
     tag?: string;
@@ -156,11 +156,11 @@ export interface IMigrationExecutionOptions {
  * Migration rollback options
  */
 export interface IMigrationRollbackOptions {
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Rollback specific migration */
     tag?: string;

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

@@ -110,17 +110,46 @@ export interface IPagination {
     /** Page size (alternative to limit) */
     pageSize?: number;
 }
+/**
+ * Include options for relationship lookups
+ */
+export interface IInclude {
+    /** Relationship name/table to include */
+    relation: string;
+    /** Fields to select from the related table */
+    select?: string[];
+    /** Where clause for the related table */
+    where?: WhereClause;
+    /** Nested includes (for deep relationships) */
+    include?: IInclude | IInclude[];
+    /** Limit results from the relationship */
+    limit?: number;
+    /** Order results from the relationship */
+    orderBy?: IOrderBy | IOrderBy[];
+    /** Foreign key column in the main table (defaults to relation_id) */
+    foreignKey?: string;
+    /** Primary key column in the related table (defaults to id) */
+    primaryKey?: string;
+    /** Relationship type */
+    type?: 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+    /** For many-to-many: junction table name */
+    through?: string;
+    /** For many-to-many: foreign key in junction table pointing to main table */
+    throughForeignKey?: string;
+    /** For many-to-many: foreign key in junction table pointing to related table */
+    throughRelatedKey?: string;
+}
 /**
  * Query options
  */
 export interface IQueryOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Columns to select (empty for all) */
     select?: string[];
@@ -134,6 +163,8 @@ export interface IQueryOptions {
     offset?: number;
     /** Joins (SQL only) */
     joins?: IJoinClause[];
+    /** Include related data (relationship lookups) */
+    include?: IInclude | IInclude[];
     /** Group by columns */
     groupBy?: string[];
     /** Having clause (for grouped queries) */
@@ -149,11 +180,11 @@ export interface IQueryOptions {
 export interface IInsertOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Data to insert (single record or array) */
     data: Record<string, any> | Record<string, any>[];
@@ -179,11 +210,11 @@ export interface IInsertOptions {
 export interface IUpdateOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Data to update */
     data: Record<string, any>;
@@ -202,11 +233,11 @@ export interface IUpdateOptions {
 export interface IDeleteOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Where clause */
     where: WhereClause;
@@ -223,11 +254,11 @@ export interface IDeleteOptions {
 export interface IUpsertOptions {
     /** Table/Collection name */
     table: string;
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Data to upsert */
     data: Record<string, any> | Record<string, any>[];
@@ -242,11 +273,11 @@ export interface IUpsertOptions {
  * Transaction execution options
  */
 export interface ITransactionExecutionOptions {
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Isolation level */
     isolationLevel?: 'READ_UNCOMMITTED' | 'READ_COMMITTED' | 'REPEATABLE_READ' | 'SERIALIZABLE';
@@ -259,11 +290,11 @@ export interface ITransactionExecutionOptions {
  * Raw query options
  */
 export interface IRawQueryOptions {
-    /** Environment slug */
-    env: string;
-    /** Product tag */
+    /** Environment slug (optional if connection is already established) */
+    env?: string;
+    /** Product tag (optional if connection is already established) */
     product?: string;
-    /** Database tag */
+    /** Database tag (optional if connection is already established) */
     database?: string;
     /** Raw SQL/query string */
     query: string;