rewind-mcp-server 0.10.0 → 1.0.0

package/dist/tools/schemas/collecting.js

@@ -0,0 +1,108 @@
+/**
+ * Output schemas for the collecting-domain tools (issue #105).
+ *
+ * These schemas are the source of truth for the collecting tools' return
+ * shapes: `collecting.ts` derives its `VinylItem` / `MediaItem` /
+ * `CollectingStats` types from them via `z.infer`, so the declared schema
+ * and the TypeScript type cannot drift.
+ *
+ * Every object schema uses `.passthrough()` so the JSON Schema advertised
+ * to clients stays `additionalProperties`-open -- a field the Rewind API
+ * adds later does not break client-side validation. See schemas/shared.ts.
+ */
+import { z } from 'zod';
+import { imageSchema, paginationSchema } from './shared.js';
+// --- Element schemas ------------------------------------------------------
+/** A single vinyl/CD/cassette record, as listed by get_vinyl_collection. */
+export const vinylItemSchema = z
+    .object({
+    id: z.number(),
+    discogs_id: z.number(),
+    title: z.string(),
+    artists: z.array(z.string()),
+    year: z.number().nullable(),
+    format: z.string(),
+    format_detail: z.string(),
+    label: z.string(),
+    genres: z.array(z.string()),
+    styles: z.array(z.string()),
+    image: imageSchema(),
+    date_added: z.string().nullable(),
+    rating: z.number().nullable(),
+    discogs_url: z.string().nullable(),
+})
+    .passthrough();
+/** A single physical-media item, as listed by get_physical_media. */
+export const mediaItemSchema = z
+    .object({
+    id: z.number(),
+    title: z.string(),
+    year: z.number().nullable(),
+    tmdb_id: z.number().nullable(),
+    imdb_id: z.string().nullable(),
+    image: imageSchema(),
+    runtime: z.number().nullable(),
+    tmdb_rating: z.number().nullable(),
+    media_type: z.string(),
+    resolution: z.string().nullable(),
+    hdr: z.string().nullable(),
+    audio: z.string().nullable(),
+    audio_channels: z.string().nullable(),
+    collected_at: z.string().nullable(),
+})
+    .passthrough();
+// --- Tool output schemas --------------------------------------------------
+/**
+ * outputSchema for get_vinyl_collection. The empty-state branch returns
+ * `{ items: [], pagination }`, which satisfies the same schema -- no union
+ * needed.
+ */
+export const vinylCollectionOutputSchema = z
+    .object({
+    items: z.array(vinylItemSchema),
+    pagination: paginationSchema(),
+})
+    .passthrough();
+/**
+ * outputSchema for get_collecting_stats (flat stats object passed through
+ * verbatim from the API). `most_collected_artist` is an open-shaped field
+ * the API may fill with an artist object or leave null -- typed as
+ * unknown/nullable so it never blocks validation.
+ */
+export const collectingStatsOutputSchema = z
+    .object({
+    total_items: z.number(),
+    by_format: z.record(z.number()),
+    wantlist_count: z.number().nullable(),
+    unique_artists: z.number().nullable(),
+    estimated_value: z.number().nullable(),
+    top_genre: z.string().nullable(),
+    oldest_release_year: z.number().nullable(),
+    newest_release_year: z.number().nullable(),
+    most_collected_artist: z.unknown(),
+    added_this_year: z.number().nullable(),
+})
+    .passthrough();
+/**
+ * outputSchema for get_physical_media. The empty-state branch returns
+ * `{ items: [], pagination }`, which satisfies the same schema -- no union
+ * needed.
+ */
+export const physicalMediaOutputSchema = z
+    .object({
+    items: z.array(mediaItemSchema),
+    pagination: paginationSchema(),
+})
+    .passthrough();
+/**
+ * outputSchema for get_physical_media_stats. The tool builds a transformed
+ * payload -- `total` is computed from the per-format counts, `formats` is
+ * the raw API list.
+ */
+export const physicalMediaStatsOutputSchema = z
+    .object({
+    total: z.number(),
+    formats: z.array(z.object({ name: z.string(), count: z.number() }).passthrough()),
+})
+    .passthrough();
+//# sourceMappingURL=collecting.js.map

package/dist/tools/schemas/collecting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collecting.js","sourceRoot":"","sources":["../../../src/tools/schemas/collecting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE5D,6EAA6E;AAE7E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,WAAW,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,WAAW,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,6EAA6E;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,UAAU,EAAE,gBAAgB,EAAE;CAC/B,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE;IAClC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,UAAU,EAAE,gBAAgB,EAAE;CAC/B,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAChE;CACF,CAAC;KACD,WAAW,EAAE,CAAC"}