@nxgt/janus 0.18.0 → 0.20.0

package/dist/conformance/index.js

@@ -1,7 +1,7 @@
 import {
   mintId2,
   createMemoryStores2
-} from "../chunks/index-kvjj5xkp.js";
+} from "../chunks/index-6bjfv4xv.js";
 import {
   JanusError2,
   StoreFailure2,
@@ -180,6 +180,10 @@ var seed = async ({ stores }) => {
 };
 var outageCases = [
   outage("users", "findUser", ({ stores }) => stores.users.findUser(user.id), seed),
+  {
+    ...outage("users", "findUsers", async ({ stores }) => stores.users.findUsers?.call(stores.users, [user.id]), seed),
+    needs: ["faults", "findUsers"]
+  },
   outage("users", "findUserByLogin", ({ stores }) => stores.users.findUserByLogin(user.type, user.logins[0] ?? ""), seed),
   outage("users", "listUsers", ({ stores }) => stores.users.listUsers({ type: user.type, after: null, limit: 10 }), seed),
   outage("sessions", "findSessionByTokenHash", ({ stores }) => stores.sessions.findSessionByTokenHash(session.tokenHash), seed),
@@ -755,12 +759,51 @@ var tokenStoreCases = [
   ...tokenKindCases,
   ...tokenDeletionCases
 ];
-// src/conformance/cases/users/deletion.ts
+// src/conformance/cases/users/batch.ts
 var group13 = "users";
+var byId = (a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+var userBatchCases = [
+  {
+    id: "users.findUsers",
+    group: group13,
+    name: "findUsers answers each stored user once, byte for byte and whatever its type, and leaves out an id nobody holds",
+    needs: "findUsers",
+    async run({ stores }) {
+      const findUsers = stores.users.findUsers;
+      ok(findUsers !== undefined, "findUsers should be present");
+      const patient = userRecord({ type: "patient" });
+      const staff = userRecord({ type: "staff" });
+      const other = userRecord();
+      for (const record of [patient, staff, other]) {
+        await stores.users.insertUser(record);
+      }
+      const answer = await findUsers?.call(stores.users, [
+        staff.id,
+        mintId2(),
+        patient.id
+      ]);
+      ok(Array.isArray(answer), "findUsers should answer a list — an absence is a shorter list, never null");
+      equal([...answer ?? []].sort(byId), [patient, staff].sort(byId), "findUsers should answer the two stored users exactly as written, and only them");
+    }
+  },
+  {
+    id: "users.findUsersNone",
+    group: group13,
+    name: "findUsers answers an empty list, not null, when no id is held",
+    needs: "findUsers",
+    async run({ stores }) {
+      await stores.users.insertUser(userRecord());
+      equal(await stores.users.findUsers?.call(stores.users, [mintId2(), mintId2()]), [], "findUsers for ids nobody holds should answer []");
+    }
+  }
+];
+
+// src/conformance/cases/users/deletion.ts
+var group14 = "users";
 var userDeletionCases = [
   {
     id: "users.delete",
-    group: group13,
+    group: group14,
     name: "deletes a user and frees their logins, answers false for nobody, and touches no other user",
     async run({ stores }) {
       const record = userRecord();
@@ -780,11 +823,11 @@ var userDeletionCases = [
 ];
 
 // src/conformance/cases/users/inserts.ts
-var group14 = "users";
+var group15 = "users";
 var userInsertCases = [
   {
     id: "users.idempotentInsert",
-    group: group14,
+    group: group15,
     name: "is idempotent under retry: inserting an existing id answers the stored record and writes nothing",
     async run({ stores }) {
       const record = userRecord();
@@ -799,7 +842,7 @@ var userInsertCases = [
   },
   {
     id: "users.uniqueness",
-    group: group14,
+    group: group15,
     name: "lets exactly one of twenty concurrent inserts hold a login: uniqueness is a constraint, not a read",
     async run({ stores }) {
       const records = Array.from({ length: 20 }, () => userRecord({ logins: ["contested@example.test"] }));
@@ -824,11 +867,11 @@ var userInsertCases = [
 ];
 
 // src/conformance/cases/users/listing.ts
-var group15 = "users";
+var group16 = "users";
 var userListingCases = [
   {
     id: "users.pagination",
-    group: group15,
+    group: group16,
     name: "pages 25 users of one type by 10 in ascending id order, with no gap, no repeat and no other type, and ends on a null cursor",
     async run({ stores }) {
       const records = Array.from({ length: 25 }, () => userRecord());
@@ -929,11 +972,11 @@ async function nullClearsCodes(stores, id) {
 }
 
 // src/conformance/cases/users/patches.ts
-var group16 = "users";
+var group17 = "users";
 var userPatchCases = [
   {
     id: "users.omission",
-    group: group16,
+    group: group17,
     name: "omission — the Kratos PUT trap: an update leaves every field it does not name exactly as it was",
     async run({ stores }) {
       const record = userRecord({
@@ -958,7 +1001,7 @@ var userPatchCases = [
   },
   {
     id: "users.passwordSlot",
-    group: group16,
+    group: group17,
     name: "keeps a password the patch does not name, and removes one the patch names null",
     async run({ stores }) {
       const record = userRecord();
@@ -972,7 +1015,7 @@ var userPatchCases = [
   secondFactorSlotCase,
   {
     id: "users.loginsMove",
-    group: group16,
+    group: group17,
     name: "moves logins on update: the old one is free, the new one found, one held elsewhere refused",
     async run({ stores }) {
       const record = userRecord();
@@ -993,11 +1036,11 @@ var userPatchCases = [
 ];
 
 // src/conformance/cases/users/reads.ts
-var group17 = "users";
+var group18 = "users";
 var userReadCases = [
   {
     id: "users.roundTrip",
-    group: group17,
+    group: group18,
     name: 'round-trips a record byte for byte: nested fields, a 1 that stays a number, a "1" that stays a string',
     async run({ stores }) {
       const record = userRecord({
@@ -1021,7 +1064,7 @@ var userReadCases = [
   },
   {
     id: "users.edgeCharacters",
-    group: group17,
+    group: group18,
     name: "round-trips every character the core lets through: control characters, U+FFFF and a surrogate pair",
     async run({ stores }) {
       const edge = "a\x01\x1F￿ \uD83D\uDE00 z";
@@ -1036,7 +1079,7 @@ var userReadCases = [
   },
   {
     id: "users.absence",
-    group: group17,
+    group: group18,
     name: "answers null for an absence, never undefined, and an empty page for an empty store",
     async run({ stores }) {
       isNull(await stores.users.findUser(mintId2()), "findUser for an unknown id");
@@ -1046,7 +1089,7 @@ var userReadCases = [
   },
   {
     id: "users.loginBytes",
-    group: group17,
+    group: group18,
     name: "compares logins as bytes, within one type: no case folding, no trimming, no collation",
     async run({ stores }) {
       const upper = userRecord({ logins: ["Ada@Example.test"] });
@@ -1063,11 +1106,11 @@ var userReadCases = [
 ];
 
 // src/conformance/cases/users/versions.ts
-var group18 = "users";
+var group19 = "users";
 var userVersionCases = [
   {
     id: "users.versionIncrements",
-    group: group18,
+    group: group19,
     name: "applies an update at the expected version, and answers the record written with its version one higher",
     async run({ stores }) {
       const record = userRecord();
@@ -1085,7 +1128,7 @@ var userVersionCases = [
   },
   {
     id: "users.versionConflict",
-    group: group18,
+    group: group19,
     name: "refuses a stale version with both versions, and leaves the record identical byte for byte",
     async run({ stores }) {
       const record = userRecord();
@@ -1106,7 +1149,7 @@ var userVersionCases = [
   },
   {
     id: "users.unknownUpdate",
-    group: group18,
+    group: group19,
     name: "refuses an update to an unknown id with NotFoundError, told apart from a version conflict",
     async run({ stores }) {
       const error = await rejects(stores.users.updateUser(mintId2(), { updatedAt: at("2026-02-01T00:00:00.000Z") }, 0), "updateUser on an unknown id should reject");
@@ -1118,6 +1161,7 @@ var userVersionCases = [
 // src/conformance/cases/users/index.ts
 var userStoreCases = [
   ...userReadCases,
+  ...userBatchCases,
   ...userInsertCases,
   ...userVersionCases,
   ...userPatchCases,
@@ -1133,17 +1177,15 @@ var allCases = [
 ];
 var SKIP_REASONS = {
   faults: "faults not provided: the outage invariant is not proven for this adapter",
-  deleteExpiredSessions: "stores.sessions does not implement the optional deleteExpiredSessions"
+  deleteExpiredSessions: "stores.sessions does not implement the optional deleteExpiredSessions",
+  findUsers: "stores.users does not implement the optional findUsers: findMany reads with findUser instead"
 };
 async function runCase(conformanceCase, harness) {
   const opened = await harness.open();
   try {
-    if (conformanceCase.needs === "faults" && opened.faults === undefined) {
-      return { skipped: SKIP_REASONS.faults };
-    }
-    if (conformanceCase.needs === "deleteExpiredSessions" && opened.stores.sessions.deleteExpiredSessions === undefined) {
-      return { skipped: SKIP_REASONS.deleteExpiredSessions };
-    }
+    const missing = needsOf(conformanceCase).find((need) => !provides(opened, need));
+    if (missing !== undefined)
+      return { skipped: SKIP_REASONS[missing] };
     await conformanceCase.run({
       stores: opened.stores,
       faults: opened.faults ?? null
@@ -1153,6 +1195,20 @@ async function runCase(conformanceCase, harness) {
     await opened.close?.();
   }
 }
+function needsOf(conformanceCase) {
+  const { needs } = conformanceCase;
+  return needs === undefined ? [] : typeof needs === "string" ? [needs] : needs;
+}
+function provides(opened, need) {
+  switch (need) {
+    case "faults":
+      return opened.faults !== undefined;
+    case "deleteExpiredSessions":
+      return opened.stores.sessions.deleteExpiredSessions !== undefined;
+    case "findUsers":
+      return opened.stores.users.findUsers !== undefined;
+  }
+}
 function describeJanusStores(options) {
   describeSuite({
     title: `${options.name} — @nxgt/janus conformance`,
@@ -1163,6 +1219,10 @@ function describeJanusStores(options) {
     faults: options.faults
   });
 }
+function needsList(described) {
+  const { needs } = described;
+  return needs === undefined ? [] : typeof needs === "string" ? [needs] : needs;
+}
 function describeSuite(options) {
   const { runner, skip, cases } = options;
   const groups = [...new Set(cases.map((c) => c.group))];
@@ -1176,7 +1236,7 @@ function describeSuite(options) {
             runner.it.skip(`${conformanceCase.name} — skipped: ${reason}`, async () => {});
             continue;
           }
-          if (conformanceCase.needs === "faults" && options.faults === false) {
+          if (needsList(conformanceCase).includes("faults") && options.faults === false) {
             runner.it.skip(`${conformanceCase.name} — skipped: ${SKIP_REASONS.faults}`, async () => {});
             continue;
           }
@@ -1249,11 +1309,11 @@ var tuple = (object, relation, subject) => ({ object, relation, subject });
 var sorted = (subjects) => subjects.map(formatSubject2).sort();
 
 // src/conformance/relations/cases/deletion.ts
-var group19 = "relations";
+var group20 = "relations";
 var relationDeletionCases = [
   {
     id: "relations.deleteEntity",
-    group: group19,
+    group: group20,
     name: "deletes every tuple naming an entity — as object, as subject, as a set’s entity — and counts them",
     async run({ store }) {
       const team = entity("team");
@@ -1280,11 +1340,11 @@ var relationDeletionCases = [
 ];
 
 // src/conformance/relations/cases/reads.ts
-var group20 = "relations";
+var group21 = "relations";
 var relationReadCases = [
   {
     id: "relations.roundTrip",
-    group: group20,
+    group: group21,
     name: "holds exactly the tuples written, byte for byte: staff:u1 is not patient:u1, and a set is not its entity",
     async run({ store }) {
       const record = entity("record", "Ｒ:1 — ÿ");
@@ -1300,7 +1360,7 @@ var relationReadCases = [
   },
   {
     id: "relations.edgeCharacters",
-    group: group20,
+    group: group21,
     name: "round-trips every character the core lets through in an id: control characters, U+FFFF and a surrogate pair",
     async run({ store }) {
       const edge = "a\x01\x1F￿ \uD83D\uDE00 z";
@@ -1323,7 +1383,7 @@ var relationReadCases = [
   },
   {
     id: "relations.undefinedRelation",
-    group: group20,
+    group: group21,
     name: "reads a subject whose relation is undefined as its entity, not as a set",
     async run({ store }) {
       const record = entity("record");
@@ -1353,7 +1413,7 @@ var relationReadCases = [
   },
   {
     id: "relations.absence",
-    group: group20,
+    group: group21,
     name: "answers false, [], an empty page and 0 for an empty store — never null or undefined",
     async run({ store }) {
       const record = entity("record");
@@ -1374,11 +1434,11 @@ var relationReadCases = [
 ];
 
 // src/conformance/relations/cases/traversal.ts
-var group21 = "relations";
+var group22 = "relations";
 var relationTraversalCases = [
   {
     id: "relations.oneHop",
-    group: group21,
+    group: group22,
     name: "answers one hop: the subject sets and the entities holding one relation on one object, and nothing else",
     async run({ store }) {
       const record = entity("record");
@@ -1402,7 +1462,7 @@ var relationTraversalCases = [
   },
   {
     id: "relations.objects",
-    group: group21,
+    group: group22,
     name: "pages 25 objects by 10 in ascending id order, for one type, relation and exact subject, and ends on a null cursor",
     async run({ store }) {
       const staff = entity("staff");
@@ -1449,11 +1509,11 @@ var relationTraversalCases = [
 ];
 
 // src/conformance/relations/cases/writes.ts
-var group22 = "relations";
+var group23 = "relations";
 var relationWriteCases = [
   {
     id: "relations.idempotentWrite",
-    group: group22,
+    group: group23,
     name: "is idempotent under retry: adding a stored tuple and removing an absent one write nothing",
     async run({ store }) {
       const record = entity("record");
@@ -1466,7 +1526,7 @@ var relationWriteCases = [
   },
   {
     id: "relations.uniqueness",
-    group: group22,
+    group: group23,
     name: "keeps one tuple when twenty concurrent writes add it: uniqueness is a constraint, not a read",
     async run({ store }) {
       const record = entity("record");
@@ -1477,7 +1537,7 @@ var relationWriteCases = [
   },
   {
     id: "relations.removeThenAdd",
-    group: group22,
+    group: group23,
     name: "applies one write’s removals and additions together",
     async run({ store }) {
       const record = entity("record");
@@ -1612,5 +1672,5 @@ export {
   userStoreCases
 };
 
-//# debugId=292F9396C913757C64756E2164756E21
+//# debugId=E36CAD1FA03131AF64756E2164756E21
 //# sourceMappingURL=index.js.map