@proteinjs/db 1.34.3 → 1.34.4

package/dist/generated/test/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../generated/test/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,+BAA6B;AAC7B,6BAA2B;AAC3B,iCAA+B;AAC/B,iCAA+B;AAC/B,8BAA4B;AAC5B,gCAA8B;AAG9B,4BAA4B;AAE5B,IAAM,WAAW,GAAG,ikjHAAikjH,CAAC;AAGtljH,4BAA4B;AAE5B,0FAAgF;AAChF,yCAAwC;AACxC,0FAA+E;AAC/E,0FAAgF;AAChF,0FAA+E;AAC/E,0FAAgF;AAChF,0FAA+E;AAC/E,0FAA2E;AAC3E,0FAA8E;AAC9E,0FAAmF;AACnF,2FAAkF;AAClF,2FAA6E;AAC7E,2FAA2E;AAC3E,2FAA4E;AAC5E,2FAA4E;AAC5E,2FAA8E;AAC9E,sFAAyE;AACzE,wEAA0E;AAC1E,wEAA8E;AAC9E,4GAAiG;AACjG,4GAAwF;AACxF,4GAAwF;AACxF,4GAA8F;AAC9F,4FAA0F;AAC1F,gGAA4F;AAC5F,gGAA2F;AAC3F,gGAAuF;AACvF,gGAAkG;AAClG,wFAA8E;AAC9E,wFAAqF;AACrF,wFAAiF;AACjF,sFAA4F;AAC5F,sFAAgG;AAChG,mCAAkC;AAClC,iEAAgE;AAChE,6DAA4D;AAC5D,2DAA0D;AAC1D,qEAAoE;AACpE,2FAA0F;AAC1F,iFAAgF;AAChF,yEAAwE;AACxE,0EAAyE;AACzE,kEAAiE;AACjE,6EAA4E;AAE5E,IAAM,WAAW,GAAG;IACnB,8BAA8B,EAAE,wCAAc;IAC9C,qBAAqB,EAAE,aAAK;IAC5B,6BAA6B,EAAE,uCAAa;IAC5C,8BAA8B,EAAE,wCAAc;IAC9C,6BAA6B,EAAE,uCAAa;IAC5C,8BAA8B,EAAE,wCAAc;IAC9C,6BAA6B,EAAE,uCAAa;IAC5C,yBAAyB,EAAE,mCAAS;IACpC,4BAA4B,EAAE,sCAAY;IAC1C,iCAAiC,EAAE,2CAAiB;IACpD,gCAAgC,EAAE,2CAAgB;IAClD,2BAA2B,EAAE,sCAAW;IACxC,yBAAyB,EAAE,oCAAS;IACpC,0BAA0B,EAAE,qCAAU;IACtC,0BAA0B,EAAE,qCAAU;IACtC,4BAA4B,EAAE,uCAAY;IAC1C,yBAAyB,EAAE,iCAAS;IACpC,iCAAiC,EAAE,kCAAiB;IACpD,qCAAqC,EAAE,sCAAqB;IAC5D,sCAAsC,EAAE,yDAAsB;IAC9D,6BAA6B,EAAE,gDAAa;IAC5C,6BAA6B,EAAE,gDAAa;IAC5C,mCAAmC,EAAE,sDAAmB;IACxD,uCAAuC,EAAE,kDAAuB;IAChE,uCAAuC,EAAE,oDAAuB;IAChE,sCAAsC,EAAE,mDAAsB;IAC9D,kCAAkC,EAAE,+CAAkB;IACtD,6CAA6C,EAAE,0DAA6B;IAC5E,6BAA6B,EAAE,sCAAa;IAC5C,oCAAoC,EAAE,6CAAoB;IAC1D,gCAAgC,EAAE,yCAAgB;IAClD,4CAA4C,EAAE,oDAA4B;IAC1E,gDAAgD,EAAE,wDAAgC;IAClF,kBAAkB,EAAE,OAAE;IACtB,iCAAiC,EAAE,qCAAiB;IACpD,+BAA+B,EAAE,iCAAe;IAChD,yBAAyB,EAAE,qBAAS;IACpC,8BAA8B,EAAE,+BAAc;IAC9C,wCAAwC,EAAE,mDAAwB;IAClE,mCAAmC,EAAE,yCAAmB;IACxD,+BAA+B,EAAE,iCAAe;IAChD,kCAAkC,EAAE,uCAAkB;IACtD,8BAA8B,EAAE,+BAAc;IAC9C,iCAAiC,EAAE,qCAAiB;CACpD,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../generated/test/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,+BAA6B;AAC7B,6BAA2B;AAC3B,iCAA+B;AAC/B,iCAA+B;AAC/B,8BAA4B;AAC5B,gCAA8B;AAG9B,4BAA4B;AAE5B,IAAM,WAAW,GAAG,wytHAAwytH,CAAC;AAG7ztH,4BAA4B;AAE5B,0FAAgF;AAChF,yCAAwC;AACxC,0FAA+E;AAC/E,0FAAgF;AAChF,0FAA+E;AAC/E,0FAAgF;AAChF,0FAA+E;AAC/E,0FAA2E;AAC3E,0FAA8E;AAC9E,0FAAmF;AACnF,2FAAkF;AAClF,2FAA6E;AAC7E,2FAA2E;AAC3E,2FAA4E;AAC5E,2FAA4E;AAC5E,2FAA8E;AAC9E,sFAAyE;AACzE,wEAA0E;AAC1E,wEAA8E;AAC9E,4GAAiG;AACjG,4GAAwF;AACxF,4GAAwF;AACxF,4GAA8F;AAC9F,4FAA0F;AAC1F,gGAA4F;AAC5F,gGAA2F;AAC3F,gGAAuF;AACvF,gGAAkG;AAClG,gGAAwF;AACxF,wFAA8E;AAC9E,wFAAqF;AACrF,wFAAiF;AACjF,sFAA4F;AAC5F,sFAAgG;AAChG,mCAAkC;AAClC,iEAAgE;AAChE,6DAA4D;AAC5D,2DAA0D;AAC1D,qEAAoE;AACpE,2FAA0F;AAC1F,iFAAgF;AAChF,yEAAwE;AACxE,0EAAyE;AACzE,kEAAiE;AACjE,6EAA4E;AAE5E,IAAM,WAAW,GAAG;IACnB,8BAA8B,EAAE,wCAAc;IAC9C,qBAAqB,EAAE,aAAK;IAC5B,6BAA6B,EAAE,uCAAa;IAC5C,8BAA8B,EAAE,wCAAc;IAC9C,6BAA6B,EAAE,uCAAa;IAC5C,8BAA8B,EAAE,wCAAc;IAC9C,6BAA6B,EAAE,uCAAa;IAC5C,yBAAyB,EAAE,mCAAS;IACpC,4BAA4B,EAAE,sCAAY;IAC1C,iCAAiC,EAAE,2CAAiB;IACpD,gCAAgC,EAAE,2CAAgB;IAClD,2BAA2B,EAAE,sCAAW;IACxC,yBAAyB,EAAE,oCAAS;IACpC,0BAA0B,EAAE,qCAAU;IACtC,0BAA0B,EAAE,qCAAU;IACtC,4BAA4B,EAAE,uCAAY;IAC1C,yBAAyB,EAAE,iCAAS;IACpC,iCAAiC,EAAE,kCAAiB;IACpD,qCAAqC,EAAE,sCAAqB;IAC5D,sCAAsC,EAAE,yDAAsB;IAC9D,6BAA6B,EAAE,gDAAa;IAC5C,6BAA6B,EAAE,gDAAa;IAC5C,mCAAmC,EAAE,sDAAmB;IACxD,uCAAuC,EAAE,kDAAuB;IAChE,uCAAuC,EAAE,oDAAuB;IAChE,sCAAsC,EAAE,mDAAsB;IAC9D,kCAAkC,EAAE,+CAAkB;IACtD,6CAA6C,EAAE,0DAA6B;IAC5E,mCAAmC,EAAE,gDAAmB;IACxD,6BAA6B,EAAE,sCAAa;IAC5C,oCAAoC,EAAE,6CAAoB;IAC1D,gCAAgC,EAAE,yCAAgB;IAClD,4CAA4C,EAAE,oDAA4B;IAC1E,gDAAgD,EAAE,wDAAgC;IAClF,kBAAkB,EAAE,OAAE;IACtB,iCAAiC,EAAE,qCAAiB;IACpD,+BAA+B,EAAE,iCAAe;IAChD,yBAAyB,EAAE,qBAAS;IACpC,8BAA8B,EAAE,+BAAc;IAC9C,wCAAwC,EAAE,mDAAwB;IAClE,mCAAmC,EAAE,yCAAmB;IACxD,+BAA+B,EAAE,iCAAe;IAChD,kCAAkC,EAAE,uCAAkB;IACtD,8BAA8B,EAAE,+BAAc;IAC9C,iCAAiC,EAAE,qCAAiB;CACpD,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,mDAAiC"}

package/dist/src/source/SourceRecord.d.ts

@@ -1,11 +1,40 @@
 import { Loadable } from '@proteinjs/reflection';
 import { Columns, Table } from '../Table';
 import { Record as DbRecord } from '../Record';
-export declare const getSourceRecordLoaders: <T extends SourceRecord = SourceRecord>() => SourceRecordLoader<T>[];
+/**
+ * A source record declaration paired with its owning source: the package that compiled the
+ * declaration into this build (from the declaration's reflection qualified name). The source is
+ * the ownership grain of the sync — {@link SourceRecordLoader} stamps it on every row it writes
+ * and prunes only within it, so servers running different builds against one shared database
+ * never delete each other's rows.
+ */
+export type SourceRecordLoaderDeclaration<T extends SourceRecord = SourceRecord> = {
+    source: string;
+    loader: SourceRecordLoader<T>;
+};
+export declare const getSourceRecordLoaders: <T extends SourceRecord = SourceRecord>() => SourceRecordLoaderDeclaration<T>[];
 export declare function getSourceRecordTables(): Table<any>[];
 export declare function isSourceRecordTable(table: Table<any>): boolean;
 export interface SourceRecord extends DbRecord {
     isLoadedFromSource?: boolean;
+    /**
+     * The package whose declaration owns this row (the declaring loader's package, from its
+     * reflection qualified name). Stamped by {@link SourceRecordLoader} on every row it writes;
+     * the removed-reconcile prunes only rows whose `sourcePackage` matches a package the running
+     * build actually declares from — so a build never deletes rows owned by a package it does not
+     * carry (e.g. another server's types on a shared database). Rows written before this column
+     * existed carry NULL until their owning package's next boot adopts and stamps them.
+     */
+    sourcePackage?: string;
+    /**
+     * The declaring package's version at the time this row was last stamped (from the package's
+     * own package.json, resolved at runtime). This is the ordering WITHIN a package that makes
+     * version skew safe on a shared database: a boot never prunes, flags, or rewrites a row stamped
+     * by a strictly NEWER version of the same package, so an older build cannot delete the types a
+     * newer build added or churn the ones it redefined. NULL (legacy rows, or builds whose package
+     * version could not be resolved) carries no ordering and keeps the last-writer-wins semantics.
+     */
+    sourcePackageVersion?: string;
 }
 /**
  * Wrapper function to add default Record and SourceRecord columns to your table's columns.
@@ -30,7 +59,11 @@ type OptionalProperties<T> = Pick<T, {
  *
  * On Db.init, the record will be inserted if it doesn't exist, and updated if it does exist to mirror what is in source.
  *
- * If the SourceRecordLoader is deleted from source, the record will be deleted from the db on server startup. This will also be the behavior if id is changed - the record with the old id will be deleted.
+ * If the SourceRecordLoader is deleted from source, the record will be deleted from the db on server startup (per the
+ * table's `onSourceRemoved` policy) — by the next boot of a build that still carries the declaring package at its
+ * version or newer. Ownership is per package: a boot only reconciles rows owned by packages it carries, and never
+ * rows a newer version of the same package stamped; a package removed from every build leaves its rows behind.
+ * This will also be the behavior if id is changed - the record with the old id will be deleted.
  */
 export interface SourceRecordLoader<T extends SourceRecord> extends Loadable {
     table: Table<T>;

package/dist/src/source/SourceRecord.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceRecord.d.ts","sourceRoot":"","sources":["../../../src/source/SourceRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAa,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAqB,MAAM,WAAW,CAAC;AAGlE,eAAO,MAAM,sBAAsB,sEACwD,CAAC;AAE5F,wBAAgB,qBAAqB,iBAUpC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,WASpD;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAQD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,YAAY,EAC5D,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,YAAY,CAAC,CAAC,EAC7C,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,YAAY,CAAC,CAAC,CAK9D;AAED,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACpE,KAAK,4BAA4B,CAAC,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAC5F,KAAK,kBAAkB,CAAC,CAAC,IAAI,IAAI,CAC/B,CAAC,EACD;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACtD,CAAC,MAAM,CAAC,CAAC,CACX,CAAC;AACF,KAAK,kBAAkB,CAAC,CAAC,IAAI,IAAI,CAC/B,CAAC,EACD;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;CACtD,CAAC,MAAM,CAAC,CAAC,CACX,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,YAAY,CAAE,SAAQ,QAAQ;IAC1E,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,MAAM,EAAE;SACL,CAAC,IAAI,MAAM,kBAAkB,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CACzF,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACvC,CAAC,CAAC,CAAC;KACL,GAAG;SACD,CAAC,IAAI,MAAM,kBAAkB,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAC1F,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACvC,CAAC,CAAC,CAAC;KACL,CAAC;CACH"}
+{"version":3,"file":"SourceRecord.d.ts","sourceRoot":"","sources":["../../../src/source/SourceRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAa,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAqB,MAAM,WAAW,CAAC;AAGlE;;;;;;GAMG;AACH,MAAM,MAAM,6BAA6B,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,iFAG6C,CAAC;AAEjF,wBAAgB,qBAAqB,iBAUpC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,WASpD;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAUD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,YAAY,EAC5D,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,YAAY,CAAC,CAAC,EAC7C,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,YAAY,CAAC,CAAC,CAK9D;AAED,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACpE,KAAK,4BAA4B,CAAC,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAC5F,KAAK,kBAAkB,CAAC,CAAC,IAAI,IAAI,CAC/B,CAAC,EACD;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACtD,CAAC,MAAM,CAAC,CAAC,CACX,CAAC;AACF,KAAK,kBAAkB,CAAC,CAAC,IAAI,IAAI,CAC/B,CAAC,EACD;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;CACtD,CAAC,MAAM,CAAC,CAAC,CACX,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,YAAY,CAAE,SAAQ,QAAQ;IAC1E,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,MAAM,EAAE;SACL,CAAC,IAAI,MAAM,kBAAkB,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CACzF,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACvC,CAAC,CAAC,CAAC;KACL,GAAG;SACD,CAAC,IAAI,MAAM,kBAAkB,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAC1F,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACvC,CAAC,CAAC,CAAC;KACL,CAAC;CACH"}

package/dist/src/source/SourceRecord.js

@@ -6,7 +6,12 @@ var Table_1 = require("../Table");
 var Record_1 = require("../Record");
 var Columns_1 = require("../Columns");
 var getSourceRecordLoaders = function () {
-    return reflection_1.SourceRepository.get().objects('@proteinjs/db/SourceRecordLoader');
+    return reflection_1.SourceRepository.get()
+        .objectsWithNames('@proteinjs/db/SourceRecordLoader')
+        .map(function (_a) {
+        var packageName = _a.packageName, object = _a.object;
+        return ({ source: packageName, loader: object });
+    });
 };
 exports.getSourceRecordLoaders = getSourceRecordLoaders;
 function getSourceRecordTables() {
@@ -35,6 +40,8 @@ var getSourceRecordColumns = function (hideFromUi) {
     if (hideFromUi === void 0) { hideFromUi = true; }
     return {
         isLoadedFromSource: new Columns_1.BooleanColumn('is_loaded_from_source', { ui: { hidden: hideFromUi } }),
+        sourcePackage: new Columns_1.StringColumn('source_package', { ui: { hidden: hideFromUi } }),
+        sourcePackageVersion: new Columns_1.StringColumn('source_package_version', { ui: { hidden: hideFromUi } }),
     };
 };
 /**

package/dist/src/source/SourceRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"SourceRecord.js","sourceRoot":"","sources":["../../../src/source/SourceRecord.ts"],"names":[],"mappings":";;;AAAA,oDAAmE;AACnE,kCAAqD;AACrD,oCAAkE;AAClE,sCAA2C;AAEpC,IAAM,sBAAsB,GAAG;IACpC,OAAA,6BAAgB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAwB,kCAAkC,CAAC;AAAzF,CAAyF,CAAC;AAD/E,QAAA,sBAAsB,0BACyD;AAE5F,SAAgB,qBAAqB;IACnC,IAAM,MAAM,GAAG,IAAA,iBAAS,GAAE,CAAC;IAC3B,IAAM,kBAAkB,GAAiB,EAAE,CAAC;IAC5C,KAAoB,UAAM,EAAN,iBAAM,EAAN,oBAAM,EAAN,IAAM,EAAE;QAAvB,IAAM,KAAK,eAAA;QACd,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE;YAC9B,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAChC;KACF;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAVD,sDAUC;AAED,SAAgB,mBAAmB,CAAC,KAAiB;IACnD,KAAK,IAAM,kBAAkB,IAAI,KAAK,CAAC,OAAO,EAAE;QAC9C,IAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,IAAI,IAAI,sBAAsB,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE;YACnE,OAAO,IAAI,CAAC;SACb;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AATD,kDASC;AAMD,IAAM,sBAAsB,GAAG,UAAC,UAAiB;IAAjB,2BAAA,EAAA,iBAAiB;IAC/C,OAAO;QACL,kBAAkB,EAAE,IAAI,uBAAa,CAAC,uBAAuB,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CACrC,OAA6C,EAC7C,UAAoB;IAEpB,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,EACrD,IAAA,0BAAiB,EAAW,OAAO,CAAQ,CAC5C,CAAC;AACJ,CAAC;AARD,0DAQC"}
+{"version":3,"file":"SourceRecord.js","sourceRoot":"","sources":["../../../src/source/SourceRecord.ts"],"names":[],"mappings":";;;AAAA,oDAAmE;AACnE,kCAAqD;AACrD,oCAAkE;AAClE,sCAAyD;AAclD,IAAM,sBAAsB,GAAG;IACpC,OAAA,6BAAgB,CAAC,GAAG,EAAE;SACnB,gBAAgB,CAAwB,kCAAkC,CAAC;SAC3E,GAAG,CAAC,UAAC,EAAuB;YAArB,WAAW,iBAAA,EAAE,MAAM,YAAA;QAAO,OAAA,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAzC,CAAyC,CAAC;AAF9E,CAE8E,CAAC;AAHpE,QAAA,sBAAsB,0BAG8C;AAEjF,SAAgB,qBAAqB;IACnC,IAAM,MAAM,GAAG,IAAA,iBAAS,GAAE,CAAC;IAC3B,IAAM,kBAAkB,GAAiB,EAAE,CAAC;IAC5C,KAAoB,UAAM,EAAN,iBAAM,EAAN,oBAAM,EAAN,IAAM,EAAE;QAAvB,IAAM,KAAK,eAAA;QACd,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE;YAC9B,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAChC;KACF;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAVD,sDAUC;AAED,SAAgB,mBAAmB,CAAC,KAAiB;IACnD,KAAK,IAAM,kBAAkB,IAAI,KAAK,CAAC,OAAO,EAAE;QAC9C,IAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,IAAI,IAAI,sBAAsB,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE;YACnE,OAAO,IAAI,CAAC;SACb;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AATD,kDASC;AAwBD,IAAM,sBAAsB,GAAG,UAAC,UAAiB;IAAjB,2BAAA,EAAA,iBAAiB;IAC/C,OAAO;QACL,kBAAkB,EAAE,IAAI,uBAAa,CAAC,uBAAuB,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QAC9F,aAAa,EAAE,IAAI,sBAAY,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QACjF,oBAAoB,EAAE,IAAI,sBAAY,CAAC,wBAAwB,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;KACjG,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CACrC,OAA6C,EAC7C,UAAoB;IAEpB,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,EACrD,IAAA,0BAAiB,EAAW,OAAO,CAAQ,CAC5C,CAAC;AACJ,CAAC;AARD,0DAQC"}

package/dist/src/source/SourceRecordLoader.d.ts

@@ -1,14 +1,67 @@
+/** What one boot of the sync did to one source-record table. */
+export type SourceRecordTableLoadSummary = {
+    inserts: number;
+    updates: number;
+    unchanged: number;
+    adopted: number;
+    deletes: number;
+    removedUpdates: number;
+    /** Rows stamped by a newer version of their declaring package — left exactly as they are. */
+    skippedNewer: number;
+    /** Source-loaded rows with no owner stamp that no declaration in this build claims. */
+    unowned: number;
+};
+export type SourceRecordLoadSummary = {
+    [tableName: string]: SourceRecordTableLoadSummary;
+};
 export declare class SourceRecordLoader {
     private logger;
-    load(): Promise<void>;
+    /** Memo of resolved package versions — one resolution (and at most one warning) per source. */
+    private sourceVersions;
     /**
-     * The removed-reconcile leg: rows previously loaded from source whose declaration no longer
-     * exists (`is_loaded_from_source = true AND <key> NOT IN declared`), handled per the table's
-     * `onSourceRemoved` policy — delete (default), keep, or update with a patch. The update leg
-     * applies the patch only to rows whose fields actually differ (idempotent boots), through
-     * `Db.update` so table watchers observe each write.
+     * One boot of the source-record sync, per source-record table in this build. Returns what it
+     * did to each table (also logged).
+     *
+     * Ownership model — every row has one owner, the package that declares it, ordered by that
+     * package's version:
+     * - A boot speaks only for the packages it carries. Rows owned by a package this build does
+     *   not carry are never touched: several servers running different builds against one shared
+     *   database coexist without pruning each other's rows.
+     * - Within a package, a boot speaks only for its own version or older. A row stamped by a
+     *   NEWER version of the same package is left exactly as it is — neither pruned nor rewritten —
+     *   so ordinary version skew (an older build restarting against rows a newer build added or
+     *   redefined) cannot delete or churn data. The newest version stays authoritative for
+     *   genuine removals and redefinitions.
+     * - A package in the build is authoritative for all of its rows on every table, including
+     *   tables it no longer declares anything for: dropping the last declaration is a removal.
+     * - Rows with no owner stamp (written before `source_package` existed) are claimed by the
+     *   declaration that still matches them; the rest are reported as unowned and left alone.
+     *
+     * Accepted residuals: a package removed from every build leaves its rows behind (no surviving
+     * boot carries its authority — clean up explicitly); two builds of one package at the SAME
+     * version with differing sets (uncommitted local skew) are last-writer-wins, since versions
+     * cannot order them.
+     */
+    load(): Promise<SourceRecordLoadSummary>;
+    /**
+     * The removed-reconcile leg: rows owned by a package this build carries, at that package's
+     * version or older, that NO package in this build still declares
+     * (`is_loaded_from_source = true AND source_package IN <build's packages> AND <key> NOT IN
+     * <build's declared keys for the table>`, minus rows stamped by a newer version of their
+     * package) are handled per the table's `onSourceRemoved` policy — delete (default), keep, or
+     * update with a patch. The update leg applies the patch only to rows whose fields actually
+     * differ (idempotent boots), through `Db.update` so table watchers observe each write.
+     * See {@link load} for the ownership model.
      */
     private reconcileRemoved;
+    /**
+     * Source-loaded rows with no owner stamp that no declaration in this build claimed on this
+     * boot (the stamp leg has already run). They predate `source_package`, or their declaring
+     * package is not in this build; nobody prunes them. Reported so they are visible, never acted
+     * on. Tables that keep removed rows (`onSourceRemoved: 'keep'`) opted out of removal
+     * semantics altogether, so there is nothing to explain there.
+     */
+    private countUnowned;
     /**
      * Resolve and validate the property the sync keys on: `id` unless the table declares
      * `sourceRecordOptions.naturalKey`. A natural key must be schema-unique (a `ColumnOptions.unique`
@@ -29,7 +82,11 @@ export declare class SourceRecordLoader {
      * triggers a rewrite. Primitive columns retain their existing semantics.
      */
     private hasChanges;
-    private getSourceRecordsMap;
+    /**
+     * Every source-record table in this build with the records declared for it, plus the set of
+     * packages that declare ANY source record in this build — the packages this boot speaks for.
+     */
+    private getDeclarations;
     /**
      * Find the first point of divergence between source and existing values.
      * Returns a description of the mismatch path, or null if they match.
@@ -58,5 +115,39 @@ export declare class SourceRecordLoader {
      * are sorted.
      */
     private canonicalStringify;
+    /** Memoized {@link resolveSourceVersion} — one resolution (and at most one warning) per source. */
+    private sourceVersion;
+    /**
+     * The declaring package's version, read from its own package.json at runtime. Resolution runs
+     * from the process cwd — the booting server's package, the one dependency tree every declaring
+     * package is reachable from (`@proteinjs/db` itself does not depend on the packages that
+     * declare records, so module-relative resolution could never find them). The package's entry
+     * is resolved (honoring exports maps, where `<pkg>/package.json` is usually not requireable),
+     * then the nearest package.json whose `name` matches is read walking up from it.
+     *
+     * Returns undefined where resolution is impossible — no Node `require` (browser bundles), or a
+     * package not resolvable from cwd. The sync then has no place in the version order for that
+     * package: it never touches its version-stamped rows, and what it writes is unversioned
+     * (see {@link isNewerStamp}). Logged once per boot so a misconfigured cwd is visible.
+     */
+    private resolveSourceVersion;
+    /**
+     * Whether a row's version stamp is strictly newer than the reconciling build's version of the
+     * same package — the guard that makes version skew of one package safe on a shared database:
+     * an older build never prunes (or flags) rows a newer build of the same package declared.
+     *
+     * Unversioned stamps (NULL — legacy rows, or builds whose version could not be resolved)
+     * carry no ordering and stay reconcilable (last-writer-wins, the pre-version behavior). A
+     * build whose OWN version is unresolvable cannot place itself in the order, so it never
+     * touches a version-stamped row — conservative: prefer leaving a removed row behind over
+     * deleting one that might be newer.
+     */
+    private isNewerStamp;
+    /**
+     * Semver comparison (major.minor.patch, prerelease-aware): negative when a < b, 0 when equal,
+     * positive when a > b, and undefined when either side does not parse as semver (unorderable —
+     * the caller treats that conservatively).
+     */
+    private compareVersions;
 }
 //# sourceMappingURL=SourceRecordLoader.d.ts.map

package/dist/src/source/SourceRecordLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceRecordLoader.d.ts","sourceRoot":"","sources":["../../../src/source/SourceRecordLoader.ts"],"names":[],"mappings":"AAYA,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA+C;IAEvD,IAAI;IAiEV;;;;;;OAMG;YACW,gBAAgB;IAoC9B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IA+CvB;;;;;;;;;;;OAWG;YACW,UAAU;YAmBV,mBAAmB;IAwBjC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gBAAgB;IAkDxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;CAkB3B"}
+{"version":3,"file":"SourceRecordLoader.d.ts","sourceRoot":"","sources":["../../../src/source/SourceRecordLoader.ts"],"names":[],"mappings":"AAkBA,gEAAgE;AAChE,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG,4BAA4B,CAAA;CAAE,CAAC;AAE5F,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA+C;IAE7D,+FAA+F;IAC/F,OAAO,CAAC,cAAc,CAAyC;IAE/D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,IAAI,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAoG9C;;;;;;;;;OASG;YACW,gBAAgB;IA2D9B;;;;;;OAMG;YACW,YAAY;IAkB1B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IA+CvB;;;;;;;;;;;OAWG;YACW,UAAU;IAmBxB;;;OAGG;YACW,eAAe;IAmB7B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gBAAgB;IAkDxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IAmB1B,mGAAmG;IACnG,OAAO,CAAC,aAAa;IAQrB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,oBAAoB;IAuC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;IAapB;;;;OAIG;IACH,OAAO,CAAC,eAAe;CA4DxB"}