@prose-reader/metadata-fetcher 1.339.0 → 1.341.0

package/dist/types/match.d.ts

@@ -3,11 +3,11 @@ import { ResolvedMetadata } from '@prose-reader/archive-reader';
  * The fields the matcher compares — only ever when **both** sides state one,
  * so what the query doesn't know cannot count against a candidate.
  */
-export type MetadataMatchField = "isbn" | "gtin" | "identifiers" | "title" | "contributors" | "series" | "publisher" | "published" | "languages" | "numberOfPages";
+export type MetadataMatchField = "isbn" | "gtin" | "identifiers" | "title" | "contributors" | "series" | "publication.original.date" | "publication.original.publisher" | "publication.edition.date" | "publication.edition.publisher" | "languages" | "numberOfPages";
 /**
  * One field comparison. The compared values sit next to the score so a match
- * is explainable to a user — "same title, different publisher" — without
- * re-deriving anything.
+ * is explainable to a user — "same title, different edition publisher" —
+ * without re-deriving anything.
  */
 export type MetadataMatchSignal = {
     readonly field: MetadataMatchField;
@@ -28,17 +28,16 @@ export type MetadataMatch = {
     readonly providerId: string;
     /**
      * Aggregate confidence, `0` to `1`: the weight-averaged score of every
-     * comparable field — except when both sides state an identifier, which
-     * settles it outright: `1` if it agrees (an ISBN/GTIN match *is* the book),
-     * `0` if it contradicts. `0` too when the two sides had no field in common
-     * to compare.
+     * comparable field — except when an ISBN, GTIN or shared scheme-scoped
+     * identifier confirms identity, which settles it at `1`. A contradictory
+     * ISBN or GTIN settles it at `0`. `0` too when the two sides had no field in
+     * common to compare.
      */
     readonly score: number;
     readonly signals: ReadonlyArray<MetadataMatchSignal>;
     /**
-     * Reached `minScore`, and so contributed to the merged
-     * `FetchedMetadata.metadata`. Rejected matches are kept and ranked, for a
-     * consumer to offer for manual confirmation.
+     * Reached `minScore`. Rejected matches are kept and ranked, for a consumer
+     * to offer for manual confirmation.
      */
     readonly accepted: boolean;
     readonly metadata: ResolvedMetadata;

package/dist/utils/hasSearchTerms.d.ts

@@ -1,7 +1,7 @@
 import { ResolvedMetadata } from '@prose-reader/archive-reader';
 /**
  * Whether a catalog has anything to go on, so a lookup with nothing to ask
- * about costs no round trip. Descriptive fields alone — a publisher, a
- * language, a page count — narrow a search but cannot start one.
+ * about costs no round trip. Publication details, a language, or a page count
+ * narrow a search but cannot start one.
  */
 export declare const hasSearchTerms: (metadata: ResolvedMetadata) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prose-reader/metadata-fetcher",
-  "version": "1.339.0",
+  "version": "1.341.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -29,8 +29,9 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@prose-reader/archive-reader": "^1.339.0",
-    "@prose-reader/shared": "^1.339.0"
+    "@prose-reader/archive-reader": "^1.341.0",
+    "@prose-reader/shared": "^1.341.0",
+    "xmldoc": "^2.0.0"
   },
-  "gitHead": "6f3954f75cc72da91902eb091d5600575f6eaabb"
+  "gitHead": "620bf290b88f12f2313f7b19aa4d4abdcf124ef1"
 }

package/dist/merge/mergeResolvedMetadata.d.ts

@@ -1,21 +0,0 @@
-import { ResolvedMetadata } from '@prose-reader/archive-reader';
-/**
- * Merges several {@link ResolvedMetadata} into one, **first defined wins**.
- * Precedence is the caller's — pass the sources in the order you trust them.
- *
- * ```ts
- * // the book over the catalogs, catalogs filling the gaps
- * const metadata = mergeResolvedMetadata(resolved.metadata, fetched.metadata)
- * ```
- *
- * Field-wise rather than object-wise, so a source knowing only a cover
- * contributes it without hiding another's title. Two fields are additive
- * instead: `identifiers` concatenate (deduped on scheme + value, mirroring
- * `resolveMetadata`), and `belongsTo` merges `series` and `collection`
- * independently.
- *
- * Everything else takes the first stated value whole. Unioning keyword lists
- * across catalogs is a judgement call for the consumer, not for a merge that
- * has to stay predictable.
- */
-export declare const mergeResolvedMetadata: (...entries: ReadonlyArray<ResolvedMetadata | undefined>) => ResolvedMetadata;

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

@@ -1,15 +0,0 @@
-import { ResolvedMetadata } from '@prose-reader/archive-reader';
-export type OpenLibraryProjectGutenbergLookup = {
-    readonly id: string;
-    /** The book's exact identifier spelling, echoed only after OL confirms it. */
-    readonly identifier: {
-        readonly value: string;
-        readonly scheme?: string;
-    };
-};
-/**
- * Open Library-specific crosswalk: its `id_project_gutenberg` search field
- * stores the numeric id encoded by official Gutenberg URLs. Other providers
- * own their own identifier conventions; this is intentionally not generic.
- */
-export declare const projectGutenbergLookupFromMetadata: (metadata: ResolvedMetadata) => OpenLibraryProjectGutenbergLookup | undefined;