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
@@ -1,10 +1,18 @@
1
+ import { Option } from "commander";
1
2
  import { ApiClient } from "../lib/api-client.js";
3
+ import { commandStatus } from "../lib/command-status.js";
2
4
  import { resolveAppId } from "../lib/config.js";
3
5
  import { error, info, formatTable, formatId, formatDate, formatNumber, formatPercent, formatDuration, json, heading, result as printResult, dim, } from "../lib/output.js";
4
6
  import { buildActivityEnvelope } from "../lib/log-inspection.js";
7
+ // #5105 — `--test-users`, one flag and one value list with `users list`.
8
+ import { analyticsTestUsersOption, printTestUsersLine, testUsersParam, } from "../lib/test-users.js";
9
+ // #5251 — `--where`, one filter grammar for every filtered analytics read, and
10
+ // `--fresh` on every reader, and the anonymous user's segment.
11
+ import { ANONYMOUS_USER_SEGMENT, ERROR_FILTER_FIELDS, EVENT_FILTER_FIELDS, analyticsFreshOption, filtersArg, freshParam, whereFilters, whereOption, } from "../lib/analytics-query.js";
12
+ // #5244 — the db3 query and request readers' cells.
13
+ import { DB3_QUERIES_ORDER_BY, db3QueryCaller, formatFigure, requestFunction, } from "../lib/worker-perf-format.js";
5
14
  // #3787 — per-prompt cost cells, with the cost-unknown and partial-window rules.
6
15
  import { formatAvgCostCell, formatCostCell, } from "../lib/prompt-cost-format.js";
7
- import { ALL_APPS_CONFLICT_ERROR, ALL_APPS_SUPER_ADMIN_ERROR, isAbortStatus, isSuperAdminRole, mergeUsageReports, parseWindowDaysFlag, renderMergedUsageReport, renderUsageReport, usageExitCode, USAGE_CLI_DEFAULT_WINDOW_DAYS, USAGE_CLI_MAX_WINDOW_DAYS, USAGE_CLI_MIN_WINDOW_DAYS, } from "../lib/workflow-usage.js";
8
16
  /** Format a value that is already a percentage (e.g. 33.3 → "33.3%") */
9
17
  function formatPctRaw(value) {
10
18
  if (value === undefined || value === null)
@@ -22,18 +30,24 @@ export function registerAnalyticsCommands(program) {
22
30
  .addHelpText("after", `
23
31
  Examples:
24
32
  $ primitive analytics overview
33
+ $ primitive analytics overview --test-users include
34
+ $ primitive analytics overview --fresh
25
35
  $ primitive analytics daily-active --window-days 14
26
36
  $ primitive analytics top-users --limit 20
27
37
  $ primitive analytics user-search --query user@example.com
28
38
  $ primitive analytics user-detail <user-ulid>
39
+ $ primitive analytics user-detail --anonymous
29
40
  $ primitive analytics events --window-days 7 --page 0
41
+ $ primitive analytics events --where action=login --where country!=US
30
42
  $ primitive analytics events-grouped --group-by feature
31
43
  $ primitive analytics errors-groups --window-days 14 --limit 100
44
+ $ primitive analytics errors-groups --where source!=integration
45
+ $ primitive analytics db3-queries --order-by rows-per-returned
46
+ $ primitive analytics requests --window-days 30
32
47
  $ primitive analytics cohort-retention
33
- $ primitive analytics workflows --limit 5
34
48
  $ primitive analytics prompts --window-days 14
35
- $ primitive analytics workflow-usage --window-days 30 --all-apps --json
36
49
  `);
50
+ commandStatus(analytics, { stability: "production" });
37
51
  // ── Overview (DAU / WAU / MAU / Growth) ──────────────────────────
38
52
  analytics
39
53
  .command("overview")
@@ -41,17 +55,24 @@ Examples:
41
55
  .argument("[app-id]", "App ID (uses current app if not specified)")
42
56
  .option("--app <app-id>", "App ID")
43
57
  .option("--window-days <n>", "Growth window in days", "28")
58
+ .addOption(analyticsTestUsersOption("exclude"))
59
+ .addOption(analyticsFreshOption())
44
60
  .option("--json", "Output as JSON")
45
61
  .action(async (appId, options) => {
46
62
  const resolvedAppId = resolveAppId(appId, options);
47
63
  const client = new ApiClient();
48
64
  try {
65
+ const testUsers = {
66
+ ...testUsersParam(options.testUsers),
67
+ ...freshParam(options.fresh),
68
+ };
49
69
  const [dau, wau, mau, growth] = await Promise.all([
50
- client.getAnalyticsOverviewDau(resolvedAppId),
51
- client.getAnalyticsOverviewWau(resolvedAppId),
52
- client.getAnalyticsOverviewMau(resolvedAppId),
70
+ client.getAnalyticsOverviewDau(resolvedAppId, testUsers),
71
+ client.getAnalyticsOverviewWau(resolvedAppId, testUsers),
72
+ client.getAnalyticsOverviewMau(resolvedAppId, testUsers),
53
73
  client.getAnalyticsOverviewGrowth(resolvedAppId, {
54
74
  windowDays: parseInt(options.windowDays),
75
+ ...testUsers,
55
76
  }),
56
77
  ]);
57
78
  if (options.json) {
@@ -59,6 +80,7 @@ Examples:
59
80
  return;
60
81
  }
61
82
  heading("Active Users");
83
+ printTestUsersLine(dau.testUsers);
62
84
  console.log();
63
85
  const formatDelta = (d) => d > 0 ? `+${(d * 100).toFixed(1)}%` : d === 0 ? "0%" : `${(d * 100).toFixed(1)}%`;
64
86
  console.log(formatTable([
@@ -94,6 +116,8 @@ Examples:
94
116
  .argument("[app-id]", "App ID (uses current app if not specified)")
95
117
  .option("--app <app-id>", "App ID")
96
118
  .option("--window-days <n>", "Time window in days (7-90)", "28")
119
+ .addOption(analyticsTestUsersOption("exclude"))
120
+ .addOption(analyticsFreshOption())
97
121
  .option("--json", "Output as JSON")
98
122
  .action(async (appId, options) => {
99
123
  const resolvedAppId = resolveAppId(appId, options);
@@ -101,12 +125,15 @@ Examples:
101
125
  try {
102
126
  const result = await client.getAnalyticsDailyActive(resolvedAppId, {
103
127
  windowDays: parseInt(options.windowDays),
128
+ ...testUsersParam(options.testUsers),
129
+ ...freshParam(options.fresh),
104
130
  });
105
131
  if (options.json) {
106
132
  json(result);
107
133
  return;
108
134
  }
109
135
  heading(`Daily Active Users (${result.window_days} days)`);
136
+ printTestUsersLine(result.testUsers);
110
137
  console.log();
111
138
  if (!result.rows || result.rows.length === 0) {
112
139
  info("No data found.");
@@ -129,6 +156,8 @@ Examples:
129
156
  .argument("[app-id]", "App ID (uses current app if not specified)")
130
157
  .option("--app <app-id>", "App ID")
131
158
  .option("--window-days <n>", "Rolling window size in days (1-28)", "7")
159
+ .addOption(analyticsTestUsersOption("exclude"))
160
+ .addOption(analyticsFreshOption())
132
161
  .option("--json", "Output as JSON")
133
162
  .action(async (appId, options) => {
134
163
  const resolvedAppId = resolveAppId(appId, options);
@@ -136,12 +165,15 @@ Examples:
136
165
  try {
137
166
  const result = await client.getAnalyticsRollingActive(resolvedAppId, {
138
167
  windowDays: parseInt(options.windowDays),
168
+ ...testUsersParam(options.testUsers),
169
+ ...freshParam(options.fresh),
139
170
  });
140
171
  if (options.json) {
141
172
  json(result);
142
173
  return;
143
174
  }
144
175
  heading(`Rolling Active Users (${result.window_days}-day window)`);
176
+ printTestUsersLine(result.testUsers);
145
177
  console.log();
146
178
  if (!result.rows || result.rows.length === 0) {
147
179
  info("No data found.");
@@ -163,17 +195,23 @@ Examples:
163
195
  .description("Weekly cohort retention matrix")
164
196
  .argument("[app-id]", "App ID (uses current app if not specified)")
165
197
  .option("--app <app-id>", "App ID")
198
+ .addOption(analyticsTestUsersOption("exclude"))
199
+ .addOption(analyticsFreshOption())
166
200
  .option("--json", "Output as JSON")
167
201
  .action(async (appId, options) => {
168
202
  const resolvedAppId = resolveAppId(appId, options);
169
203
  const client = new ApiClient();
170
204
  try {
171
- const result = await client.getAnalyticsCohortRetention(resolvedAppId);
205
+ const result = await client.getAnalyticsCohortRetention(resolvedAppId, {
206
+ ...testUsersParam(options.testUsers),
207
+ ...freshParam(options.fresh),
208
+ });
172
209
  if (options.json) {
173
210
  json(result);
174
211
  return;
175
212
  }
176
213
  heading("Cohort Retention");
214
+ printTestUsersLine(result.testUsers);
177
215
  console.log();
178
216
  if (!result.rows || result.rows.length === 0) {
179
217
  info("No cohort data found.");
@@ -225,6 +263,8 @@ Examples:
225
263
  .option("--app <app-id>", "App ID")
226
264
  .option("--window-days <n>", "Time window in days", "30")
227
265
  .option("--limit <n>", "Number of users to show", "10")
266
+ .addOption(analyticsTestUsersOption("exclude"))
267
+ .addOption(analyticsFreshOption())
228
268
  .option("--json", "Output as JSON")
229
269
  .action(async (appId, options) => {
230
270
  const resolvedAppId = resolveAppId(appId, options);
@@ -233,12 +273,15 @@ Examples:
233
273
  const result = await client.getAnalyticsTopUsers(resolvedAppId, {
234
274
  windowDays: parseInt(options.windowDays),
235
275
  limit: parseInt(options.limit),
276
+ ...testUsersParam(options.testUsers),
277
+ ...freshParam(options.fresh),
236
278
  });
237
279
  if (options.json) {
238
280
  json(result);
239
281
  return;
240
282
  }
241
283
  heading(`Top Users (${result.windowDays} days)`);
284
+ printTestUsersLine(result.testUsers);
242
285
  console.log();
243
286
  if (!result.results || result.results.length === 0) {
244
287
  info("No user activity found.");
@@ -271,14 +314,18 @@ Examples:
271
314
  .option("--signup-end-day <day>", "End of an inclusive signup range (YYYY-MM-DD)")
272
315
  .option("--offset <n>", "Row offset; page a busy day until the result is not truncated")
273
316
  .option("--limit <n>", "Max results", "25")
317
+ .addOption(analyticsTestUsersOption("exclude for a listing or a signup filter, include for --query"))
318
+ .addOption(analyticsFreshOption())
274
319
  .option("--json", "Output as JSON")
275
320
  .action(async (appId, options) => {
276
321
  const resolvedAppId = resolveAppId(appId, options);
277
322
  const client = new ApiClient();
278
323
  const hasSignupFilter = Boolean(options.signupDay || options.signupStartDay || options.signupEndDay);
279
- if (!options.query && !hasSignupFilter) {
280
- error("Give --query, or a signup filter (--signup-day, or " +
281
- "--signup-start-day with --signup-end-day).");
324
+ // #5105 — `--test-users` alone lists the most recently active users,
325
+ // filtered: asked for explicitly, it says which users to list.
326
+ if (!options.query && !hasSignupFilter && !options.testUsers) {
327
+ error("Give --query, a signup filter (--signup-day, or " +
328
+ "--signup-start-day with --signup-end-day), or --test-users.");
282
329
  process.exit(1);
283
330
  return;
284
331
  }
@@ -295,6 +342,8 @@ Examples:
295
342
  ...(options.offset !== undefined
296
343
  ? { offset: parseInt(options.offset) }
297
344
  : {}),
345
+ ...testUsersParam(options.testUsers),
346
+ ...freshParam(options.fresh),
298
347
  });
299
348
  if (options.json) {
300
349
  json(result);
@@ -302,7 +351,10 @@ Examples:
302
351
  }
303
352
  heading(hasSignupFilter
304
353
  ? `Signups: ${result.signupStartDay ?? ""} to ${result.signupEndDay ?? ""}`
305
- : `User Search: "${result.query}"`);
354
+ : options.query
355
+ ? `User Search: "${result.query}"`
356
+ : "Recently Active Users");
357
+ printTestUsersLine(result.testUsers);
306
358
  console.log();
307
359
  if (!result.results || result.results.length === 0) {
308
360
  info("No users found.");
@@ -342,22 +394,45 @@ Examples:
342
394
  analytics
343
395
  .command("user-detail")
344
396
  .description("Detailed activity for a single user")
345
- .argument("<user-ulid>", "User ULID")
397
+ .argument("[user-ulid]", "User ULID (omit with --anonymous)")
346
398
  .argument("[app-id]", "App ID (uses current app if not specified)")
347
399
  .option("--app <app-id>", "App ID")
400
+ .option("--anonymous", "Activity with no signed-in user; the one optional argument is then the app ID")
401
+ .addOption(analyticsFreshOption())
348
402
  .option("--json", "Output as JSON")
349
403
  .action(async (userUlid, appId, options) => {
404
+ // #5251 — with --anonymous there is no user to name, so the one
405
+ // positional is the app, as on every other reader.
406
+ if (options.anonymous) {
407
+ if (appId !== undefined) {
408
+ error("--anonymous takes at most one argument, the app ID.");
409
+ process.exit(1);
410
+ return;
411
+ }
412
+ appId = userUlid;
413
+ userUlid = ANONYMOUS_USER_SEGMENT;
414
+ }
415
+ else if (!userUlid) {
416
+ error("Give a user ULID, or --anonymous for anonymous activity.");
417
+ process.exit(1);
418
+ return;
419
+ }
350
420
  const resolvedAppId = resolveAppId(appId, options);
351
421
  const client = new ApiClient();
352
422
  try {
353
- const result = await client.getAnalyticsUserDetail(resolvedAppId, userUlid);
423
+ const result = await client.getAnalyticsUserDetail(resolvedAppId, userUlid, freshParam(options.fresh));
354
424
  if (options.json) {
355
425
  json(result);
356
426
  return;
357
427
  }
358
428
  heading("User Detail");
359
429
  console.log();
360
- printResult("ULID", result.user.user_ulid);
430
+ if (options.anonymous) {
431
+ printResult("User", "anonymous");
432
+ }
433
+ else {
434
+ printResult("ULID", result.user.user_ulid);
435
+ }
361
436
  if (result.user.email)
362
437
  printResult("Email", result.user.email);
363
438
  if (result.user.name)
@@ -400,12 +475,13 @@ Examples:
400
475
  .argument("<user-ulid>", "User ULID")
401
476
  .argument("[app-id]", "App ID (uses current app if not specified)")
402
477
  .option("--app <app-id>", "App ID")
478
+ .addOption(analyticsFreshOption())
403
479
  .option("--json", "Output as JSON")
404
480
  .action(async (userUlid, appId, options) => {
405
481
  const resolvedAppId = resolveAppId(appId, options);
406
482
  const client = new ApiClient();
407
483
  try {
408
- const result = await client.getAnalyticsUserSnapshot(resolvedAppId, userUlid);
484
+ const result = await client.getAnalyticsUserSnapshot(resolvedAppId, userUlid, freshParam(options.fresh));
409
485
  if (options.json) {
410
486
  json(result);
411
487
  return;
@@ -434,19 +510,25 @@ Examples:
434
510
  .option("--window-days <n>", "Time window in days", "7")
435
511
  .option("--page <n>", "Page number (0-based)", "0")
436
512
  .option("--user-id <id>", "Filter to a single user's events")
513
+ .addOption(whereOption(EVENT_FILTER_FIELDS))
514
+ .addOption(analyticsTestUsersOption("include"))
515
+ .addOption(analyticsFreshOption())
437
516
  .option("--json", "Output as JSON")
438
517
  .action(async (appId, options) => {
439
518
  const resolvedAppId = resolveAppId(appId, options);
440
519
  const client = new ApiClient();
441
520
  try {
521
+ const filters = whereFilters(options.where, EVENT_FILTER_FIELDS);
442
522
  const result = await client.getAnalyticsEvents(resolvedAppId, {
443
523
  windowDays: parseInt(options.windowDays),
444
524
  page: parseInt(options.page),
445
525
  // The events feed filters by user via the bracketed
446
- // `filter[user][is]` syntax the analytics route already parses — not
447
- // a raw query param (behavior 11).
526
+ // `filter[user][is]` syntax the analytics route already parses —
527
+ // not a raw query param (behavior 11).
448
528
  ...(options.userId ? { "filter[user][is]": options.userId } : {}),
449
- });
529
+ ...testUsersParam(options.testUsers),
530
+ ...freshParam(options.fresh),
531
+ }, ...filtersArg(filters));
450
532
  if (options.json) {
451
533
  // Normalize the offset-paged response to the shared activity
452
534
  // envelope: `{page_size, rows}` → `{pageSize, items}` with the
@@ -456,6 +538,7 @@ Examples:
456
538
  return;
457
539
  }
458
540
  heading(`Events (page ${result.page}, ${result.total_rows} total)`);
541
+ printTestUsersLine(result.testUsers);
459
542
  console.log();
460
543
  if (!result.rows || result.rows.length === 0) {
461
544
  info("No events found.");
@@ -496,20 +579,27 @@ Examples:
496
579
  .option("--app <app-id>", "App ID")
497
580
  .option("--group-by <dim>", "Dimension: action, feature, route, country, deviceType, plan, day", "action")
498
581
  .option("--window-days <n>", "Time window in days", "7")
582
+ .addOption(whereOption(EVENT_FILTER_FIELDS))
583
+ .addOption(analyticsTestUsersOption("include"))
584
+ .addOption(analyticsFreshOption())
499
585
  .option("--json", "Output as JSON")
500
586
  .action(async (appId, options) => {
501
587
  const resolvedAppId = resolveAppId(appId, options);
502
588
  const client = new ApiClient();
503
589
  try {
590
+ const filters = whereFilters(options.where, EVENT_FILTER_FIELDS);
504
591
  const result = await client.getAnalyticsEventsGrouped(resolvedAppId, {
505
592
  groupBy: options.groupBy,
506
593
  windowDays: parseInt(options.windowDays),
507
- });
594
+ ...testUsersParam(options.testUsers),
595
+ ...freshParam(options.fresh),
596
+ }, ...filtersArg(filters));
508
597
  if (options.json) {
509
598
  json(result);
510
599
  return;
511
600
  }
512
601
  heading(`Events by ${result.group_by}`);
602
+ printTestUsersLine(result.testUsers);
513
603
  console.log();
514
604
  if (!result.rows || result.rows.length === 0) {
515
605
  info("No events found.");
@@ -536,16 +626,21 @@ Examples:
536
626
  .option("--limit <n>", "Max error groups to return", "50")
537
627
  .option("--status-class <class>", "Filter by status class: 4xx, 5xx, transport")
538
628
  .option("--source <source>", "Filter by source: workflow_run, workflow_step, integration, " +
539
- "function_invocation, function_run")
629
+ "function_invocation, function_run, analytics_relay")
630
+ // Its own registration: the #3660 test reads `--source`'s help up to `)`.
631
+ .addOption(whereOption(ERROR_FILTER_FIELDS))
540
632
  .option("--verbose", "Also print each group's exemplar (a raw sample of the failure) and where it came from")
633
+ .addOption(analyticsFreshOption())
541
634
  .option("--json", "Output as JSON")
542
635
  .action(async (appId, options) => {
543
636
  const resolvedAppId = resolveAppId(appId, options);
544
637
  const client = new ApiClient();
545
638
  try {
639
+ const filters = whereFilters(options.where, ERROR_FILTER_FIELDS);
546
640
  const params = {
547
641
  windowDays: parseInt(options.windowDays),
548
642
  limit: parseInt(options.limit),
643
+ ...freshParam(options.fresh),
549
644
  };
550
645
  if (options.statusClass) {
551
646
  params["filter[statusClass][is]"] = options.statusClass;
@@ -553,7 +648,7 @@ Examples:
553
648
  if (options.source) {
554
649
  params["filter[source][is]"] = options.source;
555
650
  }
556
- const result = await client.getAnalyticsErrorsGroups(resolvedAppId, params);
651
+ const result = await client.getAnalyticsErrorsGroups(resolvedAppId, params, ...filtersArg(filters));
557
652
  if (options.json) {
558
653
  json(result);
559
654
  return;
@@ -607,37 +702,51 @@ Examples:
607
702
  process.exit(1);
608
703
  }
609
704
  });
610
- // ── Integration Metrics ──────────────────────────────────────────
705
+ // ── Database Queries (#5244) ─────────────────────────────────────
611
706
  analytics
612
- .command("integrations")
613
- .description("Get integration usage metrics")
707
+ .command("db3-queries")
708
+ .description("List the db3 query shapes that read the most rows, per endpoint and server function")
614
709
  .argument("[app-id]", "App ID (uses current app if not specified)")
615
710
  .option("--app <app-id>", "App ID")
616
- .option("--window-days <n>", "Time window in days", "30")
711
+ .option("--window-days <n>", "Time window in days (1-90)", "7")
712
+ .option("--limit <n>", "Max rows to return (1-200)", "50")
713
+ .addOption(new Option("--order-by <order>", "Rank by rows read in total, or per row returned")
714
+ .choices(Object.keys(DB3_QUERIES_ORDER_BY))
715
+ .default("rows-read"))
716
+ .addOption(analyticsFreshOption())
617
717
  .option("--json", "Output as JSON")
618
718
  .action(async (appId, options) => {
619
719
  const resolvedAppId = resolveAppId(appId, options);
620
720
  const client = new ApiClient();
621
721
  try {
622
- const result = await client.getAnalyticsIntegrationMetrics(resolvedAppId, {
722
+ const result = await client.getAnalyticsDb3Queries(resolvedAppId, {
623
723
  windowDays: parseInt(options.windowDays),
724
+ limit: parseInt(options.limit),
725
+ orderBy: DB3_QUERIES_ORDER_BY[options.orderBy],
726
+ ...freshParam(options.fresh),
624
727
  });
625
728
  if (options.json) {
626
729
  json(result);
627
730
  return;
628
731
  }
629
- heading(`Integration Metrics (${result.windowDays} days)`);
732
+ heading(`Database queries (last ${result.window_days} days, by ${options.orderBy})`);
630
733
  console.log();
631
- if (!result.integrations || result.integrations.length === 0) {
632
- info("No integration usage found.");
734
+ if (!result.rows || result.rows.length === 0) {
735
+ info("No db3 server reads recorded in this window.");
633
736
  return;
634
737
  }
635
- console.log(formatTable(result.integrations, [
636
- { header: "INTEGRATION", key: "integrationKey" },
637
- { header: "CALLS", key: "invocations", align: "right", format: formatNumber },
638
- { header: "ERROR RATE", key: "errorRate", align: "right", format: formatPercent },
639
- { header: "MEDIAN", key: "medianDurationMs", align: "right", format: formatDuration },
640
- { header: "P95", key: "p95DurationMs", align: "right", format: formatDuration },
738
+ console.log(formatTable(result.rows.map((row) => ({ ...row, caller: db3QueryCaller(row) })), [
739
+ { header: "TYPE", key: "type" },
740
+ { header: "MODEL", key: "model" },
741
+ { header: "OP", key: "op" },
742
+ { header: "FILTER", key: "filter" },
743
+ { header: "SORT", key: "sort" },
744
+ { header: "CALLER", key: "caller" },
745
+ { header: "CALLS", key: "calls", align: "right", format: formatFigure },
746
+ { header: "ROWS READ", key: "rows_read", align: "right", format: formatFigure },
747
+ { header: "PER CALL", key: "rows_read_per_call", align: "right", format: formatFigure },
748
+ { header: "PER RETURNED", key: "rows_read_per_returned", align: "right", format: formatFigure },
749
+ { header: "SCANNED", key: "scanned_calls", align: "right", format: formatFigure },
641
750
  ]));
642
751
  }
643
752
  catch (err) {
@@ -645,40 +754,85 @@ Examples:
645
754
  process.exit(1);
646
755
  }
647
756
  });
648
- // ── Top Workflows ────────────────────────────────────────────────
649
757
  analytics
650
- .command("workflows")
651
- .description("Top workflows by runs")
758
+ .command("requests")
759
+ .description("List request wall time and DynamoDB round trips per endpoint and server function")
652
760
  .argument("[app-id]", "App ID (uses current app if not specified)")
653
761
  .option("--app <app-id>", "App ID")
654
- .option("--window-days <n>", "Time window in days", "30")
655
- .option("--limit <n>", "Number of workflows to show", "10")
762
+ .option("--window-days <n>", "Time window in days (1-90)", "7")
763
+ .option("--limit <n>", "Max rows to return (1-200)", "50")
764
+ .addOption(analyticsFreshOption())
656
765
  .option("--json", "Output as JSON")
657
766
  .action(async (appId, options) => {
658
767
  const resolvedAppId = resolveAppId(appId, options);
659
768
  const client = new ApiClient();
660
769
  try {
661
- const result = await client.getAnalyticsTopWorkflows(resolvedAppId, {
770
+ const result = await client.getAnalyticsRequests(resolvedAppId, {
662
771
  windowDays: parseInt(options.windowDays),
663
772
  limit: parseInt(options.limit),
773
+ ...freshParam(options.fresh),
664
774
  });
665
775
  if (options.json) {
666
776
  json(result);
667
777
  return;
668
778
  }
669
- heading(`Top Workflows (${result.windowDays} days)`);
779
+ heading(`Requests (last ${result.window_days} days)`);
670
780
  console.log();
671
- if (!result.workflows || result.workflows.length === 0) {
672
- info("No workflow data found.");
781
+ if (!result.rows || result.rows.length === 0) {
782
+ info("No requests recorded in this window.");
673
783
  return;
674
784
  }
675
- console.log(formatTable(result.workflows, [
676
- { header: "WORKFLOW", key: "workflowKey" },
677
- { header: "RUNS", key: "runs", align: "right", format: formatNumber },
678
- { header: "SUCCESS", key: "successRate", align: "right", format: formatPercent },
785
+ console.log(formatTable(result.rows.map((row) => ({ ...row, endpoint: `${row.method} ${row.path}`, function: requestFunction(row) })), [
786
+ { header: "ENDPOINT", key: "endpoint" },
787
+ { header: "FUNCTION", key: "function" },
788
+ { header: "REQUESTS", key: "requests", align: "right", format: formatFigure },
789
+ { header: "P50", key: "wall_ms_p50", align: "right", format: formatFigure },
790
+ { header: "P95", key: "wall_ms_p95", align: "right", format: formatFigure },
791
+ { header: "DYNAMO CALLS", key: "dynamo_calls_per_request", align: "right", format: formatFigure },
792
+ { header: "DYNAMO MS", key: "dynamo_ms_per_request", align: "right", format: formatFigure },
793
+ { header: "COLD", key: "cold_starts", align: "right", format: formatFigure },
794
+ ]));
795
+ console.log();
796
+ info("P50, P95 and DYNAMO MS are milliseconds per request; DYNAMO CALLS is calls per request.");
797
+ }
798
+ catch (err) {
799
+ error(err.message);
800
+ process.exit(1);
801
+ }
802
+ });
803
+ // ── Integration Metrics ──────────────────────────────────────────
804
+ analytics
805
+ .command("integrations")
806
+ .description("Get integration usage metrics")
807
+ .argument("[app-id]", "App ID (uses current app if not specified)")
808
+ .option("--app <app-id>", "App ID")
809
+ .option("--window-days <n>", "Time window in days", "30")
810
+ .addOption(analyticsFreshOption())
811
+ .option("--json", "Output as JSON")
812
+ .action(async (appId, options) => {
813
+ const resolvedAppId = resolveAppId(appId, options);
814
+ const client = new ApiClient();
815
+ try {
816
+ const result = await client.getAnalyticsIntegrationMetrics(resolvedAppId, {
817
+ windowDays: parseInt(options.windowDays),
818
+ ...freshParam(options.fresh),
819
+ });
820
+ if (options.json) {
821
+ json(result);
822
+ return;
823
+ }
824
+ heading(`Integration Metrics (${result.windowDays} days)`);
825
+ console.log();
826
+ if (!result.integrations || result.integrations.length === 0) {
827
+ info("No integration usage found.");
828
+ return;
829
+ }
830
+ console.log(formatTable(result.integrations, [
831
+ { header: "INTEGRATION", key: "integrationKey" },
832
+ { header: "CALLS", key: "invocations", align: "right", format: formatNumber },
833
+ { header: "ERROR RATE", key: "errorRate", align: "right", format: formatPercent },
679
834
  { header: "MEDIAN", key: "medianDurationMs", align: "right", format: formatDuration },
680
- { header: "P95", key: "p95", align: "right", format: formatDuration },
681
- { header: "TOKENS", key: "totalTokens", align: "right", format: formatNumber },
835
+ { header: "P95", key: "p95DurationMs", align: "right", format: formatDuration },
682
836
  ]));
683
837
  }
684
838
  catch (err) {
@@ -686,6 +840,7 @@ Examples:
686
840
  process.exit(1);
687
841
  }
688
842
  });
843
+ // ── Top Workflows ────────────────────────────────────────────────
689
844
  // ── Top Prompts ──────────────────────────────────────────────────
690
845
  analytics
691
846
  .command("prompts")
@@ -694,6 +849,7 @@ Examples:
694
849
  .option("--app <app-id>", "App ID")
695
850
  .option("--window-days <n>", "Time window in days", "30")
696
851
  .option("--limit <n>", "Number of prompts to show", "10")
852
+ .addOption(analyticsFreshOption())
697
853
  .option("--json", "Output as JSON")
698
854
  .action(async (appId, options) => {
699
855
  const resolvedAppId = resolveAppId(appId, options);
@@ -702,6 +858,7 @@ Examples:
702
858
  const result = await client.getAnalyticsTopPrompts(resolvedAppId, {
703
859
  windowDays: parseInt(options.windowDays),
704
860
  limit: parseInt(options.limit),
861
+ ...freshParam(options.fresh),
705
862
  });
706
863
  if (options.json) {
707
864
  json(result);
@@ -736,110 +893,5 @@ Examples:
736
893
  process.exit(1);
737
894
  }
738
895
  });
739
- // ── Workflow step usage ──────────────────────────────────────────
740
- /** Print one report's blocks: headings to stderr, bodies to stdout. */
741
- function printUsageBlocks(blocks) {
742
- for (const block of blocks) {
743
- if (block.heading) {
744
- console.log();
745
- heading(block.heading);
746
- }
747
- console.log(block.body);
748
- }
749
- }
750
- analytics
751
- .command("workflow-usage")
752
- .description("Step kinds this app's workflows configure, their runs in the window, and the sync-callable and idle workflows")
753
- .argument("[app-id]", "App ID (uses current app if not specified)")
754
- .option("--app <app-id>", "App ID")
755
- .option("--window-days <n>", `Run window in days (${USAGE_CLI_MIN_WINDOW_DAYS}-${USAGE_CLI_MAX_WINDOW_DAYS}, default ${USAGE_CLI_DEFAULT_WINDOW_DAYS})`)
756
- .option("--all-apps", "Merge the report across every app (super-admin only)")
757
- .option("--json", "Output as JSON")
758
- .action(async (appId, options) => {
759
- // Both boundary checks run before the client is constructed, so an
760
- // invalid invocation never reaches the network (principle 6).
761
- if (options.allApps && (appId || options.app)) {
762
- error(ALL_APPS_CONFLICT_ERROR);
763
- process.exit(1);
764
- }
765
- const window = parseWindowDaysFlag(options.windowDays);
766
- if ("error" in window) {
767
- error(window.error);
768
- process.exit(1);
769
- return;
770
- }
771
- // Omitted means omitted on the wire: the server applies its own default
772
- // and the CLI reports the same number for a merge that has no request.
773
- const params = window.omitted
774
- ? undefined
775
- : { windowDays: window.effective };
776
- const client = new ApiClient();
777
- if (options.allApps) {
778
- try {
779
- // The role gate comes first: GET /admin/api/apps is super-admin
780
- // only (#3882), so the client refuses anyone else with its own
781
- // message before any request rather than meeting the server's 403
782
- // (D3130-002).
783
- const me = await client.getMe();
784
- if (!isSuperAdminRole(me.role)) {
785
- error(ALL_APPS_SUPER_ADMIN_ERROR);
786
- process.exit(1);
787
- }
788
- // There is no cross-app endpoint by design (intent): the CLI calls
789
- // the per-app one once per app, over the GLOBAL apps list.
790
- const apps = await client.listAllAppsGlobal();
791
- const results = [];
792
- for (const app of apps) {
793
- try {
794
- results.push({
795
- appId: app.appId,
796
- report: await client.getWorkflowUsage(app.appId, params),
797
- });
798
- }
799
- catch (err) {
800
- // A merged report over a silently chosen subset would answer a
801
- // different question, so a refusal ends the walk.
802
- if (isAbortStatus(err?.statusCode))
803
- throw err;
804
- results.push({
805
- appId: app.appId,
806
- error: err?.message ?? String(err),
807
- });
808
- }
809
- }
810
- const merged = mergeUsageReports(window.effective, results);
811
- if (options.json) {
812
- json(merged);
813
- }
814
- else {
815
- printUsageBlocks(renderMergedUsageReport(merged));
816
- }
817
- // An incomplete report still prints, and still fails (intent).
818
- // `exitCode` rather than `exit()`: the report is already on stdout
819
- // and `process.exit` truncates a pipe's pending writes (#1004).
820
- process.exitCode = usageExitCode(merged);
821
- }
822
- catch (err) {
823
- error(err.message);
824
- process.exit(1);
825
- }
826
- return;
827
- }
828
- const resolvedAppId = resolveAppId(appId, options);
829
- try {
830
- const report = await client.getWorkflowUsage(resolvedAppId, params);
831
- if (options.json) {
832
- json(report);
833
- }
834
- else {
835
- printUsageBlocks(renderUsageReport(report));
836
- }
837
- process.exitCode = usageExitCode(report);
838
- }
839
- catch (err) {
840
- error(err.message);
841
- process.exit(1);
842
- }
843
- });
844
896
  }
845
897
  //# sourceMappingURL=analytics.js.map