@shotleybuilder/svelte-gridlite-kit 0.1.0

package/dist/query/schema.js

@@ -0,0 +1,75 @@
+/**
+ * Schema Introspection for GridLite
+ *
+ * Queries information_schema.columns to discover column names, types,
+ * and nullability for a given table. Maps Postgres data types to
+ * GridLite's ColumnDataType for filter operator selection and UI rendering.
+ */
+// ─── Postgres Type → ColumnDataType Mapping ─────────────────────────────────
+/**
+ * Map a Postgres data_type string (from information_schema.columns)
+ * to a GridLite ColumnDataType.
+ */
+export function mapPostgresType(postgresType) {
+    const t = postgresType.toLowerCase();
+    // Numeric types
+    if (t === 'integer' ||
+        t === 'bigint' ||
+        t === 'smallint' ||
+        t === 'numeric' ||
+        t === 'decimal' ||
+        t === 'real' ||
+        t === 'double precision' ||
+        t === 'serial' ||
+        t === 'bigserial' ||
+        t === 'smallserial' ||
+        t === 'money') {
+        return 'number';
+    }
+    // Date/time types
+    if (t === 'date' ||
+        t === 'timestamp without time zone' ||
+        t === 'timestamp with time zone' ||
+        t === 'time without time zone' ||
+        t === 'time with time zone' ||
+        t === 'interval') {
+        return 'date';
+    }
+    // Boolean
+    if (t === 'boolean') {
+        return 'boolean';
+    }
+    // Everything else is text (varchar, char, text, json, jsonb, uuid, etc.)
+    return 'text';
+}
+/**
+ * Introspect a table's schema using information_schema.columns.
+ *
+ * Returns an array of ColumnMetadata in column ordinal position order.
+ * The table name is parameterized to prevent SQL injection.
+ *
+ * @param db - PGLite instance
+ * @param tableName - The table to introspect
+ * @param schema - The schema to search (defaults to 'public')
+ */
+export async function introspectTable(db, tableName, schema = 'public') {
+    const result = await db.query(`SELECT column_name, data_type, is_nullable, column_default
+		 FROM information_schema.columns
+		 WHERE table_name = $1 AND table_schema = $2
+		 ORDER BY ordinal_position`, [tableName, schema]);
+    return result.rows.map((row) => ({
+        name: row.column_name,
+        dataType: mapPostgresType(row.data_type),
+        postgresType: row.data_type,
+        nullable: row.is_nullable === 'YES',
+        hasDefault: row.column_default !== null
+    }));
+}
+/**
+ * Get the list of column names for a table.
+ * Useful for the query builder's allowedColumns parameter.
+ */
+export async function getColumnNames(db, tableName, schema = 'public') {
+    const columns = await introspectTable(db, tableName, schema);
+    return columns.map((c) => c.name);
+}

package/dist/state/migrations.d.ts

@@ -0,0 +1,29 @@
+/**
+ * GridLite Config Table Migrations
+ *
+ * Creates and manages internal tables for persisting grid state:
+ * - _gridlite_meta: migration version tracking
+ * - _gridlite_views: saved view configurations per grid instance
+ * - _gridlite_column_state: column visibility, ordering, sizing per view
+ *
+ * All tables are prefixed with `_gridlite_` to avoid collision with user tables.
+ */
+import type { PGlite } from "@electric-sql/pglite";
+/**
+ * Run all pending migrations.
+ *
+ * This is idempotent — safe to call on every app startup.
+ * Migrations use `IF NOT EXISTS` for table/index creation.
+ *
+ * @param db - PGLite instance
+ * @returns The final migration version
+ */
+export declare function runMigrations(db: PGlite): Promise<number>;
+/**
+ * Get the latest migration version available.
+ */
+export declare function getLatestVersion(): number;
+/**
+ * Check if migrations are up to date.
+ */
+export declare function isMigrated(db: PGlite): Promise<boolean>;

package/dist/state/migrations.js

@@ -0,0 +1,113 @@
+/**
+ * GridLite Config Table Migrations
+ *
+ * Creates and manages internal tables for persisting grid state:
+ * - _gridlite_meta: migration version tracking
+ * - _gridlite_views: saved view configurations per grid instance
+ * - _gridlite_column_state: column visibility, ordering, sizing per view
+ *
+ * All tables are prefixed with `_gridlite_` to avoid collision with user tables.
+ */
+const MIGRATIONS = [
+    {
+        version: 1,
+        description: "Create meta, views, and column_state tables",
+        sql: `
+			CREATE TABLE IF NOT EXISTS _gridlite_meta (
+				key TEXT PRIMARY KEY,
+				value TEXT NOT NULL
+			);
+
+			CREATE TABLE IF NOT EXISTS _gridlite_views (
+				id TEXT PRIMARY KEY,
+				grid_id TEXT NOT NULL,
+				name TEXT NOT NULL,
+				description TEXT,
+				filters JSONB DEFAULT '[]',
+				filter_logic TEXT DEFAULT 'and',
+				sorting JSONB DEFAULT '[]',
+				grouping JSONB DEFAULT '[]',
+				column_visibility JSONB DEFAULT '{}',
+				column_order JSONB DEFAULT '[]',
+				is_default BOOLEAN DEFAULT false,
+				created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+				updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+			);
+
+			CREATE INDEX IF NOT EXISTS idx_gridlite_views_grid_id
+				ON _gridlite_views (grid_id);
+
+			CREATE TABLE IF NOT EXISTS _gridlite_column_state (
+				grid_id TEXT NOT NULL,
+				view_id TEXT NOT NULL DEFAULT '__default__',
+				column_name TEXT NOT NULL,
+				visible BOOLEAN DEFAULT true,
+				width INTEGER,
+				position INTEGER,
+				PRIMARY KEY (grid_id, view_id, column_name)
+			);
+
+			CREATE INDEX IF NOT EXISTS idx_gridlite_column_state_grid
+				ON _gridlite_column_state (grid_id);
+		`,
+    },
+];
+// ─── Migration Runner ───────────────────────────────────────────────────────
+/**
+ * Get the current migration version from the database.
+ * Returns 0 if the meta table doesn't exist yet.
+ */
+async function getCurrentVersion(db) {
+    try {
+        const result = await db.query(`SELECT value FROM _gridlite_meta WHERE key = 'migration_version'`);
+        if (result.rows.length > 0) {
+            return parseInt(result.rows[0].value, 10);
+        }
+        return 0;
+    }
+    catch {
+        // Table doesn't exist yet
+        return 0;
+    }
+}
+/**
+ * Set the migration version in the meta table.
+ */
+async function setVersion(db, version) {
+    await db.query(`INSERT INTO _gridlite_meta (key, value) VALUES ('migration_version', $1)
+		 ON CONFLICT (key) DO UPDATE SET value = $1`, [String(version)]);
+}
+/**
+ * Run all pending migrations.
+ *
+ * This is idempotent — safe to call on every app startup.
+ * Migrations use `IF NOT EXISTS` for table/index creation.
+ *
+ * @param db - PGLite instance
+ * @returns The final migration version
+ */
+export async function runMigrations(db) {
+    const currentVersion = await getCurrentVersion(db);
+    const pending = MIGRATIONS.filter((m) => m.version > currentVersion);
+    if (pending.length === 0) {
+        return currentVersion;
+    }
+    for (const migration of pending) {
+        await db.exec(migration.sql);
+        await setVersion(db, migration.version);
+    }
+    return pending[pending.length - 1].version;
+}
+/**
+ * Get the latest migration version available.
+ */
+export function getLatestVersion() {
+    return MIGRATIONS.length > 0 ? MIGRATIONS[MIGRATIONS.length - 1].version : 0;
+}
+/**
+ * Check if migrations are up to date.
+ */
+export async function isMigrated(db) {
+    const current = await getCurrentVersion(db);
+    return current >= getLatestVersion();
+}

package/dist/state/views.d.ts

@@ -0,0 +1,54 @@
+/**
+ * View Configuration Persistence
+ *
+ * CRUD operations for grid view configs stored in PGLite tables.
+ * Each grid instance (identified by `gridId`) can have multiple named views.
+ * One view per grid can be marked as the default.
+ *
+ * Requires `runMigrations()` to have been called first.
+ */
+import type { PGlite } from '@electric-sql/pglite';
+import type { ViewPreset } from '../types.js';
+/**
+ * Save a view configuration. Creates or updates (upserts).
+ */
+export declare function saveView(db: PGlite, gridId: string, view: ViewPreset): Promise<void>;
+/**
+ * Load a single view by ID.
+ */
+export declare function loadView(db: PGlite, viewId: string): Promise<ViewPreset | null>;
+/**
+ * Load all views for a grid instance.
+ */
+export declare function loadViews(db: PGlite, gridId: string): Promise<ViewPreset[]>;
+/**
+ * Load the default view for a grid instance (if one is set).
+ */
+export declare function loadDefaultView(db: PGlite, gridId: string): Promise<ViewPreset | null>;
+/**
+ * Set a view as the default for its grid. Clears any existing default first.
+ */
+export declare function setDefaultView(db: PGlite, gridId: string, viewId: string): Promise<void>;
+/**
+ * Delete a view by ID.
+ */
+export declare function deleteView(db: PGlite, viewId: string): Promise<void>;
+/**
+ * Save column state for a grid (optionally scoped to a view).
+ * Replaces all existing column state for the given grid+view.
+ */
+export declare function saveColumnState(db: PGlite, gridId: string, columns: {
+    name: string;
+    visible?: boolean;
+    width?: number;
+    position?: number;
+}[], viewId?: string): Promise<void>;
+/**
+ * Load column state for a grid (optionally scoped to a view).
+ */
+export declare function loadColumnState(db: PGlite, gridId: string, viewId?: string): Promise<{
+    name: string;
+    visible: boolean;
+    width: number | null;
+    position: number | null;
+}[]>;

package/dist/state/views.js

@@ -0,0 +1,130 @@
+/**
+ * View Configuration Persistence
+ *
+ * CRUD operations for grid view configs stored in PGLite tables.
+ * Each grid instance (identified by `gridId`) can have multiple named views.
+ * One view per grid can be marked as the default.
+ *
+ * Requires `runMigrations()` to have been called first.
+ */
+// ─── View CRUD ──────────────────────────────────────────────────────────────
+/**
+ * Save a view configuration. Creates or updates (upserts).
+ */
+export async function saveView(db, gridId, view) {
+    await db.query(`INSERT INTO _gridlite_views
+			(id, grid_id, name, description, filters, filter_logic, sorting, grouping, column_visibility, column_order, is_default, updated_at)
+		 VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, false, CURRENT_TIMESTAMP)
+		 ON CONFLICT (id) DO UPDATE SET
+			name = $3,
+			description = $4,
+			filters = $5,
+			filter_logic = $6,
+			sorting = $7,
+			grouping = $8,
+			column_visibility = $9,
+			column_order = $10,
+			updated_at = CURRENT_TIMESTAMP`, [
+        view.id,
+        gridId,
+        view.name,
+        view.description ?? null,
+        JSON.stringify(view.filters ?? []),
+        view.filterLogic ?? 'and',
+        JSON.stringify(view.sorting ?? []),
+        JSON.stringify(view.grouping ?? []),
+        JSON.stringify(view.columnVisibility ?? {}),
+        JSON.stringify(view.columnOrder ?? [])
+    ]);
+}
+/**
+ * Load a single view by ID.
+ */
+export async function loadView(db, viewId) {
+    const result = await db.query(`SELECT * FROM _gridlite_views WHERE id = $1`, [viewId]);
+    if (result.rows.length === 0)
+        return null;
+    return rowToViewPreset(result.rows[0]);
+}
+/**
+ * Load all views for a grid instance.
+ */
+export async function loadViews(db, gridId) {
+    const result = await db.query(`SELECT * FROM _gridlite_views WHERE grid_id = $1 ORDER BY name`, [gridId]);
+    return result.rows.map(rowToViewPreset);
+}
+/**
+ * Load the default view for a grid instance (if one is set).
+ */
+export async function loadDefaultView(db, gridId) {
+    const result = await db.query(`SELECT * FROM _gridlite_views WHERE grid_id = $1 AND is_default = true LIMIT 1`, [gridId]);
+    if (result.rows.length === 0)
+        return null;
+    return rowToViewPreset(result.rows[0]);
+}
+/**
+ * Set a view as the default for its grid. Clears any existing default first.
+ */
+export async function setDefaultView(db, gridId, viewId) {
+    // Clear existing default
+    await db.query(`UPDATE _gridlite_views SET is_default = false WHERE grid_id = $1`, [gridId]);
+    // Set new default
+    await db.query(`UPDATE _gridlite_views SET is_default = true WHERE id = $1 AND grid_id = $2`, [viewId, gridId]);
+}
+/**
+ * Delete a view by ID.
+ */
+export async function deleteView(db, viewId) {
+    // Also clean up associated column state
+    await db.query(`DELETE FROM _gridlite_column_state WHERE view_id = $1`, [viewId]);
+    await db.query(`DELETE FROM _gridlite_views WHERE id = $1`, [viewId]);
+}
+// ─── Column State CRUD ──────────────────────────────────────────────────────
+/**
+ * Save column state for a grid (optionally scoped to a view).
+ * Replaces all existing column state for the given grid+view.
+ */
+export async function saveColumnState(db, gridId, columns, viewId = '__default__') {
+    // Clear existing state for this grid+view
+    await db.query(`DELETE FROM _gridlite_column_state WHERE grid_id = $1 AND view_id = $2`, [gridId, viewId]);
+    // Insert new state
+    for (const col of columns) {
+        await db.query(`INSERT INTO _gridlite_column_state (grid_id, view_id, column_name, visible, width, position)
+			 VALUES ($1, $2, $3, $4, $5, $6)`, [
+            gridId,
+            viewId,
+            col.name,
+            col.visible ?? true,
+            col.width ?? null,
+            col.position ?? null
+        ]);
+    }
+}
+/**
+ * Load column state for a grid (optionally scoped to a view).
+ */
+export async function loadColumnState(db, gridId, viewId = '__default__') {
+    const result = await db.query(`SELECT * FROM _gridlite_column_state
+		 WHERE grid_id = $1 AND view_id = $2
+		 ORDER BY position NULLS LAST, column_name`, [gridId, viewId]);
+    return result.rows.map((row) => ({
+        name: row.column_name,
+        visible: row.visible,
+        width: row.width,
+        position: row.position
+    }));
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function rowToViewPreset(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        description: row.description ?? undefined,
+        filters: row.filters,
+        filterLogic: row.filter_logic,
+        sorting: row.sorting,
+        grouping: row.grouping,
+        columnVisibility: row.column_visibility,
+        columnOrder: row.column_order
+    };
+}