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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (590) hide show
  1. package/README.md +303 -186
  2. package/assets/skill/skills/primitive-platform/SKILL.md +93 -27
  3. package/dist/bin/primitive.js +15 -89
  4. package/dist/bin/primitive.js.map +1 -1
  5. package/dist/src/commands/admins.js +80 -17
  6. package/dist/src/commands/admins.js.map +1 -1
  7. package/dist/src/commands/agent-sessions.d.ts +129 -0
  8. package/dist/src/commands/agent-sessions.js +532 -20
  9. package/dist/src/commands/agent-sessions.js.map +1 -1
  10. package/dist/src/commands/analytics.js +207 -155
  11. package/dist/src/commands/analytics.js.map +1 -1
  12. package/dist/src/commands/apps-children.js +3 -0
  13. package/dist/src/commands/apps-children.js.map +1 -1
  14. package/dist/src/commands/apps-transitions.d.ts +39 -0
  15. package/dist/src/commands/apps-transitions.js +198 -0
  16. package/dist/src/commands/apps-transitions.js.map +1 -0
  17. package/dist/src/commands/apps.d.ts +17 -0
  18. package/dist/src/commands/apps.js +108 -3
  19. package/dist/src/commands/apps.js.map +1 -1
  20. package/dist/src/commands/auth-sessions.js +2 -0
  21. package/dist/src/commands/auth-sessions.js.map +1 -1
  22. package/dist/src/commands/auth.js +170 -50
  23. package/dist/src/commands/auth.js.map +1 -1
  24. package/dist/src/commands/blob-buckets.js +2 -0
  25. package/dist/src/commands/blob-buckets.js.map +1 -1
  26. package/dist/src/commands/collections.js +318 -256
  27. package/dist/src/commands/collections.js.map +1 -1
  28. package/dist/src/commands/comparisons.js +2 -0
  29. package/dist/src/commands/comparisons.js.map +1 -1
  30. package/dist/src/commands/config.d.ts +2 -2
  31. package/dist/src/commands/config.js +59 -33
  32. package/dist/src/commands/config.js.map +1 -1
  33. package/dist/src/commands/connections.js +2 -0
  34. package/dist/src/commands/connections.js.map +1 -1
  35. package/dist/src/commands/database-type-configs.js +5 -3
  36. package/dist/src/commands/database-type-configs.js.map +1 -1
  37. package/dist/src/commands/databases.js +6 -4
  38. package/dist/src/commands/databases.js.map +1 -1
  39. package/dist/src/commands/db3-types.d.ts +42 -0
  40. package/dist/src/commands/db3-types.js +445 -0
  41. package/dist/src/commands/db3-types.js.map +1 -0
  42. package/dist/src/commands/db3.d.ts +38 -0
  43. package/dist/src/commands/db3.js +2053 -0
  44. package/dist/src/commands/db3.js.map +1 -0
  45. package/dist/src/commands/documents.d.ts +110 -10
  46. package/dist/src/commands/documents.js +1019 -748
  47. package/dist/src/commands/documents.js.map +1 -1
  48. package/dist/src/commands/email-templates.js +74 -0
  49. package/dist/src/commands/email-templates.js.map +1 -1
  50. package/dist/src/commands/env.js +8 -4
  51. package/dist/src/commands/env.js.map +1 -1
  52. package/dist/src/commands/function-trigger-commands.d.ts +28 -0
  53. package/dist/src/commands/function-trigger-commands.js +341 -0
  54. package/dist/src/commands/function-trigger-commands.js.map +1 -0
  55. package/dist/src/commands/functions.js +383 -32
  56. package/dist/src/commands/functions.js.map +1 -1
  57. package/dist/src/commands/groups.js +168 -50
  58. package/dist/src/commands/groups.js.map +1 -1
  59. package/dist/src/commands/guides.js +7 -5
  60. package/dist/src/commands/guides.js.map +1 -1
  61. package/dist/src/commands/hosting.d.ts +8 -0
  62. package/dist/src/commands/hosting.js +509 -0
  63. package/dist/src/commands/hosting.js.map +1 -0
  64. package/dist/src/commands/init.js +129 -38
  65. package/dist/src/commands/init.js.map +1 -1
  66. package/dist/src/commands/integrations.js +82 -53
  67. package/dist/src/commands/integrations.js.map +1 -1
  68. package/dist/src/commands/locks.d.ts +5 -3
  69. package/dist/src/commands/locks.js +19 -61
  70. package/dist/src/commands/locks.js.map +1 -1
  71. package/dist/src/commands/metadata-category-configs.d.ts +2 -2
  72. package/dist/src/commands/metadata-category-configs.js +4 -2
  73. package/dist/src/commands/metadata-category-configs.js.map +1 -1
  74. package/dist/src/commands/metadata.js +55 -6
  75. package/dist/src/commands/metadata.js.map +1 -1
  76. package/dist/src/commands/prompts.js +75 -52
  77. package/dist/src/commands/prompts.js.map +1 -1
  78. package/dist/src/commands/rate-counters.d.ts +19 -0
  79. package/dist/src/commands/rate-counters.js +104 -0
  80. package/dist/src/commands/rate-counters.js.map +1 -0
  81. package/dist/src/commands/rule-sets.d.ts +1 -1
  82. package/dist/src/commands/rule-sets.js +2 -1
  83. package/dist/src/commands/rule-sets.js.map +1 -1
  84. package/dist/src/commands/schemas.d.ts +15 -0
  85. package/dist/src/commands/schemas.js +122 -0
  86. package/dist/src/commands/schemas.js.map +1 -0
  87. package/dist/src/commands/scripts.d.ts +9 -17
  88. package/dist/src/commands/scripts.js +24 -479
  89. package/dist/src/commands/scripts.js.map +1 -1
  90. package/dist/src/commands/secrets.d.ts +38 -0
  91. package/dist/src/commands/secrets.js +148 -6
  92. package/dist/src/commands/secrets.js.map +1 -1
  93. package/dist/src/commands/sessions.js +2 -0
  94. package/dist/src/commands/sessions.js.map +1 -1
  95. package/dist/src/commands/skill.js +2 -0
  96. package/dist/src/commands/skill.js.map +1 -1
  97. package/dist/src/commands/spent-tokens.d.ts +19 -0
  98. package/dist/src/commands/spent-tokens.js +79 -0
  99. package/dist/src/commands/spent-tokens.js.map +1 -0
  100. package/dist/src/commands/sync-app-settings.d.ts +58 -0
  101. package/dist/src/commands/sync-app-settings.js +119 -2
  102. package/dist/src/commands/sync-app-settings.js.map +1 -1
  103. package/dist/src/commands/sync-schemas.d.ts +202 -0
  104. package/dist/src/commands/sync-schemas.js +629 -0
  105. package/dist/src/commands/sync-schemas.js.map +1 -0
  106. package/dist/src/commands/sync-user-properties.d.ts +118 -0
  107. package/dist/src/commands/sync-user-properties.js +276 -0
  108. package/dist/src/commands/sync-user-properties.js.map +1 -0
  109. package/dist/src/commands/sync.d.ts +578 -546
  110. package/dist/src/commands/sync.js +3516 -5134
  111. package/dist/src/commands/sync.js.map +1 -1
  112. package/dist/src/commands/tokens.js +5 -3
  113. package/dist/src/commands/tokens.js.map +1 -1
  114. package/dist/src/commands/transitions.d.ts +54 -0
  115. package/dist/src/commands/transitions.js +418 -0
  116. package/dist/src/commands/transitions.js.map +1 -0
  117. package/dist/src/commands/usage.d.ts +42 -0
  118. package/dist/src/commands/usage.js +397 -0
  119. package/dist/src/commands/usage.js.map +1 -0
  120. package/dist/src/commands/user-properties.d.ts +14 -0
  121. package/dist/src/commands/user-properties.js +79 -0
  122. package/dist/src/commands/user-properties.js.map +1 -0
  123. package/dist/src/commands/users.js +951 -18
  124. package/dist/src/commands/users.js.map +1 -1
  125. package/dist/src/commands/vars.js +2 -0
  126. package/dist/src/commands/vars.js.map +1 -1
  127. package/dist/src/commands/waitlist.js +39 -4
  128. package/dist/src/commands/waitlist.js.map +1 -1
  129. package/dist/src/commands/workflows.d.ts +5 -83
  130. package/dist/src/commands/workflows.js +57 -2282
  131. package/dist/src/commands/workflows.js.map +1 -1
  132. package/dist/src/lib/analytics-query.d.ts +58 -0
  133. package/dist/src/lib/analytics-query.js +134 -0
  134. package/dist/src/lib/analytics-query.js.map +1 -0
  135. package/dist/src/lib/api-client.d.ts +1976 -431
  136. package/dist/src/lib/api-client.js +1095 -550
  137. package/dist/src/lib/api-client.js.map +1 -1
  138. package/dist/src/lib/app-settings-descriptor.d.ts +14 -2
  139. package/dist/src/lib/app-settings-descriptor.js +55 -1
  140. package/dist/src/lib/app-settings-descriptor.js.map +1 -1
  141. package/dist/src/lib/auth-fixtures.d.ts +44 -0
  142. package/dist/src/lib/auth-fixtures.js +61 -0
  143. package/dist/src/lib/auth-fixtures.js.map +1 -0
  144. package/dist/src/lib/auth-flow.d.ts +47 -1
  145. package/dist/src/lib/auth-flow.js +451 -14
  146. package/dist/src/lib/auth-flow.js.map +1 -1
  147. package/dist/src/lib/block-layout.d.ts +12 -23
  148. package/dist/src/lib/block-layout.js +26 -92
  149. package/dist/src/lib/block-layout.js.map +1 -1
  150. package/dist/src/lib/block-selector.d.ts +8 -14
  151. package/dist/src/lib/block-selector.js +8 -19
  152. package/dist/src/lib/block-selector.js.map +1 -1
  153. package/dist/src/lib/child-apps-local.d.ts +3 -1
  154. package/dist/src/lib/child-apps-local.js +9 -1
  155. package/dist/src/lib/child-apps-local.js.map +1 -1
  156. package/dist/src/lib/cli-manifest.d.ts +9 -0
  157. package/dist/src/lib/cli-manifest.js +10 -1
  158. package/dist/src/lib/cli-manifest.js.map +1 -1
  159. package/dist/src/lib/cli-version.d.ts +14 -0
  160. package/dist/src/lib/cli-version.js +38 -0
  161. package/dist/src/lib/cli-version.js.map +1 -0
  162. package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
  163. package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
  164. package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
  165. package/dist/src/lib/collection-export.d.ts +76 -15
  166. package/dist/src/lib/collection-export.js +116 -23
  167. package/dist/src/lib/collection-export.js.map +1 -1
  168. package/dist/src/lib/collection-principal.d.ts +22 -0
  169. package/dist/src/lib/collection-principal.js +35 -0
  170. package/dist/src/lib/collection-principal.js.map +1 -0
  171. package/dist/src/lib/command-groups.d.ts +30 -0
  172. package/dist/src/lib/command-groups.js +111 -0
  173. package/dist/src/lib/command-groups.js.map +1 -0
  174. package/dist/src/lib/command-status.d.ts +147 -0
  175. package/dist/src/lib/command-status.js +266 -0
  176. package/dist/src/lib/command-status.js.map +1 -0
  177. package/dist/src/lib/config-object-descriptor.d.ts +9 -22
  178. package/dist/src/lib/config-object-descriptor.js +113 -277
  179. package/dist/src/lib/config-object-descriptor.js.map +1 -1
  180. package/dist/src/lib/config-surface.d.ts +3 -7
  181. package/dist/src/lib/config-surface.js +9 -13
  182. package/dist/src/lib/config-surface.js.map +1 -1
  183. package/dist/src/lib/config-toml.d.ts +11 -2
  184. package/dist/src/lib/config-toml.js +25 -2
  185. package/dist/src/lib/config-toml.js.map +1 -1
  186. package/dist/src/lib/credentials-home.d.ts +7 -0
  187. package/dist/src/lib/credentials-home.js +45 -10
  188. package/dist/src/lib/credentials-home.js.map +1 -1
  189. package/dist/src/lib/credentials-lock.d.ts +14 -6
  190. package/dist/src/lib/credentials-lock.js +90 -10
  191. package/dist/src/lib/credentials-lock.js.map +1 -1
  192. package/dist/src/lib/credentials-store.d.ts +142 -70
  193. package/dist/src/lib/credentials-store.js +420 -111
  194. package/dist/src/lib/credentials-store.js.map +1 -1
  195. package/dist/src/lib/custodian.d.ts +8 -0
  196. package/dist/src/lib/custodian.js +18 -0
  197. package/dist/src/lib/custodian.js.map +1 -0
  198. package/dist/src/lib/data-input.d.ts +1 -1
  199. package/dist/src/lib/data-input.js +1 -1
  200. package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
  201. package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
  202. package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
  203. package/dist/src/lib/db-codegen/dbTypeIR.d.ts +40 -1
  204. package/dist/src/lib/db-codegen/dbTypeIR.js +32 -8
  205. package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
  206. package/dist/src/lib/db-type-records.d.ts +125 -0
  207. package/dist/src/lib/db-type-records.js +237 -0
  208. package/dist/src/lib/db-type-records.js.map +1 -0
  209. package/dist/src/lib/db3-export.d.ts +322 -0
  210. package/dist/src/lib/db3-export.js +767 -0
  211. package/dist/src/lib/db3-export.js.map +1 -0
  212. package/dist/src/lib/db3-index-output.d.ts +116 -0
  213. package/dist/src/lib/db3-index-output.js +223 -0
  214. package/dist/src/lib/db3-index-output.js.map +1 -0
  215. package/dist/src/lib/db3-json-fields.d.ts +49 -0
  216. package/dist/src/lib/db3-json-fields.js +195 -0
  217. package/dist/src/lib/db3-json-fields.js.map +1 -0
  218. package/dist/src/lib/db3-type-archive.d.ts +59 -0
  219. package/dist/src/lib/db3-type-archive.js +95 -0
  220. package/dist/src/lib/db3-type-archive.js.map +1 -0
  221. package/dist/src/lib/db3-type-models.d.ts +148 -0
  222. package/dist/src/lib/db3-type-models.js +583 -0
  223. package/dist/src/lib/db3-type-models.js.map +1 -0
  224. package/dist/src/lib/deprecation.d.ts +2 -2
  225. package/dist/src/lib/deprecation.js +2 -2
  226. package/dist/src/lib/document-export-record-log.d.ts +7 -0
  227. package/dist/src/lib/document-export-record-log.js +9 -0
  228. package/dist/src/lib/document-export-record-log.js.map +1 -1
  229. package/dist/src/lib/document-ingest-artifact.d.ts +19 -0
  230. package/dist/src/lib/document-ingest-artifact.js +55 -6
  231. package/dist/src/lib/document-ingest-artifact.js.map +1 -1
  232. package/dist/src/lib/document-ingest-format2.d.ts +36 -0
  233. package/dist/src/lib/document-ingest-format2.js +78 -0
  234. package/dist/src/lib/document-ingest-format2.js.map +1 -0
  235. package/dist/src/lib/document-ingest-input.d.ts +9 -0
  236. package/dist/src/lib/document-ingest-input.js +28 -1
  237. package/dist/src/lib/document-ingest-input.js.map +1 -1
  238. package/dist/src/lib/document-ingest.d.ts +11 -1
  239. package/dist/src/lib/document-ingest.js +16 -0
  240. package/dist/src/lib/document-ingest.js.map +1 -1
  241. package/dist/src/lib/document-schema-rows.d.ts +42 -0
  242. package/dist/src/lib/document-schema-rows.js +53 -0
  243. package/dist/src/lib/document-schema-rows.js.map +1 -0
  244. package/dist/src/lib/experimental-apis.d.ts +36 -0
  245. package/dist/src/lib/experimental-apis.js +46 -0
  246. package/dist/src/lib/experimental-apis.js.map +1 -0
  247. package/dist/src/lib/file-attachment.d.ts +24 -0
  248. package/dist/src/lib/file-attachment.js +31 -0
  249. package/dist/src/lib/file-attachment.js.map +1 -0
  250. package/dist/src/lib/function-authorize-check.d.ts +142 -0
  251. package/dist/src/lib/function-authorize-check.js +311 -0
  252. package/dist/src/lib/function-authorize-check.js.map +1 -0
  253. package/dist/src/lib/function-authorize-view.d.ts +36 -0
  254. package/dist/src/lib/function-authorize-view.js +110 -0
  255. package/dist/src/lib/function-authorize-view.js.map +1 -0
  256. package/dist/src/lib/function-bundle.d.ts +27 -5
  257. package/dist/src/lib/function-bundle.js +142 -7
  258. package/dist/src/lib/function-bundle.js.map +1 -1
  259. package/dist/src/lib/function-collect.d.ts +112 -12
  260. package/dist/src/lib/function-collect.js +601 -12
  261. package/dist/src/lib/function-collect.js.map +1 -1
  262. package/dist/src/lib/function-db-types.d.ts +65 -11
  263. package/dist/src/lib/function-db-types.js +326 -157
  264. package/dist/src/lib/function-db-types.js.map +1 -1
  265. package/dist/src/lib/function-document-types.d.ts +19 -7
  266. package/dist/src/lib/function-document-types.js +24 -12
  267. package/dist/src/lib/function-document-types.js.map +1 -1
  268. package/dist/src/lib/function-grants-preflight.d.ts +99 -0
  269. package/dist/src/lib/function-grants-preflight.js +154 -2
  270. package/dist/src/lib/function-grants-preflight.js.map +1 -1
  271. package/dist/src/lib/function-lint.d.ts +85 -0
  272. package/dist/src/lib/function-lint.js +442 -0
  273. package/dist/src/lib/function-lint.js.map +1 -0
  274. package/dist/src/lib/function-log-row.js +21 -2
  275. package/dist/src/lib/function-log-row.js.map +1 -1
  276. package/dist/src/lib/function-run.d.ts +13 -21
  277. package/dist/src/lib/function-run.js +14 -27
  278. package/dist/src/lib/function-run.js.map +1 -1
  279. package/dist/src/lib/function-schema-codegen.d.ts +86 -22
  280. package/dist/src/lib/function-schema-codegen.js +194 -88
  281. package/dist/src/lib/function-schema-codegen.js.map +1 -1
  282. package/dist/src/lib/function-schema-refs.d.ts +98 -0
  283. package/dist/src/lib/function-schema-refs.js +177 -0
  284. package/dist/src/lib/function-schema-refs.js.map +1 -0
  285. package/dist/src/lib/function-sync.d.ts +120 -6
  286. package/dist/src/lib/function-sync.js +217 -26
  287. package/dist/src/lib/function-sync.js.map +1 -1
  288. package/dist/src/lib/function-trigger-listing.d.ts +11 -6
  289. package/dist/src/lib/function-trigger-listing.js +32 -11
  290. package/dist/src/lib/function-trigger-listing.js.map +1 -1
  291. package/dist/src/lib/function-typecheck.d.ts +52 -0
  292. package/dist/src/lib/function-typecheck.js +174 -54
  293. package/dist/src/lib/function-typecheck.js.map +1 -1
  294. package/dist/src/lib/function-versions.d.ts +2 -0
  295. package/dist/src/lib/function-versions.js +1 -0
  296. package/dist/src/lib/function-versions.js.map +1 -1
  297. package/dist/src/lib/generated-build-flags.d.ts +13 -0
  298. package/dist/src/lib/generated-build-flags.js +14 -0
  299. package/dist/src/lib/generated-build-flags.js.map +1 -0
  300. package/dist/src/lib/generated-command-status.d.ts +6 -0
  301. package/dist/src/lib/generated-command-status.js +502 -0
  302. package/dist/src/lib/generated-command-status.js.map +1 -0
  303. package/dist/src/lib/generated-config-surfaces.d.ts +804 -140
  304. package/dist/src/lib/generated-config-surfaces.js +2491 -1806
  305. package/dist/src/lib/generated-config-surfaces.js.map +1 -1
  306. package/dist/src/lib/generated-sdk-types.d.ts +1 -1
  307. package/dist/src/lib/generated-sdk-types.js +1 -1
  308. package/dist/src/lib/generated-sdk-types.js.map +1 -1
  309. package/dist/src/lib/hosting-build.d.ts +97 -0
  310. package/dist/src/lib/hosting-build.js +204 -0
  311. package/dist/src/lib/hosting-build.js.map +1 -0
  312. package/dist/src/lib/hosting-client.d.ts +167 -0
  313. package/dist/src/lib/hosting-client.js +340 -0
  314. package/dist/src/lib/hosting-client.js.map +1 -0
  315. package/dist/src/lib/hosting-environments.d.ts +32 -0
  316. package/dist/src/lib/hosting-environments.js +74 -0
  317. package/dist/src/lib/hosting-environments.js.map +1 -0
  318. package/dist/src/lib/hosting-errors.d.ts +30 -0
  319. package/dist/src/lib/hosting-errors.js +43 -0
  320. package/dist/src/lib/hosting-errors.js.map +1 -0
  321. package/dist/src/lib/hosting-token.d.ts +46 -0
  322. package/dist/src/lib/hosting-token.js +60 -0
  323. package/dist/src/lib/hosting-token.js.map +1 -0
  324. package/dist/src/lib/hosting-trust-step.d.ts +67 -0
  325. package/dist/src/lib/hosting-trust-step.js +279 -0
  326. package/dist/src/lib/hosting-trust-step.js.map +1 -0
  327. package/dist/src/lib/hosting-trust.d.ts +77 -0
  328. package/dist/src/lib/hosting-trust.js +194 -0
  329. package/dist/src/lib/hosting-trust.js.map +1 -0
  330. package/dist/src/lib/hosting-wait.d.ts +42 -0
  331. package/dist/src/lib/hosting-wait.js +84 -0
  332. package/dist/src/lib/hosting-wait.js.map +1 -0
  333. package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
  334. package/dist/src/lib/hosting-wfp-upload.js +149 -0
  335. package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
  336. package/dist/src/lib/init-assets.d.ts +2 -6
  337. package/dist/src/lib/init-assets.js +11 -27
  338. package/dist/src/lib/init-assets.js.map +1 -1
  339. package/dist/src/lib/init-ios-links.d.ts +11 -7
  340. package/dist/src/lib/init-ios-links.js +28 -22
  341. package/dist/src/lib/init-ios-links.js.map +1 -1
  342. package/dist/src/lib/init-login-note.d.ts +13 -0
  343. package/dist/src/lib/init-login-note.js +22 -0
  344. package/dist/src/lib/init-login-note.js.map +1 -0
  345. package/dist/src/lib/init-schema.d.ts +15 -0
  346. package/dist/src/lib/init-schema.js +54 -0
  347. package/dist/src/lib/init-schema.js.map +1 -1
  348. package/dist/src/lib/integration-test-request.d.ts +54 -0
  349. package/dist/src/lib/integration-test-request.js +207 -0
  350. package/dist/src/lib/integration-test-request.js.map +1 -0
  351. package/dist/src/lib/invoker-shared-enums.d.ts +35 -0
  352. package/dist/src/lib/invoker-shared-enums.js +98 -0
  353. package/dist/src/lib/invoker-shared-enums.js.map +1 -0
  354. package/dist/src/lib/json-value.d.ts +6 -0
  355. package/dist/src/lib/json-value.js +13 -0
  356. package/dist/src/lib/json-value.js.map +1 -0
  357. package/dist/src/lib/load-routes.d.ts +33 -0
  358. package/dist/src/lib/load-routes.js +35 -0
  359. package/dist/src/lib/load-routes.js.map +1 -0
  360. package/dist/src/lib/log-inspection.d.ts +23 -4
  361. package/dist/src/lib/log-inspection.js +14 -5
  362. package/dist/src/lib/log-inspection.js.map +1 -1
  363. package/dist/src/lib/login-exchange-check.d.ts +18 -0
  364. package/dist/src/lib/login-exchange-check.js +27 -0
  365. package/dist/src/lib/login-exchange-check.js.map +1 -0
  366. package/dist/src/lib/login-scope-lines.d.ts +17 -7
  367. package/dist/src/lib/login-scope-lines.js +33 -10
  368. package/dist/src/lib/login-scope-lines.js.map +1 -1
  369. package/dist/src/lib/metadata-report.d.ts +85 -0
  370. package/dist/src/lib/metadata-report.js +81 -0
  371. package/dist/src/lib/metadata-report.js.map +1 -0
  372. package/dist/src/lib/object-status-filter.d.ts +9 -1
  373. package/dist/src/lib/object-status-filter.js +9 -1
  374. package/dist/src/lib/object-status-filter.js.map +1 -1
  375. package/dist/src/lib/output.d.ts +1 -1
  376. package/dist/src/lib/output.js +3 -1
  377. package/dist/src/lib/output.js.map +1 -1
  378. package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
  379. package/dist/src/lib/pin-refusal-hint.js +35 -0
  380. package/dist/src/lib/pin-refusal-hint.js.map +1 -0
  381. package/dist/src/lib/platform-owned.js +5 -0
  382. package/dist/src/lib/platform-owned.js.map +1 -1
  383. package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
  384. package/dist/src/lib/primitive-declaration-names.js +22 -0
  385. package/dist/src/lib/primitive-declaration-names.js.map +1 -0
  386. package/dist/src/lib/primitive-declaration.d.ts +174 -0
  387. package/dist/src/lib/primitive-declaration.js +871 -0
  388. package/dist/src/lib/primitive-declaration.js.map +1 -0
  389. package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
  390. package/dist/src/lib/primitive-env-plugin.js +408 -0
  391. package/dist/src/lib/primitive-env-plugin.js.map +1 -0
  392. package/dist/src/lib/project-login-apps.d.ts +8 -0
  393. package/dist/src/lib/project-login-apps.js +27 -0
  394. package/dist/src/lib/project-login-apps.js.map +1 -0
  395. package/dist/src/lib/prompt-schema-codegen.d.ts +36 -12
  396. package/dist/src/lib/prompt-schema-codegen.js +96 -100
  397. package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
  398. package/dist/src/lib/prompt-schema-document.d.ts +35 -0
  399. package/dist/src/lib/prompt-schema-document.js +92 -0
  400. package/dist/src/lib/prompt-schema-document.js.map +1 -0
  401. package/dist/src/lib/prompt-schema-refs.d.ts +173 -0
  402. package/dist/src/lib/prompt-schema-refs.js +478 -0
  403. package/dist/src/lib/prompt-schema-refs.js.map +1 -0
  404. package/dist/src/lib/records-verbs.d.ts +79 -0
  405. package/dist/src/lib/records-verbs.js +45 -0
  406. package/dist/src/lib/records-verbs.js.map +1 -0
  407. package/dist/src/lib/refresh-admin-credentials.d.ts +34 -4
  408. package/dist/src/lib/refresh-admin-credentials.js +85 -29
  409. package/dist/src/lib/refresh-admin-credentials.js.map +1 -1
  410. package/dist/src/lib/refresh-stored-login.d.ts +85 -0
  411. package/dist/src/lib/refresh-stored-login.js +233 -0
  412. package/dist/src/lib/refresh-stored-login.js.map +1 -0
  413. package/dist/src/lib/register-commands.d.ts +36 -0
  414. package/dist/src/lib/register-commands.js +37 -0
  415. package/dist/src/lib/register-commands.js.map +1 -0
  416. package/dist/src/lib/retired-imports.d.ts +53 -0
  417. package/dist/src/lib/retired-imports.js +120 -0
  418. package/dist/src/lib/retired-imports.js.map +1 -0
  419. package/dist/src/lib/row-field-rename.d.ts +18 -0
  420. package/dist/src/lib/row-field-rename.js +32 -0
  421. package/dist/src/lib/row-field-rename.js.map +1 -0
  422. package/dist/src/lib/run-status.d.ts +1 -1
  423. package/dist/src/lib/run-status.generated.d.ts +2 -2
  424. package/dist/src/lib/run-status.generated.js +3 -1
  425. package/dist/src/lib/run-status.generated.js.map +1 -1
  426. package/dist/src/lib/run-status.js +1 -1
  427. package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
  428. package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
  429. package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
  430. package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
  431. package/dist/src/lib/schema-codegen/generated-db3-bridge.js +227 -0
  432. package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
  433. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
  434. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
  435. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
  436. package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +229 -0
  437. package/dist/src/lib/schema-codegen/generated-field-grammar.js +420 -0
  438. package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
  439. package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
  440. package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
  441. package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
  442. package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
  443. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
  444. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
  445. package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +258 -0
  446. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
  447. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
  448. package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
  449. package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
  450. package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
  451. package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
  452. package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
  453. package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
  454. package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
  455. package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
  456. package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
  457. package/dist/src/lib/schema-codegen/generated-schema-shape.d.ts +27 -0
  458. package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
  459. package/dist/src/lib/schema-codegen/generated-schema-shape.js.map +1 -0
  460. package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
  461. package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
  462. package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
  463. package/dist/src/lib/schema-codegen/naming.d.ts +35 -0
  464. package/dist/src/lib/schema-codegen/naming.js +83 -0
  465. package/dist/src/lib/schema-codegen/naming.js.map +1 -0
  466. package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
  467. package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
  468. package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
  469. package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
  470. package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
  471. package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
  472. package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
  473. package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
  474. package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
  475. package/dist/src/lib/schema-codegen/schemaToTs.d.ts +109 -0
  476. package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
  477. package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
  478. package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
  479. package/dist/src/lib/schema-codegen/valuesLists.js +144 -0
  480. package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
  481. package/dist/src/lib/schema-defs-module.d.ts +29 -0
  482. package/dist/src/lib/schema-defs-module.js +103 -0
  483. package/dist/src/lib/schema-defs-module.js.map +1 -0
  484. package/dist/src/lib/schema-family-index.d.ts +228 -0
  485. package/dist/src/lib/schema-family-index.js +813 -0
  486. package/dist/src/lib/schema-family-index.js.map +1 -0
  487. package/dist/src/lib/schema-pins.d.ts +82 -0
  488. package/dist/src/lib/schema-pins.js +198 -0
  489. package/dist/src/lib/schema-pins.js.map +1 -0
  490. package/dist/src/lib/schema-preview.d.ts +244 -0
  491. package/dist/src/lib/schema-preview.js +498 -0
  492. package/dist/src/lib/schema-preview.js.map +1 -0
  493. package/dist/src/lib/scope-request.d.ts +23 -11
  494. package/dist/src/lib/scope-request.js +69 -31
  495. package/dist/src/lib/scope-request.js.map +1 -1
  496. package/dist/src/lib/session-scope.d.ts +26 -0
  497. package/dist/src/lib/session-scope.js +58 -0
  498. package/dist/src/lib/session-scope.js.map +1 -0
  499. package/dist/src/lib/skill-installer.d.ts +2 -2
  500. package/dist/src/lib/skill-installer.js +2 -21
  501. package/dist/src/lib/skill-installer.js.map +1 -1
  502. package/dist/src/lib/step-run-table.d.ts +1 -2
  503. package/dist/src/lib/step-run-table.js +1 -2
  504. package/dist/src/lib/step-run-table.js.map +1 -1
  505. package/dist/src/lib/swift-codegen/agentGenerator.d.ts +2 -1
  506. package/dist/src/lib/swift-codegen/agentGenerator.js +25 -23
  507. package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
  508. package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
  509. package/dist/src/lib/swift-codegen/banners.js +12 -0
  510. package/dist/src/lib/swift-codegen/banners.js.map +1 -1
  511. package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
  512. package/dist/src/lib/swift-codegen/functionGenerator.js +169 -51
  513. package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
  514. package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
  515. package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
  516. package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
  517. package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +51 -0
  518. package/dist/src/lib/swift-codegen/sharedGenerator.js +239 -0
  519. package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
  520. package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
  521. package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
  522. package/dist/src/lib/swift-codegen/swiftKeys.js.map +1 -0
  523. package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
  524. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
  525. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
  526. package/dist/src/lib/sync-resource-types.d.ts +117 -31
  527. package/dist/src/lib/sync-resource-types.js +197 -189
  528. package/dist/src/lib/sync-resource-types.js.map +1 -1
  529. package/dist/src/lib/sync-selectors.d.ts +7 -0
  530. package/dist/src/lib/sync-selectors.js +22 -2
  531. package/dist/src/lib/sync-selectors.js.map +1 -1
  532. package/dist/src/lib/template.d.ts +39 -3
  533. package/dist/src/lib/template.js +103 -14
  534. package/dist/src/lib/template.js.map +1 -1
  535. package/dist/src/lib/test-case-file-names.d.ts +3 -5
  536. package/dist/src/lib/test-case-file-names.js +3 -5
  537. package/dist/src/lib/test-case-file-names.js.map +1 -1
  538. package/dist/src/lib/test-runs.d.ts +45 -0
  539. package/dist/src/lib/test-runs.js +150 -0
  540. package/dist/src/lib/test-runs.js.map +1 -0
  541. package/dist/src/lib/test-users.d.ts +25 -0
  542. package/dist/src/lib/test-users.js +36 -0
  543. package/dist/src/lib/test-users.js.map +1 -0
  544. package/dist/src/lib/toml-database-config.d.ts +4 -2
  545. package/dist/src/lib/toml-database-config.js +11 -6
  546. package/dist/src/lib/toml-database-config.js.map +1 -1
  547. package/dist/src/lib/toml-list-edit.d.ts +33 -0
  548. package/dist/src/lib/toml-list-edit.js +481 -0
  549. package/dist/src/lib/toml-list-edit.js.map +1 -0
  550. package/dist/src/lib/toml-scalar-edit.d.ts +9 -0
  551. package/dist/src/lib/toml-scalar-edit.js +73 -5
  552. package/dist/src/lib/toml-scalar-edit.js.map +1 -1
  553. package/dist/src/lib/transition-warnings.d.ts +21 -0
  554. package/dist/src/lib/transition-warnings.js +49 -0
  555. package/dist/src/lib/transition-warnings.js.map +1 -0
  556. package/dist/src/lib/usage-meters.d.ts +16 -0
  557. package/dist/src/lib/usage-meters.js +52 -0
  558. package/dist/src/lib/usage-meters.js.map +1 -0
  559. package/dist/src/lib/user-index.d.ts +80 -0
  560. package/dist/src/lib/user-index.js +166 -0
  561. package/dist/src/lib/user-index.js.map +1 -0
  562. package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
  563. package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
  564. package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
  565. package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
  566. package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
  567. package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
  568. package/dist/src/lib/user-walk.d.ts +31 -0
  569. package/dist/src/lib/user-walk.js +102 -0
  570. package/dist/src/lib/user-walk.js.map +1 -0
  571. package/dist/src/lib/webhook-capture.d.ts +43 -0
  572. package/dist/src/lib/webhook-capture.js +91 -0
  573. package/dist/src/lib/webhook-capture.js.map +1 -0
  574. package/dist/src/lib/webhook-deliver.d.ts +18 -20
  575. package/dist/src/lib/webhook-deliver.js +34 -89
  576. package/dist/src/lib/webhook-deliver.js.map +1 -1
  577. package/dist/src/lib/webhook-test-run.d.ts +32 -0
  578. package/dist/src/lib/webhook-test-run.js +108 -0
  579. package/dist/src/lib/webhook-test-run.js.map +1 -0
  580. package/dist/src/lib/worker-perf-format.d.ts +22 -0
  581. package/dist/src/lib/worker-perf-format.js +27 -0
  582. package/dist/src/lib/worker-perf-format.js.map +1 -0
  583. package/dist/src/types/index.d.ts +20 -65
  584. package/dist/src/validators.d.ts +7 -55
  585. package/dist/src/validators.js +7 -53
  586. package/dist/src/validators.js.map +1 -1
  587. package/dist/src/vite.d.ts +17 -0
  588. package/dist/src/vite.js +18 -0
  589. package/dist/src/vite.js.map +1 -0
  590. package/package.json +20 -9
@@ -0,0 +1,177 @@
1
+ /**
2
+ * A function file's schemas, compiled the way the server compiles them.
3
+ *
4
+ * A function schema may define shapes under `$defs` and use them with local
5
+ * `$ref`s, and (#5533) ref shared defs in the tree's `schemas/` files. The
6
+ * server inlines every ref whose target exists when it stores the schema, so
7
+ * every LOCAL reader that pushes or compares a function file has to see that
8
+ * same compiled document: the local side of `config diff` and the push gate,
9
+ * the preflight, the build's warnings, and the configs push's compiled
10
+ * payload and provenance. The header bodies carry the AUTHORED schemas
11
+ * (`authoredFunctionTable`), which the server compiles from source against
12
+ * its stored rows. Codegen reads the authored schemas, so generated types are
13
+ * unchanged by refs. `compileFunctionToml` runs right after the file is
14
+ * parsed, with the vendored copy of the server's compiler.
15
+ *
16
+ * Never run it on a document built from a STORED row: the stored side is
17
+ * compared exactly as stored, so a schema stored before refs resolved reads as
18
+ * a change until it is pushed again.
19
+ */
20
+ import { compileSchemaRefs, functionSchemaRowBudgetRefusal, schemaFamilyRefsIn, } from "./schema-codegen/generated-schema-refs.js";
21
+ import { schemaProvenanceOf } from "./schema-codegen/generated-schema-provenance.js";
22
+ import { fieldTableMarkerKeys } from "./schema-codegen/generated-field-table.js";
23
+ /**
24
+ * The warning for a JSON-Schema slot whose root carries field-table keys
25
+ * (#5541): accepted as annotations, as before, but probably meant as a field
26
+ * table under the field-table key. Null when it carries none.
27
+ */
28
+ export function fieldTableKeyWarning(where, schema, slot) {
29
+ const keys = fieldTableMarkerKeys(schema);
30
+ if (keys.length === 0)
31
+ return null;
32
+ const which = keys.length === 1 ? `${keys[0]}, a field-table key` : `${keys.join(", ")}, field-table keys`;
33
+ return `${where} carries ${which}; to write a field table, move it to ${slot}`;
34
+ }
35
+ const FIELDS = ["inputSchema", "outputSchema"];
36
+ /** Results by the document they compiled (and produced), per family source, so a second call is free. */
37
+ const compiledDocuments = new WeakMap();
38
+ /** A compiled `[function]` table → the authored table it was compiled from. */
39
+ const authoredTables = new WeakMap();
40
+ /** The key a compile without a family index is cached under. */
41
+ const PHASE_TWO = Symbol("no family index");
42
+ /** The index a schema with no family-spelled ref compiles against: it reads nothing. */
43
+ const NO_FAMILIES = Object.freeze({ files: new Map() });
44
+ function isPlainObject(value) {
45
+ return value !== null && typeof value === "object" && !Array.isArray(value);
46
+ }
47
+ /** The tree-relative spelling of a function file (`functions/<key>.toml`), for messages. */
48
+ export function functionFileLabel(filePath) {
49
+ const posix = filePath.replace(/\\/g, "/");
50
+ const at = posix.lastIndexOf("/functions/");
51
+ return at >= 0 ? posix.slice(at + 1) : posix;
52
+ }
53
+ /**
54
+ * The `[function]` table whose schemas a header create or update sends: the
55
+ * authored table a compiled one came from (#5533), or the table itself. The
56
+ * server compiles a header's schema from source against its stored rows, so
57
+ * the body must not carry the CLI's compile: a shared def's dangling
58
+ * `#/$defs/<X>` would resolve against the function's own `$defs` if compiled
59
+ * twice.
60
+ */
61
+ export function authoredFunctionTable(table) {
62
+ return (isPlainObject(table) && authoredTables.get(table)) || table;
63
+ }
64
+ /** A schema as the push reads it: a JSON-string spelling parsed; anything else not an object is no schema. */
65
+ function schemaValue(value) {
66
+ let schema = value;
67
+ if (typeof schema === "string") {
68
+ try {
69
+ schema = JSON.parse(schema);
70
+ }
71
+ catch {
72
+ return null;
73
+ }
74
+ }
75
+ return isPlainObject(schema) ? schema : null;
76
+ }
77
+ /**
78
+ * Compile the refs of a parsed `functions/<key>.toml`. A schema written as a
79
+ * JSON string is read the way the server reads it. A schema the compile
80
+ * leaves unchanged keeps its authored spelling.
81
+ *
82
+ * With `families` (#5533), shared refs resolve against the tree's `schemas/`
83
+ * files (#5540: and db3 types); a loader is called only when a schema writes a family-spelled ref.
84
+ * Without it, shared refs stay inert as in the release before.
85
+ */
86
+ export function compileFunctionToml(file, parsed, families) {
87
+ if (!isPlainObject(parsed) || !isPlainObject(parsed.function)) {
88
+ return {
89
+ parsed,
90
+ warnings: [],
91
+ refusal: null,
92
+ budgetRefusal: null,
93
+ schemas: { inputSchema: null, outputSchema: null },
94
+ resolved: { inputSchema: [], outputSchema: [] },
95
+ };
96
+ }
97
+ const cacheKey = families ?? PHASE_TWO;
98
+ const known = compiledDocuments.get(parsed)?.get(cacheKey);
99
+ if (known)
100
+ return known;
101
+ const table = parsed.function;
102
+ let compiledTable = table;
103
+ const warnings = [];
104
+ let refusal = null;
105
+ const resolved = { inputSchema: [], outputSchema: [] };
106
+ const schemas = { inputSchema: null, outputSchema: null };
107
+ const values = FIELDS.map((field) => schemaValue(table[field]));
108
+ let index;
109
+ if (families) {
110
+ const scans = values.map((value) => schemaFamilyRefsIn(value));
111
+ const needed = scans.some((scan) => scan.edges.length > 0 || scan.db3.length > 0 || scan.shortForms || scan.reserved);
112
+ index = !needed ? NO_FAMILIES : typeof families === "function" ? families() : families;
113
+ }
114
+ FIELDS.forEach((field, at) => {
115
+ const schema = values[at];
116
+ if (!schema)
117
+ return;
118
+ const misplaced = fieldTableKeyWarning(field, schema, field === "inputSchema" ? "[function.input]" : "[function.output]");
119
+ if (misplaced)
120
+ warnings.push(`${file}: ${misplaced}`);
121
+ // #5540 — the field is the position: a db3 ref gets the row in outputSchema.
122
+ const compiled = compileSchemaRefs(schema, { field, position: field === "outputSchema" ? "output" : "input", ...(index ? { families: index } : {}) });
123
+ if (compiled.refusal) {
124
+ refusal ??= `${file}: ${compiled.refusal.message}`;
125
+ return;
126
+ }
127
+ for (const warning of compiled.warnings)
128
+ warnings.push(`${file}: ${warning.message}`);
129
+ resolved[field] = compiled.resolved;
130
+ schemas[field] = compiled.schema;
131
+ if (JSON.stringify(compiled.schema) !== JSON.stringify(schema)) {
132
+ if (compiledTable === table)
133
+ compiledTable = { ...table };
134
+ compiledTable[field] = compiled.schema;
135
+ }
136
+ });
137
+ // The bytes the server stores for each schema the push sends.
138
+ const stored = (value) => value === undefined || value === null || value === "" ? null : typeof value === "string" ? value : JSON.stringify(value);
139
+ const budget = refusal
140
+ ? null
141
+ : functionSchemaRowBudgetRefusal(stored(compiledTable.inputSchema), stored(compiledTable.outputSchema), resolved);
142
+ const result = {
143
+ parsed: compiledTable === table ? parsed : { ...parsed, function: compiledTable },
144
+ warnings,
145
+ refusal,
146
+ budgetRefusal: budget ? `${file}: ${budget.message}` : null,
147
+ schemas,
148
+ resolved,
149
+ };
150
+ if (compiledTable !== table)
151
+ authoredTables.set(compiledTable, table);
152
+ for (const document of [parsed, result.parsed]) {
153
+ let byKey = compiledDocuments.get(document);
154
+ if (!byKey) {
155
+ byKey = new Map();
156
+ compiledDocuments.set(document, byKey);
157
+ }
158
+ byKey.set(cacheKey, result);
159
+ }
160
+ return result;
161
+ }
162
+ /**
163
+ * The compiled payload a configs push sends for a compiled function file:
164
+ * the two compiled schemas (null where the file declares none) and the
165
+ * provenance of each, which the server recompiles and compares. The compile
166
+ * must have run with a family index.
167
+ */
168
+ export async function functionSchemaPayload(compiled) {
169
+ return {
170
+ compiled: { inputSchema: compiled.schemas.inputSchema, outputSchema: compiled.schemas.outputSchema },
171
+ provenance: {
172
+ inputSchema: await schemaProvenanceOf(compiled.resolved.inputSchema),
173
+ outputSchema: await schemaProvenanceOf(compiled.resolved.outputSchema),
174
+ },
175
+ };
176
+ }
177
+ //# sourceMappingURL=function-schema-refs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"function-schema-refs.js","sourceRoot":"","sources":["../../../src/lib/function-schema-refs.ts"],"names":[],"mappings":"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"}
@@ -32,8 +32,9 @@
32
32
  * time and refuses a destination that lands outside the real root.
33
33
  */
34
34
  import { type TriggerDeclaration } from "./generated-config-surfaces.js";
35
+ import { type CompiledFunctionToml, type FunctionSchemaPayload, type SchemaFamilySource } from "./function-schema-refs.js";
35
36
  import { type PullWriteTally } from "./pull-write.js";
36
- import { type FunctionManifest as CollectedManifest } from "./function-collect.js";
37
+ import { type CollectedFunction, type FunctionManifest as CollectedManifest } from "./function-collect.js";
37
38
  /**
38
39
  * Collect one function's manifest, or answer from this command's memo.
39
40
  *
@@ -49,6 +50,18 @@ export declare function collectManifestForBundle(options: {
49
50
  /** The built bundle's source, for the static scan (#3279). */
50
51
  bundle?: string;
51
52
  }): Promise<CollectedManifest>;
53
+ /**
54
+ * The manifest and the local `authorize` answer (#4717), from the same memo:
55
+ * one collect pass per bundle answers both.
56
+ */
57
+ export declare function collectForBundle(options: {
58
+ configDir: string;
59
+ entry: string;
60
+ functionKey: string;
61
+ contentHash: string;
62
+ /** The built bundle's source, for the static scan (#3279). */
63
+ bundle?: string;
64
+ }): Promise<CollectedFunction>;
52
65
  /**
53
66
  * The server's own `[function.triggers.*]` rules, applied to a parsed
54
67
  * `[function]` table, with "nothing declared" spelled as null so a caller can
@@ -95,7 +108,33 @@ export interface FunctionConfigPush {
95
108
  * can seed a model's metadata on a function's first write.
96
109
  */
97
110
  documentSchema?: string;
111
+ /**
112
+ * #5533 — the TOML's two schemas as this CLI compiled them (null where the
113
+ * file declares none). The server recompiles them from the TOML against its
114
+ * stored `schemas/` files and refuses the push if they differ.
115
+ */
116
+ compiled: FunctionSchemaPayload["compiled"];
117
+ /** #5533 — where each compiled schema inlined refs, and each def's hash; inside the envelope and `envelopeHash`. */
118
+ provenance: FunctionSchemaPayload["provenance"];
119
+ /**
120
+ * #5547 — the advisory typecheck's lines for this version, when the typed
121
+ * `ctx.db3` handles refuse something in it; absent otherwise. Outside the
122
+ * envelope and `envelopeHash`: the server counts them in its log and stores
123
+ * nothing.
124
+ */
125
+ db3FilterAdvisories?: string[];
98
126
  }
127
+ /**
128
+ * The lines `config push` prints from a function version push's answer: the
129
+ * string entries of its `warnings` list, in order, without the platform
130
+ * transition lines (`ApiClient.request` prints those itself). The server adds a
131
+ * line there when, for example, a Turnstile function's app has no site key or
132
+ * no `PRIMITIVE_TURNSTILE_SECRET`; the push has succeeded either way.
133
+ *
134
+ * @param pushedVersion The answer of `pushFunctionConfig`.
135
+ * @returns The lines to print; `[]` for an answer without a `warnings` list.
136
+ */
137
+ export declare function functionVersionPushWarnings(pushedVersion: unknown): string[];
99
138
  /**
100
139
  * Everything about one `functions/<key>.toml` that `config push` can decide
101
140
  * from the file alone (#3320).
@@ -124,6 +163,8 @@ export declare function functionTomlPreflightErrors(options: {
124
163
  functionKey: string;
125
164
  /** The already-parsed document, so the file is read once. */
126
165
  tomlData: any;
166
+ /** #5533 — what shared refs resolve against; the file's own tree by default. */
167
+ families?: SchemaFamilySource;
127
168
  }): string[];
128
169
  /**
129
170
  * Build everything the config-version route needs for one function file.
@@ -156,6 +197,19 @@ export interface DetailedFunctionConfigPush {
156
197
  * beside it, to the typechecker.
157
198
  */
158
199
  projectSources: string[];
200
+ /**
201
+ * Whether the built function carries `authorize` (#4717), from the collect
202
+ * pass. Never sent: the server records its own answer from the push probe.
203
+ * It decides whether `config push` may refuse the version before sending
204
+ * it (#4738).
205
+ */
206
+ authorize: boolean;
207
+ /**
208
+ * #4730 — the push warnings of a flagged build (an authorize that reads no
209
+ * caller, unbounded input-schema nodes, a root left open); empty for a
210
+ * bare handler. Printed by `config push`, which pushes anyway.
211
+ */
212
+ warnings: string[];
159
213
  }
160
214
  /**
161
215
  * `buildFunctionConfigPush`, plus the shared sources the build inlined — what
@@ -171,6 +225,8 @@ export declare function buildFunctionConfigPushDetailed(options: {
171
225
  tomlData: any;
172
226
  /** The declared `functionSources` directories; see `buildFunctionBundle`. */
173
227
  sourceRoots?: readonly string[];
228
+ /** #5533 — what shared refs resolve against; the tree's own `schemas/` by default. */
229
+ families?: SchemaFamilySource;
174
230
  }): Promise<DetailedFunctionConfigPush>;
175
231
  /**
176
232
  * The per-function failure when a server DID NOT retain the document schema it
@@ -229,8 +285,7 @@ export declare function documentSchemaDropAnswer(documentSchemaModels: unknown):
229
285
  * Says ONCE — for the whole push, not once per function — that this push drops
230
286
  * a document schema a running version carries (#3455, D3455-004).
231
287
  *
232
- * Removing `models/models.toml` and its generated tree copy is a legitimate
233
- * edit, so it is a warning and not a refusal; but it turns first-writer seeding
288
+ * Removing `models/models.toml` is a legitimate edit, so it is a warning and not a refusal; but it turns first-writer seeding
234
289
  * off for every document these functions touch, and that must not be silent.
235
290
  *
236
291
  * The state this holds is "has the run been told yet", and the rule is that
@@ -249,6 +304,11 @@ export declare function createDocumentSchemaDropWarner(deps: {
249
304
  /** Where the sentence goes. */
250
305
  warn: (message: string) => void;
251
306
  }): (functionId: string, activeConfigId: string | undefined) => Promise<void>;
307
+ /**
308
+ * The compiled payload a configs push carries for a compiled function file
309
+ * (#5533): the two compiled schemas and their provenance.
310
+ */
311
+ export declare function functionConfigSchemaPayload(compiled: CompiledFunctionToml): Promise<FunctionSchemaPayload>;
252
312
  /**
253
313
  * The create body. `functionKey` is attached here rather than spread from the
254
314
  * table: the identity comes from the file name, exactly as it does for every
@@ -266,8 +326,47 @@ export declare function buildFunctionCreatePayload(functionKey: string, table: a
266
326
  * live that the file no longer declares, and the comparison — which reads an
267
327
  * absent schema as `null` — would report that difference again on every run.
268
328
  * Removing `[function.inputSchema]` clears it, and the next diff is Synced.
329
+ *
330
+ * #4738 — neither body carries `access`: the header's rule is frozen, and the
331
+ * server refuses a body that names it.
269
332
  */
270
333
  export declare function buildFunctionUpdatePayload(table: any): Record<string, any>;
334
+ /** The facts `config push` decides a function's pre-refusal from (#4738). */
335
+ export interface FunctionPushPreRefusalInput {
336
+ functionKey: string;
337
+ /** The live read succeeded, so `exists` is the server's answer. */
338
+ liveKnown: boolean;
339
+ /** The server holds a live header for the key. */
340
+ exists: boolean;
341
+ /** The LOCAL build carries `authorize`. */
342
+ authorize: boolean;
343
+ /** The TOML's `[function]` table carries `access`. */
344
+ tomlCarriesAccess: boolean;
345
+ }
346
+ /**
347
+ * The refusal `config push` records before any request, or null — #4738.
348
+ *
349
+ * Only when no stored version can match: the live read succeeded and the
350
+ * server holds no header for the key. For a function that exists the server
351
+ * decides, because it alone can match the envelope against an inactive stored
352
+ * version (and re-point the header to it); a degraded run sends and lets the
353
+ * server decide too. A bare build is refused before the ambiguity, as on the
354
+ * server.
355
+ */
356
+ export declare function functionPushPreRefusal(input: FunctionPushPreRefusalInput): string | null;
357
+ /**
358
+ * The message `config push` records for a refused version: the server's two
359
+ * break refusals and its compiled-payload mismatch (#5533) carry the file
360
+ * they are about, as the pre-refusal does; everything else reads as it
361
+ * always did.
362
+ */
363
+ export declare function functionVersionRefusalMessage(functionKey: string, err: unknown): string;
364
+ /**
365
+ * The warning for a flagged function whose envelope is unchanged and whose
366
+ * TOML still carries `access` (#4738): nothing is pushed, and the next change
367
+ * to the code is refused until the line goes.
368
+ */
369
+ export declare function unchangedAccessWarning(functionKey: string): string;
271
370
  /** The version-carried keys, as the config-version row holds them. */
272
371
  export interface ActiveFunctionVersion {
273
372
  entry?: string;
@@ -275,6 +374,11 @@ export interface ActiveFunctionVersion {
275
374
  limits?: unknown;
276
375
  /** #3182 — the capabilities the server derived from the authored TOML. */
277
376
  capabilities?: string[];
377
+ /**
378
+ * #4717 — whether the version carries `authorize`, as the server's push
379
+ * probe recorded it.
380
+ */
381
+ authorize?: boolean;
278
382
  }
279
383
  /**
280
384
  * The canonical TOML for a function with no stored authored bytes — a function
@@ -288,9 +392,10 @@ export declare function serializeFunction(record: any, active?: ActiveFunctionVe
288
392
  * local file and a server record cannot be read into different shapes.
289
393
  *
290
394
  * Text the server rewrites on the way in is read the same way it will come
291
- * back (the DSO-003 rule the webhook comparator states): `access` is stored
292
- * trimmed and `entry` normalized, so an authored value that differs only in
293
- * that respect is not permanent drift.
395
+ * back (the DSO-003 rule the webhook comparator states): `entry` is stored
396
+ * normalized, so an authored value that differs only in that respect is not
397
+ * permanent drift. `access` is no part of it (#4738): the header's rule is
398
+ * frozen, and a file's line beside it is neither sent nor compared.
294
399
  */
295
400
  export declare function functionDiffEntity(tomlData: any): Record<string, any>;
296
401
  /**
@@ -448,12 +553,19 @@ export interface DocumentSchemaPullPlan {
448
553
  * file cannot reproduce two envelopes, so an operator is told which
449
554
  * function the tree now speaks for and which ones will read Modified until
450
555
  * they are pushed again.
556
+ *
557
+ * Those rules are for a tree outside any project (#5208). Inside a project
558
+ * the copy is never read, so the pull writes none and removes one it finds,
559
+ * whatever it learned; and when a pulled version carries a schema the
560
+ * project has no file for, it says once what follows and how to keep it.
451
561
  */
452
562
  export declare function planDocumentSchemaPull(options: {
453
563
  configDir: string;
454
564
  functions: readonly PulledFunctionSchema[];
455
565
  /** True when the pull read every active function the app has. */
456
566
  coversEveryFunction: boolean;
567
+ /** Whether the tree belongs to a project; defaults to `projectRootFor`'s answer. */
568
+ inProject?: boolean;
457
569
  }): DocumentSchemaPullPlan;
458
570
  /** What one `applyFunctionPull` actually did. */
459
571
  export interface FunctionPullOutcome {
@@ -461,6 +573,8 @@ export interface FunctionPullOutcome {
461
573
  writtenSources: string[];
462
574
  /** One line per file the write step refused. */
463
575
  refusals: string[];
576
+ /** The tree-relative paths a planned removal deleted (#5208). */
577
+ removed: string[];
464
578
  }
465
579
  /**
466
580
  * Write a plan's files, creating the directories they need.