skyward-orm 0.2.0 → 0.3.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 (191) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +182 -75
  3. data/lib/skyward/orm/adapters/postgresql/connection.rb +52 -0
  4. data/lib/skyward/orm/adapters/postgresql.rb +283 -0
  5. data/lib/skyward/orm/adapters/sqlite/constraints.rb +172 -0
  6. data/lib/skyward/orm/adapters/sqlite.rb +317 -0
  7. data/lib/skyward/orm/adapters.rb +38 -0
  8. data/lib/skyward/orm/catalog/column.rb +12 -0
  9. data/lib/skyward/orm/catalog/constraint.rb +13 -0
  10. data/lib/skyward/orm/catalog/index.rb +11 -0
  11. data/lib/skyward/orm/catalog/table.rb +10 -0
  12. data/lib/skyward/orm/catalog.rb +6 -0
  13. data/lib/skyward/orm/cli/boot_file.rb +43 -0
  14. data/lib/skyward/orm/cli/migrate.rb +30 -0
  15. data/lib/skyward/orm/cli/migration.rb +111 -0
  16. data/lib/skyward/orm/cli/rollback.rb +18 -0
  17. data/lib/skyward/orm/cli/status.rb +36 -0
  18. data/lib/skyward/orm/cli.rb +4 -0
  19. data/lib/skyward/orm/commands.rb +64 -0
  20. data/lib/skyward/orm/connection/database/schema_check.rb +67 -0
  21. data/lib/skyward/orm/connection/database.rb +357 -0
  22. data/lib/skyward/orm/connection/pool.rb +102 -0
  23. data/lib/skyward/orm/connection/session.rb +38 -0
  24. data/lib/skyward/orm/connection.rb +7 -0
  25. data/lib/skyward/orm/members.rb +16 -0
  26. data/lib/skyward/orm/migration_error.rb +4 -0
  27. data/lib/skyward/orm/migrations/add_column.rb +7 -0
  28. data/lib/skyward/orm/migrations/add_constraint.rb +7 -0
  29. data/lib/skyward/orm/migrations/add_index.rb +7 -0
  30. data/lib/skyward/orm/migrations/alter_table.rb +12 -0
  31. data/lib/skyward/orm/migrations/change_default.rb +9 -0
  32. data/lib/skyward/orm/migrations/change_nullable.rb +8 -0
  33. data/lib/skyward/orm/migrations/change_type.rb +9 -0
  34. data/lib/skyward/orm/migrations/create_table.rb +8 -0
  35. data/lib/skyward/orm/migrations/definitions.rb +176 -0
  36. data/lib/skyward/orm/migrations/diff.rb +213 -0
  37. data/lib/skyward/orm/migrations/directory.rb +48 -0
  38. data/lib/skyward/orm/migrations/discovery.rb +14 -0
  39. data/lib/skyward/orm/migrations/drop_column.rb +7 -0
  40. data/lib/skyward/orm/migrations/drop_constraint.rb +7 -0
  41. data/lib/skyward/orm/migrations/drop_index.rb +7 -0
  42. data/lib/skyward/orm/migrations/rename_column.rb +8 -0
  43. data/lib/skyward/orm/migrations/runner/edited.rb +7 -0
  44. data/lib/skyward/orm/migrations/runner/failed.rb +8 -0
  45. data/lib/skyward/orm/migrations/runner/irreversible.rb +7 -0
  46. data/lib/skyward/orm/migrations/runner/locked.rb +8 -0
  47. data/lib/skyward/orm/migrations/runner/migration.rb +11 -0
  48. data/lib/skyward/orm/migrations/runner/missing.rb +7 -0
  49. data/lib/skyward/orm/migrations/runner/raced.rb +7 -0
  50. data/lib/skyward/orm/migrations/runner.rb +227 -0
  51. data/lib/skyward/orm/migrations/script.rb +350 -0
  52. data/lib/skyward/orm/migrations/status.rb +93 -0
  53. data/lib/skyward/orm/migrations/summary.rb +110 -0
  54. data/lib/skyward/orm/migrations/versions.rb +19 -0
  55. data/lib/skyward/orm/migrations.rb +8 -0
  56. data/lib/skyward/orm/placeholders.rb +37 -0
  57. data/lib/skyward/orm/pool_timeout.rb +4 -0
  58. data/lib/skyward/orm/projection.rb +67 -0
  59. data/lib/skyward/orm/queries/clauses.rb +588 -0
  60. data/lib/skyward/orm/queries.rb +4 -0
  61. data/lib/skyward/orm/query.rb +26 -0
  62. data/lib/skyward/orm/record.rb +96 -0
  63. data/lib/skyward/orm/schema_mismatch.rb +4 -0
  64. data/lib/skyward/orm/statements.rb +97 -0
  65. data/lib/skyward/orm/tables/check.rb +8 -0
  66. data/lib/skyward/orm/tables/column.rb +10 -0
  67. data/lib/skyward/orm/tables/column_types.rb +74 -0
  68. data/lib/skyward/orm/tables/declarations.rb +172 -0
  69. data/lib/skyward/orm/tables/length.rb +8 -0
  70. data/lib/skyward/orm/tables/loaded.rb +21 -0
  71. data/lib/skyward/orm/tables/reference.rb +9 -0
  72. data/lib/skyward/orm/tables/rows.rb +52 -0
  73. data/lib/skyward/orm/tables/schema.rb +14 -0
  74. data/lib/skyward/orm/tables/sql.rb +7 -0
  75. data/lib/skyward/orm/tables/validation.rb +29 -0
  76. data/lib/skyward/orm/tables/values.rb +102 -0
  77. data/lib/skyward/orm/tables.rb +7 -0
  78. data/lib/skyward/orm/transactional.rb +18 -0
  79. data/lib/skyward/orm/version.rb +1 -1
  80. data/lib/skyward/orm/violation.rb +13 -0
  81. data/lib/skyward/orm/violation_error.rb +13 -0
  82. data/lib/skyward/orm.rb +72 -1
  83. data/sig/generated/skyward/orm/adapters/postgresql/connection.rbs +41 -0
  84. data/sig/generated/skyward/orm/adapters/postgresql.rbs +138 -0
  85. data/sig/generated/skyward/orm/adapters/sqlite/constraints.rbs +87 -0
  86. data/sig/generated/skyward/orm/adapters/sqlite.rbs +166 -0
  87. data/sig/generated/skyward/orm/adapters.rbs +15 -0
  88. data/sig/generated/skyward/orm/catalog/column.rbs +20 -0
  89. data/sig/generated/skyward/orm/catalog/constraint.rbs +22 -0
  90. data/sig/generated/skyward/orm/catalog/index.rbs +20 -0
  91. data/sig/generated/skyward/orm/catalog/table.rbs +20 -0
  92. data/sig/generated/skyward/orm/catalog.rbs +5 -0
  93. data/sig/generated/skyward/orm/cli/boot_file.rbs +21 -0
  94. data/sig/generated/skyward/orm/cli/migrate.rbs +15 -0
  95. data/sig/generated/skyward/orm/cli/migration.rbs +45 -0
  96. data/sig/generated/skyward/orm/cli/rollback.rbs +7 -0
  97. data/sig/generated/skyward/orm/cli/status.rbs +17 -0
  98. data/sig/generated/skyward/orm/cli.rbs +4 -0
  99. data/sig/generated/skyward/orm/commands.rbs +2 -0
  100. data/sig/generated/skyward/orm/connection/database/schema_check.rbs +31 -0
  101. data/sig/generated/skyward/orm/connection/database.rbs +226 -0
  102. data/sig/generated/skyward/orm/connection/pool.rbs +54 -0
  103. data/sig/generated/skyward/orm/connection/session.rbs +25 -0
  104. data/sig/generated/skyward/orm/connection.rbs +7 -0
  105. data/sig/generated/skyward/orm/members.rbs +9 -0
  106. data/sig/generated/skyward/orm/migration_error.rbs +4 -0
  107. data/sig/generated/skyward/orm/migrations/add_column.rbs +14 -0
  108. data/sig/generated/skyward/orm/migrations/add_constraint.rbs +14 -0
  109. data/sig/generated/skyward/orm/migrations/add_index.rbs +14 -0
  110. data/sig/generated/skyward/orm/migrations/alter_table.rbs +22 -0
  111. data/sig/generated/skyward/orm/migrations/change_default.rbs +18 -0
  112. data/sig/generated/skyward/orm/migrations/change_nullable.rbs +16 -0
  113. data/sig/generated/skyward/orm/migrations/change_type.rbs +18 -0
  114. data/sig/generated/skyward/orm/migrations/create_table.rbs +16 -0
  115. data/sig/generated/skyward/orm/migrations/definitions.rbs +81 -0
  116. data/sig/generated/skyward/orm/migrations/diff.rbs +99 -0
  117. data/sig/generated/skyward/orm/migrations/directory.rbs +37 -0
  118. data/sig/generated/skyward/orm/migrations/discovery.rbs +9 -0
  119. data/sig/generated/skyward/orm/migrations/drop_column.rbs +14 -0
  120. data/sig/generated/skyward/orm/migrations/drop_constraint.rbs +14 -0
  121. data/sig/generated/skyward/orm/migrations/drop_index.rbs +14 -0
  122. data/sig/generated/skyward/orm/migrations/rename_column.rbs +16 -0
  123. data/sig/generated/skyward/orm/migrations/runner/edited.rbs +14 -0
  124. data/sig/generated/skyward/orm/migrations/runner/failed.rbs +16 -0
  125. data/sig/generated/skyward/orm/migrations/runner/irreversible.rbs +14 -0
  126. data/sig/generated/skyward/orm/migrations/runner/locked.rbs +16 -0
  127. data/sig/generated/skyward/orm/migrations/runner/migration.rbs +22 -0
  128. data/sig/generated/skyward/orm/migrations/runner/missing.rbs +14 -0
  129. data/sig/generated/skyward/orm/migrations/runner/raced.rbs +14 -0
  130. data/sig/generated/skyward/orm/migrations/runner.rbs +73 -0
  131. data/sig/generated/skyward/orm/migrations/script.rbs +161 -0
  132. data/sig/generated/skyward/orm/migrations/status.rbs +49 -0
  133. data/sig/generated/skyward/orm/migrations/summary.rbs +50 -0
  134. data/sig/generated/skyward/orm/migrations/versions.rbs +11 -0
  135. data/sig/generated/skyward/orm/migrations.rbs +7 -0
  136. data/sig/generated/skyward/orm/placeholders.rbs +21 -0
  137. data/sig/generated/skyward/orm/pool_timeout.rbs +4 -0
  138. data/sig/generated/skyward/orm/projection.rbs +42 -0
  139. data/sig/generated/skyward/orm/queries/clauses.rbs +367 -0
  140. data/sig/generated/skyward/orm/queries.rbs +4 -0
  141. data/sig/generated/skyward/orm/query.rbs +20 -0
  142. data/sig/generated/skyward/orm/record.rbs +80 -0
  143. data/sig/generated/skyward/orm/schema_mismatch.rbs +4 -0
  144. data/sig/generated/skyward/orm/statements.rbs +53 -0
  145. data/sig/generated/skyward/orm/tables/check.rbs +16 -0
  146. data/sig/generated/skyward/orm/tables/column.rbs +20 -0
  147. data/sig/generated/skyward/orm/tables/column_types.rbs +39 -0
  148. data/sig/generated/skyward/orm/tables/declarations.rbs +87 -0
  149. data/sig/generated/skyward/orm/tables/length.rbs +16 -0
  150. data/sig/generated/skyward/orm/tables/loaded.rbs +14 -0
  151. data/sig/generated/skyward/orm/tables/reference.rbs +18 -0
  152. data/sig/generated/skyward/orm/tables/rows.rbs +24 -0
  153. data/sig/generated/skyward/orm/tables/schema.rbs +28 -0
  154. data/sig/generated/skyward/orm/tables/sql.rbs +14 -0
  155. data/sig/generated/skyward/orm/tables/validation.rbs +9 -0
  156. data/sig/generated/skyward/orm/tables/values.rbs +49 -0
  157. data/sig/generated/skyward/orm/tables.rbs +7 -0
  158. data/sig/generated/skyward/orm/transactional.rbs +11 -0
  159. data/sig/generated/skyward/orm/violation.rbs +22 -0
  160. data/sig/generated/skyward/orm/violation_error.rbs +10 -0
  161. data/sig/generated/skyward/orm.rbs +29 -0
  162. data/sig/manual/pg.rbs +31 -0
  163. data/sig/manual/skyward/orm/adapters/postgresql.rbs +3 -0
  164. data/sig/manual/skyward/orm/adapters/sqlite/constraints.rbs +3 -0
  165. data/sig/manual/skyward/orm/adapters/sqlite.rbs +3 -0
  166. data/sig/manual/skyward/orm/adapters.rbs +3 -0
  167. data/sig/manual/skyward/orm/cli/boot_file.rbs +3 -0
  168. data/sig/manual/skyward/orm/cli/migrate.rbs +3 -0
  169. data/sig/manual/skyward/orm/cli/migration.rbs +3 -0
  170. data/sig/manual/skyward/orm/cli/rollback.rbs +3 -0
  171. data/sig/manual/skyward/orm/cli/status.rbs +3 -0
  172. data/sig/manual/skyward/orm/connection/database/schema_check.rbs +3 -0
  173. data/sig/manual/skyward/orm/members.rbs +3 -0
  174. data/sig/manual/skyward/orm/migrations/definitions.rbs +3 -0
  175. data/sig/manual/skyward/orm/migrations/diff.rbs +3 -0
  176. data/sig/manual/skyward/orm/migrations/directory.rbs +3 -0
  177. data/sig/manual/skyward/orm/migrations/discovery.rbs +3 -0
  178. data/sig/manual/skyward/orm/migrations/runner.rbs +3 -0
  179. data/sig/manual/skyward/orm/migrations/script.rbs +3 -0
  180. data/sig/manual/skyward/orm/migrations/status.rbs +3 -0
  181. data/sig/manual/skyward/orm/migrations/summary.rbs +3 -0
  182. data/sig/manual/skyward/orm/migrations/versions.rbs +3 -0
  183. data/sig/manual/skyward/orm/placeholders.rbs +3 -0
  184. data/sig/manual/skyward/orm/statements.rbs +3 -0
  185. data/sig/manual/skyward/orm/tables/loaded.rbs +3 -0
  186. data/sig/manual/skyward/orm/tables/rows.rbs +3 -0
  187. data/sig/manual/skyward/orm/tables/validation.rbs +3 -0
  188. data/sig/manual/skyward/orm/tables/values.rbs +3 -0
  189. data/sig/manual/skyward/orm.rbs +45 -0
  190. data/sig/manual/sqlite3.rbs +23 -0
  191. metadata +188 -3
@@ -0,0 +1,110 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skyward::ORM::Migrations::Summary
4
+ extend self
5
+
6
+ # @rbs changes: Array[Skyward::ORM::Migrations::change]
7
+ # @rbs adapter: Skyward::ORM::_Adapter
8
+ # @rbs return: String
9
+ def text(changes, adapter) = changes.map { |change| section(change, adapter) }.join
10
+
11
+ private
12
+
13
+ # Each change is a line, marked + for what's added, - for what's dropped,
14
+ # and ~ for what's changed, and the lines line up after what each names.
15
+ # @rbs change: Skyward::ORM::Migrations::change
16
+ # @rbs adapter: Skyward::ORM::_Adapter
17
+ # @rbs return: String
18
+ def section(change, adapter)
19
+ klass = change.klass
20
+ table = klass.table_name
21
+ case change
22
+ when Skyward::ORM::Migrations::CreateTable
23
+ "#{klass} has no table yet:\n + #{table} #{counts(change)}\n"
24
+ else
25
+ lines = change.edits.map { |edit| line(edit, adapter) }
26
+ width = lines.map { |_, name, _| name.length }.max || 0
27
+ ["#{klass} differs from the #{table} table:\n", *lines.map do |mark, name, text|
28
+ " #{mark} #{name.ljust(width)} #{text}\n"
29
+ end].join
30
+ end
31
+ end
32
+
33
+ # @rbs edit: Skyward::ORM::Migrations::edit
34
+ # @rbs adapter: Skyward::ORM::_Adapter
35
+ # @rbs return: [String, String, String]
36
+ def line(edit, adapter)
37
+ case edit
38
+ when Skyward::ORM::Migrations::AddColumn then ["+", edit.column.name.name, column(edit.column, adapter)]
39
+ when Skyward::ORM::Migrations::DropColumn
40
+ ["-", edit.column.name.name, "#{edit.column.type} #{edit.column.nullable ? "NULL" : "NOT NULL"}".lstrip]
41
+ when Skyward::ORM::Migrations::RenameColumn then ["~", edit.to.name, "renamed from #{edit.from}"]
42
+ when Skyward::ORM::Migrations::ChangeType then ["~", edit.column.name, "#{edit.to}, was #{edit.from}"]
43
+ when Skyward::ORM::Migrations::ChangeNullable
44
+ ["~", edit.column.name, edit.nullable ? "NULL, was NOT NULL" : "NOT NULL, was NULL"]
45
+ when Skyward::ORM::Migrations::ChangeDefault then ["~", edit.column.name,
46
+ "#{default(edit.to)}, was #{default(edit.from)}"]
47
+ when Skyward::ORM::Migrations::AddConstraint then ["+", edit.constraint.name.to_s, constraint(edit.constraint)]
48
+ when Skyward::ORM::Migrations::DropConstraint then ["-", edit.constraint.name || "unnamed",
49
+ constraint(edit.constraint)]
50
+ when Skyward::ORM::Migrations::AddIndex then ["+", edit.index.name, index(edit.index)]
51
+ else ["-", edit.index.name, index(edit.index)]
52
+ end
53
+ end
54
+
55
+ # @rbs change: Skyward::ORM::Migrations::CreateTable
56
+ # @rbs return: String
57
+ def counts(change)
58
+ schema = change.klass.schema
59
+ declared = [
60
+ [schema.references.size, "reference", "references"],
61
+ [schema.checks.size + change.columns.count { |column| column.type == :enum }, "check", "checks"],
62
+ [schema.uniques.size, "unique", "uniques"],
63
+ [schema.indexes.size, "index", "indexes"]
64
+ ] #: Array[[Integer, String, String]]
65
+ [
66
+ count(change.columns.size, "column", "columns"),
67
+ *declared.filter_map { |size, one, many| count(size, one, many) if size.positive? }
68
+ ].join(", ")
69
+ end
70
+
71
+ # @rbs size: Integer
72
+ # @rbs one: String
73
+ # @rbs many: String
74
+ # @rbs return: String
75
+ def count(size, one, many) = "#{size} #{size == 1 ? one : many}"
76
+
77
+ # @rbs column: Skyward::ORM::Tables::Column
78
+ # @rbs adapter: Skyward::ORM::_Adapter
79
+ # @rbs return: String
80
+ def column(column, adapter)
81
+ sql_type = adapter.sql_type(column.type)
82
+ return "needs a type" unless sql_type
83
+
84
+ "#{sql_type} #{column.nullable ? "NULL" : "NOT NULL"}"
85
+ end
86
+
87
+ # @rbs default: String?
88
+ # @rbs return: String
89
+ def default(default) = default ? "DEFAULT #{default}" : "no default"
90
+
91
+ # @rbs constraint: Skyward::ORM::Catalog::Constraint
92
+ # @rbs return: String
93
+ def constraint(constraint)
94
+ columns = "(#{constraint.columns.join(", ")})"
95
+ case constraint.kind
96
+ when :primary_key then "primary key #{columns}"
97
+ when :unique then "unique #{columns}"
98
+ when :check then "check #{columns}"
99
+ else "reference #{columns} to #{constraint.references}"
100
+ end
101
+ end
102
+
103
+ # An index on an expression has no columns to name.
104
+ # @rbs index: Skyward::ORM::Catalog::Index
105
+ # @rbs return: String
106
+ def index(index)
107
+ kind = index.unique ? "unique index" : "index"
108
+ index.columns.empty? ? "#{kind} on an expression" : "#{kind} (#{index.columns.join(", ")})"
109
+ end
110
+ end
@@ -0,0 +1,19 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skyward::ORM::Migrations::Versions
4
+ extend self
5
+
6
+ # Running a migration records its version here, and a database that's
7
+ # never been migrated doesn't have the table yet.
8
+ TABLE = :schema_migrations #: Symbol
9
+
10
+ # @rbs database: Skyward::ORM::Connection::Database
11
+ # @rbs return: Hash[String, String]
12
+ def checksums(database)
13
+ return {} unless database.tables.any? { |table| table.name == TABLE }
14
+
15
+ database.execute("SELECT version, checksum FROM #{TABLE}").to_h do |version, checksum|
16
+ [version.to_s, checksum.to_s]
17
+ end
18
+ end
19
+ end
@@ -0,0 +1,8 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skyward::ORM::Migrations
4
+ # @rbs!
5
+ # type change = CreateTable | AlterTable
6
+ # type edit = AddColumn | DropColumn | RenameColumn | ChangeType | ChangeNullable | ChangeDefault
7
+ # | AddConstraint | DropConstraint | AddIndex | DropIndex
8
+ end
@@ -0,0 +1,37 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skyward::ORM::Placeholders
4
+ extend self
5
+
6
+ # A ? in a string, a quoted name or a comment is the SQL's own, so those
7
+ # match whole and are kept. SQL escapes a quote by doubling it, which reads
8
+ # here as two strings side by side.
9
+ MARKS = %r{'[^']*'|"[^"]*"|--[^\n]*|/\*.*?\*/|\?}m #: Regexp
10
+
11
+ # @rbs sql: String
12
+ # @rbs count: Integer
13
+ # @rbs &: (Integer position) -> String
14
+ # @rbs return: String
15
+ def replace(sql, count)
16
+ marks = 0
17
+ replaced = sql.gsub(MARKS) { |match| match == "?" ? yield(marks += 1) : match }
18
+ return replaced if marks == count
19
+
20
+ raise ArgumentError, "The SQL has #{marks} ?, each taking one value, but was given #{count}"
21
+ end
22
+
23
+ # The driver spreads an Array or Hash across several placeholders, or none,
24
+ # moving every value after it to another `?`.
25
+ # @rbs binds: Array[untyped]
26
+ # @rbs subject: String
27
+ # @rbs return: void
28
+ def require_scalars(binds, subject)
29
+ binds.each.with_index(1) do |bind, index|
30
+ kind = case bind
31
+ when Array then "an Array"
32
+ when Hash then "a Hash"
33
+ end
34
+ raise ArgumentError, "#{subject} binds one value to each ?, but value #{index} is #{kind}" if kind
35
+ end
36
+ end
37
+ end
@@ -0,0 +1,4 @@
1
+ # frozen_string_literal: true
2
+
3
+ class Skyward::ORM::PoolTimeout < StandardError
4
+ end
@@ -0,0 +1,67 @@
1
+ # frozen_string_literal: true
2
+
3
+ # @rbs generic R
4
+ class Skyward::ORM::Projection
5
+ include Skyward::ORM::Queries::Clauses #[R]
6
+
7
+ # @rbs **values: untyped
8
+ # @rbs return: R | Skyward::ORM::Violation
9
+ def insert(**values)
10
+ require_insertable
11
+ database = @session.database
12
+ sql, binds = Skyward::ORM::Statements.insert(database.adapter, database.column_types, @table, values)
13
+ written = returning(sql, binds)
14
+ case written
15
+ when Skyward::ORM::Violation then written
16
+ else written.fetch(0)
17
+ end
18
+ end
19
+
20
+ # @rbs **values: untyped
21
+ # @rbs return: R
22
+ def insert!(**values) = unviolated(insert(**values))
23
+
24
+ # @rbs **values: untyped
25
+ # @rbs return: Array[R] | Skyward::ORM::Violation
26
+ def update(**values)
27
+ sql, binds = updating(values)
28
+ returning(sql, binds)
29
+ end
30
+
31
+ # @rbs **values: untyped
32
+ # @rbs return: Array[R]
33
+ def update!(**values) = unviolated(update(**values))
34
+
35
+ # @rbs return: Array[R] | Skyward::ORM::Violation
36
+ def delete
37
+ sql, binds = deleting
38
+ returning(sql, binds)
39
+ end
40
+
41
+ # @rbs return: Array[R]
42
+ def delete! = unviolated(delete)
43
+
44
+ private
45
+
46
+ # An INSERT writes one row and takes none of a query's clauses, so the query
47
+ # can only say what comes back.
48
+ # @rbs return: void
49
+ def require_insertable
50
+ refused = [("conditions" if @scope == :narrowed), *clauses].compact
51
+ return if refused.empty?
52
+
53
+ raise ArgumentError,
54
+ "#{@table} can't insert through a query with #{listing(refused)}. " \
55
+ "Start from #{@table}.into, with nothing else on it."
56
+ end
57
+
58
+ # Steep can't tie the row class to R, so the rows are untyped here and each
59
+ # public method types them.
60
+ # @rbs sql: String
61
+ # @rbs binds: Array[untyped]
62
+ # @rbs return: Array[untyped] | Skyward::ORM::Violation
63
+ def returning(sql, binds)
64
+ returned = Skyward::ORM::Statements.returning(Skyward::ORM::Members.of(@row))
65
+ @session.database.write_returning(@table, @row, "#{sql} #{returned}", binds)
66
+ end
67
+ end