@actuate-media/cms-core 0.42.0 → 0.44.0

package/dist/__tests__/ai/ai.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai.test.d.ts.map

package/dist/__tests__/ai/ai.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/ai/ai.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ai/ai.test.js

@@ -0,0 +1,261 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { defaultAISettings, encryptProviderKey, getAIConfig, getEnvApiKey, last4, resolveProviderKey, toPublicProvider, } from '../../ai/config-store.js';
+import { mergeFeatures } from '../../ai/feature-defaults.js';
+import { curatedFallbackCatalog, normalizeModel } from '../../ai/catalog.js';
+import { resolveModelOrUnavailable } from '../../ai/models.js';
+import { getUsageSummary } from '../../ai/usage.js';
+import * as openai from '../../ai/providers/openai.js';
+import * as anthropic from '../../ai/providers/anthropic.js';
+import * as custom from '../../ai/providers/custom.js';
+function makeConn(overrides = {}) {
+    return {
+        id: 'c1',
+        provider: 'anthropic',
+        displayName: 'Anthropic',
+        enabled: true,
+        status: 'unknown',
+        createdAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+        updatedBy: 'u1',
+        ...overrides,
+    };
+}
+function mockResponse(status, body) {
+    return {
+        ok: status >= 200 && status < 300,
+        status,
+        json: async () => body,
+    };
+}
+describe('ai/config-store', () => {
+    const origEnv = { ...process.env };
+    afterEach(() => {
+        process.env = { ...origEnv };
+        vi.restoreAllMocks();
+    });
+    it('encrypts a key and masks to last4 without leaking the key', async () => {
+        const { apiKeyEncrypted, apiKeyLast4 } = await encryptProviderKey('sk-ant-secret-7788');
+        expect(apiKeyLast4).toBe('7788');
+        const conn = makeConn({ apiKeyEncrypted, apiKeyLast4 });
+        const pub = toPublicProvider(conn);
+        expect(pub.apiKeyEncrypted).toBeUndefined();
+        expect(pub.apiKeyLast4).toBe('7788');
+        expect(pub.hasKey).toBe(true);
+        expect(pub.apiKeySource).toBe('database');
+        expect(pub.keyManagedExternally).toBe(false);
+    });
+    it('treats an env-managed provider as read-only and reflects the env key suffix', () => {
+        process.env.OPENAI_API_KEY = 'sk-env-key-9090';
+        const conn = makeConn({ provider: 'openai' });
+        const pub = toPublicProvider(conn);
+        expect(pub.apiKeySource).toBe('environment');
+        expect(pub.keyManagedExternally).toBe(true);
+        expect(pub.apiKeyLast4).toBe('9090');
+        expect(getEnvApiKey('openai')).toBe('sk-env-key-9090');
+    });
+    it('resolves the env key over a stored key, else decrypts the stored key', async () => {
+        const { apiKeyEncrypted } = await encryptProviderKey('stored-key-1111');
+        const conn = makeConn({ provider: 'xai', apiKeyEncrypted });
+        expect(await resolveProviderKey(conn)).toBe('stored-key-1111');
+        process.env.XAI_API_KEY = 'env-key-2222';
+        expect(await resolveProviderKey(conn)).toBe('env-key-2222');
+    });
+    it('last4 handles short and empty values', () => {
+        expect(last4('abcdef')).toBe('cdef');
+        expect(last4('ab')).toBe('ab');
+        expect(last4('')).toBeUndefined();
+        expect(last4(undefined)).toBeUndefined();
+    });
+    it('getAIConfig returns populated defaults when no document exists', async () => {
+        const db = { document: { findFirst: async () => null } };
+        const config = await getAIConfig(db);
+        expect(config.providers).toEqual([]);
+        expect(config.settings.features.length).toBeGreaterThan(0);
+        expect(config.settings.budget.alertAtPercentages).toEqual([50, 80, 100]);
+    });
+    it('getAIConfig merges stored feature toggles over current defaults', async () => {
+        const db = {
+            document: {
+                findFirst: async () => ({
+                    data: {
+                        providers: [],
+                        settings: {
+                            features: [{ key: 'ai.features.contentWriting', enabled: false }],
+                        },
+                    },
+                }),
+            },
+        };
+        const config = await getAIConfig(db);
+        const cw = config.settings.features.find((f) => f.key === 'ai.features.contentWriting');
+        expect(cw?.enabled).toBe(false);
+        // Other defaults still present.
+        expect(config.settings.features.length).toBe(defaultAISettings().features.length);
+    });
+});
+describe('ai/feature-defaults mergeFeatures', () => {
+    it('preserves enabled state and drops unknown keys', () => {
+        const merged = mergeFeatures([
+            { key: 'ai.features.mediaAltText', enabled: false },
+            { key: 'ai.features.removed', enabled: true },
+        ]);
+        expect(merged.find((f) => f.key === 'ai.features.mediaAltText')?.enabled).toBe(false);
+        expect(merged.find((f) => f.key === 'ai.features.removed')).toBeUndefined();
+    });
+});
+describe('ai/catalog normalizeModel', () => {
+    const now = '2026-01-01T00:00:00.000Z';
+    it('merges curated capabilities + display name for a dated provider id', () => {
+        const m = normalizeModel({
+            provider: 'openai',
+            providerModelId: 'gpt-4o-2024-08-06',
+            source: 'provider',
+            lastSyncedAt: now,
+        });
+        expect(m.displayName).toBe('GPT-4o (balanced)');
+        expect(m.capabilities.vision).toBe(true);
+        expect(m.capabilities.text).toBe(true);
+        expect(m.pricing?.inputPerMillion).toBe(2.5);
+    });
+    it('prefers the longest match (gpt-4o-mini over gpt-4o)', () => {
+        const m = normalizeModel({
+            provider: 'openai',
+            providerModelId: 'gpt-4o-mini-2024-07-18',
+            source: 'provider',
+            lastSyncedAt: now,
+        });
+        expect(m.displayName).toBe('GPT-4o mini (fast)');
+    });
+    it('infers conservative capabilities for an unknown model', () => {
+        const m = normalizeModel({
+            provider: 'custom',
+            providerModelId: 'mystery-llm-v9',
+            source: 'manual',
+            lastSyncedAt: now,
+        });
+        expect(m.capabilities.text).toBe(true);
+        expect(m.capabilities.vision).toBe(false);
+        expect(m.metadata).toEqual({});
+    });
+    it('detects embedding models by id', () => {
+        const m = normalizeModel({
+            provider: 'custom',
+            providerModelId: 'my-embedding-model',
+            source: 'manual',
+            lastSyncedAt: now,
+        });
+        expect(m.capabilities.embeddings).toBe(true);
+        expect(m.capabilities.text).toBe(false);
+        expect(m.outputModalities).toEqual(['embedding']);
+    });
+    it('curatedFallbackCatalog returns normalized models for a provider', () => {
+        const models = curatedFallbackCatalog('anthropic', now);
+        expect(models.length).toBeGreaterThan(0);
+        expect(models.every((m) => m.provider === 'anthropic')).toBe(true);
+        expect(models.some((m) => m.displayName === 'Claude Sonnet (balanced)')).toBe(true);
+    });
+});
+describe('ai/models resolveModelOrUnavailable', () => {
+    it('returns the catalog model when present', () => {
+        const catalog = curatedFallbackCatalog('anthropic', '2026-01-01T00:00:00.000Z');
+        const target = catalog[0];
+        expect(resolveModelOrUnavailable(target.id, catalog)?.status).not.toBe('unavailable');
+    });
+    it('synthesizes an unavailable model when the id is gone', () => {
+        const catalog = curatedFallbackCatalog('anthropic', '2026-01-01T00:00:00.000Z');
+        const m = resolveModelOrUnavailable('openai:ghost-model', catalog);
+        expect(m?.status).toBe('unavailable');
+        expect(m?.provider).toBe('openai');
+        expect(m?.providerModelId).toBe('ghost-model');
+    });
+    it('returns null for an empty id', () => {
+        expect(resolveModelOrUnavailable(undefined, [])).toBeNull();
+    });
+});
+describe('ai/providers adapters (mocked fetch)', () => {
+    it('openai testConnection maps 200 -> connected and lists model ids', async () => {
+        const fetchImpl = vi
+            .fn()
+            .mockResolvedValue(mockResponse(200, { data: [{ id: 'gpt-4o' }, { id: 'gpt-4o-mini' }] }));
+        const res = await openai.testConnection({ apiKey: 'k', fetchImpl });
+        expect(res.status).toBe('connected');
+        expect(res.ok).toBe(true);
+        const ids = await openai.listModels({ apiKey: 'k', fetchImpl });
+        expect(ids).toEqual(['gpt-4o', 'gpt-4o-mini']);
+    });
+    it('openai testConnection maps 401 -> invalid_key', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(mockResponse(401, {}));
+        const res = await openai.testConnection({ apiKey: 'bad', fetchImpl });
+        expect(res.status).toBe('invalid_key');
+        expect(res.ok).toBe(false);
+    });
+    it('openai testConnection reports needs_setup with no key', async () => {
+        const res = await openai.testConnection({ apiKey: '' });
+        expect(res.status).toBe('needs_setup');
+    });
+    it('anthropic sends x-api-key + version headers', async () => {
+        const fetchImpl = vi
+            .fn()
+            .mockResolvedValue(mockResponse(200, { data: [] }));
+        await anthropic.testConnection({ apiKey: 'k', fetchImpl });
+        const call = fetchImpl.mock.calls[0];
+        const headers = call[1].headers;
+        expect(headers['x-api-key']).toBe('k');
+        expect(headers['anthropic-version']).toBeTruthy();
+    });
+    it('custom provider rejects an SSRF base URL before fetching', async () => {
+        const fetchImpl = vi.fn();
+        const res = await custom.testConnection({
+            apiKey: 'k',
+            baseUrl: 'http://127.0.0.1/v1',
+            fetchImpl,
+        });
+        expect(res.ok).toBe(false);
+        expect(res.message.toLowerCase()).toContain('unsafe');
+        expect(fetchImpl.mock.calls.length).toBe(0);
+    });
+    it('custom provider treats 404 /models as connected (manual model entry)', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(mockResponse(404, {}));
+        // Public IP literal so the SSRF guard's DNS resolution is skipped (offline test).
+        const res = await custom.testConnection({
+            apiKey: 'k',
+            baseUrl: 'https://93.184.216.34/v1',
+            fetchImpl,
+        });
+        expect(res.ok).toBe(true);
+        expect(res.status).toBe('connected');
+    });
+});
+describe('ai/usage getUsageSummary', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-06-15T12:00:00.000Z'));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('aggregates token totals from audit rows within the month', async () => {
+        const db = {
+            document: { findFirst: async () => null },
+            auditLog: {
+                findMany: async () => [
+                    { details: { totalTokensUsed: 100 } },
+                    { details: { tokensUsed: 50 } },
+                    { details: { promptTokens: 10, completionTokens: 5 } },
+                    { details: { action: 'noop' } },
+                ],
+            },
+        };
+        const summary = await getUsageSummary(db);
+        expect(summary.totalTokens).toBe(165);
+        expect(summary.runCount).toBe(3);
+        expect(summary.periodStart).toBe('2026-06-01T00:00:00.000Z');
+    });
+    it('returns zero usage when there are no rows', async () => {
+        const db = { document: { findFirst: async () => null }, auditLog: { findMany: async () => [] } };
+        const summary = await getUsageSummary(db);
+        expect(summary.totalTokens).toBe(0);
+        expect(summary.runCount).toBe(0);
+    });
+});
+//# sourceMappingURL=ai.test.js.map

package/dist/__tests__/ai/ai.test.js.map

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

package/dist/__tests__/ai/resolve.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve.test.d.ts.map

package/dist/__tests__/ai/resolve.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/ai/resolve.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ai/resolve.test.js

@@ -0,0 +1,164 @@
+import { describe, expect, it } from 'vitest';
+import { resolveAllFeatureModels, resolveFeatureModel } from '../../ai/resolve.js';
+const NO_CAPS = {
+    text: false,
+    vision: false,
+    imageGeneration: false,
+    embeddings: false,
+    toolCalling: false,
+    structuredOutput: false,
+    streaming: false,
+    reasoning: false,
+    longContext: false,
+};
+function model(id, caps, over = {}) {
+    const [provider = 'anthropic', providerModelId = id] = id.split(':');
+    return {
+        id,
+        provider: provider,
+        providerModelId,
+        displayName: id,
+        status: 'available',
+        capabilities: { ...NO_CAPS, ...caps },
+        inputModalities: ['text'],
+        outputModalities: ['text'],
+        lastSyncedAt: '2026-01-01T00:00:00.000Z',
+        source: 'provider',
+        metadata: {},
+        ...over,
+    };
+}
+function conn(over = {}) {
+    return {
+        id: 'p-anthropic',
+        provider: 'anthropic',
+        displayName: 'Anthropic',
+        enabled: true,
+        status: 'connected',
+        createdAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+        updatedBy: 'u1',
+        ...over,
+    };
+}
+function config(over) {
+    return {
+        providers: over.providers ?? [conn()],
+        settings: {
+            defaultModelId: over.defaultModelId,
+            defaultVisionModelId: over.defaultVisionModelId,
+            features: over.features ?? [],
+            budget: { alertAtPercentages: [], disableWhenExceeded: false },
+            logsRetentionDays: 30,
+        },
+    };
+}
+const textFeature = {
+    key: 'ai.features.contentWriting',
+    label: 'Content writing',
+    description: '',
+    enabled: true,
+    category: 'content',
+    requiredCapabilities: ['text'],
+    approvalRequired: false,
+    allowBulkApply: false,
+    rolesAllowed: ['ADMIN'],
+    permissionsRequired: ['ai.use'],
+};
+describe('resolveFeatureModel', () => {
+    it('uses the global default when the feature has no override', () => {
+        const catalog = [model('anthropic:claude-x', { text: true })];
+        const cfg = config({ defaultModelId: 'anthropic:claude-x', features: [textFeature] });
+        const r = resolveFeatureModel(cfg, textFeature.key, catalog);
+        expect(r.modelId).toBe('anthropic:claude-x');
+        expect(r.source).toBe('global-default');
+        expect(r.providerId).toBe('p-anthropic');
+        expect(r.satisfiesCapabilities).toBe(true);
+    });
+    it('prefers the feature-level model override over the default', () => {
+        const catalog = [
+            model('anthropic:claude-x', { text: true }),
+            model('openai:gpt-y', { text: true }, { provider: 'openai' }),
+        ];
+        const cfg = config({
+            providers: [conn(), conn({ id: 'p-openai', provider: 'openai' })],
+            defaultModelId: 'anthropic:claude-x',
+            features: [{ ...textFeature, modelId: 'openai:gpt-y' }],
+        });
+        const r = resolveFeatureModel(cfg, textFeature.key, catalog);
+        expect(r.modelId).toBe('openai:gpt-y');
+        expect(r.source).toBe('feature-override');
+        expect(r.providerId).toBe('p-openai');
+    });
+    it('falls back to the capability-typed default for a vision feature', () => {
+        const visionFeature = {
+            ...textFeature,
+            key: 'ai.features.mediaAltText',
+            requiredCapabilities: ['vision'],
+        };
+        const catalog = [
+            model('anthropic:claude-text', { text: true }),
+            model('openai:gpt-vision', { text: true, vision: true }, { provider: 'openai' }),
+        ];
+        const cfg = config({
+            providers: [conn(), conn({ id: 'p-openai', provider: 'openai' })],
+            defaultModelId: 'anthropic:claude-text', // text-only, can't satisfy vision
+            defaultVisionModelId: 'openai:gpt-vision',
+            features: [visionFeature],
+        });
+        const r = resolveFeatureModel(cfg, visionFeature.key, catalog);
+        expect(r.modelId).toBe('openai:gpt-vision');
+        expect(r.source).toBe('capability-default');
+        expect(r.satisfiesCapabilities).toBe(true);
+    });
+    it('reports missing capabilities when no candidate satisfies them', () => {
+        const visionFeature = {
+            ...textFeature,
+            key: 'ai.features.mediaAltText',
+            requiredCapabilities: ['vision'],
+        };
+        const catalog = [model('anthropic:claude-text', { text: true })];
+        const cfg = config({ defaultModelId: 'anthropic:claude-text', features: [visionFeature] });
+        const r = resolveFeatureModel(cfg, visionFeature.key, catalog);
+        expect(r.modelId).toBe('anthropic:claude-text');
+        expect(r.satisfiesCapabilities).toBe(false);
+        expect(r.missingCapabilities).toContain('vision');
+    });
+    it('keeps an uncatalogued override and flags it as not satisfying capabilities', () => {
+        const cfg = config({
+            features: [{ ...textFeature, modelId: 'anthropic:ghost-model' }],
+        });
+        const r = resolveFeatureModel(cfg, textFeature.key, []);
+        expect(r.modelId).toBe('anthropic:ghost-model');
+        expect(r.source).toBe('feature-override');
+        expect(r.satisfiesCapabilities).toBe(false);
+    });
+    it('returns source "none" with no model configured', () => {
+        const cfg = config({ features: [textFeature] });
+        const r = resolveFeatureModel(cfg, textFeature.key, []);
+        expect(r.source).toBe('none');
+        expect(r.modelId).toBeUndefined();
+        expect(r.missingCapabilities).toContain('text');
+    });
+    it('does not select an unavailable model when an available one exists', () => {
+        const catalog = [
+            model('anthropic:dead', { text: true }, { status: 'unavailable' }),
+            model('anthropic:live', { text: true }),
+        ];
+        const cfg = config({
+            defaultModelId: 'anthropic:dead',
+            features: [{ ...textFeature, fallbackModelIds: ['anthropic:live'] }],
+        });
+        const r = resolveFeatureModel(cfg, textFeature.key, catalog);
+        expect(r.modelId).toBe('anthropic:live');
+        expect(r.source).toBe('fallback');
+    });
+    it('resolveAllFeatureModels keys by feature', () => {
+        const catalog = [model('anthropic:claude-x', { text: true })];
+        const cfg = config({ defaultModelId: 'anthropic:claude-x', features: [textFeature] });
+        const all = resolveAllFeatureModels(cfg, catalog);
+        expect(Object.keys(all)).toEqual([textFeature.key]);
+        expect(all[textFeature.key]?.modelId).toBe('anthropic:claude-x');
+    });
+});
+//# sourceMappingURL=resolve.test.js.map

package/dist/__tests__/ai/resolve.test.js.map

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

package/dist/ai/catalog.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Curated model metadata + normalization.
+ *
+ * Live provider listing endpoints return model IDs and little else (rarely
+ * capabilities or pricing). We merge those IDs with a curated capability/pricing
+ * map so the catalog always knows what a model can do, what it costs, and
+ * whether it is current. When no key/live listing is available, the curated
+ * entries also serve as the fallback catalog.
+ *
+ * Matching is prefix-based (longest match wins) so dated provider IDs like
+ * `gpt-4o-2024-08-06` resolve to the `gpt-4o` entry, while `gpt-4o-mini-*`
+ * resolves to its own entry.
+ */
+import type { AIModel, AIProviderKey } from './types.js';
+export interface NormalizeInput {
+    provider: AIProviderKey;
+    providerModelId: string;
+    source: AIModel['source'];
+    lastSyncedAt: string;
+    /** Override status (e.g. 'available' from a live listing). */
+    status?: AIModel['status'];
+    /** Provider-supplied display name, if any. */
+    displayName?: string;
+}
+/** Merge a (live or fallback) model id with curated metadata into an AIModel. */
+export declare function normalizeModel(input: NormalizeInput): AIModel;
+/** Curated fallback catalog for a provider (used when no live listing). */
+export declare function curatedFallbackCatalog(provider: AIProviderKey, lastSyncedAt: string): AIModel[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/ai/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/ai/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAuC,aAAa,EAAE,MAAM,YAAY,CAAA;AAmT7F,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CA4B7D;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,CAc/F"}