@ultimabase/testing 0.1.2 → 0.3.0-canary.20261031104207

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @ultimabase/testing
 
+## 0.3.0-canary.20261031104207
+
+### Minor Changes
+
+- 6e8ebf6: `testApplication` returns `feed.missed()`, which calls each plugin's `missed` during a test (D-168).
+- 353c2bf: A string field takes `unique: 'insensitive'`, and a unique index `mode: 'insensitive'`: `Alice` then clashes with `alice`, while each row keeps its case, and the `UNIQUE_VIOLATION` names the field (D-170). `postgres()` makes a unique index over `lower()`, which also serves an insensitive `equals`: run a migration after the upgrade to add it. `@ultimabase/testing` checks an adapter's case-insensitive keys.
+
+### Patch Changes
+
+- Updated dependencies [41cfff6]
+- Updated dependencies [6e8ebf6]
+- Updated dependencies [9cd2dd4]
+- Updated dependencies [353c2bf]
+  - ultimabase@0.3.0-canary.20261031104207
+
+## 0.2.0
+
+### Patch Changes
+
+- Updated dependencies [2c3bf4e]
+- Updated dependencies [fd1263e]
+  - ultimabase@0.2.0
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/test-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-adapter.d.ts","sourceRoot":"","sources":["../src/test-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AA0BzC,MAAM,MAAM,OAAO,GAAG;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAA;CACjC,CAAA;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,OAAO,EACrB,OAAO,EAAE,OAAO,GACd,IAAI,CA0BN"}
+{"version":3,"file":"test-adapter.d.ts","sourceRoot":"","sources":["../src/test-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AA2BzC,MAAM,MAAM,OAAO,GAAG;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAA;CACjC,CAAA;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,OAAO,EACrB,OAAO,EAAE,OAAO,GACd,IAAI,CA2BN"}

package/dist/test-adapter.js

@@ -20,6 +20,7 @@ import { roundTrips } from './round-trips.js';
 import { searches } from './searches.js';
 import { sorts } from './sorts.js';
 import { transactions } from './transactions.js';
+import { uniqueCases } from './unique-cases.js';
 import { virtuals } from './virtuals.js';
 import { writes } from './writes.js';
 /**
@@ -31,6 +32,7 @@ export function testAdapter(name, create, options) {
         reads(create);
         cases(create);
         writes(create);
+        uniqueCases(create);
         cascades(create);
         lists(create);
         jsonPaths(create);

package/dist/test-application.d.ts

@@ -1,6 +1,11 @@
 export type TestApplication = {
     /** The HTTP server's address during a test, such as `http://localhost:54321`. */
     readonly url: string;
+    /** The change feed, during a test (D-168). */
+    readonly feed: {
+        /** Calls each plugin's `missed`, as after a lost connection. */
+        readonly missed: () => void;
+    };
 };
 export type TestOptions = {
     /**

package/dist/test-application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-application.d.ts","sourceRoot":"","sources":["../src/test-application.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,eAAe,GAAG;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACpB,CAAA;AAwBD,MAAM,MAAM,WAAW,GAAG;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;CAC9B,CAAA;AAgBD;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACvB,eAAe,CA2BjB"}
+{"version":3,"file":"test-application.d.ts","sourceRoot":"","sources":["../src/test-application.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,eAAe,GAAG;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE;QACd,gEAAgE;QAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAC3B,CAAA;CACD,CAAA;AAwBD,MAAM,MAAM,WAAW,GAAG;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;CAC9B,CAAA;AAgBD;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACvB,eAAe,CAkCjB"}

package/dist/test-application.js

@@ -1,5 +1,5 @@
 import { memory } from 'ultimabase';
-import { quietRuns, runningApi, scratchOf } from 'ultimabase/internal';
+import { quietRuns, runningApi, runningFeed, scratchOf, } from 'ultimabase/internal';
 import { afterEach, beforeAll, beforeEach } from 'vitest';
 /** Starts `run` with `PORT` set to `0`, then puts `PORT` back. */
 async function onFreePort(run) {
@@ -64,5 +64,12 @@ export function testApplication(app, options = {}) {
             }
             return url;
         },
+        feed: {
+            missed: () => {
+                if (run === undefined)
+                    throw new Error('feed.missed() runs during a test.');
+                runningFeed()?.missed();
+            },
+        },
     };
 }

package/dist/unique-cases.d.ts

@@ -0,0 +1,3 @@
+import type { Adapter } from 'ultimabase';
+export declare function uniqueCases(create: () => Adapter): void;
+//# sourceMappingURL=unique-cases.d.ts.map

package/dist/unique-cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-cases.d.ts","sourceRoot":"","sources":["../src/unique-cases.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AA2BzC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,OAAO,GAAG,IAAI,CAwFvD"}

package/dist/unique-cases.js

@@ -0,0 +1,68 @@
+import { defineModel, master } from 'ultimabase';
+import { describe, expect, it } from 'vitest';
+import { started } from './suite.js';
+const M = { as: master };
+const club = (id) => ({ connect: { id } });
+const Account = defineModel({
+    name: 'Account',
+    fields: (f) => ({
+        username: f.string({ unique: 'insensitive' }),
+        nickname: f.string({ unique: 'insensitive', optional: true }),
+    }),
+});
+const Club = defineModel({
+    name: 'Club',
+    fields: (f) => ({ name: f.string(), members: f.many(() => Member) }),
+});
+const Member = defineModel({
+    name: 'Member',
+    fields: (f) => ({ handle: f.string(), club: f.one(() => Club) }),
+    indexes: [{ fields: ['handle', 'club'], unique: true, mode: 'insensitive' }],
+});
+export function uniqueCases(create) {
+    describe('case-insensitive unique keys', () => {
+        started(create, [Account, Club, Member]);
+        it('refuses a value another row holds in another case', async () => {
+            const alice = await Account.create({ data: { username: 'alice' } }, M);
+            const refused = {
+                code: 'UNIQUE_VIOLATION',
+                details: { model: 'Account', fields: ['username'] },
+            };
+            await expect(Account.create({ data: { username: 'Alice' } }, M)).rejects.toMatchObject(refused);
+            await expect(Account.createMany({ data: [{ username: 'Bob' }, { username: 'BOB' }] }, M)).rejects.toMatchObject(refused);
+            const bob = await Account.create({ data: { username: 'bob' } }, M);
+            await expect(Account.update({ where: { id: bob.id }, data: { username: 'ALICE' } }, M)).rejects.toMatchObject(refused);
+            const renamed = await Account.update({ where: { id: alice.id }, data: { username: 'Alice' } }, M);
+            expect(renamed.username).toBe('Alice');
+            expect(await Account.count({}, M)).toBe(2);
+        });
+        it('lets rows without a value share none', async () => {
+            await Account.create({ data: { username: 'ada' } }, M);
+            await Account.create({ data: { username: 'grace' } }, M);
+            await Account.create({ data: { username: 'linus', nickname: 'Penguin' } }, M);
+            await expect(Account.create({ data: { username: 'tux', nickname: 'penguin' } }, M)).rejects.toMatchObject({
+                details: { model: 'Account', fields: ['nickname'] },
+            });
+        });
+        it('matches exactly by key, and finds the other cases with mode', async () => {
+            const alice = await Account.create({ data: { username: 'Alice' } }, M);
+            expect(await Account.findUnique({ where: { username: 'alice' } }, M)).toBeNull();
+            expect(await Account.findUnique({ where: { username: 'Alice' } }, M)).toEqual(alice);
+            const insensitive = { equals: 'ALICE', mode: 'insensitive' };
+            expect(await Account.findFirst({ where: { username: insensitive } }, M)).toEqual(alice);
+            expect(await Account.count({ where: { username: { not: 'aLiCe', mode: 'insensitive' } } }, M)).toBe(0);
+            expect(await Account.count({ where: { username: { in: ['ALICE'], mode: 'insensitive' } } }, M)).toBe(1);
+        });
+        it('refuses the values of an index in another case, its other fields alike', async () => {
+            const chess = await Club.create({ data: { name: 'Chess' } }, M);
+            const go = await Club.create({ data: { name: 'Go' } }, M);
+            await Member.create({ data: { handle: 'ada', club: club(chess.id) } }, M);
+            await expect(Member.create({ data: { handle: 'ADA', club: club(chess.id) } }, M)).rejects.toMatchObject({
+                code: 'UNIQUE_VIOLATION',
+                details: { model: 'Member', fields: ['handle', 'club'] },
+            });
+            await Member.create({ data: { handle: 'ADA', club: club(go.id) } }, M);
+            expect(await Member.count({}, M)).toBe(2);
+        });
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimabase/testing",
-  "version": "0.1.2",
+  "version": "0.3.0-canary.20261031104207",
   "description": "Test helpers for UltimaBase applications, plugins and adapters.",
   "type": "module",
   "license": "Apache-2.0",
@@ -31,12 +31,12 @@
     }
   },
   "peerDependencies": {
-    "ultimabase": "^0.1.2",
+    "ultimabase": "0.3.0-canary.20261031104207",
     "vitest": "^5.0.5"
   },
   "devDependencies": {
-    "@ultimabase/http": "0.1.2",
-    "ultimabase": "0.1.2",
+    "@ultimabase/http": "0.3.0-canary.20261031104207",
+    "ultimabase": "0.3.0-canary.20261031104207",
     "vite": "8.3.4",
     "vitest": "5.0.5"
   }

package/src/test-adapter.ts

@@ -23,6 +23,7 @@ import { roundTrips } from './round-trips.ts'
 import { searches } from './searches.ts'
 import { sorts } from './sorts.ts'
 import { transactions } from './transactions.ts'
+import { uniqueCases } from './unique-cases.ts'
 import { virtuals } from './virtuals.ts'
 import { writes } from './writes.ts'
 
@@ -44,6 +45,7 @@ export function testAdapter(
 		reads(create)
 		cases(create)
 		writes(create)
+		uniqueCases(create)
 		cascades(create)
 		lists(create)
 		jsonPaths(create)

package/src/test-application.ts

@@ -4,12 +4,22 @@
 import type { Adapter } from 'ultimabase'
 import { memory } from 'ultimabase'
 import type { Lifecycle } from 'ultimabase/internal'
-import { quietRuns, runningApi, scratchOf } from 'ultimabase/internal'
+import {
+	quietRuns,
+	runningApi,
+	runningFeed,
+	scratchOf,
+} from 'ultimabase/internal'
 import { afterEach, beforeAll, beforeEach } from 'vitest'
 
 export type TestApplication = {
 	/** The HTTP server's address during a test, such as `http://localhost:54321`. */
 	readonly url: string
+	/** The change feed, during a test (D-168). */
+	readonly feed: {
+		/** Calls each plugin's `missed`, as after a lost connection. */
+		readonly missed: () => void
+	}
 }
 
 /** Starts `run` with `PORT` set to `0`, then puts `PORT` back. */
@@ -89,5 +99,12 @@ export function testApplication(
 			}
 			return url
 		},
+		feed: {
+			missed: () => {
+				if (run === undefined)
+					throw new Error('feed.missed() runs during a test.')
+				runningFeed()?.missed()
+			},
+		},
 	}
 }

package/src/unique-cases.ts

@@ -0,0 +1,119 @@
+// Case-insensitive unique keys in the contract (D-170): a field's and an
+// index's, refused regardless of case, matched exactly by `findUnique` and
+// found by an insensitive equality.
+import type { Adapter } from 'ultimabase'
+import { defineModel, master } from 'ultimabase'
+import { describe, expect, it } from 'vitest'
+import { started } from './suite.ts'
+
+const M = { as: master }
+const club = (id: string) => ({ connect: { id } })
+
+const Account = defineModel({
+	name: 'Account',
+	fields: (f) => ({
+		username: f.string({ unique: 'insensitive' }),
+		nickname: f.string({ unique: 'insensitive', optional: true }),
+	}),
+})
+
+const Club = defineModel({
+	name: 'Club',
+	fields: (f) => ({ name: f.string(), members: f.many(() => Member) }),
+})
+
+const Member = defineModel({
+	name: 'Member',
+	fields: (f) => ({ handle: f.string(), club: f.one(() => Club) }),
+	indexes: [{ fields: ['handle', 'club'], unique: true, mode: 'insensitive' }],
+})
+
+export function uniqueCases(create: () => Adapter): void {
+	describe('case-insensitive unique keys', () => {
+		started(create, [Account, Club, Member])
+
+		it('refuses a value another row holds in another case', async () => {
+			const alice = await Account.create({ data: { username: 'alice' } }, M)
+			const refused = {
+				code: 'UNIQUE_VIOLATION',
+				details: { model: 'Account', fields: ['username'] },
+			}
+			await expect(
+				Account.create({ data: { username: 'Alice' } }, M),
+			).rejects.toMatchObject(refused)
+			await expect(
+				Account.createMany(
+					{ data: [{ username: 'Bob' }, { username: 'BOB' }] },
+					M,
+				),
+			).rejects.toMatchObject(refused)
+			const bob = await Account.create({ data: { username: 'bob' } }, M)
+			await expect(
+				Account.update(
+					{ where: { id: bob.id }, data: { username: 'ALICE' } },
+					M,
+				),
+			).rejects.toMatchObject(refused)
+			const renamed = await Account.update(
+				{ where: { id: alice.id }, data: { username: 'Alice' } },
+				M,
+			)
+			expect(renamed.username).toBe('Alice')
+			expect(await Account.count({}, M)).toBe(2)
+		})
+
+		it('lets rows without a value share none', async () => {
+			await Account.create({ data: { username: 'ada' } }, M)
+			await Account.create({ data: { username: 'grace' } }, M)
+			await Account.create(
+				{ data: { username: 'linus', nickname: 'Penguin' } },
+				M,
+			)
+			await expect(
+				Account.create({ data: { username: 'tux', nickname: 'penguin' } }, M),
+			).rejects.toMatchObject({
+				details: { model: 'Account', fields: ['nickname'] },
+			})
+		})
+
+		it('matches exactly by key, and finds the other cases with mode', async () => {
+			const alice = await Account.create({ data: { username: 'Alice' } }, M)
+			expect(
+				await Account.findUnique({ where: { username: 'alice' } }, M),
+			).toBeNull()
+			expect(
+				await Account.findUnique({ where: { username: 'Alice' } }, M),
+			).toEqual(alice)
+			const insensitive = { equals: 'ALICE', mode: 'insensitive' } as const
+			expect(
+				await Account.findFirst({ where: { username: insensitive } }, M),
+			).toEqual(alice)
+			expect(
+				await Account.count(
+					{ where: { username: { not: 'aLiCe', mode: 'insensitive' } } },
+					M,
+				),
+			).toBe(0)
+			expect(
+				await Account.count(
+					{ where: { username: { in: ['ALICE'], mode: 'insensitive' } } },
+					M,
+				),
+			).toBe(1)
+		})
+
+		it('refuses the values of an index in another case, its other fields alike', async () => {
+			const chess = await Club.create({ data: { name: 'Chess' } }, M)
+			const go = await Club.create({ data: { name: 'Go' } }, M)
+			await Member.create({ data: { handle: 'ada', club: club(chess.id) } }, M)
+			await expect(
+				Member.create({ data: { handle: 'ADA', club: club(chess.id) } }, M),
+			).rejects.toMatchObject({
+				code: 'UNIQUE_VIOLATION',
+				details: { model: 'Member', fields: ['handle', 'club'] },
+			})
+			await Member.create({ data: { handle: 'ADA', club: club(go.id) } }, M)
+			expect(await Member.count({}, M)).toBe(2)
+		})
+	})
+}