@lde/search-pipeline 0.9.0 → 0.10.0

package/dist/search-index-writer.d.ts

@@ -1,18 +1,19 @@
 import { type Writer } from '@lde/pipeline';
-import type { SearchDocument, SearchSchema, SearchType } from '@lde/search';
+import type { RootType, SearchDocument, SearchSchema } from '@lde/search';
 import type { TypedSearchDocument } from './typed-search-document.js';
 /** Options for {@link searchIndexWriter}. */
 export interface SearchIndexWriterOptions {
     /**
-     * The declarative schema: one {@link SearchType} per root type. The writer
-     * opens one engine run per type in it and routes each document to its type’s
-     * run. Must be the same schema the stages project through.
+     * The declarative schema: one {@link RootType} per collection. The writer
+     * opens one engine run per Root Type in it and routes each document to its
+     * type’s run. Reference Types are absent from `schema.values()`, so none ever
+     * earns a run. Must be the same schema the stages project through.
      */
     schema: SearchSchema;
     /**
      * The engine writer that owns a given root type’s collection – e.g. a
      * `@lde/search-typesense` `BlueGreenRebuild` bound to that type and the
-     * collection name it keeps its alias on. Called once per {@link SearchType}
+     * collection name it keeps its alias on. Called once per {@link RootType}
      * in the schema when the writer is built.
      *
      * A single-collection deployment returns one writer for its one type; a
@@ -22,7 +23,7 @@ export interface SearchIndexWriterOptions {
      * own collection, alias and cross-pod lock. The per-collection fan-out is this
      * writer’s job.
      */
-    writerFor: (searchType: SearchType) => Writer<SearchDocument>;
+    writerFor: (searchType: RootType) => Writer<SearchDocument>;
 }
 /**
  * The single terminal of a search-indexing pipeline: an engine-agnostic router

package/dist/search-index-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-index-writer.d.ts","sourceRoot":"","sources":["../src/search-index-writer.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,mBAAmB,CAAC,CAoI7B"}
+{"version":3,"file":"search-index-writer.d.ts","sourceRoot":"","sources":["../src/search-index-writer.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,SAAS,EAAE,CAAC,UAAU,EAAE,QAAQ,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,mBAAmB,CAAC,CAoI7B"}

package/dist/search-stages.d.ts

@@ -1,15 +1,16 @@
 import { Stage, type ItemSelector, type StageReaders } from '@lde/pipeline';
-import { type SearchSchema, type SearchType } from '@lde/search';
+import { type RootType, type SearchSchema } from '@lde/search';
 import type { TypedSearchDocument } from './typed-search-document.js';
 /** One root type’s stage in a search pipeline. */
 export interface SearchStageType {
     /**
-     * The {@link SearchType} this stage projects. Must belong to
+     * The {@link RootType} this stage projects. Must belong to
      * {@link SearchStagesOptions.schema} (matched by `class`); the stage projects
      * with the schema’s own declaration object, so `assertTypeInSchema`’s identity
-     * check inside {@link projectRoots} always holds.
+     * check inside {@link projectRoots} always holds. A Reference Type is never a
+     * stage: it is reached only through an inline reference, never selected.
      */
-    searchType: SearchType;
+    searchType: RootType;
     /**
      * The selector variable that binds this type’s roots – the CONSTRUCT subject
      * the batch is complete for. Must **not** be `dataset`: `?dataset` is
@@ -68,7 +69,7 @@ export declare function searchStages(options: SearchStagesOptions): Stage<TypedS
 /**
  * An {@link ItemSelector} that selects every instance of a root type’s source
  * class: `SELECT ?‹rootVariable› WHERE { ?‹rootVariable› a <class> }`. A
- * convenience for the **object grain**, where {@link SearchType.class} really is
+ * convenience for the **object grain**, where {@link RootType.class} really is
  * the source class – **not** a default: root selection is a deployment concern,
  * and three of the Dataset Register’s four catalog types have no source class at
  * all (their entry point – “registered, newest registration, has a title” – is a
@@ -78,5 +79,5 @@ export declare function searchStages(options: SearchStagesOptions): Stage<TypedS
  * {@link SearchStageType.rootVariable}; it must not be `dataset` (reserved by the
  * SPARQL reader).
  */
-export declare function selectByClass(searchType: SearchType, rootVariable?: string): ItemSelector;
+export declare function selectByClass(searchType: RootType, rootVariable?: string): ItemSelector;
 //# sourceMappingURL=search-stages.d.ts.map

package/dist/search-stages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-stages.d.ts","sourceRoot":"","sources":["../src/search-stages.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAgB,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,UAAU,EAAE,UAAU,CAAC;IACvB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,YAAY,EAAE,YAAY,CAAC;IAC3B,yDAAyD;IACzD,OAAO,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB,4DAA4D;IAC5D,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAC3B,KAAK,CAAC,mBAAmB,CAAC,EAAE,CA8C9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,YAAY,SAAS,GACpB,YAAY,CAId"}
+{"version":3,"file":"search-stages.d.ts","sourceRoot":"","sources":["../src/search-stages.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,UAAU,EAAE,QAAQ,CAAC;IACrB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,YAAY,EAAE,YAAY,CAAC;IAC3B,yDAAyD;IACzD,OAAO,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB,4DAA4D;IAC5D,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAC3B,KAAK,CAAC,mBAAmB,CAAC,EAAE,CA8C9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,QAAQ,EACpB,YAAY,SAAS,GACpB,YAAY,CAId"}

package/dist/search-stages.js

@@ -55,7 +55,7 @@ export function searchStages(options) {
 /**
  * An {@link ItemSelector} that selects every instance of a root type’s source
  * class: `SELECT ?‹rootVariable› WHERE { ?‹rootVariable› a <class> }`. A
- * convenience for the **object grain**, where {@link SearchType.class} really is
+ * convenience for the **object grain**, where {@link RootType.class} really is
  * the source class – **not** a default: root selection is a deployment concern,
  * and three of the Dataset Register’s four catalog types have no source class at
  * all (their entry point – “registered, newest registration, has a title” – is a

package/dist/typed-search-document.d.ts

@@ -1,6 +1,6 @@
-import type { SearchDocument, SearchType } from '@lde/search';
+import type { RootType, SearchDocument } from '@lde/search';
 /**
- * A projected {@link SearchDocument} paired with the {@link SearchType} it was
+ * A projected {@link SearchDocument} paired with the {@link RootType} it was
  * projected from.
  *
  * A search pipeline is N per-type stages writing to one terminal, and
@@ -17,7 +17,7 @@ import type { SearchDocument, SearchType } from '@lde/search';
  * ([ADR 13](https://github.com/ldelements/lde/blob/main/docs/decisions/0013-project-inside-the-batch-per-root-type.md)).
  */
 export interface TypedSearchDocument {
-    readonly searchType: SearchType;
+    readonly searchType: RootType;
     readonly document: SearchDocument;
 }
 //# sourceMappingURL=typed-search-document.d.ts.map

package/dist/typed-search-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-search-document.d.ts","sourceRoot":"","sources":["../src/typed-search-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC"}
+{"version":3,"file":"typed-search-document.d.ts","sourceRoot":"","sources":["../src/typed-search-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lde/search-pipeline",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Search indexing as an @lde/pipeline instance: a Writer<Quad> that applies the @lde/search projection to extracted RDF and fans each document out to the transactional engine writer for its type's collection. Glue between the pipeline quad world and the search-engine document world; owns no projection or engine logic itself.",
   "repository": {
     "url": "git+https://github.com/ldelements/lde.git",
@@ -25,11 +25,11 @@
     "!**/*.tsbuildinfo"
   ],
   "dependencies": {
-    "@lde/search": "^0.10.0",
+    "@lde/search": "^0.11.0",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
-    "@lde/search-typesense": "^0.12.0",
+    "@lde/search-typesense": "^0.13.0",
     "@rdfjs/types": "^2.0.1",
     "n3": "^2.1.1",
     "testcontainers": "^12.0.3",