sqlite-hub 1.2.0 → 1.5.0

package/docs/guidelines/DESIGN.md

@@ -0,0 +1,55 @@
+# SQLite Hub UI Rules for Codex
+
+Follow these rules exactly when creating or modifying UI controls.
+
+1. Reuse existing shared components before creating anything new.
+2. Use exactly one semantic main class per control.
+3. Never combine multiple primary button-style classes (`standard-button`, `signature-button`, `delete-button`) on the same element.
+4. View-specific classes may change layout, width, spacing, or position only.
+5. View-specific classes must not redefine the base style of shared components.
+6. The standard height for buttons and compact interactive controls is `32px`.
+7. The source of truth for button height is `--button-height` in `frontend/styles/tokens.css`.
+8. The source of truth for form control height is `--control-height` in `frontend/styles/tokens.css`.
+9. Controls in the same row must have the same height unless one is a text input or textarea.
+10. All regular buttons must use one of these base classes only: `standard-button`, `signature-button`, `delete-button`.
+11. Use `standard-button` for normal actions.
+12. Use `signature-button` only for the primary yellow CTA in a context.
+13. Use `delete-button` only for destructive actions.
+14. Delete buttons must show the `delete` Material Symbol before the text label.
+15. `signature-button` must keep its hover state and chamfered corner.
+16. All visible clickable buttons must have a hover state.
+17. Disabled states must come from the shared component, not from local view CSS.
+18. Dropdown toggles may combine a base button class with `dropdown-button__toggle`; that class may only control dropdown layout and open-state behavior.
+19. Visibility/toggle buttons may combine a base button class with `panel-toggle-button`; that class is the shared toggle-state modifier.
+20. All reusable checkboxes must use `standard-checkbox`.
+21. Do not build feature-specific checkbox shells or checkbox base styles.
+22. Inputs and selects must follow the shared base rules in `frontend/styles/base.css`.
+23. Ghost or transparent inputs must not use a white background, including unfocused state.
+24. When a new control pattern appears in multiple places, promote it to a shared component first, then migrate existing usages.
+
+## Source of Truth
+
+- `frontend/styles/tokens.css`
+- `frontend/styles/base.css`
+- `frontend/index.html`
+
+## Default Decision Rules
+
+- Prefer reuse over invention.
+- Prefer migration over local override.
+- Prefer shared component updates over per-view fixes.
+
+## UX behavior
+
+- All drawers must close with `Escape`.
+- All modal windows must close with `Escape`.
+- Open dropdowns and menu popovers must close with `Escape`.
+- Focused text-like input elements must clear their value with `Escape` before any parent drawer, modal, dropdown, or selection state handles the key.
+- Search inputs must clear with `Escape` and dispatch the same input/update behavior as manual clearing.
+- Do not clear multiline textareas with `Escape` unless the textarea is explicitly built as a search field.
+- If an input is already empty, `Escape` may continue to the next applicable close/clear behavior.
+
+## History elements
+
+- Query history panels, such as SQL Editor and Charts history, are always placed on the right side.
+- Subnavigation panels, such as tables, documents, structure objects, and table-designer tables, are always placed on the left side.

package/docs/shortkeys.md

@@ -0,0 +1,27 @@
+# Meddia Tagging
+
+## tagging queue
+
+`shift + enter` triggers tagged & next
+
+# SQL Editor
+
+`shift + enter` triggers execute
+
+## Chart Details & Query Details (drawer)
+
+`esc` closes the drawer
+
+# Misc
+
+## Modals
+
+`esc` closes the modal
+
+## Input elements
+
+`esc` clears the input
+
+## Dropdown Buttons
+
+`esc` closes the dropwdown

package/docs/todo.md

@@ -0,0 +1,4 @@
+# Maybe
+
+- Data Pipeline Light/hook, programmable triggers?
+- MCP

package/examples/api/generate-types.js

@@ -0,0 +1,52 @@
+const SQLITE_HUB_URL = process.env.SQLITE_HUB_URL || 'http://127.0.0.1:4173';
+const apiToken = process.env.SQLITE_HUB_API_TOKEN;
+const databaseId = process.env.SQLITE_HUB_DATABASE_ID || process.argv[2];
+const tableName = process.env.SQLITE_HUB_TABLE || process.argv[3] || 'users';
+const target = process.env.SQLITE_HUB_TYPE_TARGET || process.argv[4] || 'typescript';
+
+if (!apiToken) {
+    throw new Error('SQLITE_HUB_API_TOKEN is required.');
+}
+
+if (!databaseId) {
+    throw new Error('Provide SQLITE_HUB_DATABASE_ID or pass the database id as the first argument.');
+}
+
+const url = [
+    SQLITE_HUB_URL.replace(/\/$/, ''),
+    'api/v1/databases',
+    encodeURIComponent(databaseId),
+    'tables',
+    encodeURIComponent(tableName),
+    'types',
+].join('/');
+
+const response = await fetch(url, {
+    method: 'POST',
+    headers: {
+        Accept: 'application/json',
+        Authorization: `Bearer ${apiToken}`,
+        'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+        target,
+        options: {
+            propertyNaming: 'camel',
+            nullableMode: 'native',
+            includeComments: true,
+            includeDefaultsAsComments: true,
+        },
+    }),
+});
+
+const payload = await response.json();
+
+if (!response.ok || !payload.success) {
+    throw new Error(payload.error?.message || payload.message || 'Type generation failed.');
+}
+
+console.log(payload.data.code);
+
+if (payload.warnings?.length) {
+    console.error(payload.warnings.map(warning => `Warning: ${warning}`).join('\n'));
+}

package/frontend/js/api.js

@@ -153,6 +153,17 @@ export function getBackup(backupId) {
   return request(`/api/backups/${encodeURIComponent(backupId)}`);
 }
 
+export function getBackupDiff(backupId, options = {}) {
+  const params = new URLSearchParams();
+
+  if (options.sampleLimit !== undefined) {
+    params.set("sampleLimit", String(options.sampleLimit));
+  }
+
+  const query = params.toString();
+  return request(`/api/backups/${encodeURIComponent(backupId)}/diff${query ? `?${query}` : ""}`);
+}
+
 export function createBackup(payload = {}) {
   return request("/api/backups", {
     method: "POST",
@@ -205,6 +216,33 @@ export function getDbStatus() {
   return request("/api/db/status");
 }
 
+export function getLogs(options = {}) {
+  const params = new URLSearchParams();
+
+  [
+    "kind",
+    "range",
+    "actor",
+    "status",
+    "queryType",
+    "destructive",
+    "from",
+    "to",
+    "search",
+    "limit",
+    "offset",
+  ].forEach((key) => {
+    const value = options[key];
+
+    if (value !== undefined && value !== null && value !== "") {
+      params.set(key, String(value));
+    }
+  });
+
+  const query = params.toString();
+  return request(`/api/logs${query ? `?${query}` : ""}`);
+}
+
 export function executeSql(sql) {
   return request("/api/sql/execute", {
     method: "POST",
@@ -340,6 +378,13 @@ export function getStructureDetail(tableName) {
   return request(`/api/structure/${encodeURIComponent(tableName)}`);
 }
 
+export function generateStructureTypes(tableName, payload = {}) {
+  return request(`/api/structure/${encodeURIComponent(tableName)}/types`, {
+    method: "POST",
+    body: payload,
+  });
+}
+
 export function getTableDesignerOverview() {
   return request("/api/table-designer");
 }
@@ -452,6 +497,10 @@ export function getDataTable(tableName, options = {}) {
   return request(`/api/data/${encodeURIComponent(tableName)}${query ? `?${query}` : ""}`);
 }
 
+export function analyzeTableAdvisor(tableName) {
+  return request(`/api/data/${encodeURIComponent(tableName)}/advisor`);
+}
+
 export function getDataTableRow(tableName, payload) {
   return request(`/api/data/${encodeURIComponent(tableName)}/row`, {
     method: "POST",
@@ -473,6 +522,20 @@ export function previewDataTableRowUpdate(tableName, payload) {
   });
 }
 
+export function previewSyntheticDataRows(tableName, payload) {
+  return request(`/api/data/${encodeURIComponent(tableName)}/generate/preview`, {
+    method: "POST",
+    body: payload,
+  });
+}
+
+export function insertSyntheticDataRows(tableName, payload) {
+  return request(`/api/data/${encodeURIComponent(tableName)}/generate/insert`, {
+    method: "POST",
+    body: payload,
+  });
+}
+
 export function deleteDataTableRow(tableName, payload) {
   return request(`/api/data/${encodeURIComponent(tableName)}/rows`, {
     method: "DELETE",