primitive-admin 1.2.0-alpha.9 → 1.3.0-alpha.1

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 (590) hide show
  1. package/README.md +303 -186
  2. package/assets/skill/skills/primitive-platform/SKILL.md +93 -27
  3. package/dist/bin/primitive.js +15 -89
  4. package/dist/bin/primitive.js.map +1 -1
  5. package/dist/src/commands/admins.js +80 -17
  6. package/dist/src/commands/admins.js.map +1 -1
  7. package/dist/src/commands/agent-sessions.d.ts +129 -0
  8. package/dist/src/commands/agent-sessions.js +532 -20
  9. package/dist/src/commands/agent-sessions.js.map +1 -1
  10. package/dist/src/commands/analytics.js +207 -155
  11. package/dist/src/commands/analytics.js.map +1 -1
  12. package/dist/src/commands/apps-children.js +3 -0
  13. package/dist/src/commands/apps-children.js.map +1 -1
  14. package/dist/src/commands/apps-transitions.d.ts +39 -0
  15. package/dist/src/commands/apps-transitions.js +198 -0
  16. package/dist/src/commands/apps-transitions.js.map +1 -0
  17. package/dist/src/commands/apps.d.ts +17 -0
  18. package/dist/src/commands/apps.js +108 -3
  19. package/dist/src/commands/apps.js.map +1 -1
  20. package/dist/src/commands/auth-sessions.js +2 -0
  21. package/dist/src/commands/auth-sessions.js.map +1 -1
  22. package/dist/src/commands/auth.js +170 -50
  23. package/dist/src/commands/auth.js.map +1 -1
  24. package/dist/src/commands/blob-buckets.js +2 -0
  25. package/dist/src/commands/blob-buckets.js.map +1 -1
  26. package/dist/src/commands/collections.js +318 -256
  27. package/dist/src/commands/collections.js.map +1 -1
  28. package/dist/src/commands/comparisons.js +2 -0
  29. package/dist/src/commands/comparisons.js.map +1 -1
  30. package/dist/src/commands/config.d.ts +2 -2
  31. package/dist/src/commands/config.js +59 -33
  32. package/dist/src/commands/config.js.map +1 -1
  33. package/dist/src/commands/connections.js +2 -0
  34. package/dist/src/commands/connections.js.map +1 -1
  35. package/dist/src/commands/database-type-configs.js +5 -3
  36. package/dist/src/commands/database-type-configs.js.map +1 -1
  37. package/dist/src/commands/databases.js +6 -4
  38. package/dist/src/commands/databases.js.map +1 -1
  39. package/dist/src/commands/db3-types.d.ts +42 -0
  40. package/dist/src/commands/db3-types.js +445 -0
  41. package/dist/src/commands/db3-types.js.map +1 -0
  42. package/dist/src/commands/db3.d.ts +38 -0
  43. package/dist/src/commands/db3.js +2053 -0
  44. package/dist/src/commands/db3.js.map +1 -0
  45. package/dist/src/commands/documents.d.ts +110 -10
  46. package/dist/src/commands/documents.js +1019 -748
  47. package/dist/src/commands/documents.js.map +1 -1
  48. package/dist/src/commands/email-templates.js +74 -0
  49. package/dist/src/commands/email-templates.js.map +1 -1
  50. package/dist/src/commands/env.js +8 -4
  51. package/dist/src/commands/env.js.map +1 -1
  52. package/dist/src/commands/function-trigger-commands.d.ts +28 -0
  53. package/dist/src/commands/function-trigger-commands.js +341 -0
  54. package/dist/src/commands/function-trigger-commands.js.map +1 -0
  55. package/dist/src/commands/functions.js +383 -32
  56. package/dist/src/commands/functions.js.map +1 -1
  57. package/dist/src/commands/groups.js +168 -50
  58. package/dist/src/commands/groups.js.map +1 -1
  59. package/dist/src/commands/guides.js +7 -5
  60. package/dist/src/commands/guides.js.map +1 -1
  61. package/dist/src/commands/hosting.d.ts +8 -0
  62. package/dist/src/commands/hosting.js +509 -0
  63. package/dist/src/commands/hosting.js.map +1 -0
  64. package/dist/src/commands/init.js +129 -38
  65. package/dist/src/commands/init.js.map +1 -1
  66. package/dist/src/commands/integrations.js +82 -53
  67. package/dist/src/commands/integrations.js.map +1 -1
  68. package/dist/src/commands/locks.d.ts +5 -3
  69. package/dist/src/commands/locks.js +19 -61
  70. package/dist/src/commands/locks.js.map +1 -1
  71. package/dist/src/commands/metadata-category-configs.d.ts +2 -2
  72. package/dist/src/commands/metadata-category-configs.js +4 -2
  73. package/dist/src/commands/metadata-category-configs.js.map +1 -1
  74. package/dist/src/commands/metadata.js +55 -6
  75. package/dist/src/commands/metadata.js.map +1 -1
  76. package/dist/src/commands/prompts.js +75 -52
  77. package/dist/src/commands/prompts.js.map +1 -1
  78. package/dist/src/commands/rate-counters.d.ts +19 -0
  79. package/dist/src/commands/rate-counters.js +104 -0
  80. package/dist/src/commands/rate-counters.js.map +1 -0
  81. package/dist/src/commands/rule-sets.d.ts +1 -1
  82. package/dist/src/commands/rule-sets.js +2 -1
  83. package/dist/src/commands/rule-sets.js.map +1 -1
  84. package/dist/src/commands/schemas.d.ts +15 -0
  85. package/dist/src/commands/schemas.js +122 -0
  86. package/dist/src/commands/schemas.js.map +1 -0
  87. package/dist/src/commands/scripts.d.ts +9 -17
  88. package/dist/src/commands/scripts.js +24 -479
  89. package/dist/src/commands/scripts.js.map +1 -1
  90. package/dist/src/commands/secrets.d.ts +38 -0
  91. package/dist/src/commands/secrets.js +148 -6
  92. package/dist/src/commands/secrets.js.map +1 -1
  93. package/dist/src/commands/sessions.js +2 -0
  94. package/dist/src/commands/sessions.js.map +1 -1
  95. package/dist/src/commands/skill.js +2 -0
  96. package/dist/src/commands/skill.js.map +1 -1
  97. package/dist/src/commands/spent-tokens.d.ts +19 -0
  98. package/dist/src/commands/spent-tokens.js +79 -0
  99. package/dist/src/commands/spent-tokens.js.map +1 -0
  100. package/dist/src/commands/sync-app-settings.d.ts +58 -0
  101. package/dist/src/commands/sync-app-settings.js +119 -2
  102. package/dist/src/commands/sync-app-settings.js.map +1 -1
  103. package/dist/src/commands/sync-schemas.d.ts +202 -0
  104. package/dist/src/commands/sync-schemas.js +629 -0
  105. package/dist/src/commands/sync-schemas.js.map +1 -0
  106. package/dist/src/commands/sync-user-properties.d.ts +118 -0
  107. package/dist/src/commands/sync-user-properties.js +276 -0
  108. package/dist/src/commands/sync-user-properties.js.map +1 -0
  109. package/dist/src/commands/sync.d.ts +578 -546
  110. package/dist/src/commands/sync.js +3516 -5134
  111. package/dist/src/commands/sync.js.map +1 -1
  112. package/dist/src/commands/tokens.js +5 -3
  113. package/dist/src/commands/tokens.js.map +1 -1
  114. package/dist/src/commands/transitions.d.ts +54 -0
  115. package/dist/src/commands/transitions.js +418 -0
  116. package/dist/src/commands/transitions.js.map +1 -0
  117. package/dist/src/commands/usage.d.ts +42 -0
  118. package/dist/src/commands/usage.js +397 -0
  119. package/dist/src/commands/usage.js.map +1 -0
  120. package/dist/src/commands/user-properties.d.ts +14 -0
  121. package/dist/src/commands/user-properties.js +79 -0
  122. package/dist/src/commands/user-properties.js.map +1 -0
  123. package/dist/src/commands/users.js +951 -18
  124. package/dist/src/commands/users.js.map +1 -1
  125. package/dist/src/commands/vars.js +2 -0
  126. package/dist/src/commands/vars.js.map +1 -1
  127. package/dist/src/commands/waitlist.js +39 -4
  128. package/dist/src/commands/waitlist.js.map +1 -1
  129. package/dist/src/commands/workflows.d.ts +5 -83
  130. package/dist/src/commands/workflows.js +57 -2282
  131. package/dist/src/commands/workflows.js.map +1 -1
  132. package/dist/src/lib/analytics-query.d.ts +58 -0
  133. package/dist/src/lib/analytics-query.js +134 -0
  134. package/dist/src/lib/analytics-query.js.map +1 -0
  135. package/dist/src/lib/api-client.d.ts +1976 -431
  136. package/dist/src/lib/api-client.js +1095 -550
  137. package/dist/src/lib/api-client.js.map +1 -1
  138. package/dist/src/lib/app-settings-descriptor.d.ts +14 -2
  139. package/dist/src/lib/app-settings-descriptor.js +55 -1
  140. package/dist/src/lib/app-settings-descriptor.js.map +1 -1
  141. package/dist/src/lib/auth-fixtures.d.ts +44 -0
  142. package/dist/src/lib/auth-fixtures.js +61 -0
  143. package/dist/src/lib/auth-fixtures.js.map +1 -0
  144. package/dist/src/lib/auth-flow.d.ts +47 -1
  145. package/dist/src/lib/auth-flow.js +451 -14
  146. package/dist/src/lib/auth-flow.js.map +1 -1
  147. package/dist/src/lib/block-layout.d.ts +12 -23
  148. package/dist/src/lib/block-layout.js +26 -92
  149. package/dist/src/lib/block-layout.js.map +1 -1
  150. package/dist/src/lib/block-selector.d.ts +8 -14
  151. package/dist/src/lib/block-selector.js +8 -19
  152. package/dist/src/lib/block-selector.js.map +1 -1
  153. package/dist/src/lib/child-apps-local.d.ts +3 -1
  154. package/dist/src/lib/child-apps-local.js +9 -1
  155. package/dist/src/lib/child-apps-local.js.map +1 -1
  156. package/dist/src/lib/cli-manifest.d.ts +9 -0
  157. package/dist/src/lib/cli-manifest.js +10 -1
  158. package/dist/src/lib/cli-manifest.js.map +1 -1
  159. package/dist/src/lib/cli-version.d.ts +14 -0
  160. package/dist/src/lib/cli-version.js +38 -0
  161. package/dist/src/lib/cli-version.js.map +1 -0
  162. package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
  163. package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
  164. package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
  165. package/dist/src/lib/collection-export.d.ts +76 -15
  166. package/dist/src/lib/collection-export.js +116 -23
  167. package/dist/src/lib/collection-export.js.map +1 -1
  168. package/dist/src/lib/collection-principal.d.ts +22 -0
  169. package/dist/src/lib/collection-principal.js +35 -0
  170. package/dist/src/lib/collection-principal.js.map +1 -0
  171. package/dist/src/lib/command-groups.d.ts +30 -0
  172. package/dist/src/lib/command-groups.js +111 -0
  173. package/dist/src/lib/command-groups.js.map +1 -0
  174. package/dist/src/lib/command-status.d.ts +147 -0
  175. package/dist/src/lib/command-status.js +266 -0
  176. package/dist/src/lib/command-status.js.map +1 -0
  177. package/dist/src/lib/config-object-descriptor.d.ts +9 -22
  178. package/dist/src/lib/config-object-descriptor.js +113 -277
  179. package/dist/src/lib/config-object-descriptor.js.map +1 -1
  180. package/dist/src/lib/config-surface.d.ts +3 -7
  181. package/dist/src/lib/config-surface.js +9 -13
  182. package/dist/src/lib/config-surface.js.map +1 -1
  183. package/dist/src/lib/config-toml.d.ts +11 -2
  184. package/dist/src/lib/config-toml.js +25 -2
  185. package/dist/src/lib/config-toml.js.map +1 -1
  186. package/dist/src/lib/credentials-home.d.ts +7 -0
  187. package/dist/src/lib/credentials-home.js +45 -10
  188. package/dist/src/lib/credentials-home.js.map +1 -1
  189. package/dist/src/lib/credentials-lock.d.ts +14 -6
  190. package/dist/src/lib/credentials-lock.js +90 -10
  191. package/dist/src/lib/credentials-lock.js.map +1 -1
  192. package/dist/src/lib/credentials-store.d.ts +142 -70
  193. package/dist/src/lib/credentials-store.js +420 -111
  194. package/dist/src/lib/credentials-store.js.map +1 -1
  195. package/dist/src/lib/custodian.d.ts +8 -0
  196. package/dist/src/lib/custodian.js +18 -0
  197. package/dist/src/lib/custodian.js.map +1 -0
  198. package/dist/src/lib/data-input.d.ts +1 -1
  199. package/dist/src/lib/data-input.js +1 -1
  200. package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
  201. package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
  202. package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
  203. package/dist/src/lib/db-codegen/dbTypeIR.d.ts +40 -1
  204. package/dist/src/lib/db-codegen/dbTypeIR.js +32 -8
  205. package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
  206. package/dist/src/lib/db-type-records.d.ts +125 -0
  207. package/dist/src/lib/db-type-records.js +237 -0
  208. package/dist/src/lib/db-type-records.js.map +1 -0
  209. package/dist/src/lib/db3-export.d.ts +322 -0
  210. package/dist/src/lib/db3-export.js +767 -0
  211. package/dist/src/lib/db3-export.js.map +1 -0
  212. package/dist/src/lib/db3-index-output.d.ts +116 -0
  213. package/dist/src/lib/db3-index-output.js +223 -0
  214. package/dist/src/lib/db3-index-output.js.map +1 -0
  215. package/dist/src/lib/db3-json-fields.d.ts +49 -0
  216. package/dist/src/lib/db3-json-fields.js +195 -0
  217. package/dist/src/lib/db3-json-fields.js.map +1 -0
  218. package/dist/src/lib/db3-type-archive.d.ts +59 -0
  219. package/dist/src/lib/db3-type-archive.js +95 -0
  220. package/dist/src/lib/db3-type-archive.js.map +1 -0
  221. package/dist/src/lib/db3-type-models.d.ts +148 -0
  222. package/dist/src/lib/db3-type-models.js +583 -0
  223. package/dist/src/lib/db3-type-models.js.map +1 -0
  224. package/dist/src/lib/deprecation.d.ts +2 -2
  225. package/dist/src/lib/deprecation.js +2 -2
  226. package/dist/src/lib/document-export-record-log.d.ts +7 -0
  227. package/dist/src/lib/document-export-record-log.js +9 -0
  228. package/dist/src/lib/document-export-record-log.js.map +1 -1
  229. package/dist/src/lib/document-ingest-artifact.d.ts +19 -0
  230. package/dist/src/lib/document-ingest-artifact.js +55 -6
  231. package/dist/src/lib/document-ingest-artifact.js.map +1 -1
  232. package/dist/src/lib/document-ingest-format2.d.ts +36 -0
  233. package/dist/src/lib/document-ingest-format2.js +78 -0
  234. package/dist/src/lib/document-ingest-format2.js.map +1 -0
  235. package/dist/src/lib/document-ingest-input.d.ts +9 -0
  236. package/dist/src/lib/document-ingest-input.js +28 -1
  237. package/dist/src/lib/document-ingest-input.js.map +1 -1
  238. package/dist/src/lib/document-ingest.d.ts +11 -1
  239. package/dist/src/lib/document-ingest.js +16 -0
  240. package/dist/src/lib/document-ingest.js.map +1 -1
  241. package/dist/src/lib/document-schema-rows.d.ts +42 -0
  242. package/dist/src/lib/document-schema-rows.js +53 -0
  243. package/dist/src/lib/document-schema-rows.js.map +1 -0
  244. package/dist/src/lib/experimental-apis.d.ts +36 -0
  245. package/dist/src/lib/experimental-apis.js +46 -0
  246. package/dist/src/lib/experimental-apis.js.map +1 -0
  247. package/dist/src/lib/file-attachment.d.ts +24 -0
  248. package/dist/src/lib/file-attachment.js +31 -0
  249. package/dist/src/lib/file-attachment.js.map +1 -0
  250. package/dist/src/lib/function-authorize-check.d.ts +142 -0
  251. package/dist/src/lib/function-authorize-check.js +311 -0
  252. package/dist/src/lib/function-authorize-check.js.map +1 -0
  253. package/dist/src/lib/function-authorize-view.d.ts +36 -0
  254. package/dist/src/lib/function-authorize-view.js +110 -0
  255. package/dist/src/lib/function-authorize-view.js.map +1 -0
  256. package/dist/src/lib/function-bundle.d.ts +27 -5
  257. package/dist/src/lib/function-bundle.js +142 -7
  258. package/dist/src/lib/function-bundle.js.map +1 -1
  259. package/dist/src/lib/function-collect.d.ts +112 -12
  260. package/dist/src/lib/function-collect.js +601 -12
  261. package/dist/src/lib/function-collect.js.map +1 -1
  262. package/dist/src/lib/function-db-types.d.ts +65 -11
  263. package/dist/src/lib/function-db-types.js +326 -157
  264. package/dist/src/lib/function-db-types.js.map +1 -1
  265. package/dist/src/lib/function-document-types.d.ts +19 -7
  266. package/dist/src/lib/function-document-types.js +24 -12
  267. package/dist/src/lib/function-document-types.js.map +1 -1
  268. package/dist/src/lib/function-grants-preflight.d.ts +99 -0
  269. package/dist/src/lib/function-grants-preflight.js +154 -2
  270. package/dist/src/lib/function-grants-preflight.js.map +1 -1
  271. package/dist/src/lib/function-lint.d.ts +85 -0
  272. package/dist/src/lib/function-lint.js +442 -0
  273. package/dist/src/lib/function-lint.js.map +1 -0
  274. package/dist/src/lib/function-log-row.js +21 -2
  275. package/dist/src/lib/function-log-row.js.map +1 -1
  276. package/dist/src/lib/function-run.d.ts +13 -21
  277. package/dist/src/lib/function-run.js +14 -27
  278. package/dist/src/lib/function-run.js.map +1 -1
  279. package/dist/src/lib/function-schema-codegen.d.ts +86 -22
  280. package/dist/src/lib/function-schema-codegen.js +194 -88
  281. package/dist/src/lib/function-schema-codegen.js.map +1 -1
  282. package/dist/src/lib/function-schema-refs.d.ts +98 -0
  283. package/dist/src/lib/function-schema-refs.js +177 -0
  284. package/dist/src/lib/function-schema-refs.js.map +1 -0
  285. package/dist/src/lib/function-sync.d.ts +120 -6
  286. package/dist/src/lib/function-sync.js +217 -26
  287. package/dist/src/lib/function-sync.js.map +1 -1
  288. package/dist/src/lib/function-trigger-listing.d.ts +11 -6
  289. package/dist/src/lib/function-trigger-listing.js +32 -11
  290. package/dist/src/lib/function-trigger-listing.js.map +1 -1
  291. package/dist/src/lib/function-typecheck.d.ts +52 -0
  292. package/dist/src/lib/function-typecheck.js +174 -54
  293. package/dist/src/lib/function-typecheck.js.map +1 -1
  294. package/dist/src/lib/function-versions.d.ts +2 -0
  295. package/dist/src/lib/function-versions.js +1 -0
  296. package/dist/src/lib/function-versions.js.map +1 -1
  297. package/dist/src/lib/generated-build-flags.d.ts +13 -0
  298. package/dist/src/lib/generated-build-flags.js +14 -0
  299. package/dist/src/lib/generated-build-flags.js.map +1 -0
  300. package/dist/src/lib/generated-command-status.d.ts +6 -0
  301. package/dist/src/lib/generated-command-status.js +502 -0
  302. package/dist/src/lib/generated-command-status.js.map +1 -0
  303. package/dist/src/lib/generated-config-surfaces.d.ts +804 -140
  304. package/dist/src/lib/generated-config-surfaces.js +2491 -1806
  305. package/dist/src/lib/generated-config-surfaces.js.map +1 -1
  306. package/dist/src/lib/generated-sdk-types.d.ts +1 -1
  307. package/dist/src/lib/generated-sdk-types.js +1 -1
  308. package/dist/src/lib/generated-sdk-types.js.map +1 -1
  309. package/dist/src/lib/hosting-build.d.ts +97 -0
  310. package/dist/src/lib/hosting-build.js +204 -0
  311. package/dist/src/lib/hosting-build.js.map +1 -0
  312. package/dist/src/lib/hosting-client.d.ts +167 -0
  313. package/dist/src/lib/hosting-client.js +340 -0
  314. package/dist/src/lib/hosting-client.js.map +1 -0
  315. package/dist/src/lib/hosting-environments.d.ts +32 -0
  316. package/dist/src/lib/hosting-environments.js +74 -0
  317. package/dist/src/lib/hosting-environments.js.map +1 -0
  318. package/dist/src/lib/hosting-errors.d.ts +30 -0
  319. package/dist/src/lib/hosting-errors.js +43 -0
  320. package/dist/src/lib/hosting-errors.js.map +1 -0
  321. package/dist/src/lib/hosting-token.d.ts +46 -0
  322. package/dist/src/lib/hosting-token.js +60 -0
  323. package/dist/src/lib/hosting-token.js.map +1 -0
  324. package/dist/src/lib/hosting-trust-step.d.ts +67 -0
  325. package/dist/src/lib/hosting-trust-step.js +279 -0
  326. package/dist/src/lib/hosting-trust-step.js.map +1 -0
  327. package/dist/src/lib/hosting-trust.d.ts +77 -0
  328. package/dist/src/lib/hosting-trust.js +194 -0
  329. package/dist/src/lib/hosting-trust.js.map +1 -0
  330. package/dist/src/lib/hosting-wait.d.ts +42 -0
  331. package/dist/src/lib/hosting-wait.js +84 -0
  332. package/dist/src/lib/hosting-wait.js.map +1 -0
  333. package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
  334. package/dist/src/lib/hosting-wfp-upload.js +149 -0
  335. package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
  336. package/dist/src/lib/init-assets.d.ts +2 -6
  337. package/dist/src/lib/init-assets.js +11 -27
  338. package/dist/src/lib/init-assets.js.map +1 -1
  339. package/dist/src/lib/init-ios-links.d.ts +11 -7
  340. package/dist/src/lib/init-ios-links.js +28 -22
  341. package/dist/src/lib/init-ios-links.js.map +1 -1
  342. package/dist/src/lib/init-login-note.d.ts +13 -0
  343. package/dist/src/lib/init-login-note.js +22 -0
  344. package/dist/src/lib/init-login-note.js.map +1 -0
  345. package/dist/src/lib/init-schema.d.ts +15 -0
  346. package/dist/src/lib/init-schema.js +54 -0
  347. package/dist/src/lib/init-schema.js.map +1 -1
  348. package/dist/src/lib/integration-test-request.d.ts +54 -0
  349. package/dist/src/lib/integration-test-request.js +207 -0
  350. package/dist/src/lib/integration-test-request.js.map +1 -0
  351. package/dist/src/lib/invoker-shared-enums.d.ts +35 -0
  352. package/dist/src/lib/invoker-shared-enums.js +98 -0
  353. package/dist/src/lib/invoker-shared-enums.js.map +1 -0
  354. package/dist/src/lib/json-value.d.ts +6 -0
  355. package/dist/src/lib/json-value.js +13 -0
  356. package/dist/src/lib/json-value.js.map +1 -0
  357. package/dist/src/lib/load-routes.d.ts +33 -0
  358. package/dist/src/lib/load-routes.js +35 -0
  359. package/dist/src/lib/load-routes.js.map +1 -0
  360. package/dist/src/lib/log-inspection.d.ts +23 -4
  361. package/dist/src/lib/log-inspection.js +14 -5
  362. package/dist/src/lib/log-inspection.js.map +1 -1
  363. package/dist/src/lib/login-exchange-check.d.ts +18 -0
  364. package/dist/src/lib/login-exchange-check.js +27 -0
  365. package/dist/src/lib/login-exchange-check.js.map +1 -0
  366. package/dist/src/lib/login-scope-lines.d.ts +17 -7
  367. package/dist/src/lib/login-scope-lines.js +33 -10
  368. package/dist/src/lib/login-scope-lines.js.map +1 -1
  369. package/dist/src/lib/metadata-report.d.ts +85 -0
  370. package/dist/src/lib/metadata-report.js +81 -0
  371. package/dist/src/lib/metadata-report.js.map +1 -0
  372. package/dist/src/lib/object-status-filter.d.ts +9 -1
  373. package/dist/src/lib/object-status-filter.js +9 -1
  374. package/dist/src/lib/object-status-filter.js.map +1 -1
  375. package/dist/src/lib/output.d.ts +1 -1
  376. package/dist/src/lib/output.js +3 -1
  377. package/dist/src/lib/output.js.map +1 -1
  378. package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
  379. package/dist/src/lib/pin-refusal-hint.js +35 -0
  380. package/dist/src/lib/pin-refusal-hint.js.map +1 -0
  381. package/dist/src/lib/platform-owned.js +5 -0
  382. package/dist/src/lib/platform-owned.js.map +1 -1
  383. package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
  384. package/dist/src/lib/primitive-declaration-names.js +22 -0
  385. package/dist/src/lib/primitive-declaration-names.js.map +1 -0
  386. package/dist/src/lib/primitive-declaration.d.ts +174 -0
  387. package/dist/src/lib/primitive-declaration.js +871 -0
  388. package/dist/src/lib/primitive-declaration.js.map +1 -0
  389. package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
  390. package/dist/src/lib/primitive-env-plugin.js +408 -0
  391. package/dist/src/lib/primitive-env-plugin.js.map +1 -0
  392. package/dist/src/lib/project-login-apps.d.ts +8 -0
  393. package/dist/src/lib/project-login-apps.js +27 -0
  394. package/dist/src/lib/project-login-apps.js.map +1 -0
  395. package/dist/src/lib/prompt-schema-codegen.d.ts +36 -12
  396. package/dist/src/lib/prompt-schema-codegen.js +96 -100
  397. package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
  398. package/dist/src/lib/prompt-schema-document.d.ts +35 -0
  399. package/dist/src/lib/prompt-schema-document.js +92 -0
  400. package/dist/src/lib/prompt-schema-document.js.map +1 -0
  401. package/dist/src/lib/prompt-schema-refs.d.ts +173 -0
  402. package/dist/src/lib/prompt-schema-refs.js +478 -0
  403. package/dist/src/lib/prompt-schema-refs.js.map +1 -0
  404. package/dist/src/lib/records-verbs.d.ts +79 -0
  405. package/dist/src/lib/records-verbs.js +45 -0
  406. package/dist/src/lib/records-verbs.js.map +1 -0
  407. package/dist/src/lib/refresh-admin-credentials.d.ts +34 -4
  408. package/dist/src/lib/refresh-admin-credentials.js +85 -29
  409. package/dist/src/lib/refresh-admin-credentials.js.map +1 -1
  410. package/dist/src/lib/refresh-stored-login.d.ts +85 -0
  411. package/dist/src/lib/refresh-stored-login.js +233 -0
  412. package/dist/src/lib/refresh-stored-login.js.map +1 -0
  413. package/dist/src/lib/register-commands.d.ts +36 -0
  414. package/dist/src/lib/register-commands.js +37 -0
  415. package/dist/src/lib/register-commands.js.map +1 -0
  416. package/dist/src/lib/retired-imports.d.ts +53 -0
  417. package/dist/src/lib/retired-imports.js +120 -0
  418. package/dist/src/lib/retired-imports.js.map +1 -0
  419. package/dist/src/lib/row-field-rename.d.ts +18 -0
  420. package/dist/src/lib/row-field-rename.js +32 -0
  421. package/dist/src/lib/row-field-rename.js.map +1 -0
  422. package/dist/src/lib/run-status.d.ts +1 -1
  423. package/dist/src/lib/run-status.generated.d.ts +2 -2
  424. package/dist/src/lib/run-status.generated.js +3 -1
  425. package/dist/src/lib/run-status.generated.js.map +1 -1
  426. package/dist/src/lib/run-status.js +1 -1
  427. package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
  428. package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
  429. package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
  430. package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
  431. package/dist/src/lib/schema-codegen/generated-db3-bridge.js +227 -0
  432. package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
  433. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
  434. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
  435. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
  436. package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +229 -0
  437. package/dist/src/lib/schema-codegen/generated-field-grammar.js +420 -0
  438. package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
  439. package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
  440. package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
  441. package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
  442. package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
  443. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
  444. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
  445. package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +258 -0
  446. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
  447. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
  448. package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
  449. package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
  450. package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
  451. package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
  452. package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
  453. package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
  454. package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
  455. package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
  456. package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
  457. package/dist/src/lib/schema-codegen/generated-schema-shape.d.ts +27 -0
  458. package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
  459. package/dist/src/lib/schema-codegen/generated-schema-shape.js.map +1 -0
  460. package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
  461. package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
  462. package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
  463. package/dist/src/lib/schema-codegen/naming.d.ts +35 -0
  464. package/dist/src/lib/schema-codegen/naming.js +83 -0
  465. package/dist/src/lib/schema-codegen/naming.js.map +1 -0
  466. package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
  467. package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
  468. package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
  469. package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
  470. package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
  471. package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
  472. package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
  473. package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
  474. package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
  475. package/dist/src/lib/schema-codegen/schemaToTs.d.ts +109 -0
  476. package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
  477. package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
  478. package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
  479. package/dist/src/lib/schema-codegen/valuesLists.js +144 -0
  480. package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
  481. package/dist/src/lib/schema-defs-module.d.ts +29 -0
  482. package/dist/src/lib/schema-defs-module.js +103 -0
  483. package/dist/src/lib/schema-defs-module.js.map +1 -0
  484. package/dist/src/lib/schema-family-index.d.ts +228 -0
  485. package/dist/src/lib/schema-family-index.js +813 -0
  486. package/dist/src/lib/schema-family-index.js.map +1 -0
  487. package/dist/src/lib/schema-pins.d.ts +82 -0
  488. package/dist/src/lib/schema-pins.js +198 -0
  489. package/dist/src/lib/schema-pins.js.map +1 -0
  490. package/dist/src/lib/schema-preview.d.ts +244 -0
  491. package/dist/src/lib/schema-preview.js +498 -0
  492. package/dist/src/lib/schema-preview.js.map +1 -0
  493. package/dist/src/lib/scope-request.d.ts +23 -11
  494. package/dist/src/lib/scope-request.js +69 -31
  495. package/dist/src/lib/scope-request.js.map +1 -1
  496. package/dist/src/lib/session-scope.d.ts +26 -0
  497. package/dist/src/lib/session-scope.js +58 -0
  498. package/dist/src/lib/session-scope.js.map +1 -0
  499. package/dist/src/lib/skill-installer.d.ts +2 -2
  500. package/dist/src/lib/skill-installer.js +2 -21
  501. package/dist/src/lib/skill-installer.js.map +1 -1
  502. package/dist/src/lib/step-run-table.d.ts +1 -2
  503. package/dist/src/lib/step-run-table.js +1 -2
  504. package/dist/src/lib/step-run-table.js.map +1 -1
  505. package/dist/src/lib/swift-codegen/agentGenerator.d.ts +2 -1
  506. package/dist/src/lib/swift-codegen/agentGenerator.js +25 -23
  507. package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
  508. package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
  509. package/dist/src/lib/swift-codegen/banners.js +12 -0
  510. package/dist/src/lib/swift-codegen/banners.js.map +1 -1
  511. package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
  512. package/dist/src/lib/swift-codegen/functionGenerator.js +169 -51
  513. package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
  514. package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
  515. package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
  516. package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
  517. package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +51 -0
  518. package/dist/src/lib/swift-codegen/sharedGenerator.js +239 -0
  519. package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
  520. package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
  521. package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
  522. package/dist/src/lib/swift-codegen/swiftKeys.js.map +1 -0
  523. package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
  524. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
  525. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
  526. package/dist/src/lib/sync-resource-types.d.ts +117 -31
  527. package/dist/src/lib/sync-resource-types.js +197 -189
  528. package/dist/src/lib/sync-resource-types.js.map +1 -1
  529. package/dist/src/lib/sync-selectors.d.ts +7 -0
  530. package/dist/src/lib/sync-selectors.js +22 -2
  531. package/dist/src/lib/sync-selectors.js.map +1 -1
  532. package/dist/src/lib/template.d.ts +39 -3
  533. package/dist/src/lib/template.js +103 -14
  534. package/dist/src/lib/template.js.map +1 -1
  535. package/dist/src/lib/test-case-file-names.d.ts +3 -5
  536. package/dist/src/lib/test-case-file-names.js +3 -5
  537. package/dist/src/lib/test-case-file-names.js.map +1 -1
  538. package/dist/src/lib/test-runs.d.ts +45 -0
  539. package/dist/src/lib/test-runs.js +150 -0
  540. package/dist/src/lib/test-runs.js.map +1 -0
  541. package/dist/src/lib/test-users.d.ts +25 -0
  542. package/dist/src/lib/test-users.js +36 -0
  543. package/dist/src/lib/test-users.js.map +1 -0
  544. package/dist/src/lib/toml-database-config.d.ts +4 -2
  545. package/dist/src/lib/toml-database-config.js +11 -6
  546. package/dist/src/lib/toml-database-config.js.map +1 -1
  547. package/dist/src/lib/toml-list-edit.d.ts +33 -0
  548. package/dist/src/lib/toml-list-edit.js +481 -0
  549. package/dist/src/lib/toml-list-edit.js.map +1 -0
  550. package/dist/src/lib/toml-scalar-edit.d.ts +9 -0
  551. package/dist/src/lib/toml-scalar-edit.js +73 -5
  552. package/dist/src/lib/toml-scalar-edit.js.map +1 -1
  553. package/dist/src/lib/transition-warnings.d.ts +21 -0
  554. package/dist/src/lib/transition-warnings.js +49 -0
  555. package/dist/src/lib/transition-warnings.js.map +1 -0
  556. package/dist/src/lib/usage-meters.d.ts +16 -0
  557. package/dist/src/lib/usage-meters.js +52 -0
  558. package/dist/src/lib/usage-meters.js.map +1 -0
  559. package/dist/src/lib/user-index.d.ts +80 -0
  560. package/dist/src/lib/user-index.js +166 -0
  561. package/dist/src/lib/user-index.js.map +1 -0
  562. package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
  563. package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
  564. package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
  565. package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
  566. package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
  567. package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
  568. package/dist/src/lib/user-walk.d.ts +31 -0
  569. package/dist/src/lib/user-walk.js +102 -0
  570. package/dist/src/lib/user-walk.js.map +1 -0
  571. package/dist/src/lib/webhook-capture.d.ts +43 -0
  572. package/dist/src/lib/webhook-capture.js +91 -0
  573. package/dist/src/lib/webhook-capture.js.map +1 -0
  574. package/dist/src/lib/webhook-deliver.d.ts +18 -20
  575. package/dist/src/lib/webhook-deliver.js +34 -89
  576. package/dist/src/lib/webhook-deliver.js.map +1 -1
  577. package/dist/src/lib/webhook-test-run.d.ts +32 -0
  578. package/dist/src/lib/webhook-test-run.js +108 -0
  579. package/dist/src/lib/webhook-test-run.js.map +1 -0
  580. package/dist/src/lib/worker-perf-format.d.ts +22 -0
  581. package/dist/src/lib/worker-perf-format.js +27 -0
  582. package/dist/src/lib/worker-perf-format.js.map +1 -0
  583. package/dist/src/types/index.d.ts +20 -65
  584. package/dist/src/validators.d.ts +7 -55
  585. package/dist/src/validators.js +7 -53
  586. package/dist/src/validators.js.map +1 -1
  587. package/dist/src/vite.d.ts +17 -0
  588. package/dist/src/vite.js +18 -0
  589. package/dist/src/vite.js.map +1 -0
  590. package/package.json +20 -9
@@ -24,14 +24,20 @@
24
24
  * without this the bare `primitive-functions` specifier every function
25
25
  * imports would not resolve at all, and the augmentation would have
26
26
  * nothing to augment;
27
- * - `primitive-function-types.d.ts` (#3281, rendered by
28
- * `function-schema-codegen.ts`) — every function's `<Key>Input` and
29
- * `<Key>Output` from its declared schemas, and the `FunctionSchemas`
30
- * augmentation that types `defineFunction("<key>", handler)`;
27
+ * - `primitive.d.ts` (#5544, rendered by `primitive-declaration.ts`) —
28
+ * every `schemas/` def, function, prompt, db3 model and user property
29
+ * type under one namespace per family, and the augmentations that type
30
+ * `defineFunction`, `ctx.prompts.run`, `ctx.db3` and `ctx.users`. It
31
+ * replaced four per-family files (`RETIRED_DECLARATIONS`), which are
32
+ * removed;
31
33
  * - `primitive-document-types.d.ts` (#3281, rendered by
32
34
  * `function-document-types.ts`) — the project's document models from
33
35
  * `models/models.toml`, and the `DocumentSchemas` augmentation that types
34
- * `ctx.doc(documentId).model("<Model>")`; open when the project has none;
36
+ * `ctx.doc(documentId).model("<Model>")`; not written when the project has
37
+ * none (#5206), and dropped from an explicit tsconfig `files` list then.
38
+ * #5208 — inside a project it is typed from `models/models.toml` only,
39
+ * and the generated schema copy a pull or push once wrote beside it is
40
+ * removed (`plannedRemovals`);
35
41
  * - `generated/<key>.generated.ts` (#3281, same renderer) — the per-key
36
42
  * CLIENT invoker, carrying every verb since #3482. Excluded from
37
43
  * the scaffolded program (it imports `js-bao-wss-client`), and written to
@@ -56,13 +62,18 @@
56
62
  import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, } from "fs";
57
63
  import { basename, dirname, join, relative, resolve, sep } from "path";
58
64
  import { parseConfigToml } from "./config-toml.js";
59
- import { FUNCTION_INVOKERS_DIR, FUNCTION_TYPES_DECLARATION_FILE, GENERATED_FILE_SUFFIX, functionSchemaSources, renderFunctionInvokers, renderFunctionSchemasDeclaration, } from "./function-schema-codegen.js";
65
+ import { FUNCTION_INVOKERS_DIR, FunctionSchemaCodegenError, GENERATED_FILE_SUFFIX, functionSchemaSources, } from "./function-schema-codegen.js";
60
66
  import { DOCUMENT_TYPES_DECLARATION_FILE, DOCUMENT_SCHEMA_TREE_FILE, resolveDocumentSchema, renderDocumentTypesDeclaration, } from "./function-document-types.js";
61
- import { AGENT_CLIENT_FILE_SUFFIX, PROMPT_TYPES_DECLARATION_FILE, promptSchemaSources, renderAgentClientFiles, renderPromptSchemasDeclaration, } from "./prompt-schema-codegen.js";
62
- import { describeDbType } from "./db-codegen/dbTypeIR.js";
63
- import { tsTypeForDbFieldType } from "./db-codegen/dbTsTypes.js";
64
- import { objectPropertyKey } from "./db-codegen/dbNaming.js";
67
+ import { AGENT_CLIENT_FILE_SUFFIX, promptSchemaSources, renderAgentClientFiles, } from "./prompt-schema-codegen.js";
68
+ import { db3TypeSources, typeEntries } from "./db-type-records.js";
69
+ import { primitiveDeclarationInputs, renderPrimitiveDeclaration } from "./primitive-declaration.js";
70
+ import { renderFunctionInvokerSet } from "./invoker-shared-enums.js";
71
+ import { renderSchemaDefsModule, SCHEMA_DEFS_FILE } from "./schema-defs-module.js";
72
+ import { PRIMITIVE_DECLARATION_FILE, PRIMITIVE_DECLARATION_SPECIFIER, RETIRED_DECLARATIONS, } from "./primitive-declaration-names.js";
65
73
  import { SDK_TYPES_SOURCE } from "./generated-sdk-types.js";
74
+ import { USER_PROPERTIES_CLIENT_FILE, USER_PROPERTIES_FILE, renderUserPropertiesClientTypes, treeHasUserProperties, userPropertiesSource, } from "./user-properties/user-properties-codegen.js";
75
+ export { db3TypeSources } from "./db-type-records.js";
76
+ export { PRIMITIVE_DECLARATION_FILE, RETIRED_DECLARATIONS } from "./primitive-declaration-names.js";
66
77
  export const DB_TYPES_DECLARATION_FILE = "primitive-db-types.d.ts";
67
78
  export const SDK_TYPES_FILE = "primitive-functions.d.ts";
68
79
  export const FUNCTIONS_TSCONFIG_FILE = "tsconfig.json";
@@ -76,11 +87,12 @@ export const FUNCTIONS_TSCONFIG_FILE = "tsconfig.json";
76
87
  export const REGENERATED_DECLARATIONS = [
77
88
  DB_TYPES_DECLARATION_FILE,
78
89
  SDK_TYPES_FILE,
79
- FUNCTION_TYPES_DECLARATION_FILE,
90
+ // #5544 — every function, prompt, schemas/ def, db3 and user property type.
91
+ PRIMITIVE_DECLARATION_FILE,
80
92
  DOCUMENT_TYPES_DECLARATION_FILE,
81
- // #3330 — the prompt output types, from the tree's `prompts/*.toml`.
82
- PROMPT_TYPES_DECLARATION_FILE,
83
93
  ];
94
+ /** Every declaration codegen ever writes or once wrote. */
95
+ const ALL_DECLARATIONS = [...REGENERATED_DECLARATIONS, ...RETIRED_DECLARATIONS.map((retired) => retired.file)];
84
96
  /** The scaffold's exclusion for the client invokers (#3281). */
85
97
  export const GENERATED_EXCLUDE = `${FUNCTION_INVOKERS_DIR}/**`;
86
98
  const HEADER = `// GENERATED by \`primitive config push\` from database-type-configs/*.toml.
@@ -94,31 +106,6 @@ const HEADER = `// GENERATED by \`primitive config push\` from database-type-con
94
106
  // platform owns rather than the schema, added by the SDK's own row type, so it
95
107
  // is not repeated per model here whether or not a model declares one.
96
108
  `;
97
- function quote(value) {
98
- return JSON.stringify(value);
99
- }
100
- /**
101
- * A model or field name as a TYPE member key.
102
- *
103
- * Model and field names are whatever the TOML says — js-bao preserves them
104
- * verbatim — so `Order-Item` and `first-name` are ordinary schemas and are not
105
- * TypeScript identifiers. Emitting one raw makes the whole declaration a syntax
106
- * error, which breaks the editor and `tsc` wiring for every OTHER type in the
107
- * tree too. The client generators' own `objectPropertyKey` answers this,
108
- * except that its `__proto__` case is a computed key — legal in an object
109
- * literal, not in a type member — so that one is quoted instead.
110
- */
111
- function memberKey(name) {
112
- const key = objectPropertyKey(name);
113
- return key.startsWith("[") ? quote(name) : key;
114
- }
115
- /** A TS string-literal union, or `string` when there is nothing to narrow to. */
116
- function fieldType(type, enumValues) {
117
- if (type === "string" && Array.isArray(enumValues) && enumValues.length > 0) {
118
- return enumValues.map((v) => quote(v)).join(" | ");
119
- }
120
- return tsTypeForDbFieldType(type);
121
- }
122
109
  /**
123
110
  * The declaration for a whole config tree's database types.
124
111
  *
@@ -129,57 +116,12 @@ function fieldType(type, enumValues) {
129
116
  export function renderDbTypesDeclaration(sources) {
130
117
  const types = [...sources].sort((a, b) => a.databaseType < b.databaseType ? -1 : a.databaseType > b.databaseType ? 1 : 0);
131
118
  const lines = [HEADER, "export interface PrimitiveDatabaseSchemas {"];
132
- for (const source of types) {
133
- let records = [];
134
- try {
135
- const ir = describeDbType({
136
- databaseType: source.databaseType,
137
- tomlPath: source.tomlPath,
138
- tomlContent: source.tomlContent,
139
- });
140
- records = [...ir.records]
141
- .sort((a, b) => (a.modelName < b.modelName ? -1 : 1))
142
- .map((record) => {
143
- const declared = new Set();
144
- const members = [];
145
- for (const field of record.fields) {
146
- declared.add(field.name);
147
- members.push(` ${memberKey(field.name)}${field.required ? "" : "?"}: ${fieldType(field.type, field.enum)};`);
148
- }
149
- // Server-stamped fields exist on a read row but not on one a
150
- // function just built, so they are optional — the same call the
151
- // client renderer makes.
152
- for (const stamped of [...ir.stampedFields].sort()) {
153
- if (declared.has(stamped))
154
- continue;
155
- declared.add(stamped);
156
- members.push(` ${memberKey(stamped)}?: string;`);
157
- }
158
- return { modelName: record.modelName, members };
159
- });
160
- }
161
- catch {
162
- // A type whose TOML this renderer cannot describe contributes no models
163
- // rather than failing the push: its own preflight reports the file, and
164
- // an untyped handle is what a schemaless type gets anyway.
165
- records = [];
166
- }
167
- if (records.length === 0) {
168
- lines.push(` ${quote(source.databaseType)}: {};`);
169
- continue;
170
- }
171
- lines.push(` ${quote(source.databaseType)}: {`);
172
- for (const record of records) {
173
- if (record.members.length === 0) {
174
- lines.push(` ${memberKey(record.modelName)}: Record<string, unknown>;`);
175
- continue;
176
- }
177
- lines.push(` ${memberKey(record.modelName)}: {`);
178
- lines.push(...record.members);
179
- lines.push(` };`);
180
- }
181
- lines.push(` };`);
182
- }
119
+ lines.push(...typeEntries(types.map((source) => ({
120
+ key: source.databaseType,
121
+ tomlPath: source.tomlPath,
122
+ tomlContent: source.tomlContent,
123
+ table: "database",
124
+ })), "optional"));
183
125
  lines.push("}");
184
126
  lines.push("");
185
127
  // The augmentation. Only emitted when there is something to bind: an empty
@@ -193,8 +135,14 @@ export function renderDbTypesDeclaration(sources) {
193
135
  }
194
136
  return lines.join("\n");
195
137
  }
196
- /** The scaffolded compiler wiring. Written once; an author owns it after. */
197
- export function renderFunctionsTsconfig() {
138
+ /**
139
+ * The scaffolded compiler wiring. Written once; an author owns it after.
140
+ *
141
+ * `absent` names the regenerated declarations the tree does not get, which
142
+ * the scaffold leaves out of `include` (#5898).
143
+ */
144
+ export function renderFunctionsTsconfig(absent = []) {
145
+ const declarations = REGENERATED_DECLARATIONS.filter((file) => !absent.includes(file));
198
146
  return (JSON.stringify({
199
147
  // Scaffolded by `primitive config push` (#3182). Yours to adjust — push
200
148
  // writes it once and then leaves it alone. What it must keep doing is
@@ -221,7 +169,7 @@ export function renderFunctionsTsconfig() {
221
169
  "primitive-functions": [`./${SDK_TYPES_FILE}`],
222
170
  },
223
171
  },
224
- include: ["**/*.ts", ...REGENERATED_DECLARATIONS.map((file) => `./${file}`)],
172
+ include: ["**/*.ts", ...declarations.map((file) => `./${file}`)],
225
173
  // The client invokers (#3281) import `js-bao-wss-client`, which a
226
174
  // config tree does not install: they are for the app's client code,
227
175
  // and an editor program that swept them in would report every one of
@@ -305,6 +253,10 @@ function isGlobEntry(entry) {
305
253
  function isDeclarationEntry(entry, file) {
306
254
  return entry === `./${file}` || entry === file;
307
255
  }
256
+ /** The retired declaration an entry names (#5544), or null. */
257
+ function retiredEntryOf(entry) {
258
+ return RETIRED_DECLARATIONS.find((retired) => isDeclarationEntry(entry, retired.file)) ?? null;
259
+ }
308
260
  /** `"./**\/*.ts"` and `"**\/*.ts"` name the same set; read them the same way. */
309
261
  function normalizeEntry(entry) {
310
262
  return entry.startsWith("./") ? entry.slice(2) : entry;
@@ -351,7 +303,7 @@ function coversSubdirectories(entry) {
351
303
  function isSourceEntry(entry) {
352
304
  if (typeof entry !== "string")
353
305
  return false;
354
- if (REGENERATED_DECLARATIONS.some((file) => isDeclarationEntry(entry, file))) {
306
+ if (ALL_DECLARATIONS.some((file) => isDeclarationEntry(entry, file))) {
355
307
  return false;
356
308
  }
357
309
  return isGlobEntry(entry) || entry.endsWith(".ts");
@@ -399,11 +351,17 @@ function tsconfigWiringGaps(parsed, context) {
399
351
  const declarationsCovered = listed.some(coversDeclarations);
400
352
  const reachesSubdirectories = listed.some(coversSubdirectories);
401
353
  const exclude = Array.isArray(parsed.exclude) ? parsed.exclude : [];
354
+ const absent = context.absentDeclarations ?? [];
402
355
  return {
403
356
  mapping: !mapped.includes(`./${SDK_TYPES_FILE}`),
404
357
  missingDeclarations: implicitlyAll || declarationsCovered
405
358
  ? []
406
- : REGENERATED_DECLARATIONS.filter((file) => !listed.some((entry) => isDeclarationEntry(entry, file))),
359
+ : REGENERATED_DECLARATIONS.filter((file) => !absent.includes(file) && !listed.some((entry) => isDeclarationEntry(entry, file))),
360
+ absentFiles: files.filter((entry) => typeof entry === "string" && absent.some((file) => isDeclarationEntry(entry, file))),
361
+ retiredEntries: [
362
+ ...include.filter((entry) => retiredEntryOf(entry)).map((entry) => ({ list: "include", entry: entry })),
363
+ ...files.filter((entry) => retiredEntryOf(entry)).map((entry) => ({ list: "files", entry: entry })),
364
+ ],
407
365
  sources: !implicitlyAll && !declarationsCovered && !listed.some(isSourceEntry),
408
366
  // Only a program that would SEE the directory needs the exclusion: an
409
367
  // explicit list that reaches no subdirectory never sweeps it in.
@@ -413,7 +371,12 @@ function tsconfigWiringGaps(parsed, context) {
413
371
  };
414
372
  }
415
373
  function hasGaps(gaps) {
416
- return (gaps.mapping || gaps.missingDeclarations.length > 0 || gaps.sources || gaps.generatedExclusion);
374
+ return (gaps.mapping ||
375
+ gaps.missingDeclarations.length > 0 ||
376
+ gaps.sources ||
377
+ gaps.generatedExclusion ||
378
+ gaps.absentFiles.length > 0 ||
379
+ gaps.retiredEntries.length > 0);
417
380
  }
418
381
  function describeGaps(gaps) {
419
382
  const problems = [];
@@ -433,6 +396,17 @@ function describeGaps(gaps) {
433
396
  problems.push(`\`exclude\` does not cover "${GENERATED_EXCLUDE}", so the generated client ` +
434
397
  "invokers (which import `js-bao-wss-client`) are swept into the program");
435
398
  }
399
+ if (gaps.absentFiles.length > 0) {
400
+ problems.push(`\`files\` names ${gaps.absentFiles
401
+ .map((entry) => `"${entry}"`)
402
+ .join(", ")}, which codegen no longer writes, so the compiler reports it missing`);
403
+ }
404
+ for (const { list, entry } of gaps.retiredEntries) {
405
+ const retired = retiredEntryOf(entry);
406
+ problems.push(`\`${list}\` names "${entry}", which codegen no longer writes: its types are in ` +
407
+ `"./${PRIMITIVE_DECLARATION_FILE}" under ${retired.namespace}, so remove the entry` +
408
+ (list === "files" ? ` and list "./${PRIMITIVE_DECLARATION_FILE}"` : ""));
409
+ }
436
410
  return problems;
437
411
  }
438
412
  /**
@@ -458,7 +432,7 @@ function describeGaps(gaps) {
458
432
  */
459
433
  export function inspectFunctionsTsconfig(existing, context = { generatedDirExists: false }) {
460
434
  if (existing === null) {
461
- return { repaired: renderFunctionsTsconfig(), problems: [] };
435
+ return { repaired: renderFunctionsTsconfig(context.absentDeclarations), problems: [] };
462
436
  }
463
437
  let parsed;
464
438
  let plainJson = true;
@@ -508,6 +482,20 @@ export function inspectFunctionsTsconfig(existing, context = { generatedDirExist
508
482
  : [];
509
483
  paths[SDK_MODULE_SPECIFIER] = [...mapped, `./${SDK_TYPES_FILE}`];
510
484
  }
485
+ if (gaps.retiredEntries.length > 0) {
486
+ // #5544 — a retired declaration's entry goes; its replacement comes back
487
+ // through the missing-declaration repair below, and a `files` list the
488
+ // removal empties goes with it, the sources then coming through `include`.
489
+ for (const list of ["include", "files"]) {
490
+ if (!Array.isArray(parsed[list]))
491
+ continue;
492
+ const kept = parsed[list].filter((entry) => !retiredEntryOf(entry));
493
+ if (list === "files" && kept.length === 0)
494
+ delete parsed.files;
495
+ else
496
+ parsed[list] = kept;
497
+ }
498
+ }
511
499
  if (gaps.missingDeclarations.length > 0 || gaps.sources) {
512
500
  const include = Array.isArray(parsed.include) ? parsed.include : [];
513
501
  const added = [];
@@ -527,6 +515,15 @@ export function inspectFunctionsTsconfig(existing, context = { generatedDirExist
527
515
  const exclude = Array.isArray(parsed.exclude) ? parsed.exclude : [];
528
516
  parsed.exclude = [...exclude, GENERATED_EXCLUDE];
529
517
  }
518
+ if (gaps.absentFiles.length > 0 && Array.isArray(parsed.files)) {
519
+ // #5206 — a root that no longer exists is dropped; an emptied list goes
520
+ // with it, since the sources then come through `include`.
521
+ const files = parsed.files.filter((entry) => !gaps.absentFiles.includes(entry));
522
+ if (files.length > 0)
523
+ parsed.files = files;
524
+ else
525
+ delete parsed.files;
526
+ }
530
527
  return { repaired: JSON.stringify(parsed, null, 2) + "\n", problems: [] };
531
528
  }
532
529
  /**
@@ -630,37 +627,95 @@ function planAgentClientArtifacts(configDir, options) {
630
627
  };
631
628
  });
632
629
  }
630
+ /**
631
+ * The app's client types of `user-properties.toml` (#5385), where the
632
+ * invokers go: client code needs them whether or not the tree has functions.
633
+ */
634
+ function planUserPropertiesClientArtifacts(configDir, options, userProperties) {
635
+ if (!userProperties)
636
+ return [];
637
+ const absolute = join(functionInvokerDir(configDir, options), USER_PROPERTIES_CLIENT_FILE);
638
+ return [
639
+ {
640
+ relative: reportedPath(configDir, absolute),
641
+ absolute,
642
+ contents: renderUserPropertiesClientTypes(userProperties),
643
+ regenerated: true,
644
+ source: USER_PROPERTIES_FILE,
645
+ },
646
+ ];
647
+ }
648
+ /**
649
+ * #5899 — `schema-defs.generated.ts`, where the invokers go, when a db3 field
650
+ * refs a `schemas/` object def: client code needs it whether or not the tree
651
+ * has functions.
652
+ */
653
+ function planSchemaDefsClientArtifacts(configDir, options) {
654
+ const module = renderSchemaDefsModule({ db3: db3TypeSources(configDir), configDir });
655
+ if (!module)
656
+ return [];
657
+ const absolute = join(functionInvokerDir(configDir, options), module.fileName);
658
+ return [
659
+ {
660
+ relative: reportedPath(configDir, absolute),
661
+ absolute,
662
+ contents: module.content,
663
+ regenerated: true,
664
+ source: `the JSON field defs of ${module.sources.join(", ")}`,
665
+ },
666
+ ];
667
+ }
633
668
  /**
634
669
  * What push would write, without writing it.
635
670
  *
636
- * Only the agents' client artifacts when the tree has no `functions/`
637
- * directory (#3798, DSO-3798-005), and nothing at all when it has neither:
638
- * the other artifacts exist to type function sources, and a tree with none
639
- * needs no compiler wiring.
671
+ * Only the client artifacts — the agents' (#3798, DSO-3798-005) and the user
672
+ * property types (#5385) — when the tree has no `functions/` directory, and
673
+ * nothing at all when it has none of them: the other artifacts exist to type
674
+ * function sources, and a tree with none needs no compiler wiring.
640
675
  */
641
676
  export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
642
677
  const functionsDir = join(configDir, "functions");
643
678
  const agentArtifacts = planAgentClientArtifacts(configDir, options);
644
- if (!treeHasFunctionsDir(configDir))
645
- return agentArtifacts;
646
- // #3455 — one resolution for both the declaration below and the tree copy.
679
+ if (!treeHasFunctionsDir(configDir)) {
680
+ const clientArtifacts = [
681
+ ...planUserPropertiesClientArtifacts(configDir, options, userPropertiesSource(configDir)),
682
+ ...planSchemaDefsClientArtifacts(configDir, options),
683
+ ...agentArtifacts,
684
+ ];
685
+ refuseSharedDestinations(clientArtifacts);
686
+ return clientArtifacts;
687
+ }
688
+ // #3455 — one resolution for the document declaration below.
647
689
  const documentSchema = resolveDocumentSchema(configDir);
648
- const declaration = renderDbTypesDeclaration(databaseTypeSources(configDir));
649
- // #3281 — the functions declaration and the per-key invokers, from the same
690
+ // #5898 — `ctx.db`'s declaration only for a tree with database types: with
691
+ // none it would be an empty interface, and the one an earlier run wrote goes
692
+ // (`retiredFunctionTypeArtifacts`). The handle stays open without it.
693
+ const databaseTypes = databaseTypeSources(configDir);
694
+ // #5544 — every function, prompt, schemas/ def, db3 and user property type
695
+ // in one declaration, and the per-key invokers from the same
650
696
  // `functions/*.toml`. A malformed schema throws naming the file: the honest
651
697
  // `unknown` is for an absent schema, and typing a broken one as anything
652
698
  // would be a declaration that lies.
653
699
  const functionSources = functionSchemaSources(configDir);
654
- const functionsDeclaration = renderFunctionSchemasDeclaration(functionSources);
700
+ const primitiveDeclaration = renderPrimitiveDeclaration(primitiveDeclarationInputs(configDir));
655
701
  const invokerDir = functionInvokerDir(configDir, options);
656
- const invokers = renderFunctionInvokers(functionSources);
702
+ // #5896 — with the shared `schemas/` enums they use, declared once beside them.
703
+ const invokerSet = renderFunctionInvokerSet(configDir, functionSources);
704
+ const invokers = invokerSet.invokers;
705
+ // #5385 — the user property types, only for a tree that declares them. A
706
+ // file that does not parse throws naming it, like a malformed function schema.
707
+ const userProperties = userPropertiesSource(configDir);
657
708
  const artifacts = [
658
- {
659
- relative: `functions/${DB_TYPES_DECLARATION_FILE}`,
660
- absolute: join(functionsDir, DB_TYPES_DECLARATION_FILE),
661
- contents: declaration,
662
- regenerated: true,
663
- },
709
+ ...(databaseTypes.length > 0
710
+ ? [
711
+ {
712
+ relative: `functions/${DB_TYPES_DECLARATION_FILE}`,
713
+ absolute: join(functionsDir, DB_TYPES_DECLARATION_FILE),
714
+ contents: renderDbTypesDeclaration(databaseTypes),
715
+ regenerated: true,
716
+ },
717
+ ]
718
+ : []),
664
719
  {
665
720
  relative: `functions/${SDK_TYPES_FILE}`,
666
721
  absolute: join(functionsDir, SDK_TYPES_FILE),
@@ -668,50 +723,37 @@ export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
668
723
  regenerated: true,
669
724
  },
670
725
  {
671
- relative: `functions/${FUNCTION_TYPES_DECLARATION_FILE}`,
672
- absolute: join(functionsDir, FUNCTION_TYPES_DECLARATION_FILE),
673
- contents: functionsDeclaration,
726
+ relative: `functions/${PRIMITIVE_DECLARATION_FILE}`,
727
+ absolute: join(functionsDir, PRIMITIVE_DECLARATION_FILE),
728
+ contents: primitiveDeclaration,
674
729
  regenerated: true,
675
730
  },
676
731
  // #3281 — the document handle's declaration, from the project's
677
- // `models/models.toml` (open when the project has none).
732
+ // `models/models.toml`.
678
733
  //
679
734
  // #3455 (D3455-009) — through the SAME resolution push and diff use, so a
680
735
  // tree pulled into a project with no `models/models.toml` is typed from
681
736
  // the schema its active version was pushed with rather than losing its
682
737
  // types the moment it is pulled.
683
- {
684
- relative: `functions/${DOCUMENT_TYPES_DECLARATION_FILE}`,
685
- absolute: join(functionsDir, DOCUMENT_TYPES_DECLARATION_FILE),
686
- contents: renderDocumentTypesDeclaration(documentSchema.declarationSource),
687
- regenerated: true,
688
- },
689
- // #3330 — `ctx.prompts.run`'s output types, from this tree's
690
- // `prompts/*.toml` (open when the tree declares none).
691
- {
692
- relative: `functions/${PROMPT_TYPES_DECLARATION_FILE}`,
693
- absolute: join(functionsDir, PROMPT_TYPES_DECLARATION_FILE),
694
- contents: renderPromptSchemasDeclaration(promptSchemaSources(configDir)),
695
- regenerated: true,
696
- },
697
- // #3455 (D3455-009) — the project's document schema, copied into the tree
698
- // so a fresh `config pull` into a project that has no `models/models.toml`
699
- // still rebuilds the same envelope and reads Synced.
700
738
  //
701
- // Regenerated from the PROJECT file whenever there is one, and otherwise
702
- // left exactly alone: when the copy is itself what the resolution answered
703
- // (rule 2) it IS the source, and rewriting a file from itself would be the
704
- // second source of truth the fixed precedence exists to avoid.
705
- ...(documentSchema.origin === "project" && documentSchema.source
739
+ // #5206 — none when no schema file resolves: an app with no documents
740
+ // gets no document declaration, and the one an earlier run wrote goes
741
+ // (`retiredFunctionTypeArtifacts`). The handle stays open without it.
742
+ ...(documentSchema.declarationSource
706
743
  ? [
707
744
  {
708
- relative: `functions/${DOCUMENT_SCHEMA_TREE_FILE}`,
709
- absolute: join(functionsDir, DOCUMENT_SCHEMA_TREE_FILE),
710
- contents: documentSchema.source.content,
745
+ relative: `functions/${DOCUMENT_TYPES_DECLARATION_FILE}`,
746
+ absolute: join(functionsDir, DOCUMENT_TYPES_DECLARATION_FILE),
747
+ contents: renderDocumentTypesDeclaration(documentSchema.declarationSource),
711
748
  regenerated: true,
712
749
  },
713
750
  ]
714
751
  : []),
752
+ // #5208 — the generated schema copy (D3455-009) is never planned: inside
753
+ // a project `models/models.toml` is the only document schema, so a copy
754
+ // there is a planned removal; outside one, a copy is itself the
755
+ // resolution (rule 2), and rewriting a file from itself would be a second
756
+ // source of truth.
715
757
  ...invokers.map((invoker) => {
716
758
  const absolute = join(invokerDir, invoker.fileName);
717
759
  return {
@@ -719,8 +761,28 @@ export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
719
761
  absolute,
720
762
  contents: invoker.content,
721
763
  regenerated: true,
764
+ source: `function ${invoker.fileName.slice(0, -GENERATED_FILE_SUFFIX.length)}`,
722
765
  };
723
766
  }),
767
+ // #5896 — after the invokers, so a function keyed `shared-enums` is the
768
+ // one a refusal names first.
769
+ ...(invokerSet.sharedEnums
770
+ ? [
771
+ {
772
+ relative: reportedPath(configDir, join(invokerDir, invokerSet.sharedEnums.fileName)),
773
+ absolute: join(invokerDir, invokerSet.sharedEnums.fileName),
774
+ contents: invokerSet.sharedEnums.content,
775
+ regenerated: true,
776
+ source: `the shared enums of ${invokerSet.sharedEnums.sources.join(", ")}`,
777
+ },
778
+ ]
779
+ : []),
780
+ // #5385 — `UserProperties` and `ClientUserProperties` for the app's client
781
+ // code (beside the invokers); the functions' are in `primitive.d.ts`.
782
+ ...planUserPropertiesClientArtifacts(configDir, options, userProperties),
783
+ // #5899 — after the invokers, so a function keyed `schema-defs` is the one
784
+ // a refusal names first.
785
+ ...planSchemaDefsClientArtifacts(configDir, options),
724
786
  // #3798 — each agent's client-side types, beside the invokers and owned
725
787
  // by the same plan (so the orphan sweep keeps them while the agent does).
726
788
  ...agentArtifacts,
@@ -747,8 +809,27 @@ export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
747
809
  regenerated: false,
748
810
  });
749
811
  }
812
+ refuseSharedDestinations(artifacts);
750
813
  return artifacts;
751
814
  }
815
+ /**
816
+ * Refuse a plan in which two artifacts name one file (#5385): a function
817
+ * keyed `user-properties` writes its invoker where the user property client
818
+ * types go, and either would silently overwrite the other. Judged on the
819
+ * absolute paths, so a `-o` directory is judged as written.
820
+ */
821
+ function refuseSharedDestinations(artifacts) {
822
+ const byPath = new Map();
823
+ for (const artifact of artifacts) {
824
+ const prior = byPath.get(artifact.absolute);
825
+ if (prior) {
826
+ throw new FunctionSchemaCodegenError(`${artifact.relative} would be generated twice — from ${prior.source ?? prior.relative} and from ` +
827
+ `${artifact.source ?? artifact.relative} — and one would overwrite the other. Rename the function ` +
828
+ "(its key names its generated file) so the two differ.");
829
+ }
830
+ byPath.set(artifact.absolute, artifact);
831
+ }
832
+ }
752
833
  /**
753
834
  * The tsconfig wiring push could not repair, phrased for the author.
754
835
  *
@@ -777,13 +858,21 @@ export function functionTypeWiringProblems(configDir, options = {}) {
777
858
  /**
778
859
  * What the inspection knows about the directory: whether `generated/` will
779
860
  * exist beside the tsconfig once this plan is written (it exists now, or this
780
- * plan writes an invoker into the default location).
861
+ * plan writes an invoker into the default location), and which declarations
862
+ * the plan leaves out (#5206, #5898).
781
863
  */
782
864
  function tsconfigContext(configDir, options) {
783
865
  const defaultDir = join(configDir, "functions", FUNCTION_INVOKERS_DIR);
866
+ const userProperties = treeHasUserProperties(configDir);
784
867
  const writesThere = functionInvokerDir(configDir, options) === defaultDir &&
785
- functionSchemaSources(configDir).length > 0;
786
- return { generatedDirExists: existsSync(defaultDir) || writesThere };
868
+ (functionSchemaSources(configDir).length > 0 || userProperties);
869
+ return {
870
+ generatedDirExists: existsSync(defaultDir) || writesThere,
871
+ absentDeclarations: [
872
+ ...(databaseTypeSources(configDir).length > 0 ? [] : [DB_TYPES_DECLARATION_FILE]),
873
+ ...(resolveDocumentSchema(configDir).declarationSource ? [] : [DOCUMENT_TYPES_DECLARATION_FILE]),
874
+ ],
875
+ };
787
876
  }
788
877
  /**
789
878
  * Invokers in the plan's directory that the plan no longer writes — a
@@ -797,20 +886,92 @@ function orphanedInvokers(configDir, planned, options) {
797
886
  const keep = new Set(planned.map((a) => a.absolute));
798
887
  // #3798 (CSO-3798-003) — with no `functions/` at all, an agent's client
799
888
  // artifact is the only thing a run could have written here (an `-o`
800
- // directory the functions run never owned before), so only those are swept.
801
- const suffix = existsSync(join(configDir, "functions"))
802
- ? GENERATED_FILE_SUFFIX
803
- : AGENT_CLIENT_FILE_SUFFIX;
889
+ // directory the functions run never owned before), so only those are swept
890
+ // — and (#5385) the user property client types.
891
+ const owned = existsSync(join(configDir, "functions"))
892
+ ? (f) => f.endsWith(GENERATED_FILE_SUFFIX)
893
+ : (f) => f.endsWith(AGENT_CLIENT_FILE_SUFFIX) || f === USER_PROPERTIES_CLIENT_FILE || f === SCHEMA_DEFS_FILE;
804
894
  return readdirSync(dir)
805
- .filter((f) => f.endsWith(suffix))
895
+ .filter(owned)
806
896
  .map((f) => join(dir, f))
807
897
  .filter((absolute) => !keep.has(absolute));
808
898
  }
809
- /** Write them, and report the tree-relative paths that changed on disk. */
810
- export function writeFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
899
+ /**
900
+ * Declarations a plan may leave out: the database declaration exists only
901
+ * while the tree has database types (#5898), and the document declaration
902
+ * only while a document schema resolves (#5206).
903
+ */
904
+ const OPTIONAL_DECLARATIONS = [DB_TYPES_DECLARATION_FILE, DOCUMENT_TYPES_DECLARATION_FILE];
905
+ /**
906
+ * The generated files on disk that `planned` no longer writes: a database
907
+ * or document declaration an earlier run wrote, once the tree's database
908
+ * types (#5898) or document schema (#5206) are gone, the four declarations `primitive.d.ts` replaced (#5544), and,
909
+ * inside a project, the generated schema copy no resolution there reads
910
+ * (#5208).
911
+ */
912
+ export function retiredFunctionTypeArtifacts(configDir, planned) {
913
+ if (!treeHasFunctionsDir(configDir))
914
+ return [];
915
+ const keep = new Set(planned.map((a) => a.absolute));
916
+ const staleCopy = resolveDocumentSchema(configDir).staleTreeCopy;
917
+ return [
918
+ ...OPTIONAL_DECLARATIONS.map((file) => join(configDir, "functions", file)),
919
+ ...RETIRED_DECLARATIONS.map((retired) => join(configDir, "functions", retired.file)),
920
+ ...(staleCopy ? [staleCopy] : []),
921
+ ].filter((absolute) => !keep.has(absolute) && existsSync(absolute));
922
+ }
923
+ /**
924
+ * Every file a write of `planned` removes, as absolute paths (#5208): the
925
+ * invokers of removed functions, and the retired generated files. The one
926
+ * list the write, `--check`, the dry-run typechecker and the removal lines
927
+ * all read, so they cannot disagree about what goes.
928
+ */
929
+ export function plannedRemovals(configDir, planned, options = {}) {
930
+ return [
931
+ ...orphanedInvokers(configDir, planned, options),
932
+ ...retiredFunctionTypeArtifacts(configDir, planned),
933
+ ];
934
+ }
935
+ /**
936
+ * The line a command prints for a file a write removed (#5208), given its
937
+ * tree-relative path. The schema copy's names where the document schema
938
+ * lives and how to get it back; it never sends the author to the copy.
939
+ */
940
+ export function functionTypeRemovalLine(relative) {
941
+ if (relative.endsWith(`/${DOCUMENT_SCHEMA_TREE_FILE}`)) {
942
+ return (`Removed ${relative}: inside a project the document schema is models/models.toml, and this ` +
943
+ "generated file is no longer read. To keep the schema, restore models/models.toml from version " +
944
+ "control (the generated file was committed beside your functions); the running version keeps " +
945
+ "the schema until a push without it.");
946
+ }
947
+ if (relative.endsWith(`/${DOCUMENT_TYPES_DECLARATION_FILE}`)) {
948
+ return `Removed ${relative}: no document schema resolves, so ctx.doc's models are untyped.`;
949
+ }
950
+ if (relative.endsWith(`/${DB_TYPES_DECLARATION_FILE}`)) {
951
+ return `Removed ${relative}: the tree has no database-type-configs/*.toml, so ctx.db's models are untyped.`;
952
+ }
953
+ // #5544 — a declaration `primitive.d.ts` replaced names where its types went.
954
+ const retired = RETIRED_DECLARATIONS.find((entry) => relative.endsWith(`/${entry.file}`));
955
+ if (retired) {
956
+ return (`Removed ${relative}: its types are in functions/${PRIMITIVE_DECLARATION_FILE} under ${retired.namespace}; ` +
957
+ `import type { ${retired.namespace} } from "${PRIMITIVE_DECLARATION_SPECIFIER}".`);
958
+ }
959
+ // #5385 — the user property client types go with user-properties.toml.
960
+ if (relative.endsWith(`/${USER_PROPERTIES_CLIENT_FILE}`)) {
961
+ return `Removed ${relative}: the tree has no ${USER_PROPERTIES_FILE}, so UserProperties declares no field.`;
962
+ }
963
+ // #5899 — the JSON field defs go with the last db3 field that refs an object def.
964
+ if (relative.endsWith(`/${SCHEMA_DEFS_FILE}`) || relative === SCHEMA_DEFS_FILE) {
965
+ return `Removed ${relative}: no db3 field refs a schemas/ object def any more.`;
966
+ }
967
+ return `Removed ${relative}: no function declares it any more.`;
968
+ }
969
+ /** Write them, and report what was written and what was removed. */
970
+ export function applyFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
811
971
  // No early return for an empty plan (CSO-3798-003): removing a tree's last
812
972
  // agent (or its last function) plans nothing, and its artifacts still go.
813
973
  const artifacts = planFunctionTypeArtifacts(configDir, sdkTypes, options);
974
+ const removals = plannedRemovals(configDir, artifacts, options);
814
975
  const written = [];
815
976
  for (const artifact of artifacts) {
816
977
  const exists = existsSync(artifact.absolute);
@@ -825,10 +986,18 @@ export function writeFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
825
986
  // A removed function's invoker goes with it (#3281): a stale generated file
826
987
  // an app still imports is a compile error naming a function that no longer
827
988
  // exists, which is the right failure, but one left behind forever is not.
828
- for (const orphan of orphanedInvokers(configDir, artifacts, options)) {
829
- rmSync(orphan, { force: true });
989
+ const removed = [];
990
+ for (const absolute of removals) {
991
+ if (!existsSync(absolute))
992
+ continue;
993
+ rmSync(absolute, { force: true });
994
+ removed.push(reportedPath(configDir, absolute));
830
995
  }
831
- return written;
996
+ return { written, removed };
997
+ }
998
+ /** Write them, and report the tree-relative paths that changed on disk. */
999
+ export function writeFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
1000
+ return applyFunctionTypeArtifacts(configDir, sdkTypes, options).written;
832
1001
  }
833
1002
  /**
834
1003
  * The artifacts a `--check` run would rewrite: the freshness answer for CI and
@@ -851,8 +1020,8 @@ export function staleFunctionTypeArtifacts(configDir, options = {}) {
851
1020
  stale.push(artifact.relative);
852
1021
  }
853
1022
  }
854
- for (const orphan of orphanedInvokers(configDir, planned, options)) {
855
- stale.push(reportedPath(configDir, orphan));
1023
+ for (const removal of plannedRemovals(configDir, planned, options)) {
1024
+ stale.push(reportedPath(configDir, removal));
856
1025
  }
857
1026
  return stale;
858
1027
  }