@digitalpaws/starr 0.0.1

package/dist/library/scan-controller.d.ts

@@ -0,0 +1,95 @@
+import type Database from "better-sqlite3";
+import type { EventBus, Logger } from "../types/plugin.js";
+import type { LibraryScanCandidate } from "@digitalpaws/starr-types-core";
+import { LibraryScanner } from "./library-scanner.js";
+import { MetadataMatcher } from "./metadata-matcher.js";
+import { LibraryCache } from "./library-cache.js";
+import type { ContentTypeRegistryImpl } from "../content-types/registry.js";
+import type { Importer } from "./importer.js";
+/**
+ * In-memory scan state, keyed by scanId.
+ */
+interface ScanState {
+    scanId: string;
+    status: "scanning" | "matching" | "complete" | "cancelled";
+    progress: {
+        total: number;
+        completed: number;
+        matched: number;
+        noMatch: number;
+        alreadyImported: number;
+    };
+    candidates: LibraryScanCandidate[];
+}
+export declare class ScanController {
+    private scanner;
+    private matcher;
+    private db;
+    private bus;
+    private logger;
+    private libraryCache;
+    private contentTypeRegistry;
+    private importer;
+    private concurrency;
+    constructor(scanner: LibraryScanner, matcher: MetadataMatcher, db: Database.Database, bus: EventBus, logger: Logger, libraryCache: LibraryCache, contentTypeRegistry: ContentTypeRegistryImpl, importer: Importer, concurrency?: number);
+    /**
+     * Start an async scan. Returns the scanId immediately.
+     * The scan runs in the background; progress is polled via getScan().
+     *
+     * @param libraryId Optional — scan only this library.
+     * @param contentTypeIds Optional — scan only roots for these content types.
+     */
+    startScan(libraryId?: string, contentTypeIds?: string[]): string;
+    /**
+     * Get the current state of a scan.
+     */
+    getScan(scanId: string): ScanState | undefined;
+    /**
+     * Cancel a running scan.
+     */
+    cancelScan(scanId: string): boolean;
+    /**
+     * Import accepted candidates into the library.
+     * Phase 1: Create tracked_request rows in a transaction (sync).
+     * Phase 2: Process each via the Importer (async) so library config
+     *          (roots, link type, subtitles, naming) is applied correctly.
+     */
+    importCandidates(scanId: string, candidateIds: string[]): Promise<{
+        imported: number;
+        failed: number;
+        errors: Array<{
+            id: string;
+            error: string;
+        }>;
+    }>;
+    /**
+     * Remove a completed scan from memory.
+     */
+    cleanupScan(scanId: string): void;
+    private runScan;
+    /**
+     * Run a custom search for a specific candidate and update its matches.
+     * Called from the API when the user clicks "Search again".
+     */
+    searchCandidate(scanId: string, candidateId: string, query: string): Promise<boolean>;
+    /**
+     * Update the user's selected match index for a candidate.
+     */
+    selectMatch(scanId: string, candidateId: string, matchIndex: number): boolean;
+    private groupToCandidate;
+    private emitProgress;
+    /**
+     * Create a tracked_request row for a scanned candidate.
+     * Runs inside a transaction. Returns the data the Importer needs,
+     * or null if the candidate has no media files.
+     *
+     * Unlike the old importSingleCandidate, this does NOT:
+     * - Insert into library_paths (the Importer handles that)
+     * - Set library_path on tracked_requests (the Importer sets it)
+     * - Emit events (the Importer emits them)
+     */
+    private createTrackedRequest;
+    private pickPrimaryFile;
+}
+export {};
+//# sourceMappingURL=scan-controller.d.ts.map

package/dist/library/scan-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-controller.d.ts","sourceRoot":"","sources":["../../src/library/scan-controller.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,oBAAoB,EAAmB,MAAM,+BAA+B,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC3D,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAmCD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAG1B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,mBAAmB,EAAE,uBAAuB,EAC5C,QAAQ,EAAE,QAAQ,EAClB,WAAW,SAAsB;IAanC;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAmBhE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOnC;;;;;OAKG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAmE9F;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;YAMnB,OAAO;IAiFrB;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IA4BnB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAW7E,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,YAAY;IAQpB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkF5B,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/library/scan-controller.js

@@ -0,0 +1,379 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { computeContentIdentity } from "../content-types/registry.js";
+const activeScans = new Map();
+const DEFAULT_CONCURRENCY = 3;
+/**
+ * Simple semaphore for concurrency control.
+ */
+class Semaphore {
+    max;
+    current = 0;
+    queue = [];
+    constructor(max) {
+        this.max = max;
+    }
+    async acquire() {
+        if (this.current < this.max) {
+            this.current++;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        if (this.queue.length > 0) {
+            const next = this.queue.shift();
+            next();
+        }
+        else {
+            this.current--;
+        }
+    }
+}
+export class ScanController {
+    scanner;
+    matcher;
+    db;
+    bus;
+    logger;
+    libraryCache;
+    contentTypeRegistry;
+    importer;
+    concurrency;
+    constructor(scanner, matcher, db, bus, logger, libraryCache, contentTypeRegistry, importer, concurrency = DEFAULT_CONCURRENCY) {
+        this.scanner = scanner;
+        this.matcher = matcher;
+        this.db = db;
+        this.bus = bus;
+        this.logger = logger.child("scan-controller");
+        this.libraryCache = libraryCache;
+        this.contentTypeRegistry = contentTypeRegistry;
+        this.importer = importer;
+        this.concurrency = concurrency;
+    }
+    /**
+     * Start an async scan. Returns the scanId immediately.
+     * The scan runs in the background; progress is polled via getScan().
+     *
+     * @param libraryId Optional — scan only this library.
+     * @param contentTypeIds Optional — scan only roots for these content types.
+     */
+    startScan(libraryId, contentTypeIds) {
+        const scanId = randomUUID();
+        const state = {
+            scanId,
+            status: "scanning",
+            progress: { total: 0, completed: 0, matched: 0, noMatch: 0, alreadyImported: 0 },
+            candidates: [],
+        };
+        activeScans.set(scanId, state);
+        // Run scan in background (not awaited)
+        this.runScan(scanId, state, libraryId, contentTypeIds).catch((err) => {
+            this.logger.error("scan failed", { scanId, error: String(err) });
+            state.status = "complete";
+        });
+        return scanId;
+    }
+    /**
+     * Get the current state of a scan.
+     */
+    getScan(scanId) {
+        return activeScans.get(scanId);
+    }
+    /**
+     * Cancel a running scan.
+     */
+    cancelScan(scanId) {
+        const state = activeScans.get(scanId);
+        if (!state || state.status === "complete")
+            return false;
+        state.status = "cancelled";
+        return true;
+    }
+    /**
+     * Import accepted candidates into the library.
+     * Phase 1: Create tracked_request rows in a transaction (sync).
+     * Phase 2: Process each via the Importer (async) so library config
+     *          (roots, link type, subtitles, naming) is applied correctly.
+     */
+    async importCandidates(scanId, candidateIds) {
+        const state = activeScans.get(scanId);
+        if (!state) {
+            return { imported: 0, failed: 0, errors: [] };
+        }
+        const errors = [];
+        // Phase 1: Create all tracked_request rows in a single transaction.
+        // Each entry captures what the Importer needs without doing the actual file I/O.
+        const pending = [];
+        const txn = this.db.transaction(() => {
+            for (const candidateId of candidateIds) {
+                const candidate = state.candidates.find((c) => c.id === candidateId);
+                if (!candidate) {
+                    errors.push({ id: candidateId, error: "candidate not found" });
+                    continue;
+                }
+                try {
+                    const result = this.createTrackedRequest(candidate);
+                    if (result)
+                        pending.push(result);
+                }
+                catch (err) {
+                    errors.push({ id: candidateId, error: err.message });
+                }
+            }
+        });
+        txn();
+        // Phase 2: Process each candidate through the Importer.
+        // The Importer handles file transfer (link type), subtitle importing,
+        // naming-rule resolution, library_path insertion, and event emission.
+        let imported = 0;
+        for (const p of pending) {
+            try {
+                const result = await this.importer.import(p.requestId, p.primaryFile, p.item, p.contentTypeId, p.extension, p.contentIdentity, p.libraryId);
+                if (result.success) {
+                    imported++;
+                }
+                else {
+                    errors.push({ id: p.requestId, error: result.error ?? "importer returned failure" });
+                }
+            }
+            catch (err) {
+                errors.push({ id: p.requestId, error: err.message });
+            }
+        }
+        return { imported, failed: errors.length, errors };
+    }
+    /**
+     * Remove a completed scan from memory.
+     */
+    cleanupScan(scanId) {
+        activeScans.delete(scanId);
+    }
+    // ── Private ──
+    async runScan(scanId, state, libraryId, contentTypeIds) {
+        // Phase 1: Discover groups
+        this.emitProgress(scanId, state);
+        const groups = await this.scanner.discoverGroups({ libraryId, contentTypeIds });
+        if (state.status === "cancelled")
+            return;
+        state.candidates = groups.map((g) => this.groupToCandidate(g));
+        state.progress.total = groups.length;
+        // Find already-imported items
+        const dirs = groups.map((g) => g.directory);
+        const existing = this.scanner.findExisting(dirs);
+        for (const candidate of state.candidates) {
+            if (existing.has(candidate.directory)) {
+                candidate.alreadyImported = true;
+                candidate.status = "already-imported";
+                candidate.accepted = false;
+                state.progress.alreadyImported++;
+            }
+        }
+        state.status = "matching";
+        this.emitProgress(scanId, state);
+        // Phase 2: Match metadata for non-imported candidates
+        const sem = new Semaphore(this.concurrency);
+        const matchTasks = state.candidates
+            .filter((c) => !c.alreadyImported)
+            .map(async (candidate) => {
+            await sem.acquire();
+            try {
+                if (state.status === "cancelled")
+                    return;
+                const group = groups.find((g) => g.directory === candidate.directory);
+                if (!group)
+                    return;
+                const matches = await this.matcher.findMatches(group);
+                if (matches.length > 0) {
+                    candidate.matches = matches;
+                    candidate.selectedMatchIndex = 0;
+                    candidate.status = "matched";
+                    candidate.accepted = true;
+                    state.progress.matched++;
+                }
+                else {
+                    candidate.matches = [];
+                    candidate.selectedMatchIndex = -1;
+                    candidate.status = "no-match";
+                    state.progress.noMatch++;
+                }
+                state.progress.completed++;
+                this.emitProgress(scanId, state);
+            }
+            catch (err) {
+                candidate.status = "error";
+                candidate.error = String(err);
+                state.progress.completed++;
+                this.emitProgress(scanId, state);
+            }
+            finally {
+                sem.release();
+            }
+        });
+        await Promise.all(matchTasks);
+        state.status = "complete";
+        this.emitProgress(scanId, state);
+        this.logger.info("scan complete", {
+            scanId,
+            total: state.progress.total,
+            matched: state.progress.matched,
+            noMatch: state.progress.noMatch,
+            alreadyImported: state.progress.alreadyImported,
+        });
+    }
+    /**
+     * Run a custom search for a specific candidate and update its matches.
+     * Called from the API when the user clicks "Search again".
+     */
+    async searchCandidate(scanId, candidateId, query) {
+        const state = activeScans.get(scanId);
+        if (!state)
+            return false;
+        const candidate = state.candidates.find((c) => c.id === candidateId);
+        if (!candidate)
+            return false;
+        try {
+            const matches = await this.matcher.searchCustom(candidate.folderName, query, candidate.contentTypeId);
+            candidate.matches = matches;
+            candidate.selectedMatchIndex = matches.length > 0 ? 0 : -1;
+            candidate.status = matches.length > 0 ? "matched" : "no-match";
+            candidate.accepted = matches.length > 0;
+            return true;
+        }
+        catch (err) {
+            this.logger.error("custom search failed", {
+                scanId,
+                candidateId,
+                error: String(err),
+            });
+            return false;
+        }
+    }
+    /**
+     * Update the user's selected match index for a candidate.
+     */
+    selectMatch(scanId, candidateId, matchIndex) {
+        const state = activeScans.get(scanId);
+        if (!state)
+            return false;
+        const candidate = state.candidates.find((c) => c.id === candidateId);
+        if (!candidate)
+            return false;
+        if (matchIndex < -1 || matchIndex >= candidate.matches.length)
+            return false;
+        candidate.selectedMatchIndex = matchIndex;
+        candidate.accepted = matchIndex >= 0;
+        return true;
+    }
+    groupToCandidate(group) {
+        return {
+            id: randomUUID(),
+            directory: group.directory,
+            files: group.files,
+            contentTypeId: group.contentTypeId,
+            libraryId: group.libraryId,
+            folderName: group.folderName,
+            matches: [],
+            selectedMatchIndex: -1,
+            accepted: false,
+            alreadyImported: false,
+            status: "pending",
+        };
+    }
+    emitProgress(scanId, state) {
+        this.bus.emit("library.scan.progress", {
+            scanId,
+            status: state.status,
+            progress: state.progress,
+        });
+    }
+    /**
+     * Create a tracked_request row for a scanned candidate.
+     * Runs inside a transaction. Returns the data the Importer needs,
+     * or null if the candidate has no media files.
+     *
+     * Unlike the old importSingleCandidate, this does NOT:
+     * - Insert into library_paths (the Importer handles that)
+     * - Set library_path on tracked_requests (the Importer sets it)
+     * - Emit events (the Importer emits them)
+     */
+    createTrackedRequest(candidate) {
+        const requestId = randomUUID();
+        // Get the selected match, if any
+        const selectedMatch = candidate.selectedMatchIndex >= 0 && candidate.selectedMatchIndex < candidate.matches.length
+            ? candidate.matches[candidate.selectedMatchIndex]
+            : null;
+        // Determine the correct contentTypeId: prefer the match's value when
+        // available (metadata sources return the real ID), otherwise fall back
+        // to the scanner-assigned ID (which may be "unknown" for default-root items).
+        const resolvedContentTypeId = selectedMatch
+            ? selectedMatch.item.contentTypeId
+            : candidate.contentTypeId;
+        // Build the ContentItemBase from selected match or folder name
+        const item = selectedMatch
+            ? { ...selectedMatch.item, contentTypeId: resolvedContentTypeId }
+            : {
+                contentTypeId: resolvedContentTypeId,
+                title: candidate.folderName,
+                externalIds: {},
+            };
+        // Pick the primary media file
+        const primaryFile = this.pickPrimaryFile(candidate.files);
+        // Compute content identity using the resolved content type ID
+        const contentIdentity = selectedMatch
+            ? computeContentIdentity({ contentTypeId: resolvedContentTypeId, externalIds: item.externalIds }, this.contentTypeRegistry)
+            : `${resolvedContentTypeId}::local::${candidate.folderName}`;
+        // Determine file extension for the Importer
+        const extension = path.extname(primaryFile).slice(1).toLowerCase() || "mkv";
+        const now = new Date().toISOString();
+        // Insert into tracked_requests — no library_path set here.
+        // The Importer will update it after the file transfer.
+        this.db
+            .prepare(`INSERT INTO tracked_requests
+           (request_id, content_type_id, content_identity, item,
+            owner_user_id, watchers, status, library_id, attempts, created_at, updated_at)
+         VALUES
+           (@requestId, @contentTypeId, @contentIdentity, @item,
+            @ownerUserId, '[]', 'downloaded', @libraryId, 0, @createdAt, @updatedAt)`)
+            .run({
+            requestId,
+            contentTypeId: resolvedContentTypeId,
+            contentIdentity,
+            item: JSON.stringify(item),
+            ownerUserId: "admin",
+            libraryId: candidate.libraryId ?? null,
+            createdAt: now,
+            updatedAt: now,
+        });
+        return {
+            requestId,
+            primaryFile,
+            item,
+            contentTypeId: resolvedContentTypeId,
+            extension,
+            contentIdentity,
+            libraryId: candidate.libraryId,
+        };
+    }
+    pickPrimaryFile(files) {
+        if (files.length === 0)
+            throw new Error("no media files to import");
+        if (files.length === 1)
+            return files[0];
+        // Prefer the file whose basename best matches the parent folder name
+        const dirName = path.basename(path.dirname(files[0]));
+        const exactMatch = files.find((f) => {
+            const base = path.basename(f, path.extname(f));
+            return base.toLowerCase() === dirName.toLowerCase();
+        });
+        if (exactMatch)
+            return exactMatch;
+        // Fall back to first file
+        return files[0];
+    }
+}
+//# sourceMappingURL=scan-controller.js.map

package/dist/library/scan-controller.js.map

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

package/dist/library/source-resolver.d.ts

@@ -0,0 +1,17 @@
+export interface ResolvedSource {
+    /** The directory containing the source files. */
+    sourceDir: string;
+    /** All media files found at the source location. */
+    files: string[];
+}
+/**
+ * Resolve the source path from a download.completed event.
+ *
+ * Resolution order:
+ * 1. If location is provided and the stripped path exists:
+ *    - If it is a file → return it as the only file
+ *    - If it is a directory → scan for media files
+ * 2. If all fail → throw with a descriptive message.
+ */
+export declare function resolveSourcePath(location: string | undefined): Promise<ResolvedSource>;
+//# sourceMappingURL=source-resolver.d.ts.map

package/dist/library/source-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-resolver.d.ts","sourceRoot":"","sources":["../../src/library/source-resolver.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAgCD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,cAAc,CAAC,CAgCzB"}

package/dist/library/source-resolver.js

@@ -0,0 +1,75 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import fs from "node:fs/promises";
+import path from "node:path";
+const MEDIA_EXTENSIONS = new Set([
+    "mkv", "mp4", "avi", "mov", "wmv", "flv", "webm",
+    "m4v", "mpg", "mpeg", "ts", "m2ts",
+]);
+/**
+ * Return true if the file extension looks like a media file.
+ */
+function isMediaFile(filePath) {
+    const ext = path.extname(filePath).slice(1).toLowerCase();
+    return MEDIA_EXTENSIONS.has(ext);
+}
+/**
+ * Scan a directory (non-recursive) for media files.
+ * Skips hidden directories and common non-content subdirectories.
+ */
+async function scanDirectory(dir) {
+    const results = [];
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            // Skip common non-content directories
+            if (entry.name.startsWith("."))
+                continue;
+            if (entry.name === "Extras" || entry.name === "Sample" || entry.name === "samples")
+                continue;
+            const nested = await scanDirectory(fullPath);
+            results.push(...nested);
+        }
+        else if (entry.isFile() && isMediaFile(fullPath)) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/**
+ * Resolve the source path from a download.completed event.
+ *
+ * Resolution order:
+ * 1. If location is provided and the stripped path exists:
+ *    - If it is a file → return it as the only file
+ *    - If it is a directory → scan for media files
+ * 2. If all fail → throw with a descriptive message.
+ */
+export async function resolveSourcePath(location) {
+    if (!location) {
+        throw new Error("Cannot resolve source path: no location provided on download.completed");
+    }
+    // Strip protocol prefix (e.g. "qbittorrent:/path" → "/path")
+    const colonIdx = location.indexOf(":");
+    const strippedPath = colonIdx >= 0 ? location.slice(colonIdx + 1) : location;
+    try {
+        const stat = await fs.stat(strippedPath);
+        if (stat.isFile()) {
+            const dir = path.dirname(strippedPath);
+            return { sourceDir: dir, files: [strippedPath] };
+        }
+        if (stat.isDirectory()) {
+            const files = await scanDirectory(strippedPath);
+            if (files.length === 0) {
+                throw new Error(`No media files found in directory: ${strippedPath}`);
+            }
+            return { sourceDir: strippedPath, files };
+        }
+    }
+    catch (err) {
+        throw new Error(`Cannot access source path "${strippedPath}": ${err.message}`, { cause: err });
+    }
+    throw new Error(`Source path is neither a file nor a directory: ${strippedPath}`);
+}
+//# sourceMappingURL=source-resolver.js.map

package/dist/library/source-resolver.js.map

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

package/dist/logging/logger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "../types/plugin.js";
+export declare function createLogger(tag?: string, levelName?: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAoBjD,wBAAgB,YAAY,CAAC,GAAG,SAAS,EAAE,SAAS,SAAS,GAAG,MAAM,CAuFrE"}