postgrelize 0.0.0-stage → 1.0.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 (308) hide show
  1. package/CHANGELOG.md +269 -0
  2. package/LICENSE +21 -0
  3. package/README.md +131 -2
  4. package/dist/associations/association-accessors.d.ts +21 -0
  5. package/dist/associations/association-key-types.d.ts +44 -0
  6. package/dist/associations/association-keys.d.ts +98 -0
  7. package/dist/associations/association-lookup.d.ts +26 -0
  8. package/dist/associations/association-shape.d.ts +25 -0
  9. package/dist/associations/association.d.ts +95 -0
  10. package/dist/associations/belongs-to-many.d.ts +86 -0
  11. package/dist/associations/belongs-to.d.ts +45 -0
  12. package/dist/associations/has-many.d.ts +79 -0
  13. package/dist/associations/has-one.d.ts +44 -0
  14. package/dist/associations/include-assembler.d.ts +21 -0
  15. package/dist/associations/include-columns.d.ts +24 -0
  16. package/dist/associations/include-joins.d.ts +17 -0
  17. package/dist/associations/include-loader.d.ts +48 -0
  18. package/dist/associations/include-order.d.ts +22 -0
  19. package/dist/associations/include-query-builder.d.ts +54 -0
  20. package/dist/associations/include-resolver.d.ts +29 -0
  21. package/dist/associations/include-rows.d.ts +47 -0
  22. package/dist/associations/include-sub-query.d.ts +35 -0
  23. package/dist/associations/include.d.ts +112 -0
  24. package/dist/associations/junction-keys.d.ts +23 -0
  25. package/dist/associations/nested-creator.d.ts +44 -0
  26. package/dist/associations/nested-saver.d.ts +30 -0
  27. package/dist/associations/owner-keys.d.ts +34 -0
  28. package/dist/associations/separate-include-loader.d.ts +24 -0
  29. package/dist/associations/types.d.ts +139 -0
  30. package/dist/connection/connection-config.d.ts +33 -0
  31. package/dist/connection/connection-manager.d.ts +65 -0
  32. package/dist/connection/connection-types.d.ts +21 -0
  33. package/dist/connection/copy-from-stdin.d.ts +52 -0
  34. package/dist/connection/copy-runner.d.ts +30 -0
  35. package/dist/connection/copy-to-stdout.d.ts +49 -0
  36. package/dist/connection/copy.d.ts +22 -0
  37. package/dist/connection/notifications.d.ts +28 -0
  38. package/dist/connection/options.d.ts +158 -0
  39. package/dist/connection/query-logger.d.ts +41 -0
  40. package/dist/connection/replica-router.d.ts +20 -0
  41. package/dist/connection/statement-cache.d.ts +36 -0
  42. package/dist/connection/statement-timeout.d.ts +22 -0
  43. package/dist/data-types/abstract-data-type.d.ts +58 -0
  44. package/dist/data-types/array-literal-parser.d.ts +17 -0
  45. package/dist/data-types/array-type.d.ts +18 -0
  46. package/dist/data-types/bit-type.d.ts +14 -0
  47. package/dist/data-types/blob-type.d.ts +12 -0
  48. package/dist/data-types/char-type.d.ts +12 -0
  49. package/dist/data-types/composite-fields.d.ts +26 -0
  50. package/dist/data-types/composite-type.d.ts +32 -0
  51. package/dist/data-types/data-types.d.ts +172 -0
  52. package/dist/data-types/date-type.d.ts +14 -0
  53. package/dist/data-types/decimal-type.d.ts +13 -0
  54. package/dist/data-types/default-value-generator.d.ts +15 -0
  55. package/dist/data-types/enum-type.d.ts +19 -0
  56. package/dist/data-types/ewkb-reader.d.ts +18 -0
  57. package/dist/data-types/ewkb-writer.d.ts +17 -0
  58. package/dist/data-types/float-type.d.ts +12 -0
  59. package/dist/data-types/geometric-text.d.ts +65 -0
  60. package/dist/data-types/geometric-type.d.ts +46 -0
  61. package/dist/data-types/hstore-type.d.ts +16 -0
  62. package/dist/data-types/integer-type.d.ts +24 -0
  63. package/dist/data-types/json-type.d.ts +16 -0
  64. package/dist/data-types/multirange-type.d.ts +19 -0
  65. package/dist/data-types/range-type.d.ts +28 -0
  66. package/dist/data-types/record-text.d.ts +29 -0
  67. package/dist/data-types/scalar-type.d.ts +13 -0
  68. package/dist/data-types/spatial-type.d.ts +20 -0
  69. package/dist/data-types/string-type.d.ts +12 -0
  70. package/dist/data-types/text-type.d.ts +12 -0
  71. package/dist/data-types/timestamp-type.d.ts +15 -0
  72. package/dist/data-types/virtual-type.d.ts +15 -0
  73. package/dist/data-types/wall-clock.d.ts +14 -0
  74. package/dist/ddl/column-ddl.d.ts +73 -0
  75. package/dist/ddl/constraint-ddl.d.ts +30 -0
  76. package/dist/ddl/ddl-generator.d.ts +181 -0
  77. package/dist/ddl/ddl-guards.d.ts +60 -0
  78. package/dist/ddl/ddl-types.d.ts +193 -0
  79. package/dist/ddl/enum-ddl.d.ts +42 -0
  80. package/dist/ddl/extension-ddl.d.ts +57 -0
  81. package/dist/ddl/function-ddl.d.ts +98 -0
  82. package/dist/ddl/index-ddl.d.ts +29 -0
  83. package/dist/ddl/index-element-ddl.d.ts +19 -0
  84. package/dist/ddl/partition-ddl.d.ts +88 -0
  85. package/dist/ddl/partition-types.d.ts +94 -0
  86. package/dist/ddl/policy-ddl.d.ts +137 -0
  87. package/dist/ddl/routine-guards.d.ts +63 -0
  88. package/dist/ddl/sequence-ddl.d.ts +103 -0
  89. package/dist/ddl/sql-literal.d.ts +61 -0
  90. package/dist/ddl/table-ddl.d.ts +35 -0
  91. package/dist/ddl/trigger-ddl.d.ts +81 -0
  92. package/dist/ddl/view-ddl.d.ts +122 -0
  93. package/dist/decorators/association-applier.d.ts +18 -0
  94. package/dist/decorators/association-decorators.d.ts +72 -0
  95. package/dist/decorators/column-decorators.d.ts +147 -0
  96. package/dist/decorators/decorator-factory.d.ts +45 -0
  97. package/dist/decorators/decorator-signature.d.ts +26 -0
  98. package/dist/decorators/decorator-types.d.ts +24 -0
  99. package/dist/decorators/foreign-key-decorator.d.ts +21 -0
  100. package/dist/decorators/hook-decorators.d.ts +393 -0
  101. package/dist/decorators/init-arguments.d.ts +29 -0
  102. package/dist/decorators/model-decorators.d.ts +18 -0
  103. package/dist/decorators/model-metadata.d.ts +70 -0
  104. package/dist/decorators/table-decorators.d.ts +43 -0
  105. package/dist/decorators/timestamp-decorators.d.ts +38 -0
  106. package/dist/errors/base-error.d.ts +40 -0
  107. package/dist/errors/connection-errors.d.ts +152 -0
  108. package/dist/errors/database-errors.d.ts +152 -0
  109. package/dist/errors/errors.d.ts +5 -0
  110. package/dist/errors/map-pg-error.d.ts +27 -0
  111. package/dist/errors/misc-errors.d.ts +188 -0
  112. package/dist/errors/validation-errors.d.ts +117 -0
  113. package/dist/exports-core.d.ts +15 -0
  114. package/dist/exports-decorators.d.ts +8 -0
  115. package/dist/exports-errors.d.ts +2 -0
  116. package/dist/exports-model.d.ts +21 -0
  117. package/dist/exports-schema.d.ts +19 -0
  118. package/dist/expressions/call-expressions.d.ts +54 -0
  119. package/dist/expressions/condition-expressions.d.ts +51 -0
  120. package/dist/expressions/expression.d.ts +52 -0
  121. package/dist/expressions/jsonpath-helpers.d.ts +37 -0
  122. package/dist/expressions/methods.d.ts +188 -0
  123. package/dist/expressions/op.d.ts +182 -0
  124. package/dist/expressions/query-expressions.d.ts +110 -0
  125. package/dist/expressions/row-expressions.d.ts +35 -0
  126. package/dist/expressions/search-helpers.d.ts +138 -0
  127. package/dist/expressions/trigram-helpers.d.ts +40 -0
  128. package/dist/hooks/hooks.d.ts +125 -0
  129. package/dist/index.cjs +20461 -0
  130. package/dist/index.cjs.map +1 -0
  131. package/dist/index.d.ts +5 -0
  132. package/dist/index.js +20332 -0
  133. package/dist/index.js.map +1 -0
  134. package/dist/model/attribute-columns.d.ts +85 -0
  135. package/dist/model/attribute-normalizer.d.ts +42 -0
  136. package/dist/model/attribute-options.d.ts +121 -0
  137. package/dist/model/bulk-insert-builder.d.ts +24 -0
  138. package/dist/model/bulk-options.d.ts +173 -0
  139. package/dist/model/copy-options.d.ts +51 -0
  140. package/dist/model/cte-builder.d.ts +134 -0
  141. package/dist/model/definition-normalizer.d.ts +26 -0
  142. package/dist/model/delete-query-builder.d.ts +42 -0
  143. package/dist/model/find-options.d.ts +144 -0
  144. package/dist/model/find-query-builder.d.ts +38 -0
  145. package/dist/model/insert-query-builder.d.ts +41 -0
  146. package/dist/model/instance-destroyer.d.ts +44 -0
  147. package/dist/model/instance-lifecycle-services.d.ts +61 -0
  148. package/dist/model/instance-lifecycle.d.ts +128 -0
  149. package/dist/model/instance-saver.d.ts +25 -0
  150. package/dist/model/instance-state.d.ts +48 -0
  151. package/dist/model/instance-validation.d.ts +35 -0
  152. package/dist/model/instance-values.d.ts +80 -0
  153. package/dist/model/instance-writer.d.ts +59 -0
  154. package/dist/model/join-source-builder.d.ts +25 -0
  155. package/dist/model/lateral-keys-builder.d.ts +25 -0
  156. package/dist/model/merge-action-builder.d.ts +31 -0
  157. package/dist/model/merge-options.d.ts +72 -0
  158. package/dist/model/merge-query-builder.d.ts +29 -0
  159. package/dist/model/merge-source-builder.d.ts +22 -0
  160. package/dist/model/mixins/model-aggregates.d.ts +69 -0
  161. package/dist/model/mixins/model-associations.d.ts +73 -0
  162. package/dist/model/mixins/model-constructor.d.ts +7 -0
  163. package/dist/model/mixins/model-finders.d.ts +124 -0
  164. package/dist/model/mixins/model-hooks.d.ts +138 -0
  165. package/dist/model/mixins/model-postgres.d.ts +198 -0
  166. package/dist/model/mixins/model-schema-binding.d.ts +36 -0
  167. package/dist/model/mixins/model-schema.d.ts +55 -0
  168. package/dist/model/mixins/model-scopes.d.ts +57 -0
  169. package/dist/model/mixins/model-writers.d.ts +175 -0
  170. package/dist/model/mixins/named-hooks.d.ts +28 -0
  171. package/dist/model/model-accessors.d.ts +22 -0
  172. package/dist/model/model-base.d.ts +83 -0
  173. package/dist/model/model-definition.d.ts +130 -0
  174. package/dist/model/model-instance-persistence.d.ts +132 -0
  175. package/dist/model/model-instance-values.d.ts +154 -0
  176. package/dist/model/model-operations.d.ts +22 -0
  177. package/dist/model/model-registry.d.ts +139 -0
  178. package/dist/model/model-services.d.ts +46 -0
  179. package/dist/model/model-state.d.ts +60 -0
  180. package/dist/model/model-values.d.ts +86 -0
  181. package/dist/model/model.d.ts +560 -0
  182. package/dist/model/on-conflict-builder.d.ts +111 -0
  183. package/dist/model/operations/bulk-create-operation.d.ts +40 -0
  184. package/dist/model/operations/copy-from-source.d.ts +51 -0
  185. package/dist/model/operations/copy-operation.d.ts +54 -0
  186. package/dist/model/operations/count-operation.d.ts +52 -0
  187. package/dist/model/operations/create-operation.d.ts +31 -0
  188. package/dist/model/operations/destroy-operation.d.ts +65 -0
  189. package/dist/model/operations/find-cursor.d.ts +23 -0
  190. package/dist/model/operations/find-lookups.d.ts +89 -0
  191. package/dist/model/operations/find-operation.d.ts +47 -0
  192. package/dist/model/operations/increment-operation.d.ts +40 -0
  193. package/dist/model/operations/insert-operation.d.ts +71 -0
  194. package/dist/model/operations/merge-operation.d.ts +56 -0
  195. package/dist/model/operations/model-operation.d.ts +33 -0
  196. package/dist/model/operations/update-operation.d.ts +45 -0
  197. package/dist/model/operations/upsert-operation.d.ts +39 -0
  198. package/dist/model/options.d.ts +103 -0
  199. package/dist/model/returning-old.d.ts +52 -0
  200. package/dist/model/row-mapper.d.ts +78 -0
  201. package/dist/model/row-plan.d.ts +31 -0
  202. package/dist/model/runtime.d.ts +54 -0
  203. package/dist/model/scope-registry.d.ts +81 -0
  204. package/dist/model/select-aggregates.d.ts +37 -0
  205. package/dist/model/select-lock.d.ts +13 -0
  206. package/dist/model/select-options.d.ts +92 -0
  207. package/dist/model/select-query-builder.d.ts +73 -0
  208. package/dist/model/select-targets.d.ts +77 -0
  209. package/dist/model/source-option-builder.d.ts +23 -0
  210. package/dist/model/source-options.d.ts +108 -0
  211. package/dist/model/statement-builder.d.ts +77 -0
  212. package/dist/model/statement-services.d.ts +2 -0
  213. package/dist/model/sync-hooks.d.ts +18 -0
  214. package/dist/model/table-sample-builder.d.ts +13 -0
  215. package/dist/model/types.d.ts +85 -0
  216. package/dist/model/unnest-insert-builder.d.ts +24 -0
  217. package/dist/model/update-query-builder.d.ts +39 -0
  218. package/dist/model/v6-conflict-builder.d.ts +37 -0
  219. package/dist/model/value-cloner.d.ts +17 -0
  220. package/dist/model/values-writer.d.ts +12 -0
  221. package/dist/model/where-options.d.ts +164 -0
  222. package/dist/model/write-options.d.ts +160 -0
  223. package/dist/model/written-rows.d.ts +56 -0
  224. package/dist/query/query-result-shaper.d.ts +91 -0
  225. package/dist/query/raw-query.d.ts +27 -0
  226. package/dist/query-interface/alter-planner.d.ts +40 -0
  227. package/dist/query-interface/bulk-data.d.ts +44 -0
  228. package/dist/query-interface/column-commands.d.ts +52 -0
  229. package/dist/query-interface/column-describer.d.ts +17 -0
  230. package/dist/query-interface/enum-commands.d.ts +36 -0
  231. package/dist/query-interface/index-commands.d.ts +57 -0
  232. package/dist/query-interface/model-tables.d.ts +58 -0
  233. package/dist/query-interface/object-commands.d.ts +71 -0
  234. package/dist/query-interface/partition-commands.d.ts +43 -0
  235. package/dist/query-interface/policy-commands.d.ts +54 -0
  236. package/dist/query-interface/query-interface-objects.d.ts +108 -0
  237. package/dist/query-interface/query-interface-partitions.d.ts +66 -0
  238. package/dist/query-interface/query-interface-policies.d.ts +86 -0
  239. package/dist/query-interface/query-interface-routines.d.ts +120 -0
  240. package/dist/query-interface/query-interface-tables.d.ts +179 -0
  241. package/dist/query-interface/query-interface-types.d.ts +62 -0
  242. package/dist/query-interface/query-interface-views.d.ts +84 -0
  243. package/dist/query-interface/query-interface.d.ts +256 -0
  244. package/dist/query-interface/routine-commands.d.ts +71 -0
  245. package/dist/query-interface/schema-synchronizer.d.ts +99 -0
  246. package/dist/query-interface/statement-runner.d.ts +40 -0
  247. package/dist/query-interface/sync-planner.d.ts +26 -0
  248. package/dist/query-interface/table-commands.d.ts +63 -0
  249. package/dist/query-interface/table-introspector.d.ts +58 -0
  250. package/dist/query-interface/view-commands.d.ts +47 -0
  251. package/dist/sequelize/sequelize-base.d.ts +196 -0
  252. package/dist/sequelize/sequelize-constructor.d.ts +7 -0
  253. package/dist/sequelize/sequelize-hooks.d.ts +86 -0
  254. package/dist/sequelize/sequelize-internals.d.ts +87 -0
  255. package/dist/sequelize/sequelize-notifications.d.ts +66 -0
  256. package/dist/sequelize/sequelize-schema.d.ts +106 -0
  257. package/dist/sequelize/sequelize-transactions.d.ts +96 -0
  258. package/dist/sequelize.d.ts +790 -0
  259. package/dist/sql/ast-clauses.d.ts +137 -0
  260. package/dist/sql/ast-expressions.d.ts +88 -0
  261. package/dist/sql/ast-statements.d.ts +80 -0
  262. package/dist/sql/ast.d.ts +21 -0
  263. package/dist/sql/compile.d.ts +21 -0
  264. package/dist/sql/dml-compiler.d.ts +54 -0
  265. package/dist/sql/expression-compiler.d.ts +56 -0
  266. package/dist/sql/from-compiler.d.ts +39 -0
  267. package/dist/sql/identifier-quoter.d.ts +15 -0
  268. package/dist/sql/merge-compiler.d.ts +20 -0
  269. package/dist/sql/order.d.ts +15 -0
  270. package/dist/sql/query-compiler.d.ts +45 -0
  271. package/dist/sql/sql-chunks.d.ts +50 -0
  272. package/dist/sql/with-compiler.d.ts +19 -0
  273. package/dist/transaction/advisory-locks.d.ts +28 -0
  274. package/dist/transaction/transaction-constants.d.ts +35 -0
  275. package/dist/transaction/transaction-runner.d.ts +60 -0
  276. package/dist/transaction/transaction-starter.d.ts +25 -0
  277. package/dist/transaction/transaction-statements.d.ts +28 -0
  278. package/dist/transaction/transaction.d.ts +198 -0
  279. package/dist/validation/attribute-validators.d.ts +23 -0
  280. package/dist/validation/builtin-attribute-validator.d.ts +19 -0
  281. package/dist/validation/builtin-validators.d.ts +16 -0
  282. package/dist/validation/core-validator.d.ts +16 -0
  283. package/dist/validation/custom-validators.d.ts +13 -0
  284. package/dist/validation/instance-validator.d.ts +25 -0
  285. package/dist/validation/schema-items.d.ts +22 -0
  286. package/dist/validation/standard-schema-validator.d.ts +30 -0
  287. package/dist/validation/standard-schema.d.ts +39 -0
  288. package/dist/validation/types.d.ts +36 -0
  289. package/dist/validation/validation-target.d.ts +13 -0
  290. package/dist/where/comparison-compiler.d.ts +27 -0
  291. package/dist/where/condition-compiler.d.ts +18 -0
  292. package/dist/where/operand-resolver.d.ts +10 -0
  293. package/dist/where/operator-allowlist.d.ts +14 -0
  294. package/dist/where/where-support.d.ts +52 -0
  295. package/dist/where/where.d.ts +46 -0
  296. package/dist/where/window-compiler.d.ts +14 -0
  297. package/llm/USAGE.md +423 -0
  298. package/package.json +102 -4
  299. package/skills/postgrelize/SKILL.md +57 -0
  300. package/skills/postgrelize/reference/associations.md +108 -0
  301. package/skills/postgrelize/reference/errors.md +37 -0
  302. package/skills/postgrelize/reference/migrating-from-sequelize.md +15 -0
  303. package/skills/postgrelize/reference/postgresql-features.md +157 -0
  304. package/skills/postgrelize/reference/querying.md +111 -0
  305. package/skills/postgrelize/reference/schema.md +135 -0
  306. package/skills/postgrelize/reference/security.md +34 -0
  307. package/skills/postgrelize/reference/transactions-and-sessions.md +122 -0
  308. package/skills/postgrelize/reference/writing.md +198 -0
@@ -0,0 +1,73 @@
1
+ import { AttributeDefinition } from '../model/model-definition.ts';
2
+ import { ColumnDefinition, ColumnSqlOptions } from './ddl-types.ts';
3
+ import { EnumDdl } from './enum-ddl.ts';
4
+ import { TableName } from './sql-literal.ts';
5
+ /**
6
+ * Column parts of DDL: the SQL type, `DEFAULT`, `REFERENCES`, column definitions and comments.
7
+ *
8
+ * @internal
9
+ */
10
+ export declare class ColumnDdl {
11
+ #private;
12
+ /**
13
+ * @param enums - Enum type names.
14
+ */
15
+ constructor(enums: EnumDdl);
16
+ /**
17
+ * Converts a normalized attribute to a column definition.
18
+ *
19
+ * @param attribute - Normalized attribute.
20
+ * @returns Column definition.
21
+ */
22
+ columnOf(attribute: AttributeDefinition): ColumnDefinition;
23
+ /**
24
+ * SQL type of a column (SERIAL for auto-increment integers, enum type names).
25
+ *
26
+ * @param table - Table name or `{ tableName, schema }`.
27
+ * @param column - Column definition.
28
+ * @returns SQL type.
29
+ */
30
+ columnType(table: TableName, column: ColumnDefinition): string;
31
+ /**
32
+ * `DEFAULT ...` clause value.
33
+ *
34
+ * @param column - Column definition.
35
+ * @returns SQL of the default, or `undefined` for client-side defaults.
36
+ */
37
+ defaultSql(column: ColumnDefinition): string | undefined;
38
+ /**
39
+ * `REFERENCES ...` clause.
40
+ *
41
+ * @param column - Column definition.
42
+ * @param defaultSchema - Schema of the referenced table when it has none.
43
+ * @returns SQL of the clause, or `undefined` without references.
44
+ */
45
+ referencesSql(column: ColumnDefinition, defaultSchema?: string): string | undefined;
46
+ /**
47
+ * One column of `CREATE TABLE` / `ADD COLUMN`.
48
+ *
49
+ * @param table - Table name or `{ tableName, schema }`.
50
+ * @param column - Column definition.
51
+ * @param options - `inlinePrimaryKey` and the default schema of references.
52
+ * @returns Column SQL.
53
+ */
54
+ columnSql(table: TableName, column: ColumnDefinition, options?: ColumnSqlOptions): string;
55
+ /**
56
+ * `COMMENT ON COLUMN` for a column with a comment.
57
+ *
58
+ * @param table - Table name or `{ tableName, schema }`.
59
+ * @param column - Column name and comment.
60
+ * @returns The statement, or nothing without a comment.
61
+ */
62
+ commentSql(table: TableName, column: Readonly<{
63
+ field: string;
64
+ comment?: string;
65
+ }>): readonly string[];
66
+ /**
67
+ * Whether a `unique` option has `nullsNotDistinct: true`.
68
+ *
69
+ * @param unique - `unique` option of a column.
70
+ * @returns The flag.
71
+ */
72
+ nullsNotDistinct(unique: ColumnDefinition['unique']): boolean;
73
+ }
@@ -0,0 +1,30 @@
1
+ import { ConstraintOptions } from './ddl-types.ts';
2
+ import { TableName } from './sql-literal.ts';
3
+ /**
4
+ * `ALTER TABLE ... ADD CONSTRAINT` statements (check, unique, primary, foreign key and exclusion constraints).
5
+ *
6
+ * @internal
7
+ */
8
+ export declare class ConstraintDdl {
9
+ #private;
10
+ /**
11
+ * `ALTER TABLE ... ADD CONSTRAINT` statement.
12
+ *
13
+ * @param table - Table name or `{ tableName, schema }`.
14
+ * @param options - Constraint definition.
15
+ * @param defaultSchema - Schema used when a table reference has none.
16
+ * @returns Statement.
17
+ * @throws Error for an unknown constraint type, a foreign key without references, an `exclude`
18
+ * without elements or a `notValid` on a constraint that cannot be `NOT VALID`.
19
+ */
20
+ addConstraintSql(table: TableName, options: ConstraintOptions, defaultSchema?: string): string;
21
+ /**
22
+ * `ALTER TABLE ... VALIDATE CONSTRAINT` statement.
23
+ *
24
+ * @param table - Table name or `{ tableName, schema }`.
25
+ * @param name - Constraint name.
26
+ * @param defaultSchema - Schema used when the table reference has none.
27
+ * @returns Statement.
28
+ */
29
+ validateConstraintSql(table: TableName, name: string, defaultSchema?: string): string;
30
+ }
@@ -0,0 +1,181 @@
1
+ import { AttributeDefinition } from '../model/model-definition.ts';
2
+ import { ColumnDefinition, ConstraintOptions, CreateTableOptions, DeferrableValue, IndexField, IndexOptions } from './ddl-types.ts';
3
+ import { CreatePartitionOptions, DetachPartitionOptions } from './partition-ddl.ts';
4
+ import { PartitionBoundSpec } from './partition-types.ts';
5
+ import { TableName } from './sql-literal.ts';
6
+ export { Deferrable, type ColumnDefinition, type ConstraintOptions, type DeferrableValue, type ExcludeElement, type IndexField, type IndexOptions, } from './ddl-types.ts';
7
+ /**
8
+ * Generates DDL statements (tables, columns, enum types, indexes, constraints, comments,
9
+ * references) for PostgreSQL. Values are inlined as escaped literals.
10
+ *
11
+ * @internal
12
+ */
13
+ export declare class DdlGenerator {
14
+ #private;
15
+ /**
16
+ * SQL of a `Deferrable` value; anything that is not one of them is rejected.
17
+ *
18
+ * @internal
19
+ */
20
+ static deferrableSql(value: DeferrableValue): string;
21
+ /**
22
+ * Converts a normalized attribute to a column definition.
23
+ *
24
+ * @param attribute - Normalized attribute.
25
+ * @returns Column definition.
26
+ */
27
+ columnOf(attribute: AttributeDefinition): ColumnDefinition;
28
+ /**
29
+ * Name of the PostgreSQL enum type of a column (`enum_<table>_<column>`, v6).
30
+ *
31
+ * @param table - Table name or `{ tableName, schema }`.
32
+ * @param field - Column name.
33
+ * @returns Unquoted enum type name.
34
+ */
35
+ enumTypeName(table: TableName, field: string): string;
36
+ /**
37
+ * SQL type of a column (SERIAL for auto-increment integers, enum type names).
38
+ *
39
+ * @param table - Table name or `{ tableName, schema }`.
40
+ * @param column - Column definition.
41
+ * @returns SQL type.
42
+ */
43
+ columnType(table: TableName, column: ColumnDefinition): string;
44
+ /**
45
+ * `DEFAULT ...` clause value.
46
+ *
47
+ * @param column - Column definition.
48
+ * @returns SQL of the default, or `undefined` for client-side defaults.
49
+ */
50
+ defaultSql(column: ColumnDefinition): string | undefined;
51
+ /**
52
+ * `REFERENCES ...` clause.
53
+ *
54
+ * @param column - Column definition.
55
+ * @param defaultSchema - Schema of the referenced table when it has none.
56
+ * @returns SQL of the clause, or `undefined` without references.
57
+ */
58
+ referencesSql(column: ColumnDefinition, defaultSchema?: string): string | undefined;
59
+ /**
60
+ * One column of `CREATE TABLE` / `ADD COLUMN`.
61
+ *
62
+ * @param table - Table name or `{ tableName, schema }`.
63
+ * @param column - Column definition.
64
+ * @param options - `inlinePrimaryKey` and the default schema of references.
65
+ * @returns Column SQL.
66
+ */
67
+ columnSql(table: TableName, column: ColumnDefinition, options?: Readonly<{
68
+ inlinePrimaryKey?: boolean;
69
+ defaultSchema?: string;
70
+ }>): string;
71
+ /**
72
+ * `CREATE TYPE ... AS ENUM` wrapped so an existing type is not an error (v6).
73
+ *
74
+ * @param table - Table name or `{ tableName, schema }`.
75
+ * @param column - Column definition.
76
+ * @returns Statement, or `undefined` for non-enum columns.
77
+ */
78
+ createEnumSql(table: TableName, column: ColumnDefinition): string | undefined;
79
+ /**
80
+ * Statements creating a table: enum types, `CREATE TABLE IF NOT EXISTS`, comments.
81
+ *
82
+ * @param table - Table name or `{ tableName, schema }`.
83
+ * @param columns - Column definitions.
84
+ * @param options - Table comment, persistence (`unlogged`, `temporary`), default schema and `ifNotExists` (default true).
85
+ * @returns Statements in execution order.
86
+ */
87
+ createTableSql(table: TableName, columns: readonly ColumnDefinition[], options?: CreateTableOptions): readonly string[];
88
+ /**
89
+ * `COMMENT ON COLUMN` for a column with a comment.
90
+ *
91
+ * @param table - Table name or `{ tableName, schema }`.
92
+ * @param column - Column name and comment.
93
+ * @returns The statement, or nothing without a comment.
94
+ */
95
+ columnCommentSql(table: TableName, column: Readonly<{
96
+ field: string;
97
+ comment?: string;
98
+ }>): readonly string[];
99
+ /**
100
+ * `ALTER TYPE ... ADD VALUE IF NOT EXISTS` for every enum value of a column.
101
+ *
102
+ * @param table - Table name or `{ tableName, schema }`.
103
+ * @param column - Column definition.
104
+ * @returns Statements; empty for non-enum columns.
105
+ */
106
+ addEnumValuesSql(table: TableName, column: ColumnDefinition): readonly string[];
107
+ /**
108
+ * `ALTER TABLE ... ALTER COLUMN` statements bringing a column to its definition (v6 changeColumn).
109
+ *
110
+ * @param table - Table name or `{ tableName, schema }`.
111
+ * @param column - Column definition.
112
+ * @param defaultSchema - Schema used when the table reference has none.
113
+ * @returns Statements in execution order.
114
+ */
115
+ changeColumnSql(table: TableName, column: ColumnDefinition, defaultSchema?: string): readonly string[];
116
+ /**
117
+ * Default index name (v6 `Utils.nameIndex`).
118
+ *
119
+ * @param table - Table name or `{ tableName, schema }`.
120
+ * @param fields - Indexed fields.
121
+ * @returns Index name.
122
+ */
123
+ indexName(table: TableName, fields: readonly IndexField[]): string;
124
+ /**
125
+ * `CREATE [UNIQUE] INDEX` statement.
126
+ *
127
+ * @param table - Table name or `{ tableName, schema }`.
128
+ * @param options - Index options.
129
+ * @param defaultSchema - Schema used when the table reference has none.
130
+ * @returns Statement.
131
+ * @throws Error without fields or with an invalid method / operator class.
132
+ */
133
+ createIndexSql(table: TableName, options: IndexOptions, defaultSchema?: string): string;
134
+ /**
135
+ * `ALTER TABLE ... ADD CONSTRAINT` statement.
136
+ *
137
+ * @param table - Table name or `{ tableName, schema }`.
138
+ * @param options - Constraint definition.
139
+ * @param defaultSchema - Schema used when a table reference has none.
140
+ * @returns Statement.
141
+ * @throws Error for an unknown constraint type or a foreign key without references.
142
+ */
143
+ addConstraintSql(table: TableName, options: ConstraintOptions, defaultSchema?: string): string;
144
+ /**
145
+ * `ALTER TABLE ... VALIDATE CONSTRAINT` statement.
146
+ *
147
+ * @param table - Table name or `{ tableName, schema }`.
148
+ * @param name - Constraint name.
149
+ * @param defaultSchema - Schema used when the table reference has none.
150
+ * @returns Statement.
151
+ */
152
+ validateConstraintSql(table: TableName, name: string, defaultSchema?: string): string;
153
+ /**
154
+ * `CREATE TABLE ... PARTITION OF` statement.
155
+ *
156
+ * @param parent - Partitioned table.
157
+ * @param partition - New partition name.
158
+ * @param bound - Bounds.
159
+ * @param options - Sub-partitioning and `ifNotExists`.
160
+ * @returns Statement.
161
+ */
162
+ createPartitionSql(parent: TableName, partition: TableName, bound: PartitionBoundSpec, options?: CreatePartitionOptions): string;
163
+ /**
164
+ * `ALTER TABLE ... ATTACH PARTITION` statement.
165
+ *
166
+ * @param parent - Partitioned table.
167
+ * @param partition - Existing table to attach.
168
+ * @param bound - Bounds.
169
+ * @returns Statement.
170
+ */
171
+ attachPartitionSql(parent: TableName, partition: TableName, bound: PartitionBoundSpec): string;
172
+ /**
173
+ * `ALTER TABLE ... DETACH PARTITION` statement.
174
+ *
175
+ * @param parent - Partitioned table.
176
+ * @param partition - Partition to detach.
177
+ * @param options - `concurrently` or `finalize`.
178
+ * @returns Statement.
179
+ */
180
+ detachPartitionSql(parent: TableName, partition: TableName, options?: DetachPartitionOptions): string;
181
+ }
@@ -0,0 +1,60 @@
1
+ import { DeferrableValue } from './ddl-types.ts';
2
+ /**
3
+ * Allowlists for the DDL keywords that cannot be quoted: referential actions, deferrable modes,
4
+ * index methods and operator classes (ADR-020).
5
+ *
6
+ * @internal
7
+ */
8
+ export declare class DdlGuards {
9
+ /**
10
+ * SQL of a `Deferrable` value; anything that is not one of them is rejected.
11
+ *
12
+ * @param value - Deferrable value.
13
+ * @returns SQL of the mode.
14
+ * @throws Error for anything but a `Deferrable` constant.
15
+ */
16
+ deferrableSql(value: DeferrableValue): string;
17
+ /**
18
+ * Normalized referential action (`ON DELETE` / `ON UPDATE`).
19
+ *
20
+ * @param action - Action as given.
21
+ * @returns Upper-case action.
22
+ * @throws Error for an action outside the allowlist.
23
+ */
24
+ action(action: string): string;
25
+ /**
26
+ * A plain identifier word (index method, operator class), rendered unquoted.
27
+ *
28
+ * @param value - Word.
29
+ * @param kind - Kind named in the error.
30
+ * @returns The word.
31
+ * @throws Error for anything but `[A-Za-z_][\w]*`.
32
+ */
33
+ word(value: string, kind: string): string;
34
+ /**
35
+ * An operator symbol (EXCLUDE `WITH` operator), rendered unquoted.
36
+ *
37
+ * @param value - Operator such as `&&` or `=`.
38
+ * @returns The operator.
39
+ * @throws Error for anything but 1-63 operator characters, or one that opens a comment.
40
+ */
41
+ operator(value: string): string;
42
+ /**
43
+ * A whole number rendered into DDL (sequence bounds, cache size); anything else is rejected.
44
+ *
45
+ * @param value - Number or bigint.
46
+ * @param kind - Kind named in the error.
47
+ * @returns Decimal text of the number.
48
+ * @throws Error for non-integers and unsafe numbers.
49
+ */
50
+ integer(value: number | bigint, kind: string): string;
51
+ /**
52
+ * ` ON DELETE ... ON UPDATE ... <deferrable>` suffix of a foreign key; empty parts are omitted.
53
+ *
54
+ * @param onDelete - `ON DELETE` action.
55
+ * @param onUpdate - `ON UPDATE` action.
56
+ * @param deferrable - Deferrable mode.
57
+ * @returns SQL suffix.
58
+ */
59
+ foreignKeySuffix(onDelete: string | undefined, onUpdate: string | undefined, deferrable: DeferrableValue | undefined): string;
60
+ }
@@ -0,0 +1,193 @@
1
+ import { DataType } from '../data-types/data-types.ts';
2
+ import { AttributeDefinition } from '../model/model-definition.ts';
3
+ import { PartitionKey } from './partition-types.ts';
4
+ import { TableName } from './sql-literal.ts';
5
+ /** `Deferrable` setting of a foreign key or transaction (Sequelize v6 `Deferrable`). */
6
+ export type DeferrableValue = Readonly<{
7
+ /** SQL of the mode, e.g. `DEFERRABLE INITIALLY DEFERRED`. */
8
+ sql: string;
9
+ }>;
10
+ /**
11
+ * Deferrable constraint modes (Sequelize v6 `Deferrable`).
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * await queryInterface.addColumn('posts', 'userId', {
16
+ * type: DataTypes.INTEGER,
17
+ * references: { model: 'Users', key: 'id', deferrable: Deferrable.INITIALLY_DEFERRED },
18
+ * });
19
+ * ```
20
+ */
21
+ export declare const Deferrable: {
22
+ /** `DEFERRABLE INITIALLY IMMEDIATE`. */
23
+ readonly INITIALLY_IMMEDIATE: Readonly<Readonly<{
24
+ /** SQL of the mode, e.g. `DEFERRABLE INITIALLY DEFERRED`. */
25
+ sql: string;
26
+ }>>;
27
+ /** `DEFERRABLE INITIALLY DEFERRED`. */
28
+ readonly INITIALLY_DEFERRED: Readonly<Readonly<{
29
+ /** SQL of the mode, e.g. `DEFERRABLE INITIALLY DEFERRED`. */
30
+ sql: string;
31
+ }>>;
32
+ /** `NOT DEFERRABLE`. */
33
+ readonly NOT: Readonly<Readonly<{
34
+ /** SQL of the mode, e.g. `DEFERRABLE INITIALLY DEFERRED`. */
35
+ sql: string;
36
+ }>>;
37
+ };
38
+ /** Column definition as used by DDL builders. */
39
+ export type ColumnDefinition = Readonly<{
40
+ name: string;
41
+ field: string;
42
+ type: DataType;
43
+ allowNull: boolean;
44
+ primaryKey: boolean;
45
+ autoIncrement: boolean;
46
+ defaultValue: unknown;
47
+ unique: AttributeDefinition['unique'];
48
+ comment: string | undefined;
49
+ references: AttributeDefinition['references'];
50
+ onDelete: string | undefined;
51
+ onUpdate: string | undefined;
52
+ identity: 'always' | 'byDefault' | undefined;
53
+ generated: AttributeDefinition['generated'];
54
+ }>;
55
+ /** Modifiers shared by every index element. */
56
+ type IndexElementModifiers = Readonly<{
57
+ /** `ASC` / `DESC`. */
58
+ order?: 'ASC' | 'DESC';
59
+ /** `NULLS FIRST` / `NULLS LAST`. PostgreSQL extension. */
60
+ nulls?: 'FIRST' | 'LAST';
61
+ /** Collation name (quoted identifier). */
62
+ collate?: string;
63
+ /** Operator class, e.g. `'jsonb_path_ops'`. */
64
+ operator?: string;
65
+ }>;
66
+ /**
67
+ * Index field: a column name, `{ name, order, nulls, collate, operator }` or an expression
68
+ * `{ expression, ... }`. The `expression` is trusted SQL (not escaped): never build it from user
69
+ * input. An index with an expression field needs an explicit `name`.
70
+ */
71
+ export type IndexField = string | (IndexElementModifiers & Readonly<{
72
+ /** Column name. */
73
+ name: string;
74
+ /** Not used for a column field. */
75
+ expression?: undefined;
76
+ }>) | (IndexElementModifiers & Readonly<{
77
+ /** Trusted SQL expression, wrapped in parentheses. */
78
+ expression: string;
79
+ /** Not used for an expression field. */
80
+ name?: undefined;
81
+ }>);
82
+ /**
83
+ * Options of `addIndex` and model `indexes` (Sequelize v6 `IndexesOptions`).
84
+ *
85
+ * @example
86
+ * ```ts
87
+ * const options: IndexOptions = {
88
+ * fields: ['email'],
89
+ * unique: true,
90
+ * where: { active: true },
91
+ * using: 'btree',
92
+ * };
93
+ * await queryInterface.addIndex('users', options);
94
+ * ```
95
+ */
96
+ export type IndexOptions = Readonly<{
97
+ /** Indexed columns. */
98
+ fields?: readonly IndexField[];
99
+ /** Index name; default `underscore(<table>_<fields>)`. Required when a field is an expression. */
100
+ name?: string;
101
+ /** Unique index. */
102
+ unique?: boolean;
103
+ /** `NULLS NOT DISTINCT` for unique indexes. PostgreSQL extension. */
104
+ nullsNotDistinct?: boolean;
105
+ /** Index method: `btree`, `hash`, `gist`, `gin`, `brin`, ... */
106
+ using?: string;
107
+ /** Default operator class for all fields. */
108
+ operator?: string;
109
+ /** Partial index predicate. */
110
+ where?: unknown;
111
+ /** `CREATE INDEX CONCURRENTLY`. */
112
+ concurrently?: boolean;
113
+ /** Covering index columns (`INCLUDE (...)`). */
114
+ include?: readonly string[];
115
+ /** `IF NOT EXISTS`. */
116
+ ifNotExists?: boolean;
117
+ }>;
118
+ /**
119
+ * One element of an `exclude` constraint: an index field plus the operator it is compared with.
120
+ * The `expression`, when used, is trusted SQL.
121
+ */
122
+ export type ExcludeElement = Exclude<IndexField, string> & Readonly<{
123
+ /** Exclusion operator, e.g. `'&&'` or `'='` (operator characters only). */
124
+ with: string;
125
+ }>;
126
+ /**
127
+ * Options of `addConstraint` (Sequelize v6).
128
+ *
129
+ * @example
130
+ * ```ts
131
+ * const options: ConstraintOptions = {
132
+ * type: 'foreign key',
133
+ * fields: ['userId'],
134
+ * name: 'posts_user_fk',
135
+ * references: { table: 'users', field: 'id' },
136
+ * onDelete: 'CASCADE',
137
+ * };
138
+ * await queryInterface.addConstraint('posts', options);
139
+ * ```
140
+ */
141
+ export type ConstraintOptions = Readonly<{
142
+ /** Constraint kind. */
143
+ type: 'check' | 'unique' | 'primary key' | 'foreign key' | 'exclude' | 'CHECK' | 'UNIQUE' | 'PRIMARY KEY' | 'FOREIGN KEY' | 'EXCLUDE';
144
+ /** Constrained columns. Not used by `exclude` (see `exclude`). */
145
+ fields?: readonly string[];
146
+ /** Constraint name. */
147
+ name?: string;
148
+ /** Check condition, or the partial predicate of an `exclude` constraint (where object). */
149
+ where?: unknown;
150
+ /** Foreign key target. */
151
+ references?: Readonly<{
152
+ /** Referenced table. */ table: TableName;
153
+ /** Referenced column. */ field: string;
154
+ /** Referenced columns, replacing `field` (needed with `period`). */ fields?: readonly string[];
155
+ }>;
156
+ /** `ON DELETE` action. */
157
+ onDelete?: string;
158
+ /** `ON UPDATE` action. */
159
+ onUpdate?: string;
160
+ /** Deferrable mode. */
161
+ deferrable?: DeferrableValue;
162
+ /** `NULLS NOT DISTINCT` for unique constraints. PostgreSQL extension. */
163
+ nullsNotDistinct?: boolean;
164
+ /** Exclusion elements: `{ column | expression, with }`. Required by `exclude`. PostgreSQL extension. */
165
+ exclude?: readonly ExcludeElement[];
166
+ /** Index method of an `exclude` constraint (`gist`, `spgist`, `btree`, ...). */
167
+ using?: string;
168
+ /** Covering columns of an `exclude` constraint (`INCLUDE (...)`). */
169
+ include?: readonly string[];
170
+ /** Last field of a `unique` / `primary key` constraint is `WITHOUT OVERLAPS` (temporal key, PostgreSQL 18). */
171
+ withoutOverlaps?: boolean;
172
+ /** Last field (and last referenced field) of a foreign key is `PERIOD` (PostgreSQL 18). */
173
+ period?: boolean;
174
+ /** `false` adds `NOT ENFORCED` (check and foreign key, PostgreSQL 18). */
175
+ enforced?: boolean;
176
+ /** Adds `NOT VALID` (check and foreign key only); run `validateConstraint` later. PostgreSQL extension. */
177
+ notValid?: boolean;
178
+ }>;
179
+ /** Options of a column inside `CREATE TABLE` / `ADD COLUMN`. */
180
+ export type ColumnSqlOptions = Readonly<{
181
+ inlinePrimaryKey?: boolean;
182
+ defaultSchema?: string;
183
+ }>;
184
+ /** Options of `CREATE TABLE`. */
185
+ export type CreateTableOptions = Readonly<{
186
+ comment?: string;
187
+ unlogged?: boolean;
188
+ temporary?: boolean;
189
+ defaultSchema?: string;
190
+ ifNotExists?: boolean;
191
+ partitionBy?: PartitionKey;
192
+ }>;
193
+ export {};
@@ -0,0 +1,42 @@
1
+ import { ColumnDefinition } from './ddl-types.ts';
2
+ import { TableName } from './sql-literal.ts';
3
+ /**
4
+ * PostgreSQL enum types of `ENUM` and `ARRAY(ENUM)` columns (`enum_<table>_<column>`, v6).
5
+ *
6
+ * @internal
7
+ */
8
+ export declare class EnumDdl {
9
+ #private;
10
+ /**
11
+ * Name of the PostgreSQL enum type of a column (`enum_<table>_<column>`, v6).
12
+ *
13
+ * @param table - Table name or `{ tableName, schema }`.
14
+ * @param field - Column name.
15
+ * @returns Unquoted enum type name.
16
+ */
17
+ typeName(table: TableName, field: string): string;
18
+ /**
19
+ * Quoted, schema-qualified enum type of a column.
20
+ *
21
+ * @param table - Table name or `{ tableName, schema }`.
22
+ * @param field - Column name.
23
+ * @returns Quoted type name.
24
+ */
25
+ quotedType(table: TableName, field: string): string;
26
+ /**
27
+ * `CREATE TYPE ... AS ENUM` wrapped so an existing type is not an error (v6).
28
+ *
29
+ * @param table - Table name or `{ tableName, schema }`.
30
+ * @param column - Column definition.
31
+ * @returns Statement, or `undefined` for non-enum columns.
32
+ */
33
+ createSql(table: TableName, column: ColumnDefinition): string | undefined;
34
+ /**
35
+ * `ALTER TYPE ... ADD VALUE IF NOT EXISTS` for every enum value of a column.
36
+ *
37
+ * @param table - Table name or `{ tableName, schema }`.
38
+ * @param column - Column definition.
39
+ * @returns Statements; empty for non-enum columns.
40
+ */
41
+ addValuesSql(table: TableName, column: ColumnDefinition): readonly string[];
42
+ }
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Options of `createExtension`.
3
+ *
4
+ * @example
5
+ * ```ts
6
+ * const options: CreateExtensionOptions = { ifNotExists: true, schema: 'public' };
7
+ * await queryInterface.createExtension('pg_trgm', options);
8
+ * ```
9
+ */
10
+ export type CreateExtensionOptions = Readonly<{
11
+ /** Adds `IF NOT EXISTS`. */
12
+ ifNotExists?: boolean;
13
+ /** Schema that receives the extension objects. */
14
+ schema?: string;
15
+ /** Extension version to install. */
16
+ version?: string;
17
+ /** Also installs the extensions it depends on. */
18
+ cascade?: boolean;
19
+ }>;
20
+ /**
21
+ * Options of `dropExtension`.
22
+ *
23
+ * @example
24
+ * ```ts
25
+ * const options: DropExtensionOptions = { ifExists: true, cascade: true };
26
+ * await queryInterface.dropExtension('pg_trgm', options);
27
+ * ```
28
+ */
29
+ export type DropExtensionOptions = Readonly<{
30
+ /** Adds `IF EXISTS`. */
31
+ ifExists?: boolean;
32
+ /** Also drops objects that depend on the extension. */
33
+ cascade?: boolean;
34
+ }>;
35
+ /**
36
+ * `CREATE EXTENSION` and `DROP EXTENSION` statements.
37
+ *
38
+ * @internal
39
+ */
40
+ export declare class ExtensionDdl {
41
+ /**
42
+ * `CREATE EXTENSION` statement.
43
+ *
44
+ * @param name - Extension name.
45
+ * @param options - Statement options.
46
+ * @returns Statement.
47
+ */
48
+ createSql(name: string, options: CreateExtensionOptions): string;
49
+ /**
50
+ * `DROP EXTENSION` statement.
51
+ *
52
+ * @param name - Extension name.
53
+ * @param options - Statement options.
54
+ * @returns Statement.
55
+ */
56
+ dropSql(name: string, options: DropExtensionOptions): string;
57
+ }