postgrelize 0.0.0-stage → 1.1.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 (319) hide show
  1. package/CHANGELOG.md +289 -0
  2. package/LICENSE +21 -0
  3. package/README.md +131 -2
  4. package/dist/associations/alias-minifier.d.ts +43 -0
  5. package/dist/associations/association-accessors.d.ts +21 -0
  6. package/dist/associations/association-key-types.d.ts +44 -0
  7. package/dist/associations/association-keys.d.ts +98 -0
  8. package/dist/associations/association-lookup.d.ts +26 -0
  9. package/dist/associations/association-shape.d.ts +25 -0
  10. package/dist/associations/association.d.ts +95 -0
  11. package/dist/associations/belongs-to-many.d.ts +86 -0
  12. package/dist/associations/belongs-to.d.ts +45 -0
  13. package/dist/associations/has-many.d.ts +79 -0
  14. package/dist/associations/has-one.d.ts +44 -0
  15. package/dist/associations/include-assembler.d.ts +21 -0
  16. package/dist/associations/include-columns.d.ts +24 -0
  17. package/dist/associations/include-joins.d.ts +17 -0
  18. package/dist/associations/include-loader.d.ts +48 -0
  19. package/dist/associations/include-order.d.ts +22 -0
  20. package/dist/associations/include-query-builder.d.ts +54 -0
  21. package/dist/associations/include-resolver.d.ts +29 -0
  22. package/dist/associations/include-rows.d.ts +47 -0
  23. package/dist/associations/include-sub-query.d.ts +35 -0
  24. package/dist/associations/include.d.ts +112 -0
  25. package/dist/associations/junction-keys.d.ts +23 -0
  26. package/dist/associations/nested-creator.d.ts +44 -0
  27. package/dist/associations/nested-saver.d.ts +30 -0
  28. package/dist/associations/owner-keys.d.ts +34 -0
  29. package/dist/associations/separate-include-loader.d.ts +24 -0
  30. package/dist/associations/types.d.ts +139 -0
  31. package/dist/connection/after-connect-hook.d.ts +24 -0
  32. package/dist/connection/connect-hooks.d.ts +26 -0
  33. package/dist/connection/connection-config.d.ts +33 -0
  34. package/dist/connection/connection-manager.d.ts +65 -0
  35. package/dist/connection/connection-types.d.ts +21 -0
  36. package/dist/connection/copy-from-stdin.d.ts +52 -0
  37. package/dist/connection/copy-runner.d.ts +30 -0
  38. package/dist/connection/copy-to-stdout.d.ts +49 -0
  39. package/dist/connection/copy.d.ts +22 -0
  40. package/dist/connection/notifications.d.ts +28 -0
  41. package/dist/connection/options.d.ts +165 -0
  42. package/dist/connection/query-logger.d.ts +41 -0
  43. package/dist/connection/replica-router.d.ts +20 -0
  44. package/dist/connection/statement-cache.d.ts +36 -0
  45. package/dist/connection/statement-timeout.d.ts +22 -0
  46. package/dist/data-types/abstract-data-type.d.ts +58 -0
  47. package/dist/data-types/array-literal-parser.d.ts +17 -0
  48. package/dist/data-types/array-type.d.ts +18 -0
  49. package/dist/data-types/bit-type.d.ts +14 -0
  50. package/dist/data-types/blob-type.d.ts +12 -0
  51. package/dist/data-types/char-type.d.ts +12 -0
  52. package/dist/data-types/composite-fields.d.ts +26 -0
  53. package/dist/data-types/composite-type.d.ts +32 -0
  54. package/dist/data-types/data-types.d.ts +176 -0
  55. package/dist/data-types/date-type.d.ts +14 -0
  56. package/dist/data-types/decimal-type.d.ts +13 -0
  57. package/dist/data-types/default-value-generator.d.ts +15 -0
  58. package/dist/data-types/enum-type.d.ts +19 -0
  59. package/dist/data-types/ewkb-reader.d.ts +18 -0
  60. package/dist/data-types/ewkb-writer.d.ts +17 -0
  61. package/dist/data-types/float-type.d.ts +12 -0
  62. package/dist/data-types/geometric-text.d.ts +65 -0
  63. package/dist/data-types/geometric-type.d.ts +46 -0
  64. package/dist/data-types/hstore-type.d.ts +16 -0
  65. package/dist/data-types/integer-type.d.ts +24 -0
  66. package/dist/data-types/json-type.d.ts +16 -0
  67. package/dist/data-types/multirange-type.d.ts +19 -0
  68. package/dist/data-types/range-type.d.ts +28 -0
  69. package/dist/data-types/record-text.d.ts +29 -0
  70. package/dist/data-types/scalar-type.d.ts +13 -0
  71. package/dist/data-types/spatial-type.d.ts +20 -0
  72. package/dist/data-types/string-type.d.ts +12 -0
  73. package/dist/data-types/text-type.d.ts +12 -0
  74. package/dist/data-types/timestamp-type.d.ts +15 -0
  75. package/dist/data-types/virtual-type.d.ts +15 -0
  76. package/dist/data-types/wall-clock.d.ts +14 -0
  77. package/dist/ddl/column-ddl.d.ts +73 -0
  78. package/dist/ddl/constraint-ddl.d.ts +30 -0
  79. package/dist/ddl/ddl-generator.d.ts +181 -0
  80. package/dist/ddl/ddl-guards.d.ts +60 -0
  81. package/dist/ddl/ddl-types.d.ts +204 -0
  82. package/dist/ddl/enum-ddl.d.ts +42 -0
  83. package/dist/ddl/extension-ddl.d.ts +57 -0
  84. package/dist/ddl/function-ddl.d.ts +98 -0
  85. package/dist/ddl/index-ddl.d.ts +29 -0
  86. package/dist/ddl/index-element-ddl.d.ts +19 -0
  87. package/dist/ddl/partition-ddl.d.ts +88 -0
  88. package/dist/ddl/partition-types.d.ts +94 -0
  89. package/dist/ddl/policy-ddl.d.ts +137 -0
  90. package/dist/ddl/routine-guards.d.ts +63 -0
  91. package/dist/ddl/sequence-ddl.d.ts +103 -0
  92. package/dist/ddl/sql-literal.d.ts +61 -0
  93. package/dist/ddl/table-ddl.d.ts +35 -0
  94. package/dist/ddl/trigger-ddl.d.ts +81 -0
  95. package/dist/ddl/view-ddl.d.ts +122 -0
  96. package/dist/decorators/association-applier.d.ts +18 -0
  97. package/dist/decorators/association-decorators.d.ts +72 -0
  98. package/dist/decorators/column-decorators.d.ts +147 -0
  99. package/dist/decorators/decorator-factory.d.ts +45 -0
  100. package/dist/decorators/decorator-signature.d.ts +26 -0
  101. package/dist/decorators/decorator-types.d.ts +24 -0
  102. package/dist/decorators/foreign-key-decorator.d.ts +21 -0
  103. package/dist/decorators/hook-decorators.d.ts +393 -0
  104. package/dist/decorators/init-arguments.d.ts +29 -0
  105. package/dist/decorators/model-decorators.d.ts +18 -0
  106. package/dist/decorators/model-metadata.d.ts +70 -0
  107. package/dist/decorators/table-decorators.d.ts +43 -0
  108. package/dist/decorators/timestamp-decorators.d.ts +38 -0
  109. package/dist/errors/base-error.d.ts +40 -0
  110. package/dist/errors/connection-errors.d.ts +152 -0
  111. package/dist/errors/database-errors.d.ts +186 -0
  112. package/dist/errors/errors.d.ts +5 -0
  113. package/dist/errors/map-pg-error.d.ts +27 -0
  114. package/dist/errors/misc-errors.d.ts +232 -0
  115. package/dist/errors/validation-errors.d.ts +141 -0
  116. package/dist/exports-associations.d.ts +6 -0
  117. package/dist/exports-core.d.ts +95 -0
  118. package/dist/exports-decorators.d.ts +8 -0
  119. package/dist/exports-errors.d.ts +2 -0
  120. package/dist/exports-model.d.ts +21 -0
  121. package/dist/exports-schema.d.ts +19 -0
  122. package/dist/expressions/call-expressions.d.ts +54 -0
  123. package/dist/expressions/condition-expressions.d.ts +51 -0
  124. package/dist/expressions/expression.d.ts +52 -0
  125. package/dist/expressions/jsonpath-helpers.d.ts +37 -0
  126. package/dist/expressions/logic.d.ts +25 -0
  127. package/dist/expressions/methods.d.ts +188 -0
  128. package/dist/expressions/op.d.ts +182 -0
  129. package/dist/expressions/query-expressions.d.ts +110 -0
  130. package/dist/expressions/row-expressions.d.ts +35 -0
  131. package/dist/expressions/search-helpers.d.ts +138 -0
  132. package/dist/expressions/trigram-helpers.d.ts +40 -0
  133. package/dist/hooks/hooks.d.ts +125 -0
  134. package/dist/index.cjs +21864 -0
  135. package/dist/index.cjs.map +1 -0
  136. package/dist/index.d.ts +6 -0
  137. package/dist/index.js +21688 -0
  138. package/dist/index.js.map +1 -0
  139. package/dist/model/attribute-columns.d.ts +85 -0
  140. package/dist/model/attribute-normalizer.d.ts +42 -0
  141. package/dist/model/attribute-options.d.ts +121 -0
  142. package/dist/model/bulk-insert-builder.d.ts +24 -0
  143. package/dist/model/bulk-options.d.ts +173 -0
  144. package/dist/model/copy-options.d.ts +51 -0
  145. package/dist/model/cte-builder.d.ts +134 -0
  146. package/dist/model/definition-normalizer.d.ts +26 -0
  147. package/dist/model/delete-query-builder.d.ts +42 -0
  148. package/dist/model/find-options.d.ts +144 -0
  149. package/dist/model/find-query-builder.d.ts +38 -0
  150. package/dist/model/inflector.d.ts +28 -0
  151. package/dist/model/insert-query-builder.d.ts +41 -0
  152. package/dist/model/instance-destroyer.d.ts +44 -0
  153. package/dist/model/instance-lifecycle-services.d.ts +61 -0
  154. package/dist/model/instance-lifecycle.d.ts +128 -0
  155. package/dist/model/instance-saver.d.ts +25 -0
  156. package/dist/model/instance-state.d.ts +48 -0
  157. package/dist/model/instance-validation.d.ts +35 -0
  158. package/dist/model/instance-values.d.ts +88 -0
  159. package/dist/model/instance-writer.d.ts +59 -0
  160. package/dist/model/join-source-builder.d.ts +25 -0
  161. package/dist/model/lateral-keys-builder.d.ts +25 -0
  162. package/dist/model/merge-action-builder.d.ts +31 -0
  163. package/dist/model/merge-options.d.ts +72 -0
  164. package/dist/model/merge-query-builder.d.ts +29 -0
  165. package/dist/model/merge-source-builder.d.ts +22 -0
  166. package/dist/model/mixins/model-aggregates.d.ts +69 -0
  167. package/dist/model/mixins/model-associations.d.ts +113 -0
  168. package/dist/model/mixins/model-constructor.d.ts +7 -0
  169. package/dist/model/mixins/model-finders.d.ts +140 -0
  170. package/dist/model/mixins/model-hooks.d.ts +142 -0
  171. package/dist/model/mixins/model-postgres.d.ts +198 -0
  172. package/dist/model/mixins/model-schema-binding.d.ts +36 -0
  173. package/dist/model/mixins/model-schema.d.ts +100 -0
  174. package/dist/model/mixins/model-scopes.d.ts +57 -0
  175. package/dist/model/mixins/model-writers.d.ts +175 -0
  176. package/dist/model/mixins/named-hooks.d.ts +28 -0
  177. package/dist/model/model-accessors.d.ts +22 -0
  178. package/dist/model/model-base.d.ts +83 -0
  179. package/dist/model/model-definition.d.ts +130 -0
  180. package/dist/model/model-instance-persistence.d.ts +132 -0
  181. package/dist/model/model-instance-values.d.ts +197 -0
  182. package/dist/model/model-operations.d.ts +22 -0
  183. package/dist/model/model-registry.d.ts +152 -0
  184. package/dist/model/model-services.d.ts +46 -0
  185. package/dist/model/model-state.d.ts +68 -0
  186. package/dist/model/model-values.d.ts +86 -0
  187. package/dist/model/model.d.ts +629 -0
  188. package/dist/model/on-conflict-builder.d.ts +111 -0
  189. package/dist/model/operations/bulk-create-operation.d.ts +40 -0
  190. package/dist/model/operations/copy-from-source.d.ts +51 -0
  191. package/dist/model/operations/copy-operation.d.ts +54 -0
  192. package/dist/model/operations/count-operation.d.ts +52 -0
  193. package/dist/model/operations/create-operation.d.ts +31 -0
  194. package/dist/model/operations/destroy-operation.d.ts +65 -0
  195. package/dist/model/operations/find-cursor.d.ts +23 -0
  196. package/dist/model/operations/find-lookups.d.ts +99 -0
  197. package/dist/model/operations/find-operation.d.ts +47 -0
  198. package/dist/model/operations/increment-operation.d.ts +40 -0
  199. package/dist/model/operations/insert-operation.d.ts +71 -0
  200. package/dist/model/operations/merge-operation.d.ts +56 -0
  201. package/dist/model/operations/model-operation.d.ts +33 -0
  202. package/dist/model/operations/update-operation.d.ts +45 -0
  203. package/dist/model/operations/upsert-operation.d.ts +39 -0
  204. package/dist/model/options.d.ts +103 -0
  205. package/dist/model/returning-old.d.ts +52 -0
  206. package/dist/model/row-mapper.d.ts +78 -0
  207. package/dist/model/row-plan.d.ts +31 -0
  208. package/dist/model/runtime.d.ts +56 -0
  209. package/dist/model/scope-registry.d.ts +81 -0
  210. package/dist/model/select-aggregates.d.ts +37 -0
  211. package/dist/model/select-lock.d.ts +13 -0
  212. package/dist/model/select-options.d.ts +92 -0
  213. package/dist/model/select-query-builder.d.ts +73 -0
  214. package/dist/model/select-targets.d.ts +77 -0
  215. package/dist/model/source-option-builder.d.ts +23 -0
  216. package/dist/model/source-options.d.ts +108 -0
  217. package/dist/model/statement-builder.d.ts +77 -0
  218. package/dist/model/statement-services.d.ts +2 -0
  219. package/dist/model/sync-hooks.d.ts +18 -0
  220. package/dist/model/table-sample-builder.d.ts +13 -0
  221. package/dist/model/types.d.ts +85 -0
  222. package/dist/model/unnest-insert-builder.d.ts +24 -0
  223. package/dist/model/update-query-builder.d.ts +39 -0
  224. package/dist/model/v6-conflict-builder.d.ts +37 -0
  225. package/dist/model/value-cloner.d.ts +17 -0
  226. package/dist/model/values-writer.d.ts +12 -0
  227. package/dist/model/where-options.d.ts +164 -0
  228. package/dist/model/write-options.d.ts +160 -0
  229. package/dist/model/written-rows.d.ts +56 -0
  230. package/dist/package-version.d.ts +8 -0
  231. package/dist/query/query-result-shaper.d.ts +93 -0
  232. package/dist/query/raw-query.d.ts +27 -0
  233. package/dist/query-interface/alter-planner.d.ts +40 -0
  234. package/dist/query-interface/bulk-data.d.ts +44 -0
  235. package/dist/query-interface/column-commands.d.ts +52 -0
  236. package/dist/query-interface/column-describer.d.ts +17 -0
  237. package/dist/query-interface/enum-commands.d.ts +36 -0
  238. package/dist/query-interface/index-commands.d.ts +57 -0
  239. package/dist/query-interface/model-tables.d.ts +58 -0
  240. package/dist/query-interface/object-commands.d.ts +71 -0
  241. package/dist/query-interface/partition-commands.d.ts +43 -0
  242. package/dist/query-interface/policy-commands.d.ts +54 -0
  243. package/dist/query-interface/query-interface-catalog.d.ts +180 -0
  244. package/dist/query-interface/query-interface-objects.d.ts +108 -0
  245. package/dist/query-interface/query-interface-partitions.d.ts +66 -0
  246. package/dist/query-interface/query-interface-policies.d.ts +86 -0
  247. package/dist/query-interface/query-interface-routines.d.ts +120 -0
  248. package/dist/query-interface/query-interface-tables.d.ts +179 -0
  249. package/dist/query-interface/query-interface-types.d.ts +62 -0
  250. package/dist/query-interface/query-interface-views.d.ts +84 -0
  251. package/dist/query-interface/query-interface.d.ts +256 -0
  252. package/dist/query-interface/routine-commands.d.ts +71 -0
  253. package/dist/query-interface/schema-synchronizer.d.ts +110 -0
  254. package/dist/query-interface/statement-runner.d.ts +40 -0
  255. package/dist/query-interface/sync-planner.d.ts +26 -0
  256. package/dist/query-interface/table-commands.d.ts +63 -0
  257. package/dist/query-interface/table-introspector.d.ts +58 -0
  258. package/dist/query-interface/view-commands.d.ts +47 -0
  259. package/dist/sequelize/instance-hook-adders.d.ts +72 -0
  260. package/dist/sequelize/sequelize-base.d.ts +196 -0
  261. package/dist/sequelize/sequelize-constructor.d.ts +7 -0
  262. package/dist/sequelize/sequelize-helpers.d.ts +133 -0
  263. package/dist/sequelize/sequelize-hooks.d.ts +99 -0
  264. package/dist/sequelize/sequelize-internals.d.ts +87 -0
  265. package/dist/sequelize/sequelize-notifications.d.ts +66 -0
  266. package/dist/sequelize/sequelize-schema.d.ts +125 -0
  267. package/dist/sequelize/sequelize-transactions.d.ts +96 -0
  268. package/dist/sequelize.d.ts +1175 -0
  269. package/dist/sql/ast-clauses.d.ts +137 -0
  270. package/dist/sql/ast-expressions.d.ts +88 -0
  271. package/dist/sql/ast-statements.d.ts +80 -0
  272. package/dist/sql/ast.d.ts +21 -0
  273. package/dist/sql/compile.d.ts +21 -0
  274. package/dist/sql/dml-compiler.d.ts +54 -0
  275. package/dist/sql/expression-compiler.d.ts +56 -0
  276. package/dist/sql/from-compiler.d.ts +39 -0
  277. package/dist/sql/identifier-quoter.d.ts +15 -0
  278. package/dist/sql/merge-compiler.d.ts +20 -0
  279. package/dist/sql/order.d.ts +15 -0
  280. package/dist/sql/query-compiler.d.ts +45 -0
  281. package/dist/sql/sql-chunks.d.ts +50 -0
  282. package/dist/sql/with-compiler.d.ts +19 -0
  283. package/dist/transaction/advisory-locks.d.ts +28 -0
  284. package/dist/transaction/cls-namespace.d.ts +44 -0
  285. package/dist/transaction/transaction-constants.d.ts +35 -0
  286. package/dist/transaction/transaction-runner.d.ts +78 -0
  287. package/dist/transaction/transaction-starter.d.ts +25 -0
  288. package/dist/transaction/transaction-statements.d.ts +29 -0
  289. package/dist/transaction/transaction.d.ts +201 -0
  290. package/dist/validation/attribute-validators.d.ts +23 -0
  291. package/dist/validation/builtin-attribute-validator.d.ts +19 -0
  292. package/dist/validation/builtin-validators.d.ts +16 -0
  293. package/dist/validation/core-validator.d.ts +16 -0
  294. package/dist/validation/custom-validators.d.ts +13 -0
  295. package/dist/validation/instance-validator.d.ts +25 -0
  296. package/dist/validation/schema-items.d.ts +22 -0
  297. package/dist/validation/standard-schema-validator.d.ts +30 -0
  298. package/dist/validation/standard-schema.d.ts +39 -0
  299. package/dist/validation/types.d.ts +36 -0
  300. package/dist/validation/validation-target.d.ts +13 -0
  301. package/dist/where/comparison-compiler.d.ts +27 -0
  302. package/dist/where/condition-compiler.d.ts +18 -0
  303. package/dist/where/operand-resolver.d.ts +10 -0
  304. package/dist/where/operator-allowlist.d.ts +14 -0
  305. package/dist/where/where-support.d.ts +52 -0
  306. package/dist/where/where.d.ts +46 -0
  307. package/dist/where/window-compiler.d.ts +14 -0
  308. package/llm/USAGE.md +423 -0
  309. package/package.json +103 -4
  310. package/skills/postgrelize/SKILL.md +57 -0
  311. package/skills/postgrelize/reference/associations.md +108 -0
  312. package/skills/postgrelize/reference/errors.md +37 -0
  313. package/skills/postgrelize/reference/migrating-from-sequelize.md +15 -0
  314. package/skills/postgrelize/reference/postgresql-features.md +157 -0
  315. package/skills/postgrelize/reference/querying.md +111 -0
  316. package/skills/postgrelize/reference/schema.md +135 -0
  317. package/skills/postgrelize/reference/security.md +34 -0
  318. package/skills/postgrelize/reference/transactions-and-sessions.md +122 -0
  319. package/skills/postgrelize/reference/writing.md +198 -0
@@ -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
+ }
@@ -0,0 +1,98 @@
1
+ /** Function reference: a plain name (`'touch'`, `'app.touch'`) or `{ name, schema }` (quoted exactly). */
2
+ export type FunctionName = string | Readonly<{
3
+ /** Function name, quoted exactly. */
4
+ name: string;
5
+ /** Schema name, quoted exactly. */
6
+ schema?: string;
7
+ }>;
8
+ /** Parameter of a function. */
9
+ export type FunctionParam = Readonly<{
10
+ /** SQL type, e.g. `'integer'`, `'varchar(10)'`, `'text[]'`. */
11
+ type: string;
12
+ /** Parameter name (identifier word). */
13
+ name?: string;
14
+ /** `IN`, `OUT`, `INOUT` or `VARIADIC`. */
15
+ direction?: string;
16
+ }>;
17
+ /** Local variable declared before `BEGIN`. */
18
+ export type FunctionVariable = Readonly<{
19
+ /** Variable name (identifier word). */
20
+ name: string;
21
+ /** SQL type. */
22
+ type: string;
23
+ /** Initial value, rendered as a literal. */
24
+ default?: unknown;
25
+ }>;
26
+ /**
27
+ * Options of `createFunction`.
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * const options: CreateFunctionOptions = {
32
+ * force: true,
33
+ * variables: [{ name: 'limit_rows', type: 'integer', default: 100 }],
34
+ * };
35
+ * await queryInterface.createFunction('f', [], 'integer', 'plpgsql', 'RETURN limit_rows;', [], options);
36
+ * ```
37
+ */
38
+ export type CreateFunctionOptions = Readonly<{
39
+ /** Local variables (`DECLARE name type := default;`). */
40
+ variables?: readonly FunctionVariable[];
41
+ /** `CREATE OR REPLACE FUNCTION`. */
42
+ force?: boolean;
43
+ }>;
44
+ /**
45
+ * Options of `dropFunction`.
46
+ *
47
+ * @example
48
+ * ```ts
49
+ * const options: DropFunctionOptions = { ifExists: true, cascade: true };
50
+ * await queryInterface.dropFunction('f', [], options);
51
+ * ```
52
+ */
53
+ export type DropFunctionOptions = Readonly<{
54
+ /** Adds `IF EXISTS`. */
55
+ ifExists?: boolean;
56
+ /** `CASCADE` instead of the default `RESTRICT`. */
57
+ cascade?: boolean;
58
+ }>;
59
+ /**
60
+ * `CREATE`, `DROP` and `ALTER ... RENAME` statements for functions (Sequelize v6 shapes).
61
+ *
62
+ * @internal
63
+ */
64
+ export declare class FunctionDdl {
65
+ #private;
66
+ /**
67
+ * `CREATE [OR REPLACE] FUNCTION` statement; the body is wrapped in `BEGIN ... END;` like v6.
68
+ *
69
+ * @param name - Function name.
70
+ * @param params - Parameters.
71
+ * @param returnType - Return type.
72
+ * @param language - Language word.
73
+ * @param body - Trusted SQL / PL/pgSQL text.
74
+ * @param optionsArray - Characteristic keywords.
75
+ * @param options - Statement options.
76
+ * @returns Statement.
77
+ * @throws Error for missing parts or values outside the guards.
78
+ */
79
+ createSql(name: FunctionName, params: readonly FunctionParam[], returnType: string, language: string, body: string, optionsArray: readonly string[], options: CreateFunctionOptions): string;
80
+ /**
81
+ * `DROP FUNCTION` statement (`RESTRICT` unless `cascade`).
82
+ *
83
+ * @param name - Function name.
84
+ * @param params - Parameters identifying the overload.
85
+ * @param options - Statement options.
86
+ * @returns Statement.
87
+ */
88
+ dropSql(name: FunctionName, params: readonly FunctionParam[], options: DropFunctionOptions): string;
89
+ /**
90
+ * `ALTER FUNCTION ... RENAME TO` statement.
91
+ *
92
+ * @param name - Current name.
93
+ * @param params - Parameters identifying the overload.
94
+ * @param newName - New unqualified name.
95
+ * @returns Statement.
96
+ */
97
+ renameSql(name: FunctionName, params: readonly FunctionParam[], newName: string): string;
98
+ }
@@ -0,0 +1,29 @@
1
+ import { IndexField, IndexOptions } from './ddl-types.ts';
2
+ import { TableName } from './sql-literal.ts';
3
+ /**
4
+ * `CREATE INDEX` statements and v6 default index names.
5
+ *
6
+ * @internal
7
+ */
8
+ export declare class IndexDdl {
9
+ #private;
10
+ /**
11
+ * Default index name (v6 `Utils.nameIndex`).
12
+ *
13
+ * @param table - Table name or `{ tableName, schema }`.
14
+ * @param fields - Indexed fields.
15
+ * @returns Index name.
16
+ */
17
+ indexName(table: TableName, fields: readonly IndexField[]): string;
18
+ /**
19
+ * `CREATE [UNIQUE] INDEX` statement.
20
+ *
21
+ * @param table - Table name or `{ tableName, schema }`.
22
+ * @param options - Index options.
23
+ * @param defaultSchema - Schema used when the table reference has none.
24
+ * @returns Statement.
25
+ * @throws Error without fields, with an invalid method / operator class, or with an expression
26
+ * field and no name.
27
+ */
28
+ createIndexSql(table: TableName, options: IndexOptions, defaultSchema?: string): string;
29
+ }
@@ -0,0 +1,19 @@
1
+ import { IndexField } from './ddl-types.ts';
2
+ /**
3
+ * One element of an index or EXCLUDE constraint: a quoted column or a trusted SQL expression with
4
+ * collation, operator class, order and nulls ordering.
5
+ *
6
+ * @internal
7
+ */
8
+ export declare class IndexElementDdl {
9
+ #private;
10
+ /**
11
+ * SQL of an element.
12
+ *
13
+ * @param field - Column name or field object.
14
+ * @param operator - Default operator class.
15
+ * @returns Element SQL.
16
+ * @throws Error for an empty expression or an invalid operator class.
17
+ */
18
+ elementSql(field: IndexField, operator: string | undefined): string;
19
+ }
@@ -0,0 +1,88 @@
1
+ import { PartitionBoundSpec, PartitionKey } from './partition-types.ts';
2
+ import { TableName } from './sql-literal.ts';
3
+ /**
4
+ * Options of `createPartition`.
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * await queryInterface.createPartition(
9
+ * 'events',
10
+ * 'events_2026',
11
+ * { from: ['2026-01-01'], to: ['2027-01-01'] },
12
+ * { ifNotExists: true, partitionBy: { strategy: 'list', columns: ['kind'] } },
13
+ * );
14
+ * ```
15
+ */
16
+ export type CreatePartitionOptions = Readonly<{
17
+ /** Makes the partition itself partitioned. */
18
+ partitionBy?: PartitionKey;
19
+ /** `IF NOT EXISTS`. */
20
+ ifNotExists?: boolean;
21
+ }>;
22
+ /**
23
+ * Options of `detachPartition`.
24
+ *
25
+ * @example
26
+ * ```ts
27
+ * await queryInterface.detachPartition('events', 'events_2026', { concurrently: true });
28
+ * ```
29
+ */
30
+ export type DetachPartitionOptions = Readonly<{
31
+ /** `DETACH PARTITION ... CONCURRENTLY` (cannot run inside a transaction). */
32
+ concurrently?: boolean;
33
+ /** `DETACH PARTITION ... FINALIZE`, completing an interrupted concurrent detach. */
34
+ finalize?: boolean;
35
+ }>;
36
+ /**
37
+ * Declarative partitioning statements: `PARTITION BY`, `PARTITION OF`, `ATTACH` and `DETACH`.
38
+ *
39
+ * @internal
40
+ */
41
+ export declare class PartitionDdl {
42
+ #private;
43
+ /**
44
+ * ` PARTITION BY ...` clause of `CREATE TABLE`.
45
+ *
46
+ * @param key - Strategy and key columns.
47
+ * @returns Clause with a leading space.
48
+ * @throws Error for an unknown strategy, no columns or an invalid operator class.
49
+ */
50
+ partitionBySql(key: PartitionKey): string;
51
+ /**
52
+ * `CREATE TABLE ... PARTITION OF` statement.
53
+ *
54
+ * @param parent - Partitioned table.
55
+ * @param partition - New partition name.
56
+ * @param bound - Bounds.
57
+ * @param options - Sub-partitioning and `ifNotExists`.
58
+ * @returns Statement.
59
+ */
60
+ createPartitionSql(parent: TableName, partition: TableName, bound: PartitionBoundSpec, options?: CreatePartitionOptions): string;
61
+ /**
62
+ * `ALTER TABLE ... ATTACH PARTITION` statement.
63
+ *
64
+ * @param parent - Partitioned table.
65
+ * @param partition - Existing table to attach.
66
+ * @param bound - Bounds.
67
+ * @returns Statement.
68
+ */
69
+ attachPartitionSql(parent: TableName, partition: TableName, bound: PartitionBoundSpec): string;
70
+ /**
71
+ * `ALTER TABLE ... DETACH PARTITION` statement.
72
+ *
73
+ * @param parent - Partitioned table.
74
+ * @param partition - Partition to detach.
75
+ * @param options - `concurrently` or `finalize`.
76
+ * @returns Statement.
77
+ * @throws Error when both options are set.
78
+ */
79
+ detachPartitionSql(parent: TableName, partition: TableName, options?: DetachPartitionOptions): string;
80
+ /**
81
+ * `FOR VALUES ...` or `DEFAULT` clause.
82
+ *
83
+ * @param bound - Bounds.
84
+ * @returns Clause.
85
+ * @throws Error for an unknown bound shape or non-integer modulus / remainder.
86
+ */
87
+ boundSql(bound: PartitionBoundSpec): string;
88
+ }
@@ -0,0 +1,94 @@
1
+ /** Partitioning method of a partitioned table. */
2
+ export type PartitionStrategy = 'range' | 'list' | 'hash';
3
+ /** Marker of a `MINVALUE` / `MAXVALUE` bound inside a range partition bound. */
4
+ export type PartitionBoundMarker = Readonly<{
5
+ /** Keyword the marker renders as. */
6
+ keyword: 'MINVALUE' | 'MAXVALUE';
7
+ }>;
8
+ /**
9
+ * `MINVALUE` and `MAXVALUE` for the `from` / `to` lists of a range partition bound. They are
10
+ * markers, not strings, so a string value can never be read as a keyword.
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * await queryInterface.createPartition('events', 'events_old', {
15
+ * from: [PartitionBound.MINVALUE],
16
+ * to: ['2020-01-01'],
17
+ * });
18
+ * ```
19
+ */
20
+ export declare const PartitionBound: {
21
+ /** Lowest possible value of a range column. */
22
+ readonly MINVALUE: Readonly<Readonly<{
23
+ /** Keyword the marker renders as. */
24
+ keyword: "MINVALUE" | "MAXVALUE";
25
+ }>>;
26
+ /** Highest possible value of a range column. */
27
+ readonly MAXVALUE: Readonly<Readonly<{
28
+ /** Keyword the marker renders as. */
29
+ keyword: "MINVALUE" | "MAXVALUE";
30
+ }>>;
31
+ };
32
+ /** Element of a partition key: a column, or an expression (trusted SQL) with collation and operator class. */
33
+ export type PartitionKeyElement = string | Readonly<{
34
+ /** Column name. */
35
+ name: string;
36
+ /** Collation name. */
37
+ collate?: string;
38
+ /** Operator class. */
39
+ operator?: string;
40
+ /** Not used for a column element. */
41
+ expression?: undefined;
42
+ }> | Readonly<{
43
+ /** Trusted SQL expression, wrapped in parentheses. */
44
+ expression: string;
45
+ /** Collation name. */
46
+ collate?: string;
47
+ /** Operator class. */
48
+ operator?: string;
49
+ /** Not used for an expression element. */
50
+ name?: undefined;
51
+ }>;
52
+ /**
53
+ * Partition key of `createTable({ partitionBy })` and of a sub-partitioned partition.
54
+ *
55
+ * @example
56
+ * ```ts
57
+ * const key: PartitionKey = { strategy: 'range', columns: ['createdAt'] };
58
+ * await queryInterface.createTable('events', { createdAt: DataTypes.DATE }, { partitionBy: key });
59
+ * ```
60
+ */
61
+ export type PartitionKey = Readonly<{
62
+ /** `'range'`, `'list'` or `'hash'`. */
63
+ strategy: PartitionStrategy;
64
+ /** Key columns or expressions. */
65
+ columns: readonly PartitionKeyElement[];
66
+ }>;
67
+ /**
68
+ * Bounds of a partition: `{ in }` (list), `{ from, to }` (range; `PartitionBound.MINVALUE` /
69
+ * `MAXVALUE` allowed), `{ modulus, remainder }` (hash) or `{ default: true }`. Values are rendered
70
+ * as literals.
71
+ *
72
+ * @example
73
+ * ```ts
74
+ * const bound: PartitionBoundSpec = { from: ['2026-01-01'], to: ['2027-01-01'] };
75
+ * await queryInterface.createPartition('events', 'events_2026', bound);
76
+ * ```
77
+ */
78
+ export type PartitionBoundSpec = Readonly<{
79
+ /** List partition: the values the partition holds. */
80
+ in: readonly unknown[];
81
+ }> | Readonly<{
82
+ /** Range partition: inclusive lower bound, one value per key column. */
83
+ from: readonly unknown[];
84
+ /** Range partition: exclusive upper bound, one value per key column. */
85
+ to: readonly unknown[];
86
+ }> | Readonly<{
87
+ /** Hash partition: modulus. */
88
+ modulus: number;
89
+ /** Hash partition: remainder, `0 <= remainder < modulus`. */
90
+ remainder: number;
91
+ }> | Readonly<{
92
+ /** Default partition, receiving rows that match no other partition. */
93
+ default: true;
94
+ }>;
@@ -0,0 +1,137 @@
1
+ import { TableName } from './sql-literal.ts';
2
+ /** Condition of a policy: SQL text (trusted) or a where object (values rendered as literals). */
3
+ export type PolicyCondition = string | Readonly<Record<string | symbol, unknown>>;
4
+ /**
5
+ * Options of `enableRowLevelSecurity`.
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * const options: EnableRowLevelSecurityOptions = { force: true };
10
+ * await queryInterface.enableRowLevelSecurity('documents', options);
11
+ * ```
12
+ */
13
+ export type EnableRowLevelSecurityOptions = Readonly<{
14
+ /** Also `FORCE ROW LEVEL SECURITY`: the table owner is subject to the policies too. */
15
+ force?: boolean;
16
+ }>;
17
+ /**
18
+ * Options of `disableRowLevelSecurity`.
19
+ *
20
+ * @example
21
+ * ```ts
22
+ * const options: DisableRowLevelSecurityOptions = { noForce: true };
23
+ * await queryInterface.disableRowLevelSecurity('documents', options);
24
+ * ```
25
+ */
26
+ export type DisableRowLevelSecurityOptions = Readonly<{
27
+ /** Also `NO FORCE ROW LEVEL SECURITY`. */
28
+ noForce?: boolean;
29
+ }>;
30
+ /**
31
+ * Options of `createPolicy`.
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * const options: CreatePolicyOptions = {
36
+ * command: 'select',
37
+ * roles: ['app_user'],
38
+ * using: "tenant_id = current_setting('app.tenant_id')::int",
39
+ * };
40
+ * await queryInterface.createPolicy('documents', 'tenant_isolation', options);
41
+ * ```
42
+ */
43
+ export type CreatePolicyOptions = Readonly<{
44
+ /** Command the policy applies to; defaults to `'all'`. */
45
+ command?: 'all' | 'select' | 'insert' | 'update' | 'delete';
46
+ /** `'permissive'` (default) or `'restrictive'`. */
47
+ kind?: 'permissive' | 'restrictive';
48
+ /** Roles the policy applies to: role names, or `'public'`, `'current_user'`, `'current_role'`, `'session_user'`. */
49
+ roles?: readonly string[];
50
+ /** `USING (...)`: which existing rows are visible. SQL text is trusted; a where object is compiled with literals. */
51
+ using?: PolicyCondition;
52
+ /** `WITH CHECK (...)`: which new rows may be written. Same forms as `using`. */
53
+ withCheck?: PolicyCondition;
54
+ }>;
55
+ /**
56
+ * Options of `alterPolicy`.
57
+ *
58
+ * @example
59
+ * ```ts
60
+ * const options: AlterPolicyOptions = { roles: ['app_user', 'app_admin'], rename: 'tenant_rows' };
61
+ * await queryInterface.alterPolicy('documents', 'tenant_isolation', options);
62
+ * ```
63
+ */
64
+ export type AlterPolicyOptions = Readonly<Pick<CreatePolicyOptions, 'roles' | 'using' | 'withCheck'> & {
65
+ /** New policy name (applied after the other changes). */
66
+ rename?: string;
67
+ }>;
68
+ /**
69
+ * Options of `dropPolicy`.
70
+ *
71
+ * @example
72
+ * ```ts
73
+ * const options: DropPolicyOptions = { ifExists: true };
74
+ * await queryInterface.dropPolicy('documents', 'tenant_isolation', options);
75
+ * ```
76
+ */
77
+ export type DropPolicyOptions = Readonly<{
78
+ /** Adds `IF EXISTS`. */
79
+ ifExists?: boolean;
80
+ /** Also drops objects that depend on the policy. */
81
+ cascade?: boolean;
82
+ }>;
83
+ /**
84
+ * Row-level security DDL: `ENABLE` / `DISABLE ROW LEVEL SECURITY` and `CREATE` / `ALTER` / `DROP
85
+ * POLICY`. Names and roles are quoted; commands and kinds are allowlisted; string conditions are
86
+ * trusted SQL (ADR-025).
87
+ *
88
+ * @internal
89
+ */
90
+ export declare class PolicyDdl {
91
+ #private;
92
+ /**
93
+ * `ALTER TABLE ... ENABLE ROW LEVEL SECURITY` statement.
94
+ *
95
+ * @param table - Table.
96
+ * @param options - Statement options.
97
+ * @returns Statement.
98
+ */
99
+ enableSql(table: TableName, options: EnableRowLevelSecurityOptions): string;
100
+ /**
101
+ * `ALTER TABLE ... DISABLE ROW LEVEL SECURITY` statement.
102
+ *
103
+ * @param table - Table.
104
+ * @param options - Statement options.
105
+ * @returns Statement.
106
+ */
107
+ disableSql(table: TableName, options: DisableRowLevelSecurityOptions): string;
108
+ /**
109
+ * `CREATE POLICY` statement.
110
+ *
111
+ * @param table - Table.
112
+ * @param name - Policy name.
113
+ * @param options - Policy options.
114
+ * @returns Statement.
115
+ * @throws Error for an unknown command or kind.
116
+ */
117
+ createSql(table: TableName, name: string, options: CreatePolicyOptions): string;
118
+ /**
119
+ * `ALTER POLICY` statements (the change, then the rename).
120
+ *
121
+ * @param table - Table.
122
+ * @param name - Policy name.
123
+ * @param options - Changes.
124
+ * @returns Statements.
125
+ * @throws Error without any change.
126
+ */
127
+ alterSql(table: TableName, name: string, options: AlterPolicyOptions): readonly string[];
128
+ /**
129
+ * `DROP POLICY` statement.
130
+ *
131
+ * @param table - Table.
132
+ * @param name - Policy name.
133
+ * @param options - Statement options.
134
+ * @returns Statement.
135
+ */
136
+ dropSql(table: TableName, name: string, options: DropPolicyOptions): string;
137
+ }
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Allowlists and patterns for the keywords and type names of functions and triggers that cannot be
3
+ * quoted (ADR-020, ADR-025).
4
+ *
5
+ * @internal
6
+ */
7
+ export declare class RoutineGuards {
8
+ /**
9
+ * A plain identifier word (parameter, variable, language), rendered unquoted so it folds like v6.
10
+ *
11
+ * @param value - Word.
12
+ * @param kind - Kind named in the error.
13
+ * @returns The word.
14
+ * @throws Error for anything but `[A-Za-z_]\w*`.
15
+ */
16
+ word(value: string, kind: string): string;
17
+ /**
18
+ * A type name: words, an optional schema, a length / precision and array brackets.
19
+ *
20
+ * @param value - Type as written in SQL.
21
+ * @param kind - Kind named in the error.
22
+ * @returns The type.
23
+ * @throws Error for anything that is not a type name.
24
+ */
25
+ typeName(value: string, kind: string): string;
26
+ /**
27
+ * Parameter direction keyword.
28
+ *
29
+ * @param value - Direction.
30
+ * @returns Upper-case direction.
31
+ * @throws Error outside `IN`, `OUT`, `INOUT`, `VARIADIC`.
32
+ */
33
+ direction(value: string): string;
34
+ /**
35
+ * Function characteristic keywords (`IMMUTABLE`, `SECURITY DEFINER`, `COST n`, ...).
36
+ *
37
+ * @param options - Keywords as given.
38
+ * @returns Normalized keywords.
39
+ * @throws Error for a keyword outside the allowlist.
40
+ */
41
+ functionOptions(options: readonly string[]): readonly string[];
42
+ /**
43
+ * Trigger clauses: row / statement level, deferrability, `REFERENCING` transition tables and
44
+ * `WHEN (condition)`. The condition is trusted SQL.
45
+ *
46
+ * @param options - Clauses as given.
47
+ * @returns Normalized clauses (`WHEN` kept as written).
48
+ * @throws Error for a clause outside the allowlist.
49
+ */
50
+ triggerOptions(options: readonly string[]): readonly string[];
51
+ /**
52
+ * Function name: a word or `schema.word` string (unquoted, folds like v6) or `{ name, schema }`
53
+ * (quoted exactly).
54
+ *
55
+ * @param name - Function name.
56
+ * @returns SQL name.
57
+ * @throws Error for a string that is not one or two identifier words.
58
+ */
59
+ functionName(name: string | Readonly<{
60
+ name: string;
61
+ schema?: string;
62
+ }>): string;
63
+ }