@ekrist1/vulse 0.1.6-alpha.3

package/dist/core/repos/entries.d.ts.map

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

package/dist/core/repos/entries.js

@@ -0,0 +1,393 @@
+import { and, asc, desc, eq, gte, isNull, lte, sql } from 'drizzle-orm';
+import { nanoid } from 'nanoid';
+import { entries, entryLocales, entryRevisions } from '../schema.js';
+import { NotFoundError, ValidationError } from '../errors.js';
+import { isValidSlug, normalizeSlug } from '../slug.js';
+export const DEFAULT_LOCALE = 'default';
+function joinToEntry(shell, locale) {
+    return {
+        id: shell.id,
+        collection: shell.collection,
+        parentId: shell.parentId ?? null,
+        sortOrder: shell.sortOrder,
+        slug: locale.slug,
+        status: locale.status,
+        locale: locale.locale,
+        version: locale.version,
+        content: locale.content,
+        draftContent: locale.draftContent ?? null,
+        hasUnpublishedChanges: locale.draftContent != null,
+        publishedAt: locale.publishedAt,
+        createdAt: shell.createdAt,
+        updatedAt: locale.updatedAt,
+        createdBy: shell.createdBy,
+        updatedBy: locale.updatedBy,
+    };
+}
+export class EntriesRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async resolveUniqueSlug(collection, locale, desired, excludeEntryId) {
+        const base = normalizeSlug(desired);
+        if (!base || !isValidSlug(base)) {
+            throw new ValidationError('URL slug must use lowercase letters, numbers, and hyphens only.', {
+                field: 'slug',
+                issues: [{ path: ['slug'], message: 'Use lowercase letters, numbers, and hyphens only.' }],
+            });
+        }
+        let suffix = 1;
+        for (;;) {
+            const candidate = suffix === 1 ? base : `${base}-${suffix}`;
+            const [existing] = await this.db.select({ entryId: entryLocales.entryId })
+                .from(entryLocales)
+                .where(and(eq(entryLocales.collection, collection), eq(entryLocales.locale, locale), eq(entryLocales.slug, candidate)))
+                .limit(1);
+            if (!existing || existing.entryId === excludeEntryId)
+                return candidate;
+            suffix++;
+        }
+    }
+    isSlugUniqueViolation(err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return message.includes('UNIQUE constraint failed') && message.includes('slug');
+    }
+    async maxSortOrder(collection, parentId) {
+        const conds = [eq(entries.collection, collection)];
+        conds.push(parentId ? eq(entries.parentId, parentId) : isNull(entries.parentId));
+        const [row] = await this.db.select({ max: sql `coalesce(max(${entries.sortOrder}), 0)` })
+            .from(entries)
+            .where(and(...conds));
+        return row?.max ?? 0;
+    }
+    /** True if the proposed parent would create a cycle (parent is a descendant of id). */
+    async wouldCreateCycle(id, proposedParentId) {
+        if (proposedParentId === null)
+            return false;
+        if (proposedParentId === id)
+            return true;
+        // Walk parent chain upward from proposedParentId; if we hit `id`, it's a cycle.
+        const seen = new Set();
+        let current = proposedParentId;
+        while (current) {
+            if (seen.has(current))
+                return false; // pre-existing cycle, but not caused by this move
+            seen.add(current);
+            if (current === id)
+                return true;
+            const [row] = await this.db.select({ parentId: entries.parentId })
+                .from(entries).where(eq(entries.id, current)).limit(1);
+            current = row?.parentId ?? null;
+        }
+        return false;
+    }
+    async create(input) {
+        const locale = input.locale ?? DEFAULT_LOCALE;
+        const slug = await this.resolveUniqueSlug(input.collection, locale, input.slug);
+        const now = new Date();
+        const sortOrder = (await this.maxSortOrder(input.collection, input.parentId ?? null)) + 1;
+        const publishNow = !input.draftsEnabled && (input.status ?? 'draft') === 'published';
+        const entryId = nanoid();
+        const shellRow = {
+            id: entryId,
+            collection: input.collection,
+            parentId: input.parentId ?? null,
+            sortOrder,
+            createdAt: now,
+            updatedAt: now,
+            createdBy: input.createdBy,
+        };
+        const localeRow = {
+            entryId,
+            collection: input.collection,
+            locale,
+            slug,
+            status: publishNow ? 'published' : (input.status ?? 'draft'),
+            version: 1,
+            content: input.draftsEnabled && !publishNow ? {} : input.content,
+            draftContent: input.draftsEnabled && !publishNow ? input.content : null,
+            publishedAt: publishNow ? now : null,
+            updatedAt: now,
+            updatedBy: input.createdBy,
+        };
+        const insertStmts = () => [
+            this.db.insert(entries).values(shellRow),
+            this.db.insert(entryLocales).values(localeRow),
+            this.db.insert(entryRevisions).values({
+                id: nanoid(),
+                entryId,
+                locale,
+                version: 1,
+                content: input.content,
+                authorId: input.createdBy,
+                changeSummary: null,
+                createdAt: now,
+            }),
+        ];
+        try {
+            const [a, b, c] = insertStmts();
+            await this.db.batch([a, b, c]);
+        }
+        catch (err) {
+            if (!this.isSlugUniqueViolation(err))
+                throw err;
+            localeRow.slug = await this.resolveUniqueSlug(input.collection, locale, slug);
+            const [a, b, c] = insertStmts();
+            await this.db.batch([a, b, c]);
+        }
+        return joinToEntry(shellRow, localeRow);
+    }
+    /** Add a new locale translation to an existing entry. */
+    async createLocale(entryId, input) {
+        const shell = await this.findShellById(entryId);
+        if (!shell)
+            throw new NotFoundError(`Entry ${entryId} not found`);
+        const slug = await this.resolveUniqueSlug(shell.collection, input.locale, input.slug);
+        const now = new Date();
+        const publishNow = !input.draftsEnabled && (input.status ?? 'draft') === 'published';
+        const localeRow = {
+            entryId,
+            collection: shell.collection,
+            locale: input.locale,
+            slug,
+            status: publishNow ? 'published' : (input.status ?? 'draft'),
+            version: 1,
+            content: input.draftsEnabled && !publishNow ? {} : input.content,
+            draftContent: input.draftsEnabled && !publishNow ? input.content : null,
+            publishedAt: publishNow ? now : null,
+            updatedAt: now,
+            updatedBy: input.updatedBy,
+        };
+        await this.db.batch([
+            this.db.insert(entryLocales).values(localeRow),
+            this.db.insert(entryRevisions).values({
+                id: nanoid(),
+                entryId,
+                locale: input.locale,
+                version: 1,
+                content: input.content,
+                authorId: input.updatedBy,
+                changeSummary: null,
+                createdAt: now,
+            }),
+            this.db.update(entries).set({ updatedAt: now }).where(eq(entries.id, entryId)),
+        ]);
+        return joinToEntry({ ...shell, updatedAt: now }, localeRow);
+    }
+    async findShellById(id) {
+        const [row] = await this.db.select().from(entries).where(eq(entries.id, id)).limit(1);
+        return row ?? null;
+    }
+    async findById(id, locale = DEFAULT_LOCALE) {
+        const [shell] = await this.db.select().from(entries).where(eq(entries.id, id)).limit(1);
+        if (!shell)
+            return null;
+        const [loc] = await this.db.select().from(entryLocales)
+            .where(and(eq(entryLocales.entryId, id), eq(entryLocales.locale, locale)))
+            .limit(1);
+        if (!loc)
+            return null;
+        return joinToEntry(shell, loc);
+    }
+    /** Returns every locale row for an entry — used by the admin to render the locale picker. */
+    async listLocales(id) {
+        const rows = await this.db.select({
+            locale: entryLocales.locale,
+            slug: entryLocales.slug,
+            status: entryLocales.status,
+            draftContent: entryLocales.draftContent,
+            publishedAt: entryLocales.publishedAt,
+            updatedAt: entryLocales.updatedAt,
+        }).from(entryLocales).where(eq(entryLocales.entryId, id));
+        return rows.map((r) => ({
+            locale: r.locale,
+            slug: r.slug,
+            status: r.status,
+            hasUnpublishedChanges: r.draftContent != null,
+            publishedAt: r.publishedAt,
+            updatedAt: r.updatedAt,
+        }));
+    }
+    async findBySlug(collection, slug, locale = DEFAULT_LOCALE) {
+        const [loc] = await this.db.select().from(entryLocales).where(and(eq(entryLocales.collection, collection), eq(entryLocales.slug, slug), eq(entryLocales.locale, locale))).limit(1);
+        if (!loc)
+            return null;
+        const [shell] = await this.db.select().from(entries).where(eq(entries.id, loc.entryId)).limit(1);
+        if (!shell)
+            return null;
+        return joinToEntry(shell, loc);
+    }
+    async list(opts) {
+        const locale = opts.locale ?? DEFAULT_LOCALE;
+        const conditions = [
+            eq(entries.collection, opts.collection),
+            eq(entryLocales.locale, locale),
+        ];
+        if (opts.status)
+            conditions.push(eq(entryLocales.status, opts.status));
+        if (opts.parentId !== undefined) {
+            conditions.push(opts.parentId === null ? isNull(entries.parentId) : eq(entries.parentId, opts.parentId));
+        }
+        if (opts.createdBy)
+            conditions.push(eq(entries.createdBy, opts.createdBy));
+        if (opts.publishedAfter)
+            conditions.push(gte(entryLocales.publishedAt, opts.publishedAfter));
+        if (opts.publishedBefore)
+            conditions.push(lte(entryLocales.publishedAt, opts.publishedBefore));
+        const direction = opts.order === 'asc' ? asc : desc;
+        const order = opts.orderBy === 'publishedAt' ? [direction(entryLocales.publishedAt)]
+            : opts.orderBy === 'createdAt' ? [direction(entries.createdAt)]
+                : opts.orderBy === 'updatedAt' ? [direction(entryLocales.updatedAt)]
+                    : [asc(entries.sortOrder), desc(entryLocales.updatedAt)];
+        const base = this.db.select({ shell: entries, loc: entryLocales })
+            .from(entries)
+            .innerJoin(entryLocales, eq(entryLocales.entryId, entries.id))
+            .where(and(...conditions))
+            .orderBy(...order);
+        const limited = opts.limit !== undefined ? base.limit(opts.limit) : base;
+        const paged = opts.offset !== undefined ? limited.offset(opts.offset) : limited;
+        const rows = await paged;
+        return rows.map((r) => joinToEntry(r.shell, r.loc));
+    }
+    async tree(collection, locale = DEFAULT_LOCALE) {
+        const rows = await this.db.select({ shell: entries, loc: entryLocales })
+            .from(entries)
+            .innerJoin(entryLocales, eq(entryLocales.entryId, entries.id))
+            .where(and(eq(entries.collection, collection), eq(entryLocales.locale, locale)))
+            .orderBy(asc(entries.sortOrder), desc(entryLocales.updatedAt));
+        const byParent = new Map();
+        for (const r of rows) {
+            const node = { ...joinToEntry(r.shell, r.loc), children: [] };
+            const bucket = byParent.get(node.parentId) ?? [];
+            bucket.push(node);
+            byParent.set(node.parentId, bucket);
+        }
+        function attach(parentId) {
+            const children = byParent.get(parentId) ?? [];
+            for (const child of children)
+                child.children = attach(child.id);
+            return children;
+        }
+        return attach(null);
+    }
+    async move(collection, id, input) {
+        const shell = await this.findShellById(id);
+        if (!shell || shell.collection !== collection)
+            throw new NotFoundError(`Entry ${id} not found`);
+        if (await this.wouldCreateCycle(id, input.parentId)) {
+            throw new ValidationError('An entry cannot be moved under itself or one of its descendants.');
+        }
+        const sortOrder = input.sortOrder ?? (await this.maxSortOrder(collection, input.parentId)) + 1;
+        const now = new Date();
+        await this.db.update(entries).set({
+            parentId: input.parentId,
+            sortOrder,
+            updatedAt: now,
+        }).where(eq(entries.id, id));
+        const next = await this.findShellById(id);
+        if (!next)
+            throw new NotFoundError(`Entry ${id} not found`);
+        return next;
+    }
+    async updateWithRevision(id, patch) {
+        const locale = patch.locale ?? DEFAULT_LOCALE;
+        const existing = await this.findById(id, locale);
+        if (!existing)
+            throw new NotFoundError(`Entry ${id} (${locale}) not found`);
+        let nextSlug = existing.slug;
+        if (patch.slug !== undefined && patch.slug !== existing.slug) {
+            nextSlug = await this.resolveUniqueSlug(existing.collection, locale, patch.slug, id);
+        }
+        const now = new Date();
+        const nextVersion = existing.version + 1;
+        const workingContent = patch.content ?? (patch.draftsEnabled && existing.draftContent != null ? existing.draftContent : existing.content);
+        const localeWhere = and(eq(entryLocales.entryId, id), eq(entryLocales.locale, locale));
+        if (patch.draftsEnabled) {
+            const publishNow = patch.publish === true;
+            const next = publishNow
+                ? {
+                    content: workingContent,
+                    draftContent: null,
+                    status: 'published',
+                    publishedAt: existing.publishedAt ?? now,
+                    slug: nextSlug,
+                    version: nextVersion,
+                    updatedAt: now,
+                    updatedBy: patch.updatedBy,
+                }
+                : {
+                    content: existing.content,
+                    draftContent: workingContent,
+                    status: existing.status,
+                    publishedAt: existing.publishedAt,
+                    slug: nextSlug,
+                    version: nextVersion,
+                    updatedAt: now,
+                    updatedBy: patch.updatedBy,
+                };
+            await this.db.batch([
+                this.db.insert(entryRevisions).values({
+                    id: nanoid(), entryId: id, locale, version: nextVersion, content: workingContent,
+                    authorId: patch.updatedBy, changeSummary: patch.changeSummary ?? null, createdAt: now,
+                }),
+                this.db.update(entryLocales).set(next).where(localeWhere),
+                this.db.update(entries).set({ updatedAt: now }).where(eq(entries.id, id)),
+            ]);
+            return {
+                ...existing,
+                slug: next.slug,
+                status: next.status,
+                version: next.version,
+                content: next.content,
+                draftContent: next.draftContent ?? null,
+                hasUnpublishedChanges: next.draftContent != null,
+                publishedAt: next.publishedAt,
+                updatedAt: next.updatedAt,
+                updatedBy: next.updatedBy,
+            };
+        }
+        const nextContent = patch.content ?? existing.content;
+        const nextStatus = patch.status ?? existing.status;
+        const nextPublishedAt = nextStatus === 'published' && !existing.publishedAt ? now : existing.publishedAt;
+        await this.db.batch([
+            this.db.insert(entryRevisions).values({
+                id: nanoid(), entryId: id, locale, version: nextVersion, content: nextContent,
+                authorId: patch.updatedBy, changeSummary: patch.changeSummary ?? null, createdAt: now,
+            }),
+            this.db.update(entryLocales).set({
+                content: nextContent,
+                slug: nextSlug,
+                status: nextStatus,
+                version: nextVersion,
+                publishedAt: nextPublishedAt,
+                updatedAt: now,
+                updatedBy: patch.updatedBy,
+            }).where(localeWhere),
+            this.db.update(entries).set({ updatedAt: now }).where(eq(entries.id, id)),
+        ]);
+        return {
+            ...existing,
+            content: nextContent,
+            slug: nextSlug,
+            status: nextStatus,
+            version: nextVersion,
+            publishedAt: nextPublishedAt,
+            updatedAt: now,
+            updatedBy: patch.updatedBy,
+            hasUnpublishedChanges: false,
+        };
+    }
+    async publish(id, updatedBy, locale = DEFAULT_LOCALE) {
+        return this.updateWithRevision(id, { publish: true, draftsEnabled: true, updatedBy, locale });
+    }
+    async delete(id) {
+        await this.db.delete(entries).where(eq(entries.id, id));
+    }
+    /** Delete only one locale of an entry; the entry shell remains if other locales exist. */
+    async deleteLocale(id, locale) {
+        await this.db.delete(entryLocales).where(and(eq(entryLocales.entryId, id), eq(entryLocales.locale, locale)));
+        // Also remove revisions for that locale; entries cascade is broader than we want here.
+        await this.db.delete(entryRevisions).where(and(eq(entryRevisions.entryId, id), eq(entryRevisions.locale, locale)));
+    }
+}

package/dist/core/repos/forms.d.ts

@@ -0,0 +1,82 @@
+import type { VulseDb } from '../db.js';
+import { type FormDefinition } from '../forms/definition.js';
+export interface FormRow {
+    handle: string;
+    label: string;
+    definition: FormDefinition;
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    submissionCount?: number;
+}
+export declare class FormsRepo {
+    private db;
+    constructor(db: VulseDb);
+    create(input: FormDefinition): Promise<FormRow>;
+    findByHandle(handle: string): Promise<FormRow | null>;
+    list(): Promise<FormRow[]>;
+    update(handle: string, input: FormDefinition): Promise<FormRow>;
+    delete(handle: string): Promise<void>;
+}
+export interface SubmissionMeta {
+    ip?: string;
+    userAgent?: string;
+    referer?: string;
+    locale?: string;
+}
+export interface FileRef {
+    field: string;
+    mediaId: string;
+}
+export interface SubmissionRow {
+    id: string;
+    formHandle: string;
+    payload: Record<string, unknown>;
+    fileRefs: FileRef[];
+    meta: SubmissionMeta;
+    status: 'received' | 'processed' | 'failed';
+    error: string | null;
+    createdAt: Date;
+}
+export declare class SubmissionsRepo {
+    private db;
+    constructor(db: VulseDb);
+    create(input: {
+        formHandle: string;
+        payload: Record<string, unknown>;
+        fileRefs?: FileRef[];
+        meta: SubmissionMeta;
+    }): Promise<SubmissionRow>;
+    findById(id: string): Promise<SubmissionRow | null>;
+    list(opts: {
+        formHandle: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<SubmissionRow[]>;
+    delete(id: string): Promise<void>;
+    deleteMany(ids: string[]): Promise<number>;
+    updateStatus(id: string, status: 'processed' | 'failed', error?: string | null): Promise<void>;
+}
+export interface UploadDraftRow {
+    id: string;
+    formHandle: string;
+    fieldName: string;
+    mediaId: string;
+    expiresAt: Date;
+    createdAt: Date;
+}
+export declare class FormUploadDraftsRepo {
+    private db;
+    constructor(db: VulseDb);
+    create(input: {
+        formHandle: string;
+        fieldName: string;
+        mediaId: string;
+        expiresAt: Date;
+    }): Promise<UploadDraftRow>;
+    findValid(formHandle: string, fieldName: string, mediaId: string): Promise<UploadDraftRow | null>;
+    delete(id: string): Promise<void>;
+    listExpired(before: Date): Promise<UploadDraftRow[]>;
+    attachToSubmission(draftId: string): Promise<void>;
+}
+//# sourceMappingURL=forms.d.ts.map

package/dist/core/repos/forms.d.ts.map

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

package/dist/core/repos/forms.js

@@ -0,0 +1,199 @@
+import { eq, and, gt, lt, sql, desc } from 'drizzle-orm';
+import { nanoid } from 'nanoid';
+import { vulseForms, vulseFormSubmissions, vulseFormUniqueValues, vulseFormUploadDrafts, } from '../schema.js';
+import { NotFoundError, ValidationError } from '../errors.js';
+import { FormDefinitionSchema, } from '../forms/definition.js';
+function parseRow(row) {
+    return {
+        handle: row.handle,
+        label: row.label,
+        definition: FormDefinitionSchema.parse(row.definition),
+        enabled: row.enabled,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+export class FormsRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async create(input) {
+        const parsed = FormDefinitionSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ValidationError('Invalid form', { issues: parsed.error.issues });
+        const def = parsed.data;
+        const now = new Date();
+        await this.db.insert(vulseForms).values({
+            handle: def.handle,
+            label: def.label,
+            definition: def,
+            enabled: def.settings.enabled,
+            createdAt: now,
+            updatedAt: now,
+        });
+        const row = await this.findByHandle(def.handle);
+        if (!row)
+            throw new Error(`form not found after create: ${def.handle}`);
+        return row;
+    }
+    async findByHandle(handle) {
+        const row = await this.db.select().from(vulseForms).where(eq(vulseForms.handle, handle)).get();
+        return row ? parseRow(row) : null;
+    }
+    async list() {
+        const rows = await this.db
+            .select({
+            handle: vulseForms.handle,
+            label: vulseForms.label,
+            definition: vulseForms.definition,
+            enabled: vulseForms.enabled,
+            createdAt: vulseForms.createdAt,
+            updatedAt: vulseForms.updatedAt,
+            submissionCount: sql `(
+          SELECT COUNT(*) FROM vulse_form_submissions
+          WHERE form_handle = ${vulseForms.handle}
+        )`.mapWith(Number),
+        })
+            .from(vulseForms)
+            .orderBy(vulseForms.createdAt);
+        return rows.map((r) => ({
+            ...parseRow({
+                ...r,
+                // The list query intentionally omits schemaVersion; supply the default
+                // so parseRow's type-cast remains accurate without an over-broad `as`.
+                schemaVersion: 1,
+            }),
+            submissionCount: r.submissionCount,
+        }));
+    }
+    async update(handle, input) {
+        if (input.handle !== handle) {
+            throw new Error(`form handle is immutable (got '${input.handle}', expected '${handle}')`);
+        }
+        const parsed = FormDefinitionSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ValidationError('Invalid form', { issues: parsed.error.issues });
+        const def = parsed.data;
+        await this.db.update(vulseForms).set({
+            label: def.label,
+            definition: def,
+            enabled: def.settings.enabled,
+            updatedAt: new Date(),
+        }).where(eq(vulseForms.handle, handle));
+        const row = await this.findByHandle(handle);
+        if (!row)
+            throw new NotFoundError('form not found');
+        return row;
+    }
+    async delete(handle) {
+        await this.db.delete(vulseForms).where(eq(vulseForms.handle, handle));
+    }
+}
+function parseSubmission(row) {
+    return {
+        id: row.id,
+        formHandle: row.formHandle,
+        payload: row.payload,
+        fileRefs: (row.fileRefs ?? []),
+        meta: row.meta,
+        status: row.status,
+        error: row.error ?? null,
+        createdAt: row.createdAt,
+    };
+}
+export class SubmissionsRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async create(input) {
+        const now = new Date();
+        const row = {
+            id: nanoid(),
+            formHandle: input.formHandle,
+            payload: input.payload,
+            fileRefs: input.fileRefs ?? [],
+            meta: input.meta,
+            status: 'received',
+            error: null,
+            createdAt: now,
+        };
+        await this.db.insert(vulseFormSubmissions).values(row);
+        return parseSubmission(row);
+    }
+    async findById(id) {
+        const row = await this.db.select().from(vulseFormSubmissions).where(eq(vulseFormSubmissions.id, id)).get();
+        return row ? parseSubmission(row) : null;
+    }
+    async list(opts) {
+        let query = this.db.select().from(vulseFormSubmissions)
+            .where(eq(vulseFormSubmissions.formHandle, opts.formHandle))
+            .orderBy(desc(vulseFormSubmissions.createdAt));
+        if (opts.limit !== undefined)
+            query = query.limit(opts.limit);
+        if (opts.offset !== undefined)
+            query = query.offset(opts.offset);
+        const rows = await query;
+        return rows.map(parseSubmission);
+    }
+    async delete(id) {
+        await this.db.delete(vulseFormUniqueValues).where(eq(vulseFormUniqueValues.submissionId, id));
+        await this.db.delete(vulseFormSubmissions).where(eq(vulseFormSubmissions.id, id));
+    }
+    async deleteMany(ids) {
+        if (ids.length === 0)
+            return 0;
+        for (const id of ids) {
+            await this.db.delete(vulseFormUniqueValues).where(eq(vulseFormUniqueValues.submissionId, id));
+        }
+        let deleted = 0;
+        for (const id of ids) {
+            await this.db.delete(vulseFormSubmissions).where(eq(vulseFormSubmissions.id, id));
+            deleted++;
+        }
+        return deleted;
+    }
+    async updateStatus(id, status, error) {
+        await this.db.update(vulseFormSubmissions).set({
+            status,
+            error: error ?? null,
+        }).where(eq(vulseFormSubmissions.id, id));
+    }
+}
+export class FormUploadDraftsRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async create(input) {
+        const now = new Date();
+        const row = {
+            id: nanoid(),
+            formHandle: input.formHandle,
+            fieldName: input.fieldName,
+            mediaId: input.mediaId,
+            expiresAt: input.expiresAt,
+            createdAt: now,
+        };
+        await this.db.insert(vulseFormUploadDrafts).values(row);
+        return row;
+    }
+    async findValid(formHandle, fieldName, mediaId) {
+        const row = await this.db.select().from(vulseFormUploadDrafts)
+            .where(and(eq(vulseFormUploadDrafts.formHandle, formHandle), eq(vulseFormUploadDrafts.fieldName, fieldName), eq(vulseFormUploadDrafts.mediaId, mediaId), gt(vulseFormUploadDrafts.expiresAt, new Date())))
+            .get();
+        return row ?? null;
+    }
+    async delete(id) {
+        await this.db.delete(vulseFormUploadDrafts).where(eq(vulseFormUploadDrafts.id, id));
+    }
+    async listExpired(before) {
+        const rows = await this.db.select().from(vulseFormUploadDrafts)
+            .where(lt(vulseFormUploadDrafts.expiresAt, before));
+        return rows;
+    }
+    async attachToSubmission(draftId) {
+        await this.delete(draftId);
+    }
+}