@zivue/zuuid 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+- Added provider-stable ZUUID generation using UUID v5.
+- Added flat `ZuuidData` model with source metadata and provenance.
+- Added shared lightweight list item shape for search results, relations, and recommendations.
+- Added TMDB provider support for movies, TV shows, and people.
+- Added TMDB fetch, raw source-record fetch, transform, unified search, and raw search APIs.
+- Added TMDB fetch and search CLI examples for local testing.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zivue
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,368 @@
+# @zivue/zuuid
+
+TypeScript helpers for fetching, searching, and transforming Zuuid datasets.
+
+Zuuid is the metadata, search, and indexing substrate for Zivue/Stareto. This package focuses on the client-side model: provider-stable UUIDs, source records, and normalized Zuuid datasets.
+
+Storage, caching, object keys, and persistence belong in a layer outside this package.
+
+## Install
+
+```sh
+npm install @zivue/zuuid
+```
+
+## Quick Start
+
+```ts
+import { createZuuidClient } from "@zivue/zuuid";
+
+const zuuid = createZuuidClient({
+  providers: {
+    tmdb: {
+      bearerToken: process.env.TMDB_BEARER_TOKEN!
+    }
+  }
+});
+
+const search = await zuuid.movie.tmdb?.search({ query: "Fight Club" });
+const selected = search?.results[0];
+const movie = selected ? await zuuid.movie.tmdb?.fetch({ id: selected.source.value }) : undefined;
+
+console.log(movie?.zuuid);
+```
+
+## Generate A ZUUID
+
+Zuuid generation is UUID v5:
+
+```txt
+uuid_v5(provider_namespace, "<normalized-category>:<external_id>")
+```
+
+```ts
+import { providerZuuid } from "@zivue/zuuid";
+
+const zuuid = await providerZuuid({
+  provider: "tmdb",
+  category: "movie",
+  externalId: "550"
+});
+
+console.log(zuuid);
+// 1706d641-d381-5618-9425-d8cd8b35f898
+```
+
+`category` is trimmed and lowercased. `externalId` is trimmed but otherwise preserved.
+
+## Zuuid Dataset
+
+```ts
+import { createZuuidData } from "@zivue/zuuid";
+
+const dataset = createZuuidData({
+  zuuid: "1706d641-d381-5618-9425-d8cd8b35f898",
+  category: "movie",
+  primaryTitle: "Fight Club"
+});
+```
+
+The dataset shape is intentionally flat:
+
+```ts
+type ZuuidData = {
+  zuuid: string;
+  kind: EntityKind;
+  category: string;
+  primaryTitle: string;
+  primaryDate?: string;
+  rating?: number;
+  cover?: string;
+  aliases: Alias[];
+  descriptions: Description[];
+  details: Detail[];
+  media: MediaAsset[];
+  relations: EntityRelation[];
+  recommendations: RecommendationEdge[];
+  tags: string[];
+  externalIds: ExternalId[];
+  provenance: Provenance[];
+};
+```
+
+Search results, relations, and recommendations use the same lightweight list item fields: `id`, `zuuid`, `category`, `title`, `date`, `cover`, `rating`, `weight`, `relationType`, `attribute`, and `order`. That lets transformed datasets and search results carry useful related-entity context before those related entities are fetched as full Zuuid datasets.
+
+Backend-only concerns such as record versions, flags, review state, index state, and object-store metadata are intentionally not part of this package's dataset shape.
+
+## Source Metadata
+
+Source records are provider records before they are transformed into canonical entities. They carry the external provider key, raw JSON payload, content hash, and observation timestamps.
+
+```ts
+import { attachSourceMetadata, createSourceRecord } from "@zivue/zuuid";
+
+const source = await createSourceRecord({
+  source: { provider: "tmdb", category: "movie", externalId: "550" },
+  payload: { title: "Fight Club" },
+  observedAt: "2026-05-21T00:00:00.000Z"
+});
+
+const withSource = attachSourceMetadata(dataset, source);
+```
+
+`attachSourceMetadata` returns a new dataset with `externalIds` and `provenance` updated.
+
+## TMDB Movies, TV, And People
+
+The first provider module supports fetching and transforming TMDB movies, TV shows, and people.
+
+| Provider | Category | Search | Fetch | Transform |
+| --- | --- | --- | --- | --- |
+| TMDB | movie | yes | yes | yes |
+| TMDB | tv | yes | yes | yes |
+| TMDB | person | yes | yes | yes |
+
+```ts
+import { TmdbProvider } from "@zivue/zuuid/providers/tmdb";
+
+const tmdb = new TmdbProvider({
+  bearerToken: process.env.TMDB_BEARER_TOKEN!
+});
+
+const movie = await tmdb.fetchMovie({ id: 550 });
+const tv = await tmdb.fetchTv({ id: 1399 });
+const person = await tmdb.fetchPerson({ id: 287 });
+
+console.log(movie?.zuuid);
+// 1706d641-d381-5618-9425-d8cd8b35f898
+```
+
+You can also split fetching from transformation:
+
+```ts
+import { TmdbProvider, transformTmdbMovie, transformTmdbPerson, transformTmdbTv } from "@zivue/zuuid/providers/tmdb";
+
+const source = await tmdb.fetchMovieSourceRecord({ id: 550 });
+const movie = source ? await transformTmdbMovie(source) : undefined;
+
+const tvSource = await tmdb.fetchTvSourceRecord({ id: 1399 });
+const tv = tvSource ? await transformTmdbTv(tvSource) : undefined;
+
+const personSource = await tmdb.fetchPersonSourceRecord({ id: 287 });
+const person = personSource ? await transformTmdbPerson(personSource) : undefined;
+```
+
+Search returns unified lightweight candidates. Use search to find candidate IDs, then fetch the selected item for the full transformed dataset:
+
+```ts
+const movies = await tmdb.searchMovies({ query: "Fight Club" });
+const tvShows = await tmdb.searchTv({ query: "Game of Thrones" });
+const people = await tmdb.searchPeople({ query: "Brad Pitt" });
+
+console.log(movies.pagination);
+// { page: 1, totalPages: 10, totalResults: 190 }
+
+const selectedMovie = movies.results[0];
+console.log(selectedMovie);
+// {
+//   id: "1706d641-d381-5618-9425-d8cd8b35f898",
+//   zuuid: "1706d641-d381-5618-9425-d8cd8b35f898",
+//   category: "movie",
+//   title: "Fight Club",
+//   date: "1999-10-15",
+//   cover: "https://image.tmdb.org/t/p/w500/...",
+//   rating: 8.4,
+//   weight: 20.0,
+//   relationType: null,
+//   attribute: null,
+//   order: null,
+//   source: { source: "tmdb", category: "movie", value: "550" }
+// }
+
+const fullMovie = selectedMovie ? await tmdb.fetchMovie({ id: selectedMovie.source.value }) : undefined;
+```
+
+Raw search source records are also available:
+
+```ts
+const rawMovies = await tmdb.searchMovieSourceRecords({ query: "Fight Club" });
+```
+
+Category-specific imports are also available:
+
+```ts
+import { transformTmdbMovie } from "@zivue/zuuid/providers/tmdb/movie";
+import { transformTmdbTv } from "@zivue/zuuid/providers/tmdb/tv";
+import { transformTmdbPerson } from "@zivue/zuuid/providers/tmdb/person";
+```
+
+`TmdbProvider` accepts either `{ bearerToken }` or `{ apiKey }`. TMDB bearer tokens are API Read Access Tokens and usually start with `eyJ...`; v3 API keys are shorter hex-like strings.
+
+## Client Instantiation
+
+For applications with multiple providers, use `createZuuidClient` to wire provider config once:
+
+```ts
+import { createZuuidClient } from "@zivue/zuuid";
+
+const zuuid = createZuuidClient({
+  providers: {
+    tmdb: {
+      bearerToken: process.env.TMDB_BEARER_TOKEN!
+    }
+    // Future movie providers can sit beside tmdb, e.g. omdb.
+  }
+});
+
+const movie = await zuuid.movie.tmdb?.fetch({ id: 550 });
+const tv = await zuuid.tv.tmdb?.fetch({ id: 1399 });
+const person = await zuuid.people.tmdb?.fetch({ id: 287 });
+```
+
+The config is provider-keyed because apps usually manage credentials per provider. The client facade is category-first, so multiple movie providers can live under `zuuid.movie`:
+
+```ts
+zuuid.movie.tmdb?.fetch({ id: 550 });
+zuuid.tv.tmdb?.fetch({ id: 1399 });
+zuuid.people.tmdb?.fetch({ id: 287 });
+
+zuuid.movie.tmdb?.search({ query: "Fight Club" });
+zuuid.tv.tmdb?.search({ query: "Game of Thrones" });
+zuuid.people.tmdb?.search({ query: "Brad Pitt" });
+// later: zuuid.movie.omdb?.fetch(...)
+```
+
+The client is stateless: it does not cache, persist, schedule, or read environment variables. It only closes over provider configuration and exposes category/provider methods.
+
+## API
+
+## Package Structure
+
+The source is split by Zuuid responsibility:
+
+- `identity.ts`: provider namespaces and UUID v5 ZUUID generation
+- `entity.ts`: flat Zuuid data types and category helpers
+- `client.ts`: stateless package instantiator for configured providers
+- `providers/<provider>/index.ts`: provider module barrel
+- `providers/<provider>/client.ts`: shared provider client/config
+- `providers/<provider>/<category>.ts`: category-specific fetch and transform helpers
+- `providers/tmdb/movie.ts`: TMDB movie fetch and transform helpers
+- `providers/tmdb/tv.ts`: TMDB TV fetch and transform helpers
+- `providers/tmdb/person.ts`: TMDB person fetch and transform helpers
+- `source.ts`: source records, external IDs, and provenance
+- `hash.ts`: stable payload hashing
+- `uuid.ts`: UUID parsing/normalization and UUID v5 internals
+- `types.ts`: shared JSON value types
+- `index.ts`: public barrel exports
+
+### `providerZuuid(input)`
+
+Generates a deterministic ZUUID for a provider/category/external ID.
+
+### `providerNamespace(provider)`
+
+Returns the UUID namespace configured for a known provider.
+
+### `createZuuidData(input)`
+
+Creates a normalized Zuuid dataset.
+
+### `createSourceRecord(input)`
+
+Creates a source record and computes the SHA-256 payload hash used for provenance.
+
+### `attachSourceMetadata(dataset, sourceRecord, confidence?)`
+
+Returns a new dataset with external ID and provenance attached.
+
+### `TmdbProvider`
+
+Fetches TMDB source records and transforms them into `ZuuidData`.
+
+### `transformTmdbMovie(sourceRecord, options?)`
+
+Transforms an already-fetched TMDB movie source record into `ZuuidData`.
+
+### `transformTmdbTv(sourceRecord, options?)`
+
+Transforms an already-fetched TMDB TV source record into `ZuuidData`.
+
+### `transformTmdbPerson(sourceRecord, options?)`
+
+Transforms an already-fetched TMDB person source record into `ZuuidData`.
+
+### `categoryFor(value)`
+
+Normalizes a category and derives its entity kind.
+
+### `kindForCategory(category)`
+
+Maps categories such as `movie`, `book`, `game`, `restaurant`, and `person` to broad kinds such as `watch`, `read`, `play`, `visit`, and `people`.
+
+## Development
+
+```sh
+npm install
+npm test
+```
+
+## Try It
+
+Fetch and transform TMDB movie `550`:
+
+```sh
+TMDB_BEARER_TOKEN=... npm run example:tmdb-fetch -- movie 550
+```
+
+or:
+
+```sh
+TMDB_API_KEY=... npm run example:tmdb-fetch -- movie 550
+```
+
+Fetch and transform TMDB TV show `1399`:
+
+```sh
+TMDB_BEARER_TOKEN=... npm run example:tmdb-fetch -- tv 1399
+```
+
+Fetch and transform TMDB person `287`:
+
+```sh
+TMDB_BEARER_TOKEN=... npm run example:tmdb-fetch -- people 287
+```
+
+Search TMDB and print unified search results:
+
+```sh
+npm run example:tmdb-search -- movie "Fight Club"
+npm run example:tmdb-search -- tv "Game of Thrones"
+npm run example:tmdb-search -- people "Brad Pitt"
+```
+
+The example also reads `.env` from the repo root:
+
+```sh
+TMDB_BEARER_TOKEN=...
+# or
+TMDB_READ_ACCESS_TOKEN=...
+# or
+TMDB_API_KEY=...
+```
+
+If both token and API key are present, the example uses the bearer token first. TMDB's API Read Access Token usually starts with `eyJ...`; the v3 API key is a shorter hex-like string.
+
+If `TMDB_API_KEY` accidentally contains a token starting with `eyJ`, the example treats it as a bearer token and sends it as `Authorization: Bearer ...`.
+
+The example writes debug output to:
+
+```txt
+data/tmdb/movie/550.raw.json
+data/tmdb/movie/550.zuuid.json
+data/tmdb/tv/1399.raw.json
+data/tmdb/tv/1399.zuuid.json
+data/tmdb/people/287.raw.json
+data/tmdb/people/287.zuuid.json
+data/tmdb/search/movie/fight-club.zuuid-search.json
+data/tmdb/search/movie/fight-club.raw-search.json
+```

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import type { SearchResponse, ZuuidData, ZuuidSearchResult } from "./entity.js";
+import { type FetchTmdbMovieInput, type FetchTmdbPersonInput, type FetchTmdbTvInput, type TmdbProviderOptions, type TmdbSearchInput } from "./providers/tmdb/index.js";
+import type { SourceRecord } from "./source.js";
+export type ProviderConfigs = {
+    tmdb?: TmdbProviderOptions;
+};
+export type ZuuidClientConfig = {
+    providers?: ProviderConfigs;
+};
+export type MovieProviderClient<TFetchInput> = {
+    fetch(input: TFetchInput): Promise<ZuuidData | undefined>;
+    fetchSourceRecord(input: TFetchInput): Promise<SourceRecord | undefined>;
+    search(input: TmdbSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+    searchSourceRecords(input: TmdbSearchInput): Promise<SearchResponse<SourceRecord>>;
+    transform(source: SourceRecord): Promise<ZuuidData>;
+};
+export type ZuuidClient = {
+    movie: {
+        tmdb?: MovieProviderClient<FetchTmdbMovieInput>;
+    };
+    tv: {
+        tmdb?: MovieProviderClient<FetchTmdbTvInput>;
+    };
+    people: {
+        tmdb?: MovieProviderClient<FetchTmdbPersonInput>;
+    };
+};
+export declare function createZuuidClient(config?: ZuuidClientConfig): ZuuidClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,WAAW,IAAI;IAC7C,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC1D,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC3E,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IACnF,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;KACjD,CAAC;IACF,EAAE,EAAE;QACF,IAAI,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;KAC9C,CAAC;IACF,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;KAClD,CAAC;CACH,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,iBAAsB,GAAG,WAAW,CAsC7E"}

package/dist/client.js

@@ -0,0 +1,39 @@
+import { TmdbProvider, transformTmdbMovie, transformTmdbPerson, transformTmdbTv } from "./providers/tmdb/index.js";
+export function createZuuidClient(config = {}) {
+    const tmdb = config.providers?.tmdb ? new TmdbProvider(config.providers.tmdb) : undefined;
+    return Object.freeze({
+        movie: Object.freeze({
+            tmdb: tmdb
+                ? Object.freeze({
+                    fetch: (input) => tmdb.fetchMovie(input),
+                    fetchSourceRecord: (input) => tmdb.fetchMovieSourceRecord(input),
+                    search: (input) => tmdb.searchMovies(input),
+                    searchSourceRecords: (input) => tmdb.searchMovieSourceRecords(input),
+                    transform: (source) => transformTmdbMovie(source, tmdb.transformOptions())
+                })
+                : undefined
+        }),
+        tv: Object.freeze({
+            tmdb: tmdb
+                ? Object.freeze({
+                    fetch: (input) => tmdb.fetchTv(input),
+                    fetchSourceRecord: (input) => tmdb.fetchTvSourceRecord(input),
+                    search: (input) => tmdb.searchTv(input),
+                    searchSourceRecords: (input) => tmdb.searchTvSourceRecords(input),
+                    transform: (source) => transformTmdbTv(source, tmdb.transformOptions())
+                })
+                : undefined
+        }),
+        people: Object.freeze({
+            tmdb: tmdb
+                ? Object.freeze({
+                    fetch: (input) => tmdb.fetchPerson(input),
+                    fetchSourceRecord: (input) => tmdb.fetchPersonSourceRecord(input),
+                    search: (input) => tmdb.searchPeople(input),
+                    searchSourceRecords: (input) => tmdb.searchPersonSourceRecords(input),
+                    transform: (source) => transformTmdbPerson(source, tmdb.transformOptions())
+                })
+                : undefined
+        })
+    });
+}

package/dist/entity.d.ts

@@ -0,0 +1,106 @@
+import type { ExternalId, Provenance } from "./source.js";
+import type { JsonValue } from "./types.js";
+export type EntityKind = "event" | "listen" | "people" | "play" | "read" | "visit" | "watch" | string;
+export type CategoryInfo = {
+    category: string;
+    kind: EntityKind;
+};
+export type Alias = {
+    value: string;
+    language?: string;
+    region?: string;
+    aliasType: string;
+    isPrimary: boolean;
+    source?: string;
+};
+export type Description = {
+    language?: string;
+    region?: string;
+    value: string;
+    source?: string;
+};
+export type Detail = {
+    key: string;
+    value: JsonValue;
+    source?: string;
+};
+export type MediaAsset = {
+    url: string;
+    mediaType: string;
+    mediaCategory: string;
+    width?: number;
+    height?: number;
+    isPrimary: boolean;
+    data?: JsonValue;
+    source?: string;
+};
+export type RelationKind = "appears_in" | "authored_by" | "based_on" | "contains" | "duplicate_of" | "mentions" | "part_of" | "performed_by" | "published_by" | "related_to" | "same_as" | "source_of" | string;
+export type RecommendationKind = "similar" | "related" | "same_creator" | "same_series" | "same_topic" | string;
+export type ZuuidData = {
+    zuuid: string;
+    kind: EntityKind;
+    category: string;
+    primaryTitle: string;
+    primaryDate?: string;
+    rating?: number;
+    cover?: string;
+    aliases: Alias[];
+    descriptions: Description[];
+    details: Detail[];
+    media: MediaAsset[];
+    relations: EntityRelation[];
+    recommendations: RecommendationEdge[];
+    tags: string[];
+    externalIds: ExternalId[];
+    provenance: Provenance[];
+};
+export type ZuuidListItem = {
+    id: string;
+    zuuid: string;
+    category: string;
+    title: string;
+    date: string | null;
+    cover: string | null;
+    rating: number | null;
+    weight: number | null;
+    relationType: string | null;
+    attribute: string | null;
+    order: number | null;
+};
+export type EntityRelation = ZuuidListItem & {
+    relationType: RelationKind;
+    direction: "outgoing" | "incoming" | "symmetric";
+    source?: string;
+    externalId?: string;
+    confidence?: number;
+    data?: JsonValue;
+};
+export type RecommendationEdge = ZuuidListItem & {
+    recommendationType: RecommendationKind;
+    relationType: RecommendationKind;
+    source?: string;
+    externalId?: string;
+    reasons: string[];
+};
+export type ZuuidSearchResult = ZuuidListItem & {
+    source: ExternalId;
+};
+export type SearchPagination = {
+    page: number;
+    totalPages: number;
+    totalResults: number;
+};
+export type SearchResponse<T> = {
+    results: T[];
+    pagination: SearchPagination;
+};
+export type CreateZuuidDataInput = {
+    zuuid: string;
+    category: string;
+    primaryTitle: string;
+};
+export declare function createZuuidData(input: CreateZuuidDataInput): ZuuidData;
+export declare function createZuuidDataFromParts(zuuid: string, category: CategoryInfo, primaryTitle: string): ZuuidData;
+export declare function categoryFor(value: string): CategoryInfo;
+export declare function kindForCategory(category: string): EntityKind;
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"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"}

package/dist/entity.js

@@ -0,0 +1,101 @@
+import { normalizeUuid } from "./uuid.js";
+export function createZuuidData(input) {
+    const zuuid = normalizeUuid(input.zuuid);
+    const category = categoryFor(input.category);
+    return createZuuidDataFromParts(zuuid, category, input.primaryTitle);
+}
+export function createZuuidDataFromParts(zuuid, category, primaryTitle) {
+    return {
+        zuuid: normalizeUuid(zuuid),
+        kind: category.kind,
+        category: category.category,
+        primaryTitle,
+        aliases: [],
+        descriptions: [],
+        details: [],
+        media: [],
+        relations: [],
+        recommendations: [],
+        tags: [],
+        externalIds: [],
+        provenance: []
+    };
+}
+export function categoryFor(value) {
+    const normalized = normalizeKeyPart(value);
+    return {
+        category: normalized,
+        kind: kindForCategory(normalized),
+    };
+}
+export function kindForCategory(category) {
+    switch (normalizeKeyPart(category)) {
+        case "movie":
+        case "film":
+        case "tv":
+        case "tvshow":
+        case "tv_show":
+        case "tvseason":
+        case "tv_season":
+        case "series":
+        case "anime":
+        case "documentary":
+        case "video":
+            return "watch";
+        case "album":
+        case "music":
+        case "musicalbum":
+        case "release":
+        case "master":
+        case "track":
+        case "recording":
+        case "podcast":
+        case "podcast_episode":
+        case "audiobook":
+            return "listen";
+        case "book":
+        case "work":
+        case "article":
+        case "web_page":
+        case "comic":
+        case "manga":
+        case "paper":
+        case "blog_post":
+            return "read";
+        case "game":
+        case "videogame":
+        case "boardgame":
+        case "platform":
+            return "play";
+        case "place":
+        case "location":
+        case "venue":
+        case "restaurant":
+        case "route":
+        case "city":
+        case "country":
+            return "visit";
+        case "event":
+        case "concert":
+        case "screening":
+        case "exhibition":
+        case "match":
+        case "festival":
+            return "event";
+        case "person":
+        case "people":
+        case "artist":
+        case "author":
+        case "actor":
+        case "creator":
+        case "organization":
+        case "company":
+        case "team":
+            return "people";
+        default:
+            return normalizeKeyPart(category);
+    }
+}
+function normalizeKeyPart(value) {
+    return value.trim().toLowerCase();
+}

package/dist/hash.d.ts

@@ -0,0 +1,3 @@
+import type { JsonValue } from "./types.js";
+export declare function stablePayloadHash(payload: JsonValue): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map