@media-engine/core 0.1.0 → 0.1.1

package/README.md

@@ -1,295 +1,54 @@
 # @media-engine/core
 
-Core TypeScript package for Media Engine.
+**English** | [Русский](https://github.com/Yaneart/media-engine/blob/main/packages/core/README.ru.md)
 
-It owns the framework-independent engine, public media types, provider contracts, streaming provider contracts, provider registry, merge strategy, cache interface, error model, and testing utilities.
+This is the part of Media Engine that does the thinking: it chooses providers, runs them, merges their answers, caches results, and turns failures into a predictable shape.
 
-Core does not import concrete providers and does not read API keys from the environment. Providers are passed in from the outside.
+It does not contain any real data sources. For those, install `@media-engine/providers` too.
 
 ## Install
 
 ```bash
-npm install @media-engine/core
+npm install @media-engine/core @media-engine/providers
 ```
 
-## Basic Usage
+## Basic use
 
 ```ts
-import { MediaEngine, createMockProvider } from "@media-engine/core";
+import { MediaEngine } from "@media-engine/core";
+import { cinemetaProvider, kinobdProvider } from "@media-engine/providers";
 
 const media = new MediaEngine({
-  providers: [createMockProvider()],
+  providers: [kinobdProvider(), cinemetaProvider()],
 });
 
-const response = await media.search({
-  title: "Interstellar",
-});
-
-console.log(response.results[0]?.item.title);
-console.log(response.meta.providers.successful);
-```
-
-## Usage With Mock Provider
-
-```ts
-import {
-  MediaEngine,
-  createDetailsResult,
-  createMockProvider,
-  createSearchResult,
-  sampleMovie,
-} from "@media-engine/core";
-
-const mockProvider = createMockProvider({
-  name: "local-fixture",
-  searchResults: [createSearchResult("local-fixture", sampleMovie)],
-  detailsResult: createDetailsResult("local-fixture", sampleMovie),
-});
-
-const media = new MediaEngine({
-  providers: [mockProvider],
-});
-
-const search = await media.search({
-  imdb: "tt0816692",
-});
-
-const details = await media.getDetails({
-  imdb: "tt0816692",
-});
-
-console.log(search.results.length);
-console.log(details.details?.title);
-```
-
-## Provider Contract Overview
-
-A provider is a small object that implements the `MediaProvider` contract:
-
-```ts
-import type { MediaProvider } from "@media-engine/core";
+const search = await media.search({ title: "Interstellar" });
+const details = await media.getDetails({ imdb: "tt0816692" });
 
-export const provider: MediaProvider = {
-  name: "example",
-  kind: "metadata",
-  capabilities: {
-    mediaTypes: ["movie", "series", "anime"],
-    search: {
-      byTitle: true,
-      byExternalIds: ["imdb", "tmdb"],
-    },
-    details: {
-      byExternalIds: ["imdb", "tmdb"],
-    },
-  },
-  async search(query, context) {
-    return [];
-  },
-  async getDetails(query, context) {
-    return null;
-  },
-};
+console.log(search.results[0]?.item);
+console.log(details.details);
 ```
 
-`capabilities` tell the engine when a provider can be selected. `search` returns normalized provider search results. `getDetails` is optional; providers without it are skipped by `MediaEngine.getDetails`.
+The engine also has `getAvailability()` for optional streaming providers.
 
-Provider methods receive a `context` with `signal`, `timeoutMs`, `debug`, and `language`. Providers should respect `context.signal` when they perform slow work.
+## What comes from core
 
-Applications can bound slower optional providers independently while keeping a global upper limit:
-
-```ts
-const media = new MediaEngine({
-  providers,
-  timeoutMs: 5_000,
-  providerTimeouts: {
-    cinemeta: 2_500,
-    wikidata: 2_500,
-  },
-});
-```
-
-The effective timeout is the smaller of `timeoutMs` and the matching `providerTimeouts` value.
-
-## Streaming Availability Contract
-
-Streaming availability is separate from metadata search and details. Configure streaming providers through `streamingProviders` and call `getAvailability` with a media or episode identity.
-
-```ts
-import { MediaEngine, createMockProvider } from "@media-engine/core";
-import type { StreamingProvider } from "@media-engine/core";
-
-const streamingProvider: StreamingProvider = {
-  name: "example-streaming",
-  kind: "streaming",
-  capabilities: {
-    mediaTypes: ["movie", "series", "anime"],
-    lookup: {
-      byTitle: true,
-      byExternalIds: ["imdb"],
-      byEpisode: true,
-    },
-    features: ["embed", "translations", "qualities"],
-  },
-  async getAvailability(query) {
-    return {
-      query,
-      options: [],
-      sourceProviders: [{ provider: "example-streaming" }],
-      checkedAt: new Date().toISOString(),
-    };
-  },
-};
-
-const media = new MediaEngine({
-  providers: [createMockProvider()],
-  streamingProviders: [streamingProvider],
-});
-
-const availability = await media.getAvailability({
-  type: "movie",
-  imdb: "tt0816692",
-});
-```
-
-Core does not decide whether a third-party player source is appropriate for a product. Concrete streaming providers must document their own source rules and expose only safe access URLs.
-
-## Search Response Example
-
-```ts
-import { MediaEngine, createSuccessProvider } from "@media-engine/core";
+- `MediaEngine`;
+- search, details, media, and streaming types;
+- metadata and streaming provider contracts;
+- merge and cache interfaces;
+- `MemoryCache`;
+- normalized errors and provider failure metadata;
+- mock providers and fixtures for tests.
 
-const media = new MediaEngine({
-  providers: [createSuccessProvider()],
-});
-
-const response = await media.search({
-  title: "Interstellar",
-});
-```
-
-Shape:
-
-```ts
-{
-  query: {
-    title: "Interstellar",
-  },
-  results: [
-    {
-      item: {
-        id: "sample-movie-interstellar",
-        type: "movie",
-        title: "Interstellar",
-        year: 2014,
-      },
-      score: 0.5,
-      sources: [
-        {
-          provider: "success-provider",
-        },
-      ],
-    },
-  ],
-  meta: {
-    providers: {
-      requested: ["success-provider"],
-      successful: ["success-provider"],
-      failed: [],
-    },
-    cached: false,
-    tookMs: 1,
-  },
-}
-```
-
-`score`, `tookMs`, and optional fields can vary with the provider result and merge strategy.
-
-## Details Response Example
-
-```ts
-import { MediaEngine, createSuccessProvider } from "@media-engine/core";
-
-const media = new MediaEngine({
-  providers: [createSuccessProvider()],
-});
-
-const response = await media.getDetails({
-  imdb: "tt0816692",
-});
-```
-
-Shape:
-
-```ts
-{
-  query: {
-    imdb: "tt0816692",
-    ids: {
-      imdb: "tt0816692",
-    },
-  },
-  details: {
-    id: "sample-movie-interstellar",
-    type: "movie",
-    title: "Interstellar",
-    year: 2014,
-  },
-  meta: {
-    providers: {
-      requested: ["success-provider"],
-      successful: ["success-provider"],
-      failed: [],
-    },
-    cached: false,
-    tookMs: 1,
-  },
-}
-```
-
-If selected providers return no details, `details` is `null`.
-
-## Availability Response Example
-
-```ts
-import { MediaEngine, createSuccessProvider } from "@media-engine/core";
-
-const media = new MediaEngine({
-  providers: [createSuccessProvider()],
-});
-
-const response = await media.getAvailability({
-  type: "movie",
-  imdb: "tt0816692",
-});
-```
-
-When no streaming providers are configured, `options` is empty and `sourceProviders` is empty. Provider failures are exposed through response metadata when configured providers fail.
-
-## Bounded Memory Cache
-
-```ts
-import { MediaEngine, MemoryCache } from "@media-engine/core";
-
-const media = new MediaEngine({
-  cache: new MemoryCache({
-    defaultTtlMs: 5 * 60_000,
-    maxEntries: 500,
-  }),
-});
-```
+Provider calls run concurrently. If one source fails and another succeeds, the response keeps the useful data and lists the failure in `meta.providers.failed`.
 
-`defaultTtlMs` applies when a cache write does not specify its own TTL. `maxEntries` bounds memory usage and evicts the least-recently-used entry when full.
+`MemoryCache` can retain metadata for a separate bounded stale window. `MediaEngine` uses it only for search and details when every selected provider fails retryably; stale streaming links are never returned. Such responses set `meta.cached` and `meta.stale` to `true`.
 
-## Testing Utilities
+The constructor also accepts streaming providers, a cache, global and per-provider timeouts, a custom merge strategy, and debug mode. Provider calls are bounded to two concurrent operations per provider by default, with a cancellable queue of 100; `providerConcurrency` can tune per-provider limits or disable the gate. Queue waiting remains inside the existing provider timeout. Core never imports concrete provider packages itself.
 
-The core package exports deterministic helpers for tests and examples:
+Exact types are available from the package exports. The short [public API guide](https://github.com/Yaneart/media-engine/blob/main/docs/public-api.md) explains the three main operations without repeating every field.
 
-- `createMockProvider`;
-- `createSuccessProvider`;
-- `createFailingProvider`;
-- `createTimeoutProvider`;
-- `sampleMovie`;
-- `sampleSeries`;
-- `sampleAnime`.
+## License
 
-These helpers do not call real APIs and do not require API keys.
+MIT

package/README.ru.md

@@ -0,0 +1,54 @@
+# @media-engine/core
+
+[English](https://github.com/Yaneart/media-engine/blob/main/packages/core/README.md) | **Русский**
+
+Это часть Media Engine, которая отвечает за основную логику: выбирает провайдеры, запускает их, объединяет ответы, кеширует результат и приводит ошибки к предсказуемому виду.
+
+Самих источников данных в core нет. Для них установите ещё и `@media-engine/providers`.
+
+## Установка
+
+```bash
+npm install @media-engine/core @media-engine/providers
+```
+
+## Простой пример
+
+```ts
+import { MediaEngine } from "@media-engine/core";
+import { cinemetaProvider, kinobdProvider } from "@media-engine/providers";
+
+const media = new MediaEngine({
+  providers: [kinobdProvider(), cinemetaProvider()],
+});
+
+const search = await media.search({ title: "Интерстеллар" });
+const details = await media.getDetails({ imdb: "tt0816692" });
+
+console.log(search.results[0]?.item);
+console.log(details.details);
+```
+
+Для опциональных стриминговых провайдеров у движка также есть `getAvailability()`.
+
+## Что экспортирует core
+
+- `MediaEngine`;
+- типы поиска, деталей, медиа и стриминга;
+- контракты metadata- и streaming-провайдеров;
+- интерфейсы объединения и кеша;
+- `MemoryCache`;
+- нормализованные ошибки и сведения о сбоях провайдеров;
+- mock-провайдеры и примеры данных для тестов.
+
+Провайдеры запускаются параллельно. Если один источник не сработал, а другой вернул данные, полезный ответ сохранится, а ошибка попадёт в `meta.providers.failed`.
+
+`MemoryCache` может сохранять метаданные в отдельном ограниченном stale-окне. `MediaEngine` использует их только для поиска и деталей, когда все выбранные провайдеры завершились с retryable-ошибками; устаревшие streaming-ссылки никогда не возвращаются. В таком ответе `meta.cached` и `meta.stale` равны `true`.
+
+Конструктор также принимает стриминговые провайдеры, кеш, общий и индивидуальные тайм-ауты, собственную стратегию объединения и debug-режим. По умолчанию одновременно выполняются не более двух операций каждого провайдера, а отменяемая очередь ограничена 100 элементами; `providerConcurrency` позволяет настроить отдельные лимиты или отключить gate. Ожидание в очереди входит в существующий тайм-аут провайдера. Сам core никогда не импортирует пакеты с конкретными провайдерами.
+
+Точные типы доступны через exports пакета. В коротком [описании публичного API](https://github.com/Yaneart/media-engine/blob/main/docs/public-api.md) разобраны три основные операции без перечисления каждого поля.
+
+## Лицензия
+
+MIT

package/dist/cache/memory.d.ts

@@ -2,18 +2,23 @@ import type { Cache, CacheSetOptions } from "./types.js";
 export interface MemoryCacheOptions {
     now?: () => number;
     defaultTtlMs?: number;
+    defaultStaleTtlMs?: number;
     maxEntries?: number;
 }
 export declare class MemoryCache implements Cache {
     private readonly entries;
     private readonly now;
     private readonly defaultTtlMs?;
+    private readonly defaultStaleTtlMs?;
     private readonly maxEntries?;
     constructor(options?: MemoryCacheOptions);
     get<T>(key: string): T | undefined;
+    getStale<T>(key: string): T | undefined;
     set<T>(key: string, value: T, options?: CacheSetOptions): void;
     delete(key: string): void;
     clear(): void;
     private isExpired;
+    private isBeyondStaleWindow;
+    private deleteIfBeyondStaleWindow;
     private evictOverflow;
 }

package/dist/cache/memory.js

@@ -4,14 +4,20 @@ export class MemoryCache {
     entries = new Map();
     now;
     defaultTtlMs;
+    defaultStaleTtlMs;
     maxEntries;
     constructor(options = {}) {
         if (options.maxEntries !== undefined &&
             (!Number.isInteger(options.maxEntries) || options.maxEntries <= 0)) {
             throw new TypeError("MemoryCache maxEntries must be a positive integer.");
         }
+        if (options.defaultStaleTtlMs !== undefined &&
+            (!Number.isInteger(options.defaultStaleTtlMs) || options.defaultStaleTtlMs < 0)) {
+            throw new TypeError("MemoryCache defaultStaleTtlMs must be a non-negative integer.");
+        }
         this.now = options.now ?? Date.now;
         this.defaultTtlMs = options.defaultTtlMs;
+        this.defaultStaleTtlMs = options.defaultStaleTtlMs;
         this.maxEntries = options.maxEntries;
     }
     // Reads a cached value and removes it when it has expired.
@@ -22,6 +28,23 @@ export class MemoryCache {
             return undefined;
         }
         if (this.isExpired(entry)) {
+            this.deleteIfBeyondStaleWindow(key, entry);
+            return undefined;
+        }
+        if (this.maxEntries !== undefined) {
+            this.entries.delete(key);
+            this.entries.set(key, entry);
+        }
+        return cloneCacheValue(entry.value);
+    }
+    // Reads a value only after normal TTL expiration and before its stale window closes.
+    // Читает значение только после обычного TTL и до завершения stale-окна.
+    getStale(key) {
+        const entry = this.entries.get(key);
+        if (!entry || !this.isExpired(entry)) {
+            return undefined;
+        }
+        if (this.isBeyondStaleWindow(entry)) {
             this.entries.delete(key);
             return undefined;
         }
@@ -35,9 +58,16 @@ export class MemoryCache {
     // Сохраняет значение с опциональным TTL в миллисекундах.
     set(key, value, options = {}) {
         const ttlMs = options.ttlMs ?? this.defaultTtlMs;
+        const staleTtlMs = options.staleTtlMs ?? this.defaultStaleTtlMs;
+        if (staleTtlMs !== undefined && (!Number.isInteger(staleTtlMs) || staleTtlMs < 0)) {
+            throw new TypeError("MemoryCache staleTtlMs must be a non-negative integer.");
+        }
         const expiresAt = ttlMs === undefined || ttlMs < 0 ? undefined : this.now() + ttlMs;
+        const staleUntil = expiresAt === undefined || staleTtlMs === undefined || staleTtlMs <= 0
+            ? undefined
+            : expiresAt + staleTtlMs;
         this.entries.delete(key);
-        this.entries.set(key, { value: cloneCacheValue(value), expiresAt });
+        this.entries.set(key, { value: cloneCacheValue(value), expiresAt, staleUntil });
         this.evictOverflow();
     }
     // Removes one cache entry by key.
@@ -55,6 +85,14 @@ export class MemoryCache {
     isExpired(entry) {
         return entry.expiresAt !== undefined && entry.expiresAt <= this.now();
     }
+    isBeyondStaleWindow(entry) {
+        return entry.staleUntil === undefined || entry.staleUntil <= this.now();
+    }
+    deleteIfBeyondStaleWindow(key, entry) {
+        if (this.isBeyondStaleWindow(entry)) {
+            this.entries.delete(key);
+        }
+    }
     // Evicts expired entries first, then least-recently-used entries until the bound is met.
     // Сначала удаляет истекшие записи, затем давно не использованные до соблюдения лимита.
     evictOverflow() {
@@ -62,7 +100,7 @@ export class MemoryCache {
             return;
         }
         for (const [key, entry] of this.entries) {
-            if (this.isExpired(entry)) {
+            if (this.isExpired(entry) && this.isBeyondStaleWindow(entry)) {
                 this.entries.delete(key);
             }
         }

package/dist/cache/memory.js.map

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

package/dist/cache/types.d.ts

@@ -1,8 +1,10 @@
 export interface CacheSetOptions {
     ttlMs?: number;
+    staleTtlMs?: number;
 }
 export interface Cache {
     get<T>(key: string): Promise<T | undefined> | T | undefined;
+    getStale?<T>(key: string): Promise<T | undefined> | T | undefined;
     set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void> | void;
     delete(key: string): Promise<void> | void;
     clear(): Promise<void> | void;

package/dist/engine/availability.d.ts

@@ -0,0 +1,5 @@
+import type { CacheSetOptions } from "../cache/index.js";
+import type { MediaAvailability, StreamQuery, StreamingProvider } from "../streaming/index.js";
+export declare function selectStreamingProviders(providers: StreamingProvider[], query: StreamQuery): StreamingProvider[];
+export declare function mergeAvailabilityResults(query: StreamQuery, results: MediaAvailability[]): MediaAvailability;
+export declare function createAvailabilityCacheOptions(availability: MediaAvailability): CacheSetOptions | undefined;

package/dist/engine/availability.js

@@ -0,0 +1,129 @@
+import { sortObject } from "./query.js";
+const EXPIRING_AVAILABILITY_CACHE_SAFETY_MS = 1_000;
+// Selects streaming providers that can answer the normalized stream query.
+// Выбирает streaming-провайдеры, которые могут ответить на нормализованный stream query.
+export function selectStreamingProviders(providers, query) {
+    return providers.filter((provider) => {
+        if (query.providers && !query.providers.includes(provider.name)) {
+            return false;
+        }
+        if (!provider.capabilities.mediaTypes.includes(query.type)) {
+            return false;
+        }
+        if (hasEpisodeQuery(query) && !provider.capabilities.lookup.byEpisode) {
+            return false;
+        }
+        return (Boolean(query.title && provider.capabilities.lookup.byTitle) ||
+            hasSupportedExternalId(query.ids, provider.capabilities.lookup.byExternalIds));
+    });
+}
+// Merges availability results without hiding provider attribution.
+// Объединяет availability-результаты, не скрывая атрибуцию провайдеров.
+export function mergeAvailabilityResults(query, results) {
+    return {
+        query,
+        item: results.find((result) => result.item)?.item,
+        episodes: mergeEpisodeAvailability(results),
+        options: uniqueBy(results.flatMap((result) => result.options), (option) => `${option.provider}:${option.id}`),
+        sourceProviders: uniqueBy(results.flatMap((result) => result.sourceProviders), (source) => createStreamingSourceKey(source)),
+        checkedAt: new Date().toISOString(),
+    };
+}
+// Keeps cached direct links from outliving the earliest advertised expiration.
+// Не позволяет кешированным прямым ссылкам пережить ближайший заявленный срок действия.
+export function createAvailabilityCacheOptions(availability) {
+    const expiresAtValues = [
+        ...availability.options,
+        ...(availability.episodes?.flatMap((episode) => episode.options) ?? []),
+    ]
+        .map((option) => option.expiresAt)
+        .filter((value) => value !== undefined)
+        .map((value) => Date.parse(value))
+        .filter(Number.isFinite);
+    if (expiresAtValues.length === 0) {
+        return { staleTtlMs: 0 };
+    }
+    const earliestExpiration = Math.min(...expiresAtValues);
+    return {
+        ttlMs: Math.max(0, earliestExpiration - Date.now() - EXPIRING_AVAILABILITY_CACHE_SAFETY_MS),
+        staleTtlMs: 0,
+    };
+}
+// Merges episode-level availability blocks by episode identity.
+// Объединяет episode-level availability блоки по идентичности эпизода.
+function mergeEpisodeAvailability(results) {
+    const episodesByKey = new Map();
+    for (const episode of results.flatMap((result) => [
+        ...(result.episodes ?? []),
+        ...createEpisodeAvailabilityFromOptions(result.options),
+    ])) {
+        const key = createEpisodeKey(episode);
+        const existing = episodesByKey.get(key);
+        if (!existing) {
+            episodesByKey.set(key, {
+                seasonNumber: episode.seasonNumber,
+                episodeNumber: episode.episodeNumber,
+                absoluteEpisodeNumber: episode.absoluteEpisodeNumber,
+                title: episode.title,
+                options: uniqueBy(episode.options, (option) => `${option.provider}:${option.id}`),
+            });
+            continue;
+        }
+        existing.options = uniqueBy([...existing.options, ...episode.options], (option) => `${option.provider}:${option.id}`);
+        existing.title ??= episode.title;
+    }
+    return episodesByKey.size > 0 ? [...episodesByKey.values()] : undefined;
+}
+// Creates episode blocks from top-level options that carry episode identity.
+// Создает episode blocks из top-level options, которые содержат идентичность эпизода.
+function createEpisodeAvailabilityFromOptions(options) {
+    return options
+        .filter((option) => option.episode)
+        .map((option) => ({
+        seasonNumber: option.episode?.seasonNumber,
+        episodeNumber: option.episode?.episodeNumber,
+        absoluteEpisodeNumber: option.episode?.absoluteEpisodeNumber,
+        options: [option],
+    }));
+}
+// Checks whether query ids overlap provider-supported external ID sources.
+// Проверяет, пересекаются ли query ids с поддерживаемыми провайдером источниками ID.
+function hasSupportedExternalId(ids, supportedSources) {
+    return Boolean(ids && supportedSources.some((source) => Boolean(ids[source])));
+}
+// Checks whether query targets a concrete episode.
+// Проверяет, нацелен ли query на конкретный эпизод.
+function hasEpisodeQuery(query) {
+    return (query.seasonNumber !== undefined ||
+        query.episodeNumber !== undefined ||
+        query.absoluteEpisodeNumber !== undefined);
+}
+// Creates a stable identity for an episode availability block.
+// Создает стабильную идентичность для блока доступности эпизода.
+function createEpisodeKey(episode) {
+    return [
+        episode.seasonNumber ?? "",
+        episode.episodeNumber ?? "",
+        episode.absoluteEpisodeNumber ?? "",
+    ].join(":");
+}
+// Creates a stable identity for provider source attribution.
+// Создает стабильную идентичность для атрибуции источника провайдера.
+function createStreamingSourceKey(source) {
+    return `${source.provider}:${source.url ?? ""}:${JSON.stringify(sortObject(source.ids ?? {}))}`;
+}
+// Keeps the first value for each derived key.
+// Оставляет первое значение для каждого вычисленного ключа.
+function uniqueBy(values, getKey) {
+    const seen = new Set();
+    const unique = [];
+    for (const value of values) {
+        const key = getKey(value);
+        if (!seen.has(key)) {
+            seen.add(key);
+            unique.push(value);
+        }
+    }
+    return unique;
+}
+//# sourceMappingURL=availability.js.map

package/dist/engine/availability.js.map

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