@memberjunction/db-auto-doc 2.117.0 → 2.119.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 (263) hide show
  1. package/README.md +803 -165
  2. package/bin/run.js +7 -0
  3. package/dist/api/DBAutoDocAPI.d.ts +252 -0
  4. package/dist/api/DBAutoDocAPI.d.ts.map +1 -0
  5. package/dist/api/DBAutoDocAPI.js +530 -0
  6. package/dist/api/DBAutoDocAPI.js.map +1 -0
  7. package/dist/api/index.d.ts +7 -0
  8. package/dist/api/index.d.ts.map +1 -0
  9. package/dist/api/index.js +10 -0
  10. package/dist/api/index.js.map +1 -0
  11. package/dist/commands/analyze.d.ts +6 -4
  12. package/dist/commands/analyze.d.ts.map +1 -1
  13. package/dist/commands/analyze.js +58 -71
  14. package/dist/commands/analyze.js.map +1 -1
  15. package/dist/commands/export.d.ts +14 -4
  16. package/dist/commands/export.d.ts.map +1 -1
  17. package/dist/commands/export.js +156 -61
  18. package/dist/commands/export.js.map +1 -1
  19. package/dist/commands/generate-queries.d.ts +17 -0
  20. package/dist/commands/generate-queries.d.ts.map +1 -0
  21. package/dist/commands/generate-queries.js +182 -0
  22. package/dist/commands/generate-queries.js.map +1 -0
  23. package/dist/commands/init.d.ts +3 -4
  24. package/dist/commands/init.d.ts.map +1 -1
  25. package/dist/commands/init.js +206 -144
  26. package/dist/commands/init.js.map +1 -1
  27. package/dist/commands/reset.d.ts +4 -1
  28. package/dist/commands/reset.d.ts.map +1 -1
  29. package/dist/commands/reset.js +33 -19
  30. package/dist/commands/reset.js.map +1 -1
  31. package/dist/commands/status.d.ts +10 -0
  32. package/dist/commands/status.d.ts.map +1 -0
  33. package/dist/commands/status.js +66 -0
  34. package/dist/commands/status.js.map +1 -0
  35. package/dist/core/AnalysisEngine.d.ts +108 -0
  36. package/dist/core/AnalysisEngine.d.ts.map +1 -0
  37. package/dist/core/AnalysisEngine.js +716 -0
  38. package/dist/core/AnalysisEngine.js.map +1 -0
  39. package/dist/core/AnalysisOrchestrator.d.ts +41 -0
  40. package/dist/core/AnalysisOrchestrator.d.ts.map +1 -0
  41. package/dist/core/AnalysisOrchestrator.js +377 -0
  42. package/dist/core/AnalysisOrchestrator.js.map +1 -0
  43. package/dist/core/BackpropagationEngine.d.ts +32 -0
  44. package/dist/core/BackpropagationEngine.d.ts.map +1 -0
  45. package/dist/core/BackpropagationEngine.js +121 -0
  46. package/dist/core/BackpropagationEngine.js.map +1 -0
  47. package/dist/core/ConvergenceDetector.d.ts +27 -0
  48. package/dist/core/ConvergenceDetector.d.ts.map +1 -0
  49. package/dist/core/ConvergenceDetector.js +92 -0
  50. package/dist/core/ConvergenceDetector.js.map +1 -0
  51. package/dist/core/GuardrailsManager.d.ts +78 -0
  52. package/dist/core/GuardrailsManager.d.ts.map +1 -0
  53. package/dist/core/GuardrailsManager.js +367 -0
  54. package/dist/core/GuardrailsManager.js.map +1 -0
  55. package/dist/core/index.d.ts +7 -0
  56. package/dist/core/index.d.ts.map +1 -0
  57. package/dist/core/index.js +13 -0
  58. package/dist/core/index.js.map +1 -0
  59. package/dist/database/Database.d.ts +56 -0
  60. package/dist/database/Database.d.ts.map +1 -0
  61. package/dist/database/Database.js +172 -0
  62. package/dist/database/Database.js.map +1 -0
  63. package/dist/database/TopologicalSorter.d.ts +25 -0
  64. package/dist/database/TopologicalSorter.d.ts.map +1 -0
  65. package/dist/database/TopologicalSorter.js +150 -0
  66. package/dist/database/TopologicalSorter.js.map +1 -0
  67. package/dist/database/index.d.ts +6 -0
  68. package/dist/database/index.d.ts.map +1 -0
  69. package/dist/database/index.js +14 -0
  70. package/dist/database/index.js.map +1 -0
  71. package/dist/discovery/ColumnStatsCache.d.ts +91 -0
  72. package/dist/discovery/ColumnStatsCache.d.ts.map +1 -0
  73. package/dist/discovery/ColumnStatsCache.js +231 -0
  74. package/dist/discovery/ColumnStatsCache.js.map +1 -0
  75. package/dist/discovery/DiscoveryEngine.d.ts +100 -0
  76. package/dist/discovery/DiscoveryEngine.d.ts.map +1 -0
  77. package/dist/discovery/DiscoveryEngine.js +726 -0
  78. package/dist/discovery/DiscoveryEngine.js.map +1 -0
  79. package/dist/discovery/DiscoveryTriggerAnalyzer.d.ts +57 -0
  80. package/dist/discovery/DiscoveryTriggerAnalyzer.d.ts.map +1 -0
  81. package/dist/discovery/DiscoveryTriggerAnalyzer.js +186 -0
  82. package/dist/discovery/DiscoveryTriggerAnalyzer.js.map +1 -0
  83. package/dist/discovery/FKDetector.d.ts +47 -0
  84. package/dist/discovery/FKDetector.d.ts.map +1 -0
  85. package/dist/discovery/FKDetector.js +317 -0
  86. package/dist/discovery/FKDetector.js.map +1 -0
  87. package/dist/discovery/LLMDiscoveryValidator.d.ts +64 -0
  88. package/dist/discovery/LLMDiscoveryValidator.d.ts.map +1 -0
  89. package/dist/discovery/LLMDiscoveryValidator.js +431 -0
  90. package/dist/discovery/LLMDiscoveryValidator.js.map +1 -0
  91. package/dist/discovery/LLMSanityChecker.d.ts +38 -0
  92. package/dist/discovery/LLMSanityChecker.d.ts.map +1 -0
  93. package/dist/discovery/LLMSanityChecker.js +156 -0
  94. package/dist/discovery/LLMSanityChecker.js.map +1 -0
  95. package/dist/discovery/PKDetector.d.ts +62 -0
  96. package/dist/discovery/PKDetector.d.ts.map +1 -0
  97. package/dist/discovery/PKDetector.js +436 -0
  98. package/dist/discovery/PKDetector.js.map +1 -0
  99. package/dist/discovery/index.d.ts +9 -0
  100. package/dist/discovery/index.d.ts.map +1 -0
  101. package/dist/discovery/index.js +25 -0
  102. package/dist/discovery/index.js.map +1 -0
  103. package/dist/drivers/BaseAutoDocDriver.d.ts +132 -0
  104. package/dist/drivers/BaseAutoDocDriver.d.ts.map +1 -0
  105. package/dist/drivers/BaseAutoDocDriver.js +121 -0
  106. package/dist/drivers/BaseAutoDocDriver.js.map +1 -0
  107. package/dist/drivers/MySQLDriver.d.ts +61 -0
  108. package/dist/drivers/MySQLDriver.d.ts.map +1 -0
  109. package/dist/drivers/MySQLDriver.js +668 -0
  110. package/dist/drivers/MySQLDriver.js.map +1 -0
  111. package/dist/drivers/PostgreSQLDriver.d.ts +65 -0
  112. package/dist/drivers/PostgreSQLDriver.d.ts.map +1 -0
  113. package/dist/drivers/PostgreSQLDriver.js +704 -0
  114. package/dist/drivers/PostgreSQLDriver.js.map +1 -0
  115. package/dist/drivers/SQLServerDriver.d.ts +61 -0
  116. package/dist/drivers/SQLServerDriver.d.ts.map +1 -0
  117. package/dist/drivers/SQLServerDriver.js +667 -0
  118. package/dist/drivers/SQLServerDriver.js.map +1 -0
  119. package/dist/generators/CSVGenerator.d.ts +35 -0
  120. package/dist/generators/CSVGenerator.d.ts.map +1 -0
  121. package/dist/generators/CSVGenerator.js +154 -0
  122. package/dist/generators/CSVGenerator.js.map +1 -0
  123. package/dist/generators/HTMLGenerator.d.ts +29 -0
  124. package/dist/generators/HTMLGenerator.d.ts.map +1 -0
  125. package/dist/generators/HTMLGenerator.js +710 -0
  126. package/dist/generators/HTMLGenerator.js.map +1 -0
  127. package/dist/generators/MarkdownGenerator.d.ts +27 -0
  128. package/dist/generators/MarkdownGenerator.d.ts.map +1 -0
  129. package/dist/generators/MarkdownGenerator.js +361 -0
  130. package/dist/generators/MarkdownGenerator.js.map +1 -0
  131. package/dist/generators/MermaidGenerator.d.ts +35 -0
  132. package/dist/generators/MermaidGenerator.d.ts.map +1 -0
  133. package/dist/generators/MermaidGenerator.js +321 -0
  134. package/dist/generators/MermaidGenerator.js.map +1 -0
  135. package/dist/generators/ReportGenerator.d.ts +22 -0
  136. package/dist/generators/ReportGenerator.d.ts.map +1 -0
  137. package/dist/generators/ReportGenerator.js +176 -0
  138. package/dist/generators/ReportGenerator.js.map +1 -0
  139. package/dist/generators/SQLGenerator.d.ts +31 -0
  140. package/dist/generators/SQLGenerator.d.ts.map +1 -0
  141. package/dist/generators/SQLGenerator.js +168 -0
  142. package/dist/generators/SQLGenerator.js.map +1 -0
  143. package/dist/generators/SampleQueryGenerator.d.ts +64 -0
  144. package/dist/generators/SampleQueryGenerator.d.ts.map +1 -0
  145. package/dist/generators/SampleQueryGenerator.js +500 -0
  146. package/dist/generators/SampleQueryGenerator.js.map +1 -0
  147. package/dist/generators/index.d.ts +10 -0
  148. package/dist/generators/index.d.ts.map +1 -0
  149. package/dist/generators/index.js +19 -0
  150. package/dist/generators/index.js.map +1 -0
  151. package/dist/index.d.ts +11 -20
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +19 -20
  154. package/dist/index.js.map +1 -1
  155. package/dist/prompts/PromptEngine.d.ts +65 -0
  156. package/dist/prompts/PromptEngine.d.ts.map +1 -0
  157. package/dist/prompts/PromptEngine.js +305 -0
  158. package/dist/prompts/PromptEngine.js.map +1 -0
  159. package/dist/prompts/PromptFileLoader.d.ts +21 -0
  160. package/dist/prompts/PromptFileLoader.d.ts.map +1 -0
  161. package/dist/prompts/PromptFileLoader.js +74 -0
  162. package/dist/prompts/PromptFileLoader.js.map +1 -0
  163. package/dist/prompts/index.d.ts +6 -0
  164. package/dist/prompts/index.d.ts.map +1 -0
  165. package/dist/prompts/index.js +11 -0
  166. package/dist/prompts/index.js.map +1 -0
  167. package/dist/state/IterationTracker.d.ts +64 -0
  168. package/dist/state/IterationTracker.d.ts.map +1 -0
  169. package/dist/state/IterationTracker.js +136 -0
  170. package/dist/state/IterationTracker.js.map +1 -0
  171. package/dist/state/StateManager.d.ts +79 -0
  172. package/dist/state/StateManager.d.ts.map +1 -0
  173. package/dist/state/StateManager.js +348 -0
  174. package/dist/state/StateManager.js.map +1 -0
  175. package/dist/state/StateValidator.d.ts +24 -0
  176. package/dist/state/StateValidator.d.ts.map +1 -0
  177. package/dist/state/StateValidator.js +147 -0
  178. package/dist/state/StateValidator.js.map +1 -0
  179. package/dist/state/index.d.ts +7 -0
  180. package/dist/state/index.d.ts.map +1 -0
  181. package/dist/state/index.js +13 -0
  182. package/dist/state/index.js.map +1 -0
  183. package/dist/types/analysis.d.ts +76 -0
  184. package/dist/types/analysis.d.ts.map +1 -0
  185. package/dist/types/analysis.js +6 -0
  186. package/dist/types/analysis.js.map +1 -0
  187. package/dist/types/config.d.ts +143 -0
  188. package/dist/types/config.d.ts.map +1 -0
  189. package/dist/types/config.js +7 -0
  190. package/dist/types/config.js.map +1 -0
  191. package/dist/types/discovery.d.ts +277 -0
  192. package/dist/types/discovery.d.ts.map +1 -0
  193. package/dist/types/discovery.js +7 -0
  194. package/dist/types/discovery.js.map +1 -0
  195. package/dist/types/driver.d.ts +148 -0
  196. package/dist/types/driver.d.ts.map +1 -0
  197. package/dist/types/driver.js +7 -0
  198. package/dist/types/driver.js.map +1 -0
  199. package/dist/types/index.d.ts +8 -0
  200. package/dist/types/index.d.ts.map +1 -0
  201. package/dist/types/index.js +24 -0
  202. package/dist/types/index.js.map +1 -0
  203. package/dist/types/prompts.d.ts +158 -0
  204. package/dist/types/prompts.d.ts.map +1 -0
  205. package/dist/types/prompts.js +6 -0
  206. package/dist/types/prompts.js.map +1 -0
  207. package/dist/types/sample-queries.d.ts +172 -0
  208. package/dist/types/sample-queries.d.ts.map +1 -0
  209. package/dist/types/sample-queries.js +7 -0
  210. package/dist/types/sample-queries.js.map +1 -0
  211. package/dist/types/state.d.ts +291 -0
  212. package/dist/types/state.d.ts.map +1 -0
  213. package/dist/types/state.js +7 -0
  214. package/dist/types/state.js.map +1 -0
  215. package/dist/utils/config-loader.d.ts +29 -0
  216. package/dist/utils/config-loader.d.ts.map +1 -0
  217. package/dist/utils/config-loader.js +163 -0
  218. package/dist/utils/config-loader.js.map +1 -0
  219. package/dist/utils/index.d.ts +5 -0
  220. package/dist/utils/index.d.ts.map +1 -0
  221. package/dist/utils/index.js +9 -0
  222. package/dist/utils/index.js.map +1 -0
  223. package/package.json +28 -3
  224. package/dist/ai/simple-ai-client.d.ts +0 -70
  225. package/dist/ai/simple-ai-client.d.ts.map +0 -1
  226. package/dist/ai/simple-ai-client.js +0 -181
  227. package/dist/ai/simple-ai-client.js.map +0 -1
  228. package/dist/analyzers/analyzer.d.ts +0 -23
  229. package/dist/analyzers/analyzer.d.ts.map +0 -1
  230. package/dist/analyzers/analyzer.js +0 -127
  231. package/dist/analyzers/analyzer.js.map +0 -1
  232. package/dist/cli-old/cli.d.ts +0 -3
  233. package/dist/cli-old/cli.d.ts.map +0 -1
  234. package/dist/cli-old/cli.js +0 -388
  235. package/dist/cli-old/cli.js.map +0 -1
  236. package/dist/commands/review.d.ts +0 -11
  237. package/dist/commands/review.d.ts.map +0 -1
  238. package/dist/commands/review.js +0 -82
  239. package/dist/commands/review.js.map +0 -1
  240. package/dist/database/connection.d.ts +0 -40
  241. package/dist/database/connection.d.ts.map +0 -1
  242. package/dist/database/connection.js +0 -136
  243. package/dist/database/connection.js.map +0 -1
  244. package/dist/database/introspection.d.ts +0 -59
  245. package/dist/database/introspection.d.ts.map +0 -1
  246. package/dist/database/introspection.js +0 -124
  247. package/dist/database/introspection.js.map +0 -1
  248. package/dist/generators/markdown-generator.d.ts +0 -8
  249. package/dist/generators/markdown-generator.d.ts.map +0 -1
  250. package/dist/generators/markdown-generator.js +0 -106
  251. package/dist/generators/markdown-generator.js.map +0 -1
  252. package/dist/generators/sql-generator.d.ts +0 -20
  253. package/dist/generators/sql-generator.d.ts.map +0 -1
  254. package/dist/generators/sql-generator.js +0 -83
  255. package/dist/generators/sql-generator.js.map +0 -1
  256. package/dist/state/state-manager.d.ts +0 -95
  257. package/dist/state/state-manager.d.ts.map +0 -1
  258. package/dist/state/state-manager.js +0 -236
  259. package/dist/state/state-manager.js.map +0 -1
  260. package/dist/types/state-file.d.ts +0 -124
  261. package/dist/types/state-file.d.ts.map +0 -1
  262. package/dist/types/state-file.js +0 -79
  263. package/dist/types/state-file.js.map +0 -1
@@ -0,0 +1,277 @@
1
+ /**
2
+ * Type definitions for relationship discovery phase
3
+ * Used to detect primary keys and foreign keys in databases with missing metadata
4
+ */
5
+ /**
6
+ * Evidence for why a column might be a primary key
7
+ */
8
+ export interface PKEvidence {
9
+ uniqueness: number;
10
+ nullCount: number;
11
+ totalRows: number;
12
+ dataPattern: 'sequential' | 'guid' | 'composite' | 'natural' | 'unknown';
13
+ namingScore: number;
14
+ dataTypeScore: number;
15
+ warnings: string[];
16
+ }
17
+ /**
18
+ * Primary key candidate discovered during analysis
19
+ */
20
+ export interface PKCandidate {
21
+ schemaName: string;
22
+ tableName: string;
23
+ columnNames: string[];
24
+ confidence: number;
25
+ evidence: PKEvidence;
26
+ discoveredInIteration: number;
27
+ validatedByLLM: boolean;
28
+ status: 'candidate' | 'confirmed' | 'rejected';
29
+ }
30
+ /**
31
+ * Evidence for why a column might be a foreign key
32
+ */
33
+ export interface FKEvidence {
34
+ namingMatch: number;
35
+ valueOverlap: number;
36
+ cardinalityRatio: number;
37
+ dataTypeMatch: boolean;
38
+ nullPercentage: number;
39
+ sampleSize: number;
40
+ orphanCount: number;
41
+ warnings: string[];
42
+ }
43
+ /**
44
+ * Foreign key candidate discovered during analysis
45
+ */
46
+ export interface FKCandidate {
47
+ schemaName: string;
48
+ sourceTable: string;
49
+ sourceColumn: string;
50
+ targetSchema: string;
51
+ targetTable: string;
52
+ targetColumn: string;
53
+ confidence: number;
54
+ evidence: FKEvidence;
55
+ discoveredInIteration: number;
56
+ validatedByLLM: boolean;
57
+ status: 'candidate' | 'confirmed' | 'rejected';
58
+ }
59
+ /**
60
+ * Statistics about a column's data (for discovery)
61
+ * Extended version of AutoDocColumnStatistics
62
+ */
63
+ export interface ColumnStatistics {
64
+ columnName: string;
65
+ dataType: string;
66
+ totalRows: number;
67
+ nullCount: number;
68
+ distinctCount: number;
69
+ minValue?: string | number;
70
+ maxValue?: string | number;
71
+ avgLength?: number;
72
+ commonPatterns?: string[];
73
+ sampleValues: Array<string | number | null>;
74
+ }
75
+ /**
76
+ * Simpler column statistics interface for discovery
77
+ * Maps to what the driver provides
78
+ */
79
+ export interface SimpleColumnStats {
80
+ totalRows: number;
81
+ nullCount: number;
82
+ distinctCount: number;
83
+ sampleValues: Array<string | number | null>;
84
+ }
85
+ /**
86
+ * Single iteration of the discovery process
87
+ */
88
+ export interface RelationshipDiscoveryIteration {
89
+ iteration: number;
90
+ phase: 'sampling' | 'pk_detection' | 'fk_detection' | 'sanity_check' | 'llm_validation' | 'backprop';
91
+ startedAt: string;
92
+ completedAt: string;
93
+ tokensUsed: number;
94
+ discoveries: {
95
+ newPKs: PKCandidate[];
96
+ newFKs: FKCandidate[];
97
+ validated: string[];
98
+ rejected: string[];
99
+ confidenceChanges: Array<{
100
+ id: string;
101
+ oldConfidence: number;
102
+ newConfidence: number;
103
+ reason: string;
104
+ }>;
105
+ };
106
+ backpropTriggered: boolean;
107
+ backpropReason?: string;
108
+ }
109
+ /**
110
+ * Feedback from analysis phase back to discovery
111
+ */
112
+ export interface AnalysisToDiscoveryFeedback {
113
+ type: 'pk_invalidated' | 'fk_invalidated' | 'new_relationship' | 'confidence_change';
114
+ evidence: string;
115
+ tableName: string;
116
+ columnName: string;
117
+ affectedCandidates: string[];
118
+ recommendation: 'remove' | 'downgrade_confidence' | 'upgrade_confidence' | 'add_new';
119
+ newConfidence?: number;
120
+ newRelationship?: {
121
+ targetTable: string;
122
+ targetColumn: string;
123
+ };
124
+ }
125
+ /**
126
+ * Complete state of relationship discovery phase
127
+ */
128
+ export interface RelationshipDiscoveryPhase {
129
+ triggered: boolean;
130
+ triggerReason: 'missing_pks' | 'insufficient_fks' | 'both' | 'manual';
131
+ triggerDetails: {
132
+ tablesWithoutPK: number;
133
+ expectedFKs: number;
134
+ actualFKs: number;
135
+ fkDeficitPercentage: number;
136
+ };
137
+ startedAt: string;
138
+ completedAt?: string;
139
+ tokenBudget: {
140
+ allocated: number;
141
+ used: number;
142
+ remaining: number;
143
+ };
144
+ iterations: RelationshipDiscoveryIteration[];
145
+ discovered: {
146
+ primaryKeys: PKCandidate[];
147
+ foreignKeys: FKCandidate[];
148
+ };
149
+ schemaEnhancements: {
150
+ pkeysAdded: number;
151
+ fkeysAdded: number;
152
+ overallConfidence: number;
153
+ };
154
+ feedbackFromAnalysis: AnalysisToDiscoveryFeedback[];
155
+ summary: {
156
+ totalTablesAnalyzed: number;
157
+ tablesWithDiscoveredPKs: number;
158
+ relationshipsDiscovered: number;
159
+ averageConfidence: number;
160
+ highConfidenceCount: number;
161
+ mediumConfidenceCount: number;
162
+ lowConfidenceCount: number;
163
+ rejectedCount: number;
164
+ };
165
+ }
166
+ /**
167
+ * Discovery trigger analysis
168
+ */
169
+ export interface DiscoveryTriggerAnalysis {
170
+ shouldRun: boolean;
171
+ reason: string;
172
+ details: {
173
+ totalTables: number;
174
+ tablesWithPK: number;
175
+ tablesWithoutPK: number;
176
+ totalFKs: number;
177
+ expectedMinFKs: number;
178
+ fkDeficit: number;
179
+ fkDeficitPercentage: number;
180
+ };
181
+ }
182
+ /**
183
+ * Cached column statistics for reuse across discovery and analysis
184
+ * Pre-computed once and stored to avoid redundant queries
185
+ */
186
+ export interface CachedColumnStats {
187
+ schemaName: string;
188
+ tableName: string;
189
+ columnName: string;
190
+ dataType: string;
191
+ totalRows: number;
192
+ nullCount: number;
193
+ nullPercentage: number;
194
+ distinctCount: number;
195
+ uniqueness: number;
196
+ minValue?: string | number;
197
+ maxValue?: string | number;
198
+ avgLength?: number;
199
+ dataPattern: 'sequential' | 'guid' | 'composite' | 'natural' | 'unknown';
200
+ sampleValues: Array<string | number | null>;
201
+ valueDistribution?: Array<{
202
+ value: string | number;
203
+ frequency: number;
204
+ }>;
205
+ computedAt: string;
206
+ queryTimeMs: number;
207
+ }
208
+ /**
209
+ * Collection of cached stats for a table
210
+ */
211
+ export interface TableStatsCache {
212
+ schemaName: string;
213
+ tableName: string;
214
+ totalRows: number;
215
+ columns: Map<string, CachedColumnStats>;
216
+ computedAt: string;
217
+ }
218
+ /**
219
+ * LLM context for relationship discovery
220
+ * Provides selective stats to LLM for intelligent reasoning
221
+ */
222
+ export interface LLMDiscoveryContext {
223
+ targetTable: {
224
+ schema: string;
225
+ table: string;
226
+ rowCount: number;
227
+ columns: Array<{
228
+ name: string;
229
+ type: string;
230
+ uniqueness: number;
231
+ nullPercentage: number;
232
+ distinctCount: number;
233
+ dataPattern: string;
234
+ sampleValues: Array<string | number | null>;
235
+ }>;
236
+ };
237
+ relatedTables?: Array<{
238
+ schema: string;
239
+ table: string;
240
+ rowCount: number;
241
+ potentialRelationships: Array<{
242
+ columnName: string;
243
+ similarity: number;
244
+ reason: string;
245
+ }>;
246
+ }>;
247
+ pkCandidates: Array<{
248
+ columnNames: string[];
249
+ confidence: number;
250
+ reasoning: string;
251
+ }>;
252
+ fkCandidates: Array<{
253
+ sourceColumn: string;
254
+ targetTable: string;
255
+ targetColumn: string;
256
+ confidence: number;
257
+ reasoning: string;
258
+ }>;
259
+ }
260
+ /**
261
+ * LLM validation result
262
+ */
263
+ export interface LLMValidationResult {
264
+ validated: boolean;
265
+ reasoning: string;
266
+ confidenceAdjustment: number;
267
+ recommendations: Array<{
268
+ type: 'confirm' | 'reject' | 'modify' | 'add_new';
269
+ target: 'pk' | 'fk';
270
+ schemaName?: string;
271
+ tableName?: string;
272
+ columnName?: string;
273
+ details: string;
274
+ }>;
275
+ tokensUsed: number;
276
+ }
277
+ //# sourceMappingURL=discovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/types/discovery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ /**
3
+ * Type definitions for relationship discovery phase
4
+ * Used to detect primary keys and foreign keys in databases with missing metadata
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ //# sourceMappingURL=discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/types/discovery.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
@@ -0,0 +1,148 @@
1
+ /**
2
+ * Database driver abstraction types
3
+ * Defines database-agnostic interfaces for multi-provider support
4
+ */
5
+ /**
6
+ * Database-agnostic schema representation
7
+ */
8
+ export interface AutoDocSchema {
9
+ name: string;
10
+ description?: string;
11
+ tables: AutoDocTable[];
12
+ }
13
+ /**
14
+ * Database-agnostic table representation
15
+ */
16
+ export interface AutoDocTable {
17
+ schemaName: string;
18
+ tableName: string;
19
+ rowCount: number;
20
+ columns: AutoDocColumn[];
21
+ foreignKeys: AutoDocForeignKey[];
22
+ primaryKeys: AutoDocPrimaryKey[];
23
+ }
24
+ /**
25
+ * Database-agnostic column representation
26
+ */
27
+ export interface AutoDocColumn {
28
+ name: string;
29
+ dataType: string;
30
+ isNullable: boolean;
31
+ isPrimaryKey: boolean;
32
+ isForeignKey: boolean;
33
+ checkConstraint?: string;
34
+ defaultValue?: string;
35
+ maxLength?: number;
36
+ precision?: number;
37
+ scale?: number;
38
+ }
39
+ /**
40
+ * Database-agnostic foreign key representation
41
+ */
42
+ export interface AutoDocForeignKey {
43
+ columnName: string;
44
+ referencedSchema: string;
45
+ referencedTable: string;
46
+ referencedColumn: string;
47
+ constraintName?: string;
48
+ }
49
+ /**
50
+ * Database-agnostic primary key representation
51
+ */
52
+ export interface AutoDocPrimaryKey {
53
+ columnName: string;
54
+ ordinalPosition: number;
55
+ constraintName?: string;
56
+ }
57
+ /**
58
+ * Database-agnostic column statistics
59
+ */
60
+ export interface AutoDocColumnStatistics {
61
+ totalRows: number;
62
+ distinctCount: number;
63
+ uniquenessRatio: number;
64
+ nullCount: number;
65
+ nullPercentage: number;
66
+ sampleValues: any[];
67
+ min?: any;
68
+ max?: any;
69
+ avg?: number;
70
+ stdDev?: number;
71
+ avgLength?: number;
72
+ maxLength?: number;
73
+ minLength?: number;
74
+ valueDistribution?: AutoDocValueDistribution[];
75
+ }
76
+ /**
77
+ * Value distribution for low-cardinality columns
78
+ */
79
+ export interface AutoDocValueDistribution {
80
+ value: any;
81
+ frequency: number;
82
+ percentage: number;
83
+ }
84
+ /**
85
+ * Existing description from database metadata
86
+ */
87
+ export interface AutoDocExistingDescription {
88
+ target: 'table' | 'column';
89
+ targetName: string;
90
+ description: string;
91
+ }
92
+ /**
93
+ * Database connection configuration (provider-agnostic)
94
+ */
95
+ export interface AutoDocConnectionConfig {
96
+ provider: 'sqlserver' | 'mysql' | 'postgresql' | 'oracle';
97
+ host: string;
98
+ port?: number;
99
+ database: string;
100
+ user?: string;
101
+ username?: string;
102
+ password: string;
103
+ encrypt?: boolean;
104
+ trustServerCertificate?: boolean;
105
+ socketPath?: string;
106
+ ssl?: boolean | {
107
+ rejectUnauthorized?: boolean;
108
+ };
109
+ connectionTimeout?: number;
110
+ requestTimeout?: number;
111
+ maxConnections?: number;
112
+ minConnections?: number;
113
+ idleTimeoutMillis?: number;
114
+ }
115
+ /**
116
+ * Query result wrapper
117
+ */
118
+ export interface AutoDocQueryResult<T = any> {
119
+ success: boolean;
120
+ data?: T[];
121
+ rowCount?: number;
122
+ errorMessage?: string;
123
+ }
124
+ /**
125
+ * Connection test result
126
+ */
127
+ export interface AutoDocConnectionTestResult {
128
+ success: boolean;
129
+ message: string;
130
+ serverVersion?: string;
131
+ databaseName?: string;
132
+ }
133
+ /**
134
+ * Schema filter options
135
+ */
136
+ export interface AutoDocSchemaFilter {
137
+ include?: string[];
138
+ exclude?: string[];
139
+ }
140
+ /**
141
+ * Table filter options
142
+ */
143
+ export interface AutoDocTableFilter {
144
+ exclude?: string[];
145
+ includePattern?: RegExp;
146
+ excludePattern?: RegExp;
147
+ }
148
+ //# sourceMappingURL=driver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/types/driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,GAAG,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAEjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ /**
3
+ * Database driver abstraction types
4
+ * Defines database-agnostic interfaces for multi-provider support
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ //# sourceMappingURL=driver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/types/driver.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Centralized exports for all types
3
+ */
4
+ export * from './state.js';
5
+ export * from './config.js';
6
+ export * from './analysis.js';
7
+ export * from './prompts.js';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}
@@ -0,0 +1,24 @@
1
+ "use strict";
2
+ /**
3
+ * Centralized exports for all types
4
+ */
5
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
6
+ if (k2 === undefined) k2 = k;
7
+ var desc = Object.getOwnPropertyDescriptor(m, k);
8
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
9
+ desc = { enumerable: true, get: function() { return m[k]; } };
10
+ }
11
+ Object.defineProperty(o, k2, desc);
12
+ }) : (function(o, m, k, k2) {
13
+ if (k2 === undefined) k2 = k;
14
+ o[k2] = m[k];
15
+ }));
16
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
17
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
18
+ };
19
+ Object.defineProperty(exports, "__esModule", { value: true });
20
+ __exportStar(require("./state.js"), exports);
21
+ __exportStar(require("./config.js"), exports);
22
+ __exportStar(require("./analysis.js"), exports);
23
+ __exportStar(require("./prompts.js"), exports);
24
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,+CAA6B"}
@@ -0,0 +1,158 @@
1
+ /**
2
+ * Prompt-related types for DBAutoDoc
3
+ */
4
+ export interface PromptExecutionResult<T> {
5
+ success: boolean;
6
+ result?: T;
7
+ errorMessage?: string;
8
+ tokensUsed: number;
9
+ cost?: number;
10
+ promptInput?: string;
11
+ promptOutput?: string;
12
+ inputTokens?: number;
13
+ outputTokens?: number;
14
+ guardrailExceeded?: boolean;
15
+ }
16
+ export interface TableAnalysisPromptResult {
17
+ tableDescription: string;
18
+ reasoning: string;
19
+ confidence: number;
20
+ columnDescriptions: ColumnDescriptionPromptResult[];
21
+ foreignKeys?: ForeignKeyPromptResult[];
22
+ inferredBusinessDomain?: string;
23
+ parentTableInsights?: ParentTableInsight[];
24
+ }
25
+ export interface ForeignKeyPromptResult {
26
+ columnName: string;
27
+ referencesSchema: string;
28
+ referencesTable: string;
29
+ referencesColumn: string;
30
+ confidence: number;
31
+ }
32
+ export interface ParentTableInsight {
33
+ parentTable: string;
34
+ insight: string;
35
+ confidence: number;
36
+ }
37
+ export interface ColumnDescriptionPromptResult {
38
+ columnName: string;
39
+ description: string;
40
+ reasoning: string;
41
+ }
42
+ export interface BackpropagationPromptResult {
43
+ needsRevision: boolean;
44
+ revisedDescription?: string;
45
+ reasoning: string;
46
+ confidence: number;
47
+ }
48
+ export interface SchemaSanityCheckPromptResult {
49
+ schemaDescription: string;
50
+ inconsistencies: string[];
51
+ suggestions: string[];
52
+ }
53
+ export interface CrossSchemaSanityCheckPromptResult {
54
+ insights: string[];
55
+ globalPatterns: string[];
56
+ suggestions: string[];
57
+ }
58
+ export interface ConvergenceCheckPromptResult {
59
+ hasConverged: boolean;
60
+ reasoning: string;
61
+ recommendedActions: string[];
62
+ }
63
+ export interface SemanticComparisonPromptResult {
64
+ tableMateriallyChanged: boolean;
65
+ tableChangeReasoning: string;
66
+ columnChanges: ColumnChangeResult[];
67
+ }
68
+ export interface ColumnChangeResult {
69
+ columnName: string;
70
+ materiallyChanged: boolean;
71
+ changeReasoning: string;
72
+ }
73
+ export interface DependencyLevelSanityCheckResult {
74
+ hasMaterialIssues: boolean;
75
+ overallAssessment: string;
76
+ tableIssues: TableIssue[];
77
+ crossTableObservations: CrossTableObservation[];
78
+ }
79
+ export interface TableIssue {
80
+ tableName: string;
81
+ issueType: 'description' | 'business_purpose' | 'relationships' | 'terminology';
82
+ severity: 'high' | 'medium' | 'low';
83
+ description: string;
84
+ suggestedFix: string;
85
+ }
86
+ export interface CrossTableObservation {
87
+ tables: string[];
88
+ observation: string;
89
+ impact: string;
90
+ recommendation: string;
91
+ }
92
+ export interface SchemaLevelSanityCheckResult {
93
+ hasMaterialIssues: boolean;
94
+ schemaCoherence: 'excellent' | 'good' | 'fair' | 'poor';
95
+ overallAssessment: string;
96
+ schemaLevelIssues: SchemaLevelIssue[];
97
+ tableIssues: TableIssue[];
98
+ architecturalPatterns: ArchitecturalPattern[];
99
+ businessDomainSuggestions: BusinessDomainSuggestion[];
100
+ }
101
+ export interface SchemaLevelIssue {
102
+ issueType: 'consistency' | 'relationships' | 'business_domain' | 'naming' | 'architecture' | 'missing_pattern';
103
+ severity: 'high' | 'medium' | 'low';
104
+ description: string;
105
+ affectedTables: string[];
106
+ suggestedSchemaDescription?: string;
107
+ }
108
+ export interface ArchitecturalPattern {
109
+ pattern: 'audit_trail' | 'configuration' | 'lookup' | 'transaction' | 'versioning' | 'soft_delete' | 'hierarchy';
110
+ tables: string[];
111
+ description: string;
112
+ }
113
+ export interface BusinessDomainSuggestion {
114
+ suggestedDomain: string;
115
+ reasoning: string;
116
+ confidence: 'high' | 'medium' | 'low';
117
+ }
118
+ export interface CrossSchemaSanityCheckResult {
119
+ hasMaterialIssues: boolean;
120
+ overallConsistency: 'excellent' | 'good' | 'fair' | 'poor';
121
+ overallAssessment: string;
122
+ crossSchemaIssues: CrossSchemaIssue[];
123
+ terminologyConflicts: TerminologyConflict[];
124
+ schemaIssues: SchemaIssue[];
125
+ databaseLevelObservations: DatabaseLevelObservation[];
126
+ }
127
+ export interface CrossSchemaIssue {
128
+ issueType: 'terminology' | 'shared_tables' | 'relationships' | 'business_domains' | 'naming' | 'duplication';
129
+ severity: 'high' | 'medium' | 'low';
130
+ description: string;
131
+ affectedSchemas: string[];
132
+ affectedTables: Array<{
133
+ schema: string;
134
+ table: string;
135
+ }>;
136
+ suggestedResolution: string;
137
+ }
138
+ export interface TerminologyConflict {
139
+ term: string;
140
+ usages: Array<{
141
+ schema: string;
142
+ table: string;
143
+ meaning: string;
144
+ }>;
145
+ recommendedStandardization: string;
146
+ }
147
+ export interface SchemaIssue {
148
+ schemaName: string;
149
+ issueType: 'description' | 'business_domain' | 'relationships';
150
+ description: string;
151
+ suggestedFix: string;
152
+ }
153
+ export interface DatabaseLevelObservation {
154
+ observation: string;
155
+ impact: string;
156
+ recommendation: string;
157
+ }
158
+ //# sourceMappingURL=prompts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/types/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,6BAA6B,EAAE,CAAC;IACpD,WAAW,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,8BAA8B;IAC7C,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,kBAAkB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,gCAAgC;IAC/C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,aAAa,GAAG,kBAAkB,GAAG,eAAe,GAAG,aAAa,CAAC;IAChF,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;IAC9C,yBAAyB,EAAE,wBAAwB,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,aAAa,GAAG,eAAe,GAAG,iBAAiB,GAAG,QAAQ,GAAG,cAAc,GAAG,iBAAiB,CAAC;IAC/G,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,GAAG,eAAe,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;IACjH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAGD,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC3D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,yBAAyB,EAAE,wBAAwB,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,kBAAkB,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC7G,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,aAAa,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ /**
3
+ * Prompt-related types for DBAutoDoc
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ //# sourceMappingURL=prompts.js.map