@digitalpaws/starr 0.0.1

package/dist/logging/logger.js

@@ -0,0 +1,107 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import { env } from "node:process";
+import path from "node:path";
+import fs from "node:fs";
+const LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };
+function resolveLogFilePath() {
+    const explicit = env.STARR_LOG_FILE;
+    if (explicit === "")
+        return undefined; // disabled
+    if (explicit)
+        return path.resolve(explicit);
+    const dataDir = env.STARR_DATA_DIR ?? "./data";
+    return path.resolve(dataDir, "logs", "starr.log");
+}
+function ensureLogDir(logPath) {
+    const dir = path.dirname(logPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+export function createLogger(tag = "core", levelName = "info") {
+    const consoleLevel = LEVELS[levelName] ?? LEVELS.info;
+    const fileLevelName = env.STARR_LOG_FILE_LEVEL ?? levelName;
+    const fileLevel = LEVELS[fileLevelName] ?? consoleLevel;
+    const logFilePath = resolveLogFilePath();
+    let fileHandle;
+    let fileErrorLogged = false;
+    function openFile() {
+        if (!logFilePath)
+            return undefined;
+        try {
+            ensureLogDir(logFilePath);
+            return fs.openSync(logFilePath, "a");
+        }
+        catch (err) {
+            if (!fileErrorLogged) {
+                console.warn(JSON.stringify({
+                    timestamp: new Date().toISOString(),
+                    level: "warn",
+                    tag: "core/logging",
+                    message: "Failed to open log file",
+                    path: logFilePath,
+                    error: String(err),
+                }));
+                fileErrorLogged = true;
+            }
+            return undefined;
+        }
+    }
+    function log(level, message, meta) {
+        const levelValue = LEVELS[level] ?? LEVELS.info;
+        const line = {
+            timestamp: new Date().toISOString(),
+            level,
+            tag,
+            message,
+            ...(meta ?? {}),
+        };
+        // Console sink
+        if (levelValue >= consoleLevel) {
+            console.log(JSON.stringify(line));
+        }
+        // File sink
+        if (logFilePath && levelValue >= fileLevel) {
+            if (fileHandle === undefined) {
+                fileHandle = openFile();
+            }
+            if (fileHandle !== undefined) {
+                try {
+                    fs.writeSync(fileHandle, JSON.stringify(line) + "\n");
+                }
+                catch (err) {
+                    if (!fileErrorLogged) {
+                        console.warn(JSON.stringify({
+                            timestamp: new Date().toISOString(),
+                            level: "warn",
+                            tag: "core/logging",
+                            message: "Failed to write to log file",
+                            path: logFilePath,
+                            error: String(err),
+                        }));
+                        fileErrorLogged = true;
+                    }
+                }
+            }
+        }
+    }
+    if (fileHandle !== undefined) {
+        process.once("exit", () => {
+            try {
+                fs.closeSync(fileHandle);
+            }
+            catch {
+                // ignore close errors
+            }
+        });
+    }
+    return {
+        debug: (m, meta) => log("debug", m, meta),
+        info: (m, meta) => log("info", m, meta),
+        warn: (m, meta) => log("warn", m, meta),
+        error: (m, meta) => log("error", m, meta),
+        child: (childTag) => createLogger(`${tag}/${childTag}`, levelName),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,36 @@
+export type { PluginContext, PluginLifecycle, PluginMeta, ConfigSchema, ConfigField, Logger, EventBus, PluginStorage, ContentTypeRegistry, RegisterFn, StarrEvent, EventHandler, Unsubscribe, EmitOpts, RequestOpts, ConnectionTestResult, } from "./types/plugin.js";
+export { SPINE_EVENTS, SPINE_NAMESPACES, isSpineType, validateSpineEmission, } from "./events/spine.js";
+export { EventBusImpl } from "./events/event-bus.js";
+export { Starr } from "./host.js";
+export type { StarrOptions, PluginRuntime } from "./host.js";
+export { createLogger } from "./logging/logger.js";
+export { discoverPluginDirs } from "./plugins/discovery.js";
+export { createContext } from "./plugins/context.js";
+export { loadPlugins, stopPlugins } from "./plugins/loader.js";
+export { ContentTypeRegistryImpl, validateDescriptor, computeContentIdentity, areSameItem, } from "./content-types/registry.js";
+export { StateStore } from "./state/state-store.js";
+export type { TrackedRequest, TrackedRequestData, RequestStatus, TraceEntry, } from "./state/state-store.js";
+export { requestIntake } from "./state/request-intake.js";
+export type { RequestIntakeInput } from "./state/request-intake.js";
+export { AuthService } from "./auth/auth-service.js";
+export { createAuthServer, authenticate, withAuth, parseCookies, COOKIE_NAME } from "./auth/http-server.js";
+export { loadJwtSecret, getJwtSecret, resetJwtSecret } from "./auth/jwt-secret.js";
+export { RateLimiter } from "./auth/rate-limiter.js";
+export { Importer } from "./library/importer.js";
+export type { ImportResult } from "./library/importer.js";
+export { LibraryService } from "./library/library-service.js";
+export type { Library, LibraryInput } from "./library/library-service.js";
+export { resolveNaming } from "./library/naming.js";
+export type { NamingRule, NamingSegment } from "@digitalpaws/starr-types-core";
+export { DEFAULT_LIBRARY_CONFIG } from "./library/library-config.js";
+export type { LibraryConfig, LibraryRoots } from "./library/library-config.js";
+export { LibraryCache } from "./library/library-cache.js";
+export type { CachedLibraryItem } from "./library/library-cache.js";
+export { resolveSourcePath } from "./library/source-resolver.js";
+export type { ResolvedSource } from "./library/source-resolver.js";
+export { LibraryScanner } from "./library/library-scanner.js";
+export type { DiscoveredGroup } from "./library/library-scanner.js";
+export { MetadataMatcher } from "./library/metadata-matcher.js";
+export type { MatchResult } from "./library/metadata-matcher.js";
+export { ScanController } from "./library/scan-controller.js";
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,aAAa,EACb,eAAe,EACf,UAAU,EACV,YAAY,EACZ,WAAW,EACX,MAAM,EACN,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,WAAW,EACX,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,GACZ,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/main.js

@@ -0,0 +1,229 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+export { SPINE_EVENTS, SPINE_NAMESPACES, isSpineType, validateSpineEmission, } from "./events/spine.js";
+export { EventBusImpl } from "./events/event-bus.js";
+export { Starr } from "./host.js";
+export { createLogger } from "./logging/logger.js";
+export { discoverPluginDirs } from "./plugins/discovery.js";
+export { createContext } from "./plugins/context.js";
+export { loadPlugins, stopPlugins } from "./plugins/loader.js";
+export { ContentTypeRegistryImpl, validateDescriptor, computeContentIdentity, areSameItem, } from "./content-types/registry.js";
+export { StateStore } from "./state/state-store.js";
+export { requestIntake } from "./state/request-intake.js";
+export { AuthService } from "./auth/auth-service.js";
+export { createAuthServer, authenticate, withAuth, parseCookies, COOKIE_NAME } from "./auth/http-server.js";
+export { loadJwtSecret, getJwtSecret, resetJwtSecret } from "./auth/jwt-secret.js";
+export { RateLimiter } from "./auth/rate-limiter.js";
+export { Importer } from "./library/importer.js";
+export { LibraryService } from "./library/library-service.js";
+export { resolveNaming } from "./library/naming.js";
+export { DEFAULT_LIBRARY_CONFIG } from "./library/library-config.js";
+export { LibraryCache } from "./library/library-cache.js";
+export { resolveSourcePath } from "./library/source-resolver.js";
+export { LibraryScanner } from "./library/library-scanner.js";
+export { MetadataMatcher } from "./library/metadata-matcher.js";
+export { ScanController } from "./library/scan-controller.js";
+// Bootstrap — only run when this module is the entry point (not during tests/imports).
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+const isMain = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+if (isMain) {
+    const { Starr } = await import("./host.js");
+    const { createLogger } = await import("./logging/logger.js");
+    const { loadPlugins, stopPlugins } = await import("./plugins/loader.js");
+    const { openDatastore } = await import("./datastore/db.js");
+    const { runMigrations, CORE_MIGRATIONS } = await import("./datastore/migrations.js");
+    const { loadEncryptionKey } = await import("./datastore/encrypt.js");
+    const { ConfigService } = await import("./config/config-service.js");
+    const { StateStore } = await import("./state/state-store.js");
+    const { loadJwtSecret } = await import("./auth/jwt-secret.js");
+    const { AuthService } = await import("./auth/auth-service.js");
+    const { createWebServer, initAuthService, initOidcServices } = await import("./web/index.js");
+    const { initContentTypeRoutes } = await import("./web/routes/content-types.js");
+    const { initDiscoveryRoutes } = await import("./web/routes/discovery.js");
+    const { initRequestRoutes } = await import("./web/routes/requests.js");
+    const { initConfigRoutes } = await import("./web/routes/config.js");
+    const { initActivityRoutes } = await import("./web/routes/activity.js");
+    const { initSseRoutes } = await import("./web/routes/sse.js");
+    const { initAuthRoutes } = await import("./web/routes/auth.js");
+    const { initTraceStore } = await import("./state/trace-store.js");
+    const { OidcProviderService } = await import("./auth/oidc/oidc-provider-service.js");
+    const { UserService } = await import("./auth/oidc/user-service.js");
+    const { OidcFlow } = await import("./auth/oidc/oidc-flow.js");
+    const { Importer } = await import("./library/importer.js");
+    const { getNamingRule } = await import("./content-types/registry.js");
+    const { DEFAULT_LIBRARY_CONFIG } = await import("./library/library-config.js");
+    const { LibraryService } = await import("./library/library-service.js");
+    const { LibraryCache } = await import("./library/library-cache.js");
+    const { initLibraryRoutes } = await import("./web/routes/library.js");
+    const { initLibraryManagementRoutes } = await import("./web/routes/library-management.js");
+    const { initLibraryImportRoutes } = await import("./web/routes/library-import.js");
+    const { LibraryScanner } = await import("./library/library-scanner.js");
+    const { MetadataMatcher } = await import("./library/metadata-matcher.js");
+    const { ScanController } = await import("./library/scan-controller.js");
+    const { resolveSourcePath } = await import("./library/source-resolver.js");
+    async function main() {
+        const pluginsDir = path.resolve(process.env.STARR_PLUGINS_DIR ?? "./plugins");
+        const dataDir = path.resolve(process.env.STARR_DATA_DIR ?? "./data");
+        const apiVersion = process.env.STARR_API_VERSION ?? "1.0.0";
+        const logLevel = process.env.STARR_LOG_LEVEL ?? "info";
+        const logger = createLogger("core", logLevel);
+        // 1. Open datastore
+        const datastore = openDatastore(dataDir, logger);
+        // 2. Run core migrations
+        runMigrations(datastore.db, CORE_MIGRATIONS, logger);
+        // 3. Load encryption key
+        loadEncryptionKey(dataDir, logger);
+        // 3a. Load JWT secret
+        loadJwtSecret(dataDir, logger);
+        // 4. Create host
+        const starr = new Starr({ pluginsDir, apiVersion, logger });
+        starr.datastore = datastore;
+        // 5. Create ConfigService (after datastore and encryption are ready)
+        const configService = new ConfigService(datastore.db, logger.child("config"), 
+        // Reload callback — use lazy import to avoid circular deps
+        async (pluginId) => {
+            const { reloadPlugin } = await import("./plugins/loader.js");
+            await reloadPlugin(starr, pluginId);
+        });
+        starr.configService = configService;
+        // 6. Initialize state store (subscribes to spine events)
+        const stateStore = new StateStore(datastore.db, starr.coreBus, logger);
+        starr.stateStore = stateStore;
+        // 5a. Create LibraryService (after migrations so table exists)
+        const libraryService = new LibraryService(datastore.db, starr.coreBus, logger.child("library-service"));
+        starr.libraryService = libraryService;
+        // Bootstrap default library if none exist
+        const defaultLib = libraryService.getGlobalDefault();
+        if (!defaultLib) {
+            libraryService.create({
+                name: "Default Library",
+                isDefault: true,
+                defaultLibraryRoot: DEFAULT_LIBRARY_CONFIG.defaultLibraryRoot,
+                linkType: DEFAULT_LIBRARY_CONFIG.linkType,
+                importSubtitles: DEFAULT_LIBRARY_CONFIG.importSubtitles,
+                subtitleExtensions: [...DEFAULT_LIBRARY_CONFIG.subtitleExtensions],
+            });
+            logger.info("created default library");
+        }
+        // 6a. Create importer (reacts to download.completed)
+        const importer = new Importer(datastore.db, starr.coreBus, logger, () => {
+            const defaultLib = libraryService.getGlobalDefault();
+            return {
+                defaultLibraryRoot: defaultLib?.defaultLibraryRoot ?? DEFAULT_LIBRARY_CONFIG.defaultLibraryRoot,
+                roots: defaultLib?.roots ?? {},
+                linkType: defaultLib?.linkType ?? DEFAULT_LIBRARY_CONFIG.linkType,
+                importSubtitles: defaultLib?.importSubtitles ?? DEFAULT_LIBRARY_CONFIG.importSubtitles,
+                subtitleExtensions: defaultLib?.subtitleExtensions ?? DEFAULT_LIBRARY_CONFIG.subtitleExtensions,
+            };
+        }, (contentTypeId) => getNamingRule(contentTypeId, starr.contentTypeRegistry), libraryService);
+        starr.importer = importer;
+        // 6b. Create library cache (populated from imported items)
+        const libraryCache = new LibraryCache(datastore.db, starr.coreBus, logger);
+        libraryCache.refreshFromDb();
+        starr.libraryCache = libraryCache;
+        // 6c. Create library scanner, metadata matcher, and scan controller
+        const libraryScanner = new LibraryScanner(datastore.db, logger, libraryService);
+        const metadataMatcher = new MetadataMatcher(starr.coreBus, starr.contentTypeRegistry, logger);
+        const scanController = new ScanController(libraryScanner, metadataMatcher, datastore.db, starr.coreBus, logger, libraryCache, starr.contentTypeRegistry, importer);
+        starr.scanController = scanController;
+        // Subscribe importer to download.completed
+        starr.coreBus.on("download.completed", async (event) => {
+            const payload = event.payload;
+            const req = stateStore.getByRequestId(payload.requestId);
+            if (!req)
+                return;
+            try {
+                const resolved = await resolveSourcePath(payload.location);
+                // Import each media file found at the source
+                let anySucceeded = false;
+                for (const filePath of resolved.files) {
+                    const ext = path.extname(filePath).slice(1).toLowerCase() || "mkv";
+                    const result = await importer.import(payload.requestId, filePath, req.item, req.contentTypeId, ext, req.contentIdentity, payload.libraryId);
+                    if (result.success) {
+                        anySucceeded = true;
+                    }
+                    else {
+                        logger.error("import failed for file", {
+                            requestId: payload.requestId,
+                            file: filePath,
+                            error: result.error,
+                        });
+                    }
+                }
+                if (!anySucceeded) {
+                    logger.error("all imports failed", { requestId: payload.requestId });
+                }
+            }
+            catch (err) {
+                logger.error("import resolution failed", {
+                    requestId: payload.requestId,
+                    error: String(err),
+                });
+            }
+        });
+        // 7. Create AuthService (before web server so auth hook can reference it)
+        const authService = new AuthService(datastore.db, logger.child("auth"));
+        // 7a. Create UserService
+        const userService = new UserService(datastore.db, logger.child("users"));
+        // 7b. Create OIDC Provider Service
+        const { encrypt, decrypt } = await import("./datastore/encrypt.js");
+        const oidcProviderService = new OidcProviderService(datastore.db, (plaintext) => encrypt(plaintext), (ciphertext) => decrypt(ciphertext), logger.child("oidc-providers"));
+        // 7c. Create OIDC Flow
+        const port = parseInt(process.env.STARR_PORT ?? "3457", 10);
+        const baseUrl = process.env.STARR_BASE_URL ?? `http://localhost:${port}`;
+        const oidcFlow = new OidcFlow(datastore.db, oidcProviderService, userService, baseUrl, logger.child("oidc-flow"));
+        // 8. Create web server (registers route stubs via dynamic import, auth hook)
+        const webServer = await createWebServer(logger.child("web"));
+        starr.webServer = webServer;
+        // Wire auth routes and auth hook into web server
+        initAuthService(authService);
+        initAuthRoutes(authService);
+        // Wire OIDC services into web server (so oidc route init gets them)
+        initOidcServices(oidcProviderService, oidcFlow, userService);
+        // Wire config routes (configService already exists)
+        initConfigRoutes(configService, () => starr.getRuntimes());
+        // Wire trace-store wrapper
+        initTraceStore(stateStore);
+        // 9. Load plugins (populates content-type registry, event bus handlers)
+        logger.info("booting", { pluginsDir, apiVersion, dataDir });
+        await loadPlugins(starr);
+        // 10. Wire remaining routes that depend on plugin-loaded data
+        initContentTypeRoutes(() => starr.contentTypeRegistry.list(), (id) => starr.contentTypeRegistry.get(id));
+        initDiscoveryRoutes(starr.coreBus);
+        initRequestRoutes(starr);
+        initActivityRoutes(starr);
+        initSseRoutes(starr.coreBus);
+        initLibraryRoutes(libraryCache);
+        initLibraryManagementRoutes(libraryService);
+        initLibraryImportRoutes(scanController);
+        // 11. Start web server
+        await webServer.listen({ port, host: "0.0.0.0" });
+        logger.info("web server listening", { port });
+        starr.markRunning();
+        // 12. Graceful shutdown
+        let shuttingDown = false;
+        for (const signal of ["SIGTERM", "SIGINT"]) {
+            process.on(signal, async () => {
+                if (shuttingDown)
+                    return;
+                shuttingDown = true;
+                logger.info("shutting down", { signal });
+                // Close web server first to release the port immediately
+                try {
+                    await webServer.close();
+                }
+                catch { /* ignore close errors during shutdown */ }
+                await stopPlugins(starr);
+                starr.markStopped();
+                datastore.close();
+                process.exit(0);
+            });
+        }
+    }
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/plugins/context.d.ts

@@ -0,0 +1,10 @@
+import type Database from "better-sqlite3";
+import type { PluginContext, PluginMeta } from "../types/plugin.js";
+import type { Starr } from "../host.js";
+import type { ConfigService } from "../config/config-service.js";
+export declare function createContext(starr: Starr, pluginDir: string, db: Database.Database, configService?: ConfigService, instanceId?: string): PluginContext & {
+    getMeta: () => PluginMeta | undefined;
+    unsubscribeAll: () => void;
+    deleteAllStorage: () => Promise<void>;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/plugins/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/plugins/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAwB,aAAa,EAAE,UAAU,EAAkD,MAAM,oBAAoB,CAAC;AAC1I,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,aAAa,CAAC,EAAE,aAAa,EAC7B,UAAU,SAAY,GACrB,aAAa,GAAG;IACjB,OAAO,EAAE,MAAM,UAAU,GAAG,SAAS,CAAC;IACtC,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAmHA"}

package/dist/plugins/context.js

@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import semver from "semver";
+import path from "node:path";
+import { createPluginStorage } from "../datastore/storage.js";
+export function createContext(starr, pluginDir, db, configService, instanceId = "default") {
+    let meta;
+    let defined = false;
+    let _storage = null;
+    let _subscriptions = [];
+    const guard = () => {
+        if (!defined)
+            throw new Error("ctx.define must be called before any other context method");
+    };
+    let logger = starr.logger.child(path.basename(pluginDir));
+    const context = {
+        apiVersion: starr.apiVersion,
+        define(m) {
+            if (defined)
+                throw new Error("ctx.define can only be called once");
+            if (!m.id)
+                throw new Error("plugin id is required");
+            if (!semver.valid(m.version))
+                throw new Error(`invalid plugin version: ${m.version}`);
+            if (!semver.validRange(m.starrApiVersion))
+                throw new Error(`invalid api range: ${m.starrApiVersion}`);
+            if (!semver.satisfies(starr.apiVersion, m.starrApiVersion)) {
+                throw new Error(`API version mismatch: host ${starr.apiVersion} does not satisfy ${m.starrApiVersion}`);
+            }
+            meta = m;
+            defined = true;
+            logger = starr.logger.child(m.id);
+            logger.debug("defined", { meta: m });
+        },
+        config(schema) {
+            guard();
+            if (!meta)
+                throw new Error("ctx.config called before ctx.define");
+            if (configService) {
+                return configService.register(meta.id, schema, instanceId);
+            }
+            // Fallback for tests / bootstrap paths that do not provide a ConfigService
+            const values = {};
+            for (const [key, field] of Object.entries(schema)) {
+                values[key] = field.default ?? undefined;
+            }
+            return Object.freeze(values);
+        },
+        events: (() => {
+            let _pluginBus = null;
+            const getBus = () => {
+                if (!_pluginBus) {
+                    _pluginBus = starr.busImpl.pluginBus(meta.id);
+                }
+                return _pluginBus;
+            };
+            return {
+                on(type, handler) {
+                    guard();
+                    const unsub = getBus().on(type, handler);
+                    _subscriptions.push(unsub);
+                    return unsub;
+                },
+                emit(type, payload, opts) {
+                    guard();
+                    getBus().emit(type, payload, opts);
+                },
+                request(type, payload, opts) {
+                    guard();
+                    return getBus().request(type, payload, opts);
+                },
+            };
+        })(),
+        get storage() {
+            if (!_storage && defined && meta) {
+                _storage = createPluginStorage(db, meta.id, instanceId);
+            }
+            if (!_storage) {
+                throw new Error("ctx.storage called before ctx.define");
+            }
+            return _storage;
+        },
+        contentTypes: {
+            register(descriptor) {
+                guard();
+                if (!meta)
+                    throw new Error("ctx.contentTypes.register called before ctx.define");
+                starr.contentTypeRegistry.register(descriptor, meta.id);
+                logger.debug("registered content type", { typeId: descriptor.id });
+            },
+        },
+        get logger() {
+            return logger;
+        },
+        getMeta: () => meta,
+        unsubscribeAll: () => {
+            for (const unsub of _subscriptions)
+                unsub();
+            _subscriptions = [];
+        },
+        deleteAllStorage: async () => {
+            if (_storage) {
+                await _storage.deleteAll();
+                _storage = null;
+            }
+        },
+    };
+    return context;
+}
+//# sourceMappingURL=context.js.map

package/dist/plugins/context.js.map

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

package/dist/plugins/discovery.d.ts

@@ -0,0 +1,2 @@
+export declare function discoverPluginDirs(pluginsDir: string): Promise<string[]>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/plugins/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/plugins/discovery.ts"],"names":[],"mappings":"AAMA,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB9E"}

package/dist/plugins/discovery.js

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+export async function discoverPluginDirs(pluginsDir) {
+    let entries;
+    try {
+        entries = await readdir(pluginsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const dirs = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name.startsWith("."))
+            continue;
+        if (entry.name === "node_modules")
+            continue;
+        const full = path.join(pluginsDir, entry.name);
+        try {
+            await stat(path.join(full, "package.json"));
+            dirs.push(full);
+        }
+        catch {
+            // not a plugin package
+        }
+    }
+    return dirs.sort((a, b) => path.basename(a).localeCompare(path.basename(b)));
+}
+//# sourceMappingURL=discovery.js.map

package/dist/plugins/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/plugins/discovery.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,4DAA4D;AAE5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAkB;IACzD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAAE,SAAS;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;YAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,9 @@
+import type { Starr } from "../host.js";
+export declare function loadPlugins(starr: Starr): Promise<void>;
+/**
+ * Reload a single plugin in isolation: stop → unregister → re-import → start.
+ * In multi-instance mode, all instances of the plugin are reloaded.
+ */
+export declare function reloadPlugin(starr: Starr, pluginId: string): Promise<void>;
+export declare function stopPlugins(starr: Starr): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAiB,KAAK,EAAE,MAAM,YAAY,CAAC;AAyBvD,wBAAsB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAqI7D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA+Gf;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7D"}