@prisma/orm-mysql 0.0.0-stage → 8.0.0-rc.21

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 (392) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +44 -2
  3. package/dist/adapter.d.mts +1 -0
  4. package/dist/adapter.mjs +2 -0
  5. package/dist/adapter__adapter.d.mts +1 -0
  6. package/dist/adapter__adapter.mjs +2 -0
  7. package/dist/adapter__codec-types.d.mts +1 -0
  8. package/dist/adapter__codec-types.mjs +2 -0
  9. package/dist/adapter__control.d.mts +3 -0
  10. package/dist/adapter__control.mjs +3 -0
  11. package/dist/adapter__runtime.d.mts +3 -0
  12. package/dist/adapter__runtime.mjs +3 -0
  13. package/dist/builder.d.mts +1 -0
  14. package/dist/builder.mjs +2 -0
  15. package/dist/builder__runtime.d.mts +1 -0
  16. package/dist/builder__runtime.mjs +2 -0
  17. package/dist/builder__types.d.mts +1 -0
  18. package/dist/builder__types.mjs +2 -0
  19. package/dist/components.d.mts +1 -0
  20. package/dist/components.mjs +2 -0
  21. package/dist/components__authoring.d.mts +1 -0
  22. package/dist/components__authoring.mjs +2 -0
  23. package/dist/components__codec.d.mts +1 -0
  24. package/dist/components__codec.mjs +2 -0
  25. package/dist/components__components.d.mts +1 -0
  26. package/dist/components__components.mjs +2 -0
  27. package/dist/components__control.d.mts +1 -0
  28. package/dist/components__control.mjs +2 -0
  29. package/dist/components__emission.d.mts +1 -0
  30. package/dist/components__emission.mjs +2 -0
  31. package/dist/components__execution.d.mts +1 -0
  32. package/dist/components__execution.mjs +2 -0
  33. package/dist/components__ir.d.mts +1 -0
  34. package/dist/components__ir.mjs +2 -0
  35. package/dist/components__psl-ast.d.mts +1 -0
  36. package/dist/components__psl-ast.mjs +2 -0
  37. package/dist/components__runtime.d.mts +1 -0
  38. package/dist/components__runtime.mjs +2 -0
  39. package/dist/components__utils.d.mts +1 -0
  40. package/dist/components__utils.mjs +2 -0
  41. package/dist/config.d.mts +22 -0
  42. package/dist/config.d.mts.map +1 -0
  43. package/dist/config.mjs +41 -0
  44. package/dist/config.mjs.map +1 -0
  45. package/dist/contract-builder.d.mts +192 -0
  46. package/dist/contract-builder.d.mts.map +1 -0
  47. package/dist/contract-builder.mjs +37 -0
  48. package/dist/contract-builder.mjs.map +1 -0
  49. package/dist/contract.d.mts +1 -0
  50. package/dist/contract.mjs +2 -0
  51. package/dist/contract__apply-specifier-default-control-policy.d.mts +1 -0
  52. package/dist/contract__apply-specifier-default-control-policy.mjs +2 -0
  53. package/dist/contract__contract-validation-error.d.mts +1 -0
  54. package/dist/contract__contract-validation-error.mjs +2 -0
  55. package/dist/contract__default-namespace.d.mts +1 -0
  56. package/dist/contract__default-namespace.mjs +2 -0
  57. package/dist/contract__enum-accessor.d.mts +1 -0
  58. package/dist/contract__enum-accessor.mjs +2 -0
  59. package/dist/contract__hashing-utils.d.mts +1 -0
  60. package/dist/contract__hashing-utils.mjs +2 -0
  61. package/dist/contract__hashing.d.mts +1 -0
  62. package/dist/contract__hashing.mjs +2 -0
  63. package/dist/contract__is-plain-record.d.mts +1 -0
  64. package/dist/contract__is-plain-record.mjs +2 -0
  65. package/dist/contract__resolve-domain-model.d.mts +1 -0
  66. package/dist/contract__resolve-domain-model.mjs +2 -0
  67. package/dist/contract__types.d.mts +1 -0
  68. package/dist/contract__types.mjs +2 -0
  69. package/dist/contract__validate-domain.d.mts +1 -0
  70. package/dist/contract__validate-domain.mjs +2 -0
  71. package/dist/contract__validate-once.d.mts +1 -0
  72. package/dist/contract__validate-once.mjs +2 -0
  73. package/dist/contract__validate-storage.d.mts +1 -0
  74. package/dist/contract__validate-storage.mjs +2 -0
  75. package/dist/control.d.mts +12 -0
  76. package/dist/control.d.mts.map +1 -0
  77. package/dist/control.mjs +22 -0
  78. package/dist/control.mjs.map +1 -0
  79. package/dist/driver.d.mts +1 -0
  80. package/dist/driver.mjs +2 -0
  81. package/dist/driver__control.d.mts +3 -0
  82. package/dist/driver__control.mjs +3 -0
  83. package/dist/driver__runtime.d.mts +3 -0
  84. package/dist/driver__runtime.mjs +3 -0
  85. package/dist/family-contract.d.mts +1 -0
  86. package/dist/family-contract.mjs +2 -0
  87. package/dist/family-contract__authored-check-naming.d.mts +1 -0
  88. package/dist/family-contract__authored-check-naming.mjs +2 -0
  89. package/dist/family-contract__canonicalization-hooks.d.mts +1 -0
  90. package/dist/family-contract__canonicalization-hooks.mjs +2 -0
  91. package/dist/family-contract__check-expressions.d.mts +1 -0
  92. package/dist/family-contract__check-expressions.mjs +2 -0
  93. package/dist/family-contract__codec-json-type.d.mts +1 -0
  94. package/dist/family-contract__codec-json-type.mjs +2 -0
  95. package/dist/family-contract__contract-view.d.mts +1 -0
  96. package/dist/family-contract__contract-view.mjs +2 -0
  97. package/dist/family-contract__data-type-support.d.mts +1 -0
  98. package/dist/family-contract__data-type-support.mjs +2 -0
  99. package/dist/family-contract__data-type.d.mts +1 -0
  100. package/dist/family-contract__data-type.mjs +2 -0
  101. package/dist/family-contract__entity-handle-lowering-hook.d.mts +1 -0
  102. package/dist/family-contract__entity-handle-lowering-hook.mjs +2 -0
  103. package/dist/family-contract__entity-kinds.d.mts +1 -0
  104. package/dist/family-contract__entity-kinds.mjs +2 -0
  105. package/dist/family-contract__factories.d.mts +1 -0
  106. package/dist/family-contract__factories.mjs +2 -0
  107. package/dist/family-contract__foreign-key-materialization.d.mts +1 -0
  108. package/dist/family-contract__foreign-key-materialization.mjs +2 -0
  109. package/dist/family-contract__generated-id-column-aliases.d.mts +1 -0
  110. package/dist/family-contract__generated-id-column-aliases.mjs +2 -0
  111. package/dist/family-contract__index-naming.d.mts +1 -0
  112. package/dist/family-contract__index-naming.mjs +2 -0
  113. package/dist/family-contract__index-type-validation.d.mts +1 -0
  114. package/dist/family-contract__index-type-validation.mjs +2 -0
  115. package/dist/family-contract__index-types.d.mts +1 -0
  116. package/dist/family-contract__index-types.mjs +2 -0
  117. package/dist/family-contract__referential-action-sql.d.mts +1 -0
  118. package/dist/family-contract__referential-action-sql.mjs +2 -0
  119. package/dist/family-contract__resolve-storage-table.d.mts +1 -0
  120. package/dist/family-contract__resolve-storage-table.mjs +2 -0
  121. package/dist/family-contract__sql-expression.d.mts +1 -0
  122. package/dist/family-contract__sql-expression.mjs +2 -0
  123. package/dist/family-contract__types.d.mts +1 -0
  124. package/dist/family-contract__types.mjs +2 -0
  125. package/dist/family-contract__validators.d.mts +1 -0
  126. package/dist/family-contract__validators.mjs +2 -0
  127. package/dist/family-contract__value-set-derivation-hook.d.mts +1 -0
  128. package/dist/family-contract__value-set-derivation-hook.mjs +2 -0
  129. package/dist/family-runtime.d.mts +1 -0
  130. package/dist/family-runtime.mjs +2 -0
  131. package/dist/family-runtime__internal__prepared-query.d.mts +1 -0
  132. package/dist/family-runtime__internal__prepared-query.mjs +2 -0
  133. package/dist/family__control-adapter.d.mts +1 -0
  134. package/dist/family__control-adapter.mjs +2 -0
  135. package/dist/family__control.d.mts +3 -0
  136. package/dist/family__control.mjs +3 -0
  137. package/dist/family__diff.d.mts +1 -0
  138. package/dist/family__diff.mjs +2 -0
  139. package/dist/family__ir.d.mts +1 -0
  140. package/dist/family__ir.mjs +2 -0
  141. package/dist/family__migration.d.mts +1 -0
  142. package/dist/family__migration.mjs +2 -0
  143. package/dist/family__pack.d.mts +3 -0
  144. package/dist/family__pack.mjs +3 -0
  145. package/dist/family__psl-build.d.mts +1 -0
  146. package/dist/family__psl-build.mjs +2 -0
  147. package/dist/family__psl-infer.d.mts +1 -0
  148. package/dist/family__psl-infer.mjs +2 -0
  149. package/dist/family__runtime.d.mts +3 -0
  150. package/dist/family__runtime.mjs +3 -0
  151. package/dist/family__verify.d.mts +1 -0
  152. package/dist/family__verify.mjs +2 -0
  153. package/dist/migration-tools__aggregate.d.mts +1 -0
  154. package/dist/migration-tools__aggregate.mjs +2 -0
  155. package/dist/migration-tools__contract-snapshot-store.d.mts +1 -0
  156. package/dist/migration-tools__contract-snapshot-store.mjs +2 -0
  157. package/dist/migration-tools__hash.d.mts +1 -0
  158. package/dist/migration-tools__hash.mjs +2 -0
  159. package/dist/migration-tools__io.d.mts +1 -0
  160. package/dist/migration-tools__io.mjs +2 -0
  161. package/dist/migration-tools__spaces.d.mts +1 -0
  162. package/dist/migration-tools__spaces.mjs +2 -0
  163. package/dist/migration.d.mts +1 -0
  164. package/dist/migration.mjs +2 -0
  165. package/dist/mysql-static-DcYvSThw-BMxDuGkP.mjs +83 -0
  166. package/dist/mysql-static-DcYvSThw-BMxDuGkP.mjs.map +1 -0
  167. package/dist/mysql-uiFioAtk-BuXtMcWO.d.mts +100 -0
  168. package/dist/mysql-uiFioAtk-BuXtMcWO.d.mts.map +1 -0
  169. package/dist/orm-client.d.mts +1 -0
  170. package/dist/orm-client.mjs +2 -0
  171. package/dist/relational-core.d.mts +1 -0
  172. package/dist/relational-core.mjs +2 -0
  173. package/dist/relational-core__aggregate-descriptor-registry.d.mts +1 -0
  174. package/dist/relational-core__aggregate-descriptor-registry.mjs +2 -0
  175. package/dist/relational-core__ast.d.mts +1 -0
  176. package/dist/relational-core__ast.mjs +2 -0
  177. package/dist/relational-core__codec-descriptor-registry.d.mts +1 -0
  178. package/dist/relational-core__codec-descriptor-registry.mjs +2 -0
  179. package/dist/relational-core__collection-methods.d.mts +1 -0
  180. package/dist/relational-core__collection-methods.mjs +2 -0
  181. package/dist/relational-core__contract-free.d.mts +1 -0
  182. package/dist/relational-core__contract-free.mjs +2 -0
  183. package/dist/relational-core__expression.d.mts +1 -0
  184. package/dist/relational-core__expression.mjs +2 -0
  185. package/dist/relational-core__functions.d.mts +1 -0
  186. package/dist/relational-core__functions.mjs +2 -0
  187. package/dist/relational-core__index-reference.d.mts +1 -0
  188. package/dist/relational-core__index-reference.mjs +2 -0
  189. package/dist/relational-core__middleware.d.mts +1 -0
  190. package/dist/relational-core__middleware.mjs +2 -0
  191. package/dist/relational-core__plan.d.mts +1 -0
  192. package/dist/relational-core__plan.mjs +2 -0
  193. package/dist/relational-core__query-lane-context.d.mts +1 -0
  194. package/dist/relational-core__query-lane-context.mjs +2 -0
  195. package/dist/relational-core__types.d.mts +1 -0
  196. package/dist/relational-core__types.mjs +2 -0
  197. package/dist/runtime.d.mts +24 -0
  198. package/dist/runtime.d.mts.map +1 -0
  199. package/dist/runtime.mjs +266 -0
  200. package/dist/runtime.mjs.map +1 -0
  201. package/dist/schema-ir__types.d.mts +1 -0
  202. package/dist/schema-ir__types.mjs +2 -0
  203. package/dist/static.d.mts +25 -0
  204. package/dist/static.d.mts.map +1 -0
  205. package/dist/static.mjs +2 -0
  206. package/dist/target__codec-descriptor.d.mts +1 -0
  207. package/dist/target__codec-descriptor.mjs +2 -0
  208. package/dist/target__codec-ids.d.mts +1 -0
  209. package/dist/target__codec-ids.mjs +2 -0
  210. package/dist/target__codec-types.d.mts +1 -0
  211. package/dist/target__codec-types.mjs +2 -0
  212. package/dist/target__codecs.d.mts +1 -0
  213. package/dist/target__codecs.mjs +2 -0
  214. package/dist/target__contract-free.d.mts +1 -0
  215. package/dist/target__contract-free.mjs +2 -0
  216. package/dist/target__control-tables.d.mts +1 -0
  217. package/dist/target__control-tables.mjs +2 -0
  218. package/dist/target__control.d.mts +3 -0
  219. package/dist/target__control.mjs +3 -0
  220. package/dist/target__data-types.d.mts +1 -0
  221. package/dist/target__data-types.mjs +2 -0
  222. package/dist/target__ddl.d.mts +1 -0
  223. package/dist/target__ddl.mjs +2 -0
  224. package/dist/target__default-normalizer.d.mts +1 -0
  225. package/dist/target__default-normalizer.mjs +2 -0
  226. package/dist/target__errors.d.mts +1 -0
  227. package/dist/target__errors.mjs +2 -0
  228. package/dist/target__marker-lock.d.mts +1 -0
  229. package/dist/target__marker-lock.mjs +2 -0
  230. package/dist/target__migration.d.mts +1 -0
  231. package/dist/target__migration.mjs +2 -0
  232. package/dist/target__pack.d.mts +3 -0
  233. package/dist/target__pack.mjs +3 -0
  234. package/dist/target__runtime.d.mts +3 -0
  235. package/dist/target__runtime.mjs +3 -0
  236. package/dist/target__sql-utils.d.mts +1 -0
  237. package/dist/target__sql-utils.mjs +2 -0
  238. package/dist/utils.d.mts +1 -0
  239. package/dist/utils.mjs +2 -0
  240. package/dist/utils__abortable.d.mts +1 -0
  241. package/dist/utils__abortable.mjs +2 -0
  242. package/dist/utils__array-equal.d.mts +1 -0
  243. package/dist/utils__array-equal.mjs +2 -0
  244. package/dist/utils__assertions.d.mts +1 -0
  245. package/dist/utils__assertions.mjs +2 -0
  246. package/dist/utils__canonical-stringify.d.mts +1 -0
  247. package/dist/utils__canonical-stringify.mjs +2 -0
  248. package/dist/utils__casts.d.mts +1 -0
  249. package/dist/utils__casts.mjs +2 -0
  250. package/dist/utils__defined.d.mts +1 -0
  251. package/dist/utils__defined.mjs +2 -0
  252. package/dist/utils__hash-content.d.mts +1 -0
  253. package/dist/utils__hash-content.mjs +2 -0
  254. package/dist/utils__internal-error.d.mts +1 -0
  255. package/dist/utils__internal-error.mjs +2 -0
  256. package/dist/utils__json.d.mts +1 -0
  257. package/dist/utils__json.mjs +2 -0
  258. package/dist/utils__promise.d.mts +1 -0
  259. package/dist/utils__promise.mjs +2 -0
  260. package/dist/utils__redact-db-url.d.mts +1 -0
  261. package/dist/utils__redact-db-url.mjs +2 -0
  262. package/dist/utils__result.d.mts +1 -0
  263. package/dist/utils__result.mjs +2 -0
  264. package/dist/utils__simplify-deep.d.mts +1 -0
  265. package/dist/utils__simplify-deep.mjs +2 -0
  266. package/dist/utils__structured-error.d.mts +1 -0
  267. package/dist/utils__structured-error.mjs +2 -0
  268. package/dist/utils__suppress-idle-connection-errors.d.mts +1 -0
  269. package/dist/utils__suppress-idle-connection-errors.mjs +2 -0
  270. package/dist/utils__text.d.mts +1 -0
  271. package/dist/utils__text.mjs +2 -0
  272. package/dist/utils__types.d.mts +1 -0
  273. package/dist/utils__types.mjs +2 -0
  274. package/dist/vite-plugin-contract-emit.d.mts +1 -0
  275. package/dist/vite-plugin-contract-emit.mjs +2 -0
  276. package/package.json +175 -3
  277. package/skills/prisma-8/SKILL.md +100 -0
  278. package/skills/prisma-8/references/build.md +142 -0
  279. package/skills/prisma-8/references/contract.md +548 -0
  280. package/skills/prisma-8/references/debug.md +150 -0
  281. package/skills/prisma-8/references/feedback.md +251 -0
  282. package/skills/prisma-8/references/migration-model.md +179 -0
  283. package/skills/prisma-8/references/migration-review.md +211 -0
  284. package/skills/prisma-8/references/migrations.md +622 -0
  285. package/skills/prisma-8/references/queries-mongo.md +238 -0
  286. package/skills/prisma-8/references/queries-postgres.md +710 -0
  287. package/skills/prisma-8/references/queries.md +253 -0
  288. package/skills/prisma-8/references/quickstart.md +317 -0
  289. package/skills/prisma-8/references/runtime.md +463 -0
  290. package/skills/prisma-8/references/supabase.md +234 -0
  291. package/skills/prisma-8/references/upgrade-app.md +102 -0
  292. package/skills/prisma-8/references/upgrade-extension.md +108 -0
  293. package/skills/prisma-8/upgrading/app/upgrades/0.10-to-0.11/instructions.md +56 -0
  294. package/skills/prisma-8/upgrading/app/upgrades/0.11-to-0.12/instructions.md +381 -0
  295. package/skills/prisma-8/upgrading/app/upgrades/0.11-to-0.12/re-emit-closed-mongo-contracts.ts +202 -0
  296. package/skills/prisma-8/upgrading/app/upgrades/0.11-to-0.12/re-emit-domain-namespaced-contracts.ts +201 -0
  297. package/skills/prisma-8/upgrading/app/upgrades/0.11-to-0.12/re-emit-postgres-public-default.ts +198 -0
  298. package/skills/prisma-8/upgrading/app/upgrades/0.11-to-0.12/strip-migration-labels-hints.ts +340 -0
  299. package/skills/prisma-8/upgrading/app/upgrades/0.12-to-0.13/instructions.md +339 -0
  300. package/skills/prisma-8/upgrading/app/upgrades/0.12-to-0.13/re-emit-mti-variant-link-columns.ts +229 -0
  301. package/skills/prisma-8/upgrading/app/upgrades/0.13-to-0.14/instructions.md +543 -0
  302. package/skills/prisma-8/upgrading/app/upgrades/0.13-to-0.14/migration-op-factories-to-methods.ts +290 -0
  303. package/skills/prisma-8/upgrading/app/upgrades/0.13-to-0.14/uuid-preset-rename.ts +43 -0
  304. package/skills/prisma-8/upgrading/app/upgrades/0.14-to-0.15/instructions.md +359 -0
  305. package/skills/prisma-8/upgrading/app/upgrades/0.15-to-0.16/instructions.md +173 -0
  306. package/skills/prisma-8/upgrading/app/upgrades/0.16-to-0.17/instructions.md +805 -0
  307. package/skills/prisma-8/upgrading/app/upgrades/0.16-to-0.17/strip-sha256-hash-prefixes.ts +382 -0
  308. package/skills/prisma-8/upgrading/app/upgrades/0.17-to-8.0.0-rc.1/instructions.md +72 -0
  309. package/skills/prisma-8/upgrading/app/upgrades/0.7-to-0.8/instructions.md +8 -0
  310. package/skills/prisma-8/upgrading/app/upgrades/0.8-to-0.9/instructions.md +36 -0
  311. package/skills/prisma-8/upgrading/app/upgrades/0.8-to-0.9/strip-inline-contracts.ts +226 -0
  312. package/skills/prisma-8/upgrading/app/upgrades/0.9-to-0.10/instructions.md +86 -0
  313. package/skills/prisma-8/upgrading/app/upgrades/0.9-to-0.10/stamp-storage-types-kind.ts +360 -0
  314. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.1-to-8.0.0-rc.2/instructions.md +588 -0
  315. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.10-to-8.0.0-rc.11/instructions.md +34 -0
  316. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.11-to-8.0.0-rc.12/instructions.md +639 -0
  317. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.11-to-8.0.0-rc.12/scripts/multifile-psl/add-use-prisma-8-directive.mjs +60 -0
  318. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.11-to-8.0.0-rc.12/scripts/psl-verbatim-table-names/add-model-map.mjs +256 -0
  319. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/instructions.md +332 -0
  320. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/scripts/execution-ref-entry-field/rename-execution-ref-keys.ts +193 -0
  321. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.13-to-8.0.0-rc.14/instructions.md +489 -0
  322. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.14-to-8.0.0-rc.15/instructions.md +1368 -0
  323. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.14-to-8.0.0-rc.15/scripts/data-type-in-contract/data-type-in-contract.ts +1492 -0
  324. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.15-to-8.0.0-rc.16/instructions.md +108 -0
  325. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.16-to-8.0.0-rc.17/instructions.md +755 -0
  326. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.17-to-8.0.0-rc.18/instructions.md +973 -0
  327. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.17-to-8.0.0-rc.18/scripts/sql-expression-literals-psl/rewrite-sql-strings.mjs +271 -0
  328. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/instructions.md +1862 -0
  329. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/client-takes-contract-value/contract-from-json.ts +597 -0
  330. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/data-type-values/data-type-values.ts +1120 -0
  331. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/default-generators-to-on-create/rewrite-default-generators.mjs +86 -0
  332. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/mongo-field-storage-names/mongo-field-storage-names.ts +304 -0
  333. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/remove-nocheck/remove-nocheck.ts +2462 -0
  334. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.19-to-8.0.0-rc.20/instructions.md +513 -0
  335. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.19-to-8.0.0-rc.20/scripts/expand-type-aliases/expand-type-aliases.ts +1206 -0
  336. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.2-to-8.0.0-rc.3/instructions.md +5 -0
  337. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.20-to-8.0.0-rc.21/instructions.md +802 -0
  338. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.3-to-8.0.0-rc.4/instructions.md +158 -0
  339. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.4-to-8.0.0-rc.5/instructions.md +42 -0
  340. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.5-to-8.0.0-rc.6/instructions.md +157 -0
  341. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.6-to-8.0.0-rc.7/instructions.md +33 -0
  342. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.7-to-8.0.0-rc.8/instructions.md +36 -0
  343. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.8-to-8.0.0-rc.9/instructions.md +63 -0
  344. package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.9-to-8.0.0-rc.10/instructions.md +84 -0
  345. package/skills/prisma-8/upgrading/extension/upgrades/0.10-to-0.11/instructions.md +276 -0
  346. package/skills/prisma-8/upgrading/extension/upgrades/0.11-to-0.12/instructions.md +738 -0
  347. package/skills/prisma-8/upgrading/extension/upgrades/0.11-to-0.12/migrate-contract-testing-imports.ts +97 -0
  348. package/skills/prisma-8/upgrading/extension/upgrades/0.11-to-0.12/regenerate-extension-public-baseline.ts +223 -0
  349. package/skills/prisma-8/upgrading/extension/upgrades/0.11-to-0.12/strip-migration-labels-hints.ts +340 -0
  350. package/skills/prisma-8/upgrading/extension/upgrades/0.12-to-0.13/instructions.md +266 -0
  351. package/skills/prisma-8/upgrading/extension/upgrades/0.13-to-0.14/instructions.md +522 -0
  352. package/skills/prisma-8/upgrading/extension/upgrades/0.13-to-0.14/migration-op-factories-to-methods.ts +290 -0
  353. package/skills/prisma-8/upgrading/extension/upgrades/0.13-to-0.14/uuid-preset-rename.ts +43 -0
  354. package/skills/prisma-8/upgrading/extension/upgrades/0.14-to-0.15/instructions.md +803 -0
  355. package/skills/prisma-8/upgrading/extension/upgrades/0.15-to-0.16/instructions.md +219 -0
  356. package/skills/prisma-8/upgrading/extension/upgrades/0.16-to-0.17/instructions.md +731 -0
  357. package/skills/prisma-8/upgrading/extension/upgrades/0.16-to-0.17/strip-sha256-hash-prefixes.ts +382 -0
  358. package/skills/prisma-8/upgrading/extension/upgrades/0.17-to-8.0.0-rc.1/instructions.md +194 -0
  359. package/skills/prisma-8/upgrading/extension/upgrades/0.7-to-0.8/instructions.md +8 -0
  360. package/skills/prisma-8/upgrading/extension/upgrades/0.8-to-0.9/instructions.md +57 -0
  361. package/skills/prisma-8/upgrading/extension/upgrades/0.8-to-0.9/strip-inline-contracts.ts +226 -0
  362. package/skills/prisma-8/upgrading/extension/upgrades/0.9-to-0.10/instructions.md +150 -0
  363. package/skills/prisma-8/upgrading/extension/upgrades/0.9-to-0.10/stamp-storage-types-kind.ts +360 -0
  364. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.1-to-8.0.0-rc.2/instructions.md +746 -0
  365. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.10-to-8.0.0-rc.11/instructions.md +34 -0
  366. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.11-to-8.0.0-rc.12/instructions.md +857 -0
  367. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.11-to-8.0.0-rc.12/scripts/psl-verbatim-table-names/add-model-map.mjs +256 -0
  368. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/instructions.md +504 -0
  369. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/scripts/execution-ref-entry-field/rename-execution-ref-keys.ts +193 -0
  370. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.13-to-8.0.0-rc.14/instructions.md +143 -0
  371. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.14-to-8.0.0-rc.15/instructions.md +2168 -0
  372. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.14-to-8.0.0-rc.15/scripts/data-type-in-contract/data-type-in-contract.ts +1492 -0
  373. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.15-to-8.0.0-rc.16/instructions.md +223 -0
  374. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.16-to-8.0.0-rc.17/instructions.md +583 -0
  375. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.17-to-8.0.0-rc.18/instructions.md +1008 -0
  376. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/instructions.md +2186 -0
  377. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/client-takes-contract-value/contract-from-json.ts +597 -0
  378. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/data-type-values/data-type-values.ts +1120 -0
  379. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/default-generators-to-on-create/rewrite-default-generators.mjs +86 -0
  380. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/mongo-field-storage-names/mongo-field-storage-names.ts +304 -0
  381. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.18-to-8.0.0-rc.19/scripts/remove-nocheck/remove-nocheck.ts +2462 -0
  382. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.19-to-8.0.0-rc.20/instructions.md +381 -0
  383. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.19-to-8.0.0-rc.20/scripts/expand-type-aliases/expand-type-aliases.ts +1206 -0
  384. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.2-to-8.0.0-rc.3/instructions.md +5 -0
  385. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.20-to-8.0.0-rc.21/instructions.md +570 -0
  386. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.3-to-8.0.0-rc.4/instructions.md +137 -0
  387. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.4-to-8.0.0-rc.5/instructions.md +129 -0
  388. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.5-to-8.0.0-rc.6/instructions.md +102 -0
  389. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.6-to-8.0.0-rc.7/instructions.md +33 -0
  390. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.7-to-8.0.0-rc.8/instructions.md +35 -0
  391. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.8-to-8.0.0-rc.9/instructions.md +86 -0
  392. package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.9-to-8.0.0-rc.10/instructions.md +63 -0
@@ -0,0 +1,60 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Adds `// use prisma-8` as the first line of every PSL schema file that
4
+ * lacks it, matching the directive `isPrismaNextSchema` checks for
5
+ * (`@internal/psl-parser`). A file that already carries the directive (or
6
+ * its legacy `// use prisma-next` spelling) is left untouched.
7
+ *
8
+ * Usage:
9
+ * node scripts/multifile-psl/add-use-prisma-8-directive.mjs <file-or-glob> [...more]
10
+ *
11
+ * Globs never descend into `node_modules` or `dist`.
12
+ *
13
+ * Every matched file is printed as `<file>: added directive` (or `already
14
+ * present`) for review. Running it twice is a no-op.
15
+ */
16
+
17
+ import { readFileSync, writeFileSync } from 'node:fs';
18
+ import { glob } from 'node:fs/promises';
19
+ import { argv, exit, stderr, stdout } from 'node:process';
20
+ import { fileURLToPath } from 'node:url';
21
+
22
+ const DIRECTIVE = /^(\s*\/\/ *use +)(prisma-8|prisma-next)( *)(?!\S)/;
23
+
24
+ async function expand(patterns) {
25
+ const files = [];
26
+ for (const pattern of patterns) {
27
+ for await (const match of glob(pattern, { exclude: ['**/node_modules/**', '**/dist/**'] })) {
28
+ files.push(match);
29
+ }
30
+ }
31
+ return files;
32
+ }
33
+
34
+ function addDirective(path) {
35
+ const original = readFileSync(path, 'utf8');
36
+ if (DIRECTIVE.test(original)) {
37
+ stdout.write(`${path}: already present\n`);
38
+ return;
39
+ }
40
+ writeFileSync(path, `// use prisma-8\n\n${original}`, 'utf8');
41
+ stdout.write(`${path}: added directive\n`);
42
+ }
43
+
44
+ async function main() {
45
+ const patterns = argv.slice(2);
46
+ if (patterns.length === 0) {
47
+ stderr.write('usage: add-use-prisma-8-directive.mjs <file-or-glob> [...more]\n');
48
+ exit(1);
49
+ }
50
+ const files = await expand(patterns);
51
+ if (files.length === 0) {
52
+ stderr.write('no files matched\n');
53
+ exit(1);
54
+ }
55
+ for (const file of files) addDirective(file);
56
+ }
57
+
58
+ if (process.argv[1] === fileURLToPath(import.meta.url)) {
59
+ await main();
60
+ }
@@ -0,0 +1,256 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Adds `@@map("<model name with its first letter lowered>")` to every PSL
4
+ * `model` block that has no `@@map`, so a schema written before Prisma 8 made
5
+ * model names verbatim keeps the table (or collection) names it already has.
6
+ *
7
+ * Usage:
8
+ * node <path to this file> <file-or-glob> [...more]
9
+ *
10
+ * Globs never descend into `node_modules` or `dist`.
11
+ *
12
+ * A model with `@@base(...)` and no `@@map` shares its base's storage, so it
13
+ * is left alone: adding `@@map` there would split it into its own table or
14
+ * collection.
15
+ *
16
+ * Files are rewritten in place; every mapped model is printed as
17
+ * `<file>: model <Name> -> @@map("<name>")` for review. Running it twice is a
18
+ * no-op. Only run it on a schema written against the previous release: a
19
+ * schema inferred after upgrading already names its tables verbatim.
20
+ */
21
+
22
+ import { readFileSync, writeFileSync } from 'node:fs';
23
+ import { glob } from 'node:fs/promises';
24
+ import { argv, exit, stderr, stdout } from 'node:process';
25
+ import { fileURLToPath } from 'node:url';
26
+
27
+ const MODEL_LINE = /^\s*model\s/;
28
+ const MODEL_START = /^(\s*)model\s+([A-Za-z_][A-Za-z0-9_]*)\s*(\{)?(.*)$/;
29
+ const OPEN_BRACE_LINE = /^\s*\{\s*(\/\/.*)?$/;
30
+ const BLANK_OR_COMMENT = /^\s*(\/\/.*)?$/;
31
+ const BLOCK_CLOSE = /^\s*\}\s*(\/\/.*)?$/;
32
+ const MAP_ATTRIBUTE = /^\s*@@map\s*\(/;
33
+ const BASE_ATTRIBUTE = /^\s*@@base\s*\(/;
34
+ const OWN_STORAGE_ATTRIBUTE = /@@(map|base)\s*\(/;
35
+
36
+ function lowerFirst(name) {
37
+ return name.charAt(0).toLowerCase() + name.slice(1);
38
+ }
39
+
40
+ function bodyIndent(lines, start, end, headerIndent) {
41
+ for (let i = start; i < end; i += 1) {
42
+ const match = /^(\s*)\S/.exec(lines[i]);
43
+ if (match) return match[1];
44
+ }
45
+ return `${headerIndent} `;
46
+ }
47
+
48
+ function stripCr(line) {
49
+ return line.replace(/\r$/, '');
50
+ }
51
+
52
+ /**
53
+ * Classifies the `model` line at `index`. Returns the header indent, the model
54
+ * name, the index of the first body line, any body text that shares the
55
+ * header line, and whether the whole block sits on this one line.
56
+ */
57
+ function nextNonBlankIndex(lines, index) {
58
+ let i = index + 1;
59
+ while (i < lines.length && BLANK_OR_COMMENT.test(stripCr(lines[i]))) i += 1;
60
+ return i;
61
+ }
62
+
63
+ /**
64
+ * A `model` line is a declaration only when the block's `{` follows the model
65
+ * name on that line, or opens the next line that is not blank or a comment.
66
+ * Any other `model` line is a field named `model` inside some block and is
67
+ * left alone.
68
+ */
69
+ function isModelDeclaration(lines, index) {
70
+ const match = MODEL_START.exec(stripCr(lines[index]));
71
+ if (!match) return false;
72
+ if (match[3] !== undefined) return true;
73
+ const next = lines[nextNonBlankIndex(lines, index)];
74
+ return next !== undefined && OPEN_BRACE_LINE.test(stripCr(next));
75
+ }
76
+
77
+ function readModelStart(lines, index) {
78
+ const match = MODEL_START.exec(stripCr(lines[index]));
79
+ if (!match) return undefined;
80
+ const [, indent, modelName, brace, rest] = match;
81
+ if (brace === undefined) {
82
+ if (!BLANK_OR_COMMENT.test(rest)) return undefined;
83
+ const braceAt = nextNonBlankIndex(lines, index);
84
+ const next = lines[braceAt];
85
+ if (next === undefined || !OPEN_BRACE_LINE.test(stripCr(next))) return undefined;
86
+ return { indent, modelName, bodyStart: braceAt + 1, inlineBody: '', singleLine: false };
87
+ }
88
+ const closeAt = closingBraceIndex(rest);
89
+ if (closeAt !== -1) {
90
+ return { indent, modelName, bodyStart: index + 1, inlineBody: rest, singleLine: true };
91
+ }
92
+ return {
93
+ indent,
94
+ modelName,
95
+ bodyStart: index + 1,
96
+ inlineBody: BLANK_OR_COMMENT.test(rest) ? '' : rest,
97
+ singleLine: false,
98
+ };
99
+ }
100
+
101
+ /** The line without a trailing `//` comment; a `//` inside a double-quoted string is content. */
102
+ function stripLineComment(text) {
103
+ let quoted = false;
104
+ for (let i = 0; i < text.length; i += 1) {
105
+ const char = text[i];
106
+ if (quoted) {
107
+ if (char === '\\') i += 1;
108
+ else if (char === '"') quoted = false;
109
+ } else if (char === '"') {
110
+ quoted = true;
111
+ } else if (char === '/' && text[i + 1] === '/') {
112
+ return text.slice(0, i).trimEnd();
113
+ }
114
+ }
115
+ return text;
116
+ }
117
+
118
+ /** Index of a `}` that ends the block on this line (only whitespace or a `//` comment may follow), else -1. */
119
+ function closingBraceIndex(text) {
120
+ const code = stripLineComment(text);
121
+ const closeAt = code.lastIndexOf('}');
122
+ return closeAt !== -1 && /^\s*$/.test(code.slice(closeAt + 1)) ? closeAt : -1;
123
+ }
124
+
125
+ function addMapToSingleLineModel(line, modelName) {
126
+ const raw = stripCr(line);
127
+ const closeAt = closingBraceIndex(raw);
128
+ const body = raw.slice(0, closeAt);
129
+ if (OWN_STORAGE_ATTRIBUTE.test(body)) return line;
130
+ return `${body.trimEnd()} @@map("${lowerFirst(modelName)}") ${line.slice(closeAt)}`;
131
+ }
132
+
133
+ /** Thrown when a `model` declaration is written in a shape the codemod does not recognise. */
134
+ export class UnhandledModelError extends Error {
135
+ constructor(lineNumbers) {
136
+ super(`model block(s) not understood at line(s) ${lineNumbers.join(', ')}`);
137
+ this.lineNumbers = lineNumbers;
138
+ }
139
+ }
140
+
141
+ /**
142
+ * Rewrites `source` and also returns the models that received an `@@map`, so a
143
+ * caller can show the user what was mapped. The codemod cannot see storage:
144
+ * it assumes every unmapped model was written against the release whose
145
+ * default lowered the first letter.
146
+ */
147
+ export function addModelMapsWithReport(source) {
148
+ const newline = source.includes('\r\n') ? '\r' : '';
149
+ const lines = source.split('\n');
150
+ const out = [];
151
+ const unhandled = [];
152
+ const mapped = [];
153
+ let i = 0;
154
+ while (i < lines.length) {
155
+ if (!MODEL_LINE.test(lines[i]) || !isModelDeclaration(lines, i)) {
156
+ out.push(lines[i]);
157
+ i += 1;
158
+ continue;
159
+ }
160
+ const start = readModelStart(lines, i);
161
+ if (start === undefined) {
162
+ unhandled.push(i + 1);
163
+ out.push(lines[i]);
164
+ i += 1;
165
+ continue;
166
+ }
167
+ if (start.singleLine) {
168
+ const rewritten = addMapToSingleLineModel(lines[i], start.modelName);
169
+ if (rewritten !== lines[i]) mapped.push(start.modelName);
170
+ out.push(rewritten);
171
+ i += 1;
172
+ continue;
173
+ }
174
+ let close = start.bodyStart;
175
+ while (close < lines.length && !BLOCK_CLOSE.test(lines[close])) close += 1;
176
+ if (close >= lines.length) {
177
+ unhandled.push(i + 1);
178
+ out.push(...lines.slice(i));
179
+ break;
180
+ }
181
+ const body = [start.inlineBody, ...lines.slice(start.bodyStart, close)];
182
+ out.push(...lines.slice(i, close));
183
+ if (!body.some((line) => MAP_ATTRIBUTE.test(line) || BASE_ATTRIBUTE.test(line))) {
184
+ const indent = bodyIndent(lines, start.bodyStart, close, start.indent);
185
+ out.push(`${indent}@@map("${lowerFirst(start.modelName)}")${newline}`);
186
+ mapped.push(start.modelName);
187
+ }
188
+ out.push(lines[close]);
189
+ i = close + 1;
190
+ }
191
+ if (unhandled.length > 0) throw new UnhandledModelError(unhandled);
192
+ return { source: out.join('\n'), mapped };
193
+ }
194
+
195
+ export function addModelMaps(source) {
196
+ return addModelMapsWithReport(source).source;
197
+ }
198
+
199
+ const SKIPPED_DIRECTORIES = /(^|\/)(node_modules|dist)\//;
200
+
201
+ async function expandPatterns(patterns) {
202
+ const files = new Set();
203
+ for (const pattern of patterns) {
204
+ for await (const match of glob(pattern, {
205
+ exclude: (path) => SKIPPED_DIRECTORIES.test(`${path}/`),
206
+ })) {
207
+ files.add(match);
208
+ }
209
+ }
210
+ return [...files].sort();
211
+ }
212
+
213
+ async function main() {
214
+ const patterns = argv.slice(2);
215
+ if (patterns.length === 0) {
216
+ stderr.write('usage: node add-model-map.mjs <file-or-glob> [...more]\n');
217
+ exit(2);
218
+ }
219
+ const files = await expandPatterns(patterns);
220
+ if (files.length === 0) {
221
+ stderr.write('no files matched\n');
222
+ exit(1);
223
+ }
224
+ let failed = false;
225
+ let mappedCount = 0;
226
+ for (const file of files) {
227
+ const before = readFileSync(file, 'utf8');
228
+ let result;
229
+ try {
230
+ result = addModelMapsWithReport(before);
231
+ } catch (error) {
232
+ if (!(error instanceof UnhandledModelError)) throw error;
233
+ for (const line of error.lineNumbers)
234
+ stderr.write(`${file}:${line}: model block not understood\n`);
235
+ failed = true;
236
+ continue;
237
+ }
238
+ if (result.source !== before) {
239
+ writeFileSync(file, result.source);
240
+ for (const modelName of result.mapped) {
241
+ stdout.write(`${file}: model ${modelName} -> @@map("${lowerFirst(modelName)}")\n`);
242
+ }
243
+ mappedCount += result.mapped.length;
244
+ }
245
+ }
246
+ if (mappedCount > 0) {
247
+ stdout.write(
248
+ `${mappedCount} model(s) mapped. Review the list: every one must be a model whose table or collection was created under the previous release's lowered-first-letter default. A schema written or inferred after upgrading must not be run through this codemod.\n`,
249
+ );
250
+ }
251
+ if (failed) exit(1);
252
+ }
253
+
254
+ if (argv[1] && fileURLToPath(import.meta.url) === argv[1]) {
255
+ await main();
256
+ }
@@ -0,0 +1,332 @@
1
+ ---
2
+ from: "8.0.0-rc.12"
3
+ to: "8.0.0-rc.13"
4
+ changes:
5
+ - id: execution-ref-entry-field
6
+ summary: |
7
+ Each entry in `contract.execution.mutations.defaults` now names its target as
8
+ `ref: { namespace, entry, field }` instead of `ref: { namespace, table, column }`. The values
9
+ are the same table and column names. Re-emit the contract; code that reads `.ref.table` or
10
+ `.ref.column` reads `.ref.entry` and `.ref.field`.
11
+ detection:
12
+ glob: "**/*.{json,ts,mts,cts}"
13
+ matches:
14
+ - '"ref"\s*:\s*\{(?![^{}]*"kind")[^{}]*"(?:table|column)"\s*:'
15
+ - '\.ref\??\.(?:table|column)\b'
16
+ - '\bref\s*:\s*\{(?![^{}]*\bkind\b)[^{}]*\b(?:table|column)\s*:[^{}]*\b(?:table|column)\s*:'
17
+ script: ./scripts/execution-ref-entry-field/rename-execution-ref-keys.ts
18
+ - id: ts-defaults-encoded-by-codec
19
+ summary: |
20
+ `defineContract` from the Postgres and SQLite packages now encodes every literal `.default(value)` through the column's codec. The literal is the codec's input type. TypeScript checks it for fields built inside the `defineContract` factory, and the build fails with `CONTRACT.DEFAULT_INVALID` for a value the codec refuses. Pass a value of the codec's input type, or choose the field preset whose codec takes the value you have.
21
+ detection:
22
+ glob: "**/*.{ts,mts,cts}"
23
+ matches:
24
+ - '\.default\(\s*(?!now\(\)|autoincrement\(\)|sql`)'
25
+ - id: contract-format-formats-prisma7-schema
26
+ summary: prisma contract format now formats a Prisma 7 schema configured through prisma7Schema().
27
+ - id: config-contract-source-requires-format
28
+ summary: A contract source object written in prisma.config.ts must declare format 'psl' or 'typescript'.
29
+ - id: policy-expression-json-escapes
30
+ summary: A policy expression in a PSL contract decodes every JSON escape, so \t, \b, \f, \/ and \uXXXX no longer read as written.
31
+ - id: cursor-rejects-expression-orders
32
+ summary: "cursor() now throws ORM.ARGUMENT_INVALID when an active orderBy item is not a plain column (extension-operation orders such as vector distance were previously dropped from the keyset silently)"
33
+ detection:
34
+ glob: "**/*.{ts,mts,cts}"
35
+ matches:
36
+ - '\.cursor\('
37
+ - id: mongo-codec-subpaths-move-to-target
38
+ summary: |
39
+ The Mongo codec subpaths moved from the adapter to the target:
40
+ `adapter/codec-types`, `adapter/codecs`, `adapter/codec-ids` and `adapter/data-types` under
41
+ `@prisma/orm-mongo` and `@prisma/orm-target-mongo` are now `target/...`. Emitted
42
+ `contract.d.ts` files, including migration snapshots, import `adapter/codec-types` until
43
+ rewritten or re-emitted. Under `skipLibCheck: true` that import fails silently and the
44
+ contract's field types turn wrong where they are used, instead of failing to compile.
45
+ detection:
46
+ glob: "**/*.{ts,mts,cts,md}"
47
+ matches:
48
+ - '@prisma/orm-(?:target-)?mongo/adapter/(?:codec-types|codecs|codec-ids|data-types)(?![\w-])'
49
+ - id: create-mongo-runner-deps-removed
50
+ summary: |
51
+ `createMongoRunnerDeps(...)` is removed from `@prisma/orm-mongo/adapter/control`. Build the
52
+ runner dependencies with `new MongoControlAdapterImpl().createRunnerDependencies(controlDriver)`.
53
+ detection:
54
+ glob: "**/*.{ts,mts,cts}"
55
+ matches:
56
+ - '\bcreateMongoRunnerDeps\b'
57
+ - id: mongo-runner-dependency-types-move-to-family
58
+ summary: |
59
+ `MongoRunnerDependencies` and `MarkerOperations` are no longer exported from
60
+ `adapter/control` or `target/control`; import them from `@prisma/orm-mongo/family/control-adapter`.
61
+ detection:
62
+ glob: "**/*.{ts,mts,cts}"
63
+ matches:
64
+ - '\b(?:MongoRunnerDependencies|MarkerOperations)\b[^;]*?from\s*[''"]@prisma/orm-(?:target-)?mongo/(?:adapter|target)/control[''"]'
65
+ - id: mongo-create-runner-needs-adapter-on-stack
66
+ summary: |
67
+ `mongoTargetDescriptor.migrations.createRunner(family)` now reaches the database through the
68
+ control adapter on the family's control stack. A family instance created from an empty
69
+ stack (`createMongoFamilyInstance({} as ...)`), or from a `createControlStack(...)` with no
70
+ `adapter`, fails with "Mongo family requires an adapter descriptor in ControlStack" when the
71
+ runner executes.
72
+ detection:
73
+ glob: "**/*.{ts,mts,cts}"
74
+ matches:
75
+ - 'createMongoFamilyInstance\(\s*\{\s*\}'
76
+ - 'createControlStack\(\s*\{(?:(?!adapter)[^}])*mongoTargetDescriptor(?:(?!adapter)[^}])*\}\s*\)'
77
+ - id: mongo-psl-scalar-names
78
+ summary: |
79
+ Four Mongo PSL scalar names are deprecated in favour of the name of the BSON type they store:
80
+ `Int` → `Int32`, `Float` → `Double`, `Boolean` → `Bool`, `DateTime` → `Date`. The old names
81
+ are still accepted, with a `PSL_DEPRECATED_SCALAR_NAME` warning, and will be removed in a later
82
+ release; rename them now. Codec ids, `contract.json` and every hash are unchanged. Rename only
83
+ in the Prisma 8 contract source and its `migrations/app/*/contract.prisma` copies, never in a
84
+ Prisma 6 `schema.prisma`.
85
+ detection:
86
+ glob: "**/*.prisma"
87
+ matches:
88
+ - '(?<![\s\S])(?![\s\S]*\bprovider\s*=\s*"mongodb")[\s\S]*?(?:^|\n)[ \t]*[A-Za-z_][A-Za-z0-9_]*[ \t]+(?:Int|Float|Boolean|DateTime)(?:\[\])?\??(?![ \t]*\{)(?=\s|$)'
89
+ - id: mongo-variant-field-codecs
90
+ summary: |
91
+ Through `.variant(...)`, a field declared only on the variant model is now written and read
92
+ through its codec, as base-model fields always were. An `ObjectId` field there is stored as
93
+ an `ObjectId` and read back as a hex string, and a where filter on it encodes a hex string.
94
+ - id: contract-artifacts-restamp
95
+ summary: |
96
+ The emitted `contract.json` / `contract.d.ts` embed the toolchain version, which moves
97
+ to 8.0.0-rc.13. Run `contract emit` once after upgrading so the emitted artifacts match
98
+ the installed toolchain.
99
+ detection:
100
+ glob: "**/contract.json"
101
+ contains:
102
+ - '"version": "8.0.0-rc.12"'
103
+ ---
104
+
105
+ # 8.0.0-rc.12 → 8.0.0-rc.13 — User upgrade instructions
106
+
107
+ ## `execution-ref-entry-field`
108
+
109
+ A contract with generated defaults (`temporal.createdAt()`, `temporal.updatedAt()`, `@default(uuid())` and the like) carries them under `execution.mutations.defaults`. Each entry's `ref` changes keys; the values do not:
110
+
111
+ ```json
112
+ // before
113
+ { "ref": { "namespace": "public", "table": "user", "column": "updated_at" }, "onUpdate": { "kind": "generator", "id": "timestampNow" } }
114
+
115
+ // after
116
+ { "ref": { "entry": "user", "field": "updated_at", "namespace": "public" }, "onUpdate": { "kind": "generator", "id": "timestampNow" } }
117
+ ```
118
+
119
+ 1. Run `prisma contract emit` so `contract.json` and `contract.d.ts` use the new keys. The runtime rejects a contract whose refs still say `table` and `column` with `Contract structural validation failed: execution.mutations.defaults[0].ref.entry must be a string`.
120
+ 2. Contracts stored under `migrations/` carry the old keys too: the snapshots in `migrations/snapshots/<hash>/contract.json` and `contract.d.ts`, and any intermediate contract a migration imports from its own directory, such as `migrations/app/<dir>/intermediate.json` and `intermediate.d.ts`. From the project root, run the script that sits next to this guide. `<skill>` is the directory of the synced `prisma-8` skill:
121
+
122
+ ```bash
123
+ pnpm exec tsx <skill>/upgrading/app/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/scripts/execution-ref-entry-field/rename-execution-ref-keys.ts
124
+ ```
125
+
126
+ The script reads every `.json` and `.d.ts` file under a `migrations/` directory, skipping `node_modules`, `.git` and `dist`, and changes only `execution.mutations.defaults[].ref` entries. In each one it renames `table` to `entry` and `column` to `field`, and writes the keys in the order `entry`, `field`, `namespace`, which is the order `prisma contract emit` writes. The old key order varies between files: older `contract.d.ts` files list `namespace`, `table`, `column`, newer ones `column`, `namespace`, `table`. The script handles any order; a hand edit or a search-and-replace that assumes one order misses some refs. A `contract.json` in canonical form stays canonical, so a snapshot matches a fresh emit apart from `executionHash`; an indented JSON file keeps its indentation. The script leaves every `executionHash` as it is. That hash no longer matches the renamed content, but the snapshot loader re-hashes only the storage section, so nothing checks it. `storageHash` and `profileHash` do not move, so snapshot directory names stay the same. A second run changes nothing. Pass `--check` to list the files it would change without writing them; it exits 1 if any would change. A `.json` file it cannot parse is listed as `NOT JSON` and also makes it exit 1.
127
+
128
+ To confirm the rewrite, name one migration directory under `migrations/app/` as both ends of a plan: `prisma migration plan --from <dir> --to <dir>`. It loads that migration's snapshot without touching the database. Before the rewrite it fails with `CONTRACT.VALIDATION_FAILED` and `execution.mutations.defaults[0].ref.entry must be a string`; after the rewrite it prints `No changes detected` and writes no migration. In a project with extensions it also re-pins their files under `migrations/<space-id>/`, as every `migration plan` does. `prisma db migrate --to <hash>` does not confirm it: it applies migrations, and on a database already past that snapshot it has no route back, so it fails either way. `prisma migration check` and `prisma db verify` never validate an app snapshot's `execution` section, so they pass before and after the rewrite.
129
+ 3. Code that reads the section directly changes `.ref.table` to `.ref.entry` and `.ref.column` to `.ref.field`.
130
+
131
+ `executionHash` changes for every contract with generated defaults, because the canonical JSON changes. Nothing compares it against the database, so no migration or re-sign is needed.
132
+
133
+ ## `ts-defaults-encoded-by-codec`
134
+
135
+ A TypeScript contract used to store the value passed to `.default(value)` as it stood. The column's codec now encodes it, so the value must be the codec's input type. For a field built inside the `defineContract` factory, `.default()` is typed with that input type, so a wrong value is a type error in `contract.ts`. PSL contracts, `.default(now())`, `.default(autoincrement())` and `` .default(sql`...`) `` are not affected.
136
+
137
+ What now fails, on Postgres:
138
+
139
+ ```typescript
140
+ // before: emitted, although the codec of field.dateTime() holds a Temporal.Instant
141
+ createdAt: field.dateTime().default('2024-01-01T00:00:00Z'),
142
+ ```
143
+
144
+ ```text
145
+ CONTRACT.DEFAULT_INVALID: Field "Event.createdAt" has a default that its codec refuses: Codec 'pg/timestamptz-temporal@1' encodes a Temporal.Instant, but received a string.
146
+ ```
147
+
148
+ 1. Search your contract files for `.default(` with a literal argument.
149
+ 2. Type-check the contract file, then run `prisma contract emit`. TypeScript reports a default of the wrong type; the emit reports each default the codec refuses, with its model and field.
150
+ 3. For each one, either pass the codec's type or change the preset:
151
+
152
+ | You have | Write |
153
+ | --- | --- |
154
+ | an ISO 8601 string | `field.temporal.timestamptzString().default('2024-01-01T00:00:00Z')` |
155
+ | a JavaScript `Date` | `field.temporal.timestamptzJsDate().default(new Date('2024-01-01T00:00:00Z'))` |
156
+ | a `Temporal.Instant` | `field.dateTime().default(Temporal.Instant.from('2024-01-01T00:00:00Z'))` |
157
+
158
+ Changing the preset changes the column's codec, and so the type your queries read and write for that field. On Postgres, `field.bigint()` takes a `bigint` and `field.bytes()` takes a `Uint8Array`. On SQLite, `field.temporal.datetime()` takes a `Date`, `field.column(bigintColumn)` takes a `bigint` and `field.column(blobColumn)` takes a `Uint8Array`.
159
+
160
+ On Node 24 there is no global `Temporal`. A contract file that creates a `Temporal` value must load an implementation itself, for example with `import 'temporal-polyfill/full/global'` as its first import. The type check on a `Temporal` field needs the `Temporal` type declarations in the project, for example from `temporal-polyfill/global`; without them the parameter is unchecked. The error shown above is the one you get with an implementation loaded; without one, the codec reports that the runtime has no global `Temporal` implementation.
161
+
162
+ `.default(null)` used to store `null`. It is now a type error on a field whose codec input type does not include `null`, which is every built-in codec except the JSON codecs: `field.json().optional().default(null)` still compiles and stores `null`. When the contract is built, the codec receives the `null`: a codec that checks its input, such as `pg/int8@1`, refuses it with `CONTRACT.DEFAULT_INVALID`, and a codec that passes any value through, such as `pg/text@1`, still stores `null`. A column without a default already defaults to `NULL` in the database, so remove the call.
163
+
164
+ A JavaScript `number` on a `bigint` field (codec `pg/int8@1`), such as `field.bigint().default(1)` inside the `defineContract` factory, is now a type error. Write a `bigint` literal: `field.bigint().default(1n)`. The default is stored as `"1"`, as the table below shows.
165
+
166
+ A default that gets past the type check, for example from an untyped caller, is stored in a different form than before:
167
+
168
+ | Default | Stored before | Stored now |
169
+ | --- | --- | --- |
170
+ | `field.bigint().default(1)` (also SQLite `bigintColumn`) | `1` | `"1"` |
171
+ | `field.bytes().default('x')` | `"x"` | `"eA=="` (base64) |
172
+ | SQLite `blobColumn` with `.default('x')` | `"x"` | `"78"` (hex) |
173
+
174
+ A contract with such a default emits a different `contract.json` and a different storage hash. Re-emit the contract and review the diff of `contract.json`.
175
+
176
+ A literal default on a column whose codec no pack in the contract declares now fails with `CONTRACT.DEFAULT_INVALID`, because nothing can check it. List the pack that owns the codec in the `extensions` of `defineContract`.
177
+
178
+ ## `contract-format-formats-prisma7-schema`
179
+
180
+ A project whose `contract` is `prisma7Schema('./prisma/schema.prisma')` used to be skipped by `prisma contract format`. The Prisma 7 source is now a PSL source, so the command formats that file with the Prisma 8 formatter when it parses, and refuses with `PSL.PARSE_FAILED`, without writing, when it does not (for example, a schema with a model whose closing brace is missing). A schema with a `view` block parses, so the command formats it.
181
+
182
+ If the Prisma 7 schema must keep Prisma 7's own formatting, do not run `prisma contract format` on it; format it with Prisma 7's `prisma format` instead.
183
+
184
+ ## `config-contract-source-requires-format`
185
+
186
+ A config that builds `contract.source` itself, as an object with a `load` function, must now give it a `format`: `'psl'` when its inputs are PSL text, and `'typescript'` when it builds the contract in TypeScript, for example `source: { format: 'typescript', load: async () => ok(contract) }`. Without it, or with any other value, every command that reads the config fails with `CONFIG.VALIDATION_FAILED` on the field `contract.source.format`. Sources made by `defineConfig`, `prisma7Schema()`, `prismaContract()` and the TypeScript contract helpers already declare one.
187
+
188
+ ## `policy-expression-json-escapes`
189
+
190
+ A `using` or `withCheck` expression in a `policy_*` block of a PSL contract is a JSON string, the form `prisma contract print` and `prisma contract infer` write. The reader used to decode only `\n`, `\r`, `\"` and `\\`, and kept every other backslash sequence as written. It now also decodes `\t`, `\b`, `\f`, `\/` and `\uXXXX`, so `"a\tb"` reads as `a`, a tab and `b`. A backslash sequence that is not a JSON escape, such as `\d`, is still kept as written.
191
+
192
+ If a PSL contract writes one of those five sequences in a policy expression and means the backslash and the letter, write the backslash twice (`\\t`), then run `prisma contract emit`. Otherwise the emitted policy, and the contract's storage hash, change.
193
+
194
+ ## `cursor-rejects-expression-orders`
195
+
196
+ `db.orm.<ns>.<Model>....cursor(...)` builds its keyset from plain model columns. It throws `ORM.ARGUMENT_INVALID`, naming the 1-based `orderBy` position, when an active order is any of these:
197
+
198
+ - an extension-operation result, such as `(p) => p.embedding.cosineDistance(v).asc()` or `(m) => m.text.fullTextRank(q).desc()`;
199
+ - a relation field, such as `(p) => p.author.name.asc()`;
200
+ - a relation count, such as `(u) => u.posts.count().desc()`;
201
+ - an order with null placement, such as `(p) => p.title.asc({ nulls: 'last' })`.
202
+
203
+ The check runs when `cursor()` is called and again when the query is planned, so an order added after `cursor()` is refused too. Before this change an extension-operation order was left out of the keyset without an error, which returned wrong pages.
204
+
205
+ For each `.cursor(` call on a `db.orm` chain that also calls `.orderBy(`, look at every `orderBy` lambda in the chain. If any of them is one of the orders above, do one of these:
206
+
207
+ - Paginate with `.limit(n).offset(n)` and remove `.cursor(...)`:
208
+
209
+ ```ts
210
+ const page = await db.orm.public.Post
211
+ .orderBy((p) => p.embedding.cosineDistance(v).asc())
212
+ .limit(20)
213
+ .offset(pageIndex * 20)
214
+ .all();
215
+ ```
216
+
217
+ - Keep the cursor and order by plain columns only, for example `(p) => p.createdAt.desc()` and `(p) => p.id.desc()`.
218
+
219
+ `distinctOn()` throws the same error when one of the first N orders, where N is the number of `distinctOn` columns, is not a plain column: Postgres needs those leading orders to match the `DISTINCT ON` columns, so such a query already failed in the database; it now fails earlier, with `ORM.ARGUMENT_INVALID`. Put the `distinctOn` columns first; a relation order, a count or an operation result may follow them. For example, `.orderBy([(post) => post.title.asc(), (post) => post.author.name.asc()]).distinctOn('title')` is accepted.
220
+
221
+ ## `mongo-codec-subpaths-move-to-target`
222
+
223
+ The Mongo target package owns the codecs now. Rewrite each specifier, in every file that names it (source, emitted `contract.d.ts`, the `contract.d.ts` in each `migrations/snapshots/<hash>/` directory, and docs):
224
+
225
+ | Before | After |
226
+ | --- | --- |
227
+ | `@prisma/orm-mongo/adapter/codec-types` | `@prisma/orm-mongo/target/codec-types` |
228
+ | `@prisma/orm-mongo/adapter/codecs` | `@prisma/orm-mongo/target/codecs` |
229
+ | `@prisma/orm-mongo/adapter/codec-ids` | `@prisma/orm-mongo/target/codec-ids` |
230
+ | `@prisma/orm-mongo/adapter/data-types` | `@prisma/orm-mongo/target/data-types` |
231
+ | `@prisma/orm-target-mongo/adapter/<same four>` | `@prisma/orm-target-mongo/target/<same four>` |
232
+
233
+ The exported names are unchanged. For the application's own `contract.d.ts`, running `prisma contract emit` produces the same result as the rewrite. Snapshot `contract.d.ts` files under `migrations/snapshots/` are not re-emitted, so rewrite them. The contract JSON and every hash stay the same.
234
+
235
+ Do not rely on `tsc` to find the `contract.d.ts` files. They are declaration files, and a project with `skipLibCheck: true` (the `tsconfig.json` that `prisma orm init` writes sets it) gets no error for their stale import. Instead the contract's field types stop resolving to the codec types, so type errors appear where the contract is used, such as a seed script or a query, rather than at the import, and some fields are no longer type-checked. Rewrite or re-emit every file the detection finds, whether or not `tsc` complains.
236
+
237
+ ## `create-mongo-runner-deps-removed`
238
+
239
+ ```ts
240
+ // before
241
+ import { createMongoRunnerDeps, extractDb } from '@prisma/orm-mongo/adapter/control';
242
+ import { MongoDriverImpl } from '@prisma/orm-mongo/driver';
243
+ const runner = new MongoMigrationRunner(
244
+ createMongoRunnerDeps(controlDriver, MongoDriverImpl.fromDb(extractDb(controlDriver)), family),
245
+ );
246
+
247
+ // after
248
+ import { MongoControlAdapterImpl } from '@prisma/orm-mongo/adapter/control';
249
+ const runner = new MongoMigrationRunner(
250
+ new MongoControlAdapterImpl().createRunnerDependencies(controlDriver),
251
+ );
252
+ ```
253
+
254
+ Drop imports that are now unused (`extractDb`, `MongoDriverImpl`, `createMongoFamilyInstance`) and any family instance built only to pass as the third argument.
255
+
256
+ ## `mongo-runner-dependency-types-move-to-family`
257
+
258
+ Change the import of `MongoRunnerDependencies` or `MarkerOperations` to `@prisma/orm-mongo/family/control-adapter`. The shapes are unchanged.
259
+
260
+ ## `mongo-create-runner-needs-adapter-on-stack`
261
+
262
+ Build the family instance from a control stack that includes the Mongo adapter:
263
+
264
+ ```ts
265
+ import mongoAdapter from '@prisma/orm-mongo/adapter/control';
266
+ import { createMongoFamilyInstance, mongoFamilyDescriptor } from '@prisma/orm-mongo/family/control';
267
+ import { createControlStack } from '@prisma/orm-mongo/components/control';
268
+ import { mongoTargetDescriptor } from '@prisma/orm-mongo/target/control';
269
+
270
+ const family = createMongoFamilyInstance(
271
+ createControlStack({ family: mongoFamilyDescriptor, target: mongoTargetDescriptor, adapter: mongoAdapter }),
272
+ );
273
+ ```
274
+
275
+ Code that goes through the CLI or `defineConfig` already has the adapter on the stack and needs no change.
276
+
277
+ ## `mongo-psl-scalar-names`
278
+
279
+ `Int`, `Float`, `Boolean` and `DateTime` are deprecated in Mongo schemas. They are still accepted, and they produce the same contract as the new names, but `prisma contract emit` and the language server report a `PSL_DEPRECATED_SCALAR_NAME` warning for each use, and a later release removes them. Rename them now.
280
+
281
+ Apply this only to the Prisma 8 Mongo contract source, the `.prisma` file that `prisma.config.ts` passes to `defineConfig` from `@prisma/orm-mongo/config`, and to its copies under `migrations/app/<migration>/contract.prisma`. The detection pattern also matches Postgres and SQLite schemas, whose scalar names do not change in this release; leave them alone.
282
+
283
+ Never rename in a Prisma 6 `schema.prisma`, such as one kept beside the Prisma 8 contract in a project that still runs Prisma 6: Prisma 6 has no `Int32`, `Double`, `Bool` or `Date`, and would reject the schema. The detection skips a file that declares `provider = "mongodb"`, which every Prisma 6 MongoDB schema does, but a multi-file Prisma 6 schema declares it in one file only, so also skip the other `.prisma` files of a Prisma 6 schema directory.
284
+
285
+ In each field whose type is one of the deprecated names, replace the type name, keeping any `[]` and `?`:
286
+
287
+ | Deprecated | Use | Stored as |
288
+ | --- | --- | --- |
289
+ | `Int` | `Int32` | BSON int |
290
+ | `Float` | `Double` | BSON double |
291
+ | `Boolean` | `Bool` | BSON bool |
292
+ | `DateTime` | `Date` | BSON date |
293
+
294
+ ```prisma
295
+ // before
296
+ model Post {
297
+ id ObjectId @id @map("_id")
298
+ views Int
299
+ rating Float?
300
+ published Boolean
301
+ createdAt DateTime
302
+ tags Int[]
303
+ }
304
+
305
+ // after
306
+ model Post {
307
+ id ObjectId @id @map("_id")
308
+ views Int32
309
+ rating Double?
310
+ published Bool
311
+ createdAt Date
312
+ tags Int32[]
313
+ }
314
+ ```
315
+
316
+ This includes the `contract.prisma` copies under `migrations/app/<migration>/`. Then run `prisma contract emit`: `contract.json` and `contract.d.ts` come out the same as before, so no migration or `db sign` is needed. Until the rename, each use reports `warning <file>:<line>:<column> PSL_DEPRECATED_SCALAR_NAME Scalar type "Int" is deprecated and will be removed; use "Int32" (stored as BSON int).`
317
+
318
+ Docs: list only `Int32`, `Double`, `Bool`, `Date`; the old names must not appear in the scalar tables.
319
+
320
+ ## `mongo-variant-field-codecs`
321
+
322
+ This change has no detection pattern: it applies to every model with `@@base` whose own `ObjectId` fields are written or read through `.variant(...)`.
323
+
324
+ Before, a field declared only on a variant model (`model Photo { ownerId ObjectId @@base(Asset, "photo") }`) was passed to the driver as the application wrote it and returned as the driver read it. An `ObjectId` field written as a hex string was refused by the collection validator when the contract was written in Prisma 8 PSL; a contract built with the TypeScript builder has no validator, so there the hex string was stored as a string. A stored `ObjectId` came back as the driver's `ObjectId` class instead of a hex string. A where filter on such a field passed its value unencoded, so a hex string matched nothing where an `ObjectId` was stored; it is now encoded and matches.
325
+
326
+ 1. Remove any workaround that converted such values by hand, for example passing `new ObjectId(hex)` for a variant `ObjectId` field or calling `.toHexString()` on what a read returned; pass and expect hex strings, as for any other `ObjectId` field.
327
+ 2. Documents written before this change through a TypeScript-builder contract may hold a variant `ObjectId` field as a string; a filter with a hex string now looks for an `ObjectId` and does not match them. Convert the ones that are 24-character hex strings with `db.<collection>.updateMany({ <field>: { $type: 'string', $regex: /^[0-9a-fA-F]{24}$/ } }, [{ $set: { <field>: { $toObjectId: '$<field>' } } }])`. The regex matters: without it, one string that is not an `ObjectId` in hex makes `$toObjectId` fail the whole command. Other strings, `ObjectId` values and documents without the field are left as they are.
328
+ 3. A read through the base collection (without `.variant(...)`) still returns variant-only fields as the driver read them.
329
+
330
+ ## `contract-artifacts-restamp`
331
+
332
+ For every `contract.json` matched by `detection`, run the project's emit command (`prisma contract emit`, or the project's `contract:emit` script) once after upgrading. This entry accounts for the embedded `version` moving to `8.0.0-rc.13`; any other difference in the emitted files comes from an earlier entry in this guide.