@media-engine/core 0.1.1 → 1.0.0

package/dist/providers/registry.js.map

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

package/dist/providers/types.d.ts

@@ -2,11 +2,14 @@ import type { ExternalIds, MediaDetails, MediaItem, MediaType, ProviderSource }
 export type ProviderKind = "metadata";
 export type ExternalIdSource = "imdb" | "tmdb" | "kinopoisk" | "shikimori" | "myAnimeList" | "aniList" | "worldArt";
 export type ProviderFeature = "posters" | "backdrops" | "ratings" | "genres" | "persons" | "seasons" | "episodes" | "alternative_titles";
+export type TitleDiscoveryRole = "primary" | "fallback";
 export interface ProviderCapabilities {
     mediaTypes: MediaType[];
+    searchEnrichment?: boolean;
     search: {
         byTitle: boolean;
         byExternalIds: ExternalIdSource[];
+        titleDiscovery?: TitleDiscoveryRole;
     };
     details: {
         byExternalIds: ExternalIdSource[];

package/dist/response/types.d.ts

@@ -1,8 +1,10 @@
+export type ProviderExecutionPhase = "primary" | "retry" | "fallback" | "provider_fallback" | "id_enrichment" | "poster_enrichment";
 export interface ProviderFailure {
     provider: string;
     code: string;
     retryable: boolean;
     message: string;
+    phase?: ProviderExecutionPhase;
 }
 export interface ProviderExecutionMeta {
     requested: string[];
@@ -13,15 +15,33 @@ export interface ProviderTimingMeta {
     provider: string;
     status: "success" | "failed";
     tookMs: number;
+    phase?: ProviderExecutionPhase;
 }
 export interface EngineWarning {
     code: string;
     message: string;
     provider?: string;
 }
+export interface SearchEnrichmentCounters {
+    attempted: number;
+    skipped: number;
+    succeeded: number;
+    failed: number;
+}
+export interface SearchEnrichmentDebugMeta {
+    id: SearchEnrichmentCounters;
+    poster: SearchEnrichmentCounters;
+}
+export interface SearchIdentitySnapshotDebugMeta {
+    applied: true;
+    restored: number;
+    reordered: number;
+}
 export interface ResponseDebugMeta {
     providers: string[];
     timings: ProviderTimingMeta[];
+    enrichment?: SearchEnrichmentDebugMeta;
+    identitySnapshot?: SearchIdentitySnapshotDebugMeta;
 }
 export interface ResponseMeta {
     providers: ProviderExecutionMeta;

package/dist/search/types.d.ts

@@ -14,10 +14,44 @@ export interface SearchQuery {
     limit?: number;
     language?: string;
 }
+export type SearchTitleMatchKind = "not_applicable" | "none" | "exact_primary" | "exact_alias" | "joined" | "prefix" | "contains" | "all_tokens" | "fuzzy";
+export interface SearchRankSignal {
+    value: number;
+    weight: number;
+    contribution: number;
+}
+export interface SearchRankEvidence {
+    formula: "external_id" | "non_text" | "text";
+    matchStrength: "exact_id" | "exact_title_year_type" | "normalized_title_year_type" | "weak" | "none";
+    titleMatch: {
+        kind: SearchTitleMatchKind;
+        score: number;
+        matchedTitle?: string;
+    };
+    signals: {
+        base: SearchRankSignal;
+        title: SearchRankSignal;
+        exactPrimaryTitle: SearchRankSignal;
+        popularity: SearchRankSignal;
+        rating: SearchRankSignal;
+        externalIds: SearchRankSignal;
+        sourceCoverage: SearchRankSignal;
+        sourceAuthority: SearchRankSignal;
+    };
+    preBoundedScore: number;
+    scorePosition: number;
+    diversityPosition: number;
+    finalPosition: number;
+    diversity: {
+        family: string;
+        adjusted: boolean;
+    };
+}
 export interface MediaSearchResult {
     item: MediaItem;
     score: number;
     sources: ProviderSource[];
+    ranking?: SearchRankEvidence;
 }
 export interface SearchResponse {
     query: SearchQuery;

package/dist/testing/providers.js

@@ -110,6 +110,7 @@ export function createDetailsResult(provider, details = sampleMovie) {
 function createCapabilities(overrides = {}) {
     return {
         mediaTypes: overrides.mediaTypes ?? ["movie", "series", "anime"],
+        searchEnrichment: overrides.searchEnrichment,
         search: {
             byTitle: overrides.search?.byTitle ?? true,
             byExternalIds: overrides.search?.byExternalIds ?? [
@@ -118,6 +119,7 @@ function createCapabilities(overrides = {}) {
                 "shikimori",
                 "myAnimeList",
             ],
+            titleDiscovery: overrides.search?.titleDiscovery,
         },
         details: {
             byExternalIds: overrides.details?.byExternalIds ?? [

package/dist/testing/providers.js.map

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

package/dist/torrent/index.d.ts

@@ -0,0 +1 @@
+export type * from "./types.js";

package/dist/torrent/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/torrent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/torrent/index.ts"],"names":[],"mappings":""}

package/dist/torrent/types.d.ts

@@ -0,0 +1,132 @@
+import type { ExternalIds, MediaType } from "../media/index.js";
+import type { ExternalIdSource, ProviderContext } from "../providers/index.js";
+import type { ResponseMeta } from "../response/index.js";
+export interface TorrentDiscoveryQuery {
+    type: MediaType;
+    ids?: ExternalIds;
+    imdb?: string;
+    tmdb?: string;
+    kinopoisk?: string;
+    shikimori?: string;
+    myAnimeList?: string;
+    aniList?: string;
+    title?: string;
+    alternativeTitles?: string[];
+    year?: number;
+    seasonNumber?: number;
+    episodeNumber?: number;
+    absoluteEpisodeNumber?: number;
+    providers?: string[];
+    language?: string;
+    limit?: number;
+}
+export interface TorrentMediaItem {
+    type: MediaType;
+    title?: string;
+    originalTitle?: string;
+    year?: number;
+    ids?: ExternalIds;
+}
+export interface TorrentEpisodeRef {
+    seasonNumber?: number;
+    episodeNumber?: number;
+    absoluteEpisodeNumber?: number;
+    episodeNumberEnd?: number;
+    absoluteEpisodeNumberEnd?: number;
+}
+export interface TorrentFile {
+    index?: number;
+    path: string;
+    sizeBytes?: number;
+    mediaType?: "video" | "audio" | "subtitle" | "other";
+}
+export interface TorrentReleaseInfo {
+    source?: "bluray" | "web" | "hdtv" | "dvd" | "cam" | "unknown";
+    resolution?: string;
+    height?: number;
+    videoCodec?: string;
+    audioCodec?: string;
+    container?: string;
+    hdr?: string[];
+    audioLanguages?: string[];
+    subtitleLanguages?: string[];
+}
+export interface TorrentPeerInfo {
+    seeders?: number;
+    leechers?: number;
+    checkedAt?: string;
+}
+export interface TorrentCatalogSource {
+    id: string;
+    displayName?: string;
+}
+export type TorrentHandoffKind = "magnet" | "torrent_file" | "external";
+export interface TorrentHandoff {
+    kind: TorrentHandoffKind;
+    uri: string;
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+    referer?: string;
+}
+export type TorrentAvailabilityStatus = "available" | "unseeded" | "unknown";
+export interface TorrentCandidate {
+    id: string;
+    provider: string;
+    title: string;
+    infoHash?: string;
+    sizeBytes?: number;
+    publishedAt?: string;
+    episode?: TorrentEpisodeRef;
+    files?: TorrentFile[];
+    release?: TorrentReleaseInfo;
+    peers?: TorrentPeerInfo;
+    handoff: TorrentHandoff;
+    availability: TorrentAvailabilityStatus;
+    catalogSource?: TorrentCatalogSource;
+    expiresAt?: string;
+    sourceUrl?: string;
+}
+export interface TorrentProviderSource {
+    provider: string;
+    url?: string;
+    ids?: ExternalIds;
+}
+export interface TorrentDiscoveryResponse {
+    query: TorrentDiscoveryQuery;
+    item?: TorrentMediaItem;
+    candidates: TorrentCandidate[];
+    sourceProviders: TorrentProviderSource[];
+    checkedAt: string;
+    meta?: ResponseMeta;
+}
+export type TorrentProviderFeature = "magnet" | "torrent_file" | "external" | "file_list" | "peer_stats" | "release_metadata";
+export interface TorrentProviderCapabilities {
+    mediaTypes: MediaType[];
+    lookup: {
+        byTitle: boolean;
+        byExternalIds: ExternalIdSource[];
+        byEpisode: boolean;
+    };
+    features?: TorrentProviderFeature[];
+}
+export type TorrentProviderCatalogScope = "regional" | "international";
+export interface TorrentProviderCatalog {
+    displayName: string;
+    scope: TorrentProviderCatalogScope;
+    locale?: string;
+}
+export interface TorrentProviderInfo {
+    name: string;
+    version?: string;
+    kind: "torrent";
+    catalog?: TorrentProviderCatalog;
+    capabilities: TorrentProviderCapabilities;
+}
+export interface TorrentProvider {
+    name: string;
+    version?: string;
+    kind: "torrent";
+    catalog?: TorrentProviderCatalog;
+    capabilities: TorrentProviderCapabilities;
+    discoverTorrents(query: TorrentDiscoveryQuery, context: ProviderContext): Promise<TorrentDiscoveryResponse | null>;
+}

package/dist/torrent/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/torrent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/torrent/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@media-engine/core",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "Core TypeScript engine for Media Engine.",
   "license": "MIT",
   "homepage": "https://github.com/Yaneart/media-engine#readme",
@@ -18,6 +18,7 @@
     "movies",
     "series",
     "anime",
+    "torrent",
     "shikimori"
   ],
   "type": "module",
@@ -48,8 +49,12 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "clean": "node ../../scripts/clean-package-dist.mjs",
+    "build": "pnpm clean && tsc -p tsconfig.json",
+    "coverage": "pnpm build && pnpm coverage:unit",
+    "coverage:unit": "node ../../scripts/run-node-tests.mjs --coverage --lines=96 --branches=92 --functions=95",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "pnpm build && node --test dist/providers/registry.test.js dist/errors/types.test.js dist/merge/strategy.search.merge.test.js dist/merge/strategy.search.ranking.test.js dist/merge/strategy.details.test.js dist/cache/memory.test.js dist/engine/circuit-breaker.test.js dist/engine/concurrency-limiter.test.js dist/engine/timeout-budget.test.js dist/engine/in-flight.test.js dist/engine/engine.config.test.js dist/engine/engine.health.test.js dist/engine/engine.search.query.test.js dist/engine/engine.search.results.test.js dist/engine/engine.search.providers.test.js dist/engine/engine.search.fallback.test.js dist/engine/engine.details.test.js dist/engine/engine.availability.test.js dist/testing/providers.test.js dist/streaming/types.test.js"
+    "test": "pnpm build && pnpm test:unit",
+    "test:unit": "node ../../scripts/run-node-tests.mjs"
   }
 }