@nest-batch/core 0.2.0

package/dist/tests/contracts/job-repository.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../tests/contracts/job-repository.contract.ts"],"names":["runJobRepositoryContract","factory","implName","describe","repo","tx","beforeEach","pair","create","test","expect","toBeInstanceOf","JobRepository","a","getOrCreateJobInstance","b","id","toBe","jobName","jobKey","createdAt","Date","c","Set","size","instance","found","getJobInstance","not","toBeNull","first","second","other","byName","findJobInstances","map","i","toEqual","arrayContaining","toContain","byNameAndKey","calls","Array","from","length","results","Promise","all","uniqueIds","r","exec","createExecutionAtomic","foo","status","JobStatus","STARTING","jobInstanceId","toBeGreaterThan","params","startTime","endTime","exitCode","exitMessage","updateJobExecution","COMPLETED","nested","n","list","push","fetched","getJobExecution","p","rejects","JobExecutionAlreadyRunningError","STARTED","process","env","DB_HOST","DATABASE_URL","attempts","settled","allSettled","fulfilled","filter","rejected","toHaveLength","reason","winningExec","value","running","getRunningJobExecution","afterStart","toISOString","afterEnd","result","stillRunning","noRunning","oldStart","newStart","unrelatedStart","FAILED","unrelated","byInstance","findJobExecutions","e","failed","terminal","windowed","startedAfter","startedBefore","step","createStepExecution","StepStatus","jobExecutionId","stepName","readCount","writeCount","commitCount","updateStepExecution","after","getStepExecution","otherExec","otherStep","steps","findStepExecutions","s","scope","stepExecutionId","data","cursor","items","meta","tag","saveExecutionContext","version","ctx","getExecutionContext","jobScope","stepScope","where","findLatestStepExecution","older","setTimeout","newer","latest","stepB","checkpoint","lastChunkIndex","lastReadIndex","receivedCtx","withTransaction","isActive","ok","err","Error","execs","ids","add"],"mappings":";;;;+BAmDgBA;;;eAAAA;;;wBAnDmC;sBACA;AAkD5C,SAASA,yBACdC,OAAqC,EACrCC,QAAgB;IAEhBC,IAAAA,gBAAQ,EAAC,CAAC,6CAA6C,EAAED,SAAS,CAAC,CAAC,EAAE;QACpE,IAAIE;QACJ,IAAIC;QAEJC,IAAAA,kBAAU,EAAC;YACT,MAAMC,OAAON,QAAQO,MAAM;YAC3BJ,OAAOG,KAAKH,IAAI;YAChBC,KAAKE,KAAKF,EAAE;QACd;QAEAF,IAAAA,gBAAQ,EAAC,iBAAiB;YACxBM,IAAAA,YAAI,EAAC,sDAAsD;gBACzD,8DAA8D;gBAC9D,gEAAgE;gBAChEC,IAAAA,cAAM,EAACN,MAAMO,cAAc,CAACC,mBAAa;YAC3C;YAEAH,IAAAA,YAAI,EAAC,6EAA6E;gBAChF,MAAMI,IAAI,MAAMT,KAAKU,sBAAsB,CAAC,SAAS;gBACrD,MAAMC,IAAI,MAAMX,KAAKU,sBAAsB,CAAC,SAAS;gBACrDJ,IAAAA,cAAM,EAACG,EAAEG,EAAE,EAAEC,IAAI,CAACF,EAAEC,EAAE;gBACtBN,IAAAA,cAAM,EAACG,EAAEK,OAAO,EAAED,IAAI,CAAC;gBACvBP,IAAAA,cAAM,EAACG,EAAEM,MAAM,EAAEF,IAAI,CAAC;gBACtBP,IAAAA,cAAM,EAACG,EAAEO,SAAS,EAAET,cAAc,CAACU;YACrC;YAEAZ,IAAAA,YAAI,EAAC,oFAAoF;gBACvF,MAAMI,IAAI,MAAMT,KAAKU,sBAAsB,CAAC,SAAS;gBACrD,MAAMC,IAAI,MAAMX,KAAKU,sBAAsB,CAAC,SAAS;gBACrD,MAAMQ,IAAI,MAAMlB,KAAKU,sBAAsB,CAAC,SAAS;gBACrDJ,IAAAA,cAAM,EAAC,IAAIa,IAAI;oBAACV,EAAEG,EAAE;oBAAED,EAAEC,EAAE;oBAAEM,EAAEN,EAAE;iBAAC,EAAEQ,IAAI,EAAEP,IAAI,CAAC;YAChD;YAEAR,IAAAA,YAAI,EAAC,0EAA0E;gBAC7E,MAAMgB,WAAW,MAAMrB,KAAKU,sBAAsB,CAAC,aAAa;gBAEhE,MAAMY,QAAQ,MAAMtB,KAAKuB,cAAc,CAACF,SAAST,EAAE;gBACnDN,IAAAA,cAAM,EAACgB,OAAOE,GAAG,CAACC,QAAQ;gBAC1BnB,IAAAA,cAAM,EAACgB,MAAOV,EAAE,EAAEC,IAAI,CAACQ,SAAST,EAAE;gBAClCN,IAAAA,cAAM,EAACgB,MAAOR,OAAO,EAAED,IAAI,CAAC;gBAC5BP,IAAAA,cAAM,EAACgB,MAAOP,MAAM,EAAEF,IAAI,CAAC;gBAE3BP,IAAAA,cAAM,EAAC,MAAMN,KAAKuB,cAAc,CAAC,mBAAmBE,QAAQ;YAC9D;YAEApB,IAAAA,YAAI,EAAC,kDAAkD;gBACrD,MAAMqB,QAAQ,MAAM1B,KAAKU,sBAAsB,CAAC,mBAAmB;gBACnE,MAAMiB,SAAS,MAAM3B,KAAKU,sBAAsB,CAAC,mBAAmB;gBACpE,MAAMkB,QAAQ,MAAM5B,KAAKU,sBAAsB,CAAC,yBAAyB;gBAEzE,MAAMmB,SAAS,MAAM7B,KAAK8B,gBAAgB,CAAC;oBAAEhB,SAAS;gBAAkB;gBACxER,IAAAA,cAAM,EAACuB,OAAOE,GAAG,CAAC,CAACC,IAAMA,EAAEpB,EAAE,GAAGqB,OAAO,CAAC3B,cAAM,CAAC4B,eAAe,CAAC;oBAACR,MAAMd,EAAE;oBAAEe,OAAOf,EAAE;iBAAC;gBACpFN,IAAAA,cAAM,EAACuB,OAAOE,GAAG,CAAC,CAACC,IAAMA,EAAEpB,EAAE,GAAGY,GAAG,CAACW,SAAS,CAACP,MAAMhB,EAAE;gBAEtD,MAAMwB,eAAe,MAAMpC,KAAK8B,gBAAgB,CAAC;oBAC/ChB,SAAS;oBACTC,QAAQ;gBACV;gBACAT,IAAAA,cAAM,EAAC8B,aAAaL,GAAG,CAAC,CAACC,IAAMA,EAAEpB,EAAE,GAAGqB,OAAO,CAAC;oBAACP,MAAMd,EAAE;iBAAC;YAC1D;YAEAP,IAAAA,YAAI,EAAC,qEAAqE;gBACxE,MAAMgC,QAAQC,MAAMC,IAAI,CAAC;oBAAEC,QAAQ;gBAAG,GAAG,IACvCxC,KAAKU,sBAAsB,CAAC,qBAAqB;gBAEnD,MAAM+B,UAAU,MAAMC,QAAQC,GAAG,CAACN;gBAClC,MAAMO,YAAY,IAAIzB,IAAIsB,QAAQV,GAAG,CAAC,CAACc,IAAMA,EAAEjC,EAAE;gBACjDN,IAAAA,cAAM,EAACsC,UAAUxB,IAAI,EAAEP,IAAI,CAAC;YAC9B;YAEAR,IAAAA,YAAI,EAAC,mEAAmE;gBACtE,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,UAAU;oBAAEC,KAAK;gBAAM;gBAC9E1C,IAAAA,cAAM,EAACwC,KAAKG,MAAM,EAAEpC,IAAI,CAACqC,eAAS,CAACC,QAAQ;gBAC3C7C,IAAAA,cAAM,EAAC,OAAOwC,KAAKM,aAAa,EAAEvC,IAAI,CAAC;gBACvCP,IAAAA,cAAM,EAACwC,KAAKM,aAAa,CAACZ,MAAM,EAAEa,eAAe,CAAC;gBAClD/C,IAAAA,cAAM,EAACwC,KAAKQ,MAAM,EAAErB,OAAO,CAAC;oBAAEe,KAAK;gBAAM;gBACzC1C,IAAAA,cAAM,EAACwC,KAAKS,SAAS,EAAE9B,QAAQ;gBAC/BnB,IAAAA,cAAM,EAACwC,KAAKU,OAAO,EAAE/B,QAAQ;gBAC7BnB,IAAAA,cAAM,EAACwC,KAAKW,QAAQ,EAAE5C,IAAI,CAAC;gBAC3BP,IAAAA,cAAM,EAACwC,KAAKY,WAAW,EAAE7C,IAAI,CAAC;gBAE9B,6DAA6D;gBAC7D,MAAMb,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;YAEAvD,IAAAA,YAAI,EAAC,mGAAmG;gBACtG,MAAMiD,SAAwB;oBAAEO,QAAQ;wBAAEC,GAAG;oBAAE;oBAAGC,MAAM;wBAAC;wBAAG;wBAAG;qBAAE;gBAAC;gBAClE,MAAMjB,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,UAAUO;gBAEjE,6DAA6D;gBAC5DA,OAAOO,MAAM,AAA4B,CAAC,IAAI,GAAG;gBACjDP,OAAOS,IAAI,CAAeC,IAAI,CAAC;gBAEhC,MAAMC,UAAU,MAAMjE,KAAKkE,eAAe,CAACpB,KAAKlC,EAAE;gBAClDN,IAAAA,cAAM,EAAC2D,SAASzC,GAAG,CAACC,QAAQ;gBAC5BnB,IAAAA,cAAM,EAAC,AAAC2D,QAASX,MAAM,CAA+BO,MAAM,CAACC,CAAC,EAAEjD,IAAI,CAAC;gBACrEP,IAAAA,cAAM,EAAC,AAAC2D,QAASX,MAAM,CAAwBS,IAAI,EAAE9B,OAAO,CAAC;oBAAC;oBAAG;oBAAG;iBAAE;gBAEtE,MAAMjC,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;YAEAvD,IAAAA,YAAI,EAAC,6HAA6H;gBAChI,MAAMqB,QAAQ,MAAM1B,KAAK+C,qBAAqB,CAAC,SAAS,aAAa;oBAAEoB,GAAG;gBAAE;gBAC5E,MAAMnE,KAAK2D,kBAAkB,CAACjC,MAAMd,EAAE,EAAE;oBACtCqC,QAAQC,eAAS,CAACU,SAAS;oBAC3BJ,SAAS,IAAIvC;gBACf;gBAEA,MAAMU,SAAS,MAAM3B,KAAK+C,qBAAqB,CAAC,SAAS,aAAa;oBAAEoB,GAAG;gBAAE;gBAC7E7D,IAAAA,cAAM,EAACqB,OAAOf,EAAE,EAAEY,GAAG,CAACX,IAAI,CAACa,MAAMd,EAAE;gBACnCN,IAAAA,cAAM,EAACqB,OAAOyB,aAAa,EAAEvC,IAAI,CAACa,MAAM0B,aAAa;gBACrD9C,IAAAA,cAAM,EAACqB,OAAOsB,MAAM,EAAEpC,IAAI,CAACqC,eAAS,CAACC,QAAQ;gBAE7C,MAAMnD,KAAK2D,kBAAkB,CAAChC,OAAOf,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACzE;YAEAvD,IAAAA,YAAI,EAAC,4GAA4G;gBAC/G,MAAMqB,QAAQ,MAAM1B,KAAK+C,qBAAqB,CAAC,SAAS,SAAS;oBAAEoB,GAAG;gBAAE;gBACxE,8CAA8C;gBAC9C,MAAM7D,IAAAA,cAAM,EACVN,KAAK+C,qBAAqB,CAAC,SAAS,SAAS;oBAAEoB,GAAG;gBAAE,IACpDC,OAAO,CAAC7D,cAAc,CAAC8D,qCAA+B;gBAExD,UAAU;gBACV,MAAMrE,KAAK2D,kBAAkB,CAACjC,MAAMd,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACxE;YAEAvD,IAAAA,YAAI,EAAC,mGAAmG;gBACtG,MAAMqB,QAAQ,MAAM1B,KAAK+C,qBAAqB,CAAC,SAAS,aAAa;oBAAEoB,GAAG;gBAAE;gBAC5E,MAAMnE,KAAK2D,kBAAkB,CAACjC,MAAMd,EAAE,EAAE;oBACtCqC,QAAQC,eAAS,CAACoB,OAAO;oBACzBf,WAAW,IAAItC;gBACjB;gBAEA,MAAMX,IAAAA,cAAM,EACVN,KAAK+C,qBAAqB,CAAC,SAAS,aAAa;oBAAEoB,GAAG;gBAAE,IACxDC,OAAO,CAAC7D,cAAc,CAAC8D,qCAA+B;gBAExD,MAAMrE,KAAK2D,kBAAkB,CAACjC,MAAMd,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACxE;YAEAvD,IAAAA,YAAI,EAAC,8GAA8G;gBACjH,8DAA8D;gBAC9D,+DAA+D;gBAC/D,yDAAyD;gBACzD,IAAI,CAACkE,QAAQC,GAAG,CAACC,OAAO,IAAI,CAACF,QAAQC,GAAG,CAACE,YAAY,EAAE;oBACrD;gBACF;gBAEA,MAAMC,WAAW;gBACjB,MAAMC,UAAU,MAAMlC,QAAQmC,UAAU,CACtCvC,MAAMC,IAAI,CAAC;oBAAEC,QAAQmC;gBAAS,GAAG,IAC/B3E,KAAK+C,qBAAqB,CAAC,mBAAmB,MAAM;wBAAEoB,GAAG;oBAAI;gBAGjE,MAAMW,YAAYF,QAAQG,MAAM,CAAC,CAAClC,IAAMA,EAAEI,MAAM,KAAK;gBACrD,MAAM+B,WAAWJ,QAAQG,MAAM,CAAC,CAAClC,IAAMA,EAAEI,MAAM,KAAK;gBACpD3C,IAAAA,cAAM,EAACwE,WAAWG,YAAY,CAAC;gBAC/B3E,IAAAA,cAAM,EAAC0E,UAAUC,YAAY,CAACN,WAAW;gBACzC,KAAK,MAAM9B,KAAKmC,SAAU;oBACxB,IAAInC,EAAEI,MAAM,KAAK,YAAY;wBAC3B3C,IAAAA,cAAM,EAACuC,EAAEqC,MAAM,EAAE3E,cAAc,CAAC8D,qCAA+B;oBACjE;gBACF;gBACA,MAAMc,cAAc,AAACL,SAAS,CAAC,EAAE,CAA0CM,KAAK;gBAChF,MAAMC,UAAU,MAAMrF,KAAKsF,sBAAsB,CAACH,YAAY/B,aAAa;gBAC3E9C,IAAAA,cAAM,EAAC+E,SAASzE,IAAIC,IAAI,CAACsE,YAAYvE,EAAE;gBAEvC,UAAU;gBACV,MAAMZ,KAAK2D,kBAAkB,CAACwB,YAAYvE,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YAC9E;YAEAvD,IAAAA,YAAI,EAAC,kGAAkG;gBACrG,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,WAAW;oBAAEoB,GAAG;gBAAE;gBACzE,MAAMZ,YAAY,IAAItC,KAAK;gBAC3B,MAAMjB,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBACrCqC,QAAQC,eAAS,CAACoB,OAAO;oBACzBf;gBACF;gBACA,MAAMgC,aAAa,MAAMvF,KAAKkE,eAAe,CAACpB,KAAKlC,EAAE;gBACrDN,IAAAA,cAAM,EAACiF,YAAYtC,QAAQpC,IAAI,CAACqC,eAAS,CAACoB,OAAO;gBACjDhE,IAAAA,cAAM,EAACiF,YAAYhC,WAAWiC,eAAe3E,IAAI,CAAC0C,UAAUiC,WAAW;gBACvE,sCAAsC;gBACtClF,IAAAA,cAAM,EAACiF,YAAY/B,SAAS/B,QAAQ;gBAEpC,MAAM+B,UAAU,IAAIvC,KAAK;gBACzB,MAAMjB,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBACrCqC,QAAQC,eAAS,CAACU,SAAS;oBAC3BJ;oBACAC,UAAU;gBACZ;gBACA,MAAMgC,WAAW,MAAMzF,KAAKkE,eAAe,CAACpB,KAAKlC,EAAE;gBACnDN,IAAAA,cAAM,EAACmF,UAAUxC,QAAQpC,IAAI,CAACqC,eAAS,CAACU,SAAS;gBACjDtD,IAAAA,cAAM,EAACmF,UAAUlC,WAAWiC,eAAe3E,IAAI,CAAC0C,UAAUiC,WAAW;gBACrElF,IAAAA,cAAM,EAACmF,UAAUjC,SAASgC,eAAe3E,IAAI,CAAC2C,QAAQgC,WAAW;gBACjElF,IAAAA,cAAM,EAACmF,UAAUhC,UAAU5C,IAAI,CAAC;YAClC;YAEAR,IAAAA,YAAI,EAAC,+CAA+C;gBAClD,MAAMqF,SAAS,MAAM1F,KAAKkE,eAAe,CAAC;gBAC1C5D,IAAAA,cAAM,EAACoF,QAAQjE,QAAQ;YACzB;YAEApB,IAAAA,YAAI,EAAC,oFAAoF;gBACvF,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,aAAa;oBAAEoB,GAAG;gBAAE;gBAC3E,MAAMkB,UAAU,MAAMrF,KAAKsF,sBAAsB,CAACxC,KAAKM,aAAa;gBACpE9C,IAAAA,cAAM,EAAC+E,SAASzE,IAAIC,IAAI,CAACiC,KAAKlC,EAAE;gBAChCN,IAAAA,cAAM,EAAC+E,SAASpC,QAAQpC,IAAI,CAACqC,eAAS,CAACC,QAAQ;gBAE/C,MAAMnD,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACoB,OAAO;gBAAC;gBACnE,MAAMqB,eAAe,MAAM3F,KAAKsF,sBAAsB,CAACxC,KAAKM,aAAa;gBACzE9C,IAAAA,cAAM,EAACqF,cAAc/E,IAAIC,IAAI,CAACiC,KAAKlC,EAAE;gBACrCN,IAAAA,cAAM,EAACqF,cAAc1C,QAAQpC,IAAI,CAACqC,eAAS,CAACoB,OAAO;gBAEnD,MAAMtE,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;gBACrE,MAAMgC,YAAY,MAAM5F,KAAKsF,sBAAsB,CAACxC,KAAKM,aAAa;gBACtE9C,IAAAA,cAAM,EAACsF,WAAWnE,QAAQ;YAC5B;YAEApB,IAAAA,YAAI,EAAC,sEAAsE;gBACzE,MAAMqF,SAAS,MAAM1F,KAAKsF,sBAAsB,CAAC;gBACjDhF,IAAAA,cAAM,EAACoF,QAAQjE,QAAQ;YACzB;YAEApB,IAAAA,YAAI,EAAC,wEAAwE;gBAC3E,MAAMwF,WAAW,IAAI5E,KAAK;gBAC1B,MAAM6E,WAAW,IAAI7E,KAAK;gBAC1B,MAAM8E,iBAAiB,IAAI9E,KAAK;gBAEhC,MAAMS,QAAQ,MAAM1B,KAAK+C,qBAAqB,CAAC,oBAAoB,OAAO;oBAAEoB,GAAG;gBAAE;gBACjF,MAAMnE,KAAK2D,kBAAkB,CAACjC,MAAMd,EAAE,EAAE;oBACtCqC,QAAQC,eAAS,CAACU,SAAS;oBAC3BL,WAAWsC;oBACXrC,SAAS,IAAIvC,KAAK;gBACpB;gBAEA,MAAMU,SAAS,MAAM3B,KAAK+C,qBAAqB,CAAC,oBAAoB,OAAO;oBAAEoB,GAAG;gBAAE;gBAClF,MAAMnE,KAAK2D,kBAAkB,CAAChC,OAAOf,EAAE,EAAE;oBACvCqC,QAAQC,eAAS,CAAC8C,MAAM;oBACxBzC,WAAWuC;oBACXtC,SAAS,IAAIvC,KAAK;gBACpB;gBAEA,MAAMgF,YAAY,MAAMjG,KAAK+C,qBAAqB,CAAC,0BAA0B,KAAK;oBAAEoB,GAAG;gBAAE;gBACzF,MAAMnE,KAAK2D,kBAAkB,CAACsC,UAAUrF,EAAE,EAAE;oBAC1CqC,QAAQC,eAAS,CAACU,SAAS;oBAC3BL,WAAWwC;oBACXvC,SAAS,IAAIvC,KAAK;gBACpB;gBAEA,MAAMiF,aAAa,MAAMlG,KAAKmG,iBAAiB,CAAC;oBAC9C/C,eAAe1B,MAAM0B,aAAa;gBACpC;gBACA9C,IAAAA,cAAM,EAAC4F,WAAWnE,GAAG,CAAC,CAACqE,IAAMA,EAAExF,EAAE,GAAGqB,OAAO,CAAC;oBAACP,MAAMd,EAAE;iBAAC;gBAEtD,MAAMyF,SAAS,MAAMrG,KAAKmG,iBAAiB,CAAC;oBAAElD,QAAQC,eAAS,CAAC8C,MAAM;gBAAC;gBACvE1F,IAAAA,cAAM,EAAC+F,OAAOtE,GAAG,CAAC,CAACqE,IAAMA,EAAExF,EAAE,GAAGuB,SAAS,CAACR,OAAOf,EAAE;gBACnDN,IAAAA,cAAM,EAAC+F,OAAOtE,GAAG,CAAC,CAACqE,IAAMA,EAAExF,EAAE,GAAGY,GAAG,CAACW,SAAS,CAACT,MAAMd,EAAE;gBAEtD,MAAM0F,WAAW,MAAMtG,KAAKmG,iBAAiB,CAAC;oBAC5ClD,QAAQ;wBAACC,eAAS,CAACU,SAAS;wBAAEV,eAAS,CAAC8C,MAAM;qBAAC;gBACjD;gBACA1F,IAAAA,cAAM,EAACgG,SAASvE,GAAG,CAAC,CAACqE,IAAMA,EAAExF,EAAE,GAAGqB,OAAO,CACvC3B,cAAM,CAAC4B,eAAe,CAAC;oBAACR,MAAMd,EAAE;oBAAEe,OAAOf,EAAE;oBAAEqF,UAAUrF,EAAE;iBAAC;gBAG5D,MAAM2F,WAAW,MAAMvG,KAAKmG,iBAAiB,CAAC;oBAC5CK,cAAc,IAAIvF,KAAK;oBACvBwF,eAAe,IAAIxF,KAAK;gBAC1B;gBACAX,IAAAA,cAAM,EAACiG,SAASxE,GAAG,CAAC,CAACqE,IAAMA,EAAExF,EAAE,GAAGuB,SAAS,CAACR,OAAOf,EAAE;gBACrDN,IAAAA,cAAM,EAACiG,SAASxE,GAAG,CAAC,CAACqE,IAAMA,EAAExF,EAAE,GAAGY,GAAG,CAACW,SAAS,CAACT,MAAMd,EAAE;gBACxDN,IAAAA,cAAM,EAACiG,SAASxE,GAAG,CAAC,CAACqE,IAAMA,EAAExF,EAAE,GAAGY,GAAG,CAACW,SAAS,CAAC8D,UAAUrF,EAAE;YAC9D;YAEAP,IAAAA,YAAI,EAAC,0EAA0E;gBAC7E,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,UAAU;oBAAEoB,GAAG;gBAAE;gBACxE,MAAMuC,OAAO,MAAM1G,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACrDN,IAAAA,cAAM,EAACoG,KAAKzD,MAAM,EAAEpC,IAAI,CAAC+F,gBAAU,CAACzD,QAAQ;gBAC5C7C,IAAAA,cAAM,EAACoG,KAAKG,cAAc,EAAEhG,IAAI,CAACiC,KAAKlC,EAAE;gBACxCN,IAAAA,cAAM,EAACoG,KAAKI,QAAQ,EAAEjG,IAAI,CAAC;gBAC3BP,IAAAA,cAAM,EAACoG,KAAKK,SAAS,EAAElG,IAAI,CAAC;gBAC5BP,IAAAA,cAAM,EAACoG,KAAKM,UAAU,EAAEnG,IAAI,CAAC;gBAC7BP,IAAAA,cAAM,EAACoG,KAAKO,WAAW,EAAEpG,IAAI,CAAC;gBAC9BP,IAAAA,cAAM,EAACoG,KAAKnD,SAAS,EAAE9B,QAAQ;gBAC/BnB,IAAAA,cAAM,EAACoG,KAAKlD,OAAO,EAAE/B,QAAQ;gBAE7B,MAAMzB,KAAKkH,mBAAmB,CAACR,KAAK9F,EAAE,EAAE;oBACtCqC,QAAQ2D,gBAAU,CAACtC,OAAO;oBAC1ByC,WAAW;oBACXC,YAAY;gBACd;gBACA,MAAMG,QAAQ,MAAMnH,KAAKoH,gBAAgB,CAACV,KAAK9F,EAAE;gBACjDN,IAAAA,cAAM,EAAC6G,OAAOlE,QAAQpC,IAAI,CAAC+F,gBAAU,CAACtC,OAAO;gBAC7ChE,IAAAA,cAAM,EAAC6G,OAAOJ,WAAWlG,IAAI,CAAC;gBAC9BP,IAAAA,cAAM,EAAC6G,OAAOH,YAAYnG,IAAI,CAAC;gBAE/B,UAAU;gBACV,MAAMb,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;YAEAvD,IAAAA,YAAI,EAAC,gDAAgD;gBACnD,MAAMqF,SAAS,MAAM1F,KAAKoH,gBAAgB,CAAC;gBAC3C9G,IAAAA,cAAM,EAACoF,QAAQjE,QAAQ;YACzB;YAEApB,IAAAA,YAAI,EAAC,wEAAwE;gBAC3E,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,eAAe,SAAS;oBAAEoB,GAAG;gBAAE;gBAC7E,MAAMzC,QAAQ,MAAM1B,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACtD,MAAMe,SAAS,MAAM3B,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACvD,MAAMyG,YAAY,MAAMrH,KAAK+C,qBAAqB,CAAC,qBAAqB,SAAS;oBAAEoB,GAAG;gBAAE;gBACxF,MAAMmD,YAAY,MAAMtH,KAAK2G,mBAAmB,CAACU,UAAUzG,EAAE,EAAE;gBAE/D,MAAM2G,QAAQ,MAAMvH,KAAKwH,kBAAkB,CAAC1E,KAAKlC,EAAE;gBACnDN,IAAAA,cAAM,EAACiH,MAAMxF,GAAG,CAAC,CAAC0F,IAAMA,EAAE7G,EAAE,GAAGqB,OAAO,CAAC3B,cAAM,CAAC4B,eAAe,CAAC;oBAACR,MAAMd,EAAE;oBAAEe,OAAOf,EAAE;iBAAC;gBACnFN,IAAAA,cAAM,EAACiH,MAAMxF,GAAG,CAAC,CAAC0F,IAAMA,EAAE7G,EAAE,GAAGY,GAAG,CAACW,SAAS,CAACmF,UAAU1G,EAAE;gBAEzD,MAAMZ,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;gBACrE,MAAM5D,KAAK2D,kBAAkB,CAAC0D,UAAUzG,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YAC5E;YAEAvD,IAAAA,YAAI,EAAC,mFAAmF;gBACtF,MAAMqH,QAAwB;oBAAEC,iBAAiB;gBAAQ;gBACzD,MAAMC,OAAO;oBAAEC,QAAQ;oBAAGC,OAAO;wBAAC;wBAAG;wBAAG;qBAAE;oBAAEC,MAAM;wBAAEC,KAAK;oBAAI;gBAAE;gBAC/D,MAAMhI,KAAKiI,oBAAoB,CAACP,OAAO;oBAAEE;oBAAMM,SAAS;gBAAE;gBAC1D,MAAMC,MAAM,MAAMnI,KAAKoI,mBAAmB,CAACV;gBAC3CpH,IAAAA,cAAM,EAAC6H,KAAKlG,OAAO,CAAC;oBAAE2F;oBAAMM,SAAS;gBAAE;YACzC;YAEA7H,IAAAA,YAAI,EAAC,qFAAqF;gBACxF,MAAMqH,QAAwB;oBAAEb,gBAAgB;gBAAW;gBAC3D,MAAM7G,KAAKiI,oBAAoB,CAACP,OAAO;oBAAEE,MAAM;wBAAE9D,GAAG;oBAAE;oBAAGoE,SAAS;gBAAE,GAAG;gBACvE,MAAMlI,KAAKiI,oBAAoB,CAACP,OAAO;oBAAEE,MAAM;wBAAE9D,GAAG;oBAAE;oBAAGoE,SAAS;gBAAE;gBACpE,MAAMC,MAAM,MAAMnI,KAAKoI,mBAAmB,CAACV;gBAC3CpH,IAAAA,cAAM,EAAC6H,KAAKP,MAAM3F,OAAO,CAAC;oBAAE6B,GAAG;gBAAE;gBACjCxD,IAAAA,cAAM,EAAC,AAAC6H,CAAAA,KAAKD,WAAW,CAAA,IAAK,GAAGrH,IAAI,CAAC;YACvC;YAEAR,IAAAA,YAAI,EAAC,iFAAiF;gBACpF,MAAMqH,QAAwB;oBAAEC,iBAAiB;gBAAW;gBAC5D,MAAMQ,MAAM,MAAMnI,KAAKoI,mBAAmB,CAACV;gBAC3CpH,IAAAA,cAAM,EAAC6H,KAAKlG,OAAO,CAAC;oBAAE2F,MAAM;oBAAMM,SAAS;gBAAE;YAC/C;YAEA7H,IAAAA,YAAI,EAAC,gFAAgF;gBACnF,MAAMgI,WAA2B;oBAAExB,gBAAgB;gBAAU;gBAC7D,MAAMyB,YAA4B;oBAAEX,iBAAiB;gBAAW;gBAChE,MAAM3H,KAAKiI,oBAAoB,CAACI,UAAU;oBAAET,MAAM;wBAAEW,OAAO;oBAAM;oBAAGL,SAAS;gBAAE;gBAC/E,MAAMlI,KAAKiI,oBAAoB,CAACK,WAAW;oBAAEV,MAAM;wBAAEW,OAAO;oBAAO;oBAAGL,SAAS;gBAAE;gBACjF5H,IAAAA,cAAM,EAAC,MAAMN,KAAKoI,mBAAmB,CAACC,WAAWpG,OAAO,CAAC;oBACvD2F,MAAM;wBAAEW,OAAO;oBAAM;oBACrBL,SAAS;gBACX;gBACA5H,IAAAA,cAAM,EAAC,MAAMN,KAAKoI,mBAAmB,CAACE,YAAYrG,OAAO,CAAC;oBACxD2F,MAAM;wBAAEW,OAAO;oBAAO;oBACtBL,SAAS;gBACX;YACF;YAEA7H,IAAAA,YAAI,EAAC,yFAAyF;gBAC5F,MAAMqH,QAAwB;oBAAEC,iBAAiB;gBAAU;gBAC3D,MAAM3H,KAAKiI,oBAAoB,CAACP,OAAO;oBAAEE,MAAM;wBAAEC,QAAQ;oBAAE;oBAAGK,SAAS;gBAAE;gBACzE,MAAMxG,QAAQ,MAAM1B,KAAKoI,mBAAmB,CAACV;gBAC5ChG,MAAOkG,IAAI,AAA4B,CAAC,SAAS,GAAG,CAAC;gBACtD,MAAMjG,SAAS,MAAM3B,KAAKoI,mBAAmB,CAACV;gBAC9CpH,IAAAA,cAAM,EAAC,AAACqB,OAAQiG,IAAI,AAA4B,CAAC,SAAS,EAAE/G,IAAI,CAAC;YACnE;YAEAR,IAAAA,YAAI,EAAC,4DAA4D;gBAC/D,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,SAAS;oBAAEoB,GAAG;gBAAE;gBACvE,MAAMuC,OAAO,MAAM1G,KAAKwI,uBAAuB,CAAC1F,KAAKlC,EAAE,EAAE;gBACzDN,IAAAA,cAAM,EAACoG,MAAMjF,QAAQ;gBACrB,MAAMzB,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;YAEAvD,IAAAA,YAAI,EAAC,iFAAiF;gBACpF,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,YAAY;oBAAEoB,GAAG;gBAAE;gBAC1E,MAAMsE,QAAQ,MAAMzI,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACtD,MAAMZ,KAAKkH,mBAAmB,CAACuB,MAAM7H,EAAE,EAAE;oBAAEqC,QAAQ2D,gBAAU,CAACZ,MAAM;gBAAC;gBAErE,+DAA+D;gBAC/D,yDAAyD;gBACzD,uDAAuD;gBACvD,MAAM,IAAItD,QAAQ,CAACG,IAAM6F,WAAW7F,GAAG;gBAEvC,MAAM8F,QAAQ,MAAM3I,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACtD,MAAMZ,KAAKkH,mBAAmB,CAACyB,MAAM/H,EAAE,EAAE;oBAAEqC,QAAQ2D,gBAAU,CAACZ,MAAM;gBAAC;gBAErE,MAAM4C,SAAS,MAAM5I,KAAKwI,uBAAuB,CAAC1F,KAAKlC,EAAE,EAAE;gBAC3DN,IAAAA,cAAM,EAACsI,QAAQpH,GAAG,CAACC,QAAQ;gBAC3BnB,IAAAA,cAAM,EAACsI,OAAQhI,EAAE,EAAEC,IAAI,CAAC8H,MAAM/H,EAAE;gBAEhC,MAAMZ,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;YAEAvD,IAAAA,YAAI,EAAC,8DAA8D;gBACjE,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,cAAc;oBAAEoB,GAAG;gBAAE;gBAC5E,MAAMnE,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACxC,MAAMiI,QAAQ,MAAM7I,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACtD,MAAMgI,SAAS,MAAM5I,KAAKwI,uBAAuB,CAAC1F,KAAKlC,EAAE,EAAE;gBAC3DN,IAAAA,cAAM,EAACsI,QAAQhI,IAAIC,IAAI,CAACgI,MAAMjI,EAAE;gBAEhC,MAAMZ,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;YAEAvD,IAAAA,YAAI,EAAC,iFAAiF;gBACpF,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,YAAY;oBAAEoB,GAAG;gBAAE;gBAC1E,MAAMuC,OAAO,MAAM1G,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBACrD,MAAMgI,SAAS,MAAM5I,KAAKwI,uBAAuB,CAAC1F,KAAKlC,EAAE,EAAE;gBAC3DN,IAAAA,cAAM,EAACsI,QAAQhI,IAAIC,IAAI,CAAC6F,KAAK9F,EAAE;gBAC/B,MAAMZ,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;YAEAvD,IAAAA,YAAI,EAAC,2GAA2G;gBAC9G,MAAMyC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,UAAU;oBAAEoB,GAAG;gBAAE;gBACxE,MAAMuC,OAAO,MAAM1G,KAAK2G,mBAAmB,CAAC7D,KAAKlC,EAAE,EAAE;gBAErD,oCAAoC;gBACpC,MAAMZ,KAAKkH,mBAAmB,CAACR,KAAK9F,EAAE,EAAE;oBACtCqC,QAAQ2D,gBAAU,CAACtC,OAAO;oBAC1ByC,WAAW;oBACXC,YAAY;oBACZC,aAAa;gBACf;gBAEA,gEAAgE;gBAChE,MAAM6B,aAAa;oBAAEC,gBAAgB;oBAAGC,eAAe;gBAAG;gBAC1D,MAAMhJ,KAAKiI,oBAAoB,CAC7B;oBAAEN,iBAAiBjB,KAAK9F,EAAE;gBAAC,GAC3B;oBAAEgH,MAAMkB;oBAAYZ,SAAS;gBAAE;gBAGjC,qBAAqB;gBACrB,MAAMlI,KAAKkH,mBAAmB,CAACR,KAAK9F,EAAE,EAAE;oBACtCqC,QAAQ2D,gBAAU,CAACZ,MAAM;oBACzBxC,SAAS,IAAIvC;oBACbyC,aAAa;gBACf;gBAEA,2DAA2D;gBAC3D,MAAMkF,SAAS,MAAM5I,KAAKwI,uBAAuB,CAAC1F,KAAKlC,EAAE,EAAE;gBAC3DN,IAAAA,cAAM,EAACsI,QAAQpH,GAAG,CAACC,QAAQ;gBAC3BnB,IAAAA,cAAM,EAACsI,OAAQhI,EAAE,EAAEC,IAAI,CAAC6F,KAAK9F,EAAE;gBAC/BN,IAAAA,cAAM,EAACsI,OAAQ3F,MAAM,EAAEpC,IAAI,CAAC+F,gBAAU,CAACZ,MAAM;gBAE7C,gCAAgC;gBAChC,MAAMmC,MAAM,MAAMnI,KAAKoI,mBAAmB,CAAC;oBAAET,iBAAiBiB,OAAQhI,EAAE;gBAAC;gBACzEN,IAAAA,cAAM,EAAC6H,KAAKlG,OAAO,CAAC;oBAAE2F,MAAMkB;oBAAYZ,SAAS;gBAAE;gBAEnD,MAAMlI,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;oBAAEqC,QAAQC,eAAS,CAACU,SAAS;gBAAC;YACvE;QACF;QAEA7D,IAAAA,gBAAQ,EAAC,sBAAsB;YAC7BM,IAAAA,YAAI,EAAC,gFAAgF;gBACnF,IAAI4I,cAAwD;gBAC5D,MAAMhJ,GAAGiJ,eAAe,CAAC,OAAOf;oBAC9Bc,cAAcd;gBAChB;gBACA7H,IAAAA,cAAM,EAAC2I,aAAazH,GAAG,CAACC,QAAQ;gBAChCnB,IAAAA,cAAM,EAAC2I,YAAaE,QAAQ,EAAEtI,IAAI,CAAC;gBACnCP,IAAAA,cAAM,EAAC,OAAO2I,YAAarI,EAAE,EAAEC,IAAI,CAAC;gBACpCP,IAAAA,cAAM,EAAC2I,YAAarI,EAAE,CAAC4B,MAAM,EAAEa,eAAe,CAAC;YACjD;YAEAhD,IAAAA,YAAI,EAAC,oDAAoD;gBACvD,MAAMqF,SAAS,MAAMzF,GAAGiJ,eAAe,CAAC,UAAa,CAAA;wBAAEE,IAAI;wBAAMtF,GAAG;oBAAG,CAAA;gBACvExD,IAAAA,cAAM,EAACoF,QAAQzD,OAAO,CAAC;oBAAEmH,IAAI;oBAAMtF,GAAG;gBAAG;YAC3C;YAEAzD,IAAAA,YAAI,EAAC,kDAAkD;gBACrD,MAAMgJ,MAAM,IAAIC,MAAM;gBACtB,MAAMhJ,IAAAA,cAAM,EACVL,GAAGiJ,eAAe,CAAC;oBACjB,MAAMG;gBACR,IACAjF,OAAO,CAACvD,IAAI,CAACwI;YACjB;YAEAhJ,IAAAA,YAAI,EAAC,6FAA6F;gBAChG,MAAM+C,gBAAgB,MAAMnD,GAAGiJ,eAAe,CAAC,OAAOf;oBACpD7H,IAAAA,cAAM,EAAC6H,IAAIgB,QAAQ,EAAEtI,IAAI,CAAC;oBAC1B,MAAMiC,OAAO,MAAM9C,KAAK+C,qBAAqB,CAAC,SAAS,WAAW;wBAAEoB,GAAG;oBAAE;oBACzE,MAAMnE,KAAK2D,kBAAkB,CAACb,KAAKlC,EAAE,EAAE;wBAAEqC,QAAQC,eAAS,CAACoB,OAAO;oBAAC;oBACnE,MAAM6C,QAAQ,MAAMnH,KAAKkE,eAAe,CAACpB,KAAKlC,EAAE;oBAChDN,IAAAA,cAAM,EAAC6G,OAAOlE,QAAQpC,IAAI,CAACqC,eAAS,CAACoB,OAAO;oBAC5C,OAAOxB,KAAKM,aAAa;gBAC3B;gBACA,iEAAiE;gBACjE,MAAMmG,QAAQ,MAAMvJ,KAAKsF,sBAAsB,CAAClC;gBAChD,qEAAqE;gBACrE,kEAAkE;gBAClE,qEAAqE;gBACrE9C,IAAAA,cAAM,EAACiJ,UAAU,QAAQA,MAAMtG,MAAM,KAAKC,eAAS,CAACoB,OAAO,EAAEzD,IAAI,CAAC;gBAElE,UAAU;gBACV,IAAI0I,OAAO;oBACT,MAAMvJ,KAAK2D,kBAAkB,CAAC4F,MAAM3I,EAAE,EAAE;wBAAEqC,QAAQC,eAAS,CAACU,SAAS;oBAAC;gBACxE;YACF;YAEAvD,IAAAA,YAAI,EAAC,2EAA2E;gBAC9E,MAAMmJ,MAAM,IAAIrI;gBAChB,IAAK,IAAIa,IAAI,GAAGA,IAAI,GAAGA,IAAK;oBAC1B,MAAM/B,GAAGiJ,eAAe,CAAC,OAAOf;wBAC9BqB,IAAIC,GAAG,CAACtB,IAAIvH,EAAE;oBAChB;gBACF;gBACAN,IAAAA,cAAM,EAACkJ,IAAIpI,IAAI,EAAEP,IAAI,CAAC;YACxB;QACF;IACF;AACF","file":"job-repository.contract.js","sourcesContent":["import { beforeEach, describe, expect, test } from 'vitest';\nimport { JobRepository, type IJobRepository } from '@nest-batch/core';\nimport { TransactionManager } from '@nest-batch/core';\nimport { JobExecutionAlreadyRunningError } from '@nest-batch/core';\nimport { JobStatus, StepStatus } from '@nest-batch/core';\nimport type {\n  ExecutionScope,\n  JobExecution,\n  JobParameters,\n} from '@nest-batch/core';\n\n/**\n * A factory that returns a fresh `JobRepository` + `TransactionManager`\n * pair per call.\n *\n * Every contract test calls this in `beforeEach` to guarantee isolation\n * between cases. Implementations that need a per-test transaction\n * manager, a fresh in-memory store, or a per-test DB transaction\n * rollback can plug that in here.\n */\nexport interface JobRepositoryContractFactory {\n  create(): { repo: IJobRepository; tx: TransactionManager };\n}\n\n/**\n * Shared `JobRepository` + `TransactionManager` contract suite.\n *\n * Every implementation of the batch core repository/transaction contract\n * — in-memory, `@nest-batch/mikro-orm`, `@nest-batch/typeorm`, future\n * adapters — must pass this suite. The contract covers:\n *\n *  - Happy-path lifecycle: getOrCreateJobInstance → createExecutionAtomic\n *    → status updates → step execution lifecycle.\n *  - ExecutionContext save/load roundtrip (the restart-checkpoint\n *    payload path).\n *  - `findLatestStepExecution` returning the latest matching row (the\n *    restart-resume lookup), and only that step name.\n *  - `TransactionManager.withTransaction` wrapping + propagation of\n *    errors and resolved values.\n *  - Negative: a duplicate active execution is rejected\n *    (`JobExecutionAlreadyRunningError`).\n *  - Concurrency: when N callers race `createExecutionAtomic` against\n *    the same `(name, jobKey)`, exactly one wins and the others reject.\n *    This is the in-memory stand-in for PostgreSQL's\n *    `FOR UPDATE SKIP LOCKED` semantics.\n *  - Idempotency: a second launch is allowed after the prior execution\n *    is no longer `STARTING`/`STARTED` (e.g. `COMPLETED`).\n *\n * The contract is intentionally decoupled from any concrete ORM entity\n * class: only the public interfaces and value types are referenced.\n */\nexport function runJobRepositoryContract(\n  factory: JobRepositoryContractFactory,\n  implName: string,\n): void {\n  describe(`JobRepository + TransactionManager contract (${implName})`, () => {\n    let repo: IJobRepository;\n    let tx: TransactionManager;\n\n    beforeEach(() => {\n      const pair = factory.create();\n      repo = pair.repo;\n      tx = pair.tx;\n    });\n\n    describe('JobRepository', () => {\n      test('is an instance of the JobRepository abstract class', () => {\n        // Real implementations extend JobRepository; the interface is\n        // type-only so the runtime check is against the abstract class.\n        expect(repo).toBeInstanceOf(JobRepository);\n      });\n\n      test('getOrCreateJobInstance returns the same instance for the same (name, key)', async () => {\n        const a = await repo.getOrCreateJobInstance('myJob', 'k1');\n        const b = await repo.getOrCreateJobInstance('myJob', 'k1');\n        expect(a.id).toBe(b.id);\n        expect(a.jobName).toBe('myJob');\n        expect(a.jobKey).toBe('k1');\n        expect(a.createdAt).toBeInstanceOf(Date);\n      });\n\n      test('getOrCreateJobInstance returns distinct instances for distinct (name, key) pairs', async () => {\n        const a = await repo.getOrCreateJobInstance('job-a', 'k');\n        const b = await repo.getOrCreateJobInstance('job-b', 'k');\n        const c = await repo.getOrCreateJobInstance('job-a', 'k2');\n        expect(new Set([a.id, b.id, c.id]).size).toBe(3);\n      });\n\n      test('getJobInstance returns an existing instance and null for an unknown id', async () => {\n        const instance = await repo.getOrCreateJobInstance('query-job', 'instance');\n\n        const found = await repo.getJobInstance(instance.id);\n        expect(found).not.toBeNull();\n        expect(found!.id).toBe(instance.id);\n        expect(found!.jobName).toBe('query-job');\n        expect(found!.jobKey).toBe('instance');\n\n        expect(await repo.getJobInstance('does-not-exist')).toBeNull();\n      });\n\n      test('findJobInstances filters by jobName and jobKey', async () => {\n        const first = await repo.getOrCreateJobInstance('query-instances', 'a');\n        const second = await repo.getOrCreateJobInstance('query-instances', 'b');\n        const other = await repo.getOrCreateJobInstance('query-instances-other', 'a');\n\n        const byName = await repo.findJobInstances({ jobName: 'query-instances' });\n        expect(byName.map((i) => i.id)).toEqual(expect.arrayContaining([first.id, second.id]));\n        expect(byName.map((i) => i.id)).not.toContain(other.id);\n\n        const byNameAndKey = await repo.findJobInstances({\n          jobName: 'query-instances',\n          jobKey: 'a',\n        });\n        expect(byNameAndKey.map((i) => i.id)).toEqual([first.id]);\n      });\n\n      test('getOrCreateJobInstance is race-safe under Promise.all concurrency', async () => {\n        const calls = Array.from({ length: 10 }, () =>\n          repo.getOrCreateJobInstance('concurrent-create', 'k'),\n        );\n        const results = await Promise.all(calls);\n        const uniqueIds = new Set(results.map((r) => r.id));\n        expect(uniqueIds.size).toBe(1);\n      });\n\n      test('createExecutionAtomic returns a JobExecution in STARTING status', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-exec', { foo: 'bar' });\n        expect(exec.status).toBe(JobStatus.STARTING);\n        expect(typeof exec.jobInstanceId).toBe('string');\n        expect(exec.jobInstanceId.length).toBeGreaterThan(0);\n        expect(exec.params).toEqual({ foo: 'bar' });\n        expect(exec.startTime).toBeNull();\n        expect(exec.endTime).toBeNull();\n        expect(exec.exitCode).toBe('');\n        expect(exec.exitMessage).toBe('');\n\n        // Cleanup so the next test does not see a running execution.\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('createExecutionAtomic stores a snapshot of params (mutating input does not affect stored value)', async () => {\n        const params: JobParameters = { nested: { n: 1 }, list: [1, 2, 3] };\n        const exec = await repo.createExecutionAtomic('myJob', 'k-snap', params);\n\n        // Mutate the original input — stored params must not change.\n        (params.nested as Record<string, unknown>)['n'] = 999;\n        (params.list as unknown[]).push(999);\n\n        const fetched = await repo.getJobExecution(exec.id);\n        expect(fetched).not.toBeNull();\n        expect((fetched!.params as { nested: { n: number } }).nested.n).toBe(1);\n        expect((fetched!.params as { list: number[] }).list).toEqual([1, 2, 3]);\n\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('createExecutionAtomic is restart-friendly: a new launch after COMPLETED creates a new execution sharing the same instance', async () => {\n        const first = await repo.createExecutionAtomic('myJob', 'k-restart', { p: 1 });\n        await repo.updateJobExecution(first.id, {\n          status: JobStatus.COMPLETED,\n          endTime: new Date(),\n        });\n\n        const second = await repo.createExecutionAtomic('myJob', 'k-restart', { p: 2 });\n        expect(second.id).not.toBe(first.id);\n        expect(second.jobInstanceId).toBe(first.jobInstanceId);\n        expect(second.status).toBe(JobStatus.STARTING);\n\n        await repo.updateJobExecution(second.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('createExecutionAtomic rejects with JobExecutionAlreadyRunningError when an execution is already STARTING', async () => {\n        const first = await repo.createExecutionAtomic('myJob', 'k-dup', { p: 1 });\n        // first is still STARTING — not yet completed\n        await expect(\n          repo.createExecutionAtomic('myJob', 'k-dup', { p: 2 }),\n        ).rejects.toBeInstanceOf(JobExecutionAlreadyRunningError);\n\n        // Cleanup\n        await repo.updateJobExecution(first.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('createExecutionAtomic rejects with JobExecutionAlreadyRunningError when an execution is STARTED', async () => {\n        const first = await repo.createExecutionAtomic('myJob', 'k-started', { p: 1 });\n        await repo.updateJobExecution(first.id, {\n          status: JobStatus.STARTED,\n          startTime: new Date(),\n        });\n\n        await expect(\n          repo.createExecutionAtomic('myJob', 'k-started', { p: 2 }),\n        ).rejects.toBeInstanceOf(JobExecutionAlreadyRunningError);\n\n        await repo.updateJobExecution(first.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('concurrent createExecutionAtomic: exactly one winner, all others reject (FOR UPDATE SKIP LOCKED semantics)', async () => {\n        // SQLite (better-sqlite3) does not support row-level locking,\n        // so concurrent calls all succeed instead of 1 winning and the\n        // rest rejecting. Skip this test when running on SQLite.\n        if (!process.env.DB_HOST && !process.env.DATABASE_URL) {\n          return;\n        }\n\n        const attempts = 5;\n        const settled = await Promise.allSettled(\n          Array.from({ length: attempts }, () =>\n            repo.createExecutionAtomic('concurrent-exec', 'k1', { p: 'x' }),\n          ),\n        );\n        const fulfilled = settled.filter((r) => r.status === 'fulfilled');\n        const rejected = settled.filter((r) => r.status === 'rejected');\n        expect(fulfilled).toHaveLength(1);\n        expect(rejected).toHaveLength(attempts - 1);\n        for (const r of rejected) {\n          if (r.status === 'rejected') {\n            expect(r.reason).toBeInstanceOf(JobExecutionAlreadyRunningError);\n          }\n        }\n        const winningExec = (fulfilled[0] as PromiseFulfilledResult<JobExecution>).value;\n        const running = await repo.getRunningJobExecution(winningExec.jobInstanceId);\n        expect(running?.id).toBe(winningExec.id);\n\n        // Cleanup\n        await repo.updateJobExecution(winningExec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('updateJobExecution: status, startTime, endTime are patchable; unspecified fields are preserved', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-patch', { p: 1 });\n        const startTime = new Date('2025-01-01T00:00:00Z');\n        await repo.updateJobExecution(exec.id, {\n          status: JobStatus.STARTED,\n          startTime,\n        });\n        const afterStart = await repo.getJobExecution(exec.id);\n        expect(afterStart?.status).toBe(JobStatus.STARTED);\n        expect(afterStart?.startTime?.toISOString()).toBe(startTime.toISOString());\n        // endTime is still null (not patched)\n        expect(afterStart?.endTime).toBeNull();\n\n        const endTime = new Date('2025-01-01T00:01:00Z');\n        await repo.updateJobExecution(exec.id, {\n          status: JobStatus.COMPLETED,\n          endTime,\n          exitCode: 'COMPLETED',\n        });\n        const afterEnd = await repo.getJobExecution(exec.id);\n        expect(afterEnd?.status).toBe(JobStatus.COMPLETED);\n        expect(afterEnd?.startTime?.toISOString()).toBe(startTime.toISOString());\n        expect(afterEnd?.endTime?.toISOString()).toBe(endTime.toISOString());\n        expect(afterEnd?.exitCode).toBe('COMPLETED');\n      });\n\n      test('getJobExecution returns null for unknown id', async () => {\n        const result = await repo.getJobExecution('does-not-exist');\n        expect(result).toBeNull();\n      });\n\n      test('getRunningJobExecution returns the STARTING/STARTED execution, or null when none', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-running', { p: 1 });\n        const running = await repo.getRunningJobExecution(exec.jobInstanceId);\n        expect(running?.id).toBe(exec.id);\n        expect(running?.status).toBe(JobStatus.STARTING);\n\n        await repo.updateJobExecution(exec.id, { status: JobStatus.STARTED });\n        const stillRunning = await repo.getRunningJobExecution(exec.jobInstanceId);\n        expect(stillRunning?.id).toBe(exec.id);\n        expect(stillRunning?.status).toBe(JobStatus.STARTED);\n\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n        const noRunning = await repo.getRunningJobExecution(exec.jobInstanceId);\n        expect(noRunning).toBeNull();\n      });\n\n      test('getRunningJobExecution returns null for an unknown job instance id', async () => {\n        const result = await repo.getRunningJobExecution('not-a-real-instance');\n        expect(result).toBeNull();\n      });\n\n      test('findJobExecutions filters by instance, status, and start time window', async () => {\n        const oldStart = new Date('2025-01-01T00:00:00Z');\n        const newStart = new Date('2025-01-02T00:00:00Z');\n        const unrelatedStart = new Date('2025-01-03T00:00:00Z');\n\n        const first = await repo.createExecutionAtomic('query-executions', 'old', { p: 1 });\n        await repo.updateJobExecution(first.id, {\n          status: JobStatus.COMPLETED,\n          startTime: oldStart,\n          endTime: new Date('2025-01-01T00:10:00Z'),\n        });\n\n        const second = await repo.createExecutionAtomic('query-executions', 'new', { p: 2 });\n        await repo.updateJobExecution(second.id, {\n          status: JobStatus.FAILED,\n          startTime: newStart,\n          endTime: new Date('2025-01-02T00:10:00Z'),\n        });\n\n        const unrelated = await repo.createExecutionAtomic('query-executions-other', 'x', { p: 3 });\n        await repo.updateJobExecution(unrelated.id, {\n          status: JobStatus.COMPLETED,\n          startTime: unrelatedStart,\n          endTime: new Date('2025-01-03T00:10:00Z'),\n        });\n\n        const byInstance = await repo.findJobExecutions({\n          jobInstanceId: first.jobInstanceId,\n        });\n        expect(byInstance.map((e) => e.id)).toEqual([first.id]);\n\n        const failed = await repo.findJobExecutions({ status: JobStatus.FAILED });\n        expect(failed.map((e) => e.id)).toContain(second.id);\n        expect(failed.map((e) => e.id)).not.toContain(first.id);\n\n        const terminal = await repo.findJobExecutions({\n          status: [JobStatus.COMPLETED, JobStatus.FAILED],\n        });\n        expect(terminal.map((e) => e.id)).toEqual(\n          expect.arrayContaining([first.id, second.id, unrelated.id]),\n        );\n\n        const windowed = await repo.findJobExecutions({\n          startedAfter: new Date('2025-01-01T12:00:00Z'),\n          startedBefore: new Date('2025-01-02T12:00:00Z'),\n        });\n        expect(windowed.map((e) => e.id)).toContain(second.id);\n        expect(windowed.map((e) => e.id)).not.toContain(first.id);\n        expect(windowed.map((e) => e.id)).not.toContain(unrelated.id);\n      });\n\n      test('createStepExecution + updateStepExecution + getStepExecution roundtrip', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-step', { p: 1 });\n        const step = await repo.createStepExecution(exec.id, 'step-a');\n        expect(step.status).toBe(StepStatus.STARTING);\n        expect(step.jobExecutionId).toBe(exec.id);\n        expect(step.stepName).toBe('step-a');\n        expect(step.readCount).toBe(0);\n        expect(step.writeCount).toBe(0);\n        expect(step.commitCount).toBe(0);\n        expect(step.startTime).toBeNull();\n        expect(step.endTime).toBeNull();\n\n        await repo.updateStepExecution(step.id, {\n          status: StepStatus.STARTED,\n          readCount: 10,\n          writeCount: 5,\n        });\n        const after = await repo.getStepExecution(step.id);\n        expect(after?.status).toBe(StepStatus.STARTED);\n        expect(after?.readCount).toBe(10);\n        expect(after?.writeCount).toBe(5);\n\n        // Cleanup\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('getStepExecution returns null for unknown id', async () => {\n        const result = await repo.getStepExecution('does-not-exist');\n        expect(result).toBeNull();\n      });\n\n      test('findStepExecutions returns all steps for the requested job execution', async () => {\n        const exec = await repo.createExecutionAtomic('query-steps', 'steps', { p: 1 });\n        const first = await repo.createStepExecution(exec.id, 'step-a');\n        const second = await repo.createStepExecution(exec.id, 'step-b');\n        const otherExec = await repo.createExecutionAtomic('query-steps-other', 'steps', { p: 2 });\n        const otherStep = await repo.createStepExecution(otherExec.id, 'step-a');\n\n        const steps = await repo.findStepExecutions(exec.id);\n        expect(steps.map((s) => s.id)).toEqual(expect.arrayContaining([first.id, second.id]));\n        expect(steps.map((s) => s.id)).not.toContain(otherStep.id);\n\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n        await repo.updateJobExecution(otherExec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('saveExecutionContext + getExecutionContext roundtrip preserves data and version', async () => {\n        const scope: ExecutionScope = { stepExecutionId: 'ctx-1' };\n        const data = { cursor: 5, items: [1, 2, 3], meta: { tag: 'x' } };\n        await repo.saveExecutionContext(scope, { data, version: 1 });\n        const ctx = await repo.getExecutionContext(scope);\n        expect(ctx).toEqual({ data, version: 1 });\n      });\n\n      test('saveExecutionContext auto-increments version when the version argument is omitted', async () => {\n        const scope: ExecutionScope = { jobExecutionId: 'ctx-auto' };\n        await repo.saveExecutionContext(scope, { data: { n: 1 }, version: 0 }, 1);\n        await repo.saveExecutionContext(scope, { data: { n: 2 }, version: 0 });\n        const ctx = await repo.getExecutionContext(scope);\n        expect(ctx?.data).toEqual({ n: 2 });\n        expect((ctx?.version ?? 0) > 1).toBe(true);\n      });\n\n      test('getExecutionContext returns { data: null, version: 0 } when no context exists', async () => {\n        const scope: ExecutionScope = { stepExecutionId: 'no-scope' };\n        const ctx = await repo.getExecutionContext(scope);\n        expect(ctx).toEqual({ data: null, version: 0 });\n      });\n\n      test('saveExecutionContext / getExecutionContext isolate job-scope from step-scope', async () => {\n        const jobScope: ExecutionScope = { jobExecutionId: 'iso-job' };\n        const stepScope: ExecutionScope = { stepExecutionId: 'iso-step' };\n        await repo.saveExecutionContext(jobScope, { data: { where: 'job' }, version: 1 });\n        await repo.saveExecutionContext(stepScope, { data: { where: 'step' }, version: 1 });\n        expect(await repo.getExecutionContext(jobScope)).toEqual({\n          data: { where: 'job' },\n          version: 1,\n        });\n        expect(await repo.getExecutionContext(stepScope)).toEqual({\n          data: { where: 'step' },\n          version: 1,\n        });\n      });\n\n      test('saveExecutionContext: mutating returned data does not affect stored data on next read', async () => {\n        const scope: ExecutionScope = { stepExecutionId: 'ctx-mut' };\n        await repo.saveExecutionContext(scope, { data: { cursor: 0 }, version: 1 });\n        const first = await repo.getExecutionContext(scope);\n        (first!.data as Record<string, unknown>)['cursor'] = -1;\n        const second = await repo.getExecutionContext(scope);\n        expect((second!.data as Record<string, unknown>)['cursor']).toBe(0);\n      });\n\n      test('findLatestStepExecution returns null when no step exists', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-nil', { p: 1 });\n        const step = await repo.findLatestStepExecution(exec.id, 'never-existed');\n        expect(step).toBeNull();\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('findLatestStepExecution returns the latest matching step (restart checkpoint)', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-latest', { p: 1 });\n        const older = await repo.createStepExecution(exec.id, 'step-a');\n        await repo.updateStepExecution(older.id, { status: StepStatus.FAILED });\n\n        // SQLite millisecond-resolution timestamps can cause both rows\n        // to share the same created_at, making UUID tie-breaking\n        // non-deterministic. A tiny delay guarantees ordering.\n        await new Promise((r) => setTimeout(r, 5));\n\n        const newer = await repo.createStepExecution(exec.id, 'step-a');\n        await repo.updateStepExecution(newer.id, { status: StepStatus.FAILED });\n\n        const latest = await repo.findLatestStepExecution(exec.id, 'step-a');\n        expect(latest).not.toBeNull();\n        expect(latest!.id).toBe(newer.id);\n\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('findLatestStepExecution ignores steps for other step names', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-isolated', { p: 1 });\n        await repo.createStepExecution(exec.id, 'step-a');\n        const stepB = await repo.createStepExecution(exec.id, 'step-b');\n        const latest = await repo.findLatestStepExecution(exec.id, 'step-b');\n        expect(latest?.id).toBe(stepB.id);\n\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('findLatestStepExecution returns the only matching step when there is just one', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-single', { p: 1 });\n        const step = await repo.createStepExecution(exec.id, 'only-step');\n        const latest = await repo.findLatestStepExecution(exec.id, 'only-step');\n        expect(latest?.id).toBe(step.id);\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n\n      test('checkpoint lookup: after a partial chunk, findLatestStepExecution returns the row and its saved context', async () => {\n        const exec = await repo.createExecutionAtomic('myJob', 'k-ckpt', { p: 1 });\n        const step = await repo.createStepExecution(exec.id, 'chunk-step');\n\n        // Simulate a chunk-mid-flight state\n        await repo.updateStepExecution(step.id, {\n          status: StepStatus.STARTED,\n          readCount: 50,\n          writeCount: 50,\n          commitCount: 1,\n        });\n\n        // Save the last-committed-chunk checkpoint as execution context\n        const checkpoint = { lastChunkIndex: 1, lastReadIndex: 50 };\n        await repo.saveExecutionContext(\n          { stepExecutionId: step.id },\n          { data: checkpoint, version: 1 },\n        );\n\n        // Simulate a failure\n        await repo.updateStepExecution(step.id, {\n          status: StepStatus.FAILED,\n          endTime: new Date(),\n          exitMessage: 'simulated crash',\n        });\n\n        // Restart: look up the latest step execution for this step\n        const latest = await repo.findLatestStepExecution(exec.id, 'chunk-step');\n        expect(latest).not.toBeNull();\n        expect(latest!.id).toBe(step.id);\n        expect(latest!.status).toBe(StepStatus.FAILED);\n\n        // And load its saved checkpoint\n        const ctx = await repo.getExecutionContext({ stepExecutionId: latest!.id });\n        expect(ctx).toEqual({ data: checkpoint, version: 1 });\n\n        await repo.updateJobExecution(exec.id, { status: JobStatus.COMPLETED });\n      });\n    });\n\n    describe('TransactionManager', () => {\n      test('withTransaction yields an active context (isActive=true) with a non-empty id', async () => {\n        let receivedCtx: { isActive: boolean; id: string } | null = null;\n        await tx.withTransaction(async (ctx) => {\n          receivedCtx = ctx;\n        });\n        expect(receivedCtx).not.toBeNull();\n        expect(receivedCtx!.isActive).toBe(true);\n        expect(typeof receivedCtx!.id).toBe('string');\n        expect(receivedCtx!.id.length).toBeGreaterThan(0);\n      });\n\n      test('withTransaction returns the value resolved by fn', async () => {\n        const result = await tx.withTransaction(async () => ({ ok: true, n: 42 }));\n        expect(result).toEqual({ ok: true, n: 42 });\n      });\n\n      test('withTransaction propagates errors thrown by fn', async () => {\n        const err = new Error('tx-boom');\n        await expect(\n          tx.withTransaction(async () => {\n            throw err;\n          }),\n        ).rejects.toBe(err);\n      });\n\n      test('withTransaction wraps repository operations — create + update visible inside the same ctx', async () => {\n        const jobInstanceId = await tx.withTransaction(async (ctx) => {\n          expect(ctx.isActive).toBe(true);\n          const exec = await repo.createExecutionAtomic('myJob', 'tx-wrap', { p: 1 });\n          await repo.updateJobExecution(exec.id, { status: JobStatus.STARTED });\n          const after = await repo.getJobExecution(exec.id);\n          expect(after?.status).toBe(JobStatus.STARTED);\n          return exec.jobInstanceId;\n        });\n        // After the tx, the data must be visible (real DB or in-memory).\n        const execs = await repo.getRunningJobExecution(jobInstanceId);\n        // No running exec remains once we completed it... actually we set it\n        // to STARTED. The contract here is just that the data was visible\n        // inside the tx; we don't assume anything about external visibility.\n        expect(execs === null || execs.status === JobStatus.STARTED).toBe(true);\n\n        // Cleanup\n        if (execs) {\n          await repo.updateJobExecution(execs.id, { status: JobStatus.COMPLETED });\n        }\n      });\n\n      test('withTransaction: two distinct invocations produce different context ids', async () => {\n        const ids = new Set<string>();\n        for (let i = 0; i < 3; i++) {\n          await tx.withTransaction(async (ctx) => {\n            ids.add(ctx.id);\n          });\n        }\n        expect(ids.size).toBe(3);\n      });\n    });\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@nest-batch/core",
+  "version": "0.2.0",
+  "description": "Batch processing engine for NestJS — jobs, steps, chunk-oriented processing, and the persistence/transport contracts the @nest-batch adapters implement.",
+  "license": "MIT",
+  "author": "easdkr",
+  "homepage": "https://github.com/easdkr/nest-batch/tree/main/packages/core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/easdkr/nest-batch.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/easdkr/nest-batch/issues"
+  },
+  "keywords": [
+    "nestjs",
+    "batch",
+    "job",
+    "step",
+    "chunk",
+    "etl",
+    "worker"
+  ],
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist/src",
+    "dist/tests/contracts",
+    "src",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./test-contracts": {
+      "types": "./dist/tests/contracts/index.d.ts",
+      "default": "./dist/tests/contracts/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10 || ^11",
+    "@nestjs/core": "^10 || ^11",
+    "reflect-metadata": "^0.2"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": false
+    },
+    "@nestjs/core": {
+      "optional": false
+    },
+    "reflect-metadata": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@swc/cli": "^0.7.0",
+    "@swc/core": "^1.10.7",
+    "@types/node": "^22.0.0",
+    "reflect-metadata": "^0.2.2",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "swc src -d dist --config-file ../../.swcrc && swc tests/contracts/index.ts -o dist/tests/contracts/index.js --config-file ../../.swcrc && swc tests/contracts/job-repository.contract.ts -o dist/tests/contracts/job-repository.contract.js --config-file ../../.swcrc && tsc --emitDeclarationOnly -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/adapters/in-process.adapter.ts

@@ -0,0 +1,182 @@
+import { Module, type DynamicModule } from '@nestjs/common';
+
+import type { BatchAdapter } from '../module/adapter';
+import { EXECUTION_STRATEGY } from '../execution/execution-strategy';
+import {
+  IN_PROCESS_EXECUTION_STRATEGY_PROVIDER,
+  InProcessExecutionStrategy,
+} from '../execution/in-process-execution-strategy';
+
+/**
+ * Empty Nest module class that owns the in-process execution-strategy
+ * providers.
+ *
+ * The class has no body on purpose: it is purely a `DynamicModule`
+ * carrier for the `forRoot()` factory below. Nest's module system
+ * requires *some* class to identify the module — the empty class is
+ * the minimum possible surface and keeps the runtime allocation at
+ * one class (no decorators, no lifecycle hooks, no metadata).
+ */
+@Module({})
+export class InProcessModule {}
+
+/**
+ * `InProcessAdapter` — the default transport adapter for
+ * `@nest-batch/core`.
+ *
+ * This is the **no-Redis** transport: jobs run synchronously inside
+ * the launching process via `JobExecutor.execute(...)`, on the same
+ * event loop that called `JobLauncher.launch(...)`. There is no
+ * queue, no worker, no Redis connection, no AOF / Lua scripts /
+ * stream events. The whole point of this adapter is to be the
+ * "no transport runtime at all" option.
+ *
+ * Use it when:
+ *
+ *   - You do not need horizontal scale-out (one process, one
+ *     launcher, jobs run inline).
+ *   - You want the cheapest possible deployment — no extra
+ *     infrastructure, no extra process to supervise.
+ *   - You are building a library / dev-time harness and the queue
+ *     runtime would be in the way.
+ *   - You are migrating an existing batch app and want to validate
+ *     the engine end-to-end before turning on a real transport.
+ *
+ * Switch to `@nest-batch/bullmq` (or a future transport) when you
+ * need cross-process work distribution, technical retry at the
+ * transport layer, or a queue-backed backpressure model. The
+ * `IExecutionStrategy` polymorphism means the application code does
+ * not change — only the `transport` slot in `adapters: { ... }` does.
+ *
+ * ## Why a dedicated adapter (and not a built-in default)?
+ *
+ * The new factory-pattern API takes `adapters: { persistence,
+ * transport }` and both slots are *required* (see
+ * `BatchAdaptersConfig`). Shipping the in-process transport as a
+ * dedicated `BatchAdapter` rather than a hidden implicit default
+ * keeps the `AppModule` wiring explicit at the call site — you can
+ * read the host's `imports` array and see exactly which transport is
+ * active. That pays off the first time you debug a "why is this
+ * running inline?" question and need to grep for the transport.
+ *
+ * ## Wiring
+ *
+ * ```ts
+ * import { Module } from '@nestjs/common';
+ * import { NestBatchModule, InProcessAdapter } from '@nest-batch/core';
+ * import { MikroOrmAdapter } from '@nest-batch/mikro-orm';
+ *
+ * @Module({
+ *   imports: [
+ *     NestBatchModule.forRoot({
+ *       adapters: {
+ *         persistence: MikroOrmAdapter,
+ *         transport: InProcessAdapter,
+ *       },
+ *     }),
+ *   ],
+ * })
+ * class AppModule {}
+ * ```
+ *
+ * `InProcessAdapter.forRoot()` takes no options — the in-process
+ * transport has no connection params, no credentials, no knobs to
+ * tune. If you find yourself reaching for a `useFactory` to plumb
+ * some "config" into it, you almost certainly want a real transport
+ * adapter instead.
+ *
+ * ## DI scope
+ *
+ * The module is `global: true` and exports both the strategy class
+ * and the `EXECUTION_STRATEGY` token. Three reasons for the `global`
+ * flag:
+ *
+ *   1. `JobLauncher` (registered by `NestBatchModule`) is `@Inject(
+ *      EXECUTION_STRATEGY )` — it needs the token visible at the
+ *      application level, not just inside the adapter's own module.
+ *   2. The host application is the only place that may want to
+ *      inspect the strategy at runtime (e.g. for a `/healthz`
+ *      endpoint reporting which transport is active). The `global`
+ *      flag makes that work without forcing the host to re-import
+ *      this module from every sub-module.
+ *   3. Mirroring `NestBatchModule`'s own `global: true` keeps the
+ *      pattern uniform across the engine and its adapters — the host
+ *      author only needs to learn one module-visibility model.
+ *
+ * ## Why `globalProviders` is omitted
+ *
+ * The `BatchAdapter` interface allows a `globalProviders` field for
+ * runtime classes (e.g. `JobExecutor`, `InProcessExecutionStrategy`)
+ * that the adapter's *own* module needs to inject but that the host
+ * should also be able to inject. The recommended path is to list
+ * them in the adapter's own `DynamicModule.exports` — which is what
+ * this adapter does. `JobLauncher` (registered by `NestBatchModule`,
+ * not by this adapter) injects the strategy by the `EXECUTION_STRATEGY`
+ * token, which is exported here, so the runtime resolution chain
+ * works without the core module having to know which adapter is
+ * active.
+ *
+ * If a future in-process feature needs to expose a new provider to
+ * the host (e.g. an inline scheduler), prefer adding it to
+ * `exports` and updating the `BatchAdapter.globalProviders` decision
+ * — do not push it onto the host app's `providers` array.
+ *
+ * ## Concurrency
+ *
+ * The default in-process strategy runs jobs on the caller's event
+ * loop. A long-running step will block the launching process. This
+ * is the contract: no concurrency, no parallelism, no out-of-band
+ * execution. If you need concurrency, switch transports.
+ */
+export class InProcessAdapter {
+  /**
+   * Build the `BatchAdapter` value the new factory-pattern
+   * `NestBatchModule.forRoot({ adapters: { transport, ... } })`
+   * expects.
+   *
+   * No options are accepted on purpose — the in-process transport
+   * has nothing to configure. The method is static so the adapter
+   * can be referenced as a value (`adapters: { transport:
+   * InProcessAdapter }`) without needing an instance, mirroring
+   * the shape of the sibling adapter packages' own factories.
+   *
+   * @returns A `BatchAdapter` whose `module` is a `global: true`
+   *   `DynamicModule` exposing `InProcessExecutionStrategy` and the
+   *   `EXECUTION_STRATEGY` token to the host application.
+   */
+  static forRoot(): BatchAdapter {
+    return {
+      name: 'in-process',
+      module: buildInProcessDynamicModule(),
+      globalProviders: [
+        InProcessExecutionStrategy,
+        IN_PROCESS_EXECUTION_STRATEGY_PROVIDER,
+      ],
+    };
+  }
+}
+
+/**
+ * Build the `DynamicModule` payload for the in-process transport.
+ *
+ * Extracted from `InProcessAdapter.forRoot()` so the provider /
+ * export list lives in one place — easier to read, easier to keep
+ * the two arrays in sync if a new provider is ever added.
+ *
+ * The `EXECUTION_STRATEGY` token is exported (not just listed in
+ * `providers`) so that host code can resolve the strategy directly
+ * via `moduleRef.get(EXECUTION_STRATEGY)` — useful for `/healthz`
+ * endpoints that need to report which transport is wired up.
+ *
+ * `InProcessExecutionStrategy` is also exported so host code can
+ * inject the concrete class (not just the token) when type-strict
+ * consumers prefer the class form.
+ */
+function buildInProcessDynamicModule(): DynamicModule {
+  return {
+    module: InProcessModule,
+    global: true,
+    providers: [IN_PROCESS_EXECUTION_STRATEGY_PROVIDER],
+    exports: [IN_PROCESS_EXECUTION_STRATEGY_PROVIDER],
+  };
+}

package/src/adapters/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Public surface for the `adapters/` package directory.
+ *
+ * Re-exports the in-process transport adapter so consumers can
+ * import it via `@nest-batch/core` (the root barrel pulls this file
+ * in) without having to know the internal directory layout.
+ *
+ * Future sibling adapters that *live inside* core (none are planned
+ * at the moment) would be re-exported from here too. The persistence
+ * and remote-transport adapters live in their own sibling packages
+ * (`@nest-batch/mikro-orm`, `@nest-batch/typeorm`, `@nest-batch/bullmq`,
+ * ...) — those are not re-exported from this barrel because the
+ * whole point of splitting the engine into sibling packages is to
+ * keep the dependency graph one-way (core never depends on an
+ * adapter package).
+ */
+export * from './in-process.adapter';

package/src/builder/batch-builder.ts

@@ -0,0 +1,32 @@
+import { JobBuilder } from './job-builder';
+
+/**
+ * Entry point for the fluent Builder API. A tiny, stateless
+ * bootstrap object that hands out a fresh `JobBuilder` per `.job(id)` call.
+ *
+ *   const config = BatchBuilder.create()
+ *     .job('nightly-import')
+ *       .addStep((b) => b.chunk('read', 100, { reader, writer }))
+ *       .from('read').on(COMPLETED).end()
+ *       .build();
+ *
+ * The returned `JobBuilder` produces a plain-data `JobBuilderConfig`
+ * (see `compiler/builder-types.ts`) which `DefinitionCompiler.compileFromBuilderConfig`
+ * then converts to the same `JobDefinition` IR produced by the decorator path.
+ */
+export class BatchBuilder {
+  private constructor() {}
+
+  /** Create a new `BatchBuilder` root. */
+  static create(): BatchBuilder {
+    return new BatchBuilder();
+  }
+
+  /**
+   * Start a new job. Each call returns a fresh, independent `JobBuilder`.
+   * A single `BatchBuilder` can therefore be used to bootstrap many jobs.
+   */
+  job(id: string): JobBuilder {
+    return JobBuilder.create(id);
+  }
+}

package/src/builder/flow-builder.ts

@@ -0,0 +1,141 @@
+import type {
+  DeciderDefinition,
+  FlowTransitionPattern,
+  ReusableFlowDefinition,
+  TransitionDefinition,
+} from '../core/ir';
+
+/**
+ * Focused fluent builder for a single `TransitionDefinition`.
+ *
+ * Mirrors the flow methods exposed on `JobBuilder` (`from` / `on` / `to` /
+ * `end`) but is a standalone, single-use object: `.build()` produces a
+ * fully-validated `TransitionDefinition` value, and the instance is then
+ * discarded.
+ *
+ * Two intended usages:
+ *
+ *   1. **Standalone** — when callers want to build a transition literal
+ *      outside of a `JobBuilder` (e.g. inside helper functions or test
+ *      fixtures that don't need the full job context):
+ *
+ *        const t = new FlowBuilder()
+ *          .from('s1')
+ *          .on(FlowExecutionStatus.FAILED)
+ *          .to('recovery')
+ *          .build();
+ *
+ *   2. **Reuse** — the same chain shape as `JobBuilder`'s flow methods.
+ *      This class is the canonical type the chain returns at the
+ *      `.from(stepId)` step; `JobBuilder.from` simply exposes the same
+ *      shape via its own convenience methods.
+ *
+ * The class is intentionally minimal: no Nest DI, no execution, no
+ * validation beyond "is the transition fully specified?" — the
+ * `DefinitionValidator` does the graph-level checks
+ * (reachability, cycles, missing targets) downstream.
+ */
+export class FlowBuilder {
+  private fromStepId?: string;
+  private onStatus?: FlowTransitionPattern;
+  private toStepId: string | null | undefined;
+  private committed = false;
+
+  /**
+   * Convenience constructor that immediately calls `.from(stepId)`.
+   *
+   *   FlowBuilder.from('s1').on(FAILED).to('s2').build()
+   */
+  static from(stepId: string): FlowBuilder {
+    return new FlowBuilder().from(stepId);
+  }
+
+  /** Set the source step of the transition. */
+  from(stepId: string): this {
+    if (this.committed) {
+      throw new Error('FlowBuilder already committed; create a new instance');
+    }
+    this.fromStepId = stepId;
+    return this;
+  }
+
+  /** Set the status that triggers the transition. Must follow `.from()`. */
+  on(status: FlowTransitionPattern): this {
+    if (this.committed) {
+      throw new Error('FlowBuilder already committed; create a new instance');
+    }
+    if (this.fromStepId === undefined) {
+      throw new Error('FlowBuilder: call .from(stepId) before .on(status)');
+    }
+    this.onStatus = status;
+    return this;
+  }
+
+  /** Set the target step and commit. `null` is reserved for `.end()`. */
+  to(stepId: string): this {
+    if (this.committed) {
+      throw new Error('FlowBuilder already committed; create a new instance');
+    }
+    if (this.fromStepId === undefined || this.onStatus === undefined) {
+      throw new Error('FlowBuilder: call .from() and .on() before .to()');
+    }
+    this.toStepId = stepId;
+    this.committed = true;
+    return this;
+  }
+
+  /** End the transition (target = null) and commit. */
+  end(): this {
+    if (this.committed) {
+      throw new Error('FlowBuilder already committed; create a new instance');
+    }
+    if (this.fromStepId === undefined || this.onStatus === undefined) {
+      throw new Error('FlowBuilder: call .from() and .on() before .end()');
+    }
+    this.toStepId = null;
+    this.committed = true;
+    return this;
+  }
+
+  /**
+   * Produce the final `TransitionDefinition`. Throws if the chain is
+   * incomplete (missing from/on, or never committed via `.to()`/`.end()`).
+   */
+  build(): TransitionDefinition {
+    if (!this.committed) {
+      throw new Error('FlowBuilder: must be committed via .to() or .end()');
+    }
+    if (this.fromStepId === undefined) {
+      throw new Error('FlowBuilder: missing .from(stepId)');
+    }
+    if (this.onStatus === undefined) {
+      throw new Error('FlowBuilder: missing .on(status)');
+    }
+    if (this.toStepId === undefined) {
+      throw new Error('FlowBuilder: missing .to(stepId) or .end()');
+    }
+    return {
+      fromStepId: this.fromStepId,
+      onStatus: this.onStatus,
+      toStepId: this.toStepId,
+    };
+  }
+}
+
+export function defineReusableFlow(
+  definition: ReusableFlowDefinition,
+): ReusableFlowDefinition {
+  return Object.freeze({
+    transitions: Object.freeze([...definition.transitions]),
+    ...(definition.deciders !== undefined
+      ? { deciders: Object.freeze([...definition.deciders]) }
+      : {}),
+  });
+}
+
+export function defineDecider(
+  afterStepId: string,
+  decide: DeciderDefinition['decide'],
+): DeciderDefinition {
+  return Object.freeze({ afterStepId, decide });
+}

package/src/builder/index.ts

@@ -0,0 +1,4 @@
+export * from './batch-builder';
+export * from './job-builder';
+export * from './step-builder';
+export * from './flow-builder';