@actuate-media/cms-core 0.16.0 → 0.18.0

package/dist/__tests__/api/collections-ai-create.test.d.ts

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

package/dist/__tests__/api/collections-ai-create.test.d.ts.map

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

package/dist/__tests__/api/collections-ai-create.test.js

@@ -0,0 +1,313 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// IMPORTANT: vi.mock calls are hoisted. We mock `@actuate-media/plugin-ai`
+// so the dynamic import inside handlers.ts resolves to a deterministic
+// generator instead of trying to hit a real LLM provider.
+vi.mock('@actuate-media/plugin-ai', () => ({
+    generateDocumentContent: vi.fn(async (input) => ({
+        data: {
+            title: 'Five Spring Cleaning Tips',
+            slug: 'five-spring-cleaning-tips',
+            excerpt: 'A practical guide.',
+            body: 'When spring arrives, tackle these five tasks first.',
+        },
+        title: 'Five Spring Cleaning Tips',
+        slug: 'five-spring-cleaning-tips',
+        seo: {
+            metaTitle: 'Spring Cleaning Tips',
+            metaDescription: 'Five practical spring cleaning tips for busy households.',
+            schemaType: input?.collection?.seo?.defaultSchemaType ?? 'Article',
+        },
+        usage: { promptTokens: 100, completionTokens: 250 },
+        durationMs: 42,
+    })),
+}));
+import { handleActuateAPI } from '../../api/index.js';
+import { initDB } from '../../db.js';
+import { generateApiKey } from '../../security/api-key-enhanced.js';
+const VALID_SECRET = 'a'.repeat(48);
+function createMockDB(opts) {
+    const apiKey = opts.apiKey;
+    let lastCreatedDoc = null;
+    const dbMock = {
+        apiKey: {
+            findMany: async () => (apiKey ? [apiKey] : []),
+            findUnique: async ({ where }) => {
+                if (!apiKey)
+                    return null;
+                if (apiKey.keyHash !== where.keyHash)
+                    return null;
+                return apiKey;
+            },
+            update: async () => apiKey,
+        },
+        document: {
+            findMany: async () => [],
+            findUnique: async () => lastCreatedDoc,
+            findFirst: async ({ where }) => {
+                // Return the most recently created doc if its id matches; otherwise
+                // null. updateDocument calls findFirst({ id, collection, deletedAt: null }).
+                if (!lastCreatedDoc)
+                    return null;
+                if (where?.id && where.id !== lastCreatedDoc.id)
+                    return null;
+                return lastCreatedDoc;
+            },
+            count: async () => 0,
+            create: async ({ data }) => {
+                lastCreatedDoc = {
+                    ...data,
+                    id: 'doc-ai-1',
+                    createdAt: new Date(),
+                    updatedAt: new Date(),
+                };
+                return lastCreatedDoc;
+            },
+            update: async ({ data }) => {
+                lastCreatedDoc = { ...lastCreatedDoc, ...data, updatedAt: new Date() };
+                return lastCreatedDoc;
+            },
+        },
+        version: {
+            create: async ({ data }) => ({ ...data, id: 'ver-1' }),
+            findMany: async () => [],
+        },
+        documentRevision: {
+            create: async ({ data }) => ({ ...data, id: 'rev-1' }),
+        },
+        auditLog: { create: async () => ({}) },
+        webhook: { findMany: async () => [] },
+        webhookDelivery: { create: async () => ({}) },
+        user: {},
+        session: {},
+        media: {},
+    };
+    // createDocument may wrap the create in a transaction. Run the callback
+    // against the mock itself so the same model proxies fire.
+    dbMock.$transaction = async (arg) => {
+        if (typeof arg === 'function') {
+            return await arg(dbMock);
+        }
+        if (Array.isArray(arg)) {
+            return Promise.all(arg);
+        }
+        return arg;
+    };
+    return dbMock;
+}
+async function makeKey(scopes) {
+    const { key, keyHash, keyPrefix } = await generateApiKey({ prefix: 'act_sk', scopes });
+    return {
+        key,
+        record: {
+            id: 'apikey-ai',
+            keyHash,
+            keyPrefix,
+            userId: 'user-1',
+            scopes,
+            ipRestrictions: null,
+            expiresAt: null,
+            lastUsedAt: null,
+            revokedAt: null,
+        },
+    };
+}
+const postsCollection = {
+    slug: 'posts',
+    labels: { singular: 'Post', plural: 'Posts' },
+    type: 'post',
+    seo: { defaultSchemaType: 'BlogPosting' },
+    fields: {
+        title: { type: 'text', label: 'Title', required: true },
+        slug: { type: 'slug', label: 'Slug', required: true },
+        excerpt: { type: 'text', label: 'Excerpt' },
+        body: { type: 'richText', label: 'Body' },
+    },
+};
+const pagesCollection = {
+    slug: 'pages',
+    labels: { singular: 'Page', plural: 'Pages' },
+    type: 'page',
+    fields: {
+        title: { type: 'text', label: 'Title', required: true },
+        slug: { type: 'slug', label: 'Slug', required: true },
+        layout: { type: 'blocks', label: 'Layout' },
+    },
+};
+describe('POST /collections/:slug/ai-create', () => {
+    beforeEach(() => {
+        delete globalThis.__actuateConfig;
+        process.env.CMS_SECRET = VALID_SECRET;
+    });
+    it('creates a document via AI when caller has create scope on the collection', async () => {
+        const { key, record } = await makeKey({ collections: ['posts'], actions: ['create'] });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/posts/ai-create', {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${key}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ prompt: 'Write a post about spring cleaning' }),
+        }));
+        const body = await response.json();
+        expect({ status: response.status, body }).toMatchObject({ status: 201 });
+        expect(body.data.document.id).toBe('doc-ai-1');
+        expect(body.data.document.title).toBe('Five Spring Cleaning Tips');
+        expect(body.data.document.slug).toBe('five-spring-cleaning-tips');
+        expect(body.data.document.status).toBe('DRAFT');
+        // SEO metadata flows back through the generation block (not pageSettings,
+        // which is a page-builder-only wire shape).
+        expect(body.data.generation.seo.schemaType).toBe('BlogPosting');
+        expect(body.data.generation.usage.completionTokens).toBe(250);
+    });
+    it('returns 400 when prompt is missing', async () => {
+        const { key, record } = await makeKey({ collections: ['posts'], actions: ['create'] });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/posts/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({}),
+        }));
+        expect(response.status).toBe(400);
+        const body = await response.json();
+        expect(body.error).toContain('prompt');
+    });
+    it('returns 404 when the collection is not configured', async () => {
+        const { key, record } = await makeKey({ admin: true });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/no-such-collection/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt: 'test' }),
+        }));
+        expect(response.status).toBe(404);
+    });
+    it('refuses page-builder collections and points to /page-builder/create', async () => {
+        const { key, record } = await makeKey({ collections: ['pages'], actions: ['create'] });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { pages: pagesCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/pages/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt: 'Create a homepage' }),
+        }));
+        expect(response.status).toBe(400);
+        const body = await response.json();
+        expect(body.error).toContain('page-builder/create');
+    });
+    it('rejects callers without create scope on the target collection', async () => {
+        // Key has read scope only.
+        const { key, record } = await makeKey({ collections: ['posts'], actions: ['read'] });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/posts/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt: 'test' }),
+        }));
+        expect(response.status).toBe(403);
+    });
+    it('publishes immediately when publish: true is passed AND caller has admin scope', async () => {
+        // Publish requires admin scope on the API key — under the hood that
+        // maps to role=ADMIN, which clears the publish gate in updateDocument.
+        // A non-admin key that has only create+update will still create the
+        // draft but be denied the publish transition (see the next test).
+        const { key, record } = await makeKey({ admin: true });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/posts/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt: 'test', publish: true }),
+        }));
+        expect(response.status).toBe(201);
+        const body = await response.json();
+        expect(body.data.document.status).toBe('PUBLISHED');
+    });
+    it('falls back to DRAFT + warning when publish requested but update scope is missing', async () => {
+        // create-only key — draft will be created, publish will fail.
+        const { key, record } = await makeKey({ collections: ['posts'], actions: ['create'] });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/posts/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt: 'test', publish: true }),
+        }));
+        expect(response.status).toBe(201);
+        const body = await response.json();
+        expect(body.data.document.status).toBe('DRAFT');
+        expect(body.warning).toMatch(/publish failed/i);
+    });
+    it('honors caller-supplied title and slug overrides', async () => {
+        const { key, record } = await makeKey({ collections: ['posts'], actions: ['create'] });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/posts/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                prompt: 'test',
+                title: 'My Custom Title',
+                slug: 'my-custom-slug',
+            }),
+        }));
+        expect(response.status).toBe(201);
+        const body = await response.json();
+        expect(body.data.document.title).toBe('My Custom Title');
+        expect(body.data.document.slug).toBe('my-custom-slug');
+    });
+    it('returns 400 when prompt exceeds 4000 char limit', async () => {
+        const { key, record } = await makeKey({ collections: ['posts'], actions: ['create'] });
+        const db = createMockDB({ apiKey: record });
+        initDB(db);
+        const handler = handleActuateAPI({
+            prismaClient: db,
+            config: { collections: { posts: postsCollection } },
+        });
+        const response = await handler(new Request('https://example.com/api/cms/collections/posts/ai-create', {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt: 'A'.repeat(5000) }),
+        }));
+        expect(response.status).toBe(400);
+        const body = await response.json();
+        expect(body.error).toContain('exceeds');
+    });
+});
+//# sourceMappingURL=collections-ai-create.test.js.map

package/dist/__tests__/api/collections-ai-create.test.js.map

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

package/dist/__tests__/fields/relations.test.d.ts

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

package/dist/__tests__/fields/relations.test.d.ts.map

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

package/dist/__tests__/fields/relations.test.js

@@ -0,0 +1,243 @@
+import { describe, expect, it } from 'vitest';
+import { collectRelationRefs, parsePopulateParam, populateRelations, validateRelations, } from '../../fields/relations.js';
+// ─── Test fixtures ────────────────────────────────────────────────────────
+function buildLookup(docs) {
+    return {
+        async fetchByIds(collections, ids) {
+            const result = new Map();
+            for (const id of ids) {
+                const doc = docs[id];
+                if (doc && collections.includes(doc.collection)) {
+                    result.set(id, doc);
+                }
+            }
+            return result;
+        },
+    };
+}
+const blogFields = {
+    title: { type: 'text', label: 'Title' },
+    author: { type: 'relationship', label: 'Author', relationTo: 'team' },
+    relatedPosts: {
+        type: 'relationship',
+        label: 'Related posts',
+        relationTo: 'posts',
+        hasMany: true,
+    },
+};
+const arrayFields = {
+    title: { type: 'text', label: 'Title' },
+    sections: {
+        type: 'array',
+        label: 'Sections',
+        fields: {
+            heading: { type: 'text', label: 'Heading' },
+            service: { type: 'relationship', label: 'Service', relationTo: 'services' },
+        },
+    },
+};
+// ─── collectRelationRefs ─────────────────────────────────────────────────
+describe('collectRelationRefs', () => {
+    it('extracts top-level single + many relation ids', () => {
+        const { byCollection, refsByPath } = collectRelationRefs(blogFields, {
+            title: 'Hello',
+            author: 'team-1',
+            relatedPosts: ['post-1', 'post-2'],
+        });
+        expect(byCollection.get('team')).toEqual(new Set(['team-1']));
+        expect(byCollection.get('posts')).toEqual(new Set(['post-1', 'post-2']));
+        expect(refsByPath).toHaveLength(2);
+        expect(refsByPath[0]?.path).toBe('author');
+        expect(refsByPath[1]?.path).toBe('relatedPosts');
+    });
+    it('recurses into array fields', () => {
+        const { byCollection, refsByPath } = collectRelationRefs(arrayFields, {
+            title: 'Page',
+            sections: [
+                { heading: 'A', service: 'svc-1' },
+                { heading: 'B', service: 'svc-2' },
+            ],
+        });
+        expect(byCollection.get('services')).toEqual(new Set(['svc-1', 'svc-2']));
+        expect(refsByPath.map((r) => r.path)).toEqual(['sections[0].service', 'sections[1].service']);
+    });
+    it('ignores empty / null / non-string values', () => {
+        const { byCollection } = collectRelationRefs(blogFields, {
+            title: 'X',
+            author: '',
+            relatedPosts: [null, 'post-1', '', undefined, 123],
+        });
+        expect(byCollection.get('team')).toBeUndefined();
+        expect(byCollection.get('posts')).toEqual(new Set(['post-1']));
+    });
+    it('handles multi-target relationTo arrays', () => {
+        const fields = {
+            featured: {
+                type: 'relationship',
+                label: 'Featured',
+                relationTo: ['posts', 'case-studies'],
+            },
+        };
+        const { byCollection } = collectRelationRefs(fields, { featured: 'doc-1' });
+        expect(byCollection.get('posts')).toEqual(new Set(['doc-1']));
+        expect(byCollection.get('case-studies')).toEqual(new Set(['doc-1']));
+    });
+});
+// ─── validateRelations ───────────────────────────────────────────────────
+describe('validateRelations', () => {
+    it('passes when every id resolves to a live document', async () => {
+        const lookup = buildLookup({
+            'team-1': { id: 'team-1', collection: 'team', title: 'Jane' },
+            'post-1': { id: 'post-1', collection: 'posts', title: 'A' },
+        });
+        await expect(validateRelations(blogFields, { title: 'X', author: 'team-1', relatedPosts: ['post-1'] }, lookup)).resolves.toBeUndefined();
+    });
+    it('throws when a single-ref id is missing, naming the path + collection', async () => {
+        const lookup = buildLookup({});
+        await expect(validateRelations(blogFields, { title: 'X', author: 'ghost' }, lookup)).rejects.toThrow(/Relation field "author" references document "ghost" which does not exist in collection "team"/);
+    });
+    it('throws when ANY id in a hasMany array is missing', async () => {
+        const lookup = buildLookup({
+            'post-1': { id: 'post-1', collection: 'posts' },
+            // post-2 missing
+        });
+        await expect(validateRelations(blogFields, { relatedPosts: ['post-1', 'post-2'] }, lookup)).rejects.toThrow(/post-2.*posts/);
+    });
+    it('treats null / empty values as "not set" (no validation needed)', async () => {
+        const lookup = buildLookup({});
+        await expect(validateRelations(blogFields, { title: 'X', author: '', relatedPosts: [] }, lookup)).resolves.toBeUndefined();
+    });
+    it('accepts a doc when it lives in ANY of the multi-target collections', async () => {
+        const fields = {
+            featured: {
+                type: 'relationship',
+                label: 'Featured',
+                relationTo: ['posts', 'case-studies'],
+            },
+        };
+        const lookup = buildLookup({
+            'cs-1': { id: 'cs-1', collection: 'case-studies', title: 'Big Co' },
+        });
+        await expect(validateRelations(fields, { featured: 'cs-1' }, lookup)).resolves.toBeUndefined();
+    });
+    it('validates relations nested inside array fields', async () => {
+        const lookup = buildLookup({
+            'svc-1': { id: 'svc-1', collection: 'services' },
+        });
+        await expect(validateRelations(arrayFields, {
+            sections: [
+                { heading: 'A', service: 'svc-1' },
+                { heading: 'B', service: 'missing' },
+            ],
+        }, lookup)).rejects.toThrow(/sections\[1\]\.service.*missing.*services/);
+    });
+    it('batches per collection — one fetchByIds call per target collection', async () => {
+        let callCount = 0;
+        let totalIds = 0;
+        const lookup = {
+            async fetchByIds(_cols, ids) {
+                callCount++;
+                totalIds += ids.length;
+                const m = new Map();
+                for (const id of ids)
+                    m.set(id, { id, collection: _cols[0] });
+                return m;
+            },
+        };
+        await validateRelations(blogFields, { author: 'team-1', relatedPosts: ['post-1', 'post-2', 'post-3'] }, lookup);
+        expect(callCount).toBe(2); // team, posts
+        expect(totalIds).toBe(4); // 1 team + 3 posts
+    });
+});
+// ─── populateRelations ───────────────────────────────────────────────────
+describe('populateRelations', () => {
+    const lookup = buildLookup({
+        'team-1': {
+            id: 'team-1',
+            collection: 'team',
+            title: 'Jane',
+            slug: 'jane',
+            status: 'PUBLISHED',
+        },
+        'post-1': {
+            id: 'post-1',
+            collection: 'posts',
+            title: 'Post A',
+            slug: 'a',
+            status: 'PUBLISHED',
+        },
+        'post-2': { id: 'post-2', collection: 'posts', title: 'Post B', slug: 'b', status: 'DRAFT' },
+    });
+    it('expands a single-ref id into a summary object', async () => {
+        const populated = await populateRelations(blogFields, { title: 'X', author: 'team-1' }, lookup, { paths: '*' });
+        expect(populated.title).toBe('X');
+        expect(populated.author.id).toBe('team-1');
+        expect(populated.author.title).toBe('Jane');
+        expect(populated.author.collection).toBe('team');
+    });
+    it('expands a hasMany id array into summary objects in order', async () => {
+        const populated = await populateRelations(blogFields, { title: 'X', relatedPosts: ['post-1', 'post-2'] }, lookup, { paths: '*' });
+        const list = populated.relatedPosts;
+        expect(list).toHaveLength(2);
+        expect(list[0].title).toBe('Post A');
+        expect(list[1].title).toBe('Post B');
+    });
+    it('leaves the original document untouched (returns a clone)', async () => {
+        const input = { title: 'X', author: 'team-1' };
+        const populated = await populateRelations(blogFields, input, lookup, { paths: '*' });
+        expect(input.author).toBe('team-1'); // original id preserved
+        expect(populated.author).not.toBe(input.author);
+    });
+    it('returns input verbatim when populate paths is empty / not provided', async () => {
+        const input = { title: 'X', author: 'team-1' };
+        const populated = await populateRelations(blogFields, input, lookup, {});
+        expect(populated).toEqual(input);
+    });
+    it('only populates the requested top-level paths', async () => {
+        const populated = await populateRelations(blogFields, { title: 'X', author: 'team-1', relatedPosts: ['post-1'] }, lookup, { paths: ['author'] });
+        expect(populated.author.title).toBe('Jane');
+        // relatedPosts not in whitelist → left as raw ids
+        expect(populated.relatedPosts).toEqual(['post-1']);
+    });
+    it('falls back to the raw id when a referenced doc cannot be found', async () => {
+        const populated = await populateRelations(blogFields, { title: 'X', author: 'ghost' }, lookup, {
+            paths: '*',
+        });
+        expect(populated.author).toBe('ghost');
+    });
+    it('populates relations nested in array fields', async () => {
+        const populated = await populateRelations(arrayFields, { title: 'P', sections: [{ heading: 'A', service: 'svc-1' }] }, buildLookup({
+            'svc-1': { id: 'svc-1', collection: 'services', title: 'Cleaning' },
+        }), { paths: '*' });
+        const sec = populated.sections[0];
+        expect(sec.service.title).toBe('Cleaning');
+    });
+});
+// ─── parsePopulateParam ──────────────────────────────────────────────────
+describe('parsePopulateParam', () => {
+    it('returns null for missing / falsy values', () => {
+        expect(parsePopulateParam(null)).toBeNull();
+        expect(parsePopulateParam(undefined)).toBeNull();
+        expect(parsePopulateParam('')).toBeNull();
+        expect(parsePopulateParam('false')).toBeNull();
+        expect(parsePopulateParam('0')).toBeNull();
+    });
+    it('treats * and true as "expand all"', () => {
+        expect(parsePopulateParam('*')).toEqual({ paths: '*' });
+        expect(parsePopulateParam('true')).toEqual({ paths: '*' });
+    });
+    it('parses a comma-separated whitelist', () => {
+        expect(parsePopulateParam('author,relatedPosts')).toEqual({
+            paths: ['author', 'relatedPosts'],
+        });
+    });
+    it('promotes a list that contains * to expand-all', () => {
+        expect(parsePopulateParam('author,*,relatedPosts')).toEqual({ paths: '*' });
+    });
+    it('trims whitespace and drops empty entries', () => {
+        expect(parsePopulateParam('  author , , relatedPosts ')).toEqual({
+            paths: ['author', 'relatedPosts'],
+        });
+    });
+});
+//# sourceMappingURL=relations.test.js.map

package/dist/__tests__/fields/relations.test.js.map

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

package/dist/actions.d.ts

@@ -1,3 +1,4 @@
+import { type RelationLookup } from './fields/relations.js';
 export interface ActionContext {
     userId: string;
     role: string;
@@ -23,6 +24,15 @@ export interface ListResult {
     pageSize: number;
     totalPages: number;
 }
+/**
+ * Build a {@link RelationLookup} backed by the active Prisma client. The
+ * lookup batches by collection and filters out soft-deleted docs so a
+ * relation that points at a tombstoned record is treated as broken.
+ *
+ * Exported so the API layer (resolve, list, get) can reuse it without
+ * pulling in the entire actions module.
+ */
+export declare function buildRelationLookup(db: any): RelationLookup;
 /** Create a new document in a collection. */
 export declare function createDocument(collection: string, data: Record<string, unknown>, ctx: ActionContext): Promise<Record<string, unknown>>;
 /** Update an existing document. Merges incoming data with existing to prevent field loss. */