@adminiumjs/meta 0.1.0-rc.1

package/dist/repos/email-templates.js

@@ -0,0 +1,93 @@
+/**
+ * emailTemplatesRepo — adminium_email_templates (07-meta-store.md §3.28):
+ * overrides of built-in email templates, unique on `(key, locale)`. The row
+ * IS the template the workspace edits; `is_builtin_copy` marks rows the
+ * server seeded verbatim from a built-in (true) versus rows a human has
+ * touched (false — every editor write clears it, §3.28).
+ *
+ * `blocks` is the ordered open-record array (`emailBlocksSchema`); the
+ * concrete block shape is owned by the email editor (09-generated-app.md
+ * §email-editor) — the repo validates the envelope, never the block bodies.
+ */
+import { newId } from '../ids.js';
+import { emailBlocksSchema } from '../schema/json-payloads.js';
+import { affected, packJson, readBool, readJson, writeBool } from './util.js';
+function decode(row) {
+    return {
+        id: row.id,
+        key: row.key,
+        locale: row.locale,
+        name: row.name,
+        subject: row.subject,
+        blocks: emailBlocksSchema.parse(readJson(row.blocks)),
+        enabled: readBool(row.enabled),
+        isBuiltinCopy: readBool(row.isBuiltinCopy),
+        updatedBy: row.updatedBy,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+export function emailTemplatesRepo(meta) {
+    const { db } = meta;
+    async function findByKeyLocale(key, locale) {
+        const row = await db
+            .selectFrom('adminium_email_templates')
+            .selectAll()
+            .where('key', '=', key)
+            .where('locale', '=', locale)
+            .executeTakeFirst();
+        return row ? decode(row) : null;
+    }
+    return {
+        findByKeyLocale,
+        async list() {
+            const rows = await db
+                .selectFrom('adminium_email_templates')
+                .selectAll()
+                .orderBy('key', 'asc')
+                .orderBy('locale', 'asc')
+                .execute();
+            return rows.map(decode);
+        },
+        /**
+         * `(key, locale)` upsert, portably: UPDATE first, INSERT on zero affected
+         * rows (no cross-dialect ON CONFLICT — repos/util.ts convention).
+         */
+        async upsert(key, locale, input, at = Date.now()) {
+            const blocks = packJson(emailBlocksSchema.parse(input.blocks));
+            const shared = {
+                name: input.name,
+                subject: input.subject,
+                blocks,
+                enabled: writeBool(meta, input.enabled),
+                isBuiltinCopy: writeBool(meta, input.isBuiltinCopy ?? false),
+                updatedBy: input.updatedBy ?? null,
+            };
+            const res = await db
+                .updateTable('adminium_email_templates')
+                .set({ ...shared, updatedAt: at })
+                .where('key', '=', key)
+                .where('locale', '=', locale)
+                .executeTakeFirst();
+            if (affected(res.numUpdatedRows) === 0) {
+                await db
+                    .insertInto('adminium_email_templates')
+                    .values({ id: newId('tpl'), key, locale, ...shared, createdAt: at, updatedAt: at })
+                    .execute();
+            }
+            const row = await findByKeyLocale(key, locale);
+            if (row === null)
+                throw new Error(`email template upsert lost its row: ${key}/${locale}`);
+            return row;
+        },
+        async remove(key, locale) {
+            const res = await db
+                .deleteFrom('adminium_email_templates')
+                .where('key', '=', key)
+                .where('locale', '=', locale)
+                .executeTakeFirst();
+            return affected(res.numDeletedRows) === 1;
+        },
+    };
+}
+//# sourceMappingURL=email-templates.js.map

package/dist/repos/email-templates.js.map

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

package/dist/repos/exports.d.ts

@@ -0,0 +1,67 @@
+/**
+ * exportsRepo — adminium_exports (07-meta-store.md §3.25): one row per data
+ * export request. The row is the export's public state machine
+ * (`processing → ready | failed | cancelled | expired`); the artifact itself
+ * is an adminium_files row (`file_id`) written by the `export-run` job.
+ */
+import type { MetaDb } from '../connect.js';
+export type ExportFormat = 'csv' | 'json' | 'xlsx';
+export type ExportStatus = 'processing' | 'ready' | 'failed' | 'cancelled' | 'expired';
+export interface ExportSource {
+    kind: 'table' | 'view' | 'page';
+    table?: string | null | undefined;
+    viewId?: string | null | undefined;
+    filters?: unknown[] | undefined;
+}
+export interface DataExport {
+    id: string;
+    connectionId: string | null;
+    requestedBy: string;
+    source: ExportSource;
+    format: ExportFormat;
+    status: ExportStatus;
+    fileId: string | null;
+    rowCount: number | null;
+    error: string | null;
+    createdAt: number;
+    completedAt: number | null;
+    expiresAt: number | null;
+}
+export interface CreateExportInput {
+    connectionId?: string | null;
+    requestedBy: string;
+    source: ExportSource;
+    format: ExportFormat;
+}
+export declare function exportsRepo(meta: MetaDb): {
+    findById: (id: string) => Promise<DataExport | null>;
+    create(input: CreateExportInput, at?: number): Promise<DataExport>;
+    /** Newest first; `requestedBy` scopes to one user (the "mine" list). */
+    list(opts?: {
+        requestedBy?: string;
+        limit?: number;
+    }): Promise<DataExport[]>;
+    /** processing → ready, stamping the artifact + retention window. */
+    markReady(id: string, result: {
+        fileId: string;
+        rowCount: number;
+        expiresAt: number | null;
+    }, at?: number): Promise<boolean>;
+    markFailed(id: string, error: string, at?: number): Promise<boolean>;
+    markCancelled(id: string, at?: number): Promise<boolean>;
+    /** Retention sweep: ready rows past `expires_at` flip to `expired`. */
+    expireDue(at?: number): Promise<number>;
+    /**
+     * Byte-GC worklist (retention hygiene): expired exports whose artifact
+     * file row is not yet soft-deleted. The sweep marks each file deleted and
+     * removes its bytes — re-querying (instead of returning `expireDue`'s
+     * rows) makes the pass self-healing after a crash mid-GC.
+     */
+    listExpiredArtifacts(limit?: number): Promise<{
+        id: string;
+        fileId: string;
+        storageKey: string;
+    }[]>;
+};
+export type ExportsRepo = ReturnType<typeof exportsRepo>;
+//# sourceMappingURL=exports.d.ts.map

package/dist/repos/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/repos/exports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAU5C,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAmBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;mBAGV,MAAM,KAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;kBAQzC,iBAAiB,OAAM,MAAM,GAAgB,OAAO,CAAC,UAAU,CAAC;IAmBpF,wEAAwE;gBAEhE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,UAAU,EAAE,CAAC;IAWxB,oEAAoE;kBAE9D,MAAM,UACF;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,OAClE,MAAM,GACT,OAAO,CAAC,OAAO,CAAC;mBAgBE,MAAM,SAAS,MAAM,OAAM,MAAM,GAAgB,OAAO,CAAC,OAAO,CAAC;sBAU9D,MAAM,OAAM,MAAM,GAAgB,OAAO,CAAC,OAAO,CAAC;IAU1E,uEAAuE;mBACnD,MAAM,GAAgB,OAAO,CAAC,MAAM,CAAC;IAWzD;;;;;OAKG;0CAGA,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;EAgBnE;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/repos/exports.js

@@ -0,0 +1,132 @@
+/**
+ * exportsRepo — adminium_exports (07-meta-store.md §3.25): one row per data
+ * export request. The row is the export's public state machine
+ * (`processing → ready | failed | cancelled | expired`); the artifact itself
+ * is an adminium_files row (`file_id`) written by the `export-run` job.
+ */
+import { newId } from '../ids.js';
+import { exportFormatSchema, exportSourceSchema, exportStatusSchema, } from '../schema/json-payloads.js';
+import { affected, packJson, readJson } from './util.js';
+function decode(row) {
+    return {
+        id: row.id,
+        connectionId: row.connectionId,
+        requestedBy: row.requestedBy,
+        source: exportSourceSchema.parse(readJson(row.source)),
+        format: exportFormatSchema.parse(row.format),
+        status: exportStatusSchema.parse(row.status),
+        fileId: row.fileId,
+        rowCount: row.rowCount === null ? null : Number(row.rowCount),
+        error: row.error,
+        createdAt: row.createdAt,
+        completedAt: row.completedAt,
+        expiresAt: row.expiresAt,
+    };
+}
+export function exportsRepo(meta) {
+    const { db } = meta;
+    async function findById(id) {
+        const row = await db.selectFrom('adminium_exports').selectAll().where('id', '=', id).executeTakeFirst();
+        return row ? decode(row) : null;
+    }
+    return {
+        findById,
+        async create(input, at = Date.now()) {
+            const row = {
+                id: newId('exp'),
+                connectionId: input.connectionId ?? null,
+                requestedBy: input.requestedBy,
+                source: packJson(exportSourceSchema.parse(input.source)),
+                format: exportFormatSchema.parse(input.format),
+                status: 'processing',
+                fileId: null,
+                rowCount: null,
+                error: null,
+                createdAt: at,
+                completedAt: null,
+                expiresAt: null,
+            };
+            await db.insertInto('adminium_exports').values(row).execute();
+            return decode(row);
+        },
+        /** Newest first; `requestedBy` scopes to one user (the "mine" list). */
+        async list(opts = {}) {
+            let query = db.selectFrom('adminium_exports').selectAll();
+            if (opts.requestedBy !== undefined)
+                query = query.where('requestedBy', '=', opts.requestedBy);
+            const rows = await query
+                .orderBy('createdAt', 'desc')
+                .orderBy('id', 'desc')
+                .limit(opts.limit ?? 50)
+                .execute();
+            return rows.map(decode);
+        },
+        /** processing → ready, stamping the artifact + retention window. */
+        async markReady(id, result, at = Date.now()) {
+            const res = await db
+                .updateTable('adminium_exports')
+                .set({
+                status: 'ready',
+                fileId: result.fileId,
+                rowCount: result.rowCount,
+                completedAt: at,
+                expiresAt: result.expiresAt,
+            })
+                .where('id', '=', id)
+                .where('status', '=', 'processing')
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows) === 1;
+        },
+        async markFailed(id, error, at = Date.now()) {
+            const res = await db
+                .updateTable('adminium_exports')
+                .set({ status: 'failed', error, completedAt: at })
+                .where('id', '=', id)
+                .where('status', '=', 'processing')
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows) === 1;
+        },
+        async markCancelled(id, at = Date.now()) {
+            const res = await db
+                .updateTable('adminium_exports')
+                .set({ status: 'cancelled', completedAt: at })
+                .where('id', '=', id)
+                .where('status', '=', 'processing')
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows) === 1;
+        },
+        /** Retention sweep: ready rows past `expires_at` flip to `expired`. */
+        async expireDue(at = Date.now()) {
+            const res = await db
+                .updateTable('adminium_exports')
+                .set({ status: 'expired' })
+                .where('status', '=', 'ready')
+                .where('expiresAt', 'is not', null)
+                .where('expiresAt', '<', at)
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows);
+        },
+        /**
+         * Byte-GC worklist (retention hygiene): expired exports whose artifact
+         * file row is not yet soft-deleted. The sweep marks each file deleted and
+         * removes its bytes — re-querying (instead of returning `expireDue`'s
+         * rows) makes the pass self-healing after a crash mid-GC.
+         */
+        async listExpiredArtifacts(limit = 500) {
+            const rows = await db
+                .selectFrom('adminium_exports')
+                .innerJoin('adminium_files', 'adminium_files.id', 'adminium_exports.fileId')
+                .select([
+                'adminium_exports.id as id',
+                'adminium_files.id as fileId',
+                'adminium_files.storageKey as storageKey',
+            ])
+                .where('adminium_exports.status', '=', 'expired')
+                .where('adminium_files.deletedAt', 'is', null)
+                .limit(limit)
+                .execute();
+            return rows;
+        },
+    };
+}
+//# sourceMappingURL=exports.js.map

package/dist/repos/exports.js.map

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

package/dist/repos/files.d.ts

@@ -0,0 +1,52 @@
+/**
+ * filesRepo — adminium_files (07-meta-store.md §3.27): one row per stored
+ * artifact (export bundles, import uploads, error reports, branding assets…).
+ *
+ * The repo owns ROWS only — bytes live wherever `storage`/`storage_key` say
+ * (v1: `local` under `<dataDir>/files/<id>`, apps/server/src/files/storage.ts).
+ * Deletion is soft (`deleted_at`) so a GC pass can remove bytes first and rows
+ * second without ever leaving a row that points at nothing.
+ */
+import type { MetaDb } from '../connect.js';
+import { type RecordRef } from '../schema/json-payloads.js';
+export type FileKind = 'upload' | 'export' | 'import' | 'branding' | 'schema' | 'archive';
+export interface StoredFile {
+    id: string;
+    /** v1: always `local`. */
+    storage: string;
+    storageKey: string;
+    filename: string;
+    mime: string;
+    sizeBytes: number;
+    sha256: string;
+    kind: FileKind;
+    entity: RecordRef | null;
+    uploadedBy: string | null;
+    createdAt: number;
+    deletedAt: number | null;
+}
+export interface CreateFileInput {
+    /** Storage backend key; defaults to the row id (local layout). */
+    storageKey?: string;
+    filename: string;
+    mime: string;
+    sizeBytes: number;
+    sha256: string;
+    kind: FileKind;
+    entity?: RecordRef | null;
+    uploadedBy?: string | null;
+    /** Pre-minted id (lets the storage layer write bytes under the final id first). */
+    id?: string;
+}
+export declare function filesRepo(meta: MetaDb): {
+    findById: (id: string) => Promise<StoredFile | null>;
+    create(input: CreateFileInput, at?: number): Promise<StoredFile>;
+    /** Soft delete — bytes are removed by the storage GC, rows stay addressable. */
+    markDeleted(id: string, at?: number): Promise<boolean>;
+    /** Rows already soft-deleted before `cutoff` — the storage GC's worklist. */
+    listDeletedBefore(cutoff: number, limit?: number): Promise<StoredFile[]>;
+    /** Hard-delete a row (call only after the bytes are gone). */
+    purge(id: string): Promise<boolean>;
+};
+export type FilesRepo = ReturnType<typeof filesRepo>;
+//# sourceMappingURL=files.d.ts.map

package/dist/repos/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/repos/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAI7F,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1F,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAmBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM;mBAGR,MAAM,KAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;kBAQzC,eAAe,OAAM,MAAM,GAAgB,OAAO,CAAC,UAAU,CAAC;IAqBlF,gFAAgF;oBAC1D,MAAM,OAAM,MAAM,GAAgB,OAAO,CAAC,OAAO,CAAC;IAUxE,6EAA6E;8BAC7C,MAAM,mBAAgB,OAAO,CAAC,UAAU,EAAE,CAAC;IAY3E,8DAA8D;cAC9C,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;EAK5C;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/repos/files.js

@@ -0,0 +1,86 @@
+/**
+ * filesRepo — adminium_files (07-meta-store.md §3.27): one row per stored
+ * artifact (export bundles, import uploads, error reports, branding assets…).
+ *
+ * The repo owns ROWS only — bytes live wherever `storage`/`storage_key` say
+ * (v1: `local` under `<dataDir>/files/<id>`, apps/server/src/files/storage.ts).
+ * Deletion is soft (`deleted_at`) so a GC pass can remove bytes first and rows
+ * second without ever leaving a row that points at nothing.
+ */
+import { newId } from '../ids.js';
+import { fileKindSchema, recordRefSchema } from '../schema/json-payloads.js';
+import { affected, packJson, readJsonOrNull } from './util.js';
+function decode(row) {
+    return {
+        id: row.id,
+        storage: row.storage,
+        storageKey: row.storageKey,
+        filename: row.filename,
+        mime: row.mime,
+        sizeBytes: Number(row.sizeBytes),
+        sha256: row.sha256,
+        kind: fileKindSchema.parse(row.kind),
+        entity: readJsonOrNull(row.entity),
+        uploadedBy: row.uploadedBy,
+        createdAt: row.createdAt,
+        deletedAt: row.deletedAt,
+    };
+}
+export function filesRepo(meta) {
+    const { db } = meta;
+    async function findById(id) {
+        const row = await db.selectFrom('adminium_files').selectAll().where('id', '=', id).executeTakeFirst();
+        return row ? decode(row) : null;
+    }
+    return {
+        findById,
+        async create(input, at = Date.now()) {
+            const id = input.id ?? newId('file');
+            const entity = input.entity == null ? null : recordRefSchema.parse(input.entity);
+            const row = {
+                id,
+                storage: 'local',
+                storageKey: input.storageKey ?? id,
+                filename: input.filename,
+                mime: input.mime,
+                sizeBytes: input.sizeBytes,
+                sha256: input.sha256,
+                kind: fileKindSchema.parse(input.kind),
+                entity: entity === null ? null : packJson(entity),
+                uploadedBy: input.uploadedBy ?? null,
+                createdAt: at,
+                deletedAt: null,
+            };
+            await db.insertInto('adminium_files').values(row).execute();
+            return decode(row);
+        },
+        /** Soft delete — bytes are removed by the storage GC, rows stay addressable. */
+        async markDeleted(id, at = Date.now()) {
+            const res = await db
+                .updateTable('adminium_files')
+                .set({ deletedAt: at })
+                .where('id', '=', id)
+                .where('deletedAt', 'is', null)
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows) === 1;
+        },
+        /** Rows already soft-deleted before `cutoff` — the storage GC's worklist. */
+        async listDeletedBefore(cutoff, limit = 100) {
+            const rows = await db
+                .selectFrom('adminium_files')
+                .selectAll()
+                .where('deletedAt', 'is not', null)
+                .where('deletedAt', '<', cutoff)
+                .orderBy('deletedAt', 'asc')
+                .limit(limit)
+                .execute();
+            return rows.map(decode);
+        },
+        /** Hard-delete a row (call only after the bytes are gone). */
+        async purge(id) {
+            const res = await db.deleteFrom('adminium_files').where('id', '=', id).executeTakeFirst();
+            return affected(res.numDeletedRows) === 1;
+        },
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/repos/files.js.map

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

package/dist/repos/imports.d.ts

@@ -0,0 +1,71 @@
+/**
+ * importsRepo — adminium_imports (07-meta-store.md §3.26): the import wizard's
+ * server-side state machine
+ * (`validating → ready → running → succeeded | failed | cancelled`).
+ *
+ * `mapping`/`options` are validated against the §3.26 payload schemas on every
+ * write; `stats` carries the invariant the SPA asserts (09 §11.1):
+ * total = inserted + updated + skipped.
+ */
+import type { MetaDb } from '../connect.js';
+export type ImportStatus = 'validating' | 'ready' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+export interface ImportMapping {
+    columns: {
+        from: string;
+        to: string | null;
+    }[];
+}
+export interface ImportOptions {
+    mode?: 'insert' | 'upsert' | undefined;
+    matchColumn?: string | null | undefined;
+    skipInvalid?: boolean | undefined;
+}
+export interface ImportStats {
+    total: number;
+    inserted?: number | undefined;
+    updated?: number | undefined;
+    skipped?: number | undefined;
+}
+export interface DataImport {
+    id: string;
+    connectionId: string;
+    tableName: string;
+    requestedBy: string;
+    fileId: string;
+    mapping: ImportMapping;
+    options: ImportOptions;
+    status: ImportStatus;
+    stats: ImportStats | null;
+    errorReportFileId: string | null;
+    createdAt: number;
+    startedAt: number | null;
+    finishedAt: number | null;
+}
+export interface CreateImportInput {
+    connectionId: string;
+    tableName: string;
+    requestedBy: string;
+    fileId: string;
+    mapping: ImportMapping;
+    options: ImportOptions;
+}
+export declare function importsRepo(meta: MetaDb): {
+    findById: (id: string) => Promise<DataImport | null>;
+    create(input: CreateImportInput, at?: number): Promise<DataImport>;
+    /** Newest first; `requestedBy` scopes to one user (the "mine" list). */
+    list(opts?: {
+        requestedBy?: string;
+        limit?: number;
+    }): Promise<DataImport[]>;
+    /** validating → ready, stamping the validation stats (total parsed rows). */
+    markReady(id: string, stats: ImportStats, at?: number): Promise<boolean>;
+    /** ready → running (the import-run job's claim; double-runs are refused). */
+    markRunning(id: string, at?: number): Promise<boolean>;
+    markFinished(id: string, outcome: {
+        status: "succeeded" | "failed" | "cancelled";
+        stats?: ImportStats | null;
+        errorReportFileId?: string | null;
+    }, at?: number): Promise<boolean>;
+};
+export type ImportsRepo = ReturnType<typeof importsRepo>;
+//# sourceMappingURL=imports.d.ts.map

package/dist/repos/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/repos/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAW5C,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;CACxB;AAuBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;mBAGV,MAAM,KAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;kBAQzC,iBAAiB,OAAM,MAAM,GAAgB,OAAO,CAAC,UAAU,CAAC;IAoBpF,wEAAwE;gBACvD;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAQ,OAAO,CAAC,UAAU,EAAE,CAAC;IAWtF,6EAA6E;kBACzD,MAAM,SAAS,WAAW,OAAM,MAAM,GAAgB,OAAO,CAAC,OAAO,CAAC;IAW1F,6EAA6E;oBACvD,MAAM,OAAM,MAAM,GAAgB,OAAO,CAAC,OAAO,CAAC;qBAWlE,MAAM,WACD;QACP,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC7C,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,OACG,MAAM,GACT,OAAO,CAAC,OAAO,CAAC;EAiBtB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/repos/imports.js

@@ -0,0 +1,111 @@
+/**
+ * importsRepo — adminium_imports (07-meta-store.md §3.26): the import wizard's
+ * server-side state machine
+ * (`validating → ready → running → succeeded | failed | cancelled`).
+ *
+ * `mapping`/`options` are validated against the §3.26 payload schemas on every
+ * write; `stats` carries the invariant the SPA asserts (09 §11.1):
+ * total = inserted + updated + skipped.
+ */
+import { newId } from '../ids.js';
+import { importMappingSchema, importOptionsSchema, importStatsSchema, importStatusSchema, } from '../schema/json-payloads.js';
+import { affected, packJson, readJson, readJsonOrNull } from './util.js';
+function decode(row) {
+    return {
+        id: row.id,
+        connectionId: row.connectionId,
+        tableName: row.tableName,
+        requestedBy: row.requestedBy,
+        fileId: row.fileId,
+        mapping: importMappingSchema.parse(readJson(row.mapping)),
+        options: importOptionsSchema.parse(readJson(row.options)),
+        status: importStatusSchema.parse(row.status),
+        stats: (() => {
+            const raw = readJsonOrNull(row.stats);
+            return raw === null ? null : importStatsSchema.parse(raw);
+        })(),
+        errorReportFileId: row.errorReportFileId,
+        createdAt: row.createdAt,
+        startedAt: row.startedAt,
+        finishedAt: row.finishedAt,
+    };
+}
+export function importsRepo(meta) {
+    const { db } = meta;
+    async function findById(id) {
+        const row = await db.selectFrom('adminium_imports').selectAll().where('id', '=', id).executeTakeFirst();
+        return row ? decode(row) : null;
+    }
+    return {
+        findById,
+        async create(input, at = Date.now()) {
+            const row = {
+                id: newId('imp'),
+                connectionId: input.connectionId,
+                tableName: input.tableName,
+                requestedBy: input.requestedBy,
+                fileId: input.fileId,
+                mapping: packJson(importMappingSchema.parse(input.mapping)),
+                options: packJson(importOptionsSchema.parse(input.options)),
+                status: 'validating',
+                stats: null,
+                errorReportFileId: null,
+                createdAt: at,
+                startedAt: null,
+                finishedAt: null,
+            };
+            await db.insertInto('adminium_imports').values(row).execute();
+            return decode(row);
+        },
+        /** Newest first; `requestedBy` scopes to one user (the "mine" list). */
+        async list(opts = {}) {
+            let query = db.selectFrom('adminium_imports').selectAll();
+            if (opts.requestedBy !== undefined)
+                query = query.where('requestedBy', '=', opts.requestedBy);
+            const rows = await query
+                .orderBy('createdAt', 'desc')
+                .orderBy('id', 'desc')
+                .limit(opts.limit ?? 50)
+                .execute();
+            return rows.map(decode);
+        },
+        /** validating → ready, stamping the validation stats (total parsed rows). */
+        async markReady(id, stats, at = Date.now()) {
+            void at;
+            const res = await db
+                .updateTable('adminium_imports')
+                .set({ status: 'ready', stats: packJson(importStatsSchema.parse(stats)) })
+                .where('id', '=', id)
+                .where('status', '=', 'validating')
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows) === 1;
+        },
+        /** ready → running (the import-run job's claim; double-runs are refused). */
+        async markRunning(id, at = Date.now()) {
+            const res = await db
+                .updateTable('adminium_imports')
+                .set({ status: 'running', startedAt: at })
+                .where('id', '=', id)
+                .where('status', '=', 'ready')
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows) === 1;
+        },
+        async markFinished(id, outcome, at = Date.now()) {
+            const res = await db
+                .updateTable('adminium_imports')
+                .set({
+                status: outcome.status,
+                finishedAt: at,
+                ...(outcome.stats == null ? {} : { stats: packJson(importStatsSchema.parse(outcome.stats)) }),
+                ...(outcome.errorReportFileId === undefined
+                    ? {}
+                    : { errorReportFileId: outcome.errorReportFileId }),
+            })
+                .where('id', '=', id)
+                .where('status', 'in', ['running', 'validating', 'ready'])
+                .executeTakeFirst();
+            return affected(res.numUpdatedRows) === 1;
+        },
+    };
+}
+//# sourceMappingURL=imports.js.map