@rozenite/sqlite-plugin 1.13.0 → 2.1.0

package/src/ui/sqlite-drop-mutations.ts

@@ -0,0 +1,53 @@
+import { quoteSqlIdentifier } from '../shared/sql';
+import type { SqliteEntity } from './sqlite-introspection';
+
+export type SqliteDropTarget = Pick<SqliteEntity, 'schemaName' | 'name' | 'type'>;
+
+const buildQualifiedEntityName = (schemaName: string, entityName: string) =>
+  `${quoteSqlIdentifier(schemaName)}.${quoteSqlIdentifier(entityName)}`;
+
+/**
+ * Builds a single `DROP TABLE` / `DROP VIEW` statement for the given entity.
+ * Identifiers are quoted (never parameterized, since SQLite does not support
+ * parameter binding for identifiers), so this is the only place that needs to
+ * get quoting right.
+ */
+export const buildDropEntitySql = (entity: SqliteDropTarget): string => {
+  const keyword = entity.type === 'view' ? 'VIEW' : 'TABLE';
+  return `DROP ${keyword} ${buildQualifiedEntityName(entity.schemaName, entity.name)}`;
+};
+
+/**
+ * Orders entities so that views are dropped before tables, preserving the
+ * relative order within each group. This keeps a view that references a
+ * table from ever being left dangling mid-sweep.
+ */
+export const orderEntitiesForDrop = (entities: SqliteDropTarget[]): SqliteDropTarget[] => [
+  ...entities.filter((entity) => entity.type === 'view'),
+  ...entities.filter((entity) => entity.type === 'table'),
+];
+
+/**
+ * Builds the full drop-everything script for a database sweep: every view,
+ * then every table, each as its own statement. Returns an empty string when
+ * there is nothing to drop.
+ */
+export const buildDropAllEntitiesSql = (entities: SqliteDropTarget[]): string =>
+  orderEntitiesForDrop(entities)
+    .map((entity) => `${buildDropEntitySql(entity)};`)
+    .join('\n');
+
+export const SQLITE_READ_FOREIGN_KEYS_SQL = 'PRAGMA foreign_keys';
+
+/**
+ * `PRAGMA foreign_keys` is per-connection and not parameterizable; the value
+ * is always a literal 0/1 keyword, never user input, so this is safe to
+ * inline directly.
+ */
+export const buildSetForeignKeysSql = (enabled: boolean): string =>
+  `PRAGMA foreign_keys = ${enabled ? 'ON' : 'OFF'}`;
+
+export const isForeignKeysEnabled = (rows: Record<string, unknown>[]): boolean => {
+  const rawValue = rows[0]?.foreign_keys;
+  return Number(rawValue) === 1;
+};

package/src/ui/sqlite-introspection.ts

@@ -54,13 +54,10 @@ export type SqliteIndexColumnInfo = {
 const buildQualifiedEntityName = (schemaName: string, entityName: string) =>
   `${quoteSqlIdentifier(schemaName)}.${quoteSqlIdentifier(entityName)}`;
 
-const buildPragmaPrefix = (schemaName: string) =>
-  `${quoteSqlIdentifier(schemaName)}.`;
+const buildPragmaPrefix = (schemaName: string) => `${quoteSqlIdentifier(schemaName)}.`;
 
-const asString = (value: unknown) =>
-  typeof value === 'string' ? value : String(value ?? '');
-const asNullableString = (value: unknown) =>
-  value == null ? null : String(value);
+const asString = (value: unknown) => (typeof value === 'string' ? value : String(value ?? ''));
+const asNullableString = (value: unknown) => (value == null ? null : String(value));
 const asNumber = (value: unknown) => {
   const parsed = Number(value ?? 0);
   return Number.isNaN(parsed) ? 0 : parsed;
@@ -93,10 +90,7 @@ export const buildBrowseEntitySql = (
 export const buildEntityCountSql = (schemaName: string, entityName: string) =>
   `SELECT COUNT(*) AS count FROM ${buildQualifiedEntityName(schemaName, entityName)}`;
 
-export const buildCreateSqlLookup = (
-  schemaName: string,
-  entityName: string,
-) => `
+export const buildCreateSqlLookup = (schemaName: string, entityName: string) => `
 SELECT sql
 FROM ${quoteSqlIdentifier(schemaName)}.sqlite_schema
 WHERE type IN ('table', 'view')
@@ -125,17 +119,12 @@ export const parseSchemas = (result: SqliteQueryResult): SqliteSchema[] =>
     }))
     .filter((schema) => !!schema.name);
 
-export const parseEntities = (
-  result: SqliteQueryResult,
-  schemaName: string,
-): SqliteEntity[] =>
+export const parseEntities = (result: SqliteQueryResult, schemaName: string): SqliteEntity[] =>
   result.rows
     .map((row) => ({
       schemaName,
       name: asString(row.name),
-      type: (asString(row.type) === 'view'
-        ? 'view'
-        : 'table') as SqliteEntityType,
+      type: (asString(row.type) === 'view' ? 'view' : 'table') as SqliteEntityType,
       sql: asNullableString(row.sql),
     }))
     .filter((entity) => !!entity.name);
@@ -151,9 +140,7 @@ export const parseColumns = (result: SqliteQueryResult): SqliteColumnInfo[] =>
     hidden: asNumber(row.hidden),
   }));
 
-export const parseForeignKeys = (
-  result: SqliteQueryResult,
-): SqliteForeignKeyInfo[] =>
+export const parseForeignKeys = (result: SqliteQueryResult): SqliteForeignKeyInfo[] =>
   result.rows.map((row) => ({
     id: asNumber(row.id),
     seq: asNumber(row.seq),
@@ -174,9 +161,7 @@ export const parseIndexes = (result: SqliteQueryResult): SqliteIndexInfo[] =>
     partial: asNumber(row.partial) === 1,
   }));
 
-export const parseIndexColumns = (
-  result: SqliteQueryResult,
-): SqliteIndexColumnInfo[] =>
+export const parseIndexColumns = (result: SqliteQueryResult): SqliteIndexColumnInfo[] =>
   result.rows
     .map((row) => ({
       seqno: asNumber(row.seqno),
@@ -185,5 +170,4 @@ export const parseIndexColumns = (
     }))
     .filter((column) => !!column.name);
 
-export const parseCount = (result: SqliteQueryResult) =>
-  asNumber(result.rows[0]?.count);
+export const parseCount = (result: SqliteQueryResult) => asNumber(result.rows[0]?.count);

package/src/ui/sqlite-row-delete-modal.tsx

@@ -1,10 +1,7 @@
 import { Modal, useOverlayState } from '@heroui/react';
 import { AlertTriangle, Trash2 } from 'lucide-react';
 import { useEffect, useState } from 'react';
-import {
-  SqliteModalCloseButton,
-  sqliteSecondaryButtonClassName,
-} from './sqlite-modal-controls';
+import { SqliteModalCloseButton, sqliteSecondaryButtonClassName } from './sqlite-modal-controls';
 
 type SqliteRowDeleteModalProps = {
   isOpen: boolean;
@@ -50,9 +47,7 @@ export const SqliteRowDeleteModal = ({
       await onDelete();
       onClose();
     } catch (nextError) {
-      setError(
-        nextError instanceof Error ? nextError.message : String(nextError),
-      );
+      setError(nextError instanceof Error ? nextError.message : String(nextError));
     } finally {
       setDeleting(false);
     }
@@ -76,9 +71,7 @@ export const SqliteRowDeleteModal = ({
                   <AlertTriangle aria-hidden="true" className="h-5 w-5" />
                 </div>
                 <div>
-                  <h2 className="text-lg font-semibold text-white">
-                    Delete Row {rowNumber}
-                  </h2>
+                  <h2 className="text-lg font-semibold text-white">Delete Row {rowNumber}</h2>
                   <p className="mt-1 text-sm text-slate-400">{entityName}</p>
                 </div>
               </div>
@@ -88,8 +81,8 @@ export const SqliteRowDeleteModal = ({
             <Modal.Body className="space-y-0 p-0">
               <div className="space-y-5 px-5 py-5">
                 <p className="text-sm leading-6 text-slate-300">
-                  This will permanently delete the selected row and immediately
-                  refetch the current page.
+                  This will permanently delete the selected row and immediately refetch the current
+                  page.
                 </p>
 
                 {error ? (

package/src/ui/sqlite-row-edit-modal.tsx

@@ -74,10 +74,7 @@ const stringifyDraftValue = (value: unknown, kind: EditableValueKind) => {
   return String(value);
 };
 
-const createFieldDraft = (
-  column: SqliteColumnInfo,
-  value: unknown,
-): EditableFieldDraft => {
+const createFieldDraft = (column: SqliteColumnInfo, value: unknown): EditableFieldDraft => {
   const compatibleKinds = getCompatibleValueKinds(column, value);
   const kind = compatibleKinds[0] ?? 'text';
 
@@ -104,10 +101,7 @@ export const SqliteRowEditModal = ({
       }
     },
   });
-  const primaryKeyColumns = useMemo(
-    () => getPrimaryKeyColumns(columns),
-    [columns],
-  );
+  const primaryKeyColumns = useMemo(() => getPrimaryKeyColumns(columns), [columns]);
   const editableColumns = useMemo(() => getEditableColumns(columns), [columns]);
   const [drafts, setDrafts] = useState<Record<string, EditableFieldDraft>>({});
   const [submitting, setSubmitting] = useState(false);
@@ -123,10 +117,7 @@ export const SqliteRowEditModal = ({
 
     setDrafts(
       Object.fromEntries(
-        editableColumns.map((column) => [
-          column.name,
-          createFieldDraft(column, row[column.name]),
-        ]),
+        editableColumns.map((column) => [column.name, createFieldDraft(column, row[column.name])]),
       ),
     );
     setSubmitting(false);
@@ -134,9 +125,7 @@ export const SqliteRowEditModal = ({
   }, [editableColumns, isOpen, row]);
 
   const handleKindChange = (columnName: string, kind: EditableValueKind) => {
-    const column = editableColumns.find(
-      (candidate) => candidate.name === columnName,
-    );
+    const column = editableColumns.find((candidate) => candidate.name === columnName);
 
     setDrafts((current) => ({
       ...current,
@@ -151,16 +140,12 @@ export const SqliteRowEditModal = ({
                 ? '{}'
                 : kind === 'null'
                   ? ''
-                  : kind === 'number' &&
-                      current[columnName]?.rawValue === 'true'
+                  : kind === 'number' && current[columnName]?.rawValue === 'true'
                     ? '1'
-                    : kind === 'number' &&
-                        current[columnName]?.rawValue === 'false'
+                    : kind === 'number' && current[columnName]?.rawValue === 'false'
                       ? '0'
                       : (current[columnName]?.rawValue ??
-                        (column
-                          ? createFieldDraft(column, null).rawValue
-                          : '')),
+                        (column ? createFieldDraft(column, null).rawValue : '')),
       },
     }));
   };
@@ -186,9 +171,7 @@ export const SqliteRowEditModal = ({
       await onSave(nextValues);
       onClose();
     } catch (nextError) {
-      setError(
-        nextError instanceof Error ? nextError.message : String(nextError),
-      );
+      setError(nextError instanceof Error ? nextError.message : String(nextError));
     } finally {
       setSubmitting(false);
     }
@@ -210,9 +193,7 @@ export const SqliteRowEditModal = ({
               <div>
                 <div className="flex items-center gap-2">
                   <Pencil aria-hidden="true" className="h-4 w-4 text-sky-300" />
-                  <h2 className="text-lg font-semibold text-white">
-                    Edit Row {rowNumber}
-                  </h2>
+                  <h2 className="text-lg font-semibold text-white">Edit Row {rowNumber}</h2>
                 </div>
                 <p className="mt-1 text-sm text-slate-400">{entityName}</p>
               </div>
@@ -224,12 +205,9 @@ export const SqliteRowEditModal = ({
                 {primaryKeyColumns.length > 0 ? (
                   <section className="space-y-3">
                     <div>
-                      <h3 className="text-sm font-medium text-slate-200">
-                        Row Identifier
-                      </h3>
+                      <h3 className="text-sm font-medium text-slate-200">Row Identifier</h3>
                       <p className="mt-1 text-xs text-slate-400">
-                        Primary-key fields are shown for reference and cannot be
-                        edited.
+                        Primary-key fields are shown for reference and cannot be edited.
                       </p>
                     </div>
                     <div className="grid gap-3 md:grid-cols-2">
@@ -240,16 +218,12 @@ export const SqliteRowEditModal = ({
                         >
                           <div className="flex items-center justify-between gap-3">
                             <div>
-                              <p className="text-sm font-medium text-white">
-                                {column.name}
-                              </p>
+                              <p className="text-sm font-medium text-white">{column.name}</p>
                               <p className="text-xs uppercase tracking-[0.24em] text-slate-500">
                                 {column.type || 'value'}
                               </p>
                             </div>
-                            <span className="sqlite-chip sqlite-chip-static">
-                              PK
-                            </span>
+                            <span className="sqlite-chip sqlite-chip-static">PK</span>
                           </div>
                           <p className="mt-3 break-all font-mono text-sm text-slate-200">
                             {getValuePreview(row?.[column.name])}
@@ -265,36 +239,27 @@ export const SqliteRowEditModal = ({
 
                 <section className="space-y-3">
                   <div>
-                    <h3 className="text-sm font-medium text-slate-200">
-                      Editable Values
-                    </h3>
+                    <h3 className="text-sm font-medium text-slate-200">Editable Values</h3>
                     <p className="mt-1 text-xs text-slate-400">
-                      Update any non-primary-key column and save to write the
-                      row back to SQLite.
+                      Update any non-primary-key column and save to write the row back to SQLite.
                     </p>
                   </div>
 
                   {editableColumns.length === 0 ? (
                     <div className="rounded-2xl border border-white/8 bg-white/[0.03] p-4 text-sm text-slate-300">
-                      This row does not expose editable, non-primary-key
-                      columns.
+                      This row does not expose editable, non-primary-key columns.
                     </div>
                   ) : (
                     <div className="space-y-4">
                       {editableColumns.map((column) => {
                         const draft =
-                          drafts[column.name] ??
-                          createFieldDraft(column, row?.[column.name]);
-                        const compatibleKinds = getCompatibleValueKinds(
-                          column,
-                          row?.[column.name],
-                        );
+                          drafts[column.name] ?? createFieldDraft(column, row?.[column.name]);
+                        const compatibleKinds = getCompatibleValueKinds(column, row?.[column.name]);
                         const allowNull = canColumnBeNull(column);
                         const shouldUseTextArea =
                           draft.kind === 'blob-ish' ||
                           draft.kind === 'json' ||
-                          (draft.kind === 'text' &&
-                            draft.rawValue.includes('\n'));
+                          (draft.kind === 'text' && draft.rawValue.includes('\n'));
 
                         return (
                           <div
@@ -347,9 +312,7 @@ export const SqliteRowEditModal = ({
                                                 : 'Text'}
                                       </option>
                                     ))}
-                                    {allowNull ? (
-                                      <option value="null">NULL</option>
-                                    ) : null}
+                                    {allowNull ? <option value="null">NULL</option> : null}
                                   </select>
                                 </div>
                               ) : (
@@ -428,16 +391,11 @@ export const SqliteRowEditModal = ({
                             </div>
 
                             <p className="mt-2 text-xs text-slate-500">
-                              Current value:{' '}
-                              {getValuePreview(row?.[column.name])} (
+                              Current value: {getValuePreview(row?.[column.name])} (
                               {getValueKind(row?.[column.name])}) · Compatible:{' '}
                               {compatibleKinds
                                 .map((kind) =>
-                                  kind === 'blob-ish'
-                                    ? 'blob'
-                                    : kind === 'json'
-                                      ? 'json'
-                                      : kind,
+                                  kind === 'blob-ish' ? 'blob' : kind === 'json' ? 'json' : kind,
                                 )
                                 .join(', ')}
                               {allowNull ? ', null' : ''}

package/src/ui/sqlite-row-edit-value.ts

@@ -1,10 +1,4 @@
-export type EditableValueKind =
-  | 'null'
-  | 'text'
-  | 'number'
-  | 'boolean'
-  | 'blob-ish'
-  | 'json';
+export type EditableValueKind = 'null' | 'text' | 'number' | 'boolean' | 'blob-ish' | 'json';
 
 export type EditableFieldDraft = {
   kind: EditableValueKind;
@@ -36,10 +30,7 @@ export const parseEditableFieldValue = (draft: EditableFieldDraft): unknown => {
     case 'blob-ish': {
       const parsed = JSON.parse(draft.rawValue);
 
-      if (
-        !Array.isArray(parsed) ||
-        !parsed.every((item) => typeof item === 'number')
-      ) {
+      if (!Array.isArray(parsed) || !parsed.every((item) => typeof item === 'number')) {
         throw new Error('Blob values must be JSON arrays of numbers.');
       }
 

package/src/ui/sqlite-row-mutations.ts

@@ -9,12 +9,7 @@ const SQLITE_ROWID_IDENTIFIERS = ['rowid', '_rowid_', 'oid'] as const;
 
 export type SqliteRowIdIdentifier = (typeof SQLITE_ROWID_IDENTIFIERS)[number];
 
-export type SqliteEditableValueKind =
-  | 'text'
-  | 'number'
-  | 'boolean'
-  | 'blob-ish'
-  | 'json';
+export type SqliteEditableValueKind = 'text' | 'number' | 'boolean' | 'blob-ish' | 'json';
 
 export type SqliteRowMutationDescriptor =
   | {
@@ -57,16 +52,11 @@ export const getPrimaryKeyColumns = (columns: SqliteColumnInfo[]) =>
     .sort((left, right) => left.primaryKeyOrder - right.primaryKeyOrder);
 
 export const getEditableColumns = (columns: SqliteColumnInfo[]) =>
-  columns.filter(
-    (column) => column.primaryKeyOrder === 0 && column.hidden === 0,
-  );
+  columns.filter((column) => column.primaryKeyOrder === 0 && column.hidden === 0);
 
-const getNormalizedColumnType = (column: SqliteColumnInfo) =>
-  column.type.trim().toLowerCase();
+const getNormalizedColumnType = (column: SqliteColumnInfo) => column.type.trim().toLowerCase();
 
-const inferValueKindFromRuntimeValue = (
-  value: unknown,
-): SqliteEditableValueKind => {
+const inferValueKindFromRuntimeValue = (value: unknown): SqliteEditableValueKind => {
   if (typeof value === 'number') {
     return 'number';
   }
@@ -76,9 +66,7 @@ const inferValueKindFromRuntimeValue = (
   }
 
   if (Array.isArray(value)) {
-    return value.every((item) => typeof item === 'number')
-      ? 'blob-ish'
-      : 'json';
+    return value.every((item) => typeof item === 'number') ? 'blob-ish' : 'json';
   }
 
   if (value && typeof value === 'object') {
@@ -135,14 +123,10 @@ export const canColumnBeNull = (column: SqliteColumnInfo) => !column.notNull;
 export const getAvailableRowIdIdentifier = (
   columns: SqliteColumnInfo[],
 ): SqliteRowIdIdentifier | null => {
-  const lowerCaseColumnNames = new Set(
-    columns.map((column) => column.name.toLowerCase()),
-  );
+  const lowerCaseColumnNames = new Set(columns.map((column) => column.name.toLowerCase()));
 
   return (
-    SQLITE_ROWID_IDENTIFIERS.find(
-      (identifier) => !lowerCaseColumnNames.has(identifier),
-    ) ?? null
+    SQLITE_ROWID_IDENTIFIERS.find((identifier) => !lowerCaseColumnNames.has(identifier)) ?? null
   );
 };
 
@@ -182,9 +166,7 @@ const buildWhereClause = (
   descriptor: SqliteRowMutationDescriptor,
 ) => {
   if (descriptor.mode === 'primary-key') {
-    const params = descriptor.primaryKeyColumns.map(
-      (column) => row[column.name],
-    );
+    const params = descriptor.primaryKeyColumns.map((column) => row[column.name]);
     const clause = descriptor.primaryKeyColumns
       .map((column) => `${quoteSqlIdentifier(column.name)} = ?`)
       .join(' AND ');
@@ -210,9 +192,7 @@ export const buildRowUpdateMutation = ({
 }: BuildRowUpdateMutationInput): SqliteMutationResult => {
   const updateColumnNames = getEditableColumns(columns)
     .map((column) => column.name)
-    .filter((columnName) =>
-      Object.prototype.hasOwnProperty.call(nextValues, columnName),
-    );
+    .filter((columnName) => Object.prototype.hasOwnProperty.call(nextValues, columnName));
 
   if (updateColumnNames.length === 0) {
     throw new Error('No editable columns are available for this row.');
@@ -221,9 +201,7 @@ export const buildRowUpdateMutation = ({
   const assignments = updateColumnNames.map(
     (columnName) => `${quoteSqlIdentifier(columnName)} = ?`,
   );
-  const assignmentParams = updateColumnNames.map(
-    (columnName) => nextValues[columnName],
-  );
+  const assignmentParams = updateColumnNames.map((columnName) => nextValues[columnName]);
   const where = buildWhereClause(row, descriptor);
 
   return {

package/src/ui/sqlite-table-column-order.ts

@@ -17,13 +17,8 @@ type ReorderTableColumnOrderInput = NormalizeTableColumnOrderInput & {
   overColumnId: string;
 };
 
-const applyUpdater = <TValue>(
-  updater: Updater<TValue>,
-  currentValue: TValue,
-): TValue =>
-  typeof updater === 'function'
-    ? (updater as (old: TValue) => TValue)(currentValue)
-    : updater;
+const applyUpdater = <TValue>(updater: Updater<TValue>, currentValue: TValue): TValue =>
+  typeof updater === 'function' ? (updater as (old: TValue) => TValue)(currentValue) : updater;
 
 export const getDefaultTableColumnOrder = (
   columnIds: string[],
@@ -95,9 +90,7 @@ export const reorderTableColumnOrder = ({
     return normalizedOrder;
   }
 
-  const movableColumnOrder = normalizedOrder.filter(
-    (columnId) => !fixedColumnIds.has(columnId),
-  );
+  const movableColumnOrder = normalizedOrder.filter((columnId) => !fixedColumnIds.has(columnId));
   const activeIndex = movableColumnOrder.indexOf(activeColumnId);
   const overIndex = movableColumnOrder.indexOf(overColumnId);
 
@@ -131,24 +124,16 @@ export const resolveTableColumnOrderUpdate = ({
   });
 };
 
-export const areColumnOrdersEqual = (
-  leftColumnOrder: string[],
-  rightColumnOrder: string[],
-) =>
+export const areColumnOrdersEqual = (leftColumnOrder: string[], rightColumnOrder: string[]) =>
   leftColumnOrder.length === rightColumnOrder.length &&
-  leftColumnOrder.every(
-    (columnId, columnIndex) => columnId === rightColumnOrder[columnIndex],
-  );
+  leftColumnOrder.every((columnId, columnIndex) => columnId === rightColumnOrder[columnIndex]);
 
 export const buildEntityTableId = (
   scope: 'data' | 'structure-columns' | 'structure-indexes',
   databaseId: string | null,
   schemaName: string | null,
   entityName: string | null,
-) =>
-  `${scope}:${databaseId ?? 'unknown'}:${schemaName ?? 'unknown'}:${entityName ?? 'unknown'}`;
+) => `${scope}:${databaseId ?? 'unknown'}:${schemaName ?? 'unknown'}:${entityName ?? 'unknown'}`;
 
-export const buildQueryTableId = (
-  databaseId: string | null,
-  columnIds: string[],
-) => `query:${databaseId ?? 'unknown'}:${JSON.stringify(columnIds)}`;
+export const buildQueryTableId = (databaseId: string | null, columnIds: string[]) =>
+  `query:${databaseId ?? 'unknown'}:${JSON.stringify(columnIds)}`;