@digitalpaws/starr 0.0.1

package/dist/config/config-service.js

@@ -0,0 +1,309 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+import { validateConfig } from "./validate.js";
+import { encrypt, decrypt } from "../datastore/encrypt.js";
+/**
+ * Sentinel value used to mask secret fields in UI-exported data.
+ * When update() receives this value for a secret field, it preserves
+ * the existing encrypted value rather than overwriting it.
+ */
+export const SECRET_UNCHANGED_SENTINEL = "__STARR_SECRET_UNCHANGED__";
+export class ConfigService {
+    db;
+    logger;
+    onReload;
+    // Prepared statements
+    getStmt;
+    getByInstanceStmt;
+    upsertStmt;
+    listStmt;
+    listInstancesStmt;
+    deleteInstanceStmt;
+    constructor(db, logger, onReload) {
+        this.db = db;
+        this.logger = logger;
+        this.onReload = onReload;
+        this.getStmt = db.prepare('SELECT schema, "values", updated_at FROM plugin_config WHERE plugin_id = ?');
+        this.getByInstanceStmt = db.prepare('SELECT schema, "values", updated_at FROM plugin_config WHERE plugin_id = ? AND instance_id = ?');
+        this.upsertStmt = db.prepare(`
+      INSERT INTO plugin_config (plugin_id, instance_id, schema, "values", updated_at)
+      VALUES (?, ?, ?, ?, datetime('now'))
+      ON CONFLICT(plugin_id, instance_id) DO UPDATE SET
+        schema = excluded.schema,
+        "values" = excluded."values",
+        updated_at = datetime('now')
+    `);
+        this.listStmt = db.prepare('SELECT plugin_id, instance_id, schema, "values", updated_at FROM plugin_config ORDER BY plugin_id, instance_id');
+        this.listInstancesStmt = db.prepare('SELECT plugin_id, instance_id, schema, "values", updated_at FROM plugin_config WHERE plugin_id = ? ORDER BY instance_id');
+        this.deleteInstanceStmt = db.prepare("DELETE FROM plugin_config WHERE plugin_id = ? AND instance_id = ?");
+    }
+    /**
+     * Called by the plugin context during register.
+     * Returns read-only validated values.
+     */
+    register(pluginId, schema, instanceId = "default") {
+        const row = this.getByInstanceStmt.get(pluginId, instanceId);
+        if (row) {
+            // Existing row — decrypt secrets, re-validate against current schema
+            const storedValues = this.decryptValues(schema, JSON.parse(row.values));
+            // Merge stored values with defaults from the current schema so that
+            // newly added fields (e.g. libraryId) are picked up.
+            const mergedValues = { ...this.buildDefaults(schema), ...storedValues };
+            const result = validateConfig(schema, mergedValues);
+            if (result.valid) {
+                // Schema or values may have changed (new optional fields, new defaults).
+                // Persist the current schema so get/list reflect it, and persist the
+                // merged values so existing config is preserved.
+                const toPersist = this.encryptValues(schema, mergedValues);
+                this.upsertStmt.run(pluginId, instanceId, JSON.stringify(schema), JSON.stringify(toPersist));
+                return Object.freeze(result.values);
+            }
+            // Validation failed against current schema (e.g., new required field added)
+            this.logger.warn("config re-validation failed, marking needs-configuration", {
+                pluginId,
+                instanceId,
+                errors: result.errors,
+            });
+            // Persist the new schema (so get/list reflect current schema) but keep
+            // existing values so user's prior changes aren't lost.
+            const toPersistOnFail = this.encryptValues(schema, mergedValues);
+            this.upsertStmt.run(pluginId, instanceId, JSON.stringify(schema), JSON.stringify(toPersistOnFail));
+            // Return defaults, plugin will need configuration
+            const defaults = this.buildDefaults(schema);
+            return Object.freeze(defaults);
+        }
+        // No existing row — first registration
+        const defaults = this.buildDefaults(schema);
+        const result = validateConfig(schema, defaults);
+        if (!result.valid) {
+            // Has required fields without defaults — persist defaults and mark needs-configuration
+            this.logger.warn("config has missing required fields, needs-configuration", {
+                pluginId,
+                instanceId,
+                errors: result.errors,
+            });
+        }
+        // Persist schema and values (encrypt secrets before storing)
+        const toPersist = this.encryptValues(schema, result.valid ? result.values : defaults);
+        this.upsertStmt.run(pluginId, instanceId, JSON.stringify(schema), JSON.stringify(toPersist));
+        return Object.freeze((result.valid ? result.values : defaults));
+    }
+    /**
+     * Called by the admin settings API when saving config.
+     * Updates values, persists, and triggers reload.
+     */
+    update(pluginId, schema, input, instanceId = "default") {
+        const result = validateConfig(schema, input);
+        if (!result.valid) {
+            // Validation errors block save (CF3)
+            return result;
+        }
+        // Before persisting, handle secret fields:
+        // If a secret field's value is the sentinel, retrieve and use the existing
+        // decrypted value (so encryptValues() can re-encrypt it properly).
+        const existingRow = this.getByInstanceStmt.get(pluginId, instanceId);
+        if (existingRow) {
+            const existingParsed = JSON.parse(existingRow.values);
+            const existingDecrypted = this.decryptValues(schema, existingParsed);
+            for (const [key, field] of Object.entries(schema)) {
+                const f = field;
+                if (f.type === "secret") {
+                    if (result.values[key] === SECRET_UNCHANGED_SENTINEL) {
+                        // Use the decrypted existing value — will be re-encrypted below
+                        result.values[key] = existingDecrypted[key];
+                    }
+                }
+            }
+        }
+        // Encrypt secret fields before persisting
+        const toPersist = this.encryptValues(schema, result.values);
+        // Persist
+        this.upsertStmt.run(pluginId, instanceId, JSON.stringify(schema), JSON.stringify(toPersist));
+        // Trigger reload
+        this.logger.info("config updated, triggering reload", { pluginId, instanceId });
+        this.onReload?.(pluginId);
+        return result;
+    }
+    /**
+     * Called by the admin UI to get render data.
+     * Returns schema + values (with secrets masked) + needsConfiguration flag.
+     */
+    get(pluginId, instanceId = "default") {
+        const row = this.getByInstanceStmt.get(pluginId, instanceId);
+        if (!row)
+            return undefined;
+        const schema = JSON.parse(row.schema);
+        const storedValues = JSON.parse(row.values);
+        // Decrypt secrets for internal computation
+        const decryptedValues = this.decryptValues(schema, storedValues);
+        // Mask secrets for UI output
+        const maskedValues = this.maskSecretValues(schema, decryptedValues);
+        const needsConfiguration = this.computeNeedsConfiguration(schema, decryptedValues);
+        return {
+            schema,
+            values: maskedValues,
+            needsConfiguration,
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * Called by the admin UI to list all plugins with config status.
+     */
+    list() {
+        const rows = this.listStmt.all();
+        return rows
+            .filter((row) => !row.plugin_id.startsWith("_core."))
+            .map((row) => {
+            const schema = JSON.parse(row.schema);
+            const values = JSON.parse(row.values);
+            const decryptedValues = this.decryptValues(schema, values);
+            const needsConfiguration = this.computeNeedsConfiguration(schema, decryptedValues);
+            return {
+                pluginId: row.plugin_id,
+                instanceId: row.instance_id,
+                needsConfiguration,
+                updatedAt: row.updated_at,
+                libraryId: decryptedValues.libraryId,
+            };
+        });
+    }
+    /**
+     * List all instances for a given plugin.
+     */
+    listInstances(pluginId) {
+        const rows = this.listInstancesStmt.all(pluginId);
+        return rows
+            .filter((row) => !row.plugin_id.startsWith("_core."))
+            .map((row) => {
+            const schema = JSON.parse(row.schema);
+            const values = JSON.parse(row.values);
+            const decryptedValues = this.decryptValues(schema, values);
+            const needsConfiguration = this.computeNeedsConfiguration(schema, decryptedValues);
+            return {
+                pluginId: row.plugin_id,
+                instanceId: row.instance_id,
+                needsConfiguration,
+                updatedAt: row.updated_at,
+                libraryId: decryptedValues.libraryId,
+            };
+        });
+    }
+    /**
+     * Create a new plugin instance with the given instanceId and config values.
+     * Validates and persists.
+     */
+    createInstance(pluginId, instanceId, schema, values) {
+        // Validate
+        const result = validateConfig(schema, values);
+        if (!result.valid)
+            return result;
+        // Check for duplicate instance
+        const existing = this.get(pluginId, instanceId);
+        if (existing) {
+            return { valid: false, values: {}, errors: [{ field: "instanceId", message: `Instance "${instanceId}" already exists` }] };
+        }
+        // Encrypt and persist
+        const toPersist = this.encryptValues(schema, result.values);
+        this.upsertStmt.run(pluginId, instanceId, JSON.stringify(schema), JSON.stringify(toPersist));
+        return result;
+    }
+    /**
+     * Delete a plugin instance and its config.
+     */
+    deleteInstance(pluginId, instanceId) {
+        const result = this.deleteInstanceStmt.run(pluginId, instanceId);
+        if (result.changes === 0) {
+            throw new Error(`Instance not found: ${pluginId}::${instanceId}`);
+        }
+    }
+    /**
+     * Return decrypted stored values for a plugin, or undefined if no row exists.
+     * Used by the test-connection endpoint to resolve secret sentinels.
+     */
+    getDecryptedValues(pluginId, instanceId = "default") {
+        const row = this.getByInstanceStmt.get(pluginId, instanceId);
+        if (!row)
+            return undefined;
+        const schema = JSON.parse(row.schema);
+        const storedValues = JSON.parse(row.values);
+        return this.decryptValues(schema, storedValues);
+    }
+    /**
+     * Check whether a plugin needs configuration (required fields missing).
+     * Used by context.ts for the debug log.
+     */
+    needsConfiguration(pluginId, instanceId = "default") {
+        const row = this.getByInstanceStmt.get(pluginId, instanceId);
+        if (!row)
+            return false;
+        const schema = JSON.parse(row.schema);
+        const storedValues = JSON.parse(row.values);
+        const decryptedValues = this.decryptValues(schema, storedValues);
+        return this.computeNeedsConfiguration(schema, decryptedValues);
+    }
+    // ── Private helpers ──────────────────────────────────────
+    buildDefaults(schema) {
+        const defaults = {};
+        for (const [key, rawField] of Object.entries(schema)) {
+            const field = rawField;
+            if (field.default !== undefined) {
+                defaults[key] = field.default;
+            }
+        }
+        return defaults;
+    }
+    computeNeedsConfiguration(schema, values) {
+        for (const [key, rawField] of Object.entries(schema)) {
+            const field = rawField;
+            if (field.required === true) {
+                const val = values[key];
+                if (val === undefined || val === null || val === "") {
+                    if (field.default === undefined) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    encryptValues(schema, values) {
+        const result = { ...values };
+        for (const [key, rawField] of Object.entries(schema)) {
+            const field = rawField;
+            if (field.type === "secret" && result[key] !== undefined && result[key] !== null) {
+                const plaintext = String(result[key]);
+                result[key] = encrypt(plaintext);
+            }
+        }
+        return result;
+    }
+    decryptValues(schema, values) {
+        const result = { ...values };
+        for (const [key, rawField] of Object.entries(schema)) {
+            const field = rawField;
+            if (field.type === "secret" && result[key] !== undefined && result[key] !== null && typeof result[key] === "string") {
+                try {
+                    result[key] = decrypt(result[key]);
+                }
+                catch {
+                    // If decryption fails, leave as-is (corrupted data)
+                    this.logger.warn("failed to decrypt secret field", { field: key });
+                }
+            }
+        }
+        return result;
+    }
+    maskSecretValues(schema, values) {
+        const result = { ...values };
+        for (const [key, rawField] of Object.entries(schema)) {
+            const field = rawField;
+            if (field.type === "secret") {
+                if (result[key] !== undefined && result[key] !== null && result[key] !== "") {
+                    result[key] = SECRET_UNCHANGED_SENTINEL;
+                }
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=config-service.js.map

package/dist/config/config-service.js.map

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

package/dist/config/validate.d.ts

@@ -0,0 +1,12 @@
+import type { ConfigSchema } from "../types/plugin.js";
+export interface ValidationResult {
+    valid: boolean;
+    values: Record<string, unknown>;
+    errors: FieldError[];
+}
+export interface FieldError {
+    field: string;
+    message: string;
+}
+export declare function validateConfig<T>(schema: ConfigSchema<T>, input: Record<string, unknown>): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/config/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,oBAAoB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AA6BD,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,gBAAgB,CA0GlB"}

package/dist/config/validate.js

@@ -0,0 +1,140 @@
+// SPDX-License-Identifier: 0BSD
+// SPDX-FileCopyrightText: 2025 Digi <digitalpaws@proton.me>
+function isMissing(value) {
+    if (value === undefined || value === null)
+        return true;
+    if (typeof value === "string" && value === "")
+        return true;
+    return false;
+}
+function coerceNumber(value) {
+    if (typeof value === "number") {
+        if (Number.isFinite(value))
+            return { value, ok: true };
+        return { value: NaN, ok: false };
+    }
+    if (typeof value === "string") {
+        if (value === "")
+            return { value: NaN, ok: false };
+        const n = Number(value);
+        if (Number.isFinite(n))
+            return { value: n, ok: true };
+        return { value: NaN, ok: false };
+    }
+    return { value: NaN, ok: false };
+}
+function coerceBoolean(value) {
+    if (typeof value === "boolean")
+        return { value, ok: true };
+    if (value === "true")
+        return { value: true, ok: true };
+    if (value === "false")
+        return { value: false, ok: true };
+    return { value: false, ok: false };
+}
+export function validateConfig(schema, input) {
+    const values = {};
+    const errors = [];
+    for (const [key, rawField] of Object.entries(schema)) {
+        const field = rawField;
+        const inputVal = key in input ? input[key] : undefined;
+        const missing = isMissing(inputVal);
+        // Handle missing values
+        if (missing) {
+            if (field.default !== undefined) {
+                // Default is defined — use it (even if null)
+                values[key] = field.default;
+                continue;
+            }
+            if (field.required === true) {
+                errors.push({ field: key, message: "required field is missing" });
+                continue;
+            }
+            // Optional field with no default — store undefined
+            values[key] = undefined;
+            continue;
+        }
+        // Value is present — validate and coerce based on type
+        switch (field.type) {
+            case "string":
+            case "secret": {
+                if (typeof inputVal !== "string") {
+                    errors.push({ field: key, message: `expected string, got ${typeof inputVal}` });
+                }
+                else {
+                    values[key] = inputVal;
+                }
+                break;
+            }
+            case "number": {
+                const coerced = coerceNumber(inputVal);
+                if (!coerced.ok) {
+                    errors.push({ field: key, message: `expected a finite number, got ${JSON.stringify(inputVal)}` });
+                }
+                else {
+                    values[key] = coerced.value;
+                }
+                break;
+            }
+            case "boolean": {
+                const coerced = coerceBoolean(inputVal);
+                if (!coerced.ok) {
+                    errors.push({ field: key, message: `expected boolean or "true"/"false", got ${JSON.stringify(inputVal)}` });
+                }
+                else {
+                    values[key] = coerced.value;
+                }
+                break;
+            }
+            case "enum": {
+                if (typeof inputVal !== "string") {
+                    errors.push({ field: key, message: `expected string for enum, got ${typeof inputVal}` });
+                }
+                else if (field.options && field.options.length > 0 && !field.options.includes(inputVal)) {
+                    errors.push({
+                        field: key,
+                        message: `value "${inputVal}" is not in allowed options: [${field.options.join(", ")}]`,
+                    });
+                }
+                else {
+                    values[key] = inputVal;
+                }
+                break;
+            }
+            case "url": {
+                if (typeof inputVal !== "string") {
+                    errors.push({ field: key, message: `expected string for URL, got ${typeof inputVal}` });
+                }
+                else {
+                    try {
+                        new URL(inputVal);
+                        values[key] = inputVal;
+                    }
+                    catch {
+                        errors.push({ field: key, message: `"${inputVal}" is not a valid URL` });
+                    }
+                }
+                break;
+            }
+            case "path": {
+                if (typeof inputVal !== "string" || inputVal === "") {
+                    errors.push({ field: key, message: `expected non-empty string for path, got ${JSON.stringify(inputVal)}` });
+                }
+                else {
+                    values[key] = inputVal;
+                }
+                break;
+            }
+            default:
+                // Unknown field type — leniently accept as-is
+                values[key] = inputVal;
+                break;
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        values: errors.length === 0 ? values : {},
+        errors,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/config/validate.js.map

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

package/dist/content-types/registry.d.ts

@@ -0,0 +1,75 @@
+import type { ContentTypeDescriptor, NamingRule } from "@digitalpaws/starr-types-core";
+/**
+ * Pure validation function. Returns null if valid, or an error message string.
+ *
+ * Checks in order:
+ * - id is truthy
+ * - name is truthy
+ * - identity is a non-empty array (DS2)
+ * - Each field: key, label, type are truthy
+ * - list fields must have itemType (FT2)
+ * - enum fields must have non-empty options (FT2)
+ */
+export declare function validateDescriptor(descriptor: ContentTypeDescriptor): string | null;
+/**
+ * Full content-type registry implementation.
+ *
+ * Plugins call register() via ctx.contentTypes.register. The host internally
+ * uses get(), list(), and rollbackPlugin().
+ */
+export declare class ContentTypeRegistryImpl {
+    private descriptors;
+    private pluginToIds;
+    /**
+     * Register a descriptor. Optionally associates it with a pluginId for
+     * rollback support.
+     */
+    register(descriptor: ContentTypeDescriptor, pluginId?: string): void;
+    /** Retrieve a descriptor by id. Returns undefined if not found. */
+    get(id: string): ContentTypeDescriptor | undefined;
+    /** List all registered descriptors. */
+    list(): ContentTypeDescriptor[];
+    /**
+     * Roll back (remove) all descriptors registered by a given plugin.
+     * Safe to call for unknown pluginIds (no-op).
+     */
+    rollbackPlugin(pluginId: string): void;
+}
+/**
+ * Compute a deterministic content-identity string for an item.
+ *
+ * Algorithm:
+ * 1. Look up the descriptor for item.contentTypeId.
+ * 2. If descriptor exists: walk descriptor.identity in order. For each key,
+ *    if item.externalIds[key] is present and non-empty, return
+ *    "${contentTypeId}::${key}=${value}".
+ * 3. If no identity key is present in the item's externalIds (or descriptor
+ *    not found): return "${contentTypeId}::undecidable::${sortedExternalIds}"
+ *    where sortedExternalIds is all externalId pairs sorted by key.
+ */
+export declare function computeContentIdentity(item: {
+    contentTypeId: string;
+    externalIds: Record<string, string>;
+}, registry: ContentTypeRegistryImpl): string;
+/**
+ * Compare two content items for identity.
+ *
+ * Algorithm:
+ * 1. If contentTypeId differs → false (ID2).
+ * 2. Look up descriptor. If not found → false.
+ * 3. Walk descriptor.identity in order. For each key, if BOTH items have a
+ *    truthy value, return whether they are equal.
+ * 4. No mutually-present key → false (ID1 — undecidable).
+ */
+export declare function areSameItem(a: {
+    contentTypeId: string;
+    externalIds: Record<string, string>;
+}, b: {
+    contentTypeId: string;
+    externalIds: Record<string, string>;
+}, registry: ContentTypeRegistryImpl): boolean;
+/**
+ * Get the naming rule for a content type, falling back to a safe default.
+ */
+export declare function getNamingRule(contentTypeId: string, registry: ContentTypeRegistryImpl): NamingRule;
+//# sourceMappingURL=registry.d.ts.map

package/dist/content-types/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/content-types/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CA6BnF;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,WAAW,CAA+B;IAElD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,qBAAqB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBpE,mEAAmE;IACnE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAIlD,uCAAuC;IACvC,IAAI,IAAI,qBAAqB,EAAE;IAI/B;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAOvC;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACpE,QAAQ,EAAE,uBAAuB,GAChC,MAAM,CAcR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACjE,CAAC,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACjE,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAeT;AAUD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,uBAAuB,GAChC,UAAU,CAGZ"}