primitive-admin 1.2.0-alpha.13 → 1.2.0-alpha.15

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 (324) hide show
  1. package/README.md +102 -78
  2. package/assets/skill/skills/primitive-platform/SKILL.md +87 -23
  3. package/dist/bin/primitive.js +11 -82
  4. package/dist/bin/primitive.js.map +1 -1
  5. package/dist/src/commands/admins.js +79 -17
  6. package/dist/src/commands/admins.js.map +1 -1
  7. package/dist/src/commands/agent-sessions.js +2 -0
  8. package/dist/src/commands/agent-sessions.js.map +1 -1
  9. package/dist/src/commands/analytics.js +220 -18
  10. package/dist/src/commands/analytics.js.map +1 -1
  11. package/dist/src/commands/apps-children.js +2 -0
  12. package/dist/src/commands/apps-children.js.map +1 -1
  13. package/dist/src/commands/apps.js +19 -2
  14. package/dist/src/commands/apps.js.map +1 -1
  15. package/dist/src/commands/auth.js +11 -1
  16. package/dist/src/commands/auth.js.map +1 -1
  17. package/dist/src/commands/collections.js +13 -0
  18. package/dist/src/commands/collections.js.map +1 -1
  19. package/dist/src/commands/config.d.ts +1 -1
  20. package/dist/src/commands/config.js +40 -9
  21. package/dist/src/commands/config.js.map +1 -1
  22. package/dist/src/commands/connections.js +2 -0
  23. package/dist/src/commands/connections.js.map +1 -1
  24. package/dist/src/commands/database-type-configs.js +5 -3
  25. package/dist/src/commands/database-type-configs.js.map +1 -1
  26. package/dist/src/commands/databases.js +6 -4
  27. package/dist/src/commands/databases.js.map +1 -1
  28. package/dist/src/commands/db3-types.js +2 -0
  29. package/dist/src/commands/db3-types.js.map +1 -1
  30. package/dist/src/commands/db3.d.ts +12 -0
  31. package/dist/src/commands/db3.js +345 -11
  32. package/dist/src/commands/db3.js.map +1 -1
  33. package/dist/src/commands/documents.d.ts +52 -12
  34. package/dist/src/commands/documents.js +120 -29
  35. package/dist/src/commands/documents.js.map +1 -1
  36. package/dist/src/commands/email-templates.js +72 -0
  37. package/dist/src/commands/email-templates.js.map +1 -1
  38. package/dist/src/commands/functions.js +47 -10
  39. package/dist/src/commands/functions.js.map +1 -1
  40. package/dist/src/commands/groups.js +18 -3
  41. package/dist/src/commands/groups.js.map +1 -1
  42. package/dist/src/commands/init.js +7 -1
  43. package/dist/src/commands/init.js.map +1 -1
  44. package/dist/src/commands/integrations.js +80 -47
  45. package/dist/src/commands/integrations.js.map +1 -1
  46. package/dist/src/commands/metadata-category-configs.js +2 -0
  47. package/dist/src/commands/metadata-category-configs.js.map +1 -1
  48. package/dist/src/commands/metadata.js +41 -0
  49. package/dist/src/commands/metadata.js.map +1 -1
  50. package/dist/src/commands/prompts.js +73 -47
  51. package/dist/src/commands/prompts.js.map +1 -1
  52. package/dist/src/commands/rule-sets.js +2 -0
  53. package/dist/src/commands/rule-sets.js.map +1 -1
  54. package/dist/src/commands/schemas.d.ts +15 -0
  55. package/dist/src/commands/schemas.js +122 -0
  56. package/dist/src/commands/schemas.js.map +1 -0
  57. package/dist/src/commands/secrets.js +45 -3
  58. package/dist/src/commands/secrets.js.map +1 -1
  59. package/dist/src/commands/sessions.js +2 -0
  60. package/dist/src/commands/sessions.js.map +1 -1
  61. package/dist/src/commands/sync-schemas.d.ts +202 -0
  62. package/dist/src/commands/sync-schemas.js +629 -0
  63. package/dist/src/commands/sync-schemas.js.map +1 -0
  64. package/dist/src/commands/sync-user-properties.d.ts +118 -0
  65. package/dist/src/commands/sync-user-properties.js +276 -0
  66. package/dist/src/commands/sync-user-properties.js.map +1 -0
  67. package/dist/src/commands/sync.d.ts +243 -12
  68. package/dist/src/commands/sync.js +1474 -314
  69. package/dist/src/commands/sync.js.map +1 -1
  70. package/dist/src/commands/user-properties.d.ts +14 -0
  71. package/dist/src/commands/user-properties.js +79 -0
  72. package/dist/src/commands/user-properties.js.map +1 -0
  73. package/dist/src/commands/users.js +912 -18
  74. package/dist/src/commands/users.js.map +1 -1
  75. package/dist/src/commands/waitlist.js +39 -4
  76. package/dist/src/commands/waitlist.js.map +1 -1
  77. package/dist/src/lib/analytics-query.d.ts +58 -0
  78. package/dist/src/lib/analytics-query.js +134 -0
  79. package/dist/src/lib/analytics-query.js.map +1 -0
  80. package/dist/src/lib/api-client.d.ts +779 -95
  81. package/dist/src/lib/api-client.js +369 -166
  82. package/dist/src/lib/api-client.js.map +1 -1
  83. package/dist/src/lib/block-selector.d.ts +9 -15
  84. package/dist/src/lib/block-selector.js +9 -20
  85. package/dist/src/lib/block-selector.js.map +1 -1
  86. package/dist/src/lib/cli-manifest.d.ts +8 -0
  87. package/dist/src/lib/cli-manifest.js +10 -1
  88. package/dist/src/lib/cli-manifest.js.map +1 -1
  89. package/dist/src/lib/cli-version.d.ts +14 -0
  90. package/dist/src/lib/cli-version.js +38 -0
  91. package/dist/src/lib/cli-version.js.map +1 -0
  92. package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
  93. package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
  94. package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
  95. package/dist/src/lib/command-status.d.ts +110 -0
  96. package/dist/src/lib/command-status.js +184 -0
  97. package/dist/src/lib/command-status.js.map +1 -0
  98. package/dist/src/lib/config-object-descriptor.d.ts +6 -0
  99. package/dist/src/lib/config-object-descriptor.js +71 -0
  100. package/dist/src/lib/config-object-descriptor.js.map +1 -1
  101. package/dist/src/lib/config-toml.d.ts +11 -2
  102. package/dist/src/lib/config-toml.js +25 -2
  103. package/dist/src/lib/config-toml.js.map +1 -1
  104. package/dist/src/lib/data-input.d.ts +1 -1
  105. package/dist/src/lib/data-input.js +1 -1
  106. package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
  107. package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
  108. package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
  109. package/dist/src/lib/db-codegen/dbTypeIR.d.ts +11 -1
  110. package/dist/src/lib/db-codegen/dbTypeIR.js +11 -5
  111. package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
  112. package/dist/src/lib/db-type-records.d.ts +95 -0
  113. package/dist/src/lib/db-type-records.js +219 -0
  114. package/dist/src/lib/db-type-records.js.map +1 -0
  115. package/dist/src/lib/db3-export.d.ts +65 -9
  116. package/dist/src/lib/db3-export.js +159 -22
  117. package/dist/src/lib/db3-export.js.map +1 -1
  118. package/dist/src/lib/db3-index-output.d.ts +69 -3
  119. package/dist/src/lib/db3-index-output.js +142 -4
  120. package/dist/src/lib/db3-index-output.js.map +1 -1
  121. package/dist/src/lib/db3-type-models.d.ts +39 -7
  122. package/dist/src/lib/db3-type-models.js +138 -27
  123. package/dist/src/lib/db3-type-models.js.map +1 -1
  124. package/dist/src/lib/deprecation.d.ts +2 -2
  125. package/dist/src/lib/deprecation.js +2 -2
  126. package/dist/src/lib/experimental-apis.d.ts +36 -0
  127. package/dist/src/lib/experimental-apis.js +46 -0
  128. package/dist/src/lib/experimental-apis.js.map +1 -0
  129. package/dist/src/lib/file-attachment.d.ts +24 -0
  130. package/dist/src/lib/file-attachment.js +31 -0
  131. package/dist/src/lib/file-attachment.js.map +1 -0
  132. package/dist/src/lib/function-authorize-check.d.ts +1 -1
  133. package/dist/src/lib/function-authorize-check.js +2 -1
  134. package/dist/src/lib/function-authorize-check.js.map +1 -1
  135. package/dist/src/lib/function-authorize-view.js +4 -0
  136. package/dist/src/lib/function-authorize-view.js.map +1 -1
  137. package/dist/src/lib/function-bundle.d.ts +27 -5
  138. package/dist/src/lib/function-bundle.js +106 -7
  139. package/dist/src/lib/function-bundle.js.map +1 -1
  140. package/dist/src/lib/function-collect.d.ts +2 -0
  141. package/dist/src/lib/function-collect.js +36 -7
  142. package/dist/src/lib/function-collect.js.map +1 -1
  143. package/dist/src/lib/function-db-types.d.ts +57 -40
  144. package/dist/src/lib/function-db-types.js +246 -285
  145. package/dist/src/lib/function-db-types.js.map +1 -1
  146. package/dist/src/lib/function-document-types.d.ts +19 -7
  147. package/dist/src/lib/function-document-types.js +24 -12
  148. package/dist/src/lib/function-document-types.js.map +1 -1
  149. package/dist/src/lib/function-run.d.ts +1 -1
  150. package/dist/src/lib/function-run.js +1 -1
  151. package/dist/src/lib/function-run.js.map +1 -1
  152. package/dist/src/lib/function-schema-codegen.d.ts +58 -18
  153. package/dist/src/lib/function-schema-codegen.js +85 -74
  154. package/dist/src/lib/function-schema-codegen.js.map +1 -1
  155. package/dist/src/lib/function-schema-refs.d.ts +98 -0
  156. package/dist/src/lib/function-schema-refs.js +177 -0
  157. package/dist/src/lib/function-schema-refs.js.map +1 -0
  158. package/dist/src/lib/function-sync.d.ts +38 -4
  159. package/dist/src/lib/function-sync.js +83 -14
  160. package/dist/src/lib/function-sync.js.map +1 -1
  161. package/dist/src/lib/function-typecheck.d.ts +52 -0
  162. package/dist/src/lib/function-typecheck.js +171 -54
  163. package/dist/src/lib/function-typecheck.js.map +1 -1
  164. package/dist/src/lib/generated-build-flags.d.ts +13 -0
  165. package/dist/src/lib/generated-build-flags.js +14 -0
  166. package/dist/src/lib/generated-build-flags.js.map +1 -0
  167. package/dist/src/lib/generated-config-surfaces.d.ts +211 -11
  168. package/dist/src/lib/generated-config-surfaces.js +579 -69
  169. package/dist/src/lib/generated-config-surfaces.js.map +1 -1
  170. package/dist/src/lib/generated-sdk-types.d.ts +1 -1
  171. package/dist/src/lib/generated-sdk-types.js +1 -1
  172. package/dist/src/lib/generated-sdk-types.js.map +1 -1
  173. package/dist/src/lib/integration-test-request.d.ts +54 -0
  174. package/dist/src/lib/integration-test-request.js +207 -0
  175. package/dist/src/lib/integration-test-request.js.map +1 -0
  176. package/dist/src/lib/log-inspection.d.ts +3 -0
  177. package/dist/src/lib/log-inspection.js +1 -0
  178. package/dist/src/lib/log-inspection.js.map +1 -1
  179. package/dist/src/lib/metadata-report.d.ts +85 -0
  180. package/dist/src/lib/metadata-report.js +81 -0
  181. package/dist/src/lib/metadata-report.js.map +1 -0
  182. package/dist/src/lib/output.d.ts +1 -1
  183. package/dist/src/lib/output.js +1 -1
  184. package/dist/src/lib/platform-owned.js +5 -0
  185. package/dist/src/lib/platform-owned.js.map +1 -1
  186. package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
  187. package/dist/src/lib/primitive-declaration-names.js +22 -0
  188. package/dist/src/lib/primitive-declaration-names.js.map +1 -0
  189. package/dist/src/lib/primitive-declaration.d.ts +143 -0
  190. package/dist/src/lib/primitive-declaration.js +658 -0
  191. package/dist/src/lib/primitive-declaration.js.map +1 -0
  192. package/dist/src/lib/prompt-schema-codegen.d.ts +36 -12
  193. package/dist/src/lib/prompt-schema-codegen.js +82 -98
  194. package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
  195. package/dist/src/lib/prompt-schema-document.d.ts +35 -0
  196. package/dist/src/lib/prompt-schema-document.js +92 -0
  197. package/dist/src/lib/prompt-schema-document.js.map +1 -0
  198. package/dist/src/lib/prompt-schema-refs.d.ts +164 -0
  199. package/dist/src/lib/prompt-schema-refs.js +452 -0
  200. package/dist/src/lib/prompt-schema-refs.js.map +1 -0
  201. package/dist/src/lib/records-verbs.d.ts +12 -2
  202. package/dist/src/lib/records-verbs.js +7 -2
  203. package/dist/src/lib/records-verbs.js.map +1 -1
  204. package/dist/src/lib/register-commands.d.ts +28 -0
  205. package/dist/src/lib/register-commands.js +101 -0
  206. package/dist/src/lib/register-commands.js.map +1 -0
  207. package/dist/src/lib/retired-imports.d.ts +53 -0
  208. package/dist/src/lib/retired-imports.js +120 -0
  209. package/dist/src/lib/retired-imports.js.map +1 -0
  210. package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
  211. package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
  212. package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
  213. package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
  214. package/dist/src/lib/schema-codegen/generated-db3-bridge.js +221 -0
  215. package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
  216. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
  217. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
  218. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
  219. package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +209 -0
  220. package/dist/src/lib/schema-codegen/generated-field-grammar.js +379 -0
  221. package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
  222. package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
  223. package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
  224. package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
  225. package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
  226. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
  227. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
  228. package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +129 -0
  229. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +154 -1
  230. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -1
  231. package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
  232. package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
  233. package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
  234. package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
  235. package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
  236. package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
  237. package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
  238. package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
  239. package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
  240. package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
  241. package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
  242. package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
  243. package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
  244. package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
  245. package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
  246. package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
  247. package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
  248. package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
  249. package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
  250. package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
  251. package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
  252. package/dist/src/lib/schema-codegen/schemaToTs.d.ts +40 -13
  253. package/dist/src/lib/schema-codegen/schemaToTs.js +124 -160
  254. package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -1
  255. package/dist/src/lib/schema-codegen/valuesLists.d.ts +35 -0
  256. package/dist/src/lib/schema-codegen/valuesLists.js +128 -0
  257. package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
  258. package/dist/src/lib/schema-family-index.d.ts +228 -0
  259. package/dist/src/lib/schema-family-index.js +813 -0
  260. package/dist/src/lib/schema-family-index.js.map +1 -0
  261. package/dist/src/lib/schema-pins.d.ts +82 -0
  262. package/dist/src/lib/schema-pins.js +198 -0
  263. package/dist/src/lib/schema-pins.js.map +1 -0
  264. package/dist/src/lib/schema-preview.d.ts +244 -0
  265. package/dist/src/lib/schema-preview.js +498 -0
  266. package/dist/src/lib/schema-preview.js.map +1 -0
  267. package/dist/src/lib/skill-installer.d.ts +2 -2
  268. package/dist/src/lib/skill-installer.js +2 -21
  269. package/dist/src/lib/skill-installer.js.map +1 -1
  270. package/dist/src/lib/step-run-table.d.ts +1 -2
  271. package/dist/src/lib/step-run-table.js +1 -2
  272. package/dist/src/lib/step-run-table.js.map +1 -1
  273. package/dist/src/lib/swift-codegen/agentGenerator.d.ts +2 -1
  274. package/dist/src/lib/swift-codegen/agentGenerator.js +24 -22
  275. package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
  276. package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
  277. package/dist/src/lib/swift-codegen/banners.js +12 -0
  278. package/dist/src/lib/swift-codegen/banners.js.map +1 -1
  279. package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
  280. package/dist/src/lib/swift-codegen/functionGenerator.js +167 -50
  281. package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
  282. package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +31 -7
  283. package/dist/src/lib/swift-codegen/schemaToSwift.js +213 -177
  284. package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
  285. package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +45 -0
  286. package/dist/src/lib/swift-codegen/sharedGenerator.js +120 -0
  287. package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
  288. package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
  289. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
  290. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
  291. package/dist/src/lib/sync-resource-types.d.ts +37 -5
  292. package/dist/src/lib/sync-resource-types.js +53 -5
  293. package/dist/src/lib/sync-resource-types.js.map +1 -1
  294. package/dist/src/lib/sync-selectors.d.ts +7 -0
  295. package/dist/src/lib/sync-selectors.js +22 -2
  296. package/dist/src/lib/sync-selectors.js.map +1 -1
  297. package/dist/src/lib/test-runs.d.ts +45 -0
  298. package/dist/src/lib/test-runs.js +150 -0
  299. package/dist/src/lib/test-runs.js.map +1 -0
  300. package/dist/src/lib/test-users.d.ts +25 -0
  301. package/dist/src/lib/test-users.js +36 -0
  302. package/dist/src/lib/test-users.js.map +1 -0
  303. package/dist/src/lib/toml-database-config.d.ts +2 -1
  304. package/dist/src/lib/toml-database-config.js +4 -3
  305. package/dist/src/lib/toml-database-config.js.map +1 -1
  306. package/dist/src/lib/toml-scalar-edit.js +6 -4
  307. package/dist/src/lib/toml-scalar-edit.js.map +1 -1
  308. package/dist/src/lib/user-index.d.ts +80 -0
  309. package/dist/src/lib/user-index.js +166 -0
  310. package/dist/src/lib/user-index.js.map +1 -0
  311. package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
  312. package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
  313. package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
  314. package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
  315. package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
  316. package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
  317. package/dist/src/lib/user-walk.d.ts +31 -0
  318. package/dist/src/lib/user-walk.js +102 -0
  319. package/dist/src/lib/user-walk.js.map +1 -0
  320. package/dist/src/lib/worker-perf-format.d.ts +22 -0
  321. package/dist/src/lib/worker-perf-format.js +27 -0
  322. package/dist/src/lib/worker-perf-format.js.map +1 -0
  323. package/dist/src/types/index.d.ts +13 -34
  324. package/package.json +5 -3
@@ -0,0 +1,202 @@
1
+ /**
2
+ * `schemas/<file>.toml` in `config push`, `pull` and `diff` (#5532, project
3
+ * `unified-schemas` phase 3).
4
+ *
5
+ * A `schemas/` file holds shared shapes, one `[defs.<Name>]` table each. It is
6
+ * read and compiled with the server's own module (the vendored
7
+ * `generated-schema-file.ts`), so the preflight refuses exactly what the push
8
+ * route would, and a push sends the compile beside the source for the server
9
+ * to recompile and compare. Each push of a changed file is a new immutable
10
+ * version; an identical file is skipped, a file changed only on the server is
11
+ * declined (`config pull` takes it, `--force` overwrites it), and one changed
12
+ * on both sides is a conflict. A selection carries the `schemas/` files its
13
+ * refs reach, in any spelling, pushed dependencies first.
14
+ *
15
+ * #5533 — a file's defs may ref another file's defs; the tree's family index
16
+ * (`loadSchemaFamilyIndex`) compiles the files in dependency order and
17
+ * refuses a cycle of files. A push carries each def's provenance, and a file
18
+ * whose source is unchanged is pushed again when its compile changed because
19
+ * a file it refs did.
20
+ */
21
+ import type { ApiClient } from "../lib/api-client.js";
22
+ import { type LocalSchemaFile, type RemoteDb3TypeRecord } from "../lib/schema-family-index.js";
23
+ import { type SchemaPin } from "../lib/schema-pins.js";
24
+ import { type SchemaPreview } from "../lib/schema-preview.js";
25
+ import { type PullWriteTally } from "../lib/pull-write.js";
26
+ import { type SyncSelection } from "../lib/sync-selectors.js";
27
+ import type { SyncState } from "../types/index.js";
28
+ /** The directory of the shared shapes in a tree. */
29
+ export declare const SCHEMAS_DIR = "schemas";
30
+ /** The type label push, pull and diff report a file under. */
31
+ export declare const SCHEMA_LABEL = "schema";
32
+ export type { LocalSchemaFile } from "../lib/schema-family-index.js";
33
+ /** A `schemas:` ref naming a file the tree does not have. */
34
+ export interface MissingSchemaFile {
35
+ /** The tree-relative file holding the ref. */
36
+ from: string;
37
+ ref: string;
38
+ file: string;
39
+ }
40
+ /**
41
+ * The `schemas/` files a push of `selection` must carry: every file a ref to a
42
+ * shared def reaches (`schemas:<file>#/$defs/<Name>`, `ref = "schemas.<file>.<Name>"`,
43
+ * or a short form the tree resolves) from the selected functions, prompts
44
+ * (agent tables included) and `schemas/` files, and the files those reach in
45
+ * turn, to a fixpoint. A ref to a file the tree does not have is listed under
46
+ * `missing`. With no selection, every file is a start.
47
+ */
48
+ export declare function schemaDependenciesOf(configDir: string, selection: SyncSelection | null): {
49
+ files: string[];
50
+ missing: MissingSchemaFile[];
51
+ };
52
+ /**
53
+ * `files` in the order a push stores them: a file after the files its refs
54
+ * name (any spelling), so a dependency in the same push is stored first. The
55
+ * files of a cycle go in name order (the preflight refuses a cycle).
56
+ */
57
+ export declare function schemaPushOrder(configDir: string, files: readonly string[]): string[];
58
+ /**
59
+ * Read and check every `schemas/*.toml` of a tree, by name: each compiled
60
+ * against the files it refs (#5533), with a file's own error, a refused cycle
61
+ * of files, or a dependency's error that its refs meet.
62
+ */
63
+ /**
64
+ * The db3 types a push applies (#5540), each with its tree file: every type
65
+ * of the tree the push selects whose stored row would bridge differently, or
66
+ * that the server does not hold. `serverRows` is the server's listing by
67
+ * name; without it (the listing is unavailable) every selected type counts.
68
+ * A type the push leaves as stored changes no compile, so the files that ref
69
+ * it keep their place.
70
+ */
71
+ export declare function appliedDb3Types(configDir: string, selection: SyncSelection | null, serverRows: ReadonlyMap<string, RemoteDb3TypeRecord> | null): Map<string, string>;
72
+ /**
73
+ * Before a push compiles (#5540): when a function, prompt or `schemas/` file
74
+ * of the tree writes a db3 ref (or a `<key>.<part>` short form, which a
75
+ * server type could answer), read the server's db3 types once and tell the
76
+ * tree's index, so a type the tree lacks resolves against its stored row and
77
+ * its name counts for the short forms. Under `--only`, the files the push
78
+ * carries compile against the server's row for a type of the tree it does not
79
+ * select, as the server will. Reads nothing for a tree with no such ref.
80
+ * Answers one error per such type the server does not hold either.
81
+ */
82
+ export declare function prepareDb3SchemaRefs(input: {
83
+ configDir: string;
84
+ selection: SyncSelection | null;
85
+ client: {
86
+ listDatabaseTypeConfigs(): Promise<any[]>;
87
+ };
88
+ }): Promise<string[]>;
89
+ /**
90
+ * `config push`'s two schemas legs (#5540): a file whose closure (through
91
+ * the other `files`) reaches a db3 type in `applied` goes after the db3 legs,
92
+ * so the type is stored before the server compiles the file; every other
93
+ * file keeps its place before every family. Each leg is in dependency order;
94
+ * `reasons` names, for each deferred file, the type files it waits for.
95
+ */
96
+ export declare function partitionSchemaFilesForPush(configDir: string, files: readonly string[], applied: ReadonlyMap<string, string>): {
97
+ first: string[];
98
+ afterDb3: string[];
99
+ reasons: Map<string, string[]>;
100
+ };
101
+ export declare function readLocalSchemaFiles(configDir: string): LocalSchemaFile[];
102
+ /**
103
+ * The preflight for `schemas/`: an error line for each selected file the push
104
+ * route would refuse. A function's, a prompt's (#5534) or a file's ref to a
105
+ * missing file is its own compile error (#5533), so nothing is left to warn
106
+ * about; `warnings` stays for callers that print them.
107
+ */
108
+ export declare function collectSchemaPreflight(configDir: string, selection: SyncSelection | null): {
109
+ errors: string[];
110
+ warnings: string[];
111
+ };
112
+ /** What `config push`'s schemas leg reports into the push's own bookkeeping. */
113
+ export interface SchemaPushContext {
114
+ client: Pick<ApiClient, "listSchemaFiles" | "pushSchemaFile" | "getSchemaFile">;
115
+ appId: string;
116
+ configDir: string;
117
+ selection: SyncSelection | null;
118
+ /** #5540 — the files this leg pushes, of those selected; every selected file when absent. */
119
+ files?: readonly string[];
120
+ syncState: SyncState | null;
121
+ dryRun: boolean;
122
+ force: boolean;
123
+ isCrossAppPush: boolean;
124
+ changes: Array<{
125
+ type: string;
126
+ action: string;
127
+ key: string;
128
+ }>;
129
+ /** A skipped (unchanged) file. */
130
+ skipped: () => void;
131
+ /** The server moved and the file did not: not pushed. */
132
+ drift: (file: string, localHash: string, remoteHash: string) => void;
133
+ /** Both moved, or the server refused the version the push was made against: not pushed. */
134
+ conflict: (file: string, direction: "both-changed" | "unknown-direction", localHash: string, remoteHash: string, serverModifiedAt: string | undefined, hint: string) => void;
135
+ /** An apply that failed: named, and the push exits 1. */
136
+ fail: (file: string, message: string) => void;
137
+ }
138
+ /**
139
+ * `config push`'s schemas leg, which runs before every family that may
140
+ * reference a shape: each selected file pushed when it changed, in
141
+ * dependency order. A file is judged against the live current version and
142
+ * the recorded baseline: unchanged is skipped, a version moved on the server
143
+ * with the file unchanged since the baseline is declined (drift), and one
144
+ * moved with the file edited too is a conflict, unless `--force`. A push is
145
+ * pinned to the live version it was judged against.
146
+ */
147
+ export declare function pushSchemaFiles(ctx: SchemaPushContext): Promise<void>;
148
+ /**
149
+ * `config pull`'s schemas leg: every live file's source, the selected ones
150
+ * written to `schemas/<file>.toml` byte for byte. Answers the state entries
151
+ * of the files written and every live file's name, for the prune that
152
+ * removes a managed file the server tombstoned or no longer has.
153
+ */
154
+ export declare function pullSchemaFilesLeg(input: {
155
+ client: Pick<ApiClient, "pullSchemaFiles">;
156
+ appId: string;
157
+ configDir: string;
158
+ /** Which of the live files to write. */
159
+ selected: (file: string) => boolean;
160
+ tally?: PullWriteTally;
161
+ }): Promise<{
162
+ entities: NonNullable<SyncState["entities"]["schemas"]>;
163
+ serverKeys: string[];
164
+ }>;
165
+ /** The `config diff` statuses the schemas rows use, the vocabulary every row shares. */
166
+ export interface SchemaDiffStatuses {
167
+ synced: string;
168
+ modified: string;
169
+ invalid: string;
170
+ localOnly: (file: string) => string;
171
+ remoteOnly: (file: string) => string;
172
+ }
173
+ /**
174
+ * Whether `config diff` reads a local file's stored current version: when the
175
+ * file refs other files (#5533) or db3 models (#5543), whose current state its
176
+ * pins are judged against, or when its source differs (the stored version may
177
+ * ref what the local one no longer does). An unchanged file with no such refs
178
+ * reads nothing.
179
+ */
180
+ export declare function schemaFileReadsPins(local: Pick<LocalSchemaFile, "edges" | "db3Edges" | "sourceHash">, remote: {
181
+ sourceHash?: string | null;
182
+ }): boolean;
183
+ /**
184
+ * `config diff`'s rows for `schemas/`: each local file against the live
185
+ * current version (by source hash, classified by which side moved since the
186
+ * last sync), and each live file with no local file.
187
+ */
188
+ export declare function diffSchemaRows(input: {
189
+ client: Pick<ApiClient, "listSchemaFiles" | "getSchemaFile">;
190
+ appId: string;
191
+ configDir: string;
192
+ syncState: SyncState | null;
193
+ statuses: SchemaDiffStatuses;
194
+ /** #5533 — the judge of each version's pinned defs, shared with the function rows. */
195
+ pins?: (provenance: unknown) => Promise<SchemaPin[]>;
196
+ }): Promise<Array<{
197
+ key: string;
198
+ status: string;
199
+ hint?: string;
200
+ pins?: SchemaPin[];
201
+ schemas?: SchemaPreview[];
202
+ }>>;