primitive-admin 1.2.0-alpha.9 → 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 (546) hide show
  1. package/README.md +258 -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 +138 -44
  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 +15 -0
  40. package/dist/src/commands/db3-types.js +159 -0
  41. package/dist/src/commands/db3-types.js.map +1 -0
  42. package/dist/src/commands/db3.d.ts +24 -0
  43. package/dist/src/commands/db3.js +1444 -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 +1012 -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 +376 -30
  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 +346 -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 +41 -0
  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.js +47 -3
  91. package/dist/src/commands/secrets.js.map +1 -1
  92. package/dist/src/commands/sessions.js +2 -0
  93. package/dist/src/commands/sessions.js.map +1 -1
  94. package/dist/src/commands/skill.js +2 -0
  95. package/dist/src/commands/skill.js.map +1 -1
  96. package/dist/src/commands/sync-schemas.d.ts +202 -0
  97. package/dist/src/commands/sync-schemas.js +629 -0
  98. package/dist/src/commands/sync-schemas.js.map +1 -0
  99. package/dist/src/commands/sync-user-properties.d.ts +118 -0
  100. package/dist/src/commands/sync-user-properties.js +276 -0
  101. package/dist/src/commands/sync-user-properties.js.map +1 -0
  102. package/dist/src/commands/sync.d.ts +518 -546
  103. package/dist/src/commands/sync.js +3010 -4877
  104. package/dist/src/commands/sync.js.map +1 -1
  105. package/dist/src/commands/tokens.js +5 -3
  106. package/dist/src/commands/tokens.js.map +1 -1
  107. package/dist/src/commands/transitions.d.ts +54 -0
  108. package/dist/src/commands/transitions.js +418 -0
  109. package/dist/src/commands/transitions.js.map +1 -0
  110. package/dist/src/commands/usage.d.ts +18 -0
  111. package/dist/src/commands/usage.js +343 -0
  112. package/dist/src/commands/usage.js.map +1 -0
  113. package/dist/src/commands/user-properties.d.ts +14 -0
  114. package/dist/src/commands/user-properties.js +79 -0
  115. package/dist/src/commands/user-properties.js.map +1 -0
  116. package/dist/src/commands/users.js +911 -18
  117. package/dist/src/commands/users.js.map +1 -1
  118. package/dist/src/commands/vars.js +2 -0
  119. package/dist/src/commands/vars.js.map +1 -1
  120. package/dist/src/commands/waitlist.js +39 -4
  121. package/dist/src/commands/waitlist.js.map +1 -1
  122. package/dist/src/commands/workflows.d.ts +5 -83
  123. package/dist/src/commands/workflows.js +57 -2282
  124. package/dist/src/commands/workflows.js.map +1 -1
  125. package/dist/src/lib/analytics-query.d.ts +58 -0
  126. package/dist/src/lib/analytics-query.js +134 -0
  127. package/dist/src/lib/analytics-query.js.map +1 -0
  128. package/dist/src/lib/api-client.d.ts +1818 -438
  129. package/dist/src/lib/api-client.js +965 -544
  130. package/dist/src/lib/api-client.js.map +1 -1
  131. package/dist/src/lib/app-settings-descriptor.d.ts +1 -1
  132. package/dist/src/lib/app-settings-descriptor.js +6 -0
  133. package/dist/src/lib/app-settings-descriptor.js.map +1 -1
  134. package/dist/src/lib/auth-fixtures.d.ts +44 -0
  135. package/dist/src/lib/auth-fixtures.js +61 -0
  136. package/dist/src/lib/auth-fixtures.js.map +1 -0
  137. package/dist/src/lib/auth-flow.d.ts +34 -1
  138. package/dist/src/lib/auth-flow.js +429 -13
  139. package/dist/src/lib/auth-flow.js.map +1 -1
  140. package/dist/src/lib/block-layout.d.ts +12 -23
  141. package/dist/src/lib/block-layout.js +26 -92
  142. package/dist/src/lib/block-layout.js.map +1 -1
  143. package/dist/src/lib/block-selector.d.ts +8 -14
  144. package/dist/src/lib/block-selector.js +8 -19
  145. package/dist/src/lib/block-selector.js.map +1 -1
  146. package/dist/src/lib/child-apps-local.d.ts +3 -1
  147. package/dist/src/lib/child-apps-local.js +9 -1
  148. package/dist/src/lib/child-apps-local.js.map +1 -1
  149. package/dist/src/lib/cli-manifest.d.ts +9 -0
  150. package/dist/src/lib/cli-manifest.js +10 -1
  151. package/dist/src/lib/cli-manifest.js.map +1 -1
  152. package/dist/src/lib/cli-version.d.ts +14 -0
  153. package/dist/src/lib/cli-version.js +38 -0
  154. package/dist/src/lib/cli-version.js.map +1 -0
  155. package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
  156. package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
  157. package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
  158. package/dist/src/lib/collection-export.d.ts +76 -15
  159. package/dist/src/lib/collection-export.js +116 -23
  160. package/dist/src/lib/collection-export.js.map +1 -1
  161. package/dist/src/lib/collection-principal.d.ts +22 -0
  162. package/dist/src/lib/collection-principal.js +35 -0
  163. package/dist/src/lib/collection-principal.js.map +1 -0
  164. package/dist/src/lib/command-groups.d.ts +30 -0
  165. package/dist/src/lib/command-groups.js +109 -0
  166. package/dist/src/lib/command-groups.js.map +1 -0
  167. package/dist/src/lib/command-status.d.ts +147 -0
  168. package/dist/src/lib/command-status.js +266 -0
  169. package/dist/src/lib/command-status.js.map +1 -0
  170. package/dist/src/lib/config-object-descriptor.d.ts +9 -22
  171. package/dist/src/lib/config-object-descriptor.js +107 -276
  172. package/dist/src/lib/config-object-descriptor.js.map +1 -1
  173. package/dist/src/lib/config-surface.d.ts +3 -7
  174. package/dist/src/lib/config-surface.js +9 -13
  175. package/dist/src/lib/config-surface.js.map +1 -1
  176. package/dist/src/lib/config-toml.d.ts +11 -2
  177. package/dist/src/lib/config-toml.js +25 -2
  178. package/dist/src/lib/config-toml.js.map +1 -1
  179. package/dist/src/lib/credentials-home.d.ts +7 -0
  180. package/dist/src/lib/credentials-home.js +45 -10
  181. package/dist/src/lib/credentials-home.js.map +1 -1
  182. package/dist/src/lib/credentials-lock.d.ts +14 -6
  183. package/dist/src/lib/credentials-lock.js +90 -10
  184. package/dist/src/lib/credentials-lock.js.map +1 -1
  185. package/dist/src/lib/credentials-store.d.ts +123 -70
  186. package/dist/src/lib/credentials-store.js +358 -113
  187. package/dist/src/lib/credentials-store.js.map +1 -1
  188. package/dist/src/lib/custodian.d.ts +8 -0
  189. package/dist/src/lib/custodian.js +18 -0
  190. package/dist/src/lib/custodian.js.map +1 -0
  191. package/dist/src/lib/data-input.d.ts +1 -1
  192. package/dist/src/lib/data-input.js +1 -1
  193. package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
  194. package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
  195. package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
  196. package/dist/src/lib/db-codegen/dbTypeIR.d.ts +38 -1
  197. package/dist/src/lib/db-codegen/dbTypeIR.js +29 -7
  198. package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
  199. package/dist/src/lib/db-type-records.d.ts +106 -0
  200. package/dist/src/lib/db-type-records.js +224 -0
  201. package/dist/src/lib/db-type-records.js.map +1 -0
  202. package/dist/src/lib/db3-export.d.ts +287 -0
  203. package/dist/src/lib/db3-export.js +647 -0
  204. package/dist/src/lib/db3-export.js.map +1 -0
  205. package/dist/src/lib/db3-index-output.d.ts +116 -0
  206. package/dist/src/lib/db3-index-output.js +223 -0
  207. package/dist/src/lib/db3-index-output.js.map +1 -0
  208. package/dist/src/lib/db3-type-models.d.ts +134 -0
  209. package/dist/src/lib/db3-type-models.js +452 -0
  210. package/dist/src/lib/db3-type-models.js.map +1 -0
  211. package/dist/src/lib/deprecation.d.ts +2 -2
  212. package/dist/src/lib/deprecation.js +2 -2
  213. package/dist/src/lib/document-ingest-artifact.d.ts +13 -0
  214. package/dist/src/lib/document-ingest-artifact.js +36 -6
  215. package/dist/src/lib/document-ingest-artifact.js.map +1 -1
  216. package/dist/src/lib/document-ingest-format2.d.ts +36 -0
  217. package/dist/src/lib/document-ingest-format2.js +78 -0
  218. package/dist/src/lib/document-ingest-format2.js.map +1 -0
  219. package/dist/src/lib/document-ingest-input.d.ts +9 -0
  220. package/dist/src/lib/document-ingest-input.js +28 -1
  221. package/dist/src/lib/document-ingest-input.js.map +1 -1
  222. package/dist/src/lib/document-ingest.d.ts +11 -1
  223. package/dist/src/lib/document-ingest.js +16 -0
  224. package/dist/src/lib/document-ingest.js.map +1 -1
  225. package/dist/src/lib/document-schema-rows.d.ts +42 -0
  226. package/dist/src/lib/document-schema-rows.js +53 -0
  227. package/dist/src/lib/document-schema-rows.js.map +1 -0
  228. package/dist/src/lib/experimental-apis.d.ts +36 -0
  229. package/dist/src/lib/experimental-apis.js +46 -0
  230. package/dist/src/lib/experimental-apis.js.map +1 -0
  231. package/dist/src/lib/file-attachment.d.ts +24 -0
  232. package/dist/src/lib/file-attachment.js +31 -0
  233. package/dist/src/lib/file-attachment.js.map +1 -0
  234. package/dist/src/lib/function-authorize-check.d.ts +142 -0
  235. package/dist/src/lib/function-authorize-check.js +311 -0
  236. package/dist/src/lib/function-authorize-check.js.map +1 -0
  237. package/dist/src/lib/function-authorize-view.d.ts +27 -0
  238. package/dist/src/lib/function-authorize-view.js +88 -0
  239. package/dist/src/lib/function-authorize-view.js.map +1 -0
  240. package/dist/src/lib/function-bundle.d.ts +27 -5
  241. package/dist/src/lib/function-bundle.js +142 -7
  242. package/dist/src/lib/function-bundle.js.map +1 -1
  243. package/dist/src/lib/function-collect.d.ts +90 -12
  244. package/dist/src/lib/function-collect.js +482 -12
  245. package/dist/src/lib/function-collect.js.map +1 -1
  246. package/dist/src/lib/function-db-types.d.ts +65 -11
  247. package/dist/src/lib/function-db-types.js +297 -157
  248. package/dist/src/lib/function-db-types.js.map +1 -1
  249. package/dist/src/lib/function-document-types.d.ts +19 -7
  250. package/dist/src/lib/function-document-types.js +24 -12
  251. package/dist/src/lib/function-document-types.js.map +1 -1
  252. package/dist/src/lib/function-lint.d.ts +57 -0
  253. package/dist/src/lib/function-lint.js +234 -0
  254. package/dist/src/lib/function-lint.js.map +1 -0
  255. package/dist/src/lib/function-log-row.js +21 -2
  256. package/dist/src/lib/function-log-row.js.map +1 -1
  257. package/dist/src/lib/function-run.d.ts +13 -21
  258. package/dist/src/lib/function-run.js +14 -27
  259. package/dist/src/lib/function-run.js.map +1 -1
  260. package/dist/src/lib/function-schema-codegen.d.ts +86 -22
  261. package/dist/src/lib/function-schema-codegen.js +194 -88
  262. package/dist/src/lib/function-schema-codegen.js.map +1 -1
  263. package/dist/src/lib/function-schema-refs.d.ts +98 -0
  264. package/dist/src/lib/function-schema-refs.js +177 -0
  265. package/dist/src/lib/function-schema-refs.js.map +1 -0
  266. package/dist/src/lib/function-sync.d.ts +109 -6
  267. package/dist/src/lib/function-sync.js +179 -26
  268. package/dist/src/lib/function-sync.js.map +1 -1
  269. package/dist/src/lib/function-trigger-listing.d.ts +11 -6
  270. package/dist/src/lib/function-trigger-listing.js +32 -11
  271. package/dist/src/lib/function-trigger-listing.js.map +1 -1
  272. package/dist/src/lib/function-typecheck.d.ts +52 -0
  273. package/dist/src/lib/function-typecheck.js +174 -54
  274. package/dist/src/lib/function-typecheck.js.map +1 -1
  275. package/dist/src/lib/function-versions.d.ts +2 -0
  276. package/dist/src/lib/function-versions.js +1 -0
  277. package/dist/src/lib/function-versions.js.map +1 -1
  278. package/dist/src/lib/generated-build-flags.d.ts +13 -0
  279. package/dist/src/lib/generated-build-flags.js +14 -0
  280. package/dist/src/lib/generated-build-flags.js.map +1 -0
  281. package/dist/src/lib/generated-command-status.d.ts +6 -0
  282. package/dist/src/lib/generated-command-status.js +469 -0
  283. package/dist/src/lib/generated-command-status.js.map +1 -0
  284. package/dist/src/lib/generated-config-surfaces.d.ts +538 -141
  285. package/dist/src/lib/generated-config-surfaces.js +1772 -1854
  286. package/dist/src/lib/generated-config-surfaces.js.map +1 -1
  287. package/dist/src/lib/generated-sdk-types.d.ts +1 -1
  288. package/dist/src/lib/generated-sdk-types.js +1 -1
  289. package/dist/src/lib/generated-sdk-types.js.map +1 -1
  290. package/dist/src/lib/hosting-build.d.ts +97 -0
  291. package/dist/src/lib/hosting-build.js +204 -0
  292. package/dist/src/lib/hosting-build.js.map +1 -0
  293. package/dist/src/lib/hosting-client.d.ts +167 -0
  294. package/dist/src/lib/hosting-client.js +340 -0
  295. package/dist/src/lib/hosting-client.js.map +1 -0
  296. package/dist/src/lib/hosting-environments.d.ts +32 -0
  297. package/dist/src/lib/hosting-environments.js +74 -0
  298. package/dist/src/lib/hosting-environments.js.map +1 -0
  299. package/dist/src/lib/hosting-errors.d.ts +30 -0
  300. package/dist/src/lib/hosting-errors.js +43 -0
  301. package/dist/src/lib/hosting-errors.js.map +1 -0
  302. package/dist/src/lib/hosting-token.d.ts +46 -0
  303. package/dist/src/lib/hosting-token.js +60 -0
  304. package/dist/src/lib/hosting-token.js.map +1 -0
  305. package/dist/src/lib/hosting-wait.d.ts +42 -0
  306. package/dist/src/lib/hosting-wait.js +84 -0
  307. package/dist/src/lib/hosting-wait.js.map +1 -0
  308. package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
  309. package/dist/src/lib/hosting-wfp-upload.js +149 -0
  310. package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
  311. package/dist/src/lib/init-assets.d.ts +2 -6
  312. package/dist/src/lib/init-assets.js +11 -27
  313. package/dist/src/lib/init-assets.js.map +1 -1
  314. package/dist/src/lib/init-ios-links.d.ts +11 -7
  315. package/dist/src/lib/init-ios-links.js +28 -22
  316. package/dist/src/lib/init-ios-links.js.map +1 -1
  317. package/dist/src/lib/init-login-note.d.ts +13 -0
  318. package/dist/src/lib/init-login-note.js +22 -0
  319. package/dist/src/lib/init-login-note.js.map +1 -0
  320. package/dist/src/lib/init-schema.d.ts +15 -0
  321. package/dist/src/lib/init-schema.js +54 -0
  322. package/dist/src/lib/init-schema.js.map +1 -1
  323. package/dist/src/lib/integration-test-request.d.ts +54 -0
  324. package/dist/src/lib/integration-test-request.js +207 -0
  325. package/dist/src/lib/integration-test-request.js.map +1 -0
  326. package/dist/src/lib/invoker-shared-enums.d.ts +35 -0
  327. package/dist/src/lib/invoker-shared-enums.js +98 -0
  328. package/dist/src/lib/invoker-shared-enums.js.map +1 -0
  329. package/dist/src/lib/json-value.d.ts +6 -0
  330. package/dist/src/lib/json-value.js +13 -0
  331. package/dist/src/lib/json-value.js.map +1 -0
  332. package/dist/src/lib/load-routes.d.ts +33 -0
  333. package/dist/src/lib/load-routes.js +35 -0
  334. package/dist/src/lib/load-routes.js.map +1 -0
  335. package/dist/src/lib/log-inspection.d.ts +23 -4
  336. package/dist/src/lib/log-inspection.js +14 -5
  337. package/dist/src/lib/log-inspection.js.map +1 -1
  338. package/dist/src/lib/login-exchange-check.d.ts +18 -0
  339. package/dist/src/lib/login-exchange-check.js +27 -0
  340. package/dist/src/lib/login-exchange-check.js.map +1 -0
  341. package/dist/src/lib/login-scope-lines.d.ts +17 -7
  342. package/dist/src/lib/login-scope-lines.js +33 -10
  343. package/dist/src/lib/login-scope-lines.js.map +1 -1
  344. package/dist/src/lib/metadata-report.d.ts +85 -0
  345. package/dist/src/lib/metadata-report.js +81 -0
  346. package/dist/src/lib/metadata-report.js.map +1 -0
  347. package/dist/src/lib/object-status-filter.d.ts +9 -1
  348. package/dist/src/lib/object-status-filter.js +9 -1
  349. package/dist/src/lib/object-status-filter.js.map +1 -1
  350. package/dist/src/lib/output.d.ts +1 -1
  351. package/dist/src/lib/output.js +3 -1
  352. package/dist/src/lib/output.js.map +1 -1
  353. package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
  354. package/dist/src/lib/pin-refusal-hint.js +35 -0
  355. package/dist/src/lib/pin-refusal-hint.js.map +1 -0
  356. package/dist/src/lib/platform-owned.js +5 -0
  357. package/dist/src/lib/platform-owned.js.map +1 -1
  358. package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
  359. package/dist/src/lib/primitive-declaration-names.js +22 -0
  360. package/dist/src/lib/primitive-declaration-names.js.map +1 -0
  361. package/dist/src/lib/primitive-declaration.d.ts +174 -0
  362. package/dist/src/lib/primitive-declaration.js +792 -0
  363. package/dist/src/lib/primitive-declaration.js.map +1 -0
  364. package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
  365. package/dist/src/lib/primitive-env-plugin.js +408 -0
  366. package/dist/src/lib/primitive-env-plugin.js.map +1 -0
  367. package/dist/src/lib/project-login-apps.d.ts +8 -0
  368. package/dist/src/lib/project-login-apps.js +27 -0
  369. package/dist/src/lib/project-login-apps.js.map +1 -0
  370. package/dist/src/lib/prompt-schema-codegen.d.ts +36 -12
  371. package/dist/src/lib/prompt-schema-codegen.js +96 -100
  372. package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
  373. package/dist/src/lib/prompt-schema-document.d.ts +35 -0
  374. package/dist/src/lib/prompt-schema-document.js +92 -0
  375. package/dist/src/lib/prompt-schema-document.js.map +1 -0
  376. package/dist/src/lib/prompt-schema-refs.d.ts +173 -0
  377. package/dist/src/lib/prompt-schema-refs.js +478 -0
  378. package/dist/src/lib/prompt-schema-refs.js.map +1 -0
  379. package/dist/src/lib/records-verbs.d.ts +79 -0
  380. package/dist/src/lib/records-verbs.js +45 -0
  381. package/dist/src/lib/records-verbs.js.map +1 -0
  382. package/dist/src/lib/register-commands.d.ts +36 -0
  383. package/dist/src/lib/register-commands.js +37 -0
  384. package/dist/src/lib/register-commands.js.map +1 -0
  385. package/dist/src/lib/retired-imports.d.ts +53 -0
  386. package/dist/src/lib/retired-imports.js +120 -0
  387. package/dist/src/lib/retired-imports.js.map +1 -0
  388. package/dist/src/lib/run-status.d.ts +1 -1
  389. package/dist/src/lib/run-status.generated.d.ts +2 -2
  390. package/dist/src/lib/run-status.generated.js +3 -1
  391. package/dist/src/lib/run-status.generated.js.map +1 -1
  392. package/dist/src/lib/run-status.js +1 -1
  393. package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
  394. package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
  395. package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
  396. package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
  397. package/dist/src/lib/schema-codegen/generated-db3-bridge.js +227 -0
  398. package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
  399. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
  400. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
  401. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
  402. package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +218 -0
  403. package/dist/src/lib/schema-codegen/generated-field-grammar.js +397 -0
  404. package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
  405. package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
  406. package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
  407. package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
  408. package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
  409. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
  410. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
  411. package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +258 -0
  412. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
  413. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
  414. package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
  415. package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
  416. package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
  417. package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
  418. package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
  419. package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
  420. package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
  421. package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
  422. package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
  423. package/dist/src/lib/schema-codegen/generated-schema-shape.d.ts +27 -0
  424. package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
  425. package/dist/src/lib/schema-codegen/generated-schema-shape.js.map +1 -0
  426. package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
  427. package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
  428. package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
  429. package/dist/src/lib/schema-codegen/naming.d.ts +35 -0
  430. package/dist/src/lib/schema-codegen/naming.js +83 -0
  431. package/dist/src/lib/schema-codegen/naming.js.map +1 -0
  432. package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
  433. package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
  434. package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
  435. package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
  436. package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
  437. package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
  438. package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
  439. package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
  440. package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
  441. package/dist/src/lib/schema-codegen/schemaToTs.d.ts +109 -0
  442. package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
  443. package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
  444. package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
  445. package/dist/src/lib/schema-codegen/valuesLists.js +144 -0
  446. package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
  447. package/dist/src/lib/schema-family-index.d.ts +228 -0
  448. package/dist/src/lib/schema-family-index.js +813 -0
  449. package/dist/src/lib/schema-family-index.js.map +1 -0
  450. package/dist/src/lib/schema-pins.d.ts +82 -0
  451. package/dist/src/lib/schema-pins.js +198 -0
  452. package/dist/src/lib/schema-pins.js.map +1 -0
  453. package/dist/src/lib/schema-preview.d.ts +244 -0
  454. package/dist/src/lib/schema-preview.js +498 -0
  455. package/dist/src/lib/schema-preview.js.map +1 -0
  456. package/dist/src/lib/scope-request.d.ts +23 -11
  457. package/dist/src/lib/scope-request.js +69 -31
  458. package/dist/src/lib/scope-request.js.map +1 -1
  459. package/dist/src/lib/session-scope.d.ts +26 -0
  460. package/dist/src/lib/session-scope.js +58 -0
  461. package/dist/src/lib/session-scope.js.map +1 -0
  462. package/dist/src/lib/skill-installer.d.ts +2 -2
  463. package/dist/src/lib/skill-installer.js +2 -21
  464. package/dist/src/lib/skill-installer.js.map +1 -1
  465. package/dist/src/lib/step-run-table.d.ts +1 -2
  466. package/dist/src/lib/step-run-table.js +1 -2
  467. package/dist/src/lib/step-run-table.js.map +1 -1
  468. package/dist/src/lib/swift-codegen/agentGenerator.d.ts +2 -1
  469. package/dist/src/lib/swift-codegen/agentGenerator.js +25 -23
  470. package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
  471. package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
  472. package/dist/src/lib/swift-codegen/banners.js +12 -0
  473. package/dist/src/lib/swift-codegen/banners.js.map +1 -1
  474. package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
  475. package/dist/src/lib/swift-codegen/functionGenerator.js +169 -51
  476. package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
  477. package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
  478. package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
  479. package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
  480. package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +45 -0
  481. package/dist/src/lib/swift-codegen/sharedGenerator.js +165 -0
  482. package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
  483. package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
  484. package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
  485. package/dist/src/lib/swift-codegen/swiftKeys.js.map +1 -0
  486. package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
  487. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
  488. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
  489. package/dist/src/lib/sync-resource-types.d.ts +117 -31
  490. package/dist/src/lib/sync-resource-types.js +197 -189
  491. package/dist/src/lib/sync-resource-types.js.map +1 -1
  492. package/dist/src/lib/sync-selectors.d.ts +7 -0
  493. package/dist/src/lib/sync-selectors.js +22 -2
  494. package/dist/src/lib/sync-selectors.js.map +1 -1
  495. package/dist/src/lib/template.d.ts +39 -3
  496. package/dist/src/lib/template.js +103 -14
  497. package/dist/src/lib/template.js.map +1 -1
  498. package/dist/src/lib/test-case-file-names.d.ts +3 -5
  499. package/dist/src/lib/test-case-file-names.js +3 -5
  500. package/dist/src/lib/test-case-file-names.js.map +1 -1
  501. package/dist/src/lib/test-runs.d.ts +45 -0
  502. package/dist/src/lib/test-runs.js +150 -0
  503. package/dist/src/lib/test-runs.js.map +1 -0
  504. package/dist/src/lib/test-users.d.ts +25 -0
  505. package/dist/src/lib/test-users.js +36 -0
  506. package/dist/src/lib/test-users.js.map +1 -0
  507. package/dist/src/lib/toml-database-config.d.ts +4 -2
  508. package/dist/src/lib/toml-database-config.js +11 -6
  509. package/dist/src/lib/toml-database-config.js.map +1 -1
  510. package/dist/src/lib/toml-scalar-edit.js +6 -4
  511. package/dist/src/lib/toml-scalar-edit.js.map +1 -1
  512. package/dist/src/lib/transition-warnings.d.ts +21 -0
  513. package/dist/src/lib/transition-warnings.js +49 -0
  514. package/dist/src/lib/transition-warnings.js.map +1 -0
  515. package/dist/src/lib/user-index.d.ts +80 -0
  516. package/dist/src/lib/user-index.js +166 -0
  517. package/dist/src/lib/user-index.js.map +1 -0
  518. package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
  519. package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
  520. package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
  521. package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
  522. package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
  523. package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
  524. package/dist/src/lib/user-walk.d.ts +31 -0
  525. package/dist/src/lib/user-walk.js +102 -0
  526. package/dist/src/lib/user-walk.js.map +1 -0
  527. package/dist/src/lib/webhook-capture.d.ts +43 -0
  528. package/dist/src/lib/webhook-capture.js +91 -0
  529. package/dist/src/lib/webhook-capture.js.map +1 -0
  530. package/dist/src/lib/webhook-deliver.d.ts +18 -20
  531. package/dist/src/lib/webhook-deliver.js +34 -89
  532. package/dist/src/lib/webhook-deliver.js.map +1 -1
  533. package/dist/src/lib/webhook-test-run.d.ts +32 -0
  534. package/dist/src/lib/webhook-test-run.js +108 -0
  535. package/dist/src/lib/webhook-test-run.js.map +1 -0
  536. package/dist/src/lib/worker-perf-format.d.ts +22 -0
  537. package/dist/src/lib/worker-perf-format.js +27 -0
  538. package/dist/src/lib/worker-perf-format.js.map +1 -0
  539. package/dist/src/types/index.d.ts +20 -65
  540. package/dist/src/validators.d.ts +7 -55
  541. package/dist/src/validators.js +7 -53
  542. package/dist/src/validators.js.map +1 -1
  543. package/dist/src/vite.d.ts +17 -0
  544. package/dist/src/vite.js +18 -0
  545. package/dist/src/vite.js.map +1 -0
  546. package/package.json +20 -9
@@ -0,0 +1,219 @@
1
+ /**
2
+ * Doc comments for generated TypeScript and Swift types, from the keyword
3
+ * table (#5530, project `unified-schemas` phase 1).
4
+ *
5
+ * A schema's constraint and annotation keywords do not change a generated
6
+ * type's shape, but an app developer reading a hover needs them: `string`
7
+ * alone hides `maxLength: 40`. Both renderers call `schemaDocs` at each
8
+ * declaration site — an object member and a root type — and print the result
9
+ * with `renderJsDocLines` (TS) or `renderSwiftDocLines` (Swift).
10
+ *
11
+ * Which keywords become docs is the table's `render` column
12
+ * (`schemaKeywordRender`, `doc` for an unknown key), read from the vendored
13
+ * descriptor, so codegen keeps no keyword list of its own.
14
+ *
15
+ * The validator also enforces keywords on nodes the renderers give no
16
+ * declaration site: the properties of a type-union or untyped object, any
17
+ * single-schema `items`, every `oneOf` and `anyOf` member, and a tagged
18
+ * union's member objects. Their keywords are hoisted onto the nearest site
19
+ * with a path prefix (`items.minimum`, `oneOf/1.properties.id.minimum`), so
20
+ * nothing the validator enforces is dropped. An `anyOf` member renders as a
21
+ * type (#5544), so the properties of an object member keep their own sites.
22
+ *
23
+ * #5540 — a `$comment` that is a db3 projection marker (written by the db3
24
+ * bridge, and so on every compiled node a db3 ref inlined) renders as one
25
+ * `projection:` line naming the projection, the type and the model, in place
26
+ * of the plain `$comment` entry.
27
+ */
28
+ import { describeSchema, SCHEMA_KEYWORDS, schemaKeywordRender, } from "./generated-schema-descriptor.js";
29
+ import { parseDb3ProjectionMarker } from "./generated-db3-bridge.js";
30
+ const BACKSLASH = "\\";
31
+ const TERMINATOR_ESCAPES = new Map([
32
+ ["\n", `${BACKSLASH}n`],
33
+ ["\r", `${BACKSLASH}r`],
34
+ [String.fromCharCode(0x2028), `${BACKSLASH}u2028`],
35
+ [String.fromCharCode(0x2029), `${BACKSLASH}u2029`],
36
+ ]);
37
+ const TERMINATORS = new RegExp(`[${[...TERMINATOR_ESCAPES.keys()].join("")}]`, "g");
38
+ /**
39
+ * `text` made safe for one comment line: `*\/` cannot close a block comment,
40
+ * and every line terminator becomes its escape written as plain text.
41
+ */
42
+ export function commentSafe(text) {
43
+ return text
44
+ .replace(/\*\//g, `*${BACKSLASH}/`)
45
+ .replace(TERMINATORS, (terminator) => TERMINATOR_ESCAPES.get(terminator));
46
+ }
47
+ const isNode = (value) => !!value && typeof value === "object" && !Array.isArray(value);
48
+ const hasOwn = (node, key) => Object.prototype.hasOwnProperty.call(node, key);
49
+ const TABLE_ORDER = Object.keys(SCHEMA_KEYWORDS);
50
+ function jsonValue(value) {
51
+ return commentSafe(JSON.stringify(value) ?? String(value));
52
+ }
53
+ /** What each projection is, as the `projection:` line words it. */
54
+ const PROJECTION_MEANING = {
55
+ row: "as a stored row (id, the declared fields, the type's stamps; open)",
56
+ declared: "as declared (closed, storage keys stripped)",
57
+ };
58
+ /** A db3 projection marker's `projection:` line, or null for any other `$comment`. */
59
+ function projectionEntry(value, prefix) {
60
+ const marker = parseDb3ProjectionMarker(value);
61
+ if (!marker)
62
+ return null;
63
+ return {
64
+ name: commentSafe(`${prefix}projection`),
65
+ value: commentSafe(`${marker.projection} — db3 ${marker.type}.${marker.model} ${PROJECTION_MEANING[marker.projection]}`),
66
+ kind: "line",
67
+ };
68
+ }
69
+ function proseLines(description) {
70
+ const lines = description.split(/\r\n|\r|\n/).map((line) => commentSafe(line.trimEnd()));
71
+ while (lines.length > 0 && lines[0] === "")
72
+ lines.shift();
73
+ while (lines.length > 0 && lines[lines.length - 1] === "")
74
+ lines.pop();
75
+ return lines;
76
+ }
77
+ /**
78
+ * A node's own doc keywords: table rows in table order, then unknown keys in
79
+ * the schema's order. `prefix` is empty at a site and a path when hoisted.
80
+ */
81
+ function ownEntries(node, prefix, docs) {
82
+ const hoisted = prefix !== "";
83
+ for (const keyword of TABLE_ORDER) {
84
+ if (!hasOwn(node, keyword) || schemaKeywordRender(keyword) !== "doc")
85
+ continue;
86
+ const value = node[keyword];
87
+ if (keyword === "description" && typeof value === "string" && !hoisted) {
88
+ docs.prose.push(...proseLines(value));
89
+ continue;
90
+ }
91
+ const projection = keyword === "$comment" ? projectionEntry(value, prefix) : null;
92
+ if (projection) {
93
+ docs.entries.push(projection);
94
+ continue;
95
+ }
96
+ const tag = !hoisted && (keyword !== "deprecated" || value === true);
97
+ docs.entries.push({ name: commentSafe(prefix + keyword), value: jsonValue(value), kind: tag ? "tag" : "line" });
98
+ }
99
+ for (const [key, value] of Object.entries(node)) {
100
+ if (hasOwn(SCHEMA_KEYWORDS, key))
101
+ continue;
102
+ docs.entries.push({ name: commentSafe(prefix + key), value: jsonValue(value), kind: "line" });
103
+ }
104
+ }
105
+ /**
106
+ * The descriptor of a node's own keywords, `anyOf` aside: the renderers read
107
+ * an `anyOf` as its members and the rest of the node as their base (#5544).
108
+ */
109
+ function describeOwn(node) {
110
+ if (!Array.isArray(node.anyOf))
111
+ return describeSchema(node);
112
+ const { anyOf: _anyOf, ...rest } = node;
113
+ return describeSchema(rest);
114
+ }
115
+ /** Whether the node's `enum` or `const` decides its type, leaving its properties and items unrendered. */
116
+ const literalTyped = (node, d) => d.enumValues !== null || hasOwn(node, "const");
117
+ /** Whether the renderers give a node's declared properties sites of their own. */
118
+ function propertiesHaveSites(node, reach) {
119
+ const d = describeOwn(node);
120
+ if (reach === "member")
121
+ return d.object !== null;
122
+ return reach === "type" && d.object !== null && !literalTyped(node, d) && d.oneOf === null;
123
+ }
124
+ /** Whether the renderers render a node's single-schema `items` as its element type. */
125
+ function itemsRendered(node, reach) {
126
+ const d = describeOwn(node);
127
+ return reach !== "none" && d.array !== null && !literalTyped(node, d) && d.oneOf === null;
128
+ }
129
+ /**
130
+ * Hoist the keywords of every child the validator walks and the renderers give
131
+ * no site, depth first in the schema's key order.
132
+ */
133
+ function hoistChildren(node, prefix, reach, docs) {
134
+ const d = describeOwn(node);
135
+ const admits = (type) => d.types.length === 0 || d.types.includes(type);
136
+ const visit = (child, path, childReach) => {
137
+ if (!isNode(child))
138
+ return;
139
+ ownEntries(child, path, docs);
140
+ hoistChildren(child, path, childReach, docs);
141
+ };
142
+ for (const key of Object.keys(node)) {
143
+ const value = node[key];
144
+ if (key === "properties" && isNode(value) && admits("object")) {
145
+ if (propertiesHaveSites(node, reach))
146
+ continue;
147
+ for (const [name, child] of Object.entries(value))
148
+ visit(child, `${prefix}properties.${name}.`, "none");
149
+ }
150
+ else if (key === "items" && isNode(value) && admits("array")) {
151
+ visit(value, `${prefix}items.`, itemsRendered(node, reach) ? "type" : "none");
152
+ }
153
+ else if (key === "oneOf" && Array.isArray(value)) {
154
+ const tagged = reach !== "none" && d.oneOf?.kind === "valid";
155
+ value.forEach((member, index) => visit(member, `${prefix}oneOf/${index}.`, tagged ? "member" : "none"));
156
+ }
157
+ else if (key === "anyOf" && Array.isArray(value)) {
158
+ value.forEach((member, index) => visit(member, `${prefix}anyOf/${index}.`, reach === "type" ? "type" : "none"));
159
+ }
160
+ }
161
+ }
162
+ /**
163
+ * The doc comment for one declaration site's schema node: its own prose and
164
+ * keywords, then every keyword hoisted from beneath it.
165
+ */
166
+ export function schemaDocs(node) {
167
+ const docs = { prose: [], entries: [] };
168
+ if (!isNode(node))
169
+ return docs;
170
+ ownEntries(node, "", docs);
171
+ hoistChildren(node, "", "type", docs);
172
+ return docs;
173
+ }
174
+ /**
175
+ * The doc comment for a site whose type is a reference to a declaration
176
+ * emitted elsewhere (#5544): the node's own prose and keywords only, since
177
+ * everything beneath it is documented on that declaration.
178
+ */
179
+ export function schemaOwnDocs(node) {
180
+ const docs = { prose: [], entries: [] };
181
+ if (isNode(node))
182
+ ownEntries(node, "", docs);
183
+ return docs;
184
+ }
185
+ /**
186
+ * Authored text made inert to TypeScript: any `@` after whitespace starts a
187
+ * tag (`Use @deprecated …` marks the member deprecated), a line starting
188
+ * `@ts-ignore` is a directive, and `stripInternal` drops a declaration whose
189
+ * JSDoc contains `@internal` anywhere. Every authored `@` is written as the
190
+ * entity `@`, which a hover still shows as `@`.
191
+ */
192
+ const tsInert = (text) => text.replace(/@/g, "@");
193
+ /**
194
+ * A JSDoc block at `pad`, or no lines when there is nothing to say. Only a
195
+ * `tag` entry carries a real `@`, and `deprecated` is a bare `@deprecated`;
196
+ * prose, names and values have theirs written as `@`.
197
+ */
198
+ export function renderJsDocLines(docs, pad) {
199
+ if (docs.prose.length === 0 && docs.entries.length === 0)
200
+ return [];
201
+ return [
202
+ `${pad}/**`,
203
+ ...docs.prose.map((line) => (line === "" ? `${pad} *` : `${pad} * ${tsInert(line)}`)),
204
+ ...docs.entries.map((entry) => entry.kind === "line"
205
+ ? `${pad} * - ${tsInert(entry.name)}: ${tsInert(entry.value)}`
206
+ : entry.name === "deprecated"
207
+ ? `${pad} * @deprecated`
208
+ : `${pad} * @${entry.name} ${tsInert(entry.value)}`),
209
+ `${pad} */`,
210
+ ];
211
+ }
212
+ /** `///` lines at `pad`, or none when there is nothing to say. */
213
+ export function renderSwiftDocLines(docs, pad) {
214
+ return [
215
+ ...docs.prose.map((line) => (line === "" ? `${pad}///` : `${pad}/// ${line}`)),
216
+ ...docs.entries.map((entry) => `${pad}/// - ${entry.name}: ${entry.value}`),
217
+ ];
218
+ }
219
+ //# sourceMappingURL=schemaDocs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemaDocs.js","sourceRoot":"","sources":["../../../../src/lib/schema-codegen/schemaDocs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,158 @@
1
+ /**
2
+ * The one shape both code generators render (#5542, project `unified-schemas`
3
+ * phase 9).
4
+ *
5
+ * `lowerSchema` reads a JSON-Schema node through the vendored descriptor — the
6
+ * same interpretation the server validator applies — and answers a
7
+ * `ShapeNode`. `schemaToTs.ts` and `swift-codegen/schemaToSwift.ts` render that
8
+ * node and never read the descriptor for a shape decision, so the two languages
9
+ * cannot decide a schema's shape differently. Where a language cannot express
10
+ * a node (Swift has no untagged union, TS has no integer), the renderer says so
11
+ * in its own syntax; the node is the same.
12
+ *
13
+ * The lowering order is the validator's wherever the order can matter:
14
+ * `nullable: true` admits `null` before anything else, then the type gate,
15
+ * then `enum` and `const` (intersected), then a `type` union, then a tagged
16
+ * `oneOf`, then the singular type; `anyOf` narrows whatever the node's own
17
+ * keywords say (#5544, phase 10, when `const`, `anyOf` and `nullable` became
18
+ * type shapes). A valid tagged union has no sibling `type` or `enum`, so only a
19
+ * defective one can meet them, and then the enum or the union wins.
20
+ *
21
+ * `lowerSchema` never throws. A defective tagged union is a `refused` node
22
+ * carrying the descriptor's reason; each renderer throws it with its own
23
+ * prefix.
24
+ */
25
+ import { type SchemaDocs } from "./schemaDocs.js";
26
+ /** A JSON-Schema type name a scalar node can carry. */
27
+ export type ScalarType = "string" | "number" | "integer" | "boolean" | "null";
28
+ /** Any JSON value: an `enum` member or a `const`, which TS renders as a literal type. */
29
+ export type JsonValue = string | number | boolean | null | JsonValue[] | {
30
+ [key: string]: JsonValue;
31
+ };
32
+ /** One declared property of an object node. */
33
+ export interface ShapeMember {
34
+ /** The wire key. */
35
+ name: string;
36
+ required: boolean;
37
+ shape: ShapeNode;
38
+ /** `schemaDocs` of the property's schema (`schemaOwnDocs` where it is a named reference). */
39
+ docs: SchemaDocs;
40
+ }
41
+ /** An object with a `properties` table. */
42
+ export interface ObjectShape {
43
+ kind: "object";
44
+ /** The declared properties, in schema order. */
45
+ members: ShapeMember[];
46
+ /** Keys `required` names that `properties` does not declare, in `required` order. */
47
+ requiredUndeclared: string[];
48
+ /** False when `additionalProperties` is `false`. */
49
+ open: boolean;
50
+ }
51
+ /** One member of a tagged union: its discriminant value and its object, the discriminant required. */
52
+ export interface TaggedMember {
53
+ tag: string | number | boolean;
54
+ object: ObjectShape;
55
+ }
56
+ /**
57
+ * A schema node's shape, as both renderers read it.
58
+ *
59
+ * - `unknown`: nothing enforced, or a node the validator does not descend.
60
+ * `nullable` is true when `null` is admitted beside such a node (a `type`
61
+ * union with `null` and an object or array member, an empty `type` array,
62
+ * `nullable: true`).
63
+ * - `never`: an `enum` or `const` no value of which survives the type gate.
64
+ * - `scalar`, `union`: a single type, or a `type` array of scalars (deduped).
65
+ * - `literals`: the `enum` members (or the `const`) that survive the type
66
+ * gate, deduped by JSON equality; any JSON value. `nullable` is true when
67
+ * the raw `enum` has `null`, even one the gate drops.
68
+ * - `map`: `type: "object"` with no `properties` table.
69
+ * - `object`, `array`: the validator descends `properties` or `items`.
70
+ * - `tagged`: a valid discriminated `oneOf`.
71
+ * - `untagged`: an `anyOf`: a value matching some member, and `base` (the
72
+ * node without its `anyOf`) when that says anything.
73
+ * - `nullable`: `nullable: true` on a node that has no flag of its own.
74
+ * - `named`: a reference to a declaration emitted elsewhere (#5544), at a
75
+ * pointer the caller's `named` map names.
76
+ * - `refused`: a defective tagged union.
77
+ */
78
+ export type ShapeNode = {
79
+ kind: "unknown";
80
+ nullable: boolean;
81
+ } | {
82
+ kind: "never";
83
+ } | {
84
+ kind: "scalar";
85
+ type: ScalarType;
86
+ } | {
87
+ kind: "union";
88
+ types: ScalarType[];
89
+ } | {
90
+ kind: "literals";
91
+ values: JsonValue[];
92
+ nullable: boolean;
93
+ } | {
94
+ kind: "map";
95
+ } | ObjectShape | {
96
+ kind: "array";
97
+ items: ShapeNode;
98
+ } | {
99
+ kind: "tagged";
100
+ discriminant: string;
101
+ members: TaggedMember[];
102
+ } | {
103
+ kind: "untagged";
104
+ members: ShapeNode[];
105
+ base: ShapeNode | null;
106
+ } | {
107
+ kind: "nullable";
108
+ inner: ShapeNode;
109
+ } | {
110
+ kind: "named";
111
+ name: string;
112
+ nullable: boolean;
113
+ targetNullable?: boolean;
114
+ } | {
115
+ kind: "refused";
116
+ reason: string;
117
+ };
118
+ /** A root schema lowered: its shape and its own doc comment. */
119
+ export interface LoweredSchema {
120
+ shape: ShapeNode;
121
+ docs: SchemaDocs;
122
+ }
123
+ /** A reference `lowerSchema` answers at a pointer instead of descending (#5544). */
124
+ export interface NamedReference {
125
+ /** The name a renderer writes: `Schemas.Money` in TypeScript, `Money` in Swift. */
126
+ name: string;
127
+ /** The reference adds `null` to a target that does not admit it. */
128
+ nullable: boolean;
129
+ /**
130
+ * The target's own declaration admits `null` (Swift declares it as an
131
+ * Optional alias), so the reference does too without adding it.
132
+ */
133
+ targetNullable?: boolean;
134
+ /**
135
+ * What the site's doc comment reads: the node's keys the target does not
136
+ * already carry (the target's own docs sit on its declaration). Absent:
137
+ * the node itself.
138
+ */
139
+ own?: unknown;
140
+ }
141
+ export interface LowerSchemaOptions {
142
+ /**
143
+ * JSON pointers (the compiler's spelling, rooted at the schema lowered) whose
144
+ * node is a reference to a declaration emitted elsewhere. Empty or absent:
145
+ * every node renders inline.
146
+ */
147
+ named?: ReadonlyMap<string, NamedReference>;
148
+ }
149
+ /** The exhaustiveness check every renderer's `switch` on `kind` ends in. */
150
+ export declare function assertNever(value: never): never;
151
+ /** JSON text with object keys sorted: the identity `const` and dedupe compare by. */
152
+ export declare function canonicalJsonText(value: unknown): string;
153
+ /** A JSON-pointer segment for a property name. */
154
+ export declare function pointerSegment(name: string): string;
155
+ /** Lower a root schema node; see the module note. */
156
+ export declare function lowerSchema(schema: unknown, options?: LowerSchemaOptions): LoweredSchema;
157
+ /** Whether a lowered node admits `null`. */
158
+ export declare function admitsNull(node: ShapeNode): boolean;
@@ -0,0 +1,279 @@
1
+ /**
2
+ * The one shape both code generators render (#5542, project `unified-schemas`
3
+ * phase 9).
4
+ *
5
+ * `lowerSchema` reads a JSON-Schema node through the vendored descriptor — the
6
+ * same interpretation the server validator applies — and answers a
7
+ * `ShapeNode`. `schemaToTs.ts` and `swift-codegen/schemaToSwift.ts` render that
8
+ * node and never read the descriptor for a shape decision, so the two languages
9
+ * cannot decide a schema's shape differently. Where a language cannot express
10
+ * a node (Swift has no untagged union, TS has no integer), the renderer says so
11
+ * in its own syntax; the node is the same.
12
+ *
13
+ * The lowering order is the validator's wherever the order can matter:
14
+ * `nullable: true` admits `null` before anything else, then the type gate,
15
+ * then `enum` and `const` (intersected), then a `type` union, then a tagged
16
+ * `oneOf`, then the singular type; `anyOf` narrows whatever the node's own
17
+ * keywords say (#5544, phase 10, when `const`, `anyOf` and `nullable` became
18
+ * type shapes). A valid tagged union has no sibling `type` or `enum`, so only a
19
+ * defective one can meet them, and then the enum or the union wins.
20
+ *
21
+ * `lowerSchema` never throws. A defective tagged union is a `refused` node
22
+ * carrying the descriptor's reason; each renderer throws it with its own
23
+ * prefix.
24
+ */
25
+ import { describeSchema, isType } from "./generated-schema-descriptor.js";
26
+ import { schemaDocs, schemaOwnDocs } from "./schemaDocs.js";
27
+ /** The exhaustiveness check every renderer's `switch` on `kind` ends in. */
28
+ export function assertNever(value) {
29
+ throw new Error(`schema codegen: unhandled shape ${JSON.stringify(value)}`);
30
+ }
31
+ const SCALAR_TYPES = new Set(["string", "number", "integer", "boolean", "null"]);
32
+ const isScalarType = (type) => typeof type === "string" && SCALAR_TYPES.has(type);
33
+ const isNode = (value) => !!value && typeof value === "object" && !Array.isArray(value);
34
+ const hasOwn = (node, key) => Object.prototype.hasOwnProperty.call(node, key);
35
+ /** Whether a value is JSON all the way down (an `enum` member JSON can spell). */
36
+ function isJsonValue(value) {
37
+ if (value === null || typeof value === "string" || typeof value === "boolean")
38
+ return true;
39
+ if (typeof value === "number")
40
+ return Number.isFinite(value);
41
+ if (Array.isArray(value))
42
+ return value.every(isJsonValue);
43
+ if (isNode(value))
44
+ return Object.values(value).every(isJsonValue);
45
+ return false;
46
+ }
47
+ /** JSON text with object keys sorted: the identity `const` and dedupe compare by. */
48
+ export function canonicalJsonText(value) {
49
+ if (Array.isArray(value))
50
+ return `[${value.map(canonicalJsonText).join(",")}]`;
51
+ if (isNode(value)) {
52
+ return `{${Object.keys(value)
53
+ .sort()
54
+ .map((key) => `${JSON.stringify(key)}:${canonicalJsonText(value[key])}`)
55
+ .join(",")}}`;
56
+ }
57
+ return JSON.stringify(value) ?? "undefined";
58
+ }
59
+ /** A JSON-pointer segment for a property name. */
60
+ export function pointerSegment(name) {
61
+ return name.replace(/~/g, "~0").replace(/\//g, "~1");
62
+ }
63
+ const UNKNOWN = { kind: "unknown", nullable: false };
64
+ /** Lower a root schema node; see the module note. */
65
+ export function lowerSchema(schema, options = {}) {
66
+ const ctx = { named: options.named ?? new Map() };
67
+ const shape = lowerNode(schema, "", ctx);
68
+ return { shape, docs: shape.kind === "named" ? schemaOwnDocs(ownOf(schema, "", ctx)) : schemaDocs(schema) };
69
+ }
70
+ /** The node a named site documents: the reference's `own`, else the node. */
71
+ function ownOf(schema, pointer, ctx) {
72
+ const reference = ctx.named.get(pointer);
73
+ return reference && reference.own !== undefined ? reference.own : schema;
74
+ }
75
+ function lowerNode(schema, pointer, ctx) {
76
+ const reference = ctx.named.get(pointer);
77
+ if (reference) {
78
+ return {
79
+ kind: "named",
80
+ name: reference.name,
81
+ nullable: reference.nullable,
82
+ ...(reference.targetNullable ? { targetNullable: true } : {}),
83
+ };
84
+ }
85
+ const core = lowerCore(schema, pointer, ctx);
86
+ return isNode(schema) && schema.nullable === true ? withNull(core) : core;
87
+ }
88
+ /** `nullable: true` admits `null` before any other check: the node, or `null`. */
89
+ function withNull(node) {
90
+ switch (node.kind) {
91
+ case "unknown":
92
+ return { kind: "unknown", nullable: true };
93
+ case "never":
94
+ return { kind: "scalar", type: "null" };
95
+ case "scalar":
96
+ return node.type === "null" ? node : { kind: "union", types: [node.type, "null"] };
97
+ case "union":
98
+ return node.types.includes("null") ? node : { kind: "union", types: [...node.types, "null"] };
99
+ case "named":
100
+ return { ...node, nullable: true };
101
+ case "literals":
102
+ // The flag already says "the raw enum lists null", which Swift reads for
103
+ // its `JSONValue` fallback; a literal set without `null` is wrapped.
104
+ return node.values.includes(null) ? node : { kind: "nullable", inner: node };
105
+ case "nullable":
106
+ case "refused":
107
+ return node;
108
+ case "map":
109
+ case "object":
110
+ case "array":
111
+ case "tagged":
112
+ case "untagged":
113
+ return { kind: "nullable", inner: node };
114
+ default:
115
+ return assertNever(node);
116
+ }
117
+ }
118
+ function lowerCore(schema, pointer, ctx) {
119
+ if (isNode(schema) && Array.isArray(schema.anyOf) && schema.anyOf.length > 0) {
120
+ return lowerAnyOf(schema, schema.anyOf, pointer, ctx);
121
+ }
122
+ return lowerOwn(schema, pointer, ctx);
123
+ }
124
+ /**
125
+ * `anyOf`: a value must match some member, each validated on its own, and the
126
+ * node's other keywords besides. A member that admits anything makes the union
127
+ * say nothing; a lone member with no base is that member.
128
+ */
129
+ function lowerAnyOf(schema, anyOf, pointer, ctx) {
130
+ const members = anyOf.map((member, index) => lowerNode(member, `${pointer}/anyOf/${index}`, ctx));
131
+ const { anyOf: _anyOf, ...rest } = schema;
132
+ const own = lowerOwn(rest, pointer, ctx);
133
+ const base = own.kind === "unknown" && !own.nullable ? null : own;
134
+ if (members.some((member) => member.kind === "unknown"))
135
+ return base ?? UNKNOWN;
136
+ if (members.length === 1 && base === null)
137
+ return members[0];
138
+ return { kind: "untagged", members, base };
139
+ }
140
+ /** The node's own keywords, `anyOf` and `nullable` aside. */
141
+ function lowerOwn(schema, pointer, ctx) {
142
+ const d = describeSchema(schema);
143
+ // The validator checks `enum` and `const` after the type gate, so only the
144
+ // members that satisfy a declared type are reachable.
145
+ const hasConst = isNode(schema) && hasOwn(schema, "const");
146
+ let enumValues = d.enumValues;
147
+ if (hasConst) {
148
+ const value = schema.const;
149
+ enumValues = enumValues ? enumValues.filter((v) => canonicalJsonText(v) === canonicalJsonText(value)) : [value];
150
+ }
151
+ if (enumValues) {
152
+ const survivors = d.types.length > 0 ? enumValues.filter((v) => d.types.some((t) => isType(v, t))) : enumValues;
153
+ const nullable = enumValues.includes(null);
154
+ if (survivors.length === 0)
155
+ return { kind: "never" };
156
+ if (survivors.every(isJsonValue)) {
157
+ const seen = new Set();
158
+ const values = [];
159
+ for (const value of survivors) {
160
+ const key = canonicalJsonText(value);
161
+ if (seen.has(key))
162
+ continue;
163
+ seen.add(key);
164
+ values.push(value);
165
+ }
166
+ return { kind: "literals", values, nullable };
167
+ }
168
+ // A member JSON cannot spell (built in code, not parsed): the declared type
169
+ // is what can be said.
170
+ if (d.types.length === 0)
171
+ return { kind: "unknown", nullable };
172
+ }
173
+ if (d.isUnion)
174
+ return lowerUnion(d.types);
175
+ if (d.oneOf) {
176
+ if (d.oneOf.kind === "invalid")
177
+ return { kind: "refused", reason: d.oneOf.reason };
178
+ return lowerTagged(schema, d.oneOf, pointer, ctx);
179
+ }
180
+ switch (d.singularType) {
181
+ case null:
182
+ return UNKNOWN;
183
+ case "object":
184
+ return d.object ? lowerObject(d.object, [], pointer, ctx) : { kind: "map" };
185
+ case "array": {
186
+ const items = d.array?.items;
187
+ const descended = isNode(items);
188
+ return { kind: "array", items: descended ? lowerNode(items, `${pointer}/items`, ctx) : UNKNOWN };
189
+ }
190
+ default:
191
+ if (isScalarType(d.singularType))
192
+ return { kind: "scalar", type: d.singularType };
193
+ return UNKNOWN;
194
+ }
195
+ }
196
+ /** A `type` array: a scalar union, or `unknown` when a member is not a scalar (the validator never descends a union). */
197
+ function lowerUnion(types) {
198
+ const hasNull = types.includes("null");
199
+ if (!types.every(isScalarType))
200
+ return { kind: "unknown", nullable: hasNull };
201
+ const deduped = [...new Set(types)];
202
+ if (deduped.length === 0)
203
+ return { kind: "unknown", nullable: true };
204
+ return { kind: "union", types: deduped };
205
+ }
206
+ function lowerObject(desc, forcedRequired, pointer, ctx) {
207
+ const { properties, required, additionalPropertiesClosed } = desc;
208
+ const requiredSet = new Set([
209
+ ...(Array.isArray(required) ? required.filter((k) => typeof k === "string") : []),
210
+ ...forcedRequired,
211
+ ]);
212
+ return {
213
+ kind: "object",
214
+ members: Object.keys(properties).map((name) => {
215
+ const at = `${pointer}/properties/${pointerSegment(name)}`;
216
+ const shape = lowerNode(properties[name], at, ctx);
217
+ return {
218
+ name,
219
+ required: requiredSet.has(name),
220
+ shape,
221
+ docs: shape.kind === "named" ? schemaOwnDocs(ownOf(properties[name], at, ctx)) : schemaDocs(properties[name]),
222
+ };
223
+ }),
224
+ requiredUndeclared: [...requiredSet].filter((name) => !Object.prototype.hasOwnProperty.call(properties, name)),
225
+ open: !additionalPropertiesClosed,
226
+ };
227
+ }
228
+ /**
229
+ * A valid tagged union. The validator requires the discriminator before it can
230
+ * select a branch, so every member object lists it as required whatever its
231
+ * own `required` says. A member's own `enum` is not read: the union renders
232
+ * each member as its object.
233
+ */
234
+ function lowerTagged(schema, oneOf, pointer, ctx) {
235
+ const raw = Array.isArray(schema.oneOf) ? schema.oneOf : [];
236
+ const members = [];
237
+ for (const member of oneOf.members) {
238
+ const md = describeSchema(member.schema);
239
+ // Every member of a valid tagged union is an object with properties.
240
+ if (!md.object) {
241
+ return {
242
+ kind: "refused",
243
+ reason: `oneOf branch for ${oneOf.discriminant}=${String(member.discriminantValue)} is not an object`,
244
+ };
245
+ }
246
+ const at = `${pointer}/oneOf/${raw.indexOf(member.schema)}`;
247
+ members.push({ tag: member.discriminantValue, object: lowerObject(md.object, [oneOf.discriminant], at, ctx) });
248
+ }
249
+ return { kind: "tagged", discriminant: oneOf.discriminant, members };
250
+ }
251
+ /** Whether a lowered node admits `null`. */
252
+ export function admitsNull(node) {
253
+ switch (node.kind) {
254
+ case "unknown":
255
+ return node.nullable;
256
+ case "named":
257
+ return node.nullable || node.targetNullable === true;
258
+ case "scalar":
259
+ return node.type === "null";
260
+ case "union":
261
+ return node.types.includes("null");
262
+ case "literals":
263
+ return node.values.includes(null);
264
+ case "nullable":
265
+ return true;
266
+ case "untagged":
267
+ return node.members.some(admitsNull) && (node.base === null || admitsNull(node.base));
268
+ case "never":
269
+ case "map":
270
+ case "object":
271
+ case "array":
272
+ case "tagged":
273
+ case "refused":
274
+ return false;
275
+ default:
276
+ return assertNever(node);
277
+ }
278
+ }
279
+ //# sourceMappingURL=schemaIR.js.map