@sanoma-ai/workflows 0.11.13 → 0.11.15

package/dist/db/index.d.ts

@@ -1,6 +1,7 @@
-export { type Db, databaseOn, pgCode } from "../db.ts";
+export { type Db, databaseOn, pgCode, underPreparationLock } from "../db.ts";
 export * from "./company.ts";
 export * from "./dbos.ts";
 export * from "./identity.ts";
 export * from "./kms.ts";
+export * from "./migrate.ts";
 export * from "./wakeup.ts";

package/dist/db/index.js

@@ -1,10 +1,12 @@
 // `@sanoma-ai/workflows/db`, server-only: the runtime's tables and the database they are read
-// with, for the packages that share them (the connectors' stores, the app's tests). Never a
-// workflow's import: the shipped `oxlint.json` refuses it, as it does `/wakeup-service`.
-export { databaseOn, pgCode } from "../db.js";
+// with, for the packages that share them (the connectors' stores, the app's tests), and the
+// migrator a connector applies its own generated folder with, under the preparation's lock. Never
+// a workflow's import: the shipped `oxlint.json` refuses it, as it does `/wakeup-service`.
+export { databaseOn, pgCode, underPreparationLock } from "../db.js";
 export * from "./company.js";
 export * from "./dbos.js";
 export * from "./identity.js";
 export * from "./kms.js";
+export * from "./migrate.js";
 export * from "./wakeup.js";
 //# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,4FAA4F;AAC5F,yFAAyF;AAEzF,OAAO,EAAW,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,4FAA4F;AAC5F,kGAAkG;AAClG,2FAA2F;AAE3F,OAAO,EAAW,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC7E,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/db/migrate.d.ts

@@ -9,15 +9,18 @@ export interface MigrationsJournal {
 }
 /** A migrations folder with the journal table recording what of it a database has. */
 export interface Migrations {
-    /** The folder's name under the package's `drizzle/`. */
-    name: string;
+    /**
+     * The folder, beside the module declaring it (`new URL("../drizzle/<name>/", import.meta.url)`,
+     * from `src/` and from `dist/` alike), asked for only when migrating, never in the Worker.
+     */
+    folder(): URL;
     /** Its journal table in the schema `drizzle`. */
     table: string;
     journal: MigrationsJournal;
 }
 /** The tables every company database gets (`db/company.ts`). */
 export declare const COMPANY_MIGRATIONS: {
-    name: string;
+    folder: () => import("node:url").URL;
     table: string;
     journal: {
         version: string;
@@ -33,7 +36,7 @@ export declare const COMPANY_MIGRATIONS: {
 };
 /** The wakeup service's tables (`db/wakeup.ts`). */
 export declare const WAKEUP_MIGRATIONS: {
-    name: string;
+    folder: () => import("node:url").URL;
     table: string;
     journal: {
         version: string;
@@ -50,8 +53,8 @@ export declare const WAKEUP_MIGRATIONS: {
 /**
  * Applies to `db` the migrations of `of` its database has not had, in one transaction, recording
  * each in the journal table. Drizzle's migrator compares only the newest timestamp, so a migration
- * older than the newest applied is skipped: `scripts/check-journal.ts` keeps a branch from adding
- * one. Two processes migrating one database at once race (the migrator takes no lock): callers
+ * older than the newest applied is skipped: the repository's `scripts/check-journal.ts` keeps a
+ * branch from adding one. Two processes migrating one database at once race (the migrator takes no lock): callers
  * hold `underPreparationLock`.
  */
 export declare const applyMigrations: (db: Db, of: Migrations) => Promise<void>;

package/dist/db/migrate.js

@@ -3,28 +3,26 @@ import { sql } from "drizzle-orm";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
 import companyJournal from "../../drizzle/company/meta/_journal.json" with { type: "json" };
 import wakeupJournal from "../../drizzle/wakeup/meta/_journal.json" with { type: "json" };
-/** The folder of `of`, from `src/` and from `dist/` alike; read only when migrating, never in the Worker. */
-const folderOf = (of) => fileURLToPath(new URL(`../../drizzle/${of.name}/`, import.meta.url));
 /** The tables every company database gets (`db/company.ts`). */
 export const COMPANY_MIGRATIONS = {
-    name: "company",
+    folder: () => new URL("../../drizzle/company/", import.meta.url),
     table: "__drizzle_migrations",
     journal: companyJournal,
 };
 /** The wakeup service's tables (`db/wakeup.ts`). */
 export const WAKEUP_MIGRATIONS = {
-    name: "wakeup",
+    folder: () => new URL("../../drizzle/wakeup/", import.meta.url),
     table: "__drizzle_migrations_wakeup",
     journal: wakeupJournal,
 };
 /**
  * Applies to `db` the migrations of `of` its database has not had, in one transaction, recording
  * each in the journal table. Drizzle's migrator compares only the newest timestamp, so a migration
- * older than the newest applied is skipped: `scripts/check-journal.ts` keeps a branch from adding
- * one. Two processes migrating one database at once race (the migrator takes no lock): callers
+ * older than the newest applied is skipped: the repository's `scripts/check-journal.ts` keeps a
+ * branch from adding one. Two processes migrating one database at once race (the migrator takes no lock): callers
  * hold `underPreparationLock`.
  */
-export const applyMigrations = (db, of) => migrate(db, { migrationsFolder: folderOf(of), migrationsTable: of.table });
+export const applyMigrations = (db, of) => migrate(db, { migrationsFolder: fileURLToPath(of.folder()), migrationsTable: of.table });
 /**
  * Whether the database `db` is on has had every migration of `of`: each journal entry's `when`
  * is a `created_at` of its journal table, whatever else the table holds (a database a newer

package/dist/db/migrate.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAE7D,OAAO,cAAc,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5F,OAAO,aAAa,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAsB1F,6GAA6G;AAC7G,MAAM,QAAQ,GAAG,CAAC,EAAc,EAAU,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC,IAAI,GAAG,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAElH,gEAAgE;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,sBAAsB;IAC7B,OAAO,EAAE,cAAc;CACH,CAAC;AAEvB,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,6BAA6B;IACpC,OAAO,EAAE,aAAa;CACF,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAM,EAAE,EAAc,EAAiB,EAAE,CACvE,OAAO,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAM,EAAE,EAAc;IAC5D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAC9B,GAAG,CAAA,sBAAsB,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,CACzE,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAC/B,GAAG,CAAA,8CAA8C,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAC5E,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAE7D,OAAO,cAAc,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5F,OAAO,aAAa,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AA0B1F,gEAAgE;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,wBAAwB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC;IAChE,KAAK,EAAE,sBAAsB;IAC7B,OAAO,EAAE,cAAc;CACH,CAAC;AAEvB,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,uBAAuB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC;IAC/D,KAAK,EAAE,6BAA6B;IACpC,OAAO,EAAE,aAAa;CACF,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAM,EAAE,EAAc,EAAiB,EAAE,CACvE,OAAO,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;AAE3F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAM,EAAE,EAAc;IAC5D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAC9B,GAAG,CAAA,sBAAsB,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,CACzE,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAC/B,GAAG,CAAA,8CAA8C,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAC5E,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/fill.d.ts

@@ -1,7 +1,11 @@
 import { z } from "zod";
 /** Seeds the generator from a name, so one name always makes up the same values. */
 export declare const seedFrom: (name: string) => void;
-/** The schema's value with every field `given` does not set made up, parsed by the schema. */
+/**
+ * The schema's value with every required field `given` does not set made up, parsed by the schema.
+ * Optional fields are left out, as a caller may leave them: made up, they could break a rule
+ * between fields (one of two ids, not both).
+ */
 export declare function fill(schema: z.ZodType, given: Record<string, unknown>): unknown;
 /** An object schema's fields by name; none for any other schema. */
 export declare const shapeOf: (schema: z.ZodType) => Record<string, z.ZodType>;

package/dist/fill.js

@@ -6,9 +6,18 @@ import { z } from "zod";
 setFaker(faker);
 /** Seeds the generator from a name, so one name always makes up the same values. */
 export const seedFrom = (name) => seed(createHash("sha256").update(name).digest().readUInt32BE(0));
-/** The schema's value with every field `given` does not set made up, parsed by the schema. */
+/**
+ * The schema's value with every required field `given` does not set made up, parsed by the schema.
+ * Optional fields are left out, as a caller may leave them: made up, they could break a rule
+ * between fields (one of two ids, not both).
+ */
 export function fill(schema, given) {
-    return schema.parse({ ...fake(schema), ...given });
+    const made = fake(schema);
+    for (const [name, field] of Object.entries(shapeOf(schema))) {
+        if (field.safeParse(undefined).success)
+            delete made[name];
+    }
+    return schema.parse({ ...made, ...given });
 }
 /** An object schema's fields by name; none for any other schema. */
 export const shapeOf = (schema) => schema instanceof z.ZodObject ? schema.shape : {};

package/dist/fill.js.map

@@ -1 +1 @@
-{"version":3,"file":"fill.js","sourceRoot":"","sources":["../src/fill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAE/D,QAAQ,CAAC,KAAK,CAAC,CAAC;AAEhB,oFAAoF;AACpF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3G,8FAA8F;AAC9F,MAAM,UAAU,IAAI,CAAC,MAAiB,EAAE,KAA8B;IACpE,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,GAAI,IAAI,CAAC,MAAM,CAAY,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAiB,EAA6B,EAAE,CACtE,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAEpD,sHAAsH;AACtH,MAAM,UAAU,MAAM,CAAC,MAAiB;IACtC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,MAAM,CAAC,GAAG,CAAC,QAAkC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxG,OAAO,IAAI,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAC,MAAiB;IAC3C,IAAI,KAAK,GAAG,MAAM,CAAC;IACnB,OAAO,KAAK,YAAY,CAAC,CAAC,WAAW,IAAI,KAAK,YAAY,CAAC,CAAC,WAAW,IAAI,KAAK,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC;QACzG,KAAK,GAAG,KAAK,CAAC,MAAM,EAAe,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,gHAAgH;AAChH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAE,EAAE,CACpC,GAAG,YAAY,SAAS,IAAI,GAAG,YAAY,UAAU,IAAI,GAAG,YAAY,cAAc,CAAC"}
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../src/fill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAE/D,QAAQ,CAAC,KAAK,CAAC,CAAC;AAEhB,oFAAoF;AACpF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3G;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,MAAiB,EAAE,KAA8B;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAA4B,CAAC;IACrD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC5D,IAAI,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAiB,EAA6B,EAAE,CACtE,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAEpD,sHAAsH;AACtH,MAAM,UAAU,MAAM,CAAC,MAAiB;IACtC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,MAAM,CAAC,GAAG,CAAC,QAAkC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxG,OAAO,IAAI,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAC,MAAiB;IAC3C,IAAI,KAAK,GAAG,MAAM,CAAC;IACnB,OAAO,KAAK,YAAY,CAAC,CAAC,WAAW,IAAI,KAAK,YAAY,CAAC,CAAC,WAAW,IAAI,KAAK,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC;QACzG,KAAK,GAAG,KAAK,CAAC,MAAM,EAAe,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,gHAAgH;AAChH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAE,EAAE,CACpC,GAAG,YAAY,SAAS,IAAI,GAAG,YAAY,UAAU,IAAI,GAAG,YAAY,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanoma-ai/workflows",
-  "version": "0.11.13",
+  "version": "0.11.15",
   "description": "Business processes as TypeScript functions, run durably on DBOS",
   "keywords": [
     "approvals",

package/src/db/index.ts

@@ -1,10 +1,12 @@
 // `@sanoma-ai/workflows/db`, server-only: the runtime's tables and the database they are read
-// with, for the packages that share them (the connectors' stores, the app's tests). Never a
-// workflow's import: the shipped `oxlint.json` refuses it, as it does `/wakeup-service`.
+// with, for the packages that share them (the connectors' stores, the app's tests), and the
+// migrator a connector applies its own generated folder with, under the preparation's lock. Never
+// a workflow's import: the shipped `oxlint.json` refuses it, as it does `/wakeup-service`.
 
-export { type Db, databaseOn, pgCode } from "../db.ts";
+export { type Db, databaseOn, pgCode, underPreparationLock } from "../db.ts";
 export * from "./company.ts";
 export * from "./dbos.ts";
 export * from "./identity.ts";
 export * from "./kms.ts";
+export * from "./migrate.ts";
 export * from "./wakeup.ts";

package/src/db/migrate.ts

@@ -7,9 +7,10 @@ import wakeupJournal from "../../drizzle/wakeup/meta/_journal.json" with { type:
 
 // The generated migrations (`pnpm --filter @sanoma-ai/workflows generate`), one folder per
 // database the runtime makes tables in, each with its own journal table in the schema `drizzle`,
-// since the wakeup service's database may be a company's own. The Worker, which never migrates,
-// checks a database against the journal shipped with the package (`migrationsApplied`), with no
-// file read: the journal is imported.
+// since the wakeup service's database may be a company's own. A connector's tables have folders
+// of their own, shaped the same (`@sanoma-ai/connector-better-auth`). The Worker, which never
+// migrates, checks a database against the journal shipped with the package
+// (`migrationsApplied`), with no file read: the journal is imported.
 
 /** Drizzle's journal, `meta/_journal.json` of a migrations folder. */
 export interface MigrationsJournal {
@@ -18,26 +19,26 @@ export interface MigrationsJournal {
 
 /** A migrations folder with the journal table recording what of it a database has. */
 export interface Migrations {
-  /** The folder's name under the package's `drizzle/`. */
-  name: string;
+  /**
+   * The folder, beside the module declaring it (`new URL("../drizzle/<name>/", import.meta.url)`,
+   * from `src/` and from `dist/` alike), asked for only when migrating, never in the Worker.
+   */
+  folder(): URL;
   /** Its journal table in the schema `drizzle`. */
   table: string;
   journal: MigrationsJournal;
 }
 
-/** The folder of `of`, from `src/` and from `dist/` alike; read only when migrating, never in the Worker. */
-const folderOf = (of: Migrations): string => fileURLToPath(new URL(`../../drizzle/${of.name}/`, import.meta.url));
-
 /** The tables every company database gets (`db/company.ts`). */
 export const COMPANY_MIGRATIONS = {
-  name: "company",
+  folder: () => new URL("../../drizzle/company/", import.meta.url),
   table: "__drizzle_migrations",
   journal: companyJournal,
 } satisfies Migrations;
 
 /** The wakeup service's tables (`db/wakeup.ts`). */
 export const WAKEUP_MIGRATIONS = {
-  name: "wakeup",
+  folder: () => new URL("../../drizzle/wakeup/", import.meta.url),
   table: "__drizzle_migrations_wakeup",
   journal: wakeupJournal,
 } satisfies Migrations;
@@ -45,12 +46,12 @@ export const WAKEUP_MIGRATIONS = {
 /**
  * Applies to `db` the migrations of `of` its database has not had, in one transaction, recording
  * each in the journal table. Drizzle's migrator compares only the newest timestamp, so a migration
- * older than the newest applied is skipped: `scripts/check-journal.ts` keeps a branch from adding
- * one. Two processes migrating one database at once race (the migrator takes no lock): callers
+ * older than the newest applied is skipped: the repository's `scripts/check-journal.ts` keeps a
+ * branch from adding one. Two processes migrating one database at once race (the migrator takes no lock): callers
  * hold `underPreparationLock`.
  */
 export const applyMigrations = (db: Db, of: Migrations): Promise<void> =>
-  migrate(db, { migrationsFolder: folderOf(of), migrationsTable: of.table });
+  migrate(db, { migrationsFolder: fileURLToPath(of.folder()), migrationsTable: of.table });
 
 /**
  * Whether the database `db` is on has had every migration of `of`: each journal entry's `when`

package/src/fill.ts

@@ -10,9 +10,17 @@ setFaker(faker);
 /** Seeds the generator from a name, so one name always makes up the same values. */
 export const seedFrom = (name: string) => seed(createHash("sha256").update(name).digest().readUInt32BE(0));
 
-/** The schema's value with every field `given` does not set made up, parsed by the schema. */
+/**
+ * The schema's value with every required field `given` does not set made up, parsed by the schema.
+ * Optional fields are left out, as a caller may leave them: made up, they could break a rule
+ * between fields (one of two ids, not both).
+ */
 export function fill(schema: z.ZodType, given: Record<string, unknown>): unknown {
-  return schema.parse({ ...(fake(schema) as object), ...given });
+  const made = fake(schema) as Record<string, unknown>;
+  for (const [name, field] of Object.entries(shapeOf(schema))) {
+    if (field.safeParse(undefined).success) delete made[name];
+  }
+  return schema.parse({ ...made, ...given });
 }
 
 /** An object schema's fields by name; none for any other schema. */