@dyrected/core 2.6.3 → 2.7.0

package/dist/__tests__/depth.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { createDyrectedApp } from '../app.js';
+import { defineConfig, defineCollection } from '../index.js';
+import { InMemoryAdapter } from './mocks.js';
+describe('depth — relation population', () => {
+    let db;
+    let app;
+    beforeEach(async () => {
+        db = new InMemoryAdapter();
+        // Authors
+        db.seed('authors', [
+            { id: 'author-1', name: 'Alice' },
+            { id: 'author-2', name: 'Bob' },
+        ]);
+        db.seed('comments', [
+            { id: 'comment-1', body: 'First', post: 'post-1' },
+            { id: 'comment-2', body: 'Second', post: 'post-1' },
+        ]);
+        // Posts with author relation stored as a plain ID string
+        db.seed('posts', [
+            { id: 'post-1', title: 'Hello', author: 'author-1', status: 'published' },
+            { id: 'post-2', title: 'World', author: 'author-2', status: 'draft' },
+        ]);
+        const config = defineConfig({
+            collections: [
+                defineCollection({
+                    slug: 'posts',
+                    fields: [
+                        { name: 'title', type: 'text' },
+                        { name: 'status', type: 'text' },
+                        { name: 'author', type: 'relationship', relationTo: 'authors' },
+                    ],
+                }),
+                defineCollection({
+                    slug: 'authors',
+                    fields: [
+                        { name: 'name', type: 'text' },
+                        {
+                            name: 'posts',
+                            type: 'join',
+                            collection: 'posts',
+                            on: 'author',
+                        },
+                    ],
+                }),
+                defineCollection({
+                    slug: 'comments',
+                    fields: [
+                        { name: 'body', type: 'text' },
+                        { name: 'post', type: 'relationship', relationTo: 'posts' },
+                    ],
+                }),
+            ],
+            globals: [],
+            db,
+        });
+        app = await createDyrectedApp(config);
+    });
+    it('depth=0 returns raw relation IDs, not populated objects', async () => {
+        const res = await app.request('/api/collections/posts?depth=0');
+        const data = await res.json();
+        expect(res.status).toBe(200);
+        // author should still be the raw ID string
+        expect(typeof data.docs[0].author).toBe('string');
+        expect(data.docs[0].author).toBe('author-1');
+    });
+    it('depth=1 (default) populates one level of relations', async () => {
+        const res = await app.request('/api/collections/posts');
+        const data = await res.json();
+        expect(res.status).toBe(200);
+        // author should be the populated object
+        expect(typeof data.docs[0].author).toBe('object');
+        expect(data.docs[0].author.name).toBe('Alice');
+    });
+    it('depth=1 explicit — same as default', async () => {
+        const res = await app.request('/api/collections/posts?depth=1');
+        const data = await res.json();
+        expect(data.docs[0].author.name).toBe('Alice');
+    });
+    it('depth=0 on findOne returns raw ID', async () => {
+        const res = await app.request('/api/collections/posts/post-1?depth=0');
+        const doc = await res.json();
+        expect(res.status).toBe(200);
+        expect(typeof doc.author).toBe('string');
+    });
+    it('depth=1 on findOne populates author', async () => {
+        const res = await app.request('/api/collections/posts/post-1?depth=1');
+        const doc = await res.json();
+        expect(res.status).toBe(200);
+        expect(doc.author.name).toBe('Alice');
+    });
+    it('depth + where combined — filtered result is also populated', async () => {
+        const res = await app.request(`/api/collections/posts?depth=1&where=${encodeURIComponent(JSON.stringify({ status: { equals: 'published' } }))}`);
+        const data = await res.json();
+        expect(data.total).toBe(1);
+        expect(data.docs[0].title).toBe('Hello');
+        expect(data.docs[0].author.name).toBe('Alice');
+    });
+    it('populates nested join fields when depth allows it', async () => {
+        const res = await app.request('/api/collections/posts/post-1?depth=2');
+        const doc = await res.json();
+        expect(res.status).toBe(200);
+        expect(doc.author.name).toBe('Alice');
+        expect(doc.author.posts.totalDocs).toBe(1);
+        expect(doc.author.posts.docs[0].id).toBe('post-1');
+    });
+    it('does not populate nested join fields when depth is exhausted', async () => {
+        const res = await app.request('/api/collections/posts/post-1?depth=1');
+        const doc = await res.json();
+        expect(res.status).toBe(200);
+        expect(doc.author.name).toBe('Alice');
+        expect(doc.author.posts).toBeUndefined();
+    });
+});
+//# sourceMappingURL=depth.test.js.map

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

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

package/dist/__tests__/dynamic-options.test.d.ts

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

package/dist/__tests__/dynamic-options.test.d.ts.map

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

package/dist/__tests__/dynamic-options.test.js

@@ -0,0 +1,168 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { createDyrectedApp } from "../app.js";
+import { InMemoryAdapter } from "./mocks.js";
+import { defineCollection, defineConfig } from "../index.js";
+describe("Backend Dynamic Option Queries", () => {
+    let db;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        db = new InMemoryAdapter();
+    });
+    it("should serialize static options as-is and dynamic options to { _dynamic: true }", async () => {
+        const dynamicResolver = () => [{ label: "Dynamic", value: "dyn" }];
+        const posts = defineCollection({
+            slug: "posts",
+            fields: [
+                {
+                    name: "staticSelect",
+                    type: "select",
+                    options: [{ label: "Static", value: "stat" }],
+                },
+                {
+                    name: "dynamicSelect",
+                    type: "select",
+                    options: dynamicResolver,
+                },
+            ],
+        });
+        const config = defineConfig({
+            collections: [posts],
+            globals: [],
+            db,
+        });
+        const app = await createDyrectedApp(config);
+        const res = await app.request("/api/schemas");
+        expect(res.status).toBe(200);
+        const body = await res.json();
+        const fields = body.collections[0].fields;
+        const staticField = fields.find((f) => f.name === "staticSelect");
+        const dynamicField = fields.find((f) => f.name === "dynamicSelect");
+        expect(staticField.options).toEqual([{ label: "Static", value: "stat" }]);
+        expect(dynamicField.options).toEqual({ _dynamic: true });
+    });
+    it("should serialize client-side admin option hooks as strings", async () => {
+        const optionHook = ({ siblingData }) => {
+            if (siblingData.country === "us")
+                return [{ label: "California", value: "CA" }];
+            return [];
+        };
+        const posts = defineCollection({
+            slug: "posts",
+            fields: [
+                {
+                    name: "state",
+                    type: "select",
+                    options: [],
+                    admin: {
+                        hooks: {
+                            options: optionHook,
+                        },
+                    },
+                },
+            ],
+        });
+        const config = defineConfig({
+            collections: [posts],
+            globals: [],
+            db,
+        });
+        const app = await createDyrectedApp(config);
+        const res = await app.request("/api/schemas");
+        expect(res.status).toBe(200);
+        const body = await res.json();
+        const stateField = body.collections[0].fields.find((f) => f.name === "state");
+        expect(stateField.options).toEqual([]);
+        expect(typeof stateField.admin.hooks.options).toBe("string");
+        expect(stateField.admin.hooks.options).toContain("California");
+    });
+    it("should resolve option values from options function or options config object via GET options route", async () => {
+        const posts = defineCollection({
+            slug: "posts",
+            fields: [
+                {
+                    name: "country",
+                    type: "select",
+                    options: async ({ req }) => {
+                        const search = req.query.search || "";
+                        const list = [
+                            { label: "Canada", value: "ca" },
+                            { label: "United States", value: "us" },
+                        ];
+                        return list.filter((item) => item.label.toLowerCase().includes(search.toLowerCase()));
+                    },
+                },
+                {
+                    name: "state",
+                    type: "select",
+                    options: {
+                        resolve: async ({ req }) => {
+                            const country = req.query.country || "us";
+                            if (country === "us") {
+                                return [{ label: "California", value: "CA" }];
+                            }
+                            return [{ label: "Ontario", value: "ON" }];
+                        },
+                    },
+                },
+            ],
+        });
+        const config = defineConfig({
+            collections: [posts],
+            globals: [],
+            db,
+        });
+        const app = await createDyrectedApp(config);
+        // Test search filter on country select
+        const resCountry = await app.request("/api/dyrected/options/posts/country?search=Can");
+        expect(resCountry.status).toBe(200);
+        const countryData = await resCountry.json();
+        expect(countryData).toEqual([{ label: "Canada", value: "ca" }]);
+        // Test dependent lookup on state select for country=ca
+        const resStateCa = await app.request("/api/dyrected/options/posts/state?country=ca");
+        expect(resStateCa.status).toBe(200);
+        const stateDataCa = await resStateCa.json();
+        expect(stateDataCa).toEqual([{ label: "Ontario", value: "ON" }]);
+        // Test default/us lookup on state select
+        const resStateUs = await app.request("/api/dyrected/options/posts/state");
+        expect(resStateUs.status).toBe(200);
+        const stateDataUs = await resStateUs.json();
+        expect(stateDataUs).toEqual([{ label: "California", value: "CA" }]);
+    });
+    it("should cache resolver results for cacheTTL seconds and re-run after expiry", async () => {
+        const resolve = vi.fn(async () => [{ label: "Cached", value: "c" }]);
+        const posts = defineCollection({
+            slug: "posts",
+            fields: [
+                {
+                    name: "cached",
+                    type: "select",
+                    options: { resolve, cacheTTL: 60 },
+                },
+            ],
+        });
+        const config = defineConfig({ collections: [posts], globals: [], db });
+        const app = await createDyrectedApp(config);
+        const now = 1_000_000;
+        const nowSpy = vi.spyOn(Date, "now").mockReturnValue(now);
+        // First call runs the resolver.
+        const r1 = await app.request("/api/dyrected/options/posts/cached?country=ca");
+        expect(await r1.json()).toEqual([{ label: "Cached", value: "c" }]);
+        expect(resolve).toHaveBeenCalledTimes(1);
+        // Same query within the TTL is served from cache — resolver not re-run.
+        nowSpy.mockReturnValue(now + 30_000);
+        const r2 = await app.request("/api/dyrected/options/posts/cached?country=ca");
+        expect(await r2.json()).toEqual([{ label: "Cached", value: "c" }]);
+        expect(resolve).toHaveBeenCalledTimes(1);
+        // A different query is a different cache key — resolver runs again.
+        const r3 = await app.request("/api/dyrected/options/posts/cached?country=us");
+        expect(await r3.json()).toEqual([{ label: "Cached", value: "c" }]);
+        expect(resolve).toHaveBeenCalledTimes(2);
+        // After the TTL elapses, the original query re-runs the resolver.
+        nowSpy.mockReturnValue(now + 61_000);
+        const r4 = await app.request("/api/dyrected/options/posts/cached?country=ca");
+        expect(await r4.json()).toEqual([{ label: "Cached", value: "c" }]);
+        expect(resolve).toHaveBeenCalledTimes(3);
+        nowSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=dynamic-options.test.js.map

package/dist/__tests__/dynamic-options.test.js.map

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

package/dist/__tests__/email.service.test.d.ts

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

package/dist/__tests__/email.service.test.d.ts.map

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

package/dist/__tests__/email.service.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it, vi } from 'vitest';
+import { buildInviteEmail, buildPasswordChangedEmail, buildResetPasswordEmail, buildWelcomeEmail, } from '../services/email.service.js';
+const config = {};
+describe('default email templates', () => {
+    it('uses one branded, table-based, inline-styled shell', () => {
+        const messages = [
+            buildWelcomeEmail(config, { email: 'person@example.com' }),
+            buildInviteEmail(config, { token: 'invite-token' }),
+            buildResetPasswordEmail(config, { token: 'reset-token', url: 'https://example.com/reset' }),
+            buildPasswordChangedEmail(config, { email: 'person@example.com' }),
+        ];
+        for (const { html } of messages) {
+            expect(html).toContain('<!doctype html>');
+            expect(html).toContain('role="presentation"');
+            expect(html).toContain('max-width:600px');
+            expect(html).toContain('Dyrected');
+            expect(html).toContain('Privacy:');
+            expect(html).not.toContain('<style');
+        }
+    });
+    it('escapes all values supplied to default templates', () => {
+        const attack = '<img src=x onerror="alert(1)">&\'';
+        expect(buildWelcomeEmail(config, { email: attack }).html).not.toContain(attack);
+        expect(buildInviteEmail(config, { token: attack, invitedByEmail: attack }).html).not.toContain(attack);
+        expect(buildResetPasswordEmail(config, { token: attack }).html).not.toContain(attack);
+        expect(buildPasswordChangedEmail(config, { email: attack }).html).not.toContain(attack);
+    });
+    it('only renders CTA links with an HTTP(S) URL', () => {
+        const inviteWithUrl = buildInviteEmail(config, { token: 'safe', url: 'https://example.com/invite?a=1&b=2' }).html;
+        expect(inviteWithUrl).toContain('href="https://example.com/invite?a=1&amp;b=2"');
+        expect(inviteWithUrl).not.toContain('Invitation token');
+        expect(inviteWithUrl).not.toContain('safe');
+        expect(buildInviteEmail(config, { token: 'safe', url: 'javascript:alert(1)' }).html)
+            .not.toContain('href=');
+        expect(buildResetPasswordEmail(config, { token: 'safe', url: 'https://example.com/reset?a=1&b=2' }).html)
+            .toContain('href="https://example.com/reset?a=1&amp;b=2"');
+        expect(buildResetPasswordEmail(config, { token: 'safe', url: 'javascript:alert(1)' }).html)
+            .not.toContain('href=');
+    });
+    it('continues to honor trusted custom templates', () => {
+        const customConfig = {
+            email: {
+                from: 'test@example.com',
+                send: vi.fn(),
+                templates: { welcome: () => ({ subject: 'Custom', html: '<p>Custom</p>' }) },
+            },
+        };
+        expect(buildWelcomeEmail(customConfig, { email: 'person@example.com' }))
+            .toEqual({ subject: 'Custom', html: '<p>Custom</p>' });
+    });
+});
+//# sourceMappingURL=email.service.test.js.map

package/dist/__tests__/email.service.test.js.map

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

package/dist/__tests__/field-inference.test-types.d.ts

@@ -0,0 +1,161 @@
+import { type InferDocShape } from '../index.js';
+declare const Posts: {
+    readonly slug: "posts";
+    readonly fields: [{
+        readonly name: "slug";
+        readonly type: "text";
+        readonly required: true;
+        readonly hooks: {
+            readonly beforeChange: [({ value }: import("../index.js").FieldBeforeChangeHookArgs<string, Record<string, unknown>>) => string];
+            readonly afterRead: [({ value }: import("../index.js").FieldAfterReadHookArgs<string, Record<string, unknown>>) => string];
+        };
+    }, {
+        readonly name: "views";
+        readonly type: "number";
+        readonly hooks: {
+            readonly beforeChange: [({ value }: import("../index.js").FieldBeforeChangeHookArgs<number, Record<string, unknown>>) => number];
+        };
+    }, {
+        readonly name: "active";
+        readonly type: "boolean";
+        readonly hooks: {
+            readonly afterRead: [({ value }: import("../index.js").FieldAfterReadHookArgs<boolean, Record<string, unknown>>) => boolean];
+        };
+    }, {
+        readonly name: "tags";
+        readonly type: "multiSelect";
+        readonly hooks: {
+            readonly beforeChange: [({ value }: import("../index.js").FieldBeforeChangeHookArgs<string[], Record<string, unknown>>) => string[]];
+        };
+    }];
+    readonly hooks: {
+        readonly beforeChange: [({ data }: {
+            data: Partial<import("../index.js").Prettify<{
+                id: string;
+            } & Record<string, unknown> & import("../index.js").SystemDocFields>>;
+            doc?: import("../index.js").Prettify<{
+                id: string;
+            } & Record<string, unknown> & import("../index.js").SystemDocFields> | undefined;
+            req: import("../index.js").HookRequestContext;
+            user?: import("../index.js").AuthenticatedUser;
+            operation: "create" | "update";
+            db: import("../index.js").ReadonlyDatabaseAdapter;
+        }) => Partial<import("../index.js").Prettify<{
+            id: string;
+        } & Record<string, unknown> & import("../index.js").SystemDocFields>>];
+        readonly afterChange: [({ doc }: {
+            doc: import("../index.js").Prettify<{
+                id: string;
+            } & Record<string, unknown> & import("../index.js").SystemDocFields>;
+            previousDoc?: import("../index.js").Prettify<{
+                id: string;
+            } & Record<string, unknown> & import("../index.js").SystemDocFields> | undefined;
+            req: import("../index.js").HookRequestContext;
+            user?: import("../index.js").AuthenticatedUser;
+            operation: "create" | "update";
+            db: import("../index.js").DatabaseAdapter;
+        }) => void];
+    };
+};
+declare const Posts2: Omit<import("../index.js").CollectionConfig<import("../index.js").Prettify<{
+    id: string;
+} & InferDocShape<TFields> & import("../index.js").SystemDocFields & import("../index.js").AuthDocFields>>, "admin" | "fields" | "auth"> & {
+    slug: TSlug;
+    fields: TFields;
+    auth: true | import("../index.js").AuthConfig;
+    admin?: Omit<{
+        icon?: import("../index.js").AdminIconName;
+        components?: import("../index.js").CollectionListComponentSlots;
+        useAsTitle?: string;
+        defaultColumns?: string[];
+        description?: string;
+        searchableFields?: string[];
+        group?: string;
+        hidden?: boolean;
+        filterable?: boolean;
+        autosave?: boolean;
+        autosaveDelayMs?: number;
+        previewUrl?: string | ((doc: import("../index.js").Prettify<{
+            id: string;
+        } & InferDocShape<TFields> & import("../index.js").SystemDocFields & import("../index.js").AuthDocFields>, opts: {
+            locale?: string;
+        }) => string | null) | undefined;
+        previewMode?: "postMessage" | "token";
+        urlPattern?: string;
+    }, "searchableFields" | "useAsTitle" | "defaultColumns"> & {
+        useAsTitle?: ((NonNullable<TAdmin> extends infer T ? T extends NonNullable<TAdmin> ? T extends {
+            useAsTitle?: infer V | undefined;
+        } ? V : never : never : never) extends infer T_1 ? T_1 extends (NonNullable<TAdmin> extends infer T_2 ? T_2 extends NonNullable<TAdmin> ? T_2 extends {
+            useAsTitle?: infer V | undefined;
+        } ? V : never : never : never) ? T_1 extends undefined ? undefined : T_1 extends Extract<TFields[number], {
+            name: string;
+        }>["name"] ? T_1 : {
+            __dyrected_error__: "Invalid field name";
+            __dyrected_received__: T_1;
+            __dyrected_expected__: Extract<TFields[number], {
+                name: string;
+            }>["name"];
+        } : never : never) | undefined;
+        defaultColumns?: ((NonNullable<TAdmin> extends infer T_3 ? T_3 extends NonNullable<TAdmin> ? T_3 extends {
+            defaultColumns?: infer V | undefined;
+        } ? V : never : never : never) extends infer T_4 ? T_4 extends (NonNullable<TAdmin> extends infer T_5 ? T_5 extends NonNullable<TAdmin> ? T_5 extends {
+            defaultColumns?: infer V | undefined;
+        } ? V : never : never : never) ? T_4 extends readonly unknown[] ? { [K in keyof T_4]: T_4[K] extends infer T_5 ? T_5 extends T_4[K] ? T_5 extends undefined ? undefined : T_5 extends Extract<TFields[number], {
+            name: string;
+        }>["name"] ? T_5 : {
+            __dyrected_error__: "Invalid field name";
+            __dyrected_received__: T_5;
+            __dyrected_expected__: Extract<TFields[number], {
+                name: string;
+            }>["name"];
+        } : never : never; } : {
+            __dyrected_error__: "Invalid field name list";
+            __dyrected_received__: T_4;
+            __dyrected_expected__: Extract<TFields[number], {
+                name: string;
+            }>["name"];
+        } : never : never) | undefined;
+        searchableFields?: ((NonNullable<TAdmin> extends infer T_6 ? T_6 extends NonNullable<TAdmin> ? T_6 extends {
+            searchableFields?: infer V | undefined;
+        } ? V : never : never : never) extends infer T_7 ? T_7 extends (NonNullable<TAdmin> extends infer T_8 ? T_8 extends NonNullable<TAdmin> ? T_8 extends {
+            searchableFields?: infer V | undefined;
+        } ? V : never : never : never) ? T_7 extends readonly unknown[] ? { [K_1 in keyof T_7]: T_7[K_1] extends infer T_8 ? T_8 extends T_7[K_1] ? T_8 extends undefined ? undefined : T_8 extends Extract<TFields[number], {
+            name: string;
+        }>["name"] ? T_8 : {
+            __dyrected_error__: "Invalid field name";
+            __dyrected_received__: T_8;
+            __dyrected_expected__: Extract<TFields[number], {
+                name: string;
+            }>["name"];
+        } : never : never; } : {
+            __dyrected_error__: "Invalid field name list";
+            __dyrected_received__: T_7;
+            __dyrected_expected__: Extract<TFields[number], {
+                name: string;
+            }>["name"];
+        } : never : never) | undefined;
+    };
+};
+declare const Settings: {
+    readonly slug: "settings";
+    readonly fields: [{
+        readonly name: "siteName";
+        readonly type: "text";
+        readonly required: true;
+    }, {
+        readonly name: "maintenance";
+        readonly type: "boolean";
+    }];
+    readonly hooks: {
+        readonly afterChange: [({ doc }: {
+            doc: import("../index.js").Prettify<Record<string, unknown>>;
+            previousDoc?: import("../index.js").Prettify<Record<string, unknown>> | undefined;
+            req: import("../index.js").HookRequestContext;
+            user?: import("../index.js").AuthenticatedUser;
+            operation: "update";
+            db: import("../index.js").DatabaseAdapter;
+        }) => void];
+    };
+};
+export { Posts, Posts2, Settings };
+//# sourceMappingURL=field-inference.test-types.d.ts.map

package/dist/__tests__/field-inference.test-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-inference.test-types.d.ts","sourceRoot":"","sources":["../../src/__tests__/field-inference.test-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,aAAa,EAAc,MAAM,aAAa,CAAA;AAG5F,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CT,CAAA;AAIF,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;kBAqCw2V,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA3Bn3V,CAAA;AAGF,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;CAaZ,CAAA;AAUF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA"}

package/dist/__tests__/field-inference.test-types.js

@@ -0,0 +1,87 @@
+import { defineCollection, defineGlobal } from '../index.js';
+// Test 1: field hook `value` is typed per field type — no annotations needed
+const Posts = defineCollection({
+    slug: 'posts',
+    fields: [
+        {
+            name: 'slug',
+            type: 'text',
+            required: true,
+            hooks: {
+                beforeChange: [({ value }) => value.toLowerCase()], // value: string ✓
+                afterRead: [({ value }) => value.trim()], // value: string ✓
+            },
+        },
+        {
+            name: 'views',
+            type: 'number',
+            hooks: {
+                beforeChange: [({ value }) => Math.max(0, value)], // value: number ✓
+            },
+        },
+        {
+            name: 'active',
+            type: 'boolean',
+            hooks: {
+                afterRead: [({ value }) => value ?? false], // value: boolean ✓
+            },
+        },
+        {
+            name: 'tags',
+            type: 'multiSelect',
+            hooks: {
+                beforeChange: [({ value }) => value.map(t => t.toUpperCase())], // value: string[] ✓
+            },
+        },
+    ],
+    hooks: {
+        beforeChange: [({ data }) => {
+                const _slug = data.slug; // doc shape inferred from fields ✓
+                const _views = data.views;
+                void _slug;
+                void _views;
+                return data;
+            }],
+        afterChange: [({ doc }) => {
+                const _id = doc.id; // id added automatically for collections ✓
+                const _slug = doc.slug;
+                void _id;
+                void _slug;
+            }],
+    },
+});
+const Posts2 = defineCollection({
+    slug: 'posts2',
+    fields: [{ name: 'title', type: 'text' }],
+    hooks: {
+        beforeChange: [({ data }) => {
+                const _status = data.status;
+                void _status;
+                return data;
+            }],
+    },
+});
+// Test 3: global — inferred, no id
+const Settings = defineGlobal({
+    slug: 'settings',
+    fields: [
+        { name: 'siteName', type: 'text', required: true },
+        { name: 'maintenance', type: 'boolean' },
+    ],
+    hooks: {
+        afterChange: [({ doc }) => {
+                const _name = doc.siteName; // required → string ✓
+                const _maint = doc.maintenance; // optional → boolean | undefined ✓
+                void _name;
+                void _maint;
+            }],
+    },
+});
+// Test 4: InferDocShape utility
+const fields = [
+    { name: 'title', type: 'text', required: true },
+    { name: 'tags', type: 'multiSelect' },
+];
+// → { title: string; tags?: string[] }
+export { Posts, Posts2, Settings };
+//# sourceMappingURL=field-inference.test-types.js.map

package/dist/__tests__/field-inference.test-types.js.map

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