sqlite-hub 1.2.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/README.md +113 -71
  2. package/bin/sqlite-hub.js +723 -116
  3. package/docs/API.md +152 -0
  4. package/docs/CLI.md +249 -0
  5. package/docs/CLI_API_PARITY.md +61 -0
  6. package/docs/changelog.md +149 -0
  7. package/docs/guidelines/AGENTS.md +32 -0
  8. package/docs/guidelines/DESIGN.md +55 -0
  9. package/docs/shortkeys.md +27 -0
  10. package/docs/todo.md +4 -0
  11. package/examples/api/generate-types.js +52 -0
  12. package/frontend/assets/mockups/backups_1_1920.webp +0 -0
  13. package/frontend/assets/mockups/backups_2_create_backup_modal_1920.webp +0 -0
  14. package/frontend/assets/mockups/backups_3_edit_backup_modal_1920.webp +0 -0
  15. package/frontend/assets/mockups/backups_4_restore_backup_modal_1920.webp +0 -0
  16. package/frontend/assets/mockups/backups_5_delete_backup_modal_1920.webp +0 -0
  17. package/frontend/assets/mockups/charts_1_1920.webp +0 -0
  18. package/frontend/assets/mockups/charts_2_query_detail_1920.webp +0 -0
  19. package/frontend/assets/mockups/charts_3_create_query_chart_modal_1920.webp +0 -0
  20. package/frontend/assets/mockups/charts_4_edit_query_chart_modal_1920.webp +0 -0
  21. package/frontend/assets/mockups/charts_5_delete_query_chart_modal_1920.webp +0 -0
  22. package/frontend/assets/mockups/charts_6_copy_column_modal_1920.webp +0 -0
  23. package/frontend/assets/mockups/connections_1_1920.webp +0 -0
  24. package/frontend/assets/mockups/connections_2_create_connection_modal_1920.webp +0 -0
  25. package/frontend/assets/mockups/connections_3_open_connection_modal_1920.webp +0 -0
  26. package/frontend/assets/mockups/data_1_1920.webp +0 -0
  27. package/frontend/assets/mockups/data_2_roweditor_1920.webp +0 -0
  28. package/frontend/assets/mockups/data_3_data_export_modal_1920.webp +0 -0
  29. package/frontend/assets/mockups/documents_1_1920.webp +0 -0
  30. package/frontend/assets/mockups/documents_2_document_insert_table_modal_1920.webp +0 -0
  31. package/frontend/assets/mockups/documents_3_document_insert_note_modal_1920.webp +0 -0
  32. package/frontend/assets/mockups/media_tagging_queue_1_1920.webp +0 -0
  33. package/frontend/assets/mockups/media_tagging_setup_1_1920.webp +0 -0
  34. package/frontend/assets/mockups/media_tagging_setup_2_create_media_tagging_tag_table_modal_1920.webp +0 -0
  35. package/frontend/assets/mockups/media_tagging_setup_3_create_media_tagging_mapping_table_modal_1920.webp +0 -0
  36. package/frontend/assets/mockups/overview_1_1920.webp +0 -0
  37. package/frontend/assets/mockups/settings_1_1920.webp +0 -0
  38. package/frontend/assets/mockups/sql_editor_1_1920.webp +0 -0
  39. package/frontend/assets/mockups/sql_editor_2_query_detail_1920.webp +0 -0
  40. package/frontend/assets/mockups/sql_editor_3_query_export_modal_1920.webp +0 -0
  41. package/frontend/assets/mockups/structure_1_1920.webp +0 -0
  42. package/frontend/assets/mockups/structure_2_generate_types_modal_1920.webp +0 -0
  43. package/frontend/assets/mockups/structure_3_generate_types_modal_1920.webp +0 -0
  44. package/frontend/assets/mockups/table_designer_1_1920.webp +0 -0
  45. package/frontend/assets/mockups/table_designer_2_table_designer_constraints_modal_1920.webp +0 -0
  46. package/frontend/js/api.js +63 -0
  47. package/frontend/js/app.js +310 -10
  48. package/frontend/js/components/connectionCard.js +4 -2
  49. package/frontend/js/components/emptyState.js +4 -4
  50. package/frontend/js/components/generateTypesDropdown.js +33 -0
  51. package/frontend/js/components/metricCard.js +1 -1
  52. package/frontend/js/components/modal.js +555 -21
  53. package/frontend/js/components/pageHeader.js +1 -1
  54. package/frontend/js/components/queryHistoryDetail.js +3 -3
  55. package/frontend/js/components/queryHistoryHeader.js +1 -1
  56. package/frontend/js/components/queryHistoryPanel.js +1 -1
  57. package/frontend/js/components/rowEditorPanel.js +13 -3
  58. package/frontend/js/components/sidebar.js +41 -7
  59. package/frontend/js/components/topNav.js +2 -14
  60. package/frontend/js/router.js +38 -6
  61. package/frontend/js/store.js +870 -8
  62. package/frontend/js/utils/inputClear.js +36 -0
  63. package/frontend/js/utils/syntheticData.js +240 -0
  64. package/frontend/js/views/backups.js +581 -37
  65. package/frontend/js/views/charts.js +9 -9
  66. package/frontend/js/views/connections.js +2 -2
  67. package/frontend/js/views/data.js +17 -1
  68. package/frontend/js/views/documents.js +3 -3
  69. package/frontend/js/views/editor.js +6 -6
  70. package/frontend/js/views/logs.js +339 -0
  71. package/frontend/js/views/mediaTagging.js +7 -5
  72. package/frontend/js/views/overview.js +3 -3
  73. package/frontend/js/views/settings.js +80 -30
  74. package/frontend/js/views/structure.js +12 -1
  75. package/frontend/js/views/tableAdvisor.js +385 -0
  76. package/frontend/js/views/tableDesigner.js +6 -0
  77. package/frontend/styles/base.css +1 -40
  78. package/frontend/styles/components.css +258 -232
  79. package/frontend/styles/structure-graph.css +32 -68
  80. package/frontend/styles/tailwind.css +8 -4
  81. package/frontend/styles/tailwind.generated.css +1 -1
  82. package/frontend/styles/tokens.css +28 -21
  83. package/frontend/styles/views.css +102 -261
  84. package/package.json +18 -2
  85. package/server/routes/backups.js +18 -2
  86. package/server/routes/data.js +45 -0
  87. package/server/routes/externalApi.js +321 -2
  88. package/server/routes/logs.js +127 -0
  89. package/server/routes/structure.js +22 -0
  90. package/server/server.js +3 -0
  91. package/server/services/databaseCommandService.js +59 -0
  92. package/server/services/sqlite/backupDiff.js +914 -0
  93. package/server/services/sqlite/backupService.js +77 -1
  94. package/server/services/sqlite/dataBrowserService.js +36 -0
  95. package/server/services/sqlite/introspection.js +226 -22
  96. package/server/services/sqlite/structureService.js +7 -0
  97. package/server/services/sqlite/syntheticDataGenerator.js +728 -0
  98. package/server/services/sqlite/tableAdvisor.js +790 -0
  99. package/server/services/storage/appStateStore.js +773 -169
  100. package/server/services/typeGenerationService.js +663 -0
  101. package/tailwind.config.cjs +0 -1
  102. package/.github/funding.yml +0 -2
  103. package/.github/workflows/ci.yml +0 -36
  104. package/database.sqlite +0 -0
  105. package/frontend/assets/mockups/charts_1_bars_1200.webp +0 -0
  106. package/frontend/assets/mockups/charts_2_pie_1200.webp +0 -0
  107. package/frontend/assets/mockups/charts_3_scatter_plot_1200.webp +0 -0
  108. package/frontend/assets/mockups/connections_1200.webp +0 -0
  109. package/frontend/assets/mockups/data_1_1200.webp +0 -0
  110. package/frontend/assets/mockups/data_2_row_editor_1200.webp +0 -0
  111. package/frontend/assets/mockups/documents_1200.webp +0 -0
  112. package/frontend/assets/mockups/media_tagging_1_setup_1200.webp +0 -0
  113. package/frontend/assets/mockups/media_tagging_2_tagging_queue_1200.webp +0 -0
  114. package/frontend/assets/mockups/media_tagging_3_media_viewer_1200.webp +0 -0
  115. package/frontend/assets/mockups/overview_1200.webp +0 -0
  116. package/frontend/assets/mockups/settings_1200.webp +0 -0
  117. package/frontend/assets/mockups/sql_editor_1_1200.webp +0 -0
  118. package/frontend/assets/mockups/sql_editor_2_query_details_1200.webp +0 -0
  119. package/frontend/assets/mockups/sql_editor_3_export_column_1200.webp +0 -0
  120. package/frontend/assets/mockups/sql_editor_4_export_column_as_markdown_1200.webp +0 -0
  121. package/frontend/assets/mockups/sql_editor_5_export_query_result_1200.webp +0 -0
  122. package/frontend/assets/mockups/structure_1_1200.webp +0 -0
  123. package/frontend/assets/mockups/structure_2_inspector_1200.webp +0 -0
  124. package/frontend/assets/mockups/table_designer_1_1200.webp +0 -0
  125. package/frontend/assets/mockups/table_designer_2_checks_1200.webp +0 -0
  126. package/tests/api-token-auth.test.js +0 -279
  127. package/tests/backup-manager.test.js +0 -140
  128. package/tests/backups-view.test.js +0 -70
  129. package/tests/charts-height-preset-storage.test.js +0 -60
  130. package/tests/charts-route-state.test.js +0 -144
  131. package/tests/check-constraint-options.test.js +0 -90
  132. package/tests/cli-args.test.js +0 -113
  133. package/tests/cli-service-delegation.test.js +0 -140
  134. package/tests/connection-removal.test.js +0 -52
  135. package/tests/connections-file-dialog-route.test.js +0 -89
  136. package/tests/copy-column-modal.test.js +0 -131
  137. package/tests/database-command-service.test.js +0 -174
  138. package/tests/database-documents.test.js +0 -85
  139. package/tests/documents-view.test.js +0 -132
  140. package/tests/dropdown-button.test.js +0 -101
  141. package/tests/email-preview.test.js +0 -89
  142. package/tests/export-blob.test.js +0 -99
  143. package/tests/export-filenames.test.js +0 -38
  144. package/tests/file-path-preview.test.js +0 -165
  145. package/tests/form-controls.test.js +0 -34
  146. package/tests/json-preview.test.js +0 -49
  147. package/tests/local-request-security.test.js +0 -85
  148. package/tests/markdown-documents.test.js +0 -103
  149. package/tests/native-file-dialog.test.js +0 -105
  150. package/tests/query-editor.test.js +0 -28
  151. package/tests/query-history-detail.test.js +0 -37
  152. package/tests/query-history-header.test.js +0 -30
  153. package/tests/query-results-truncation.test.js +0 -20
  154. package/tests/risky-sql.test.js +0 -30
  155. package/tests/row-editor-json.test.js +0 -82
  156. package/tests/row-editor-null-values.test.js +0 -184
  157. package/tests/row-editor-timestamp-preview.test.js +0 -192
  158. package/tests/security-paths.test.js +0 -84
  159. package/tests/settings-api-tokens-route.test.js +0 -97
  160. package/tests/settings-metadata.test.js +0 -114
  161. package/tests/settings-view.test.js +0 -108
  162. package/tests/sql-formatter.test.js +0 -173
  163. package/tests/sql-highlight.test.js +0 -38
  164. package/tests/sql-identifier-safety.test.js +0 -171
  165. package/tests/sql-result-limit.test.js +0 -66
  166. package/tests/structure-view.test.js +0 -60
  167. package/tests/table-designer-v2-unique-constraints.test.js +0 -78
  168. package/tests/table-scroll-state.test.js +0 -70
  169. package/tests/text-cell-stats.test.js +0 -38
@@ -0,0 +1,36 @@
1
+ const ESCAPE_CLEARABLE_INPUT_TYPES = new Set([
2
+ '',
3
+ 'email',
4
+ 'number',
5
+ 'password',
6
+ 'search',
7
+ 'tel',
8
+ 'text',
9
+ 'url',
10
+ ]);
11
+
12
+ export function isEscapeClearableInput(input) {
13
+ const type = String(input?.type ?? 'text').trim().toLowerCase();
14
+
15
+ return (
16
+ Boolean(input) &&
17
+ typeof input.value === 'string' &&
18
+ !input.disabled &&
19
+ !input.readOnly &&
20
+ ESCAPE_CLEARABLE_INPUT_TYPES.has(type)
21
+ );
22
+ }
23
+
24
+ export function clearInputForEscape(input, createInputEvent = () => new Event('input', { bubbles: true })) {
25
+ if (!isEscapeClearableInput(input) || input.value === '') {
26
+ return false;
27
+ }
28
+
29
+ input.value = '';
30
+
31
+ if (typeof input.dispatchEvent === 'function') {
32
+ input.dispatchEvent(createInputEvent());
33
+ }
34
+
35
+ return true;
36
+ }
@@ -0,0 +1,240 @@
1
+ export const SYNTHETIC_GENERATOR_TYPES = [
2
+ { value: 'skip', label: 'Skip' },
3
+ { value: 'static', label: 'Static Value' },
4
+ { value: 'randomText', label: 'Random Text' },
5
+ { value: 'name', label: 'Name' },
6
+ { value: 'firstName', label: 'First Name' },
7
+ { value: 'lastName', label: 'Last Name' },
8
+ { value: 'email', label: 'Email' },
9
+ { value: 'username', label: 'Username' },
10
+ { value: 'title', label: 'Title' },
11
+ { value: 'slug', label: 'Slug' },
12
+ { value: 'url', label: 'URL' },
13
+ { value: 'randomInteger', label: 'Random Integer' },
14
+ { value: 'randomDecimal', label: 'Random Decimal' },
15
+ { value: 'boolean', label: 'Boolean' },
16
+ { value: 'timestamp', label: 'Timestamp' },
17
+ { value: 'uuid', label: 'UUID' },
18
+ { value: 'oneOf', label: 'One Of' },
19
+ { value: 'existingForeignKey', label: 'Existing FK' },
20
+ ];
21
+
22
+ const GENERATOR_VALUES = new Set(SYNTHETIC_GENERATOR_TYPES.map(type => type.value));
23
+
24
+ function normalizeColumnName(value) {
25
+ return String(value ?? '')
26
+ .trim()
27
+ .toLowerCase();
28
+ }
29
+
30
+ function hasBooleanAllowedValues(column = {}) {
31
+ const values = (column.allowedValues ?? []).map(value => String(value));
32
+ const uniqueValues = new Set(values);
33
+
34
+ return uniqueValues.size === 2 && uniqueValues.has('0') && uniqueValues.has('1');
35
+ }
36
+
37
+ function hasBooleanIntegerRange(column = {}) {
38
+ return Number(column.integerRange?.min) === 0 && Number(column.integerRange?.max) === 1;
39
+ }
40
+
41
+ function isBooleanLikeColumn(column = {}, normalizedName = '') {
42
+ return (
43
+ /(^is_|^has_|enabled$|active$|archived$|published$|deleted$|visible$|boolean|bool)/.test(normalizedName) ||
44
+ hasBooleanAllowedValues(column) ||
45
+ hasBooleanIntegerRange(column)
46
+ );
47
+ }
48
+
49
+ function getForeignKeyInfo(foreignKeys = [], columnName) {
50
+ const singleColumnForeignKey = foreignKeys.find(
51
+ foreignKey =>
52
+ (foreignKey.mappings?.length ?? 0) === 1 && foreignKey.mappings?.[0]?.from === columnName,
53
+ );
54
+
55
+ if (singleColumnForeignKey) {
56
+ return {
57
+ kind: 'single',
58
+ foreignKey: singleColumnForeignKey,
59
+ mapping: singleColumnForeignKey.mappings[0],
60
+ };
61
+ }
62
+
63
+ const compositeForeignKey = foreignKeys.find(foreignKey =>
64
+ (foreignKey.mappings ?? []).some(mapping => mapping.from === columnName),
65
+ );
66
+
67
+ if (compositeForeignKey) {
68
+ return {
69
+ kind: 'composite',
70
+ foreignKey: compositeForeignKey,
71
+ mapping: compositeForeignKey.mappings.find(mapping => mapping.from === columnName) ?? null,
72
+ };
73
+ }
74
+
75
+ return null;
76
+ }
77
+
78
+ export function isIntegerPrimaryKeyColumn(column = {}) {
79
+ return (
80
+ Number(column.primaryKeyPosition ?? 0) > 0 &&
81
+ (column.affinity === 'INTEGER' || /\bINT\b/i.test(column.declaredType ?? ''))
82
+ );
83
+ }
84
+
85
+ export function normalizeSyntheticGeneratorType(value, fallback = 'skip') {
86
+ const text = String(value ?? '');
87
+
88
+ return GENERATOR_VALUES.has(text) ? text : fallback;
89
+ }
90
+
91
+ export function getSyntheticGeneratorLabel(value) {
92
+ return SYNTHETIC_GENERATOR_TYPES.find(type => type.value === value)?.label ?? 'Skip';
93
+ }
94
+
95
+ function normalizeIntegerRange(column = {}) {
96
+ const min = Number(column.integerRange?.min);
97
+ const max = Number(column.integerRange?.max);
98
+
99
+ return {
100
+ min: Number.isSafeInteger(min) ? min : null,
101
+ max: Number.isSafeInteger(max) ? max : null,
102
+ };
103
+ }
104
+
105
+ function getDefaultIntegerOptions(column = {}) {
106
+ const range = normalizeIntegerRange(column);
107
+ const min = range.min ?? (range.max !== null && range.max < 1 ? range.max - 999 : 1);
108
+ const max = range.max ?? (range.min !== null && range.min > 1000 ? range.min + 999 : 1000);
109
+
110
+ return { min, max };
111
+ }
112
+
113
+ export function getDefaultSyntheticOptions(generator, column = {}) {
114
+ switch (generator) {
115
+ case 'static':
116
+ return { value: '' };
117
+ case 'randomInteger':
118
+ return getDefaultIntegerOptions(column);
119
+ case 'randomDecimal':
120
+ return { min: 0, max: 1000, decimals: 2 };
121
+ case 'boolean':
122
+ return { trueProbability: 50 };
123
+ case 'timestamp':
124
+ return { range: 'last30', from: '', to: '' };
125
+ case 'oneOf':
126
+ return { values: (column.allowedValues ?? []).join(', ') };
127
+ default:
128
+ return {};
129
+ }
130
+ }
131
+
132
+ export function suggestSyntheticGeneratorForColumn(column = {}, foreignKeys = []) {
133
+ const name = normalizeColumnName(column.name);
134
+ const declaredType = String(column.declaredType ?? '').toUpperCase();
135
+ const affinity = String(column.affinity ?? '').toUpperCase();
136
+
137
+ if (!column.visible || column.generated || affinity === 'BLOB') {
138
+ return 'skip';
139
+ }
140
+
141
+ if (isIntegerPrimaryKeyColumn(column)) {
142
+ return 'skip';
143
+ }
144
+
145
+ const foreignKeyInfo = getForeignKeyInfo(foreignKeys, column.name);
146
+
147
+ if (foreignKeyInfo?.kind === 'single') {
148
+ return 'existingForeignKey';
149
+ }
150
+
151
+ if (foreignKeyInfo?.kind === 'composite') {
152
+ return 'skip';
153
+ }
154
+
155
+ if (/(^|_)email$/.test(name) || name.includes('email_address')) {
156
+ return 'email';
157
+ }
158
+
159
+ if (/^(first_name|firstname|given_name)$/.test(name)) {
160
+ return 'firstName';
161
+ }
162
+
163
+ if (/^(last_name|lastname|family_name|surname)$/.test(name)) {
164
+ return 'lastName';
165
+ }
166
+
167
+ if (/^(name|full_name|display_name|contact_name)$/.test(name)) {
168
+ return 'name';
169
+ }
170
+
171
+ if (/^(username|user_name|login)$/.test(name)) {
172
+ return 'username';
173
+ }
174
+
175
+ if (/(^|_)(title|headline|subject)$/.test(name)) {
176
+ return 'title';
177
+ }
178
+
179
+ if (/(^|_)slug$/.test(name)) {
180
+ return 'slug';
181
+ }
182
+
183
+ if (/(^|_)(url|website|site|homepage)$/.test(name)) {
184
+ return 'url';
185
+ }
186
+
187
+ if (/(^|_)(uuid|guid)$/.test(name)) {
188
+ return 'uuid';
189
+ }
190
+
191
+ if (isBooleanLikeColumn(column, name)) {
192
+ return 'boolean';
193
+ }
194
+
195
+ if ((column.allowedValues ?? []).length) {
196
+ return 'oneOf';
197
+ }
198
+
199
+ if (/(date|time|created_at|updated_at|timestamp)/.test(name) || /DATE|TIME/.test(declaredType)) {
200
+ return 'timestamp';
201
+ }
202
+
203
+ if (affinity === 'INTEGER') {
204
+ return 'randomInteger';
205
+ }
206
+
207
+ if (affinity === 'REAL' || affinity === 'NUMERIC' || /DECIMAL|NUMERIC/.test(declaredType)) {
208
+ return 'randomDecimal';
209
+ }
210
+
211
+ if (affinity === 'TEXT') {
212
+ return 'randomText';
213
+ }
214
+
215
+ return 'skip';
216
+ }
217
+
218
+ export function buildSyntheticDataMappings(columns = [], foreignKeys = []) {
219
+ return columns
220
+ .filter(column => column.visible && !column.generated)
221
+ .map(column => {
222
+ const foreignKeyInfo = getForeignKeyInfo(foreignKeys, column.name);
223
+ const generator = suggestSyntheticGeneratorForColumn(column, foreignKeys);
224
+ const note =
225
+ foreignKeyInfo?.kind === 'single'
226
+ ? `Existing ${foreignKeyInfo.foreignKey.referencedTable}.${foreignKeyInfo.mapping.to}`
227
+ : foreignKeyInfo?.kind === 'composite'
228
+ ? 'Composite FK unsupported'
229
+ : isIntegerPrimaryKeyColumn(column)
230
+ ? 'Auto increment / skipped'
231
+ : '';
232
+
233
+ return {
234
+ columnName: column.name,
235
+ generator,
236
+ options: getDefaultSyntheticOptions(generator, column),
237
+ note,
238
+ };
239
+ });
240
+ }