@emulates/cognito 2.3.1 → 3.0.0

package/CHANGELOG.md

@@ -1,9 +1,19 @@
 # Changelog — @emulates/cognito
 
-## 2.3.1 (2026-10-06)
+## 3.0.0 (2026-10-07)
 
-Initial release.
+### ⚠️ Breaking changes
+
+- point the repo at crvouga/emulates ([cdb5e53](https://github.com/crvouga/emulates/commit/cdb5e536ed8c1f52345e3984f089001c25fdb08a))
+
+### Fixes and improvements
+
+- format the emulates records query ([8698872](https://github.com/crvouga/emulates/commit/8698872509d06002be5a8fcdc85d79f8462320c3))
 
 ### Dependencies
 
 - `@emulates/sqlite`
+
+## 2.3.1 (2026-10-06)
+
+Initial release.

package/DISCOVERY.md

@@ -47,7 +47,7 @@ designed for assertions and diagnosis by consuming test suites.
 
 ## Report a mismatch or missing capability
 
-Follow the [agent reporting contract](https://github.com/crvouga/emulators/blob/main/docs/REPORTING_ISSUES.md). Include package version,
+Follow the [agent reporting contract](https://github.com/crvouga/emulates/blob/main/docs/REPORTING_ISSUES.md). Include package version,
 operation/command, a minimal redacted request, actual emulator result, expected oracle result or vendor
 documentation, and whether the mismatch appears in the matrix. Never include keys, tokens,
 customer data, prompts, PHI, card data, or unredacted recordings.

package/README.md

@@ -1,6 +1,6 @@
 # @emulates/cognito
 
-> Part of [Emulates](https://github.com/crvouga/emulators): high-fidelity, in-process emulators for APIs and databases.
+> Part of [Emulates](https://github.com/crvouga/emulates): high-fidelity, in-process emulators for APIs and databases.
 
 Stateful local emulator of Amazon Cognito User Pools for the AWS SDK and `amazon-cognito-identity-js`. It implements the authentication, user administration, group, federation, recovery, JWT, discovery, and JWKS surface the consumer app uses without contacting AWS.
 
@@ -20,7 +20,7 @@ Point `COGNITO_ENDPOINT` or the AWS SDK `endpoint` option at the served emulator
 import { createRuntime } from "@emulates/cognito"
 
 const cognito = createRuntime({
-  poolId: "us-east-1_emulators",
+  poolId: "us-east-1_emulates",
   clientId: "emulates-client",
   users: [
     {
@@ -33,7 +33,7 @@ const cognito = createRuntime({
 })
 ```
 
-The Node adapter is `createServer()` from `./server`; the CLI is `npx emulates-cognito serve --port 8811 --pool-id us-east-1_emulators --client-id emulates-client`.
+The Node adapter is `createServer()` from `./server`; the CLI is `npx emulates-cognito serve --port 8811 --pool-id us-east-1_emulates --client-id emulates-client`.
 
 ### AWS JSON operations
 

package/dist/{chunk-ZLLODF3V.js → chunk-BU4ORISY.js}

@@ -33,7 +33,7 @@ var CORE_MIGRATIONS = [
   {
     id: "20260322_core_records_sequences",
     sql: `
-      CREATE TABLE IF NOT EXISTS emulators_records (
+      CREATE TABLE IF NOT EXISTS emulates_records (
         namespace TEXT NOT NULL,
         collection TEXT NOT NULL,
         id TEXT NOT NULL,
@@ -41,9 +41,9 @@ var CORE_MIGRATIONS = [
         value TEXT NOT NULL,
         PRIMARY KEY (namespace, collection, id)
       );
-      CREATE INDEX IF NOT EXISTS emulators_records_seq
-        ON emulators_records (namespace, collection, seq);
-      CREATE TABLE IF NOT EXISTS emulators_sequences (
+      CREATE INDEX IF NOT EXISTS emulates_records_seq
+        ON emulates_records (namespace, collection, seq);
+      CREATE TABLE IF NOT EXISTS emulates_sequences (
         namespace TEXT NOT NULL,
         name TEXT NOT NULL,
         kind TEXT NOT NULL,
@@ -53,13 +53,33 @@ var CORE_MIGRATIONS = [
     `
   }
 ];
+var LEGACY_TABLES = [
+  ["emulators_records", "emulates_records"],
+  ["emulators_sequences", "emulates_sequences"]
+];
+var LEGACY_INDEXES = [["emulators_records_seq", "emulates_records_seq"]];
+var namesOf = (sqlite, type) => new Set(sqlite.prepare("SELECT name FROM sqlite_master WHERE type = ?").all(type).map((row) => row.name));
 var migrateCore = (sqlite) => {
   migrate(sqlite, CORE_MIGRATIONS);
+  const tables = namesOf(sqlite, "table");
+  const indexes = namesOf(sqlite, "index");
+  sqlite.transaction(() => {
+    for (const [from, to] of LEGACY_TABLES) {
+      if (tables.has(from) && !tables.has(to))
+        sqlite.exec(`ALTER TABLE ${from} RENAME TO ${to}`);
+    }
+    for (const [from, to] of LEGACY_INDEXES) {
+      if (!indexes.has(from) || indexes.has(to))
+        continue;
+      sqlite.exec(`DROP INDEX ${from}`);
+      sqlite.exec(`CREATE INDEX ${to} ON emulates_records (namespace, collection, seq)`);
+    }
+  });
 };
 var clearNamespace = (sqlite, namespace) => {
   sqlite.transaction(() => {
-    sqlite.prepare("DELETE FROM emulators_records WHERE namespace = ?").run(namespace);
-    sqlite.prepare("DELETE FROM emulators_sequences WHERE namespace = ?").run(namespace);
+    sqlite.prepare("DELETE FROM emulates_records WHERE namespace = ?").run(namespace);
+    sqlite.prepare("DELETE FROM emulates_sequences WHERE namespace = ?").run(namespace);
   });
 };
 
@@ -74,9 +94,9 @@ var Collection = class {
     this.collectionName = collectionName;
   }
   bumpCollectionSeq() {
-    const row = this.sqlite.prepare("SELECT value FROM emulators_sequences WHERE namespace = ? AND name = ? AND kind = 'collection'").get(this.namespace, this.collectionName);
+    const row = this.sqlite.prepare("SELECT value FROM emulates_sequences WHERE namespace = ? AND name = ? AND kind = 'collection'").get(this.namespace, this.collectionName);
     const next = (row?.value ?? 0) + 1;
-    this.sqlite.prepare(`INSERT INTO emulators_sequences (namespace, name, kind, value) VALUES (?, ?, 'collection', ?)
+    this.sqlite.prepare(`INSERT INTO emulates_sequences (namespace, name, kind, value) VALUES (?, ?, 'collection', ?)
          ON CONFLICT(namespace, name, kind) DO UPDATE SET value = excluded.value`).run(this.namespace, this.collectionName, next);
     return next;
   }
@@ -84,13 +104,13 @@ var Collection = class {
     return this.sqlite.transaction(() => this.bumpCollectionSeq());
   }
   get(id) {
-    const row = this.sqlite.prepare("SELECT value FROM emulators_records WHERE namespace = ? AND collection = ? AND id = ?").get(this.namespace, this.collectionName, id);
+    const row = this.sqlite.prepare("SELECT value FROM emulates_records WHERE namespace = ? AND collection = ? AND id = ?").get(this.namespace, this.collectionName, id);
     if (!row)
       return void 0;
     return JSON.parse(row.value).value;
   }
   has(id) {
-    const row = this.sqlite.prepare("SELECT 1 AS ok FROM emulators_records WHERE namespace = ? AND collection = ? AND id = ?").get(this.namespace, this.collectionName, id);
+    const row = this.sqlite.prepare("SELECT 1 AS ok FROM emulates_records WHERE namespace = ? AND collection = ? AND id = ?").get(this.namespace, this.collectionName, id);
     return row !== void 0;
   }
   /** Insert a new record, assigning it the next sequence number. */
@@ -98,7 +118,7 @@ var Collection = class {
     return this.sqlite.transaction(() => {
       const seq = this.bumpCollectionSeq();
       const stored = { seq, value };
-      this.sqlite.prepare(`INSERT INTO emulators_records (namespace, collection, id, seq, value)
+      this.sqlite.prepare(`INSERT INTO emulates_records (namespace, collection, id, seq, value)
            VALUES (?, ?, ?, ?, ?)
            ON CONFLICT(namespace, collection, id) DO UPDATE SET seq = excluded.seq, value = excluded.value`).run(this.namespace, this.collectionName, id, seq, JSON.stringify(stored));
       return stored;
@@ -107,25 +127,25 @@ var Collection = class {
   /** Replace an existing record's value, keeping its position. */
   update(id, value) {
     return this.sqlite.transaction(() => {
-      const row = this.sqlite.prepare("SELECT seq, value FROM emulators_records WHERE namespace = ? AND collection = ? AND id = ?").get(this.namespace, this.collectionName, id);
+      const row = this.sqlite.prepare("SELECT seq, value FROM emulates_records WHERE namespace = ? AND collection = ? AND id = ?").get(this.namespace, this.collectionName, id);
       if (!row)
         return void 0;
       const stored = { seq: row.seq, value };
-      this.sqlite.prepare("UPDATE emulators_records SET value = ? WHERE namespace = ? AND collection = ? AND id = ?").run(JSON.stringify(stored), this.namespace, this.collectionName, id);
+      this.sqlite.prepare("UPDATE emulates_records SET value = ? WHERE namespace = ? AND collection = ? AND id = ?").run(JSON.stringify(stored), this.namespace, this.collectionName, id);
       return stored;
     });
   }
   delete(id) {
-    const result = this.sqlite.prepare("DELETE FROM emulators_records WHERE namespace = ? AND collection = ? AND id = ?").run(this.namespace, this.collectionName, id);
+    const result = this.sqlite.prepare("DELETE FROM emulates_records WHERE namespace = ? AND collection = ? AND id = ?").run(this.namespace, this.collectionName, id);
     return result.changes > 0;
   }
   /** How many records the collection holds, without reading them. */
   count() {
-    const row = this.sqlite.prepare("SELECT COUNT(*) AS n FROM emulators_records WHERE namespace = ? AND collection = ?").get(this.namespace, this.collectionName);
+    const row = this.sqlite.prepare("SELECT COUNT(*) AS n FROM emulates_records WHERE namespace = ? AND collection = ?").get(this.namespace, this.collectionName);
     return Number(row?.n ?? 0);
   }
   list(options = {}) {
-    const rows = this.sqlite.prepare("SELECT id, seq, value FROM emulators_records WHERE namespace = ? AND collection = ?").all(this.namespace, this.collectionName);
+    const rows = this.sqlite.prepare("SELECT id, seq, value FROM emulates_records WHERE namespace = ? AND collection = ?").all(this.namespace, this.collectionName);
     const out = [];
     for (const row of rows) {
       const stored = JSON.parse(row.value);
@@ -174,9 +194,9 @@ var IdSequence = class {
   }
   next(prefix, length = 14) {
     return this.sqlite.transaction(() => {
-      const row = this.sqlite.prepare("SELECT value FROM emulators_sequences WHERE namespace = ? AND name = ? AND kind = 'id'").get(this.namespace, prefix);
+      const row = this.sqlite.prepare("SELECT value FROM emulates_sequences WHERE namespace = ? AND name = ? AND kind = 'id'").get(this.namespace, prefix);
       const value = (row?.value ?? 0) + 1;
-      this.sqlite.prepare(`INSERT INTO emulators_sequences (namespace, name, kind, value) VALUES (?, ?, 'id', ?)
+      this.sqlite.prepare(`INSERT INTO emulates_sequences (namespace, name, kind, value) VALUES (?, ?, 'id', ?)
            ON CONFLICT(namespace, name, kind) DO UPDATE SET value = excluded.value`).run(this.namespace, prefix, value);
       return `${prefix}${opaqueToken(`${this.salt}:${prefix}:${value}`, length)}`;
     });
@@ -875,7 +895,7 @@ var json = (status, body) => new Response(JSON.stringify(body), {
   status,
   headers: { "content-type": "application/json; charset=utf-8" }
 });
-var adminError = (status, message) => json(status, { error: { type: "emulators_admin", message } });
+var adminError = (status, message) => json(status, { error: { type: "emulates_admin", message } });
 var UNITS = {
   ms: 1,
   s: 1e3,
@@ -1747,18 +1767,18 @@ var adminUiRoutes = (service, ui, adminPrefix = ADMIN_PREFIX) => {
 // ../core/dist/snapshot.js
 var snapshotNamespace = (sqlite, namespace) => ({
   namespace,
-  records: sqlite.prepare("SELECT collection, id, seq, value FROM emulators_records WHERE namespace = ? ORDER BY collection, seq").all(namespace),
-  sequences: sqlite.prepare("SELECT name, kind, value FROM emulators_sequences WHERE namespace = ? ORDER BY name, kind").all(namespace)
+  records: sqlite.prepare("SELECT collection, id, seq, value FROM emulates_records WHERE namespace = ? ORDER BY collection, seq").all(namespace),
+  sequences: sqlite.prepare("SELECT name, kind, value FROM emulates_sequences WHERE namespace = ? ORDER BY name, kind").all(namespace)
 });
 var restoreNamespace = (sqlite, namespace, snapshot) => {
   sqlite.transaction(() => {
-    sqlite.prepare("DELETE FROM emulators_records WHERE namespace = ?").run(namespace);
-    sqlite.prepare("DELETE FROM emulators_sequences WHERE namespace = ?").run(namespace);
-    const record = sqlite.prepare("INSERT INTO emulators_records (namespace, collection, id, seq, value) VALUES (?, ?, ?, ?, ?)");
+    sqlite.prepare("DELETE FROM emulates_records WHERE namespace = ?").run(namespace);
+    sqlite.prepare("DELETE FROM emulates_sequences WHERE namespace = ?").run(namespace);
+    const record = sqlite.prepare("INSERT INTO emulates_records (namespace, collection, id, seq, value) VALUES (?, ?, ?, ?, ?)");
     for (const row of snapshot.records) {
       record.run(namespace, row.collection, row.id, row.seq, row.value);
     }
-    const sequence = sqlite.prepare("INSERT INTO emulators_sequences (namespace, name, kind, value) VALUES (?, ?, ?, ?)");
+    const sequence = sqlite.prepare("INSERT INTO emulates_sequences (namespace, name, kind, value) VALUES (?, ?, ?, ?)");
     for (const row of snapshot.sequences) {
       sequence.run(namespace, row.name, row.kind, row.value);
     }
@@ -1857,8 +1877,8 @@ var discoverCollections = (root) => {
   return found;
 };
 var storedNames = (sqlite, namespace) => {
-  const records = sqlite.prepare("SELECT DISTINCT collection AS name FROM emulators_records WHERE namespace = ?").all(namespace);
-  const sequences = sqlite.prepare("SELECT DISTINCT name FROM emulators_sequences WHERE namespace = ? AND kind = 'collection'").all(namespace);
+  const records = sqlite.prepare("SELECT DISTINCT collection AS name FROM emulates_records WHERE namespace = ?").all(namespace);
+  const sequences = sqlite.prepare("SELECT DISTINCT name FROM emulates_sequences WHERE namespace = ? AND kind = 'collection'").all(namespace);
   return [...records, ...sequences].map((row) => row.name);
 };
 var blankAccum = (name) => ({
@@ -2099,7 +2119,7 @@ var json3 = (status, body) => new Response(JSON.stringify(body), {
   status,
   headers: { "content-type": "application/json; charset=utf-8" }
 });
-var adminError2 = (status, message) => json3(status, { error: { type: "emulators_admin", message } });
+var adminError2 = (status, message) => json3(status, { error: { type: "emulates_admin", message } });
 var fromResult = (result, status) => result.ok ? json3(status, result.value) : adminError2(result.status, result.message);
 var integerParam = (value) => {
   if (value === null)
@@ -2200,14 +2220,14 @@ var stateAdminRoutes = (routes) => {
 };
 
 // ../core/dist/version.js
-var PACKAGE_VERSION = true ? "2.3.1" : UNRELEASED_VERSION;
+var PACKAGE_VERSION = true ? "3.0.0" : UNRELEASED_VERSION;
 
 // ../core/dist/webhooks.js
 var json4 = (status, body) => new Response(JSON.stringify(body), {
   status,
   headers: { "content-type": "application/json; charset=utf-8" }
 });
-var adminError3 = (status, message) => json4(status, { error: { type: "emulators_admin", message } });
+var adminError3 = (status, message) => json4(status, { error: { type: "emulates_admin", message } });
 var isRecord4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var parseEndpoint = (value) => {
   if (!isRecord4(value) || typeof value.url !== "string")
@@ -2809,7 +2829,7 @@ var createRuntime = (options) => {
         log(400);
         return stamp(new Response(JSON.stringify({
           error: {
-            type: "emulators_admin",
+            type: "emulates_admin",
             message: `${NAMESPACE_HEADER} must match ${NAMESPACE_PATTERN}`
           }
         }), { status: 400, headers: { "content-type": "application/json; charset=utf-8" } }));
@@ -2975,7 +2995,7 @@ var adminJson = (status, body) => new Response(JSON.stringify(body), {
   status,
   headers: { "content-type": "application/json; charset=utf-8" }
 });
-var adminFail = (status, message) => adminJson(status, { error: { type: "emulators_admin", message } });
+var adminFail = (status, message) => adminJson(status, { error: { type: "emulates_admin", message } });
 var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var credentialRoutes = (registry) => ({
   "GET /credentials": () => adminJson(200, {
@@ -3187,7 +3207,7 @@ var admin = (runtime) => ({
     const input = body;
     if (!input || typeof input.username !== "string" || typeof input.password !== "string")
       return json5(
-        { error: { type: "emulators_admin", message: "username and password are required" } },
+        { error: { type: "emulates_admin", message: "username and password are required" } },
         400
       );
     return json5(runtime.instance(namespace).state.put(input), 201);
@@ -3198,7 +3218,7 @@ var admin = (runtime) => ({
       username: user.username,
       confirmationCode: user.confirmationCode,
       resetCode: user.resetCode
-    }) : json5({ error: { type: "emulators_admin", message: "user not found" } }, 404);
+    }) : json5({ error: { type: "emulates_admin", message: "user not found" } }, 404);
   },
   "POST /keys/rotate": ({ namespace, body }) => json5(
     runtime.instance(namespace).rotateSigningKey(body?.retainPrevious !== false)
@@ -3206,7 +3226,7 @@ var admin = (runtime) => ({
   "POST /sessions/revoke": ({ namespace, body }) => {
     const username = body?.username;
     if (typeof username !== "string")
-      return json5({ error: { type: "emulators_admin", message: "username is required" } }, 400);
+      return json5({ error: { type: "emulates_admin", message: "username is required" } }, 400);
     const api = runtime.instance(namespace);
     for (const row of api.state.sessions.list({
       where: (session) => session.username === username
@@ -3268,7 +3288,7 @@ var CognitoAPI = class {
     this.sqlite = bootSqlite(options.sqlite);
     this.namespace = options.namespace ?? COGNITO_NAMESPACE;
     this.now = options.now ?? Date.now;
-    this.poolId = options.poolId ?? "us-east-1_emulators";
+    this.poolId = options.poolId ?? "us-east-1_emulates";
     this.defaultClientId = options.clientId ?? "emulates-client";
     this.state = new CognitoState(this.sqlite, this.namespace, options.users ?? []);
   }
@@ -3632,4 +3652,4 @@ export {
   accessKeyCredential,
   CognitoAPI
 };
-//# sourceMappingURL=chunk-ZLLODF3V.js.map
+//# sourceMappingURL=chunk-BU4ORISY.js.map