@lde/search-typesense 0.38.5 → 0.39.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { BlueGreenRebuild } from './blue-green-rebuild.js';
 export type { BlueGreenRebuildOptions } from './blue-green-rebuild.js';
 export { InPlaceRebuild } from './in-place-rebuild.js';
 export type { InPlaceRebuildOptions } from './in-place-rebuild.js';
-export { RebuildAlreadyRunning } from './lock.js';
+export { TypesenseRebuildRequests } from './rebuild-requests.js';
 export { buildCollectionDefinition } from './collection-definition.js';
 export type { CollectionDefinitionOptions } from './collection-definition.js';
 export { deriveCollectionName } from './collection-name.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export { BlueGreenRebuild } from './blue-green-rebuild.js';
 export { InPlaceRebuild } from './in-place-rebuild.js';
-export { RebuildAlreadyRunning } from './lock.js';
+export { TypesenseRebuildRequests } from './rebuild-requests.js';
 export { buildCollectionDefinition } from './collection-definition.js';
 export { deriveCollectionName } from './collection-name.js';
 export { buildSearchParams } from './query-compiler.js';

package/dist/lock.d.ts

@@ -1,14 +1,6 @@
 import type { Client, CollectionCreateSchema } from 'typesense';
 /** A held lock older than this (ms) is reclaimed. */
 export declare const DEFAULT_LOCK_TTL_MS: number;
-/**
- * Another run already holds the index’s rebuild lock, so this run refuses to
- * open. Rebuilds are single-flight per index across pods; catch this to treat
- * a concurrent rebuild as a graceful skip rather than a failure.
- */
-export declare class RebuildAlreadyRunning extends Error {
-    constructor(name: string);
-}
 /**
  * Open a run under the index’s single-flight lock: acquire it (throwing
  * {@link RebuildAlreadyRunning} when another rebuild holds it), run the

package/dist/lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAIhE,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,IAAI,EAAE,MAAM;CAIzB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAUd;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAED,yEAAyE;AACzE,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,sBAAsB,GACnC,OAAO,CAAC,OAAO,CAAC,CAmBlB;AA+BD,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE7D"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAKhE,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAElD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAUd;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAED,yEAAyE;AACzE,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,sBAAsB,GACnC,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAgCD,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE7D"}

package/dist/lock.js

@@ -1,17 +1,7 @@
+import { RebuildAlreadyRunning } from '@lde/search';
 const LOCK_COLLECTION = 'rebuild_locks';
 /** A held lock older than this (ms) is reclaimed. */
 export const DEFAULT_LOCK_TTL_MS = 10 * 60 * 1000;
-/**
- * Another run already holds the index’s rebuild lock, so this run refuses to
- * open. Rebuilds are single-flight per index across pods; catch this to treat
- * a concurrent rebuild as a graceful skip rather than a failure.
- */
-export class RebuildAlreadyRunning extends Error {
-    constructor(name) {
-        super(`Another rebuild of “${name}” is already running`);
-        this.name = 'RebuildAlreadyRunning';
-    }
-}
 /**
  * Open a run under the index’s single-flight lock: acquire it (throwing
  * {@link RebuildAlreadyRunning} when another rebuild holds it), run the
@@ -111,7 +101,8 @@ export async function ensureCollectionExists(client, name, schema) {
         return false;
     }
 }
-/** Take over the lock if its holder has not refreshed it within `ttlMs`. */
+/** Take over the lock if it was acquired more than `ttlMs` ago. Nothing
+ *  refreshes a held lock, so a run outliving the TTL can lose it. */
 async function reclaimIfStale(client, name, ttlMs) {
     let held;
     try {

package/dist/rebuild-requests.d.ts

@@ -0,0 +1,25 @@
+import type { Client } from 'typesense';
+import type { RebuildRequests } from '@lde/search/adapter';
+/**
+ * An index’s rebuild requests ({@link RebuildRequests}) in Typesense, for
+ * `requestRebuild` from `@lde/search`: one document per index in a `rebuild_requests`
+ * collection, created on demand, holding a random id that each request
+ * replaces.
+ *
+ * Pass the same `name` the index’s rebuild writer locks on – its
+ * `collectionName`. The requests live apart from the `rebuild_locks`
+ * collection because releasing a lock deletes its document, and a request has
+ * to outlive the release: the run holding the lock reads it afterwards.
+ */
+export declare class TypesenseRebuildRequests implements RebuildRequests {
+    private readonly client;
+    private readonly name;
+    constructor(client: Client, name: string);
+    /** Record a new request for the index, creating the `rebuild_requests`
+     *  collection on the first request ever. */
+    record(): Promise<void>;
+    /** The index’s latest request id, or `undefined` when none was recorded. */
+    latest(): Promise<string | undefined>;
+    private documents;
+}
+//# sourceMappingURL=rebuild-requests.d.ts.map

package/dist/rebuild-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-requests.d.ts","sourceRoot":"","sources":["../src/rebuild-requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;IAG/B;gDAC4C;IACtC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB7B,4EAA4E;IACtE,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAgB3C,OAAO,CAAC,SAAS;CAGlB"}

package/dist/rebuild-requests.js

@@ -0,0 +1,60 @@
+import { ensureCollectionExists, httpStatus } from './lock.js';
+const REQUEST_COLLECTION = 'rebuild_requests';
+/**
+ * An index’s rebuild requests ({@link RebuildRequests}) in Typesense, for
+ * `requestRebuild` from `@lde/search`: one document per index in a `rebuild_requests`
+ * collection, created on demand, holding a random id that each request
+ * replaces.
+ *
+ * Pass the same `name` the index’s rebuild writer locks on – its
+ * `collectionName`. The requests live apart from the `rebuild_locks`
+ * collection because releasing a lock deletes its document, and a request has
+ * to outlive the release: the run holding the lock reads it afterwards.
+ */
+export class TypesenseRebuildRequests {
+    client;
+    name;
+    constructor(client, name) {
+        this.client = client;
+        this.name = name;
+    }
+    /** Record a new request for the index, creating the `rebuild_requests`
+     *  collection on the first request ever. */
+    async record() {
+        const request = { id: this.name, request: crypto.randomUUID() };
+        try {
+            await this.documents().upsert(request);
+        }
+        catch (error) {
+            if (httpStatus(error) !== 404) {
+                throw error;
+            }
+            // First request ever: the collection does not exist yet.
+            await ensureCollectionExists(this.client, REQUEST_COLLECTION, () => ({
+                name: REQUEST_COLLECTION,
+                fields: [{ name: 'request', type: 'string' }],
+            }));
+            await this.documents().upsert(request);
+        }
+    }
+    /** The index’s latest request id, or `undefined` when none was recorded. */
+    async latest() {
+        try {
+            const { request } = (await this.client
+                .collections(REQUEST_COLLECTION)
+                .documents(this.name)
+                .retrieve());
+            return request;
+        }
+        catch (error) {
+            // No request recorded for this index, or none for any index yet.
+            if (httpStatus(error) === 404) {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    documents() {
+        return this.client.collections(REQUEST_COLLECTION).documents();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lde/search-typesense",
-  "version": "0.38.5",
+  "version": "0.39.0",
   "description": "Typesense implementation of the @lde/search SearchEngine port: collection-schema builder, query compiler, label-resolving result reconstruction, and blue/green index lifecycle. Engine-specific (Typesense) but domain-agnostic.",
   "repository": {
     "url": "git+https://github.com/ldelements/lde.git",
@@ -25,7 +25,7 @@
     "!**/*.tsbuildinfo"
   ],
   "dependencies": {
-    "@lde/search": "^0.32.3",
+    "@lde/search": "^0.33.0",
     "@lde/text-normalization": "^0.2.0",
     "tslib": "^2.3.0",
     "typesense": "^3.1.1"