@proletariat/cli 0.3.58 → 0.3.60

package/dist/lib/work-source/provider-sources.js

@@ -0,0 +1,227 @@
+/**
+ * Multi-Source Provider Configuration
+ *
+ * Allows a workspace to have multiple external ticket providers configured
+ * simultaneously (e.g. Linear for engineering, Asana for product, Shortcut
+ * for design). Each source entry includes a provider type, API key reference,
+ * team/project ID, and an identifier prefix used for routing ticket keys to
+ * the correct provider.
+ *
+ * Stored as a JSON array in workspace_settings under the key
+ * `work.provider_sources`.
+ */
+import { WORK_SOURCE_PROVIDERS, isWorkSourceProvider } from './config.js';
+const SETTINGS_TABLE = 'workspace_settings';
+const PROVIDER_SOURCES_KEY = 'work.provider_sources';
+export function validateProviderSourceEntry(entry) {
+    const errors = [];
+    if (!entry.id || entry.id.trim().length === 0) {
+        errors.push({ field: 'id', message: 'id is required' });
+    }
+    else if (!/^[a-z0-9][a-z0-9_-]*$/.test(entry.id)) {
+        errors.push({
+            field: 'id',
+            message: 'id must be lowercase alphanumeric with hyphens/underscores, starting with a letter or digit',
+        });
+    }
+    if (!entry.provider) {
+        errors.push({ field: 'provider', message: 'provider is required' });
+    }
+    else if (!isWorkSourceProvider(entry.provider)) {
+        errors.push({
+            field: 'provider',
+            message: `provider must be one of: ${WORK_SOURCE_PROVIDERS.join(', ')}`,
+        });
+    }
+    if (!entry.apiKeyRef || entry.apiKeyRef.trim().length === 0) {
+        errors.push({ field: 'apiKeyRef', message: 'apiKeyRef is required' });
+    }
+    if (!entry.teamProjectId || entry.teamProjectId.trim().length === 0) {
+        errors.push({ field: 'teamProjectId', message: 'teamProjectId is required' });
+    }
+    if (!entry.prefix || entry.prefix.trim().length === 0) {
+        errors.push({ field: 'prefix', message: 'prefix is required' });
+    }
+    return errors;
+}
+// =============================================================================
+// Persistence
+// =============================================================================
+function getRawSetting(db, key) {
+    const row = db
+        .prepare(`SELECT value FROM ${SETTINGS_TABLE} WHERE key = ?`)
+        .get(key);
+    return row?.value ?? null;
+}
+function setRawSetting(db, key, value) {
+    db.prepare(`
+    INSERT INTO ${SETTINGS_TABLE} (key, value)
+    VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = excluded.value
+  `).run(key, value);
+}
+function deleteRawSetting(db, key) {
+    db.prepare(`DELETE FROM ${SETTINGS_TABLE} WHERE key = ?`).run(key);
+}
+/**
+ * Load all provider source entries from the database.
+ * Returns an empty array if none are configured.
+ */
+export function loadProviderSources(db) {
+    const raw = getRawSetting(db, PROVIDER_SOURCES_KEY);
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((entry) => typeof entry === 'object' &&
+            entry !== null &&
+            typeof entry.id === 'string' &&
+            typeof entry.provider === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Save the full list of provider source entries to the database.
+ */
+export function saveProviderSources(db, sources) {
+    if (sources.length === 0) {
+        deleteRawSetting(db, PROVIDER_SOURCES_KEY);
+        return;
+    }
+    setRawSetting(db, PROVIDER_SOURCES_KEY, JSON.stringify(sources));
+}
+/**
+ * Add a new provider source entry. Returns validation errors if invalid,
+ * or throws if an entry with the same id already exists.
+ */
+export function addProviderSource(db, entry) {
+    const errors = validateProviderSourceEntry(entry);
+    if (errors.length > 0)
+        return errors;
+    const existing = loadProviderSources(db);
+    if (existing.some((e) => e.id === entry.id)) {
+        return [{ field: 'id', message: `A provider source with id "${entry.id}" already exists` }];
+    }
+    if (existing.some((e) => e.prefix.toUpperCase() === entry.prefix.toUpperCase())) {
+        return [{ field: 'prefix', message: `A provider source with prefix "${entry.prefix}" already exists` }];
+    }
+    existing.push(entry);
+    saveProviderSources(db, existing);
+    return [];
+}
+/**
+ * Update an existing provider source entry by id.
+ * Returns validation errors if the update is invalid, or if the entry is not found.
+ */
+export function updateProviderSource(db, id, updates) {
+    const sources = loadProviderSources(db);
+    const index = sources.findIndex((e) => e.id === id);
+    if (index === -1) {
+        return [{ field: 'id', message: `No provider source found with id "${id}"` }];
+    }
+    const merged = { ...sources[index], ...updates };
+    const errors = validateProviderSourceEntry(merged);
+    if (errors.length > 0)
+        return errors;
+    // Check prefix uniqueness against other entries
+    if (updates.prefix &&
+        sources.some((e, i) => i !== index && e.prefix.toUpperCase() === updates.prefix.toUpperCase())) {
+        return [{ field: 'prefix', message: `A provider source with prefix "${updates.prefix}" already exists` }];
+    }
+    sources[index] = merged;
+    saveProviderSources(db, sources);
+    return [];
+}
+/**
+ * Remove a provider source entry by id.
+ * Returns true if removed, false if not found.
+ */
+export function removeProviderSource(db, id) {
+    const sources = loadProviderSources(db);
+    const filtered = sources.filter((e) => e.id !== id);
+    if (filtered.length === sources.length)
+        return false;
+    saveProviderSources(db, filtered);
+    return true;
+}
+/**
+ * Get a single provider source entry by id.
+ */
+export function getProviderSourceById(db, id) {
+    const sources = loadProviderSources(db);
+    return sources.find((e) => e.id === id) ?? null;
+}
+// =============================================================================
+// Prefix-Based Routing
+// =============================================================================
+/**
+ * Resolve which provider source should handle a given ticket key based on
+ * its prefix. Matching is case-insensitive and selects the longest matching
+ * prefix (most specific match wins).
+ *
+ * Example: given sources with prefixes ['ENG-', 'PROD-', 'DES-'],
+ *   resolveProviderByPrefix(db, 'ENG-123') → source with prefix 'ENG-'
+ *   resolveProviderByPrefix(db, 'PROD-456') → source with prefix 'PROD-'
+ *   resolveProviderByPrefix(db, 'UNKNOWN-789') → null
+ */
+export function resolveProviderByPrefix(db, ticketKey) {
+    const sources = loadProviderSources(db);
+    return resolveProviderByPrefixFromList(sources, ticketKey);
+}
+/**
+ * Pure function variant that operates on an in-memory list of sources.
+ * Useful for testing and batch operations.
+ */
+export function resolveProviderByPrefixFromList(sources, ticketKey) {
+    const upperKey = ticketKey.toUpperCase();
+    let bestMatch = null;
+    let bestLength = 0;
+    for (const source of sources) {
+        const upperPrefix = source.prefix.toUpperCase();
+        if (upperKey.startsWith(upperPrefix) && upperPrefix.length > bestLength) {
+            bestMatch = source;
+            bestLength = upperPrefix.length;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Get all configured prefixes and their provider mappings.
+ * Useful for displaying the routing table to the user.
+ */
+export function getRoutingTable(db) {
+    const sources = loadProviderSources(db);
+    return sources.map((s) => ({
+        prefix: s.prefix,
+        provider: s.provider,
+        label: s.label ?? s.id,
+        id: s.id,
+    }));
+}
+// =============================================================================
+// API Key Resolution
+// =============================================================================
+/**
+ * Resolve the actual API key value from a ProviderSourceEntry's apiKeyRef.
+ *
+ * Resolution order:
+ * 1. If apiKeyRef matches an environment variable name, use its value
+ * 2. If apiKeyRef matches a workspace_settings key, use its value
+ * 3. Return null if neither resolves
+ */
+export function resolveApiKey(db, entry) {
+    // Try environment variable first
+    const envValue = process.env[entry.apiKeyRef];
+    if (envValue)
+        return envValue;
+    // Try workspace_settings key
+    const dbValue = getRawSetting(db, entry.apiKeyRef);
+    if (dbValue)
+        return dbValue;
+    return null;
+}
+//# sourceMappingURL=provider-sources.js.map

package/dist/lib/work-source/provider-sources.js.map

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