@digitalpaws/starr 0.0.1

package/dist/events/spine.js

@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+/**
+ * Reserved spine namespace prefixes.
+ * The dotted unprefixed namespace is reserved for the core spine.
+ */
+export const SPINE_NAMESPACES = [
+    "content.",
+    "release.",
+    "download.",
+    "import.",
+    "library.",
+    "discovery.",
+    "item.",
+];
+/**
+ * The v1 spine event catalog (spec §8).
+ */
+export const SPINE_EVENTS = {
+    "discovery.search": { kind: "request", producers: "core", schemaVersion: 1 },
+    "discovery.results": { kind: "reply", producers: "metadata-plugin", schemaVersion: 1 },
+    "content.requested": { kind: "request", producers: "core", schemaVersion: 2 },
+    "release.found": { kind: "reply", producers: "indexer-plugin", schemaVersion: 1 },
+    "release.chosen": { kind: "notification", producers: "selection-plugin", schemaVersion: 1 },
+    "download.started": { kind: "notification", producers: "downloader-plugin", schemaVersion: 1 },
+    "download.completed": { kind: "notification", producers: "downloader-plugin", schemaVersion: 1 },
+    "download.failed": { kind: "notification", producers: "downloader-plugin", schemaVersion: 1 },
+    "request.failed": { kind: "notification", producers: "selection-plugin", schemaVersion: 1 },
+    "item.updated": { kind: "notification", producers: "core", schemaVersion: 1 },
+    "request.deleted": { kind: "notification", producers: "core", schemaVersion: 1 },
+    "import.started": { kind: "notification", producers: "core", schemaVersion: 1 },
+    "import.completed": { kind: "notification", producers: "core", schemaVersion: 1 },
+    "import.failed": { kind: "notification", producers: "core", schemaVersion: 1 },
+    "library.file_added": { kind: "notification", producers: "core", schemaVersion: 1 },
+};
+/**
+ * Check whether an event type falls within the reserved spine namespace.
+ */
+export function isSpineType(type) {
+    return SPINE_NAMESPACES.some((ns) => type.startsWith(ns));
+}
+/**
+ * Return the schemaVersion for a spine type, or 1 as default for custom events.
+ */
+export function getSpineSchemaVersion(type) {
+    return SPINE_EVENTS[type]?.schemaVersion ?? 1;
+}
+/**
+ * Validate whether a source is allowed to emit the given spine event type.
+ *
+ * Returns an error message string if the emission is suspect, or null if it is fine.
+ * Per EBQ4 resolution, this only logs warnings; it does not reject.
+ */
+export function validateSpineEmission(source, type) {
+    if (!isSpineType(type))
+        return null; // custom event, fine
+    const meta = SPINE_EVENTS[type];
+    if (!meta) {
+        return `Unknown spine event type "${type}" emitted by "${source}"`;
+    }
+    // For v1 we are lenient: log but don't block.
+    // Only flag if core events are emitted by non-core sources.
+    if (meta.producers === "core" && source !== "core") {
+        return `Spine event "${type}" is reserved for core, but was emitted by "${source}"`;
+    }
+    return null;
+}
+//# sourceMappingURL=spine.js.map

package/dist/events/spine.js.map

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

package/dist/events/trace.d.ts

@@ -0,0 +1,24 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { StarrEvent } from "../types/plugin.js";
+/**
+ * Singleton AsyncLocalStorage that holds the "current event" during handler dispatch.
+ * This is the core trace-propagation mechanism (spec §5 PS2, EBQ5).
+ */
+export declare const traceStore: AsyncLocalStorage<StarrEvent<unknown>>;
+/**
+ * Run a function within the trace context of the given event.
+ * Any emit() calls inside fn will inherit this event's traceId.
+ */
+export declare function runInTraceContext<R>(event: StarrEvent, fn: () => R): R;
+/**
+ * Return the traceId of the currently handled event, or mint a fresh one
+ * if called outside any handler (root emission — spec §5 PS3).
+ */
+export declare function getCurrentTraceId(): string;
+/**
+ * Return the correlationId of the currently handled event, or undefined.
+ * correlationId is NOT automatically propagated by plain emit() —
+ * it is only attached via explicit opts or the reply() sugar (§5 PS2, §6.1).
+ */
+export declare function getCurrentCorrelationId(): string | undefined;
+//# sourceMappingURL=trace.d.ts.map

package/dist/events/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/events/trace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,UAAU,wCAAsC,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAE5D"}

package/dist/events/trace.js

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
+/**
+ * Singleton AsyncLocalStorage that holds the "current event" during handler dispatch.
+ * This is the core trace-propagation mechanism (spec §5 PS2, EBQ5).
+ */
+export const traceStore = new AsyncLocalStorage();
+/**
+ * Run a function within the trace context of the given event.
+ * Any emit() calls inside fn will inherit this event's traceId.
+ */
+export function runInTraceContext(event, fn) {
+    return traceStore.run(event, fn);
+}
+/**
+ * Return the traceId of the currently handled event, or mint a fresh one
+ * if called outside any handler (root emission — spec §5 PS3).
+ */
+export function getCurrentTraceId() {
+    const event = traceStore.getStore();
+    return event ? event.traceId : randomUUID();
+}
+/**
+ * Return the correlationId of the currently handled event, or undefined.
+ * correlationId is NOT automatically propagated by plain emit() —
+ * it is only attached via explicit opts or the reply() sugar (§5 PS2, §6.1).
+ */
+export function getCurrentCorrelationId() {
+    return traceStore.getStore()?.correlationId;
+}
+//# sourceMappingURL=trace.js.map

package/dist/events/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/events/trace.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,4DAA4D;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAI,KAAiB,EAAE,EAAW;IACjE,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC;AAC9C,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,65 @@
+import type { EventBus, Logger, PluginLifecycle, PluginMeta } from "./types/plugin.js";
+import type { Datastore } from "./datastore/db.js";
+import type { ConfigService } from "./config/config-service.js";
+import type { FastifyInstance } from "fastify";
+import type Database from "better-sqlite3";
+import { EventBusImpl } from "./events/event-bus.js";
+import { ContentTypeRegistryImpl } from "./content-types/registry.js";
+import type { StateStore } from "./state/state-store.js";
+import type { Importer } from "./library/importer.js";
+import type { LibraryCache } from "./library/library-cache.js";
+import type { LibraryService } from "./library/library-service.js";
+import type { ScanController } from "./library/scan-controller.js";
+export interface StarrOptions {
+    pluginsDir: string;
+    apiVersion: string;
+    logger: Logger;
+}
+export interface PluginRuntime {
+    meta: PluginMeta;
+    lifecycle: PluginLifecycle;
+    startOrder: number;
+}
+export declare class Starr {
+    readonly options: StarrOptions;
+    readonly logger: Logger;
+    readonly apiVersion: string;
+    datastore: Datastore | null;
+    private _eventBus;
+    /**
+     * Public EventBus interface (exposed for wiring context).
+     */
+    get eventBus(): EventBus;
+    /**
+     * Internal accessor for EventBusImpl (used by context to create plugin-bound buses).
+     */
+    get busImpl(): EventBusImpl;
+    /**
+     * Core event bus with source="core". Convenience for emitting spine events from the host.
+     */
+    get coreBus(): EventBus;
+    contentTypeRegistry: ContentTypeRegistryImpl;
+    configService: ConfigService | null;
+    stateStore: StateStore | null;
+    importer: Importer | null;
+    libraryCache: LibraryCache | null;
+    libraryService: LibraryService | null;
+    scanController: ScanController | null;
+    webServer: FastifyInstance | null;
+    private pluginRuntimes;
+    private running;
+    getScanController(): ScanController;
+    getLibraryCache(): LibraryCache;
+    getLibraryService(): LibraryService;
+    getImporter(): Importer;
+    /** Convenience: get the state store or throw if not initialized. */
+    getStateStore(): StateStore;
+    getDatabase(): Database.Database | null;
+    constructor(options: StarrOptions);
+    markRunning(): void;
+    markStopped(): void;
+    get isRunning(): boolean;
+    setRuntimes(runtimes: PluginRuntime[]): void;
+    getRuntimes(): readonly PluginRuntime[];
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAG5B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;IACnC,OAAO,CAAC,SAAS,CAAe;IAEhC;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,QAAQ,CAEtB;IACD,mBAAmB,EAAE,uBAAuB,CAAiC;IAC7E,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAC3C,UAAU,EAAE,UAAU,GAAG,IAAI,CAAQ;IACrC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IACzC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAQ;IAC7C,cAAc,EAAE,cAAc,GAAG,IAAI,CAAQ;IAC7C,SAAS,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEzC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,OAAO,CAAS;IAExB,iBAAiB,IAAI,cAAc;IAKnC,eAAe,IAAI,YAAY;IAK/B,iBAAiB,IAAI,cAAc;IAKnC,WAAW,IAAI,QAAQ;IAKvB,oEAAoE;IACpE,aAAa,IAAI,UAAU;IAO3B,WAAW,IAAI,QAAQ,CAAC,QAAQ,GAAG,IAAI;gBAI3B,OAAO,EAAE,YAAY;IAOjC,WAAW,IAAI,IAAI;IAKnB,WAAW,IAAI,IAAI;IAKnB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI;IAI5C,WAAW,IAAI,SAAS,aAAa,EAAE;CAGxC"}

package/dist/host.js

@@ -0,0 +1,94 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import { EventBusImpl } from "./events/event-bus.js";
+import { ContentTypeRegistryImpl } from "./content-types/registry.js";
+export class Starr {
+    options;
+    logger;
+    apiVersion;
+    // Service slots to be wired by later tasks.
+    datastore = null;
+    _eventBus;
+    /**
+     * Public EventBus interface (exposed for wiring context).
+     */
+    get eventBus() {
+        return this._eventBus.coreBus();
+    }
+    /**
+     * Internal accessor for EventBusImpl (used by context to create plugin-bound buses).
+     */
+    get busImpl() {
+        return this._eventBus;
+    }
+    /**
+     * Core event bus with source="core". Convenience for emitting spine events from the host.
+     */
+    get coreBus() {
+        return this._eventBus.coreBus();
+    }
+    contentTypeRegistry = new ContentTypeRegistryImpl();
+    configService = null;
+    stateStore = null;
+    importer = null;
+    libraryCache = null;
+    libraryService = null;
+    scanController = null;
+    webServer = null;
+    pluginRuntimes = [];
+    running = false;
+    getScanController() {
+        if (!this.scanController)
+            throw new Error("scan controller not initialized");
+        return this.scanController;
+    }
+    getLibraryCache() {
+        if (!this.libraryCache)
+            throw new Error("library cache not initialized");
+        return this.libraryCache;
+    }
+    getLibraryService() {
+        if (!this.libraryService)
+            throw new Error("library service not initialized");
+        return this.libraryService;
+    }
+    getImporter() {
+        if (!this.importer)
+            throw new Error("importer not initialized");
+        return this.importer;
+    }
+    /** Convenience: get the state store or throw if not initialized. */
+    getStateStore() {
+        if (!this.stateStore) {
+            throw new Error("state store not initialized");
+        }
+        return this.stateStore;
+    }
+    getDatabase() {
+        return this.datastore?.db ?? null;
+    }
+    constructor(options) {
+        this.options = options;
+        this.logger = options.logger.child("host");
+        this.apiVersion = options.apiVersion;
+        this._eventBus = new EventBusImpl(this.logger);
+    }
+    markRunning() {
+        this.running = true;
+        this.logger.info("running");
+    }
+    markStopped() {
+        this.running = false;
+        this.logger.info("stopped");
+    }
+    get isRunning() {
+        return this.running;
+    }
+    setRuntimes(runtimes) {
+        this.pluginRuntimes = runtimes;
+    }
+    getRuntimes() {
+        return this.pluginRuntimes;
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

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

package/dist/library/importer.d.ts

@@ -0,0 +1,29 @@
+import type Database from "better-sqlite3";
+import type { EventBus, Logger } from "../types/plugin.js";
+import type { ContentItemBase, NamingRule } from "@digitalpaws/starr-types-core";
+import type { LibraryConfig } from "./library-config.js";
+import type { LibraryService } from "./library-service.js";
+export interface ImportResult {
+    success: boolean;
+    libraryPath?: string;
+    error?: string;
+}
+export declare class Importer {
+    private db;
+    private bus;
+    private logger;
+    private getConfig;
+    private getNamingRule;
+    private libraryService?;
+    private stmtUpsertPath;
+    private stmtUpdateRequestPath;
+    constructor(db: Database.Database, bus: EventBus, logger: Logger, getConfig: () => LibraryConfig, getNamingRule: (contentTypeId: string) => NamingRule, libraryService?: LibraryService);
+    import(requestId: string, sourcePath: string, item: ContentItemBase, contentTypeId: string, extension: string, 
+    /** The pre-computed content identity for this item. */
+    contentIdentity: string, 
+    /** Optional library ID for multi-library support. */
+    libraryId?: string): Promise<ImportResult>;
+    private transferFile;
+    private importSubtitles;
+}
+//# sourceMappingURL=importer.d.ts.map

package/dist/library/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../src/library/importer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,cAAc,CAAC,CAAiB;IAExC,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,qBAAqB,CAAqB;gBAGhD,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,aAAa,EAC9B,aAAa,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,UAAU,EACpD,cAAc,CAAC,EAAE,cAAc;IAwB3B,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,eAAe,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM;IACjB,uDAAuD;IACvD,eAAe,EAAE,MAAM;IACvB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC;YAoEV,YAAY;YAUZ,eAAe;CA0B9B"}

package/dist/library/importer.js

@@ -0,0 +1,145 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import fs from "node:fs/promises";
+import path from "node:path";
+import { resolveNaming } from "./naming.js";
+export class Importer {
+    db;
+    bus;
+    logger;
+    getConfig;
+    getNamingRule;
+    libraryService;
+    stmtUpsertPath;
+    stmtUpdateRequestPath;
+    constructor(db, bus, logger, getConfig, getNamingRule, libraryService) {
+        this.db = db;
+        this.bus = bus;
+        this.logger = logger.child("importer");
+        this.getConfig = getConfig;
+        this.getNamingRule = getNamingRule;
+        this.libraryService = libraryService;
+        this.stmtUpsertPath = db.prepare(`
+      INSERT INTO library_paths (request_id, library_path, library_root, imported_at, updated_at)
+      VALUES (@requestId, @libraryPath, @libraryRoot, datetime('now'), datetime('now'))
+      ON CONFLICT(request_id) DO UPDATE SET
+        library_path = excluded.library_path,
+        updated_at = datetime('now')
+    `);
+        this.stmtUpdateRequestPath = db.prepare(`
+      UPDATE tracked_requests
+      SET library_path = @libraryPath, updated_at = datetime('now')
+      WHERE request_id = @requestId
+    `);
+    }
+    async import(requestId, sourcePath, item, contentTypeId, extension, 
+    /** The pre-computed content identity for this item. */
+    contentIdentity, 
+    /** Optional library ID for multi-library support. */
+    libraryId) {
+        try {
+            this.bus.emit("import.started", { requestId });
+            // Determine library config
+            let libraryRoot;
+            let linkType;
+            let importSubtitles;
+            let subtitleExtensions;
+            if (libraryId && this.libraryService) {
+                const lib = this.libraryService.get(libraryId);
+                if (lib) {
+                    libraryRoot = lib.roots[contentTypeId] ?? lib.defaultLibraryRoot;
+                    linkType = lib.linkType;
+                    importSubtitles = lib.importSubtitles;
+                    subtitleExtensions = lib.subtitleExtensions;
+                }
+                else {
+                    // Fallback to global config
+                    const cfg = this.getConfig();
+                    libraryRoot = cfg.roots[contentTypeId] ?? cfg.defaultLibraryRoot;
+                    linkType = cfg.linkType;
+                    importSubtitles = cfg.importSubtitles;
+                    subtitleExtensions = cfg.subtitleExtensions;
+                }
+            }
+            else {
+                // Fallback to global config
+                const cfg = this.getConfig();
+                libraryRoot = cfg.roots[contentTypeId] ?? cfg.defaultLibraryRoot;
+                linkType = cfg.linkType;
+                importSubtitles = cfg.importSubtitles;
+                subtitleExtensions = cfg.subtitleExtensions;
+            }
+            const namingRule = this.getNamingRule(contentTypeId);
+            const relativePath = resolveNaming(namingRule, item, extension);
+            const destPath = path.join(libraryRoot, relativePath);
+            await fs.mkdir(path.dirname(destPath), { recursive: true });
+            await this.transferFile(sourcePath, destPath, linkType);
+            if (importSubtitles) {
+                await this.importSubtitles(sourcePath, destPath, subtitleExtensions);
+            }
+            this.stmtUpsertPath.run({
+                requestId,
+                libraryPath: destPath,
+                libraryRoot,
+            });
+            this.stmtUpdateRequestPath.run({ requestId, libraryPath: destPath });
+            this.bus.emit("import.completed", { requestId, libraryPath: destPath });
+            this.bus.emit("library.file_added", {
+                requestId,
+                libraryPath: destPath,
+                contentTypeId,
+                contentIdentity,
+            });
+            return { success: true, libraryPath: destPath };
+        }
+        catch (err) {
+            const error = String(err);
+            this.bus.emit("import.failed", { requestId, error });
+            return { success: false, error };
+        }
+    }
+    async transferFile(src, dest, linkType) {
+        switch (linkType) {
+            case "move":
+                await fs.rename(src, dest);
+                break;
+            case "hardlink":
+                await fs.link(src, dest);
+                break;
+            case "symlink":
+                await fs.symlink(src, dest);
+                break;
+            case "copy":
+                await fs.copyFile(src, dest);
+                break;
+            default: throw new Error(`Unknown link type: ${linkType}`);
+        }
+    }
+    async importSubtitles(src, dest, subtitleExtensions) {
+        const srcDir = path.dirname(src);
+        const baseName = path.basename(src, path.extname(src));
+        const destDir = path.dirname(dest);
+        const destBaseName = path.basename(dest, path.extname(dest));
+        const entries = await fs.readdir(srcDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            const ext = path.extname(entry.name).slice(1).toLowerCase();
+            if (!subtitleExtensions.includes(ext))
+                continue;
+            const entryBaseName = path.basename(entry.name, path.extname(entry.name));
+            if (!entryBaseName.startsWith(baseName))
+                continue;
+            const srcSub = path.join(srcDir, entry.name);
+            const destSubName = entry.name.replace(baseName, destBaseName);
+            const destSub = path.join(destDir, destSubName);
+            try {
+                await this.transferFile(srcSub, destSub, "copy");
+            }
+            catch (err) {
+                this.logger.warn("failed to import subtitle", { src: srcSub, error: String(err) });
+            }
+        }
+    }
+}
+//# sourceMappingURL=importer.js.map

package/dist/library/importer.js.map

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

package/dist/library/library-cache.d.ts

@@ -0,0 +1,46 @@
+import type Database from "better-sqlite3";
+import type { EventBus, Logger } from "../types/plugin.js";
+/**
+ * A single row in the library_cache table, exposed to the API.
+ */
+export interface CachedLibraryItem {
+    requestId: string;
+    contentTypeId: string;
+    title: string;
+    sortTitle?: string;
+    summary?: string;
+    releaseDate?: string;
+    images: any[];
+    externalIds: Record<string, string>;
+    fields?: Record<string, unknown>;
+    libraryPath: string;
+    fileSize?: number;
+    importedAt: string;
+}
+export declare class LibraryCache {
+    private db;
+    private bus;
+    private logger;
+    private stmtInsert;
+    private stmtDelete;
+    private stmtGetAll;
+    private stmtGetByType;
+    private stmtCount;
+    constructor(db: Database.Database, bus: EventBus, logger: Logger);
+    /**
+     * Populate the cache from tracked_requests on startup.
+     */
+    refreshFromDb(): void;
+    /**
+     * Return all cached library items, optionally filtered by content type.
+     */
+    getItems(contentTypeId?: string): CachedLibraryItem[];
+    /**
+     * Return total count of cached items.
+     */
+    count(): number;
+    private onFileAdded;
+    private onRequestDeleted;
+    private rowToItem;
+}
+//# sourceMappingURL=library-cache.d.ts.map

package/dist/library/library-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-cache.d.ts","sourceRoot":"","sources":["../../src/library/library-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAc,MAAM,oBAAoB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,SAAS,CAAqB;gBAE1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;IA0ChE;;OAEG;IACH,aAAa,IAAI,IAAI;IAuCrB;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQrD;;OAEG;IACH,KAAK,IAAI,MAAM;IAMf,OAAO,CAAC,WAAW;IAkDnB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,SAAS;CAgBlB"}