@owlmeans/mongo-resource 0.1.18-rc.32 → 0.1.18-rc.34

package/README.md

@@ -12,7 +12,7 @@ Client-side records go in [`@owlmeans/state`](../state).
 ## Installation
 
 ```bash
-bun add @owlmeans/mongo-resource@^0.1.18-rc.31
+bun add @owlmeans/mongo-resource@^0.1.18-rc.34
 ```
 
 `mongodb` and `ajv` are peer dependencies. The connection service comes from
@@ -294,7 +294,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.33
+npx @owlmeans/agent-skills@^0.1.18-rc.35
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/mongo-resource",
-  "version": "0.1.18-rc.32",
-  "generatedAt": "2026-09-22T17:39:02.513Z",
+  "version": "0.1.18-rc.34",
+  "generatedAt": "2026-09-22T21:58:46.774Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/mongo-resource/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/mongo-resource
 
 **Layer:** Infra
-**Install:** `"@owlmeans/mongo-resource": "^0.1.18-rc.32"` in `dependencies` (peers `mongodb`, `ajv`)
+**Install:** `"@owlmeans/mongo-resource": "^0.1.18-rc.34"` in `dependencies` (peers `mongodb`, `ajv`)
 
 The Mongo counterpart of [[postgres-resource]]. A collection has no structure of its own, so
 here the resource layer owns the *validator* (`$jsonSchema` from the AJV schema), the indexes,
@@ -133,9 +133,14 @@ with `marshalReference(field, value)` and convert read-back documents' reference
   after earlier collections were already rewritten, leaving the database half-migrated and the boot
   aborting on every restart. Drop the stale index by name in the body first (guard on the key spec
   so the drop is idempotent) and let reconciliation recreate it from the declaration.
-- **Index reconciliation matches by name and recreates on any difference.** A live index whose key
-  pattern or options differ from the declaration is dropped and created again, so a renamed field
-  does converge — after `Pre`, which is why the bullet above exists. Text indexes are the one
+- **Index reconciliation matches by name and recreates on a REAL difference.** A live index whose
+  key pattern or options differ from the declaration is dropped and created again, so a renamed
+  field does converge — after `Pre`, which is why the bullet above exists. The comparison treats
+  the key as ordered (a compound index is its key order) and the options as a set, and ignores
+  what the server reports rather than the declaration asks for (`v`, `collation`, index versions):
+  comparing the two documents as JSON instead made every boot drop and recreate every index, which
+  stayed invisible until two processes booted together and the loser died on `IndexNotFound`. A
+  drop that finds the index already gone is therefore tolerated. Text indexes are the one
   exception: a live index carrying `weights` is left as it is, and changing one means dropping it
   yourself.
 - On a collection this boot just created, every registered migration is **baselined**

package/build/utils/indexes.d.ts

@@ -1,5 +1,15 @@
 import type { ResourceRecord } from '@owlmeans/resource';
 import type { MongoResource } from '../types.js';
-import type { Collection } from 'mongodb';
+import type { Collection, Document } from 'mongodb';
+/**
+ * Whether an index the database already holds differs from the one declared.
+ *
+ * Mongo returns an index's options in ITS order, not the declaration's, so comparing the two
+ * documents as JSON reported every index as changed — and every boot then dropped and recreated
+ * every index. That is invisible until two processes boot at once, when the second one's drop
+ * fails with `IndexNotFound` and takes the service down with it. Only the KEY is order-sensitive
+ * (a compound index is its key order); options are a set.
+ */
+export declare const indexChanged: (existing: Document, proposed: Document) => boolean;
 export declare const updateIndexes: (collection: Collection, resource: MongoResource<ResourceRecord>) => Promise<void>;
 //# sourceMappingURL=indexes.d.ts.map

package/build/utils/indexes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexes.d.ts","sourceRoot":"","sources":["../../src/utils/indexes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,eAAO,MAAM,aAAa,eAAsB,UAAU,YAAY,aAAa,CAAC,cAAc,CAAC,kBAiClG,CAAA"}
+{"version":3,"file":"indexes.d.ts","sourceRoot":"","sources":["../../src/utils/indexes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAanD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,aAAc,QAAQ,YAAY,QAAQ,KAAG,OAMrE,CAAA;AAED,eAAO,MAAM,aAAa,eAAsB,UAAU,YAAY,aAAa,CAAC,cAAc,CAAC,kBA8BlG,CAAA"}

package/build/utils/indexes.js

@@ -1,34 +1,58 @@
+/** What the SERVER reports about an index rather than what a declaration asks for — never a
+ *  reason to recreate one. `collation` is here because a collection's default collation is
+ *  reported on every index in it, including the ones declared without any. */
+const REPORTED_FIELDS = new Set([
+    'v', 'ns', 'name', 'collation', 'textIndexVersion', '2dsphereIndexVersion', 'background'
+]);
+const options = (spec) => Object.entries(spec)
+    .filter(([field]) => field !== 'key' && !REPORTED_FIELDS.has(field))
+    .sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+/**
+ * Whether an index the database already holds differs from the one declared.
+ *
+ * Mongo returns an index's options in ITS order, not the declaration's, so comparing the two
+ * documents as JSON reported every index as changed — and every boot then dropped and recreated
+ * every index. That is invisible until two processes boot at once, when the second one's drop
+ * fails with `IndexNotFound` and takes the service down with it. Only the KEY is order-sensitive
+ * (a compound index is its key order); options are a set.
+ */
+export const indexChanged = (existing, proposed) => {
+    // We do not recreate text indexes.
+    if ('weights' in existing)
+        return false;
+    if (JSON.stringify(existing.key) !== JSON.stringify(proposed.key))
+        return true;
+    return JSON.stringify(options(existing)) !== JSON.stringify(options(proposed));
+};
 export const updateIndexes = async (collection, resource) => {
-    if (resource.indexes != null) {
-        await Promise.all(resource.indexes.map(async (index) => {
-            const _index = (await collection.indexes()).find(_index => _index.name === index.name);
-            if (_index != null) {
-                const existing = { ..._index };
-                if ('name' in existing) {
-                    delete existing.name;
-                }
-                if ('v' in existing) {
-                    delete existing.v;
-                }
-                const propsed = { key: index.index, ...index.options };
-                // We do not recreate text indexes
-                if (JSON.stringify(existing) !== JSON.stringify(propsed) && !('weights' in existing)) {
-                    console.info(JSON.stringify(existing));
-                    console.info(JSON.stringify(propsed));
-                    console.debug(`Recreate index ${resource.alias} : ${index.name}`);
-                    await collection.dropIndex(index.name);
-                    await collection.createIndex(index.index, {
-                        name: index.name, ...((index.options != null) ? index.options : {})
-                    });
-                }
-            }
-            else {
-                console.debug(`Create index ${resource.alias} : ${index.name}`);
-                await collection.createIndex(index.index, {
-                    name: index.name, ...((index.options != null) ? index.options : {})
-                });
-            }
-        }));
+    if (resource.indexes == null) {
+        return;
     }
+    const present = await collection.indexes();
+    await Promise.all(resource.indexes.map(async (index) => {
+        const create = async () => await collection.createIndex(index.index, {
+            name: index.name, ...((index.options != null) ? index.options : {})
+        });
+        const existing = present.find(_index => _index.name === index.name);
+        if (existing == null) {
+            console.debug(`Create index ${resource.alias} : ${index.name}`);
+            await create();
+            return;
+        }
+        if (!indexChanged(existing, { key: index.index, ...index.options })) {
+            return;
+        }
+        console.debug(`Recreate index ${resource.alias} : ${index.name}`);
+        try {
+            await collection.dropIndex(index.name);
+        }
+        catch (e) {
+            // IndexNotFound: another process booting alongside this one dropped it first — it is
+            // recreating the same declaration, so there is nothing here to fail over.
+            if (e.code !== 27)
+                throw e;
+        }
+        await create();
+    }));
 };
 //# sourceMappingURL=indexes.js.map

package/build/utils/indexes.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexes.js","sourceRoot":"","sources":["../../src/utils/indexes.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,UAAsB,EAAE,QAAuC,EAAE,EAAE;IACrG,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CACpC,KAAK,EAAC,KAAK,EAAC,EAAE;YACZ,MAAM,MAAM,GAAG,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAA;YACtF,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,MAAM,QAAQ,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;gBAC9B,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;oBACvB,OAAO,QAAQ,CAAC,IAAI,CAAA;gBACtB,CAAC;gBACD,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;oBACpB,OAAO,QAAQ,CAAC,CAAC,CAAA;gBACnB,CAAC;gBACD,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAA;gBACtD,kCAAkC;gBAClC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC;oBACrF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;oBACtC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;oBACrC,OAAO,CAAC,KAAK,CAAC,kBAAkB,QAAQ,CAAC,KAAK,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;oBACjE,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBACtC,MAAM,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE;wBACxC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;qBACpE,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,KAAK,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;gBAC/D,MAAM,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE;oBACxC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpE,CAAC,CAAA;YACJ,CAAC;QACH,CAAC,CACF,CAAC,CAAA;IACJ,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"indexes.js","sourceRoot":"","sources":["../../src/utils/indexes.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/mongo-resource",
-  "version": "0.1.18-rc.32",
+  "version": "0.1.18-rc.34",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -26,13 +26,13 @@
     "mongodb": "*"
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.29",
-    "@owlmeans/resource": "^0.1.18-rc.31",
-    "@owlmeans/server-context": "^0.1.18-rc.32"
+    "@owlmeans/context": "^0.1.18-rc.31",
+    "@owlmeans/resource": "^0.1.18-rc.33",
+    "@owlmeans/server-context": "^0.1.18-rc.34"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-integration": "^0.1.18-rc.26",
+    "@owlmeans/test-integration": "^0.1.18-rc.28",
     "@types/bun": "^1.4.0",
     "@types/node": "^26.1.0",
     "mongodb": "^7.5.0",

package/src/utils/indexes.ts

@@ -1,38 +1,63 @@
 import type { ResourceRecord } from '@owlmeans/resource'
 import type { MongoResource } from '../types.js'
-import type { Collection } from 'mongodb'
+import type { Collection, Document } from 'mongodb'
+
+/** What the SERVER reports about an index rather than what a declaration asks for — never a
+ *  reason to recreate one. `collation` is here because a collection's default collation is
+ *  reported on every index in it, including the ones declared without any. */
+const REPORTED_FIELDS = new Set([
+  'v', 'ns', 'name', 'collation', 'textIndexVersion', '2dsphereIndexVersion', 'background'
+])
+
+const options = (spec: Document): [string, unknown][] => Object.entries(spec)
+  .filter(([field]) => field !== 'key' && !REPORTED_FIELDS.has(field))
+  .sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)
+
+/**
+ * Whether an index the database already holds differs from the one declared.
+ *
+ * Mongo returns an index's options in ITS order, not the declaration's, so comparing the two
+ * documents as JSON reported every index as changed — and every boot then dropped and recreated
+ * every index. That is invisible until two processes boot at once, when the second one's drop
+ * fails with `IndexNotFound` and takes the service down with it. Only the KEY is order-sensitive
+ * (a compound index is its key order); options are a set.
+ */
+export const indexChanged = (existing: Document, proposed: Document): boolean => {
+  // We do not recreate text indexes.
+  if ('weights' in existing) return false
+  if (JSON.stringify(existing.key) !== JSON.stringify(proposed.key)) return true
+
+  return JSON.stringify(options(existing)) !== JSON.stringify(options(proposed))
+}
 
 export const updateIndexes = async (collection: Collection, resource: MongoResource<ResourceRecord>) => {
-  if (resource.indexes != null) {
-    await Promise.all(resource.indexes.map(
-      async index => {
-        const _index = (await collection.indexes()).find(_index => _index.name === index.name)
-        if (_index != null) {
-          const existing = { ..._index }
-          if ('name' in existing) {
-            delete existing.name
-          }
-          if ('v' in existing) {
-            delete existing.v
-          }
-          const propsed = { key: index.index, ...index.options }
-          // We do not recreate text indexes
-          if (JSON.stringify(existing) !== JSON.stringify(propsed) && !('weights' in existing)) {
-            console.info(JSON.stringify(existing))
-            console.info(JSON.stringify(propsed))
-            console.debug(`Recreate index ${resource.alias} : ${index.name}`)
-            await collection.dropIndex(index.name)
-            await collection.createIndex(index.index, {
-              name: index.name, ...((index.options != null) ? index.options : {})
-            })
-          }
-        } else {
-          console.debug(`Create index ${resource.alias} : ${index.name}`)
-          await collection.createIndex(index.index, {
-            name: index.name, ...((index.options != null) ? index.options : {})
-          })
-        }
-      }
-    ))
+  if (resource.indexes == null) {
+    return
   }
+  const present = await collection.indexes()
+  await Promise.all(resource.indexes.map(
+    async index => {
+      const create = async () => await collection.createIndex(index.index, {
+        name: index.name, ...((index.options != null) ? index.options : {})
+      })
+      const existing = present.find(_index => _index.name === index.name)
+      if (existing == null) {
+        console.debug(`Create index ${resource.alias} : ${index.name}`)
+        await create()
+        return
+      }
+      if (!indexChanged(existing, { key: index.index, ...index.options })) {
+        return
+      }
+      console.debug(`Recreate index ${resource.alias} : ${index.name}`)
+      try {
+        await collection.dropIndex(index.name)
+      } catch (e) {
+        // IndexNotFound: another process booting alongside this one dropped it first — it is
+        // recreating the same declaration, so there is nothing here to fail over.
+        if ((e as { code?: number }).code !== 27) throw e
+      }
+      await create()
+    }
+  ))
 }

package/tests/indexes.spec.ts

@@ -0,0 +1,40 @@
+import { describe, expect, test } from 'bun:test'
+import { indexChanged } from '../src/utils/indexes.js'
+
+/**
+ * No gate: this is the pure decision behind `updateIndexes`, and the case that matters needs no
+ * database — an index the server reports back is compared against the declaration it came from.
+ */
+describe('@owlmeans/mongo-resource — index comparison', () => {
+  const declared = { key: { currentJobId: 1 }, sparse: true, unique: true }
+
+  test('the same index reported in the server\'s own option order is unchanged', () => {
+    // What the server answers for exactly this declaration — options in its order, plus `v`.
+    expect(indexChanged({ v: 2, key: { currentJobId: 1 }, unique: true, sparse: true }, declared)).toBe(false)
+  })
+
+  test('fields the server reports rather than the declaration asks for are not a change', () => {
+    const reported = {
+      v: 2, key: { currentJobId: 1 }, unique: true, sparse: true, background: false,
+      collation: { locale: 'en', strength: 2 },
+    }
+    expect(indexChanged(reported, declared)).toBe(false)
+  })
+
+  test('a changed option, a dropped option and a changed key are changes', () => {
+    expect(indexChanged({ v: 2, key: { currentJobId: 1 }, unique: false, sparse: true }, declared)).toBe(true)
+    expect(indexChanged({ v: 2, key: { currentJobId: 1 }, unique: true }, declared)).toBe(true)
+    expect(indexChanged({ v: 2, key: { currentJobId: -1 }, unique: true, sparse: true }, declared)).toBe(true)
+  })
+
+  test('a compound index compares its key in order', () => {
+    const compound = { key: { entityId: 1, createdAt: -1 } }
+    expect(indexChanged({ v: 2, key: { entityId: 1, createdAt: -1 } }, compound)).toBe(false)
+    expect(indexChanged({ v: 2, key: { createdAt: -1, entityId: 1 } }, compound)).toBe(true)
+  })
+
+  test('a text index is never recreated', () => {
+    const text = { v: 2, key: { _fts: 'text', _ftsx: 1 }, weights: { title: 1 }, textIndexVersion: 3 }
+    expect(indexChanged(text, { key: { title: 'text' } })).toBe(false)
+  })
+})