tapimo 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (313) hide show
  1. package/README.md +31 -3
  2. package/dist/ApiKey.d.ts +1 -0
  3. package/dist/ApiKey.d.ts.map +1 -1
  4. package/dist/ApiKey.js +5 -2
  5. package/dist/ApiKey.js.map +1 -1
  6. package/dist/ApiKeys.d.ts +28 -1
  7. package/dist/ApiKeys.d.ts.map +1 -1
  8. package/dist/ApiKeys.js +34 -1
  9. package/dist/ApiKeys.js.map +1 -1
  10. package/dist/App.d.ts +7167 -4507
  11. package/dist/App.d.ts.map +1 -1
  12. package/dist/App.js +8 -0
  13. package/dist/App.js.map +1 -1
  14. package/dist/Scope.d.ts +11 -2
  15. package/dist/Scope.d.ts.map +1 -1
  16. package/dist/Scope.js +14 -3
  17. package/dist/Scope.js.map +1 -1
  18. package/dist/admin/App.d.ts +128 -118
  19. package/dist/admin/App.d.ts.map +1 -1
  20. package/dist/admin/apps/api-keys.d.ts +7 -0
  21. package/dist/admin/apps/api-keys.d.ts.map +1 -1
  22. package/dist/admin/apps/scopes.d.ts +8 -0
  23. package/dist/admin/apps/scopes.d.ts.map +1 -1
  24. package/dist/admin/apps/scopes.js +3 -0
  25. package/dist/admin/apps/scopes.js.map +1 -1
  26. package/dist/admin/apps/verified-tokens.d.ts +57 -57
  27. package/dist/admin/ui.generated.d.ts +1 -1
  28. package/dist/admin/ui.generated.js +13 -13
  29. package/dist/admin/ui.generated.js.map +1 -1
  30. package/dist/analytics/Analytics.d.ts +151 -0
  31. package/dist/analytics/Analytics.d.ts.map +1 -0
  32. package/dist/analytics/Analytics.js +212 -0
  33. package/dist/analytics/Analytics.js.map +1 -0
  34. package/dist/analytics/tables/requestEvents.d.ts +215 -0
  35. package/dist/analytics/tables/requestEvents.d.ts.map +1 -0
  36. package/dist/analytics/tables/requestEvents.js +264 -0
  37. package/dist/analytics/tables/requestEvents.js.map +1 -0
  38. package/dist/apps/data/App.d.ts +1024 -624
  39. package/dist/apps/data/App.d.ts.map +1 -1
  40. package/dist/apps/data/App.js +36 -0
  41. package/dist/apps/data/App.js.map +1 -1
  42. package/dist/apps/data/routes/balances.d.ts +45 -45
  43. package/dist/apps/data/routes/coingecko.d.ts +176 -176
  44. package/dist/apps/data/routes/exchanges.d.ts +455 -455
  45. package/dist/apps/data/routes/fee-amm.d.ts +101 -101
  46. package/dist/apps/data/routes/funding.d.ts +765 -0
  47. package/dist/apps/data/routes/funding.d.ts.map +1 -0
  48. package/dist/apps/data/routes/funding.js +383 -0
  49. package/dist/apps/data/routes/funding.js.map +1 -0
  50. package/dist/apps/data/routes/receipts.d.ts.map +1 -1
  51. package/dist/apps/data/routes/receipts.js +2 -8
  52. package/dist/apps/data/routes/receipts.js.map +1 -1
  53. package/dist/apps/data/routes/rpc.d.ts +29 -36
  54. package/dist/apps/data/routes/rpc.d.ts.map +1 -1
  55. package/dist/apps/data/routes/rpc.js +29 -1
  56. package/dist/apps/data/routes/rpc.js.map +1 -1
  57. package/dist/apps/data/routes/tokenlist.d.ts +36 -36
  58. package/dist/apps/data/routes/transfers.d.ts +56 -56
  59. package/dist/apps/data/routes/verified-tokens.d.ts +36 -36
  60. package/dist/apps/data/routes/webhooks.d.ts +45 -45
  61. package/dist/apps/data/routes/webhooks.d.ts.map +1 -1
  62. package/dist/apps/data/routes/webhooks.js +8 -8
  63. package/dist/apps/data/routes/webhooks.js.map +1 -1
  64. package/dist/apps/docs/App.d.ts +4 -2
  65. package/dist/apps/docs/App.d.ts.map +1 -1
  66. package/dist/apps/docs/App.js +27 -95
  67. package/dist/apps/docs/App.js.map +1 -1
  68. package/dist/apps/docs/reference.d.ts +21 -0
  69. package/dist/apps/docs/reference.d.ts.map +1 -0
  70. package/dist/apps/docs/reference.js +112 -0
  71. package/dist/apps/docs/reference.js.map +1 -0
  72. package/dist/apps/index.d.ts +1 -0
  73. package/dist/apps/index.d.ts.map +1 -1
  74. package/dist/apps/index.js +1 -0
  75. package/dist/apps/index.js.map +1 -1
  76. package/dist/apps/mcp.d.ts +76 -0
  77. package/dist/apps/mcp.d.ts.map +1 -0
  78. package/dist/apps/mcp.js +188 -0
  79. package/dist/apps/mcp.js.map +1 -0
  80. package/dist/apps/platform/App.d.ts +3005 -728
  81. package/dist/apps/platform/App.d.ts.map +1 -1
  82. package/dist/apps/platform/App.js +13 -3
  83. package/dist/apps/platform/App.js.map +1 -1
  84. package/dist/apps/platform/Billing.d.ts +279 -0
  85. package/dist/apps/platform/Billing.d.ts.map +1 -0
  86. package/dist/apps/platform/Billing.js +477 -0
  87. package/dist/apps/platform/Billing.js.map +1 -0
  88. package/dist/apps/platform/index.d.ts +1 -0
  89. package/dist/apps/platform/index.d.ts.map +1 -1
  90. package/dist/apps/platform/index.js +1 -0
  91. package/dist/apps/platform/index.js.map +1 -1
  92. package/dist/apps/platform/routes/api-keys.d.ts +341 -49
  93. package/dist/apps/platform/routes/api-keys.d.ts.map +1 -1
  94. package/dist/apps/platform/routes/api-keys.js +115 -13
  95. package/dist/apps/platform/routes/api-keys.js.map +1 -1
  96. package/dist/apps/platform/routes/billing.d.ts +1520 -0
  97. package/dist/apps/platform/routes/billing.d.ts.map +1 -0
  98. package/dist/apps/platform/routes/billing.js +795 -0
  99. package/dist/apps/platform/routes/billing.js.map +1 -0
  100. package/dist/apps/platform/routes/invitations.d.ts +201 -83
  101. package/dist/apps/platform/routes/invitations.d.ts.map +1 -1
  102. package/dist/apps/platform/routes/invitations.js +58 -0
  103. package/dist/apps/platform/routes/invitations.js.map +1 -1
  104. package/dist/apps/platform/routes/me.d.ts +17 -17
  105. package/dist/apps/platform/routes/orgs.d.ts +50 -36
  106. package/dist/apps/platform/routes/orgs.d.ts.map +1 -1
  107. package/dist/apps/platform/routes/orgs.js +14 -3
  108. package/dist/apps/platform/routes/orgs.js.map +1 -1
  109. package/dist/apps/platform/routes/projects.d.ts +97 -97
  110. package/dist/apps/platform/routes/scopes.d.ts +107 -0
  111. package/dist/apps/platform/routes/scopes.d.ts.map +1 -0
  112. package/dist/apps/platform/routes/scopes.js +66 -0
  113. package/dist/apps/platform/routes/scopes.js.map +1 -0
  114. package/dist/apps/platform/routes/usage.d.ts +588 -0
  115. package/dist/apps/platform/routes/usage.d.ts.map +1 -0
  116. package/dist/apps/platform/routes/usage.js +391 -0
  117. package/dist/apps/platform/routes/usage.js.map +1 -0
  118. package/dist/apps/relay/App.d.ts +4 -1
  119. package/dist/apps/relay/App.d.ts.map +1 -1
  120. package/dist/apps/relay/App.js +118 -10
  121. package/dist/apps/relay/App.js.map +1 -1
  122. package/dist/apps/relay/Sponsorships.d.ts.map +1 -1
  123. package/dist/apps/relay/Sponsorships.js +2 -1
  124. package/dist/apps/relay/Sponsorships.js.map +1 -1
  125. package/dist/cli/Cli.d.ts +8 -1
  126. package/dist/cli/Cli.d.ts.map +1 -1
  127. package/dist/cli/Cli.js +11 -3
  128. package/dist/cli/Cli.js.map +1 -1
  129. package/dist/cli/commands/admin.d.ts +4 -0
  130. package/dist/cli/commands/admin.d.ts.map +1 -1
  131. package/dist/cli/commands/admin.js +80 -1
  132. package/dist/cli/commands/admin.js.map +1 -1
  133. package/dist/db/Db.d.ts +7 -0
  134. package/dist/db/Db.d.ts.map +1 -1
  135. package/dist/db/Db.js +126 -0
  136. package/dist/db/Db.js.map +1 -1
  137. package/dist/db/Schema.d.ts +79 -0
  138. package/dist/db/Schema.d.ts.map +1 -1
  139. package/dist/db/Schema.js +88 -2
  140. package/dist/db/Schema.js.map +1 -1
  141. package/dist/db/tables/billingSettings.d.ts +55 -0
  142. package/dist/db/tables/billingSettings.d.ts.map +1 -0
  143. package/dist/db/tables/billingSettings.js +70 -0
  144. package/dist/db/tables/billingSettings.js.map +1 -0
  145. package/dist/db/tables/invitations.js +2 -2
  146. package/dist/db/tables/invitations.js.map +1 -1
  147. package/dist/db/tables/organizations.d.ts +6 -2
  148. package/dist/db/tables/organizations.d.ts.map +1 -1
  149. package/dist/db/tables/organizations.js +10 -4
  150. package/dist/db/tables/organizations.js.map +1 -1
  151. package/dist/db/tables/projects.js +2 -2
  152. package/dist/db/tables/projects.js.map +1 -1
  153. package/dist/db/tables/requestUsage.d.ts +121 -0
  154. package/dist/db/tables/requestUsage.d.ts.map +1 -0
  155. package/dist/db/tables/requestUsage.js +150 -0
  156. package/dist/db/tables/requestUsage.js.map +1 -0
  157. package/dist/db/tables/sponsoredTransactions.d.ts +119 -0
  158. package/dist/db/tables/sponsoredTransactions.d.ts.map +1 -1
  159. package/dist/db/tables/sponsoredTransactions.js +155 -2
  160. package/dist/db/tables/sponsoredTransactions.js.map +1 -1
  161. package/dist/db/tables/stripeCustomers.d.ts +81 -0
  162. package/dist/db/tables/stripeCustomers.d.ts.map +1 -0
  163. package/dist/db/tables/stripeCustomers.js +120 -0
  164. package/dist/db/tables/stripeCustomers.js.map +1 -0
  165. package/dist/db/tables/users.js +2 -2
  166. package/dist/db/tables/users.js.map +1 -1
  167. package/dist/handlers/internal/sponsorship.d.ts +5 -2
  168. package/dist/handlers/internal/sponsorship.d.ts.map +1 -1
  169. package/dist/handlers/internal/sponsorship.js +19 -5
  170. package/dist/handlers/internal/sponsorship.js.map +1 -1
  171. package/dist/handlers/internal/utils.d.ts +10 -3
  172. package/dist/handlers/internal/utils.d.ts.map +1 -1
  173. package/dist/handlers/internal/utils.js +14 -6
  174. package/dist/handlers/internal/utils.js.map +1 -1
  175. package/dist/index.d.ts +1 -0
  176. package/dist/index.d.ts.map +1 -1
  177. package/dist/index.js +1 -0
  178. package/dist/index.js.map +1 -1
  179. package/dist/internal/Auth.d.ts +18 -4
  180. package/dist/internal/Auth.d.ts.map +1 -1
  181. package/dist/internal/Auth.js +148 -76
  182. package/dist/internal/Auth.js.map +1 -1
  183. package/dist/internal/Cache.d.ts.map +1 -1
  184. package/dist/internal/Cache.js +4 -1
  185. package/dist/internal/Cache.js.map +1 -1
  186. package/dist/internal/EdgeCache.d.ts +10 -0
  187. package/dist/internal/EdgeCache.d.ts.map +1 -1
  188. package/dist/internal/EdgeCache.js +39 -8
  189. package/dist/internal/EdgeCache.js.map +1 -1
  190. package/dist/internal/Fees.d.ts +27 -0
  191. package/dist/internal/Fees.d.ts.map +1 -0
  192. package/dist/internal/Fees.js +48 -0
  193. package/dist/internal/Fees.js.map +1 -0
  194. package/dist/internal/FundingRoutes.d.ts +183 -0
  195. package/dist/internal/FundingRoutes.d.ts.map +1 -0
  196. package/dist/internal/FundingRoutes.js +490 -0
  197. package/dist/internal/FundingRoutes.js.map +1 -0
  198. package/dist/internal/Id.d.ts +15 -0
  199. package/dist/internal/Id.d.ts.map +1 -0
  200. package/dist/internal/Id.js +22 -0
  201. package/dist/internal/Id.js.map +1 -0
  202. package/dist/internal/Log.d.ts +2 -0
  203. package/dist/internal/Log.d.ts.map +1 -1
  204. package/dist/internal/Log.js +3 -0
  205. package/dist/internal/Log.js.map +1 -1
  206. package/dist/internal/OpenApi.d.ts +10 -1
  207. package/dist/internal/OpenApi.d.ts.map +1 -1
  208. package/dist/internal/OpenApi.js +8 -1
  209. package/dist/internal/OpenApi.js.map +1 -1
  210. package/dist/internal/RateLimit.d.ts +25 -0
  211. package/dist/internal/RateLimit.d.ts.map +1 -1
  212. package/dist/internal/RateLimit.js +51 -0
  213. package/dist/internal/RateLimit.js.map +1 -1
  214. package/dist/internal/Response.d.ts +1 -1
  215. package/dist/internal/Response.d.ts.map +1 -1
  216. package/dist/internal/Schema.d.ts +8 -0
  217. package/dist/internal/Schema.d.ts.map +1 -1
  218. package/dist/internal/Schema.js +7 -0
  219. package/dist/internal/Schema.js.map +1 -1
  220. package/dist/internal/Webhooks.d.ts.map +1 -1
  221. package/dist/internal/Webhooks.js +3 -3
  222. package/dist/internal/Webhooks.js.map +1 -1
  223. package/package.json +4 -3
  224. package/src/ApiKey.ts +9 -2
  225. package/src/ApiKeys.test.ts +51 -0
  226. package/src/ApiKeys.ts +50 -1
  227. package/src/App.test.ts +33 -86718
  228. package/src/App.ts +18 -0
  229. package/src/Client.test-d.ts +351 -0
  230. package/src/Scope.ts +16 -3
  231. package/src/admin/apps/scopes.test.ts +6 -0
  232. package/src/admin/apps/scopes.ts +3 -0
  233. package/src/admin/ui/src/components/Page.tsx +2 -3
  234. package/src/admin/ui/src/routes/__root.tsx +2 -2
  235. package/src/admin/ui/src/routes/api-keys.tsx +2 -2
  236. package/src/admin/ui.generated.ts +13 -13
  237. package/src/analytics/Analytics.test.ts +527 -0
  238. package/src/analytics/Analytics.ts +318 -0
  239. package/src/analytics/tables/requestEvents.ts +523 -0
  240. package/src/apps/data/App.test.ts +72 -0
  241. package/src/apps/data/App.ts +35 -0
  242. package/src/apps/data/routes/funding.test.ts +214 -0
  243. package/src/apps/data/routes/funding.ts +584 -0
  244. package/src/apps/data/routes/receipts.ts +2 -9
  245. package/src/apps/data/routes/rpc.test.ts +78 -2
  246. package/src/apps/data/routes/rpc.ts +31 -1
  247. package/src/apps/data/routes/webhooks.test.ts +1 -1
  248. package/src/apps/data/routes/webhooks.ts +11 -8
  249. package/src/apps/docs/App.ts +29 -100
  250. package/src/apps/docs/reference.ts +132 -0
  251. package/src/apps/index.ts +1 -0
  252. package/src/apps/mcp.test.ts +206 -0
  253. package/src/apps/mcp.ts +250 -0
  254. package/src/apps/platform/App.ts +43 -4
  255. package/src/apps/platform/Billing.test.ts +530 -0
  256. package/src/apps/platform/Billing.ts +682 -0
  257. package/src/apps/platform/index.ts +1 -0
  258. package/src/apps/platform/routes/api-keys.test.ts +172 -9
  259. package/src/apps/platform/routes/api-keys.ts +136 -20
  260. package/src/apps/platform/routes/billing.test.ts +1100 -0
  261. package/src/apps/platform/routes/billing.ts +966 -0
  262. package/src/apps/platform/routes/invitations.test.ts +55 -7
  263. package/src/apps/platform/routes/invitations.ts +68 -0
  264. package/src/apps/platform/routes/me.test.ts +230 -0
  265. package/src/apps/platform/routes/orgs.ts +26 -4
  266. package/src/apps/platform/routes/scopes.test.ts +29 -0
  267. package/src/apps/platform/routes/scopes.ts +85 -0
  268. package/src/apps/platform/routes/usage.test.ts +422 -0
  269. package/src/apps/platform/routes/usage.ts +527 -0
  270. package/src/apps/relay/App.test.ts +457 -8
  271. package/src/apps/relay/App.ts +120 -12
  272. package/src/apps/relay/Sponsorships.test.ts +1 -1
  273. package/src/apps/relay/Sponsorships.ts +2 -1
  274. package/src/cli/Cli.test.ts +25 -2
  275. package/src/cli/Cli.ts +17 -2
  276. package/src/cli/commands/admin.test.ts +83 -0
  277. package/src/cli/commands/admin.ts +89 -1
  278. package/src/db/Db.ts +137 -0
  279. package/src/db/Schema.ts +104 -2
  280. package/src/db/tables/billingSettings.test.ts +87 -0
  281. package/src/db/tables/billingSettings.ts +108 -0
  282. package/src/db/tables/invitations.ts +2 -2
  283. package/src/db/tables/organizations.test.ts +1 -1
  284. package/src/db/tables/organizations.ts +15 -5
  285. package/src/db/tables/projects.ts +2 -2
  286. package/src/db/tables/requestUsage.ts +231 -0
  287. package/src/db/tables/sponsoredTransactions.test.ts +108 -1
  288. package/src/db/tables/sponsoredTransactions.ts +230 -2
  289. package/src/db/tables/stripeCustomers.test.ts +109 -0
  290. package/src/db/tables/stripeCustomers.ts +162 -0
  291. package/src/db/tables/users.ts +2 -2
  292. package/src/handlers/internal/sponsorship.ts +34 -7
  293. package/src/handlers/internal/utils.ts +19 -7
  294. package/src/index.ts +1 -0
  295. package/src/internal/Auth.test.ts +175 -25
  296. package/src/internal/Auth.ts +175 -86
  297. package/src/internal/Cache.ts +5 -1
  298. package/src/internal/EdgeCache.test.ts +27 -4
  299. package/src/internal/EdgeCache.ts +47 -9
  300. package/src/internal/Fees.test.ts +32 -0
  301. package/src/internal/Fees.ts +51 -0
  302. package/src/internal/FundingRoutes.ts +583 -0
  303. package/src/internal/Id.test.ts +17 -0
  304. package/src/internal/Id.ts +24 -0
  305. package/src/internal/Log.test.ts +1 -0
  306. package/src/internal/Log.ts +5 -0
  307. package/src/internal/OpenApi.ts +12 -1
  308. package/src/internal/RateLimit.test.ts +84 -0
  309. package/src/internal/RateLimit.ts +70 -0
  310. package/src/internal/Response.ts +1 -1
  311. package/src/internal/Schema.ts +8 -0
  312. package/src/internal/Webhooks.test.ts +3 -3
  313. package/src/internal/Webhooks.ts +3 -3
@@ -0,0 +1,264 @@
1
+ /**
2
+ * Builds a `Metrics.cloudflare` analytics factory that enqueues one compact
3
+ * request row per entry onto `queue`. Pass the result directly as the
4
+ * backend's `analytics` option; it reuses the backend's
5
+ * `enabled`/`environment`/`service` context and self-disables when `enabled`
6
+ * is false.
7
+ *
8
+ * @param queue - The analytics queue producer.
9
+ * @returns The analytics factory.
10
+ */
11
+ export function createQueueSink(queue) {
12
+ return (context) => async (entry) => {
13
+ if (!context.enabled)
14
+ return;
15
+ const row = event(entry, context);
16
+ try {
17
+ await queue.send(row);
18
+ }
19
+ catch {
20
+ // Transient Queues internal errors (e.g. code 15000) usually clear on retry.
21
+ await queue.send(row);
22
+ }
23
+ };
24
+ }
25
+ /**
26
+ * Inserts a batch of queued request rows, acking each message on success and
27
+ * retrying the batch on failure.
28
+ *
29
+ * @param analytics - The analytics store.
30
+ * @param messages - The queued messages.
31
+ */
32
+ export async function insertMessages(analytics, messages) {
33
+ if (messages.length === 0)
34
+ return;
35
+ try {
36
+ await analytics.insert('request_events', messages.map((message) => message.body));
37
+ for (const message of messages)
38
+ message.ack();
39
+ }
40
+ catch (error) {
41
+ console.error('ClickHouse analytics insert failed', error);
42
+ for (const message of messages)
43
+ message.retry();
44
+ }
45
+ }
46
+ /**
47
+ * Reads request usage for one project from the `request_events` table.
48
+ *
49
+ * @param analytics - The analytics store.
50
+ * @param options - The usage read options.
51
+ * @returns The project usage.
52
+ */
53
+ export async function readProjectUsage(analytics, options) {
54
+ const where = usageWhere(options);
55
+ const average = `toFloat64(coalesce(round(avgOrNull(duration_ms), 1), 0))`;
56
+ const bucket = options.interval === 'day' ? 'toStartOfDay(timestamp)' : 'toStartOfHour(timestamp)';
57
+ const [byKey, byRoute, byStatus, series, totals] = await Promise.all([
58
+ analytics.query(`
59
+ SELECT
60
+ key_id,
61
+ count() AS requests,
62
+ countIf(status >= 400) AS errors,
63
+ ${average} AS averageDurationMs
64
+ FROM ${table}
65
+ WHERE ${where} AND key_id IS NOT NULL
66
+ GROUP BY key_id
67
+ ORDER BY requests DESC, key_id ASC
68
+ LIMIT 100
69
+ `),
70
+ analytics.query(`
71
+ SELECT
72
+ route,
73
+ count() AS requests,
74
+ countIf(status >= 400) AS errors,
75
+ ${average} AS averageDurationMs
76
+ FROM ${table}
77
+ WHERE ${where}
78
+ GROUP BY route
79
+ ORDER BY requests DESC, route ASC
80
+ LIMIT 100
81
+ `),
82
+ analytics.query(`
83
+ SELECT
84
+ status,
85
+ count() AS requests
86
+ FROM ${table}
87
+ WHERE ${where}
88
+ GROUP BY status
89
+ ORDER BY status ASC
90
+ `),
91
+ analytics.query(`
92
+ SELECT
93
+ formatDateTime(${bucket}, '%Y-%m-%dT%H:%i:%S.000Z', 'UTC') AS time,
94
+ count() AS requests,
95
+ countIf(status >= 400) AS errors
96
+ FROM ${table}
97
+ WHERE ${where}
98
+ GROUP BY ${bucket}
99
+ ORDER BY ${bucket} ASC
100
+ `),
101
+ analytics.query(`
102
+ SELECT
103
+ count() AS requests,
104
+ countIf(status >= 400) AS errors,
105
+ ${average} AS averageDurationMs
106
+ FROM ${table}
107
+ WHERE ${where}
108
+ `),
109
+ ]);
110
+ return {
111
+ byKey: byKey.map((row) => ({
112
+ apiKeyId: String(row.key_id),
113
+ averageDurationMs: number(row.averageDurationMs),
114
+ errors: number(row.errors),
115
+ requests: number(row.requests),
116
+ })),
117
+ byRoute: byRoute.map((row) => ({
118
+ averageDurationMs: number(row.averageDurationMs),
119
+ errors: number(row.errors),
120
+ requests: number(row.requests),
121
+ route: String(row.route),
122
+ })),
123
+ byStatus: byStatus.map((row) => ({
124
+ requests: number(row.requests),
125
+ status: number(row.status),
126
+ })),
127
+ from: options.from,
128
+ interval: options.interval,
129
+ series: series.map((row) => ({
130
+ errors: number(row.errors),
131
+ requests: number(row.requests),
132
+ time: String(row.time),
133
+ })),
134
+ to: options.to,
135
+ totals: totals[0]
136
+ ? {
137
+ averageDurationMs: number(totals[0].averageDurationMs),
138
+ errors: number(totals[0].errors),
139
+ requests: number(totals[0].requests),
140
+ }
141
+ : { averageDurationMs: 0, errors: 0, requests: 0 },
142
+ };
143
+ }
144
+ /**
145
+ * Reads deduped billable request counts grouped by `(org, UTC hour)` for the
146
+ * request-metered billing reporter. Counts dedupe on `request_id` via
147
+ * `uniqExact` (the queue → ClickHouse path can duplicate rows); production rows
148
+ * always bill, sandbox rows only when `billing_active = 1` at request time.
149
+ *
150
+ * @param analytics - The analytics store.
151
+ * @param options - The read options.
152
+ * @returns One deduped count per `(org, hour)`.
153
+ */
154
+ export async function readBillableCounts(analytics, options) {
155
+ const sandboxGate = options.environment === 'production' ? '' : `AND billing_active = 1`;
156
+ const rows = await analytics.query(`
157
+ SELECT
158
+ org_id AS orgId,
159
+ formatDateTime(toStartOfHour(timestamp), '%Y-%m-%dT%H:%i:%S.000Z', 'UTC') AS bucketStart,
160
+ uniqExact(request_id) AS count
161
+ FROM ${table}
162
+ WHERE principal_type = 'api_key'
163
+ AND org_id IS NOT NULL
164
+ AND request_id IS NOT NULL
165
+ AND key_environment = ${literal(options.environment)}
166
+ ${sandboxGate}
167
+ AND timestamp >= parseDateTime64BestEffort(${literal(options.from)}, 3, 'UTC')
168
+ AND timestamp < parseDateTime64BestEffort(${literal(options.to)}, 3, 'UTC')
169
+ GROUP BY org_id, toStartOfHour(timestamp)
170
+ `);
171
+ return rows.map((row) => ({
172
+ bucketStart: String(row.bucketStart),
173
+ count: number(row.count),
174
+ orgId: String(row.orgId),
175
+ }));
176
+ }
177
+ /** Table name queries read from; the store scopes the database. */
178
+ const table = 'request_events';
179
+ /** Maps one request log entry to a stored row. */
180
+ function event(entry, context) {
181
+ const principal = entry.principal;
182
+ return {
183
+ billing_active: principal?.type === 'api_key' ? Number(principal.billingActive === true) : null,
184
+ duration_ms: entry.duration,
185
+ environment: context.environment ?? 'unknown',
186
+ error_code: entry.errorCode ?? null,
187
+ key_environment: principal?.type === 'api_key' ? (principal.environment ?? null) : null,
188
+ key_id: principal?.type === 'api_key' ? principal.id : null,
189
+ method: entry.method,
190
+ org_id: principal?.type === 'api_key' ? (principal.orgId ?? null) : null,
191
+ project_id: principal?.type === 'api_key' ? (principal.projectId ?? null) : null,
192
+ principal_type: principal?.type ?? 'unknown',
193
+ rate_limit_scope: entry.rateLimit?.scope ?? null,
194
+ request_id: entry.requestId ?? null,
195
+ route: entry.route,
196
+ service: context.service ?? 'unknown',
197
+ status: entry.status,
198
+ timestamp: timestamp(),
199
+ };
200
+ }
201
+ function usageWhere(options) {
202
+ const attributions = options.attributions.length
203
+ ? options.attributions
204
+ .map((attribution) => `(${attributionWhere(attribution, options)})`)
205
+ .join(' OR ')
206
+ : '0';
207
+ return [
208
+ `principal_type = 'api_key'`,
209
+ `(${attributions})`,
210
+ `timestamp >= parseDateTime64BestEffort(${literal(options.from)}, 3, 'UTC')`,
211
+ `timestamp <= parseDateTime64BestEffort(${literal(options.to)}, 3, 'UTC')`,
212
+ ].join(' AND ');
213
+ }
214
+ function attributionWhere(attribution, options) {
215
+ if (attribution.projectId === null) {
216
+ if (!attribution.apiKeyIds?.length)
217
+ return '0';
218
+ return [
219
+ `project_id IS NULL`,
220
+ `key_id IN (${attribution.apiKeyIds.map(literal).join(', ')})`,
221
+ ...(attribution.environment === undefined
222
+ ? []
223
+ : [keyEnvironmentWhere(attribution.environment, true)]),
224
+ ].join(' AND ');
225
+ }
226
+ // Absent `projectId` scopes to the whole organization (any project).
227
+ if (attribution.projectId === undefined) {
228
+ return [
229
+ `org_id = ${literal(options.orgId)}`,
230
+ ...(attribution.apiKeyIds === undefined
231
+ ? []
232
+ : [`key_id IN (${attribution.apiKeyIds.map(literal).join(', ')})`]),
233
+ ...(attribution.environment === undefined
234
+ ? []
235
+ : [keyEnvironmentWhere(attribution.environment, false)]),
236
+ ].join(' AND ');
237
+ }
238
+ return [
239
+ `org_id = ${literal(options.orgId)}`,
240
+ `project_id = ${literal(attribution.projectId)}`,
241
+ ...(attribution.apiKeyIds === undefined
242
+ ? []
243
+ : [`key_id IN (${attribution.apiKeyIds.map(literal).join(', ')})`]),
244
+ ...(attribution.environment === undefined
245
+ ? []
246
+ : [keyEnvironmentWhere(attribution.environment, false)]),
247
+ ].join(' AND ');
248
+ }
249
+ function keyEnvironmentWhere(environment, allowLegacyNull) {
250
+ const exact = `key_environment = ${literal(environment)}`;
251
+ if (!allowLegacyNull)
252
+ return exact;
253
+ return `(${exact} OR key_environment IS NULL)`;
254
+ }
255
+ function literal(value) {
256
+ return `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
257
+ }
258
+ function number(value) {
259
+ return Number(value);
260
+ }
261
+ function timestamp() {
262
+ return new Date().toISOString().replace('T', ' ').replace('Z', '');
263
+ }
264
+ //# sourceMappingURL=requestEvents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"requestEvents.js","sourceRoot":"","sources":["../../../src/analytics/tables/requestEvents.ts"],"names":[],"mappings":"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"}