@reventlessdev/reventless-seed 1.0.0-alpha.20 → 1.0.0-alpha.21

package/lib/bs/tests/Seed_ConnectTest.res

@@ -0,0 +1,64 @@
+open JestGlobals
+
+// `SEED_ROLE` is how a run says what to act as when nobody can answer a prompt —
+// a CI run wedged by a stored narrowing, or a deliberate restricted run.
+//
+// It carries two different intentions in one variable, which is why the parsing
+// is worth pinning: naming a role narrows to it, and the "give me everything"
+// answer has several spellings because an operator setting it by hand will write
+// whichever one comes to mind. Getting that wrong is not a typo — `SEED_ROLE=full`
+// read as a role named "full" would ask the platform to act as a group nobody
+// holds, and be refused.
+
+let withEnv = (value: option<string>, f: unit => unit) => {
+  let key = "SEED_ROLE"
+  let previous = NodeProcess.env->Dict.get(key)
+  switch value {
+  | Some(v) => NodeProcess.env->Dict.set(key, v)
+  | None => NodeProcess.env->Dict.delete(key)
+  }
+  f()
+  switch previous {
+  | Some(v) => NodeProcess.env->Dict.set(key, v)
+  | None => NodeProcess.env->Dict.delete(key)
+  }
+}
+
+describe("Seed_Connect.roleFromEnv:", () => {
+  testSync("is absent when nothing asked for a role", () =>
+    withEnv(None, () => expect(Seed_Connect.roleFromEnv())->Expect.toEqual(None))
+  )
+
+  testSync("reads a named role as a narrowing to it", () =>
+    withEnv(
+      Some("Shopper"),
+      () =>
+        expect(Seed_Connect.roleFromEnv())->Expect.toEqual(Some(Seed_Connect.Narrowed("Shopper"))),
+    )
+  )
+
+  // Every spelling of "everything" an operator might reach for. They all mean
+  // clear the stored choice, which is what seeding wants.
+  testSync("takes each spelling of full membership as a clear", () =>
+    ["full", "all", "none", "clear", "FULL", "All"]->Array.forEach(
+      v =>
+        withEnv(
+          Some(v),
+          () => expect(Seed_Connect.roleFromEnv())->Expect.toEqual(Some(Seed_Connect.Full)),
+        ),
+    )
+  )
+
+  // Role names are case-sensitive to the platform (`mayActAs` compares exactly),
+  // so a named role is passed through untouched — only the clear vocabulary is
+  // case-folded.
+  testSync("passes a role name through with its case intact", () =>
+    withEnv(
+      Some("Merchandiser"),
+      () =>
+        expect(Seed_Connect.roleFromEnv())->Expect.toEqual(
+          Some(Seed_Connect.Narrowed("Merchandiser")),
+        ),
+    )
+  )
+})

package/lib/bs/tests/Seed_ConnectTest.res.mjs

@@ -0,0 +1,56 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Stdlib_Dict from "@rescript/runtime/lib/es6/Stdlib_Dict.js";
+import * as Seed_Connect$ReventlessSeed from "../src/Seed_Connect.res.mjs";
+
+function withEnv(value, f) {
+  let key = "SEED_ROLE";
+  let previous = process.env[key];
+  if (value !== undefined) {
+    process.env[key] = value;
+  } else {
+    Stdlib_Dict.$$delete(process.env, key);
+  }
+  f();
+  if (previous !== undefined) {
+    process.env[key] = previous;
+    return;
+  } else {
+    return Stdlib_Dict.$$delete(process.env, key);
+  }
+}
+
+globalThis.describe("Seed_Connect.roleFromEnv:", () => {
+  globalThis.test("is absent when nothing asked for a role", () => withEnv(undefined, () => {
+    globalThis.expect(Seed_Connect$ReventlessSeed.roleFromEnv()).toEqual(undefined);
+  }));
+  globalThis.test("reads a named role as a narrowing to it", () => withEnv("Shopper", () => {
+    globalThis.expect(Seed_Connect$ReventlessSeed.roleFromEnv()).toEqual({
+      TAG: "Narrowed",
+      _0: "Shopper"
+    });
+  }));
+  globalThis.test("takes each spelling of full membership as a clear", () => {
+    [
+      "full",
+      "all",
+      "none",
+      "clear",
+      "FULL",
+      "All"
+    ].forEach(v => withEnv(v, () => {
+      globalThis.expect(Seed_Connect$ReventlessSeed.roleFromEnv()).toEqual("Full");
+    }));
+  });
+  globalThis.test("passes a role name through with its case intact", () => withEnv("Merchandiser", () => {
+    globalThis.expect(Seed_Connect$ReventlessSeed.roleFromEnv()).toEqual({
+      TAG: "Narrowed",
+      _0: "Merchandiser"
+    });
+  }));
+});
+
+export {
+  withEnv,
+}
+/*  Not a pure module */

package/lib/bs/tests/Seed_PromptTest.res

@@ -15,22 +15,18 @@ open JestGlobals
 
 describe("Seed_Prompt.isAffirmative:", () => {
   testSync("takes the three spellings of yes", () => {
-    ["y", "yes", "1"]->Array.forEach(v =>
-      expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(true)
-    )
+    ["y", "yes", "1"]->Array.forEach(v => expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(true))
   })
 
   // A prompt that prints `[y/N]` invites a capital as readily as a lowercase
   // one, and an env var set by hand is written however the hand felt.
   testSync("ignores case, so Y and YES answer as y does", () => {
-    ["Y", "Yes", "YES"]->Array.forEach(v =>
-      expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(true)
-    )
+    ["Y", "Yes", "YES"]->Array.forEach(v => expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(true))
   })
 
   testSync("ignores surrounding space", () => {
-    [" y", "y ", "  yes  "]->Array.forEach(v =>
-      expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(true)
+    [" y", "y ", "  yes  "]->Array.forEach(
+      v => expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(true),
     )
   })
 
@@ -38,14 +34,14 @@ describe("Seed_Prompt.isAffirmative:", () => {
   // reads it as "no". None may be mistaken for "nothing was said", which is what
   // sent the old code to a prompt it could not open.
   testSync("declines every spelling of no, capital N included", () => {
-    ["n", "N", "no", "No", "NO"]->Array.forEach(v =>
-      expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(false)
+    ["n", "N", "no", "No", "NO"]->Array.forEach(
+      v => expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(false),
     )
   })
 
   testSync("declines anything it does not recognise", () => {
-    ["", "  ", "0", "true", "yep", "y.", "yesplease", "affirmative"]->Array.forEach(v =>
-      expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(false)
+    ["", "  ", "0", "true", "yep", "y.", "yesplease", "affirmative"]->Array.forEach(
+      v => expect(Seed_Prompt.isAffirmative(v))->Expect.toBe(false),
     )
   })
 

package/lib/bs/tests/Seed_RandomTest.res

@@ -16,36 +16,45 @@ describe("Seed_Random:", () => {
   }
 
   describe("reproducibility — the reason this module exists:", () => {
-    testSync("the same seed replays the same sequence", () =>
-      expect(take(~seed=42, ~n=25))->toEqual(take(~seed=42, ~n=25))
+    testSync(
+      "the same seed replays the same sequence",
+      () => expect(take(~seed=42, ~n=25))->toEqual(take(~seed=42, ~n=25)),
     )
 
     // Without this, a generator that returned a constant would satisfy the
     // case above and nothing else in the suite would catch it.
-    testSync("different seeds diverge", () =>
-      expect(take(~seed=42, ~n=25) == take(~seed=43, ~n=25))->toBe(false)
+    testSync(
+      "different seeds diverge",
+      () => expect(take(~seed=42, ~n=25) == take(~seed=43, ~n=25))->toBe(false),
     )
 
-    testSync("a fresh generator does not continue the previous one", () => {
-      let r = Seed_Random.make(~seed=7)
-      let first = Seed_Random.float(r)
-      let _ = Seed_Random.float(r)
-      expect(Seed_Random.float(Seed_Random.make(~seed=7)))->toEqual(first)
-    })
+    testSync(
+      "a fresh generator does not continue the previous one",
+      () => {
+        let r = Seed_Random.make(~seed=7)
+        let first = Seed_Random.float(r)
+        let _ = Seed_Random.float(r)
+        expect(Seed_Random.float(Seed_Random.make(~seed=7)))->toEqual(first)
+      },
+    )
   })
 
   describe("float stays a unit interval:", () => {
     // mulberry32's last step is a signed 32-bit value folded back to unsigned.
     // Get that fold wrong and roughly half the draws come out negative, which
     // every consumer below (int, pick, sampleWeighted) silently mis-scales.
-    testSync("every draw is in [0, 1)", () =>
-      expect(take(~seed=99, ~n=500)->Array.every(f => f >= 0.0 && f < 1.0))->toBe(true)
+    testSync(
+      "every draw is in [0, 1)",
+      () => expect(take(~seed=99, ~n=500)->Array.every(f => f >= 0.0 && f < 1.0))->toBe(true),
     )
 
-    testSync("and the draws are not all the same value", () => {
-      let draws = take(~seed=99, ~n=100)
-      expect(draws->Array.some(f => f != draws->Array.getUnsafe(0)))->toBe(true)
-    })
+    testSync(
+      "and the draws are not all the same value",
+      () => {
+        let draws = take(~seed=99, ~n=100)
+        expect(draws->Array.some(f => f != draws->Array.getUnsafe(0)))->toBe(true)
+      },
+    )
   })
 
   describe("int is inclusive on both ends, as documented:", () => {
@@ -54,40 +63,50 @@ describe("Seed_Random:", () => {
       Array.make(~length=n, 0)->Array.map(_ => Seed_Random.int(r, ~min, ~max))
     }
 
-    testSync("never escapes the range", () =>
-      expect(draws(~min=3, ~max=7, ~n=500)->Array.every(i => i >= 3 && i <= 7))->toBe(true)
+    testSync(
+      "never escapes the range",
+      () => expect(draws(~min=3, ~max=7, ~n=500)->Array.every(i => i >= 3 && i <= 7))->toBe(true),
     )
 
     // The documented contract is "inclusive on both ends"; an off-by-one in the
     // `max - min + 1` scaling shows up as a bound that is never drawn.
-    testSync("reaches both bounds", () => {
-      let d = draws(~min=3, ~max=7, ~n=500)
-      expect((d->Array.includes(3), d->Array.includes(7)))->toEqual((true, true))
-    })
+    testSync(
+      "reaches both bounds",
+      () => {
+        let d = draws(~min=3, ~max=7, ~n=500)
+        expect((d->Array.includes(3), d->Array.includes(7)))->toEqual((true, true))
+      },
+    )
 
-    testSync("a single-value range is that value", () =>
-      expect(draws(~min=4, ~max=4, ~n=10)->Array.every(i => i == 4))->toBe(true)
+    testSync(
+      "a single-value range is that value",
+      () => expect(draws(~min=4, ~max=4, ~n=10)->Array.every(i => i == 4))->toBe(true),
     )
   })
 
   describe("pick:", () => {
-    testSync("returns None for an empty array", () =>
-      expect(Seed_Random.make(~seed=1)->Seed_Random.pick([]))->toEqual(None)
+    testSync(
+      "returns None for an empty array",
+      () => expect(Seed_Random.make(~seed=1)->Seed_Random.pick([]))->toEqual(None),
     )
 
-    testSync("always lands on a member", () => {
-      let r = Seed_Random.make(~seed=2)
-      let xs = ["a", "b", "c", "d"]
-      let hits = Array.make(~length=200, "")->Array.map(_ =>
-        r->Seed_Random.pickOr(~fallback="MISS", xs)
-      )
-      expect(hits->Array.every(h => xs->Array.includes(h)))->toBe(true)
-    })
+    testSync(
+      "always lands on a member",
+      () => {
+        let r = Seed_Random.make(~seed=2)
+        let xs = ["a", "b", "c", "d"]
+        let hits =
+          Array.make(~length=200, "")->Array.map(_ => r->Seed_Random.pickOr(~fallback="MISS", xs))
+        expect(hits->Array.every(h => xs->Array.includes(h)))->toBe(true)
+      },
+    )
 
-    testSync("pickOr falls back only when there is nothing to pick", () =>
-      expect(Seed_Random.make(~seed=3)->Seed_Random.pickOr(~fallback="fallback", []))->toBe(
-        "fallback",
-      )
+    testSync(
+      "pickOr falls back only when there is nothing to pick",
+      () =>
+        expect(Seed_Random.make(~seed=3)->Seed_Random.pickOr(~fallback="fallback", []))->toBe(
+          "fallback",
+        ),
     )
   })
 
@@ -96,65 +115,86 @@ describe("Seed_Random:", () => {
 
     // The documented shuffle use: equal weights, count = length. If sampling
     // ever replaced instead of removing, duplicates would appear here.
-    testSync("count = length yields a permutation, not a multiset", () => {
-      let xs = ["a", "b", "c", "d", "e"]
-      let out = Seed_Random.make(~seed=11)->Seed_Random.sampleWeighted(equal(xs), ~count=5)
-      let sorted = out->Array.toSorted(String.compare)
-      expect((out->Array.length, sorted))->toEqual((5, ["a", "b", "c", "d", "e"]))
-    })
-
-    testSync("count < length returns exactly count distinct items", () => {
-      let xs = ["a", "b", "c", "d", "e"]
-      let out = Seed_Random.make(~seed=12)->Seed_Random.sampleWeighted(equal(xs), ~count=3)
-      let distinct = Set.fromArray(out)->Set.size
-      expect((out->Array.length, distinct))->toEqual((3, 3))
-    })
-
-    testSync("count > length clamps to the pool", () =>
-      expect(
-        Seed_Random.make(~seed=13)
-        ->Seed_Random.sampleWeighted(equal(["a", "b"]), ~count=99)
-        ->Array.length,
-      )->toBe(2)
-    )
-
-    testSync("a zero-weight entry is never chosen while others remain", () => {
-      let out =
-        Seed_Random.make(~seed=14)->Seed_Random.sampleWeighted(
-          [("never", 0.0), ("a", 1.0), ("b", 1.0)],
-          ~count=2,
-        )
-      expect(out->Array.includes("never"))->toBe(false)
-    })
-
-    testSync("is reproducible for a given seed", () => {
-      let run = () =>
-        Seed_Random.make(~seed=15)->Seed_Random.sampleWeighted(
-          equal(["a", "b", "c", "d", "e", "f"]),
-          ~count=4,
-        )
-      expect(run())->toEqual(run())
-    })
+    testSync(
+      "count = length yields a permutation, not a multiset",
+      () => {
+        let xs = ["a", "b", "c", "d", "e"]
+        let out = Seed_Random.make(~seed=11)->Seed_Random.sampleWeighted(equal(xs), ~count=5)
+        let sorted = out->Array.toSorted(String.compare)
+        expect((out->Array.length, sorted))->toEqual((5, ["a", "b", "c", "d", "e"]))
+      },
+    )
+
+    testSync(
+      "count < length returns exactly count distinct items",
+      () => {
+        let xs = ["a", "b", "c", "d", "e"]
+        let out = Seed_Random.make(~seed=12)->Seed_Random.sampleWeighted(equal(xs), ~count=3)
+        let distinct = Set.fromArray(out)->Set.size
+        expect((out->Array.length, distinct))->toEqual((3, 3))
+      },
+    )
+
+    testSync(
+      "count > length clamps to the pool",
+      () =>
+        expect(
+          Seed_Random.make(~seed=13)
+          ->Seed_Random.sampleWeighted(equal(["a", "b"]), ~count=99)
+          ->Array.length,
+        )->toBe(2),
+    )
+
+    testSync(
+      "a zero-weight entry is never chosen while others remain",
+      () => {
+        let out =
+          Seed_Random.make(~seed=14)->Seed_Random.sampleWeighted(
+            [("never", 0.0), ("a", 1.0), ("b", 1.0)],
+            ~count=2,
+          )
+        expect(out->Array.includes("never"))->toBe(false)
+      },
+    )
+
+    testSync(
+      "is reproducible for a given seed",
+      () => {
+        let run = () =>
+          Seed_Random.make(~seed=15)->Seed_Random.sampleWeighted(
+            equal(["a", "b", "c", "d", "e", "f"]),
+            ~count=4,
+          )
+        expect(run())->toEqual(run())
+      },
+    )
   })
 
   describe("zipfWeights skews toward the head:", () => {
     let weights = Seed_Random.zipfWeights(["a", "b", "c", "d", "e"], ~exponent=1.1)
 
-    testSync("keeps every item, in order", () =>
-      expect(weights->Array.map(((item, _)) => item))->toEqual(["a", "b", "c", "d", "e"])
+    testSync(
+      "keeps every item, in order",
+      () => expect(weights->Array.map(((item, _)) => item))->toEqual(["a", "b", "c", "d", "e"]),
     )
 
-    testSync("weight decreases monotonically with rank", () => {
-      let ws = weights->Array.map(((_, w)) => w)
-      let decreasing =
-        ws->Array.everyWithIndex((w, i) => i == 0 || w < ws->Array.getUnsafe(i - 1))
-      expect(decreasing)->toBe(true)
-    })
+    testSync(
+      "weight decreases monotonically with rank",
+      () => {
+        let ws = weights->Array.map(((_, w)) => w)
+        let decreasing =
+          ws->Array.everyWithIndex((w, i) => i == 0 || w < ws->Array.getUnsafe(i - 1))
+        expect(decreasing)->toBe(true)
+      },
+    )
 
-    testSync("the leader is clear — first outweighs last several times over", () => {
-      let first = weights->Array.get(0)->Option.mapOr(0.0, ((_, w)) => w)
-      let last = weights->Array.get(4)->Option.mapOr(0.0, ((_, w)) => w)
-      expect(first > last *. 3.0)->toBe(true)
-    })
+    testSync(
+      "the leader is clear — first outweighs last several times over",
+      () => {
+        let first = weights->Array.get(0)->Option.mapOr(0.0, ((_, w)) => w)
+        let last = weights->Array.get(4)->Option.mapOr(0.0, ((_, w)) => w)
+        expect(first > last *. 3.0)->toBe(true)
+      },
+    )
   })
 })

package/lib/bs/tests/Seed_UsersTest.res

@@ -50,6 +50,22 @@ describe("Seed_Users.parseString:", () => {
     ])
   })
 
+  // The half that was dropped, and the reason owner-scoped demo rows were keyed
+  // to ids nobody on a Cognito deployment holds: the file records the id the
+  // platform stamps, and reading it only for a password threw that away.
+  //
+  // Absent stays absent rather than defaulting to the username — a local file
+  // may omit it and let the auth adapter default it, and an AWS file records a
+  // sub no default could invent. Guessing here would look like an answer.
+  testSync("keeps the userId an entry declares, and reads a missing one as absent", () => {
+    let users = Seed_Users.parseString(document)
+    expect(users->Array.map(u => u.Seed_Users.userId))->Expect.toEqual([
+      Some("local-admin"),
+      None,
+      None,
+    ])
+  })
+
   // An entry half-written by hand is the likely flaw in this file. Dropping it
   // keeps the other accounts selectable; failing the parse would not.
   testSync("skips an entry that names no password", () => {
@@ -82,11 +98,32 @@ describe("Seed_Users.load:", () => {
 describe("Seed_Users.label:", () => {
   testSync("names the groups an account carries", () => {
     expect(
-      Seed_Users.label({username: "admin", password: "x", groups: ["Admin", "Shopper"]}),
+      Seed_Users.label({
+        username: "admin",
+        password: "x",
+        groups: ["Admin", "Shopper"],
+        userId: None,
+      }),
     )->Expect.toBe("admin  [Admin, Shopper]")
   })
 
   testSync("is the bare username when the file records no groups", () => {
-    expect(Seed_Users.label({username: "admin", password: "x", groups: []}))->Expect.toBe("admin")
+    expect(
+      Seed_Users.label({username: "admin", password: "x", groups: [], userId: None}),
+    )->Expect.toBe("admin")
+  })
+
+  // The menu is unchanged by the id: an operator picks an account by name and
+  // membership, and a Cognito sub in the list would be noise at the one moment
+  // they are choosing a login.
+  testSync("says nothing about the userId", () => {
+    expect(
+      Seed_Users.label({
+        username: "admin",
+        password: "x",
+        groups: ["Admin"],
+        userId: Some("4275e4a4-00c1-70e1-1cb5-363b06b992b5"),
+      }),
+    )->Expect.toBe("admin  [Admin]")
   })
 })

package/lib/bs/tests/Seed_UsersTest.res.mjs

@@ -46,6 +46,14 @@ globalThis.describe("Seed_Users.parseString:", () => {
       []
     ]);
   });
+  globalThis.test("keeps the userId an entry declares, and reads a missing one as absent", () => {
+    let users = Seed_Users$ReventlessSeed.parseString(document);
+    globalThis.expect(users.map(u => u.userId)).toEqual([
+      "local-admin",
+      undefined,
+      undefined
+    ]);
+  });
   globalThis.test("skips an entry that names no password", () => {
     let users = Seed_Users$ReventlessSeed.parseString(`
 - username: admin
@@ -77,16 +85,26 @@ globalThis.describe("Seed_Users.label:", () => {
       groups: [
         "Admin",
         "Shopper"
-      ]
+      ],
+      userId: undefined
     })).toBe("admin  [Admin, Shopper]");
   });
   globalThis.test("is the bare username when the file records no groups", () => {
     globalThis.expect(Seed_Users$ReventlessSeed.label({
       username: "admin",
       password: "x",
-      groups: []
+      groups: [],
+      userId: undefined
     })).toBe("admin");
   });
+  globalThis.test("says nothing about the userId", () => {
+    globalThis.expect(Seed_Users$ReventlessSeed.label({
+      username: "admin",
+      password: "x",
+      groups: ["Admin"],
+      userId: "4275e4a4-00c1-70e1-1cb5-363b06b992b5"
+    })).toBe("admin  [Admin]");
+  });
 });
 
 export {

package/lib/ocaml/.compiler.log

@@ -1,2 +1,2 @@
-#Start(1788869322834)
-#Done(1788869322875)
+#Start(1788992686773)
+#Done(1788992686834)

package/lib/ocaml/ReventlessSeed.mlmap

@@ -3,6 +3,7 @@ Seed
 Seed_Client
 Seed_ClientTest
 Seed_Connect
+Seed_ConnectTest
 Seed_Prompt
 Seed_PromptTest
 Seed_Random

package/lib/ocaml/Seed.res

@@ -16,12 +16,18 @@ module Connect = Seed_Connect
 exception Failed = Seed_Types.Failed
 
 // A live target a data set seeds against: an authenticated client, whether uploads
-// are skipped this run, and a label. Uploads mint through the domain API's
-// `Upload_Presign` mutation on the client (route B), so no upload endpoint is carried.
+// are skipped this run, a label, and who the run is acting as. Uploads mint through
+// the domain API's `Upload_Presign` mutation on the client (route B), so no upload
+// endpoint is carried.
 type connection = Seed_Connect.connection = {
   client: Seed_Client.t,
   uploadsSkipped: bool,
   label: string,
+  accounts: array<Seed_Users.user>,
+  caller: Seed_Users.user,
+  callerId: option<string>,
+  login: (~username: string, ~password: string) => promise<string>,
+  roleSwitch: option<Seed_Connect.roleSwitch>,
 }
 
 // A named, seedable data set. `seed` owns everything domain-specific.