@digitalpaws/starr 0.0.1

package/dist/state/state-store.js

@@ -0,0 +1,465 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import { env } from "node:process";
+// ── Row mapping helper ─────────────────────────────────────
+function rowToRequest(row) {
+    return {
+        requestId: row.request_id,
+        contentTypeId: row.content_type_id,
+        contentIdentity: row.content_identity,
+        item: JSON.parse(row.item),
+        ownerUserId: row.owner_user_id,
+        watchers: JSON.parse(row.watchers),
+        status: row.status,
+        statusDetail: row.status_detail || undefined,
+        chosenReleaseId: row.chosen_release_id || undefined,
+        attempts: row.attempts,
+        libraryId: row.library_id || undefined,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+/**
+ * Maximum number of trace entries retained per traceId.
+ * Set via STARR_TRACE_HISTORY_LIMIT env var; defaults to 50.
+ * Values ≤ 0 disable trace capture entirely.
+ */
+const TRACE_HISTORY_LIMIT = (() => {
+    const raw = env.STARR_TRACE_HISTORY_LIMIT;
+    if (raw === undefined || raw === "")
+        return 50;
+    const n = Number(raw);
+    if (Number.isNaN(n)) {
+        // We don't have a logger at module scope — the state store
+        // constructor will log a warning if the env var is invalid.
+        return 50;
+    }
+    return Math.max(0, Math.floor(n));
+})();
+// ── StateStore class ───────────────────────────────────────
+export class StateStore {
+    db;
+    bus;
+    logger;
+    // Prepared statements — created once in constructor
+    stmtGetByRequestId;
+    stmtFindByIdentity;
+    stmtInsert;
+    stmtUpdateStatus;
+    stmtIncrementAttempts;
+    stmtAddWatcher;
+    stmtListByUser;
+    stmtInsertTrace;
+    stmtGetIdsByTraceId;
+    stmtGetTraceByRequestId;
+    stmtResetAttempts;
+    stmtResetForRetry;
+    stmtDeleteRequest;
+    stmtDeleteTraceByRequestId;
+    constructor(db, bus, logger) {
+        this.db = db;
+        this.bus = bus;
+        this.logger = logger.child("state-store");
+        // Compile prepared statements once
+        this.stmtGetByRequestId = db.prepare("SELECT * FROM tracked_requests WHERE request_id = @requestId");
+        this.stmtFindByIdentity = db.prepare(`SELECT * FROM tracked_requests
+       WHERE content_identity = @identity AND status != 'failed'
+       ORDER BY created_at DESC
+       LIMIT 1`);
+        this.stmtInsert = db.prepare(`INSERT INTO tracked_requests
+         (request_id, content_type_id, content_identity, item,
+          owner_user_id, watchers, status, attempts, library_id, created_at, updated_at)
+       VALUES
+         (@requestId, @contentTypeId, @contentIdentity, @item,
+          @ownerUserId, '[]', 'requested', 0,
+          @libraryId,
+          datetime('now'), datetime('now'))`);
+        this.stmtUpdateStatus = db.prepare(`UPDATE tracked_requests
+       SET status = @status,
+           status_detail = @detail,
+           chosen_release_id = COALESCE(@chosenReleaseId, chosen_release_id),
+           updated_at = datetime('now')
+       WHERE request_id = @requestId`);
+        this.stmtIncrementAttempts = db.prepare(`UPDATE tracked_requests
+       SET attempts = attempts + 1, updated_at = datetime('now')
+       WHERE request_id = @requestId`);
+        this.stmtAddWatcher = db.prepare(`UPDATE tracked_requests
+       SET watchers = @watchers, updated_at = datetime('now')
+       WHERE request_id = @requestId`);
+        this.stmtListByUser = db.prepare(`SELECT * FROM tracked_requests
+       WHERE owner_user_id = @userId
+          OR watchers LIKE @pattern
+       ORDER BY created_at DESC`);
+        // Trace log — prepared statements
+        this.stmtInsertTrace = db.prepare(`INSERT INTO trace_log (trace_id, request_id, event_type, event_data, timestamp)
+       VALUES (@traceId, @requestId, @eventType, @eventData, @timestamp)`);
+        this.stmtGetIdsByTraceId = db.prepare(`SELECT id FROM trace_log
+       WHERE trace_id = @traceId
+       ORDER BY id ASC`);
+        this.stmtGetTraceByRequestId = db.prepare(`SELECT * FROM trace_log
+       WHERE request_id = @requestId
+       ORDER BY id ASC`);
+        this.stmtResetAttempts = db.prepare(`UPDATE tracked_requests
+       SET attempts = 0, updated_at = datetime('now')
+       WHERE request_id = @requestId`);
+        this.stmtResetForRetry = db.prepare(`UPDATE tracked_requests
+       SET status = 'requested',
+           status_detail = @detail,
+           chosen_release_id = NULL,
+           attempts = 0,
+           updated_at = datetime('now')
+       WHERE request_id = @requestId`);
+        this.stmtDeleteRequest = db.prepare(`DELETE FROM tracked_requests WHERE request_id = @requestId`);
+        this.stmtDeleteTraceByRequestId = db.prepare(`DELETE FROM trace_log WHERE request_id = @requestId`);
+        // Subscribe to acquisition spine events
+        this.subscribe();
+    }
+    // ── Public API ───────────────────────────────────────────
+    /** Retrieve a single tracked request by its domain id. */
+    getByRequestId(requestId) {
+        const row = this.stmtGetByRequestId.get({ requestId });
+        return row ? rowToRequest(row) : undefined;
+    }
+    /**
+     * Find a non-failed tracked request with the given content identity.
+     * Used by request intake for de-duplication (DU1).
+     * Returns the most recently created match, or undefined.
+     */
+    findByContentIdentity(contentIdentity) {
+        const row = this.stmtFindByIdentity.get({ identity: contentIdentity });
+        return row ? rowToRequest(row) : undefined;
+    }
+    /**
+     * Insert a brand-new tracked request with status ``requested``.
+     * Called by request intake after de-dup check (DU3).
+     */
+    insert(data) {
+        this.stmtInsert.run({
+            requestId: data.requestId,
+            contentTypeId: data.contentTypeId,
+            contentIdentity: data.contentIdentity,
+            item: JSON.stringify(data.item),
+            ownerUserId: data.ownerUserId,
+            libraryId: data.libraryId ?? null,
+        });
+        this.logger.debug("tracked request created", {
+            requestId: data.requestId,
+            contentIdentity: data.contentIdentity,
+            libraryId: data.libraryId,
+        });
+    }
+    /**
+     * Add a userId to the watchers array of an existing request.
+     * Called by request intake when re-attaching to an existing request (DU2).
+     * No-op if the user is already the owner or a watcher.
+     */
+    addWatcher(requestId, userId) {
+        const req = this.getByRequestId(requestId);
+        if (!req) {
+            this.logger.warn("addWatcher: unknown requestId", { requestId });
+            return;
+        }
+        if (req.ownerUserId === userId || req.watchers.includes(userId)) {
+            return; // already attached
+        }
+        const updated = [...req.watchers, userId];
+        this.stmtAddWatcher.run({
+            requestId,
+            watchers: JSON.stringify(updated),
+        });
+        this.logger.debug("watcher added", { requestId, userId });
+    }
+    /**
+     * Return the ordered trace history for a tracked request.
+     *
+     * Returns an array of TraceEntry, oldest first. Returns an empty array
+     * if the requestId is unknown or has no captured events.
+     *
+     * This is the data surface for the admin "activity" view (DBG2).
+     * The UI (Task 022) renders the returned data; this task only provides
+     * the query.
+     */
+    getTraceLog(requestId) {
+        const rows = this.stmtGetTraceByRequestId.all({ requestId });
+        return rows.map((row) => ({
+            id: row.id,
+            traceId: row.trace_id,
+            requestId: row.request_id,
+            eventType: row.event_type,
+            eventData: JSON.parse(row.event_data),
+            timestamp: row.timestamp,
+        }));
+    }
+    // ── Retry ───────────────────────────────────────────────
+    /**
+     * Reset a tracked request to 'requested' for a manual retry.
+     *
+     * Clears chosenReleaseId, resets attempts to 0, sets status to
+     * 'requested' with a detail message. This is called from the
+     * retry endpoint before re-emitting content.requested.
+     *
+     * Uses a transaction for atomicity.
+     * Emits item.updated so the UI reflects the change immediately.
+     */
+    resetAndRetry(requestId) {
+        const txn = this.db.transaction(() => {
+            // Reset status, clear chosenReleaseId, reset attempts in one statement
+            this.stmtResetForRetry.run({
+                requestId,
+                detail: "Retrying — restarted by user",
+            });
+        });
+        txn();
+        // Emit item.updated so the UI updates live
+        this.bus.emit("item.updated", {
+            requestId,
+            status: "requested",
+            detail: "Retrying — restarted by user",
+        });
+        this.logger.info("request reset for retry", { requestId });
+    }
+    // ── Delete ──────────────────────────────────────────────
+    /**
+     * Permanently delete a tracked request and its associated
+     * trace-log entries. This is unconditional (any status).
+     *
+     * Returns true if a row was deleted, false if the requestId
+     * did not exist.
+     */
+    deleteRequest(requestId) {
+        const txn = this.db.transaction(() => {
+            // 1. Delete trace log entries for this request
+            this.stmtDeleteTraceByRequestId.run({ requestId });
+            // 2. Delete the request itself
+            const info = this.stmtDeleteRequest.run({ requestId });
+            return info.changes > 0;
+        });
+        const deleted = txn();
+        if (deleted) {
+            this.logger.info("request deleted", { requestId });
+        }
+        else {
+            this.logger.warn("deleteRequest: requestId not found", { requestId });
+        }
+        // Note: we deliberately do NOT emit item.updated here.
+        // Deletion is handled on the UI side by removing the item from
+        // the local store and/or navigating away.
+        return deleted;
+    }
+    /**
+     * Return ALL tracked requests (admin only).
+     */
+    getLibraryPath(requestId) {
+        const row = this.db
+            .prepare("SELECT library_path FROM library_paths WHERE request_id = ?")
+            .get(requestId);
+        return row?.library_path;
+    }
+    getAllRequests() {
+        const rows = this.db
+            .prepare("SELECT * FROM tracked_requests ORDER BY created_at DESC")
+            .all();
+        return rows.map((row) => rowToRequest(row));
+    }
+    /**
+     * List tracked requests visible to a given user (owner or watcher).
+     * Used by the UI to show the request list (UI-ST2).
+     */
+    listByUser(userId) {
+        // The LIKE pattern searches for the userId inside the JSON watchers array.
+        // e.g. '%"admin"%' matches ["admin"] or ["alice","admin"].
+        const rows = this.stmtListByUser.all({
+            userId,
+            pattern: `%"${userId}"%`,
+        });
+        return rows.map(rowToRequest);
+    }
+    // ── Trace capture ────────────────────────────────────────
+    /**
+     * Capture a spine event into the trace log. Stores the full event data
+     * (envelope fields + payload) as JSON, then prunes if the per-traceId
+     * count exceeds TRACE_HISTORY_LIMIT.
+     *
+     * This is a no-op if TRACE_HISTORY_LIMIT is 0 (trace capture disabled).
+     */
+    captureTraceEvent(event, requestId) {
+        if (TRACE_HISTORY_LIMIT === 0)
+            return;
+        const eventData = {
+            eventId: event.id,
+            traceId: event.traceId,
+            correlationId: event.correlationId,
+            source: event.source,
+            schemaVersion: event.schemaVersion,
+            timestamp: event.timestamp,
+            payload: event.payload,
+        };
+        // 1. Insert the new entry
+        this.stmtInsertTrace.run({
+            traceId: event.traceId,
+            requestId,
+            eventType: event.type,
+            eventData: JSON.stringify(eventData),
+            timestamp: event.timestamp,
+        });
+        // 2. Fetch all entry ids for this traceId, oldest first
+        const rows = this.stmtGetIdsByTraceId.all({
+            traceId: event.traceId,
+        });
+        // 3. Prune if over the limit — delete the oldest excess entries
+        if (rows.length > TRACE_HISTORY_LIMIT) {
+            const excess = rows.length - TRACE_HISTORY_LIMIT;
+            const deleteIds = rows.slice(0, excess).map((r) => r.id);
+            // Use a one-off prepared statement for deletes
+            const deleteStmt = this.db.prepare("DELETE FROM trace_log WHERE id = ?");
+            for (const id of deleteIds) {
+                deleteStmt.run(id);
+            }
+            this.logger.debug("trace pruned", {
+                traceId: event.traceId,
+                deleted: excess,
+                remaining: TRACE_HISTORY_LIMIT,
+            });
+        }
+    }
+    // ── Event subscription ───────────────────────────────────
+    subscribe() {
+        this.bus.on("release.found", this.onReleaseFound.bind(this));
+        this.bus.on("download.started", this.onDownloadStarted.bind(this));
+        this.bus.on("download.completed", this.onDownloadCompleted.bind(this));
+        this.bus.on("download.failed", this.onDownloadFailed.bind(this));
+        this.bus.on("request.failed", this.onRequestFailed.bind(this));
+        this.bus.on("import.started", this.onImportStarted.bind(this));
+        this.bus.on("import.completed", this.onImportCompleted.bind(this));
+        this.bus.on("import.failed", this.onImportFailed.bind(this));
+    }
+    onReleaseFound(event) {
+        const { requestId } = event.payload;
+        const req = this.getByRequestId(requestId);
+        if (!req) {
+            this.logger.warn("release.found for unknown requestId", { requestId });
+            return;
+        }
+        this.captureTraceEvent(event, requestId);
+        // Transition: requested → searching (first candidate arrived)
+        if (req.status === "requested") {
+            this.updateStatus(requestId, "searching");
+        }
+        // If already searching (or beyond), just more candidates — no status change.
+    }
+    onDownloadStarted(event) {
+        const payload = event.payload;
+        const req = this.getByRequestId(payload.requestId);
+        if (!req) {
+            this.logger.warn("download.started for unknown requestId", {
+                requestId: payload.requestId,
+            });
+            return;
+        }
+        this.captureTraceEvent(event, payload.requestId);
+        // Increment the display-only attempts counter (SM4)
+        this.incrementAttempts(payload.requestId);
+        // Transition: searching → downloading (defensive: also from 'requested')
+        if (req.status === "searching" || req.status === "requested") {
+            const releaseId = payload.release?.id ?? payload.release?.title ?? undefined;
+            this.updateStatus(payload.requestId, "downloading", undefined, releaseId);
+        }
+    }
+    onDownloadCompleted(event) {
+        const { requestId } = event.payload;
+        const req = this.getByRequestId(requestId);
+        if (!req) {
+            this.logger.warn("download.completed for unknown requestId", { requestId });
+            return;
+        }
+        this.captureTraceEvent(event, requestId);
+        // Terminal success — only if not already terminal
+        if (req.status !== "failed" && req.status !== "downloaded" && req.status !== "imported") {
+            this.updateStatus(requestId, "downloaded");
+        }
+    }
+    onDownloadFailed(event) {
+        const { requestId } = event.payload;
+        const req = this.getByRequestId(requestId);
+        if (!req) {
+            this.logger.warn("download.failed for unknown requestId", { requestId });
+            return;
+        }
+        this.captureTraceEvent(event, requestId);
+        // Transient failure: go back to searching, NEVER to failed (SM1)
+        if (req.status === "downloading") {
+            this.updateStatus(requestId, "searching", `retrying (attempt ${req.attempts})`);
+        }
+    }
+    onImportStarted(event) {
+        const { requestId } = event.payload;
+        const req = this.getByRequestId(requestId);
+        if (!req)
+            return;
+        if (req.status === "downloaded") {
+            this.updateStatus(requestId, "importing");
+        }
+    }
+    onImportCompleted(event) {
+        const { requestId } = event.payload;
+        const req = this.getByRequestId(requestId);
+        if (!req)
+            return;
+        if (req.status === "importing") {
+            this.updateStatus(requestId, "imported");
+        }
+    }
+    onImportFailed(event) {
+        const payload = event.payload;
+        const req = this.getByRequestId(payload.requestId);
+        if (!req)
+            return;
+        if (req.status === "importing") {
+            this.updateStatus(payload.requestId, "downloaded", `Import failed: ${payload.error ?? "unknown error"}`);
+        }
+    }
+    onRequestFailed(event) {
+        const payload = event.payload;
+        const req = this.getByRequestId(payload.requestId);
+        if (!req) {
+            this.logger.warn("request.failed for unknown requestId", {
+                requestId: payload.requestId,
+            });
+            return;
+        }
+        this.captureTraceEvent(event, payload.requestId);
+        // Terminal failure — the ONLY path to 'failed' (SM2, SP1a)
+        if (req.status !== "failed" && req.status !== "downloaded" && req.status !== "imported") {
+            this.updateStatus(payload.requestId, "failed", payload.reason);
+        }
+    }
+    // ── Internal helpers ──────────────────────────────────────
+    /**
+     * Update status, optional detail, and optional chosenReleaseId.
+     * Emits item.updated on every call (the caller guards transitions,
+     * so duplicate emissions are not a concern).
+     */
+    updateStatus(requestId, status, detail, chosenReleaseId) {
+        this.stmtUpdateStatus.run({
+            requestId,
+            status,
+            detail: detail ?? null,
+            chosenReleaseId: chosenReleaseId ?? null,
+        });
+        // Emit item.updated — the single event the UI relies on (SP2, UI-ST1)
+        const payload = {
+            requestId,
+            status,
+        };
+        if (detail !== undefined) {
+            payload.detail = detail;
+        }
+        this.bus.emit("item.updated", payload);
+        this.logger.debug("status updated", { requestId, status, detail });
+    }
+    /** Increment the attempts counter by 1. Called on download.started (SM4). */
+    incrementAttempts(requestId) {
+        this.stmtIncrementAttempts.run({ requestId });
+    }
+}
+//# sourceMappingURL=state-store.js.map

package/dist/state/state-store.js.map

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

package/dist/state/trace-store.d.ts

@@ -0,0 +1,12 @@
+import type { TraceEntry, StateStore } from "./state-store.js";
+/**
+ * Initialize the trace-store wrapper with a reference to the StateStore.
+ * Called from main.ts after the web server and state store are created.
+ */
+export declare function initTraceStore(store: StateStore): void;
+/**
+ * Retrieve trace events for a given requestId.
+ * Returns an empty array if the state store isn't available or no events exist.
+ */
+export declare function getTraceEvents(requestId: string): TraceEntry[];
+//# sourceMappingURL=trace-store.d.ts.map

package/dist/state/trace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.d.ts","sourceRoot":"","sources":["../../src/state/trace-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ/D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAEtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAG9D"}

package/dist/state/trace-store.js

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+/**
+ * Module-level reference to the state store, set by the host bootstrap.
+ * This avoids circular imports between route modules and the host.
+ */
+let stateStore = null;
+/**
+ * Initialize the trace-store wrapper with a reference to the StateStore.
+ * Called from main.ts after the web server and state store are created.
+ */
+export function initTraceStore(store) {
+    stateStore = store;
+}
+/**
+ * Retrieve trace events for a given requestId.
+ * Returns an empty array if the state store isn't available or no events exist.
+ */
+export function getTraceEvents(requestId) {
+    if (!stateStore)
+        return [];
+    return stateStore.getTraceLog(requestId);
+}
+//# sourceMappingURL=trace-store.js.map

package/dist/state/trace-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.js","sourceRoot":"","sources":["../../src/state/trace-store.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,4DAA4D;AAI5D;;;GAGG;AACH,IAAI,UAAU,GAAsB,IAAI,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,93 @@
+import type { ContentTypeDescriptor } from "@digitalpaws/starr-types-core";
+export interface PluginMeta {
+    id: string;
+    version: string;
+    starrApiVersion: string;
+}
+export interface ConnectionTestResult {
+    ok: boolean;
+    message?: string;
+}
+export interface PluginLifecycle {
+    start?(): void | Promise<void>;
+    stop?(): void | Promise<void>;
+    testConnection?(values: Record<string, unknown>): ConnectionTestResult | Promise<ConnectionTestResult>;
+}
+export interface Logger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+    child(tag: string): Logger;
+}
+export interface StarrEvent<P = unknown> {
+    readonly type: string;
+    readonly id: string;
+    readonly traceId: string;
+    readonly correlationId?: string;
+    readonly source: string;
+    readonly timestamp: string;
+    readonly schemaVersion: number;
+    readonly payload: P;
+    /** Convenience: emit a correlated reply. */
+    reply<R>(type: string, payload: R): void;
+}
+export interface EmitOpts {
+    correlationId?: string;
+}
+export interface RequestOpts {
+    responseType: string;
+    windowMs: number;
+    max?: number;
+}
+export type Unsubscribe = () => void;
+export type EventHandler<P = unknown> = (event: StarrEvent<P>) => void | Promise<void>;
+export interface EventBus {
+    emit<P>(type: string, payload: P, opts?: EmitOpts): void;
+    on<P>(type: string, handler: EventHandler<P>): Unsubscribe;
+    request<Res>(type: string, payload: unknown, opts: RequestOpts): Promise<StarrEvent<Res>[]>;
+}
+export interface PluginStorage {
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    /** List all keys (optionally filtered by prefix), sorted lexically. */
+    list<T>(prefix?: string): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    /** Delete all keys for this plugin's namespace. Used during rollback. */
+    deleteAll(): Promise<void>;
+}
+export interface ContentTypeRegistry {
+    /**
+     * Register a content-type descriptor. Throws on:
+     * - Malformed descriptor (empty identity, list without itemType,
+     *   enum without options)
+     * - Duplicate id already registered by another plugin
+     */
+    register(descriptor: ContentTypeDescriptor): void;
+}
+export interface ConfigField {
+    type: string;
+    label: string;
+    required?: boolean;
+    default?: unknown;
+    options?: string[];
+    description?: string;
+    group?: string;
+}
+export type ConfigSchema<T> = {
+    [K in keyof T]: ConfigField;
+};
+export interface PluginContext {
+    readonly apiVersion: string;
+    define(meta: PluginMeta): void;
+    config<T>(schema: ConfigSchema<T>): Readonly<T>;
+    events: EventBus;
+    storage: PluginStorage;
+    contentTypes: ContentTypeRegistry;
+    logger: Logger;
+}
+export type RegisterFn = (ctx: PluginContext) => void | PluginLifecycle | Promise<void | PluginLifecycle>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

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

package/dist/types/plugin.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,4DAA4D"}

package/dist/web/index.d.ts

@@ -0,0 +1,10 @@
+import Fastify from "fastify";
+import type { Logger } from "../types/plugin.js";
+import type { AuthService } from "../auth/auth-service.js";
+import type { OidcProviderService } from "../auth/oidc/oidc-provider-service.js";
+import type { OidcFlow } from "../auth/oidc/oidc-flow.js";
+import type { UserService } from "../auth/oidc/user-service.js";
+export declare function initAuthService(auth: AuthService): void;
+export declare function initOidcServices(oidcProviders: OidcProviderService, flow: OidcFlow, users: UserService): void;
+export declare function createWebServer(logger: Logger): Promise<Fastify.FastifyInstance<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, Fastify.FastifyBaseLogger, Fastify.FastifyTypeProviderDefault>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAQhE,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEvD;AAOD,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,mBAAmB,EAClC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,WAAW,GACjB,IAAI,CAIN;AAID,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,sSA2InD"}