@decaf-ts/core 0.12.1 → 0.13.1

package/lib/esm/index.d.ts

@@ -15,6 +15,7 @@ export * from "./query";
 export * from "./services";
 export * from "./tasks";
 export * from "./utils";
+export * from "./migrations";
 export * from "./persistence";
 /**
  * @description Stores the current package version
@@ -22,7 +23,7 @@ export * from "./persistence";
  * @const VERSION
  * @memberOf module:core
  */
-export declare const VERSION = "0.12.1";
+export declare const VERSION = "0.13.0";
 /**
  * @description Stores the current package version
  * @summary A constant representing the version of the core package

package/lib/esm/index.js

@@ -23,7 +23,7 @@ export * from "./tasks/index.js";
 export * from "./utils/index.js";
 // commented out
 // export * from "./ram";
-// export * from "./migrations";
+export * from "./migrations/index.js";
 //left to last on purpose
 export * from "./persistence/index.js";
 /**
@@ -32,7 +32,7 @@ export * from "./persistence/index.js";
  * @const VERSION
  * @memberOf module:core
  */
-export const VERSION = "0.12.1";
+export const VERSION = "0.13.0";
 /**
  * @description Stores the current package version
  * @summary A constant representing the version of the core package

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,oCAAiC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,kFAAkF;AAClF,WAAW,CAAC,WAAW,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;AAEnD,4BAA4B;AAC5B,qCAA4B;AAC5B,sCAA6B;AAE7B,gCAAuB;AACvB,oCAA2B;AAC3B,sCAA6B;AAC7B,iCAAwB;AACxB,iCAAwB;AACxB,oCAA2B;AAC3B,iCAAwB;AACxB,iCAAwB;AAExB,gBAAgB;AAChB,yBAAyB;AACzB,gCAAgC;AAEhC,yBAAyB;AACzB,uCAA8B;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,QAAQ,CAAC,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,oCAAiC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,kFAAkF;AAClF,WAAW,CAAC,WAAW,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;AAEnD,4BAA4B;AAC5B,qCAA4B;AAC5B,sCAA6B;AAE7B,gCAAuB;AACvB,oCAA2B;AAC3B,sCAA6B;AAC7B,iCAAwB;AACxB,iCAAwB;AACxB,oCAA2B;AAC3B,iCAAwB;AACxB,iCAAwB;AAExB,gBAAgB;AAChB,yBAAyB;AACzB,sCAA6B;AAE7B,yBAAyB;AACzB,uCAA8B;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,QAAQ,CAAC,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC"}

package/lib/esm/migrations/Migration.d.ts

@@ -7,7 +7,7 @@ export declare abstract class AbsMigration<A extends Adapter<any, any, any, any>
     private _precedence?;
     transaction: boolean;
     get reference(): string;
-    get precedence(): Migration<any, any, void>;
+    get precedence(): string | Migration<any, any, void>;
     protected constructor();
     protected get adapter(): A;
     protected abstract getQueryRunner(conn: ConnectionForAdapter<A>): QUERYRUNNER;

package/lib/esm/migrations/MigrationService.d.ts

@@ -1,20 +1,63 @@
-import { Migration, MigrationConfig } from "./types";
+import { Migration, MigrationConfig, PersistenceMigrationConfig } from "./types";
 import { ClientBasedService } from "../services/services";
 import { Adapter } from "../persistence/Adapter";
 import { ContextOf } from "../persistence/types";
 import { ContextualArgs, MaybeContextualArg } from "../utils/ContextualLoggedClass";
+import { TaskModel } from "../tasks/models/TaskModel";
+import { MigrationVersioning } from "./MigrationVersioning";
+type ResolvedMigration = {
+    migration: Migration<any, any>;
+    flavour: string;
+    reference: string;
+    version: string;
+};
+type VersionTask = {
+    version: string;
+    task: TaskModel;
+};
 export declare class MigrationService<PERSIST extends boolean, A extends Adapter<any, any, any, any> = any, R = void> extends ClientBasedService<PERSIST extends boolean ? A : void, MigrationConfig<PERSIST>> implements Migration<any, A, R> {
+    protected versioning: MigrationVersioning;
+    protected queuedTaskChain: Array<{
+        id: string;
+        version: string;
+    }>;
     flavour?: string;
     readonly reference: string;
     readonly precedence: Migration<any, any> | Migration<any, any>[] | null;
     transaction: boolean;
     constructor();
+    static migrateAdapters<AD extends Adapter<any, any, any, any> = Adapter<any, any, any, any>>(adapters: AD[], cfg?: PersistenceMigrationConfig<AD>, ...args: MaybeContextualArg<ContextOf<AD>>): Promise<MigrationService<true, AD>[]>;
     initialize(...args: MaybeContextualArg<ContextOf<A>>): Promise<{
         config: MigrationConfig<PERSIST>;
         client: PERSIST extends boolean ? A : void;
     }>;
     down(qr: any, adapter: any, ...args: ContextualArgs<ContextOf<any>>): Promise<void>;
-    protected sort(migrations: Migration<any, any>[]): Migration<any, any, void>[];
+    protected normalizeVersion(raw: string, precedenceHint?: string): string;
+    protected extractPrecedenceTokens(migration: Migration<any, any>): string[];
+    protected referencesMigration(candidate: Migration<any, any>, target: ResolvedMigration): boolean;
+    protected precedenceHint(migration: Migration<any, any>): string | undefined;
+    protected compareByPrecedence(migration1: ResolvedMigration, migration2: ResolvedMigration): number;
+    protected sort(migrations: ResolvedMigration[]): ResolvedMigration[];
+    protected resolveMigration(migration: Migration<any, any>): ResolvedMigration;
+    protected shouldIncludeMigration(migration: ResolvedMigration, targetFlavour?: string, includeGeneric?: boolean): boolean;
+    protected collectMigrations(targetFlavour?: string, includeGeneric?: boolean): ResolvedMigration[];
+    protected buildExecutionPlan(options?: {
+        fromVersion?: string;
+        toVersion?: string;
+        targetFlavour?: string;
+        includeGeneric?: boolean;
+    }): ResolvedMigration[];
+    protected executeMigration(migration: ResolvedMigration, ...args: ContextualArgs<ContextOf<any>>): Promise<void>;
+    protected buildMigrationTaskForPlan(plan: ResolvedMigration[], ...args: ContextualArgs<ContextOf<any>>): TaskModel;
+    protected buildMigrationTasksForPlan(plan: ResolvedMigration[], ...args: ContextualArgs<ContextOf<any>>): VersionTask[];
+    createMigrationTask(targetVersion?: string, fromVersion?: string, ...args: ContextualArgs<ContextOf<any>>): TaskModel;
+    createMigrationTasks(targetVersion?: string, fromVersion?: string, ...args: ContextualArgs<ContextOf<any>>): VersionTask[];
+    protected migrationTaskIdsFromContext(taskKey: string, args: ContextualArgs<ContextOf<any>>): string[];
     migrate(qr?: any, adapter?: any, ...args: MaybeContextualArg<ContextOf<any>>): Promise<R>;
+    migrateNormally(qr?: any, adapter?: any, ...args: MaybeContextualArg<ContextOf<any>>): Promise<R>;
+    migrateViaTasks(qr?: any, adapter?: any, ...args: MaybeContextualArg<ContextOf<any>>): Promise<R>;
+    track(taskIds?: string[] | string, ...args: MaybeContextualArg<ContextOf<any>>): Promise<void>;
+    retry(taskIds?: string[] | string, ...args: MaybeContextualArg<ContextOf<any>>): Promise<void>;
     up(qr: any, adapter: any, ...args: ContextualArgs<ContextOf<any>>): Promise<void>;
 }
+export {};