primitive-admin 1.2.0-alpha.8 → 1.3.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (563) hide show
  1. package/README.md +258 -186
  2. package/assets/skill/skills/primitive-platform/SKILL.md +103 -29
  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.d.ts +1 -1
  13. package/dist/src/commands/apps-children.js +56 -145
  14. package/dist/src/commands/apps-children.js.map +1 -1
  15. package/dist/src/commands/apps-transitions.d.ts +39 -0
  16. package/dist/src/commands/apps-transitions.js +198 -0
  17. package/dist/src/commands/apps-transitions.js.map +1 -0
  18. package/dist/src/commands/apps.d.ts +17 -0
  19. package/dist/src/commands/apps.js +108 -3
  20. package/dist/src/commands/apps.js.map +1 -1
  21. package/dist/src/commands/auth-sessions.js +2 -0
  22. package/dist/src/commands/auth-sessions.js.map +1 -1
  23. package/dist/src/commands/auth.js +138 -44
  24. package/dist/src/commands/auth.js.map +1 -1
  25. package/dist/src/commands/blob-buckets.js +2 -0
  26. package/dist/src/commands/blob-buckets.js.map +1 -1
  27. package/dist/src/commands/collections.js +318 -256
  28. package/dist/src/commands/collections.js.map +1 -1
  29. package/dist/src/commands/comparisons.js +2 -0
  30. package/dist/src/commands/comparisons.js.map +1 -1
  31. package/dist/src/commands/config.d.ts +2 -2
  32. package/dist/src/commands/config.js +59 -33
  33. package/dist/src/commands/config.js.map +1 -1
  34. package/dist/src/commands/connections.js +2 -0
  35. package/dist/src/commands/connections.js.map +1 -1
  36. package/dist/src/commands/database-type-configs.js +5 -3
  37. package/dist/src/commands/database-type-configs.js.map +1 -1
  38. package/dist/src/commands/database-types.js +13 -313
  39. package/dist/src/commands/database-types.js.map +1 -1
  40. package/dist/src/commands/databases.js +6 -4
  41. package/dist/src/commands/databases.js.map +1 -1
  42. package/dist/src/commands/db3-types.d.ts +15 -0
  43. package/dist/src/commands/db3-types.js +159 -0
  44. package/dist/src/commands/db3-types.js.map +1 -0
  45. package/dist/src/commands/db3.d.ts +24 -0
  46. package/dist/src/commands/db3.js +1444 -0
  47. package/dist/src/commands/db3.js.map +1 -0
  48. package/dist/src/commands/documents.d.ts +110 -10
  49. package/dist/src/commands/documents.js +1012 -748
  50. package/dist/src/commands/documents.js.map +1 -1
  51. package/dist/src/commands/email-templates.js +74 -0
  52. package/dist/src/commands/email-templates.js.map +1 -1
  53. package/dist/src/commands/env.js +8 -4
  54. package/dist/src/commands/env.js.map +1 -1
  55. package/dist/src/commands/function-trigger-commands.d.ts +28 -0
  56. package/dist/src/commands/function-trigger-commands.js +341 -0
  57. package/dist/src/commands/function-trigger-commands.js.map +1 -0
  58. package/dist/src/commands/functions.js +376 -30
  59. package/dist/src/commands/functions.js.map +1 -1
  60. package/dist/src/commands/groups.js +168 -50
  61. package/dist/src/commands/groups.js.map +1 -1
  62. package/dist/src/commands/guides.js +7 -5
  63. package/dist/src/commands/guides.js.map +1 -1
  64. package/dist/src/commands/hosting.d.ts +8 -0
  65. package/dist/src/commands/hosting.js +346 -0
  66. package/dist/src/commands/hosting.js.map +1 -0
  67. package/dist/src/commands/init.js +129 -38
  68. package/dist/src/commands/init.js.map +1 -1
  69. package/dist/src/commands/integrations.js +82 -53
  70. package/dist/src/commands/integrations.js.map +1 -1
  71. package/dist/src/commands/llm.js +9 -6
  72. package/dist/src/commands/llm.js.map +1 -1
  73. package/dist/src/commands/locks.d.ts +5 -3
  74. package/dist/src/commands/locks.js +19 -61
  75. package/dist/src/commands/locks.js.map +1 -1
  76. package/dist/src/commands/metadata-category-configs.d.ts +2 -2
  77. package/dist/src/commands/metadata-category-configs.js +4 -2
  78. package/dist/src/commands/metadata-category-configs.js.map +1 -1
  79. package/dist/src/commands/metadata.js +41 -0
  80. package/dist/src/commands/metadata.js.map +1 -1
  81. package/dist/src/commands/prompts.js +75 -52
  82. package/dist/src/commands/prompts.js.map +1 -1
  83. package/dist/src/commands/rate-counters.d.ts +19 -0
  84. package/dist/src/commands/rate-counters.js +104 -0
  85. package/dist/src/commands/rate-counters.js.map +1 -0
  86. package/dist/src/commands/rule-sets.d.ts +1 -1
  87. package/dist/src/commands/rule-sets.js +2 -1
  88. package/dist/src/commands/rule-sets.js.map +1 -1
  89. package/dist/src/commands/schemas.d.ts +15 -0
  90. package/dist/src/commands/schemas.js +122 -0
  91. package/dist/src/commands/schemas.js.map +1 -0
  92. package/dist/src/commands/scripts.d.ts +9 -17
  93. package/dist/src/commands/scripts.js +24 -479
  94. package/dist/src/commands/scripts.js.map +1 -1
  95. package/dist/src/commands/secrets.js +47 -3
  96. package/dist/src/commands/secrets.js.map +1 -1
  97. package/dist/src/commands/sessions.js +2 -0
  98. package/dist/src/commands/sessions.js.map +1 -1
  99. package/dist/src/commands/settings.d.ts +12 -9
  100. package/dist/src/commands/settings.js +31 -79
  101. package/dist/src/commands/settings.js.map +1 -1
  102. package/dist/src/commands/skill.js +2 -0
  103. package/dist/src/commands/skill.js.map +1 -1
  104. package/dist/src/commands/sync-schemas.d.ts +202 -0
  105. package/dist/src/commands/sync-schemas.js +629 -0
  106. package/dist/src/commands/sync-schemas.js.map +1 -0
  107. package/dist/src/commands/sync-user-properties.d.ts +118 -0
  108. package/dist/src/commands/sync-user-properties.js +276 -0
  109. package/dist/src/commands/sync-user-properties.js.map +1 -0
  110. package/dist/src/commands/sync.d.ts +519 -554
  111. package/dist/src/commands/sync.js +3010 -4909
  112. package/dist/src/commands/sync.js.map +1 -1
  113. package/dist/src/commands/tokens.js +5 -3
  114. package/dist/src/commands/tokens.js.map +1 -1
  115. package/dist/src/commands/transitions.d.ts +54 -0
  116. package/dist/src/commands/transitions.js +418 -0
  117. package/dist/src/commands/transitions.js.map +1 -0
  118. package/dist/src/commands/usage.d.ts +18 -0
  119. package/dist/src/commands/usage.js +343 -0
  120. package/dist/src/commands/usage.js.map +1 -0
  121. package/dist/src/commands/user-properties.d.ts +14 -0
  122. package/dist/src/commands/user-properties.js +79 -0
  123. package/dist/src/commands/user-properties.js.map +1 -0
  124. package/dist/src/commands/users.js +911 -18
  125. package/dist/src/commands/users.js.map +1 -1
  126. package/dist/src/commands/vars.js +2 -0
  127. package/dist/src/commands/vars.js.map +1 -1
  128. package/dist/src/commands/waitlist.js +39 -4
  129. package/dist/src/commands/waitlist.js.map +1 -1
  130. package/dist/src/commands/workflows.d.ts +5 -83
  131. package/dist/src/commands/workflows.js +57 -2282
  132. package/dist/src/commands/workflows.js.map +1 -1
  133. package/dist/src/lib/analytics-query.d.ts +58 -0
  134. package/dist/src/lib/analytics-query.js +134 -0
  135. package/dist/src/lib/analytics-query.js.map +1 -0
  136. package/dist/src/lib/api-client.d.ts +1830 -429
  137. package/dist/src/lib/api-client.js +1025 -546
  138. package/dist/src/lib/api-client.js.map +1 -1
  139. package/dist/src/lib/app-settings-descriptor.d.ts +1 -1
  140. package/dist/src/lib/app-settings-descriptor.js +6 -0
  141. package/dist/src/lib/app-settings-descriptor.js.map +1 -1
  142. package/dist/src/lib/auth-fixtures.d.ts +44 -0
  143. package/dist/src/lib/auth-fixtures.js +61 -0
  144. package/dist/src/lib/auth-fixtures.js.map +1 -0
  145. package/dist/src/lib/auth-flow.d.ts +34 -1
  146. package/dist/src/lib/auth-flow.js +429 -13
  147. package/dist/src/lib/auth-flow.js.map +1 -1
  148. package/dist/src/lib/block-layout.d.ts +12 -23
  149. package/dist/src/lib/block-layout.js +26 -92
  150. package/dist/src/lib/block-layout.js.map +1 -1
  151. package/dist/src/lib/block-selector.d.ts +8 -14
  152. package/dist/src/lib/block-selector.js +8 -19
  153. package/dist/src/lib/block-selector.js.map +1 -1
  154. package/dist/src/lib/child-apps-local.d.ts +3 -47
  155. package/dist/src/lib/child-apps-local.js +11 -73
  156. package/dist/src/lib/child-apps-local.js.map +1 -1
  157. package/dist/src/lib/cli-manifest.d.ts +9 -0
  158. package/dist/src/lib/cli-manifest.js +10 -1
  159. package/dist/src/lib/cli-manifest.js.map +1 -1
  160. package/dist/src/lib/cli-version.d.ts +14 -0
  161. package/dist/src/lib/cli-version.js +38 -0
  162. package/dist/src/lib/cli-version.js.map +1 -0
  163. package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
  164. package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
  165. package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
  166. package/dist/src/lib/collection-export.d.ts +76 -15
  167. package/dist/src/lib/collection-export.js +116 -23
  168. package/dist/src/lib/collection-export.js.map +1 -1
  169. package/dist/src/lib/collection-principal.d.ts +22 -0
  170. package/dist/src/lib/collection-principal.js +35 -0
  171. package/dist/src/lib/collection-principal.js.map +1 -0
  172. package/dist/src/lib/command-groups.d.ts +30 -0
  173. package/dist/src/lib/command-groups.js +109 -0
  174. package/dist/src/lib/command-groups.js.map +1 -0
  175. package/dist/src/lib/command-status.d.ts +147 -0
  176. package/dist/src/lib/command-status.js +266 -0
  177. package/dist/src/lib/command-status.js.map +1 -0
  178. package/dist/src/lib/config-object-descriptor.d.ts +9 -22
  179. package/dist/src/lib/config-object-descriptor.js +107 -276
  180. package/dist/src/lib/config-object-descriptor.js.map +1 -1
  181. package/dist/src/lib/config-surface.d.ts +3 -7
  182. package/dist/src/lib/config-surface.js +9 -13
  183. package/dist/src/lib/config-surface.js.map +1 -1
  184. package/dist/src/lib/config-toml.d.ts +11 -2
  185. package/dist/src/lib/config-toml.js +25 -2
  186. package/dist/src/lib/config-toml.js.map +1 -1
  187. package/dist/src/lib/credentials-home.d.ts +7 -0
  188. package/dist/src/lib/credentials-home.js +45 -10
  189. package/dist/src/lib/credentials-home.js.map +1 -1
  190. package/dist/src/lib/credentials-lock.d.ts +14 -6
  191. package/dist/src/lib/credentials-lock.js +90 -10
  192. package/dist/src/lib/credentials-lock.js.map +1 -1
  193. package/dist/src/lib/credentials-store.d.ts +123 -70
  194. package/dist/src/lib/credentials-store.js +358 -113
  195. package/dist/src/lib/credentials-store.js.map +1 -1
  196. package/dist/src/lib/custodian.d.ts +8 -0
  197. package/dist/src/lib/custodian.js +18 -0
  198. package/dist/src/lib/custodian.js.map +1 -0
  199. package/dist/src/lib/data-input.d.ts +1 -1
  200. package/dist/src/lib/data-input.js +1 -1
  201. package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
  202. package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
  203. package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
  204. package/dist/src/lib/db-codegen/dbTypeIR.d.ts +38 -1
  205. package/dist/src/lib/db-codegen/dbTypeIR.js +29 -7
  206. package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
  207. package/dist/src/lib/db-type-records.d.ts +106 -0
  208. package/dist/src/lib/db-type-records.js +224 -0
  209. package/dist/src/lib/db-type-records.js.map +1 -0
  210. package/dist/src/lib/db3-export.d.ts +287 -0
  211. package/dist/src/lib/db3-export.js +647 -0
  212. package/dist/src/lib/db3-export.js.map +1 -0
  213. package/dist/src/lib/db3-index-output.d.ts +116 -0
  214. package/dist/src/lib/db3-index-output.js +223 -0
  215. package/dist/src/lib/db3-index-output.js.map +1 -0
  216. package/dist/src/lib/db3-type-models.d.ts +134 -0
  217. package/dist/src/lib/db3-type-models.js +452 -0
  218. package/dist/src/lib/db3-type-models.js.map +1 -0
  219. package/dist/src/lib/deprecation.d.ts +2 -2
  220. package/dist/src/lib/deprecation.js +2 -2
  221. package/dist/src/lib/document-ingest-artifact.d.ts +13 -0
  222. package/dist/src/lib/document-ingest-artifact.js +36 -6
  223. package/dist/src/lib/document-ingest-artifact.js.map +1 -1
  224. package/dist/src/lib/document-ingest-format2.d.ts +36 -0
  225. package/dist/src/lib/document-ingest-format2.js +78 -0
  226. package/dist/src/lib/document-ingest-format2.js.map +1 -0
  227. package/dist/src/lib/document-ingest-input.d.ts +9 -0
  228. package/dist/src/lib/document-ingest-input.js +28 -1
  229. package/dist/src/lib/document-ingest-input.js.map +1 -1
  230. package/dist/src/lib/document-ingest.d.ts +11 -1
  231. package/dist/src/lib/document-ingest.js +16 -0
  232. package/dist/src/lib/document-ingest.js.map +1 -1
  233. package/dist/src/lib/document-schema-rows.d.ts +42 -0
  234. package/dist/src/lib/document-schema-rows.js +53 -0
  235. package/dist/src/lib/document-schema-rows.js.map +1 -0
  236. package/dist/src/lib/experimental-apis.d.ts +36 -0
  237. package/dist/src/lib/experimental-apis.js +46 -0
  238. package/dist/src/lib/experimental-apis.js.map +1 -0
  239. package/dist/src/lib/file-attachment.d.ts +24 -0
  240. package/dist/src/lib/file-attachment.js +31 -0
  241. package/dist/src/lib/file-attachment.js.map +1 -0
  242. package/dist/src/lib/function-authorize-check.d.ts +142 -0
  243. package/dist/src/lib/function-authorize-check.js +311 -0
  244. package/dist/src/lib/function-authorize-check.js.map +1 -0
  245. package/dist/src/lib/function-authorize-view.d.ts +27 -0
  246. package/dist/src/lib/function-authorize-view.js +88 -0
  247. package/dist/src/lib/function-authorize-view.js.map +1 -0
  248. package/dist/src/lib/function-bundle.d.ts +27 -5
  249. package/dist/src/lib/function-bundle.js +142 -7
  250. package/dist/src/lib/function-bundle.js.map +1 -1
  251. package/dist/src/lib/function-collect.d.ts +90 -12
  252. package/dist/src/lib/function-collect.js +482 -12
  253. package/dist/src/lib/function-collect.js.map +1 -1
  254. package/dist/src/lib/function-db-types.d.ts +65 -11
  255. package/dist/src/lib/function-db-types.js +297 -157
  256. package/dist/src/lib/function-db-types.js.map +1 -1
  257. package/dist/src/lib/function-document-types.d.ts +19 -7
  258. package/dist/src/lib/function-document-types.js +24 -12
  259. package/dist/src/lib/function-document-types.js.map +1 -1
  260. package/dist/src/lib/function-lint.d.ts +57 -0
  261. package/dist/src/lib/function-lint.js +234 -0
  262. package/dist/src/lib/function-lint.js.map +1 -0
  263. package/dist/src/lib/function-log-row.js +21 -2
  264. package/dist/src/lib/function-log-row.js.map +1 -1
  265. package/dist/src/lib/function-run.d.ts +13 -21
  266. package/dist/src/lib/function-run.js +14 -27
  267. package/dist/src/lib/function-run.js.map +1 -1
  268. package/dist/src/lib/function-schema-codegen.d.ts +86 -22
  269. package/dist/src/lib/function-schema-codegen.js +194 -88
  270. package/dist/src/lib/function-schema-codegen.js.map +1 -1
  271. package/dist/src/lib/function-schema-refs.d.ts +98 -0
  272. package/dist/src/lib/function-schema-refs.js +177 -0
  273. package/dist/src/lib/function-schema-refs.js.map +1 -0
  274. package/dist/src/lib/function-sync.d.ts +109 -6
  275. package/dist/src/lib/function-sync.js +179 -26
  276. package/dist/src/lib/function-sync.js.map +1 -1
  277. package/dist/src/lib/function-trigger-listing.d.ts +11 -6
  278. package/dist/src/lib/function-trigger-listing.js +32 -11
  279. package/dist/src/lib/function-trigger-listing.js.map +1 -1
  280. package/dist/src/lib/function-triggers.d.ts +15 -3
  281. package/dist/src/lib/function-triggers.js +72 -10
  282. package/dist/src/lib/function-triggers.js.map +1 -1
  283. package/dist/src/lib/function-typecheck.d.ts +52 -0
  284. package/dist/src/lib/function-typecheck.js +174 -54
  285. package/dist/src/lib/function-typecheck.js.map +1 -1
  286. package/dist/src/lib/function-versions.d.ts +2 -0
  287. package/dist/src/lib/function-versions.js +1 -0
  288. package/dist/src/lib/function-versions.js.map +1 -1
  289. package/dist/src/lib/generated-build-flags.d.ts +13 -0
  290. package/dist/src/lib/generated-build-flags.js +14 -0
  291. package/dist/src/lib/generated-build-flags.js.map +1 -0
  292. package/dist/src/lib/generated-command-status.d.ts +6 -0
  293. package/dist/src/lib/generated-command-status.js +469 -0
  294. package/dist/src/lib/generated-command-status.js.map +1 -0
  295. package/dist/src/lib/generated-config-surfaces.d.ts +586 -152
  296. package/dist/src/lib/generated-config-surfaces.js +1919 -1883
  297. package/dist/src/lib/generated-config-surfaces.js.map +1 -1
  298. package/dist/src/lib/generated-sdk-types.d.ts +1 -1
  299. package/dist/src/lib/generated-sdk-types.js +1 -1
  300. package/dist/src/lib/generated-sdk-types.js.map +1 -1
  301. package/dist/src/lib/generated-workflow-model-fields.d.ts +20 -0
  302. package/dist/src/lib/generated-workflow-model-fields.js +53 -0
  303. package/dist/src/lib/generated-workflow-model-fields.js.map +1 -0
  304. package/dist/src/lib/hosting-build.d.ts +97 -0
  305. package/dist/src/lib/hosting-build.js +204 -0
  306. package/dist/src/lib/hosting-build.js.map +1 -0
  307. package/dist/src/lib/hosting-client.d.ts +167 -0
  308. package/dist/src/lib/hosting-client.js +340 -0
  309. package/dist/src/lib/hosting-client.js.map +1 -0
  310. package/dist/src/lib/hosting-environments.d.ts +32 -0
  311. package/dist/src/lib/hosting-environments.js +74 -0
  312. package/dist/src/lib/hosting-environments.js.map +1 -0
  313. package/dist/src/lib/hosting-errors.d.ts +30 -0
  314. package/dist/src/lib/hosting-errors.js +43 -0
  315. package/dist/src/lib/hosting-errors.js.map +1 -0
  316. package/dist/src/lib/hosting-token.d.ts +46 -0
  317. package/dist/src/lib/hosting-token.js +60 -0
  318. package/dist/src/lib/hosting-token.js.map +1 -0
  319. package/dist/src/lib/hosting-wait.d.ts +42 -0
  320. package/dist/src/lib/hosting-wait.js +84 -0
  321. package/dist/src/lib/hosting-wait.js.map +1 -0
  322. package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
  323. package/dist/src/lib/hosting-wfp-upload.js +149 -0
  324. package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
  325. package/dist/src/lib/init-assets.d.ts +2 -6
  326. package/dist/src/lib/init-assets.js +11 -27
  327. package/dist/src/lib/init-assets.js.map +1 -1
  328. package/dist/src/lib/init-ios-links.d.ts +11 -7
  329. package/dist/src/lib/init-ios-links.js +28 -22
  330. package/dist/src/lib/init-ios-links.js.map +1 -1
  331. package/dist/src/lib/init-login-note.d.ts +13 -0
  332. package/dist/src/lib/init-login-note.js +22 -0
  333. package/dist/src/lib/init-login-note.js.map +1 -0
  334. package/dist/src/lib/init-schema.d.ts +15 -0
  335. package/dist/src/lib/init-schema.js +54 -0
  336. package/dist/src/lib/init-schema.js.map +1 -1
  337. package/dist/src/lib/integration-test-request.d.ts +54 -0
  338. package/dist/src/lib/integration-test-request.js +207 -0
  339. package/dist/src/lib/integration-test-request.js.map +1 -0
  340. package/dist/src/lib/invoker-shared-enums.d.ts +35 -0
  341. package/dist/src/lib/invoker-shared-enums.js +98 -0
  342. package/dist/src/lib/invoker-shared-enums.js.map +1 -0
  343. package/dist/src/lib/json-value.d.ts +6 -0
  344. package/dist/src/lib/json-value.js +13 -0
  345. package/dist/src/lib/json-value.js.map +1 -0
  346. package/dist/src/lib/load-routes.d.ts +33 -0
  347. package/dist/src/lib/load-routes.js +35 -0
  348. package/dist/src/lib/load-routes.js.map +1 -0
  349. package/dist/src/lib/log-inspection.d.ts +23 -4
  350. package/dist/src/lib/log-inspection.js +14 -5
  351. package/dist/src/lib/log-inspection.js.map +1 -1
  352. package/dist/src/lib/login-exchange-check.d.ts +18 -0
  353. package/dist/src/lib/login-exchange-check.js +27 -0
  354. package/dist/src/lib/login-exchange-check.js.map +1 -0
  355. package/dist/src/lib/login-scope-lines.d.ts +17 -7
  356. package/dist/src/lib/login-scope-lines.js +33 -10
  357. package/dist/src/lib/login-scope-lines.js.map +1 -1
  358. package/dist/src/lib/metadata-report.d.ts +85 -0
  359. package/dist/src/lib/metadata-report.js +81 -0
  360. package/dist/src/lib/metadata-report.js.map +1 -0
  361. package/dist/src/lib/object-status-filter.d.ts +9 -1
  362. package/dist/src/lib/object-status-filter.js +9 -1
  363. package/dist/src/lib/object-status-filter.js.map +1 -1
  364. package/dist/src/lib/output.d.ts +1 -1
  365. package/dist/src/lib/output.js +3 -1
  366. package/dist/src/lib/output.js.map +1 -1
  367. package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
  368. package/dist/src/lib/pin-refusal-hint.js +35 -0
  369. package/dist/src/lib/pin-refusal-hint.js.map +1 -0
  370. package/dist/src/lib/platform-owned.js +5 -0
  371. package/dist/src/lib/platform-owned.js.map +1 -1
  372. package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
  373. package/dist/src/lib/primitive-declaration-names.js +22 -0
  374. package/dist/src/lib/primitive-declaration-names.js.map +1 -0
  375. package/dist/src/lib/primitive-declaration.d.ts +174 -0
  376. package/dist/src/lib/primitive-declaration.js +792 -0
  377. package/dist/src/lib/primitive-declaration.js.map +1 -0
  378. package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
  379. package/dist/src/lib/primitive-env-plugin.js +408 -0
  380. package/dist/src/lib/primitive-env-plugin.js.map +1 -0
  381. package/dist/src/lib/project-login-apps.d.ts +8 -0
  382. package/dist/src/lib/project-login-apps.js +27 -0
  383. package/dist/src/lib/project-login-apps.js.map +1 -0
  384. package/dist/src/lib/prompt-schema-codegen.d.ts +46 -15
  385. package/dist/src/lib/prompt-schema-codegen.js +142 -108
  386. package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
  387. package/dist/src/lib/prompt-schema-document.d.ts +35 -0
  388. package/dist/src/lib/prompt-schema-document.js +92 -0
  389. package/dist/src/lib/prompt-schema-document.js.map +1 -0
  390. package/dist/src/lib/prompt-schema-refs.d.ts +173 -0
  391. package/dist/src/lib/prompt-schema-refs.js +478 -0
  392. package/dist/src/lib/prompt-schema-refs.js.map +1 -0
  393. package/dist/src/lib/records-verbs.d.ts +79 -0
  394. package/dist/src/lib/records-verbs.js +45 -0
  395. package/dist/src/lib/records-verbs.js.map +1 -0
  396. package/dist/src/lib/register-commands.d.ts +36 -0
  397. package/dist/src/lib/register-commands.js +37 -0
  398. package/dist/src/lib/register-commands.js.map +1 -0
  399. package/dist/src/lib/retired-imports.d.ts +53 -0
  400. package/dist/src/lib/retired-imports.js +120 -0
  401. package/dist/src/lib/retired-imports.js.map +1 -0
  402. package/dist/src/lib/run-status.d.ts +1 -1
  403. package/dist/src/lib/run-status.generated.d.ts +2 -2
  404. package/dist/src/lib/run-status.generated.js +3 -1
  405. package/dist/src/lib/run-status.generated.js.map +1 -1
  406. package/dist/src/lib/run-status.js +1 -1
  407. package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
  408. package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
  409. package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
  410. package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
  411. package/dist/src/lib/schema-codegen/generated-db3-bridge.js +227 -0
  412. package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
  413. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
  414. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
  415. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
  416. package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +218 -0
  417. package/dist/src/lib/schema-codegen/generated-field-grammar.js +397 -0
  418. package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
  419. package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
  420. package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
  421. package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
  422. package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
  423. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
  424. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
  425. package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +258 -0
  426. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
  427. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
  428. package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
  429. package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
  430. package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
  431. package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
  432. package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
  433. package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
  434. package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
  435. package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
  436. package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
  437. package/dist/src/lib/schema-codegen/generated-schema-shape.d.ts +27 -0
  438. package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
  439. package/dist/src/lib/schema-codegen/generated-schema-shape.js.map +1 -0
  440. package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
  441. package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
  442. package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
  443. package/dist/src/lib/schema-codegen/naming.d.ts +35 -0
  444. package/dist/src/lib/schema-codegen/naming.js +83 -0
  445. package/dist/src/lib/schema-codegen/naming.js.map +1 -0
  446. package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
  447. package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
  448. package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
  449. package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
  450. package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
  451. package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
  452. package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
  453. package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
  454. package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
  455. package/dist/src/lib/schema-codegen/schemaToTs.d.ts +109 -0
  456. package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
  457. package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
  458. package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
  459. package/dist/src/lib/schema-codegen/valuesLists.js +144 -0
  460. package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
  461. package/dist/src/lib/schema-family-index.d.ts +228 -0
  462. package/dist/src/lib/schema-family-index.js +813 -0
  463. package/dist/src/lib/schema-family-index.js.map +1 -0
  464. package/dist/src/lib/schema-pins.d.ts +82 -0
  465. package/dist/src/lib/schema-pins.js +198 -0
  466. package/dist/src/lib/schema-pins.js.map +1 -0
  467. package/dist/src/lib/schema-preview.d.ts +244 -0
  468. package/dist/src/lib/schema-preview.js +498 -0
  469. package/dist/src/lib/schema-preview.js.map +1 -0
  470. package/dist/src/lib/scope-request.d.ts +23 -11
  471. package/dist/src/lib/scope-request.js +69 -31
  472. package/dist/src/lib/scope-request.js.map +1 -1
  473. package/dist/src/lib/session-scope.d.ts +26 -0
  474. package/dist/src/lib/session-scope.js +58 -0
  475. package/dist/src/lib/session-scope.js.map +1 -0
  476. package/dist/src/lib/skill-installer.d.ts +2 -2
  477. package/dist/src/lib/skill-installer.js +2 -21
  478. package/dist/src/lib/skill-installer.js.map +1 -1
  479. package/dist/src/lib/step-run-table.d.ts +1 -2
  480. package/dist/src/lib/step-run-table.js +1 -2
  481. package/dist/src/lib/step-run-table.js.map +1 -1
  482. package/dist/src/lib/swift-codegen/agentGenerator.d.ts +8 -3
  483. package/dist/src/lib/swift-codegen/agentGenerator.js +76 -22
  484. package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
  485. package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
  486. package/dist/src/lib/swift-codegen/banners.js +12 -0
  487. package/dist/src/lib/swift-codegen/banners.js.map +1 -1
  488. package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
  489. package/dist/src/lib/swift-codegen/functionGenerator.js +169 -51
  490. package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
  491. package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
  492. package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
  493. package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
  494. package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +45 -0
  495. package/dist/src/lib/swift-codegen/sharedGenerator.js +165 -0
  496. package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
  497. package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
  498. package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
  499. package/dist/src/lib/swift-codegen/swiftKeys.js.map +1 -0
  500. package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
  501. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
  502. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
  503. package/dist/src/lib/sync-resource-types.d.ts +117 -31
  504. package/dist/src/lib/sync-resource-types.js +197 -189
  505. package/dist/src/lib/sync-resource-types.js.map +1 -1
  506. package/dist/src/lib/sync-selectors.d.ts +7 -0
  507. package/dist/src/lib/sync-selectors.js +22 -2
  508. package/dist/src/lib/sync-selectors.js.map +1 -1
  509. package/dist/src/lib/template.d.ts +39 -3
  510. package/dist/src/lib/template.js +103 -14
  511. package/dist/src/lib/template.js.map +1 -1
  512. package/dist/src/lib/test-case-file-names.d.ts +3 -5
  513. package/dist/src/lib/test-case-file-names.js +3 -5
  514. package/dist/src/lib/test-case-file-names.js.map +1 -1
  515. package/dist/src/lib/test-runs.d.ts +45 -0
  516. package/dist/src/lib/test-runs.js +150 -0
  517. package/dist/src/lib/test-runs.js.map +1 -0
  518. package/dist/src/lib/test-users.d.ts +25 -0
  519. package/dist/src/lib/test-users.js +36 -0
  520. package/dist/src/lib/test-users.js.map +1 -0
  521. package/dist/src/lib/toml-database-config.d.ts +4 -2
  522. package/dist/src/lib/toml-database-config.js +11 -6
  523. package/dist/src/lib/toml-database-config.js.map +1 -1
  524. package/dist/src/lib/toml-scalar-edit.js +6 -4
  525. package/dist/src/lib/toml-scalar-edit.js.map +1 -1
  526. package/dist/src/lib/transition-warnings.d.ts +21 -0
  527. package/dist/src/lib/transition-warnings.js +49 -0
  528. package/dist/src/lib/transition-warnings.js.map +1 -0
  529. package/dist/src/lib/user-index.d.ts +80 -0
  530. package/dist/src/lib/user-index.js +166 -0
  531. package/dist/src/lib/user-index.js.map +1 -0
  532. package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
  533. package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
  534. package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
  535. package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
  536. package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
  537. package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
  538. package/dist/src/lib/user-walk.d.ts +31 -0
  539. package/dist/src/lib/user-walk.js +102 -0
  540. package/dist/src/lib/user-walk.js.map +1 -0
  541. package/dist/src/lib/webhook-capture.d.ts +43 -0
  542. package/dist/src/lib/webhook-capture.js +91 -0
  543. package/dist/src/lib/webhook-capture.js.map +1 -0
  544. package/dist/src/lib/webhook-deliver.d.ts +18 -20
  545. package/dist/src/lib/webhook-deliver.js +34 -89
  546. package/dist/src/lib/webhook-deliver.js.map +1 -1
  547. package/dist/src/lib/webhook-test-run.d.ts +32 -0
  548. package/dist/src/lib/webhook-test-run.js +108 -0
  549. package/dist/src/lib/webhook-test-run.js.map +1 -0
  550. package/dist/src/lib/worker-perf-format.d.ts +22 -0
  551. package/dist/src/lib/worker-perf-format.js +27 -0
  552. package/dist/src/lib/worker-perf-format.js.map +1 -0
  553. package/dist/src/lib/workflow-field-descriptor.d.ts +91 -0
  554. package/dist/src/lib/workflow-field-descriptor.js +153 -0
  555. package/dist/src/lib/workflow-field-descriptor.js.map +1 -0
  556. package/dist/src/types/index.d.ts +20 -65
  557. package/dist/src/validators.d.ts +7 -55
  558. package/dist/src/validators.js +7 -53
  559. package/dist/src/validators.js.map +1 -1
  560. package/dist/src/vite.d.ts +17 -0
  561. package/dist/src/vite.js +18 -0
  562. package/dist/src/vite.js.map +1 -0
  563. package/package.json +20 -9
@@ -0,0 +1,224 @@
1
+ /**
2
+ * The model records of a database or db3 type's TOML, as the generated
3
+ * declarations type them (#3182, #4803; moved here by #5544 so the
4
+ * database declaration and `primitive.d.ts`'s `Db3` namespace read one
5
+ * rendering).
6
+ *
7
+ * Each model's members come from the `describeDbType` IR the client
8
+ * generators share: its declared fields, then the stamps the type applies.
9
+ * `timestamps` is how a type's create and update stamps render (#5024): the
10
+ * database declaration keeps them optional strings, as it always has; the db3
11
+ * one makes them required on every model in the timestamps' scope, because a
12
+ * db3 room writes them on every create and write there — epoch milliseconds,
13
+ * so `number` unless the model declares the field — and leaves them off every
14
+ * model outside it, which the room never stamps (#5206).
15
+ */
16
+ import { existsSync, readdirSync, readFileSync } from "fs";
17
+ import { basename, join } from "path";
18
+ import { parseConfigToml, stringifyConfigToml } from "./config-toml.js";
19
+ import { resolveDb3TypeModels } from "./db3-type-models.js";
20
+ import { describeDbType } from "./db-codegen/dbTypeIR.js";
21
+ import { tsTypeForDbFieldType } from "./db-codegen/dbTsTypes.js";
22
+ import { objectPropertyKey } from "./db-codegen/dbNaming.js";
23
+ import { DB3_FIELD_KINDS } from "./schema-codegen/generated-db3-query-capabilities.js";
24
+ /** A TOML field `type` as a db3 field kind, or undefined for one the capability manifest does not name. */
25
+ export function db3FieldKindOf(type) {
26
+ return DB3_FIELD_KINDS.includes(type) ? type : undefined;
27
+ }
28
+ function quote(value) {
29
+ return JSON.stringify(value);
30
+ }
31
+ /**
32
+ * A model or field name as a TYPE member key.
33
+ *
34
+ * Model and field names are whatever the TOML says — js-bao preserves them
35
+ * verbatim — so `Order-Item` and `first-name` are ordinary schemas and are not
36
+ * TypeScript identifiers. Emitting one raw makes the whole declaration a syntax
37
+ * error, which breaks the editor and `tsc` wiring for every OTHER type in the
38
+ * tree too. The client generators' own `objectPropertyKey` answers this,
39
+ * except that its `__proto__` case is a computed key — legal in an object
40
+ * literal, not in a type member — so that one is quoted instead.
41
+ */
42
+ export function memberKey(name) {
43
+ const key = objectPropertyKey(name);
44
+ return key.startsWith("[") ? quote(name) : key;
45
+ }
46
+ /**
47
+ * A vector field's member comment (#5225): its encoding, and how a function
48
+ * turns its stored base64 into numbers and back.
49
+ */
50
+ function vectorComment(vector) {
51
+ return `A vector of ${vector.dims} × ${vector.element}, read and written as its stored base64: encodeVector and decodeVector from primitive-functions convert numbers to it and back.`;
52
+ }
53
+ /** A member as the database declaration writes it: `name?: type;`, an enum as its string-literal union. */
54
+ function memberLine(member) {
55
+ const type = member.enum ? member.enum.map((v) => quote(v)).join(" | ") : member.type;
56
+ return `${memberKey(member.name)}${member.optional ? "?" : ""}: ${type};`;
57
+ }
58
+ /**
59
+ * Every model of one type, sorted by name, with its members; an empty list
60
+ * for a type this renderer cannot describe, which contributes no models
61
+ * rather than failing the push: its own preflight reports the file, and an
62
+ * untyped handle is what a schemaless type gets anyway.
63
+ */
64
+ export function dbTypeRecords(source, timestamps) {
65
+ try {
66
+ const ir = describeDbType({
67
+ databaseType: source.key,
68
+ tomlPath: source.tomlPath,
69
+ tomlContent: source.tomlContent,
70
+ table: source.table,
71
+ });
72
+ return [...ir.records]
73
+ .sort((a, b) => (a.modelName < b.modelName ? -1 : 1))
74
+ .map((record) => {
75
+ const required = requiredStamps(ir.timestamps, record.modelName, timestamps);
76
+ const unstamped = unstampedFields(ir, record.modelName, timestamps);
77
+ const declared = new Set();
78
+ const members = [];
79
+ for (const field of record.fields) {
80
+ declared.add(field.name);
81
+ const enumValues = field.type === "string" && Array.isArray(field.enum) && field.enum.length > 0 ? field.enum : undefined;
82
+ const kind = db3FieldKindOf(field.type);
83
+ members.push({
84
+ name: field.name,
85
+ optional: !(field.required || required.has(field.name)),
86
+ type: tsTypeForDbFieldType(field.type),
87
+ ...(enumValues ? { enum: enumValues } : {}),
88
+ ...(field.vector ? { comment: vectorComment(field.vector) } : {}),
89
+ ...(kind ? { kind } : {}),
90
+ });
91
+ }
92
+ // Server-stamped fields exist on a read row but not on one a
93
+ // function just built, so they are optional — the same call the
94
+ // client renderer makes — except a db3 type's timestamps, which
95
+ // every row in scope carries. Writes take the SDK's write type,
96
+ // which leaves every field optional.
97
+ for (const stamped of [...ir.stampedFields].sort()) {
98
+ if (declared.has(stamped) || unstamped.has(stamped))
99
+ continue;
100
+ declared.add(stamped);
101
+ members.push(required.has(stamped)
102
+ ? { name: stamped, optional: false, type: "number", kind: "number" }
103
+ : { name: stamped, optional: true, type: "string", kind: "string" });
104
+ }
105
+ const uniqueNames = [
106
+ ...new Set([...record.fields.filter((field) => field.unique).map((field) => field.name), ...(record.uniqueConstraints ?? []).map((c) => c.name)]),
107
+ ];
108
+ return { modelName: record.modelName, members, uniqueNames };
109
+ });
110
+ }
111
+ catch {
112
+ return [];
113
+ }
114
+ }
115
+ /**
116
+ * One interface member per type, already sorted by the caller, each model's
117
+ * fields inline: the database declaration's map.
118
+ */
119
+ export function typeEntries(types, timestamps) {
120
+ const lines = [];
121
+ for (const source of types) {
122
+ const records = dbTypeRecords(source, timestamps);
123
+ if (records.length === 0) {
124
+ lines.push(` ${quote(source.key)}: {};`);
125
+ continue;
126
+ }
127
+ lines.push(` ${quote(source.key)}: {`);
128
+ for (const record of records) {
129
+ if (record.members.length === 0) {
130
+ lines.push(` ${memberKey(record.modelName)}: Record<string, unknown>;`);
131
+ continue;
132
+ }
133
+ lines.push(` ${memberKey(record.modelName)}: {`);
134
+ for (const member of record.members) {
135
+ if (member.comment)
136
+ lines.push(` /** ${member.comment} */`);
137
+ lines.push(` ${memberLine(member)}`);
138
+ }
139
+ lines.push(` };`);
140
+ }
141
+ lines.push(` };`);
142
+ }
143
+ return lines;
144
+ }
145
+ /** The stamp names a model's read rows always carry under this rendering. */
146
+ function requiredStamps(stamps, modelName, timestamps) {
147
+ if (timestamps === "optional")
148
+ return new Set();
149
+ if (!inTimestampsScope(stamps, modelName))
150
+ return new Set();
151
+ return timestampNames(stamps);
152
+ }
153
+ /**
154
+ * The stamp names a model's rows never carry under this rendering (#5206): a
155
+ * db3 type's timestamps on a model outside `timestamps.models`, unless the
156
+ * type also auto-populates the field, which it does on every model.
157
+ */
158
+ function unstampedFields(ir, modelName, timestamps) {
159
+ if (timestamps === "optional" || inTimestampsScope(ir.timestamps, modelName))
160
+ return new Set();
161
+ const autoPopulated = new Set(ir.autoPopulatedFields);
162
+ return new Set([...timestampNames(ir.timestamps)].filter((name) => !autoPopulated.has(name)));
163
+ }
164
+ /** Whether the room stamps `modelName`: every model unless `models` lists them. */
165
+ function inTimestampsScope(stamps, modelName) {
166
+ return stamps.models === null || stamps.models.includes(modelName);
167
+ }
168
+ function timestampNames(stamps) {
169
+ return new Set([stamps.create, stamps.update].filter((name) => name !== null));
170
+ }
171
+ /**
172
+ * Every db3 type a config tree declares (#4803): `db3-types/*.toml` (named by
173
+ * `[type] name`, else the file name) and `database-type-configs/*.toml` (named
174
+ * by `[type] databaseType`, else the file name), one namespace with one entry
175
+ * per name. A `db3-types/` file naming models declared in another file of the
176
+ * directory (`[type] models`) is read with them, resolved (#5025). A name both
177
+ * directories hold is read from its `db3-types/` file:
178
+ * `config push` refuses a pair that differ before anything is written, so the
179
+ * two agree whenever this runs on a pushable tree.
180
+ */
181
+ export function db3TypeSources(configDir) {
182
+ const byType = new Map();
183
+ // #5025 — a db3 type naming models declared in another file of its
184
+ // directory is typed with them: its content is the resolved document.
185
+ const resolved = resolveDb3TypeModels(join(configDir, "db3-types"));
186
+ const read = (directory, key) => {
187
+ const dir = join(configDir, directory);
188
+ if (!existsSync(dir))
189
+ return;
190
+ for (const file of readdirSync(dir).filter((f) => f.endsWith(".toml")).sort()) {
191
+ const tomlPath = join(dir, file);
192
+ let tomlContent;
193
+ try {
194
+ tomlContent = readFileSync(tomlPath, "utf-8");
195
+ }
196
+ catch {
197
+ continue;
198
+ }
199
+ let declared = null;
200
+ try {
201
+ const parsed = parseConfigToml(tomlContent);
202
+ if (parsed?.type?.[key])
203
+ declared = String(parsed.type[key]);
204
+ }
205
+ catch {
206
+ // Its own preflight reports a file that does not parse.
207
+ }
208
+ const type = declared || basename(file, ".toml");
209
+ if (directory === "db3-types" && resolved.referencing.has(file)) {
210
+ const document = resolved.documents.get(file);
211
+ if (document)
212
+ tomlContent = stringifyConfigToml(document);
213
+ }
214
+ if (byType.has(type))
215
+ continue;
216
+ const enumRefs = directory === "db3-types" ? resolved.enumRefs.get(file) : undefined;
217
+ byType.set(type, enumRefs ? { type, tomlPath, tomlContent, directory, enumRefs } : { type, tomlPath, tomlContent, directory });
218
+ }
219
+ };
220
+ read("db3-types", "name");
221
+ read("database-type-configs", "databaseType");
222
+ return [...byType.values()];
223
+ }
224
+ //# sourceMappingURL=db-type-records.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"db-type-records.js","sourceRoot":"","sources":["../../../src/lib/db-type-records.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,287 @@
1
+ /**
2
+ * `primitive db3 export` and `primitive db3 import` (#4889): a db3 written
3
+ * to a directory, and a directory loaded into a db3.
4
+ *
5
+ * An export is a directory holding `db3.json` (the manifest: the db3's id,
6
+ * title and tags, its type by name and revision, its declaration as
7
+ * `GET db3/:id/schema` answers it, the indexes registered through the index
8
+ * routes, the log number the rows are at), the rows under `snapshot/` and
9
+ * `chain.json` as `documents export` writes a record-log document's, and
10
+ * the blobs under `blobs/`. It carries no grant, custody, sync state or alias:
11
+ * those belong to the app the db3 lives in.
12
+ *
13
+ * An import does every check before any write: the manifest's type must be
14
+ * one the app has, with an equal declaration (or `--untyped`); a `--into`
15
+ * target must be of the manifest's type and declare its models alike; and
16
+ * blobs are imported under their ids, so the source db3 must be gone from the
17
+ * app first. Then it creates the db3 (or confirms `--into`), registers the
18
+ * indexes an untyped target needs before any row, loads the rows through the
19
+ * db3's bulk-load session and uploads the blobs.
20
+ *
21
+ * The planner (`planDb3Import`) and the comparison (`compareDeclarations`)
22
+ * are pure; the verbs in `../commands/db3.ts` read what they need and drive
23
+ * the steps.
24
+ */
25
+ import type { ApiClient, Db3IndexKind, Db3IndexPlacement, Db3TextIndexOptions } from "./api-client.js";
26
+ import { type IngestOutcome } from "./document-ingest.js";
27
+ /** The manifest file an export writes and an import reads. */
28
+ export declare const DB3_MANIFEST = "db3.json";
29
+ /** One model's declaration: its fields' options and its compound unique constraints by name. */
30
+ export interface Db3ModelDeclaration {
31
+ fields: Record<string, Record<string, unknown>>;
32
+ constraints?: Record<string, {
33
+ type: "unique";
34
+ fields: string[];
35
+ }>;
36
+ }
37
+ /** What a db3 declares, model by model. */
38
+ export interface Db3Declaration {
39
+ models: Record<string, Db3ModelDeclaration>;
40
+ }
41
+ /** An index registered through `POST db3/:id/indexes`, as `GET db3/:id/indexes` lists it. */
42
+ export interface Db3RegisteredIndex {
43
+ name: string;
44
+ model: string;
45
+ fields: string[];
46
+ unique: boolean;
47
+ /** `true` for a string-set field's member index; absent on any other. */
48
+ members?: true;
49
+ /** What the index is (#5220); absent in an export written before it. */
50
+ kind?: Db3IndexKind;
51
+ /** Where the index lives (#5220); absent in an export written before it. */
52
+ on?: Db3IndexPlacement;
53
+ /** A text index's options (#5222); absent on any other kind, and in an export written before it. */
54
+ text?: Db3TextIndexOptions;
55
+ }
56
+ /** `db3.json`. */
57
+ export interface Db3ExportManifest {
58
+ kind: "db3-export";
59
+ version: 1;
60
+ id: string;
61
+ title: string | null;
62
+ tags: string[];
63
+ type: {
64
+ name: string;
65
+ revision: {
66
+ generation: number;
67
+ hash: string;
68
+ } | null;
69
+ } | null;
70
+ declaration: Db3Declaration;
71
+ indexes: Db3RegisteredIndex[];
72
+ lsn: number;
73
+ exportedAt: string;
74
+ }
75
+ /** A blob as `blobs/index.json` lists it. */
76
+ export interface Db3ExportedBlob {
77
+ blobId: string;
78
+ filename: string;
79
+ contentType: string;
80
+ sha256: string;
81
+ numBytes: number;
82
+ }
83
+ /** Where and as what an index is registered (#5220): given only when the export recorded it. */
84
+ type Placed = {
85
+ kind?: Db3IndexKind;
86
+ on?: Db3IndexPlacement;
87
+ };
88
+ /** One `POST db3/:id/indexes` body. */
89
+ export type Db3IndexRegistration = ({
90
+ model: string;
91
+ field: string;
92
+ unique?: true;
93
+ } & Placed) | ({
94
+ model: string;
95
+ fields: string[];
96
+ name: string;
97
+ unique: true;
98
+ } & Placed) | ({
99
+ model: string;
100
+ field: string;
101
+ members: true;
102
+ } & Placed) | Db3TextIndexRegistration;
103
+ /** A text index's `POST db3/:id/indexes` body (#5222): no name and no unique, its options as exported. */
104
+ export type Db3TextIndexRegistration = ({
105
+ model: string;
106
+ field: string;
107
+ } | {
108
+ model: string;
109
+ fields: string[];
110
+ }) & {
111
+ kind: "text";
112
+ on?: Db3IndexPlacement;
113
+ text?: Db3TextIndexOptions;
114
+ };
115
+ /**
116
+ * The indexes an export records, out of the db3's index list: each one a
117
+ * registration keeps, with the registration's own uniqueness (a
118
+ * declaration's unique on the same index is the declaration's),
119
+ * `members: true` on a member index, its `kind` and `on` as the list
120
+ * gives them (#5220), and a text index's options (#5222).
121
+ */
122
+ export declare function exportedIndexesOf(listed: readonly any[]): Db3RegisteredIndex[];
123
+ /**
124
+ * The declaration `GET db3/:id/schema` answers. The answer gives a declared
125
+ * model with no fields and a live undeclared model alike, `{ fields: {} }`,
126
+ * so such a model is kept only when `declaredModels` names it: the models a
127
+ * typed db3's type declares ({@link declaredModelNames}). A type that
128
+ * declares no models holds any model undeclared, and an untyped db3
129
+ * declares none.
130
+ */
131
+ export declare function declarationOfSchemaAnswer(answer: any, options?: {
132
+ declaredModels?: Iterable<string>;
133
+ }): Db3Declaration;
134
+ /** The models a db3 type's schema TOML declares, by name. */
135
+ export declare function declaredModelNames(schema: unknown): string[];
136
+ /** The declaration a db3 type's schema TOML installs (`GET db3-types/:name`'s `schema`). */
137
+ export declare function declarationOfTypeSchema(schema: unknown): Db3Declaration;
138
+ /**
139
+ * The differences between the declaration an export holds and the one a
140
+ * type or a target installs, one line per model, field or constraint; none
141
+ * when they are equal. Order is ignored: of models, fields, constraints and
142
+ * a constraint's fields. A field compares by its kind and its `indexed` and
143
+ * `unique` flags. With `only: "installed"`, only the models `installed`
144
+ * declares are compared (an `--untyped` import into a target that already
145
+ * declares some of them).
146
+ */
147
+ export declare function compareDeclarations(exported: Db3Declaration, installed: Db3Declaration, options?: {
148
+ only?: "installed";
149
+ installedName?: string;
150
+ }): string[];
151
+ /**
152
+ * The index registrations that install `declaration`'s indexes and uniques,
153
+ * and `indexes`, on an untyped db3: one per model and set of fields, unique
154
+ * when either source holds it unique (a registration over the same fields
155
+ * replaces the earlier one's uniqueness, so a later non-unique one would
156
+ * lift it), each compound name a valid identifier no other of the model's
157
+ * registrations takes. A member index wins its field over a declaration's
158
+ * field index, as the room keeps the member row and builds no index for the
159
+ * declaration (#5150); so does an index placed `server` or `device` over a
160
+ * declaration's field index, for the same reason (#5220). A text index
161
+ * stands beside any other kind over the same fields (#5222): it is keyed
162
+ * apart, keeps its fields' order, and is registered with no name or unique.
163
+ * So does a `vector` index (#5225).
164
+ */
165
+ export declare function registrationsFor(declaration: Db3Declaration, indexes?: Db3RegisteredIndex[]): Db3IndexRegistration[];
166
+ /** An index as `GET db3/:id/indexes` lists it. */
167
+ export interface Db3ListedIndex {
168
+ name: string;
169
+ model: string;
170
+ fields: string[];
171
+ unique: boolean;
172
+ /** `true` for a string-set field's member index. */
173
+ members?: boolean;
174
+ /** What the index is (#5220); a server from before it lists none. */
175
+ kind?: Db3IndexKind;
176
+ /** Where the index lives (#5220); a server from before it lists none. */
177
+ on?: Db3IndexPlacement;
178
+ }
179
+ /**
180
+ * `register` against the indexes a target already has: a registration an
181
+ * index of its kind over the same fields already serves, as unique or more,
182
+ * is left out (so an existing unique index is never registered again
183
+ * without `unique`, which would lift it, and a constraint the target holds
184
+ * is not registered a second time under another name); a named
185
+ * registration whose name the target gives an index over other fields is a
186
+ * conflict. A member index is served only by a member index on its field,
187
+ * and a field index only by a field index: a target holding the other kind
188
+ * on the field is a conflict. So is a holder of the same kind placed
189
+ * elsewhere (#5220): a placement changes only by drop and register. A
190
+ * registration is pending beside a holder only when their kinds may index
191
+ * the same fields side by side.
192
+ */
193
+ export declare function pendingRegistrations(register: Db3IndexRegistration[], existing: Db3ListedIndex[]): {
194
+ register: Db3IndexRegistration[];
195
+ kept: string[];
196
+ conflicts: string[];
197
+ };
198
+ /** What the import was asked. */
199
+ export interface Db3ImportFlags {
200
+ into?: string;
201
+ title?: string;
202
+ type?: string;
203
+ untyped?: boolean;
204
+ noBlobs?: boolean;
205
+ /** Create the new db3 under the export's id (`--keep-id`, #4921). */
206
+ keepId?: boolean;
207
+ }
208
+ /** What the import read before deciding: the type, the target, whether the source is still in the app. */
209
+ export interface Db3ImportFacts {
210
+ /** The type the import resolved (`--type`, else the manifest's), as `GET db3-types/:name` answered it; `null` when the app has none of that name. */
211
+ type?: {
212
+ name: string;
213
+ schema: unknown;
214
+ revision?: {
215
+ generation: number;
216
+ hash: string;
217
+ } | null;
218
+ } | null;
219
+ /** The `--into` target: its row, its declaration and the indexes it has. */
220
+ target?: {
221
+ row: any;
222
+ declaration: Db3Declaration;
223
+ indexes?: Db3ListedIndex[];
224
+ };
225
+ /** Blobs `blobs/index.json` lists. */
226
+ blobCount: number;
227
+ /** Whether `GET db3/<manifest.id>` found the source in the app; asked when blobs are imported or the id is kept. */
228
+ sourceExists?: boolean;
229
+ }
230
+ /** The import's decision: a refusal before any write, or its steps. */
231
+ export type Db3ImportPlan = {
232
+ ok: false;
233
+ refusal: string;
234
+ lines?: string[];
235
+ } | {
236
+ ok: true;
237
+ /** The type name the import resolved, or `null`. */
238
+ typeName: string | null;
239
+ /** `POST db3`'s body, or absent for `--into`; `id` is the export's under `--keep-id`. */
240
+ create?: {
241
+ title: string;
242
+ type?: string;
243
+ tags: string[];
244
+ id?: string;
245
+ };
246
+ into?: string;
247
+ /** Registered before the rows. */
248
+ register: Db3IndexRegistration[];
249
+ blobs: boolean;
250
+ /** Said beside the import, not judged (a hash that also covers hooks). */
251
+ notes: string[];
252
+ };
253
+ /** The type name an import resolves: `--type`, else the manifest's; none under `--untyped` without one. */
254
+ export declare function resolvedTypeName(manifest: Db3ExportManifest, flags: Db3ImportFlags): string | null;
255
+ /**
256
+ * Decide an import from what was read, before any write: a refusal naming
257
+ * what to do, or the steps.
258
+ */
259
+ export declare function planDb3Import(manifest: Db3ExportManifest, flags: Db3ImportFlags, facts: Db3ImportFacts): Db3ImportPlan;
260
+ /** Read `<dir>/db3.json`, or `null` when the directory has none. */
261
+ export declare function readDb3Manifest(dir: string): Db3ExportManifest | null;
262
+ /** The blobs `<dir>/blobs/index.json` lists; none without one. */
263
+ export declare function readExportedBlobs(dir: string): Db3ExportedBlob[];
264
+ /** What `db3 export` wrote. */
265
+ export interface Db3ExportResult {
266
+ manifest: Db3ExportManifest;
267
+ dir: string;
268
+ rows: number;
269
+ blobs: number;
270
+ }
271
+ /**
272
+ * Write db3 `db3Id` to `dir`: the rows (a segment export, as `documents
273
+ * export` writes a record-log document's), `chain.json`, the blobs unless
274
+ * `blobs` is false, and `db3.json` last, so a directory with a manifest is a
275
+ * finished export.
276
+ */
277
+ export declare function exportDb3(client: ApiClient, appId: string, db3Id: string, dir: string, options: {
278
+ blobs: boolean;
279
+ onProgress?: (line: string) => void;
280
+ }): Promise<Db3ExportResult>;
281
+ /**
282
+ * Load an export's rows into `db3Id` through its bulk-load session (merge,
283
+ * the epoch reserved at open), waited to a terminal state. Answers the
284
+ * session's outcome, or `null` when the export holds no rows.
285
+ */
286
+ export declare function loadDb3Rows(client: ApiClient, appId: string, db3Id: string, dir: string, onProgress: (line: string) => void): Promise<IngestOutcome | null>;
287
+ export {};