@prose-reader/metadata-fetcher 1.346.0 → 1.348.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/googleBooks/resolve.d.ts

@@ -1,28 +1,6 @@
 import { MetadataIdentifier, ResolvedMetadata } from '@prose-reader/archive-reader';
 import { GoogleBooksImageLinks, GoogleBooksVolume } from './parse.ts';
 export declare const GOOGLE_BOOKS_MAX_SUBJECTS = 25;
-/** Compile-enforced homes for the top-level Volume resource fields. */
-export declare const googleBooksVolumeMetadataHomes: {
-    id: "identifiers";
-    volumeInfo: "metadata";
-};
-/** Compile-enforced map from every parsed Google Books field to its home. */
-export declare const googleBooksVolumeInfoMetadataHomes: {
-    title: "titles";
-    subtitle: "titles";
-    authors: "contributors";
-    publisher: "publication.edition.publisher";
-    publishedDate: "publication.edition.date";
-    description: "description";
-    industryIdentifiers: "identifiers";
-    pageCount: "numberOfPages";
-    categories: "subjects";
-    language: "languages";
-    imageLinks: "cover";
-    infoLink: "candidate.url";
-    canonicalVolumeLink: "candidate.url";
-    seriesInfo: "titles";
-};
 /**
  * Prefer the largest cover Google announced and force HTTPS. Preserve the
  * query exactly: changing Google's `zoom`, `edge` or signed `imgtk` parameters

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

@@ -6,32 +6,15 @@ import { OpenLibraryDoc } from './parse.ts';
  * consumer persists. The API puts the meaningful ones first.
  */
 export declare const OPEN_LIBRARY_MAX_SUBJECTS = 25;
-/**
- * Where every {@link OpenLibraryDoc} field lands in {@link ResolvedMetadata},
- * compile-enforced: adding a field to the parser without declaring its home is
- * a type error. The archive parsers' losslessness contract, and the mapping
- * documentation.
- */
-export declare const openLibraryMetadataHomes: {
-    readonly key: "identifiers";
-    readonly title: "titles";
-    readonly subtitle: "titles";
-    readonly author_name: "contributors";
-    readonly first_publish_year: "publication.original.date";
-    readonly language: "languages";
-    readonly subject: "subjects";
-    readonly number_of_pages_median: "numberOfPages";
-    readonly cover_i: "cover";
-    readonly id_project_gutenberg: "identifiers";
-};
 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/dist/providers/projectGutenberg/resolve.d.ts

@@ -1,22 +1,6 @@
 import { MetadataIdentifier, ResolvedMetadata } from '@prose-reader/archive-reader';
 import { ProjectGutenbergRecord } from './parse.ts';
 export declare const PROJECT_GUTENBERG_MAX_SUBJECTS = 25;
-/** Compile-enforced map from every parsed RDF field to its resolved home. */
-export declare const projectGutenbergMetadataHomes: {
-    readonly id: "identifiers";
-    readonly title: "titles";
-    readonly publisher: "publication.edition.publisher";
-    readonly issued: "publication.edition.date";
-    readonly originalPublication: "publication.original";
-    readonly rights: "rights";
-    readonly description: "description";
-    readonly summary: "description";
-    readonly languages: "languages";
-    readonly subjects: "subjects";
-    readonly bookshelves: "subjects";
-    readonly contributors: "contributors";
-    readonly cover: "cover";
-};
 export declare const resolveProjectGutenbergRecord: (record: ProjectGutenbergRecord, options: {
     readonly baseUrl: string;
     readonly matchedIdentifier: MetadataIdentifier;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prose-reader/metadata-fetcher",
-  "version": "1.346.0",
+  "version": "1.348.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.346.0",
-    "@prose-reader/shared": "^1.346.0",
+    "@prose-reader/archive-reader": "^1.348.0",
+    "@prose-reader/shared": "^1.348.0",
     "xmldoc": "^2.0.0"
   },
-  "gitHead": "4c52e5b82de55cf26d658f039909829b4476fd2b"
+  "gitHead": "13868ec22f78718ba0673f4de39a940287145c40"
 }