@prose-reader/metadata-fetcher 1.347.0 → 1.349.0

package/dist/match/similarity.d.ts

@@ -8,6 +8,12 @@ export declare const normalizeForComparison: (value: string) => string;
  * `Spider Man` stay exact.
  */
 export declare const textSimilarity: (a: string, b: string) => number;
+/**
+ * Every volume, part or book number a title states explicitly, whichever
+ * division word introduced it — a catalog states the same fact as a series
+ * `position`, where the division word is implicit.
+ */
+export declare const titleDivisionNumbers: (value: string) => ReadonlySet<number>;
 /**
  * {@link textSimilarity}, with `Dune` matched against `Dune: a novel`.
  *
@@ -18,5 +24,18 @@ export declare const textSimilarity: (a: string, b: string) => number;
  * sides state different ones, the title score is `0` however similar the rest.
  */
 export declare const titleSimilarity: (a: string, b: string) => number;
+/**
+ * The best {@link titleSimilarity} over the forms one candidate title takes —
+ * bare, or composed with its subtitle.
+ *
+ * A contradiction in **any** form still scores `0`: `Irina` agreeing with
+ * `Irina: … Vol. 2` is not evidence that the candidate's own `Vol. 1` does.
+ * Taking the plain maximum would let the shorter form launder a stated
+ * disagreement about which volume this is.
+ */
+export declare const bestTitleSimilarity: (query: string, forms: ReadonlyArray<string>) => {
+    readonly score: number;
+    readonly candidate: string;
+} | undefined;
 /** {@link textSimilarity} on sorted tokens: `Herbert, Frank` ≡ `Frank Herbert`. */
 export declare const personNameSimilarity: (a: string, b: string) => number;

package/dist/providers/googleBooks/parse.d.ts

@@ -10,8 +10,18 @@ export type GoogleBooksImageLinks = {
     readonly large?: string;
     readonly extraLarge?: string;
 };
+export type GoogleBooksVolumeSeries = {
+    readonly seriesId?: string;
+    readonly orderNumber?: number;
+};
+/**
+ * Only the volume's place in its series is retained. `bookDisplayNumber` and
+ * `shortSeriesBookTitle` are display strings by Google's own definition — the
+ * sequence is `orderNumber` — and the payload never states the series name,
+ * only an id, so a name would have to be invented.
+ */
 export type GoogleBooksSeriesInfo = {
-    readonly bookDisplayNumber?: string;
+    readonly volumeSeries?: ReadonlyArray<GoogleBooksVolumeSeries>;
 };
 /**
  * The subset of a Google Books `volumeInfo` record that has a normalized home.

package/dist/providers/openLibrary/resolve.d.ts

@@ -11,9 +11,10 @@ export declare const OPEN_LIBRARY_IDENTIFIER_SCHEME = "OpenLibrary";
  * Normalizes one search hit into the cross-format vocabulary. Two choices
  * worth stating:
  *
- * - **`title` folds in `subtitle`** (`Dune: Messiah`): the vocabulary has one
- *   title field, and an OPF `dc:title` normally carries the subtitle too, so
- *   comparing a bare title against a full one would cost match score.
+ * - **`title` and `subtitle` stay separate**, as the catalog states them:
+ *   `title` is the work's title and the subtitle is a `titles` entry. The
+ *   matcher composes them when it compares, so nothing is lost by not
+ *   pre-joining them here.
  * - **An ISBN identifier is added only for an ISBN lookup**, using the queried
  *   value — the API answered "this work has that ISBN", a fact about the
  *   record. A title-search hit describes a *work*, whose editions each have

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prose-reader/metadata-fetcher",
-  "version": "1.347.0",
+  "version": "1.349.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -29,9 +29,9 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@prose-reader/archive-reader": "^1.347.0",
-    "@prose-reader/shared": "^1.347.0",
+    "@prose-reader/archive-reader": "^1.349.0",
+    "@prose-reader/shared": "^1.349.0",
     "xmldoc": "^2.0.0"
   },
-  "gitHead": "a5e60d258dbed8d4e2a4bed78680c3b9b3455418"
+  "gitHead": "0383cfd805d43fa941c54639b170b54ab9d4ac43"
 }