@inharness-ai/claude4spec 1.0.0

package/dist/server/services/chat.js

@@ -0,0 +1,309 @@
+import { nanoid } from 'nanoid';
+import { DomainError } from './tags.js';
+export class ChatService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    createThread(title = null, opts = {}) {
+        const id = nanoid(12);
+        const contextType = opts.contextType ?? 'chat';
+        const briefPath = opts.briefPath ?? null;
+        // Invariant L2: context_type='brief' ⇒ brief_path IS NOT NULL.
+        if (contextType === 'brief' && !briefPath) {
+            throw new DomainError('VALIDATION', "context_type='brief' requires brief_path");
+        }
+        this.db
+            .prepare(`INSERT INTO chat_thread (id, title, context_type, brief_path) VALUES (?, ?, ?, ?)`)
+            .run(id, title, contextType, briefPath);
+        return this.getThreadRow(id);
+    }
+    /** M21: list threads attached to a brief (path-keyed lookup). */
+    listThreadsForBrief(briefPath) {
+        const rows = this.db
+            .prepare(`SELECT t.*,
+                COUNT(m.id) AS message_count,
+                (t.initial_system_prompt IS NOT NULL) AS has_system_prompt
+           FROM chat_thread t
+           LEFT JOIN chat_message m ON m.thread_id = t.id
+          WHERE t.brief_path = ? AND t.context_type = 'brief'
+          GROUP BY t.id
+          ORDER BY t.updated_at DESC`)
+            .all(briefPath);
+        return rows.map((r) => ({
+            ...this.hydrateThread(r),
+            messageCount: r.message_count,
+        }));
+    }
+    /** M21: count threads for a brief (cheap version of listThreadsForBrief for list UI). */
+    threadCountForBrief(briefPath) {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) AS n FROM chat_thread WHERE brief_path = ? AND context_type = 'brief'`)
+            .get(briefPath);
+        return row.n;
+    }
+    listThreads() {
+        const rows = this.db
+            .prepare(`SELECT t.*,
+                COUNT(m.id) AS message_count,
+                (t.initial_system_prompt IS NOT NULL) AS has_system_prompt
+           FROM chat_thread t
+           LEFT JOIN chat_message m ON m.thread_id = t.id
+          GROUP BY t.id
+          ORDER BY t.updated_at DESC`)
+            .all();
+        return rows.map((r) => ({
+            ...this.hydrateThread(r),
+            messageCount: r.message_count,
+        }));
+    }
+    getThread(id, limit, offset) {
+        const thread = this.findThread(id);
+        if (!thread)
+            return null;
+        const messages = this.getMessages(id, limit, offset);
+        const subagentTasks = this.listSubagentTasks(id);
+        return { thread, messages, subagentTasks };
+    }
+    getThreadMeta(id) {
+        return this.findThread(id);
+    }
+    deleteThread(id) {
+        const info = this.db.prepare(`DELETE FROM chat_thread WHERE id = ?`).run(id);
+        if (info.changes === 0)
+            throw new DomainError('NOT_FOUND', `thread '${id}' not found`);
+        return { deleted: true };
+    }
+    addMessage(threadId, role, content, toolName = null, toolId = null, subagentTaskId = null, planMode = false, status = 'complete') {
+        const tx = this.db.transaction(() => {
+            const info = this.db
+                .prepare(`INSERT INTO chat_message (thread_id, role, content, tool_name, tool_id, subagent_task_id, plan_mode, status)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(threadId, role, content, toolName, toolId, subagentTaskId, planMode ? 1 : 0, status);
+            this.db
+                .prepare(`UPDATE chat_thread SET updated_at = datetime('now') WHERE id = ?`)
+                .run(threadId);
+            const row = this.db
+                .prepare(`SELECT * FROM chat_message WHERE id = ?`)
+                .get(info.lastInsertRowid);
+            return this.hydrateMessage(row);
+        });
+        return tx();
+    }
+    startSubagentTask(threadId, taskId, description, toolUseId) {
+        this.db
+            .prepare(`INSERT INTO chat_subagent_task (thread_id, task_id, tool_use_id, description, status)
+         VALUES (?, ?, ?, ?, 'running')
+         ON CONFLICT(thread_id, task_id) DO UPDATE SET
+           tool_use_id = COALESCE(excluded.tool_use_id, chat_subagent_task.tool_use_id),
+           description = excluded.description,
+           updated_at  = datetime('now')`)
+            .run(threadId, taskId, toolUseId, description);
+    }
+    updateSubagentTaskProgress(threadId, taskId, description) {
+        this.db
+            .prepare(`UPDATE chat_subagent_task
+            SET description = ?, updated_at = datetime('now')
+          WHERE thread_id = ? AND task_id = ?`)
+            .run(description, threadId, taskId);
+    }
+    completeSubagentTask(threadId, taskId, status, summary) {
+        this.db
+            .prepare(`UPDATE chat_subagent_task
+            SET status = ?, summary = ?, updated_at = datetime('now')
+          WHERE thread_id = ? AND task_id = ?`)
+            .run(status, summary, threadId, taskId);
+    }
+    listSubagentTasks(threadId) {
+        const rows = this.db
+            .prepare(`SELECT * FROM chat_subagent_task
+          WHERE thread_id = ?
+          ORDER BY created_at ASC`)
+            .all(threadId);
+        return rows.map((r) => this.hydrateSubagentTask(r));
+    }
+    getMessages(threadId, limit, offset) {
+        const rows = limit === undefined
+            ? this.db
+                .prepare(`SELECT * FROM chat_message
+                WHERE thread_id = ?
+                ORDER BY id ASC`)
+                .all(threadId)
+            : this.db
+                .prepare(`SELECT * FROM chat_message
+                WHERE thread_id = ?
+                ORDER BY id ASC
+                LIMIT ? OFFSET ?`)
+                .all(threadId, limit, offset ?? 0);
+        return rows.map((r) => this.hydrateMessage(r));
+    }
+    updateTitle(threadId, title) {
+        const info = this.db
+            .prepare(`UPDATE chat_thread SET title = ?, updated_at = datetime('now') WHERE id = ?`)
+            .run(title, threadId);
+        if (info.changes === 0)
+            throw new DomainError('NOT_FOUND', `thread '${threadId}' not found`);
+    }
+    setLastSessionId(threadId, sessionId) {
+        this.db
+            .prepare(`UPDATE chat_thread SET last_session_id = ? WHERE id = ?`)
+            .run(sessionId, threadId);
+    }
+    setInitialSystemPrompt(threadId, prompt) {
+        this.db
+            .prepare(`UPDATE chat_thread SET initial_system_prompt = ?
+           WHERE id = ? AND initial_system_prompt IS NULL`)
+            .run(prompt, threadId);
+    }
+    getInitialSystemPrompt(threadId) {
+        const row = this.db
+            .prepare(`SELECT initial_system_prompt FROM chat_thread WHERE id = ?`)
+            .get(threadId);
+        return row?.initial_system_prompt ?? null;
+    }
+    setLastUsage(threadId, usage) {
+        this.db
+            .prepare(`UPDATE chat_thread SET last_usage_json = ? WHERE id = ?`)
+            .run(JSON.stringify(usage), threadId);
+    }
+    attachTurnUsage(threadId, messageId, usage) {
+        this.db
+            .prepare(`UPDATE chat_message SET usage_json = ? WHERE id = ? AND thread_id = ?`)
+            .run(JSON.stringify(usage), messageId, threadId);
+    }
+    setLastContextSize(threadId, contextSize) {
+        this.db
+            .prepare(`UPDATE chat_thread SET last_context_size = ? WHERE id = ?`)
+            .run(contextSize, threadId);
+    }
+    attachTurnContextSize(threadId, messageId, contextSize) {
+        this.db
+            .prepare(`UPDATE chat_message SET context_size = ? WHERE id = ? AND thread_id = ?`)
+            .run(contextSize, messageId, threadId);
+    }
+    markToolUseComplete(threadId, toolUseId) {
+        this.db
+            .prepare(`UPDATE chat_message SET status = 'complete'
+           WHERE thread_id = ? AND tool_id = ? AND role = 'tool_use'`)
+            .run(threadId, toolUseId);
+    }
+    finalizeStreamingRows(threadId) {
+        this.db
+            .prepare(`UPDATE chat_message SET status = 'complete'
+           WHERE thread_id = ? AND status = 'streaming'`)
+            .run(threadId);
+    }
+    finalizeAllStreamingRows() {
+        this.db
+            .prepare(`UPDATE chat_message SET status = 'complete' WHERE status = 'streaming'`)
+            .run();
+    }
+    updateCurrentTodoItems(threadId, items) {
+        const payload = items && items.length > 0 ? JSON.stringify(items) : null;
+        this.db
+            .prepare(`UPDATE chat_thread SET current_todo_items = ? WHERE id = ?`)
+            .run(payload, threadId);
+    }
+    updateThreadSettings(threadId, patch) {
+        if (patch.planMode !== undefined) {
+            const info = this.db
+                .prepare(`UPDATE chat_thread SET plan_mode = ?, updated_at = datetime('now') WHERE id = ?`)
+                .run(patch.planMode ? 1 : 0, threadId);
+            if (info.changes === 0)
+                throw new DomainError('NOT_FOUND', `thread '${threadId}' not found`);
+        }
+        return this.getThreadRow(threadId);
+    }
+    findThread(id) {
+        const row = this.db
+            .prepare(`SELECT t.*,
+                (t.initial_system_prompt IS NOT NULL) AS has_system_prompt
+           FROM chat_thread t
+          WHERE t.id = ?`)
+            .get(id);
+        return row ? this.hydrateThread(row) : null;
+    }
+    getThreadRow(id) {
+        const thread = this.findThread(id);
+        if (!thread)
+            throw new Error(`thread ${id} disappeared mid-tx`);
+        return thread;
+    }
+    hydrateThread(row) {
+        const usage = parseUsage(row.last_usage_json);
+        // Backward-compat: stare wątki bez kolumny last_context_size — fallback do
+        // usage.inputTokens + usage.outputTokens (mirror `contextSizeOf` z library).
+        // Wątki migracja-uwsteczna: zawsze NULL → fallback. Po pierwszej turze post-024
+        // server zapisze realny contextSize i fallback przestanie być potrzebny.
+        const contextSize = row.last_context_size ?? (usage ? usage.inputTokens + usage.outputTokens : null);
+        return {
+            id: row.id,
+            title: row.title,
+            lastSessionId: row.last_session_id,
+            currentTodoItems: parseTodoItems(row.current_todo_items),
+            planMode: row.plan_mode === 1,
+            usage,
+            contextSize,
+            planId: row.plan_id ?? null,
+            lastSeenPlanVersion: row.last_seen_plan_version ?? null,
+            hasSystemPrompt: row.has_system_prompt === 1,
+            contextType: (row.context_type === 'brief' ? 'brief' : 'chat'),
+            briefPath: row.brief_path,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    hydrateMessage(row) {
+        return {
+            id: row.id,
+            threadId: row.thread_id,
+            role: row.role,
+            content: row.content,
+            toolName: row.tool_name,
+            toolId: row.tool_id,
+            subagentTaskId: row.subagent_task_id,
+            planMode: row.plan_mode === 1,
+            status: row.status === 'streaming' ? 'streaming' : 'complete',
+            usage: parseUsage(row.usage_json),
+            contextSize: row.context_size ?? null,
+            createdAt: row.created_at,
+        };
+    }
+    hydrateSubagentTask(row) {
+        return {
+            threadId: row.thread_id,
+            taskId: row.task_id,
+            toolUseId: row.tool_use_id,
+            description: row.description,
+            status: row.status,
+            summary: row.summary,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+function parseTodoItems(raw) {
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseUsage(raw) {
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object')
+            return parsed;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/server/services/chat.js.map

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

package/dist/server/services/database-table.d.ts

@@ -0,0 +1,36 @@
+import type Database from 'better-sqlite3';
+import type { BrokenReference, ChangedBy, DatabaseTable, DatabaseTableCreateInput, DatabaseTableDanglingFk, DatabaseTableDeleteResult, DatabaseTableListQuery, DatabaseTableUpdateInput } from '../../shared/entities.js';
+import type { TagsService } from './tags.js';
+import type { VersionService } from './versions.js';
+export declare class DatabaseTableService {
+    private db;
+    private tags;
+    private versions;
+    constructor(db: Database.Database, tags: TagsService, versions: VersionService);
+    create(input: DatabaseTableCreateInput, actor: ChangedBy): {
+        dbTable: DatabaseTable;
+        warnings: string[];
+    };
+    list(query?: DatabaseTableListQuery): DatabaseTable[];
+    getBySlug(slug: string): DatabaseTable | null;
+    getIdBySlug(slug: string): number | null;
+    update(slug: string, input: DatabaseTableUpdateInput, actor: ChangedBy): {
+        dbTable: DatabaseTable;
+        previousSlug: string;
+        warnings: string[];
+    };
+    remove(slug: string, actor: ChangedBy, brokenReferences?: BrokenReference[]): DatabaseTableDeleteResult;
+    /**
+     * Propagates a slug rename to every other database_table whose columns carry
+     * an `fk.table === oldSlug`. Runs in a transaction and snapshots each
+     * mutated row via VersionService for an auditable trail.
+     */
+    propagateFkSlugChange(oldSlug: string, newSlug: string, actor: ChangedBy): {
+        changedTables: string[];
+    };
+    /** Tables whose columns carry `fk.table === targetSlug`. */
+    findDanglingFks(targetSlug: string): DatabaseTableDanglingFk[];
+    private getByIdInternal;
+    private hydrate;
+    private computeWarnings;
+}

package/dist/server/services/database-table.js

@@ -0,0 +1,303 @@
+import { databaseTableSlug } from './slug.js';
+import { DomainError } from './tags.js';
+export class DatabaseTableService {
+    db;
+    tags;
+    versions;
+    constructor(db, tags, versions) {
+        this.db = db;
+        this.tags = tags;
+        this.versions = versions;
+    }
+    create(input, actor) {
+        if (!input.name)
+            throw new DomainError('VALIDATION', 'name is required');
+        const slug = input.slug?.trim() || databaseTableSlug(input.name);
+        if (!slug)
+            throw new DomainError('VALIDATION', 'slug resolves to empty');
+        const columns = input.columns ?? [];
+        const indexes = input.indexes ?? [];
+        const tx = this.db.transaction(() => {
+            const conflict = this.db.prepare(`SELECT 1 FROM database_table WHERE slug = ?`).get(slug);
+            if (conflict)
+                throw new DomainError('SLUG_CONFLICT', `database table slug '${slug}' already exists`);
+            const info = this.db
+                .prepare(`INSERT INTO database_table (slug, name, description, columns, indexes)
+           VALUES (?, ?, ?, ?, ?)`)
+                .run(slug, input.name, input.description ?? null, JSON.stringify(columns), JSON.stringify(indexes));
+            const id = Number(info.lastInsertRowid);
+            if (input.tags?.length)
+                this.tags.assignTags('database-table', id, input.tags);
+            const created = this.getByIdInternal(id);
+            this.versions.createVersion('database-table', id, created, actor, 'Created');
+            const warnings = this.computeWarnings(columns, slug);
+            return { dbTable: created, warnings };
+        });
+        return tx();
+    }
+    list(query = {}) {
+        const where = [];
+        const params = [];
+        if (query.search) {
+            where.push(`(name LIKE ? OR description LIKE ? OR slug LIKE ?)`);
+            const like = `%${query.search}%`;
+            params.push(like, like, like);
+        }
+        const tagSlugs = query.tags?.filter(Boolean) ?? [];
+        if (tagSlugs.length) {
+            const placeholders = tagSlugs.map(() => '?').join(',');
+            if (query.tagFilter === 'or') {
+                where.push(`
+          id IN (
+            SELECT et.entity_id FROM entity_tag et
+              JOIN tag t ON t.id = et.tag_id
+             WHERE et.entity_type = 'database-table' AND t.slug IN (${placeholders})
+          )
+        `);
+                params.push(...tagSlugs);
+            }
+            else {
+                where.push(`
+          id IN (
+            SELECT et.entity_id
+              FROM entity_tag et
+              JOIN tag t ON t.id = et.tag_id
+             WHERE et.entity_type = 'database-table' AND t.slug IN (${placeholders})
+          GROUP BY et.entity_id
+            HAVING COUNT(DISTINCT t.slug) = ?
+          )
+        `);
+                params.push(...tagSlugs, tagSlugs.length);
+            }
+        }
+        const whereSql = where.length ? `WHERE ${where.join(' AND ')}` : '';
+        const limit = Math.min(Math.max(query.limit ?? 200, 1), 500);
+        const offset = Math.max(query.offset ?? 0, 0);
+        const rows = this.db
+            .prepare(`SELECT * FROM database_table ${whereSql}
+         ORDER BY name
+         LIMIT ? OFFSET ?`)
+            .all(...params, limit, offset);
+        return rows.map((r) => this.hydrate(r));
+    }
+    getBySlug(slug) {
+        const row = this.db.prepare(`SELECT * FROM database_table WHERE slug = ?`).get(slug);
+        return row ? this.hydrate(row) : null;
+    }
+    getIdBySlug(slug) {
+        const row = this.db.prepare(`SELECT id FROM database_table WHERE slug = ?`).get(slug);
+        return row?.id ?? null;
+    }
+    update(slug, input, actor) {
+        const tx = this.db.transaction(() => {
+            const current = this.db
+                .prepare(`SELECT * FROM database_table WHERE slug = ?`)
+                .get(slug);
+            if (!current)
+                throw new DomainError('NOT_FOUND', `database table '${slug}' not found`);
+            const nextName = input.name ?? current.name;
+            const autoSlug = databaseTableSlug(nextName);
+            const nextSlug = input.newSlug?.trim() || autoSlug;
+            if (nextSlug !== slug) {
+                const conflict = this.db
+                    .prepare(`SELECT 1 FROM database_table WHERE slug = ?`)
+                    .get(nextSlug);
+                if (conflict)
+                    throw new DomainError('SLUG_CONFLICT', `database table slug '${nextSlug}' already exists`);
+            }
+            const nextColumns = input.columns !== undefined ? JSON.stringify(input.columns) : current.columns;
+            const nextIndexes = input.indexes !== undefined ? JSON.stringify(input.indexes) : current.indexes;
+            this.db
+                .prepare(`UPDATE database_table
+             SET slug = ?, name = ?, description = ?, columns = ?, indexes = ?,
+                 updated_at = datetime('now')
+           WHERE id = ?`)
+                .run(nextSlug, nextName, input.description !== undefined ? input.description : current.description, nextColumns, nextIndexes, current.id);
+            if (input.tags)
+                this.tags.assignTags('database-table', current.id, input.tags);
+            const updated = this.getByIdInternal(current.id);
+            const summary = nextSlug !== slug ? `Renamed from '${slug}' to '${nextSlug}'` : 'Updated';
+            this.versions.createVersion('database-table', current.id, updated, actor, summary);
+            const warnings = this.computeWarnings(updated.columns, updated.slug);
+            return { dbTable: updated, previousSlug: slug, warnings };
+        });
+        return tx();
+    }
+    remove(slug, actor, brokenReferences = []) {
+        const tx = this.db.transaction(() => {
+            const row = this.db.prepare(`SELECT * FROM database_table WHERE slug = ?`).get(slug);
+            if (!row)
+                throw new DomainError('NOT_FOUND', `database table '${slug}' not found`);
+            const danglingFks = this.findDanglingFks(slug);
+            this.versions.createVersion('database-table', row.id, null, actor, 'Deleted');
+            this.db
+                .prepare(`DELETE FROM entity_tag WHERE entity_type = 'database-table' AND entity_id = ?`)
+                .run(row.id);
+            this.db.prepare(`DELETE FROM database_table WHERE id = ?`).run(row.id);
+            return { deleted: true, brokenReferences, danglingFks };
+        });
+        return tx();
+    }
+    /**
+     * Propagates a slug rename to every other database_table whose columns carry
+     * an `fk.table === oldSlug`. Runs in a transaction and snapshots each
+     * mutated row via VersionService for an auditable trail.
+     */
+    propagateFkSlugChange(oldSlug, newSlug, actor) {
+        if (oldSlug === newSlug)
+            return { changedTables: [] };
+        const changedTables = [];
+        const tx = this.db.transaction(() => {
+            const like = `%"table":"${oldSlug}"%`;
+            const rows = this.db
+                .prepare(`SELECT id, slug, columns FROM database_table
+            WHERE slug != ? AND columns LIKE ?`)
+                .all(newSlug, like);
+            for (const row of rows) {
+                const columns = parseColumns(row.columns);
+                let mutated = false;
+                const nextColumns = columns.map((col) => {
+                    if (col.fk && col.fk.table === oldSlug) {
+                        mutated = true;
+                        return { ...col, fk: { ...col.fk, table: newSlug } };
+                    }
+                    return col;
+                });
+                if (!mutated)
+                    continue;
+                this.db
+                    .prepare(`UPDATE database_table
+               SET columns = ?, updated_at = datetime('now')
+             WHERE id = ?`)
+                    .run(JSON.stringify(nextColumns), row.id);
+                const updated = this.getByIdInternal(row.id);
+                this.versions.createVersion('database-table', row.id, updated, actor, `FK slug propagation: '${oldSlug}' → '${newSlug}'`);
+                changedTables.push(row.slug);
+            }
+        });
+        tx();
+        return { changedTables };
+    }
+    /** Tables whose columns carry `fk.table === targetSlug`. */
+    findDanglingFks(targetSlug) {
+        const like = `%"table":"${targetSlug}"%`;
+        const rows = this.db
+            .prepare(`SELECT slug, columns FROM database_table
+          WHERE slug != ? AND columns LIKE ?`)
+            .all(targetSlug, like);
+        const out = [];
+        for (const row of rows) {
+            const columns = parseColumns(row.columns);
+            for (const col of columns) {
+                if (col.fk?.table === targetSlug) {
+                    out.push({ tableSlug: row.slug, columnName: col.name });
+                }
+            }
+        }
+        return out;
+    }
+    getByIdInternal(id) {
+        const row = this.db.prepare(`SELECT * FROM database_table WHERE id = ?`).get(id);
+        if (!row)
+            throw new Error(`database_table id ${id} disappeared mid-tx`);
+        return this.hydrate(row);
+    }
+    hydrate(row) {
+        return {
+            slug: row.slug,
+            name: row.name,
+            description: row.description,
+            columns: parseColumns(row.columns),
+            indexes: parseIndexes(row.indexes),
+            tags: this.tags.getEntityTagSlugs('database-table', row.id),
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    computeWarnings(columns, selfSlug) {
+        const warnings = [];
+        const knownTables = new Map();
+        const rows = this.db
+            .prepare(`SELECT slug, columns FROM database_table`)
+            .all();
+        for (const r of rows)
+            knownTables.set(r.slug, parseColumns(r.columns));
+        for (const col of columns) {
+            if (col.enumValues && col.enumValues.length > 0 && col.type !== 'enum') {
+                warnings.push(`Column '${col.name}': enumValues set but type is '${col.type}' (expected 'enum') — enumValues will be ignored.`);
+            }
+            if (col.fk) {
+                const target = col.fk.table;
+                const targetColumns = target === selfSlug ? columns : knownTables.get(target);
+                if (!targetColumns) {
+                    warnings.push(`Column '${col.name}': fk.table '${target}' does not exist yet.`);
+                }
+                else {
+                    const targetCol = targetColumns.find((c) => c.name === col.fk.column);
+                    if (!targetCol) {
+                        warnings.push(`Column '${col.name}': fk.column '${col.fk.column}' not found in table '${target}'.`);
+                    }
+                }
+            }
+        }
+        return warnings;
+    }
+}
+function parseColumns(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed
+            .filter((c) => c && typeof c === 'object' && typeof c.name === 'string')
+            .map((c) => {
+            const col = {
+                name: String(c.name),
+                type: typeof c.type === 'string' ? c.type : 'string',
+            };
+            if (typeof c.nullable === 'boolean')
+                col.nullable = c.nullable;
+            if (typeof c.unique === 'boolean')
+                col.unique = c.unique;
+            if (typeof c.pk === 'boolean')
+                col.pk = c.pk;
+            if (c.fk && typeof c.fk === 'object' && typeof c.fk.table === 'string') {
+                col.fk = { table: String(c.fk.table), column: String(c.fk.column ?? '') };
+            }
+            if (typeof c.default === 'string')
+                col.default = c.default;
+            if (Array.isArray(c.enumValues)) {
+                col.enumValues = c.enumValues.filter((v) => typeof v === 'string');
+            }
+            if (typeof c.description === 'string')
+                col.description = c.description;
+            return col;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function parseIndexes(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed
+            .filter((i) => i && typeof i === 'object' && Array.isArray(i.columns))
+            .map((i) => {
+            const idx = {
+                columns: i.columns.filter((c) => typeof c === 'string'),
+            };
+            if (typeof i.unique === 'boolean')
+                idx.unique = i.unique;
+            if (typeof i.name === 'string')
+                idx.name = i.name;
+            return idx;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=database-table.js.map