appflare 0.0.28 → 0.1.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 (151) hide show
  1. package/cli/commands/index.ts +140 -0
  2. package/cli/generate.ts +149 -0
  3. package/cli/index.ts +56 -447
  4. package/cli/load-config.ts +182 -0
  5. package/cli/schema-compiler.ts +657 -0
  6. package/cli/templates/auth/README.md +156 -0
  7. package/cli/templates/auth/config.ts +61 -0
  8. package/cli/templates/auth/route-config.ts +18 -0
  9. package/cli/templates/auth/route-handler.ts +18 -0
  10. package/cli/templates/auth/route-request-utils.ts +55 -0
  11. package/cli/templates/auth/route.ts +14 -0
  12. package/cli/templates/core/README.md +266 -0
  13. package/cli/templates/core/app-creation.ts +19 -0
  14. package/cli/templates/core/client/appflare.ts +37 -0
  15. package/cli/templates/core/client/index.ts +6 -0
  16. package/cli/templates/core/client/storage.ts +100 -0
  17. package/cli/templates/core/client/types.ts +54 -0
  18. package/cli/templates/core/client-modules/appflare.ts +112 -0
  19. package/cli/templates/core/client-modules/handlers/index.ts +747 -0
  20. package/cli/templates/core/client-modules/handlers.ts +1 -0
  21. package/cli/templates/core/client-modules/index.ts +7 -0
  22. package/cli/templates/core/client-modules/storage.ts +180 -0
  23. package/cli/templates/core/client-modules/types.ts +145 -0
  24. package/cli/templates/core/client.ts +39 -0
  25. package/cli/templates/core/drizzle.ts +15 -0
  26. package/cli/templates/core/export.ts +14 -0
  27. package/cli/templates/core/handlers-route.ts +23 -0
  28. package/cli/templates/core/handlers.ts +1 -0
  29. package/cli/templates/core/imports.ts +8 -0
  30. package/cli/templates/core/server.ts +38 -0
  31. package/cli/templates/core/types.ts +6 -0
  32. package/cli/templates/core/wrangler.ts +109 -0
  33. package/cli/templates/handlers/README.md +353 -0
  34. package/cli/templates/handlers/auth.ts +37 -0
  35. package/cli/templates/handlers/execution.ts +39 -0
  36. package/cli/templates/handlers/generators/context/context-creation.ts +80 -0
  37. package/cli/templates/handlers/generators/context/error-helpers.ts +11 -0
  38. package/cli/templates/handlers/generators/context/scheduler.ts +24 -0
  39. package/cli/templates/handlers/generators/context/storage-api.ts +112 -0
  40. package/cli/templates/handlers/generators/context/storage-helpers.ts +59 -0
  41. package/cli/templates/handlers/generators/context/types.ts +18 -0
  42. package/cli/templates/handlers/generators/context.ts +43 -0
  43. package/cli/templates/handlers/generators/execution.ts +15 -0
  44. package/cli/templates/handlers/generators/handlers.ts +13 -0
  45. package/cli/templates/handlers/generators/registration/modules/cron.ts +30 -0
  46. package/cli/templates/handlers/generators/registration/modules/realtime.ts +631 -0
  47. package/cli/templates/handlers/generators/registration/modules/scheduler.ts +56 -0
  48. package/cli/templates/handlers/generators/registration/modules/storage.ts +194 -0
  49. package/cli/templates/handlers/generators/registration/sections.ts +210 -0
  50. package/cli/templates/handlers/generators/types/context.ts +64 -0
  51. package/cli/templates/handlers/generators/types/core.ts +101 -0
  52. package/cli/templates/handlers/generators/types/operations.ts +135 -0
  53. package/cli/templates/handlers/generators/types/query-definitions.ts +1029 -0
  54. package/cli/templates/handlers/generators/types/query-runtime.ts +417 -0
  55. package/cli/templates/handlers/index.ts +43 -0
  56. package/cli/templates/handlers/operations.ts +116 -0
  57. package/cli/templates/handlers/registration.ts +83 -0
  58. package/cli/templates/handlers/types.ts +15 -0
  59. package/cli/templates/handlers/utils.ts +48 -0
  60. package/cli/types.ts +108 -0
  61. package/cli/utils/handler-discovery.ts +366 -0
  62. package/cli/utils/json-utils.ts +24 -0
  63. package/cli/utils/path-utils.ts +19 -0
  64. package/cli/utils/schema-discovery.ts +390 -0
  65. package/index.ts +27 -4
  66. package/package.json +23 -20
  67. package/react/index.ts +5 -3
  68. package/react/use-infinite-query.ts +190 -0
  69. package/react/use-mutation.ts +54 -0
  70. package/react/use-query.ts +158 -0
  71. package/schema.ts +262 -0
  72. package/tsconfig.json +2 -4
  73. package/cli/README.md +0 -108
  74. package/cli/core/build.ts +0 -187
  75. package/cli/core/config.ts +0 -92
  76. package/cli/core/discover-handlers.ts +0 -143
  77. package/cli/core/handlers.ts +0 -7
  78. package/cli/core/index.ts +0 -205
  79. package/cli/generators/generate-api-client/client.ts +0 -163
  80. package/cli/generators/generate-api-client/extract-configuration.ts +0 -121
  81. package/cli/generators/generate-api-client/index.ts +0 -973
  82. package/cli/generators/generate-api-client/types.ts +0 -164
  83. package/cli/generators/generate-api-client/utils.ts +0 -22
  84. package/cli/generators/generate-api-client.ts +0 -1
  85. package/cli/generators/generate-cloudflare-worker/helpers.ts +0 -24
  86. package/cli/generators/generate-cloudflare-worker/index.ts +0 -2
  87. package/cli/generators/generate-cloudflare-worker/worker.ts +0 -148
  88. package/cli/generators/generate-cloudflare-worker/wrangler.ts +0 -108
  89. package/cli/generators/generate-cloudflare-worker.ts +0 -4
  90. package/cli/generators/generate-cron-handlers/cron-handlers-block.ts +0 -2
  91. package/cli/generators/generate-cron-handlers/handler-entries.ts +0 -29
  92. package/cli/generators/generate-cron-handlers/index.ts +0 -61
  93. package/cli/generators/generate-cron-handlers/runtime-block.ts +0 -49
  94. package/cli/generators/generate-cron-handlers/type-helpers-block.ts +0 -60
  95. package/cli/generators/generate-db-handlers/index.ts +0 -33
  96. package/cli/generators/generate-db-handlers/prepare.ts +0 -24
  97. package/cli/generators/generate-db-handlers/templates.ts +0 -189
  98. package/cli/generators/generate-db-handlers.ts +0 -1
  99. package/cli/generators/generate-hono-server/auth.ts +0 -97
  100. package/cli/generators/generate-hono-server/imports.ts +0 -55
  101. package/cli/generators/generate-hono-server/index.ts +0 -52
  102. package/cli/generators/generate-hono-server/routes.ts +0 -115
  103. package/cli/generators/generate-hono-server/template.ts +0 -371
  104. package/cli/generators/generate-hono-server.ts +0 -1
  105. package/cli/generators/generate-scheduler-handlers/constants.ts +0 -8
  106. package/cli/generators/generate-scheduler-handlers/handler-entries.ts +0 -22
  107. package/cli/generators/generate-scheduler-handlers/index.ts +0 -51
  108. package/cli/generators/generate-scheduler-handlers/runtime-block.ts +0 -68
  109. package/cli/generators/generate-scheduler-handlers/scheduler-handlers-block.ts +0 -2
  110. package/cli/generators/generate-scheduler-handlers/type-helpers-block.ts +0 -68
  111. package/cli/generators/generate-scheduler-handlers.ts +0 -1
  112. package/cli/generators/generate-websocket-durable-object/auth.ts +0 -30
  113. package/cli/generators/generate-websocket-durable-object/imports.ts +0 -55
  114. package/cli/generators/generate-websocket-durable-object/index.ts +0 -41
  115. package/cli/generators/generate-websocket-durable-object/query-handlers.ts +0 -18
  116. package/cli/generators/generate-websocket-durable-object/template.ts +0 -714
  117. package/cli/generators/generate-websocket-durable-object.ts +0 -1
  118. package/cli/schema/schema-static-types.ts +0 -702
  119. package/cli/schema/schema.ts +0 -151
  120. package/cli/utils/tsc.ts +0 -54
  121. package/cli/utils/utils.ts +0 -190
  122. package/cli/utils/zod-utils.ts +0 -121
  123. package/lib/README.md +0 -50
  124. package/lib/db.ts +0 -19
  125. package/lib/location.ts +0 -110
  126. package/lib/values.ts +0 -27
  127. package/react/README.md +0 -67
  128. package/react/hooks/useMutation.ts +0 -89
  129. package/react/hooks/usePaginatedQuery.ts +0 -213
  130. package/react/hooks/useQuery.ts +0 -106
  131. package/react/shared/queryShared.ts +0 -174
  132. package/server/README.md +0 -218
  133. package/server/auth.ts +0 -107
  134. package/server/database/builders.ts +0 -83
  135. package/server/database/context.ts +0 -327
  136. package/server/database/populate.ts +0 -234
  137. package/server/database/query-builder.ts +0 -161
  138. package/server/database/query-utils.ts +0 -25
  139. package/server/db.ts +0 -2
  140. package/server/storage/auth.ts +0 -16
  141. package/server/storage/bucket.ts +0 -22
  142. package/server/storage/context.ts +0 -34
  143. package/server/storage/index.ts +0 -38
  144. package/server/storage/operations.ts +0 -149
  145. package/server/storage/route-handler.ts +0 -60
  146. package/server/storage/types.ts +0 -55
  147. package/server/storage/utils.ts +0 -47
  148. package/server/storage.ts +0 -6
  149. package/server/types/schema-refs.ts +0 -66
  150. package/server/types/types.ts +0 -633
  151. package/server/utils/id-utils.ts +0 -230
@@ -1,702 +0,0 @@
1
- export const staticTypeDefinitions = `
2
- type Keys<T> = keyof T;
3
-
4
- type NonNil<T> = Exclude<T, null | undefined>;
5
-
6
- type ExtractIdTableName<T> = NonNil<T> extends Id<infer TTable>
7
- ? TTable
8
- : NonNil<T> extends Array<infer TItem>
9
- ? ExtractIdTableName<TItem>
10
- : never;
11
-
12
- type NumericKeys<T> =
13
- {
14
- [K in keyof T]: NonNil<T[K]> extends number | bigint ? K : never;
15
- }[keyof T] & string;
16
-
17
- type Friendly<T> = T extends Id<any>
18
- ? T | string
19
- : T extends Array<infer TItem>
20
- ? Array<Friendly<TItem>>
21
- : T;
22
-
23
- type FriendlyDoc<TDoc> = {
24
- [K in keyof TDoc]: Friendly<TDoc[K]>;
25
- };
26
-
27
- type PopulateValue<T> = T extends Id<infer TTable>
28
- ? (TTable extends TableNames ? Doc<TTable> : never)
29
- : T extends Array<infer TItem>
30
- ? Array<PopulateValue<TItem>>
31
- : T extends null
32
- ? null
33
- : T extends undefined
34
- ? undefined
35
- : NonNil<T> extends Id<infer TTable2>
36
- ? (TTable2 extends TableNames ? Doc<TTable2> : never) | Extract<T, null> | Extract<T, undefined>
37
- : NonNil<T> extends Array<infer TItem2>
38
- ? (Array<PopulateValue<TItem2>> | Extract<T, null> | Extract<T, undefined>)
39
- : T;
40
-
41
- type PopulatableKeys<TDoc> = {
42
- [K in Keys<TDoc>]: ExtractIdTableName<TDoc[K]> extends string ? K : never;
43
- }[Keys<TDoc>];
44
-
45
- type WithPopulated<TDoc, TKey extends Keys<TDoc>> = {
46
- [K in Keys<TDoc>]: K extends TKey ? PopulateValue<TDoc[K]> : TDoc[K];
47
- };
48
-
49
- type WithPopulatedMany<TDoc, TKeys extends Keys<TDoc>> = {
50
- [K in Keys<TDoc>]: K extends TKeys ? PopulateValue<TDoc[K]> : TDoc[K];
51
- };
52
-
53
- type WithSelected<TDoc, TKeys extends Keys<TDoc>> = Pick<TDoc, TKeys>;
54
-
55
- export type SortDirection = "asc" | "desc";
56
-
57
- type Comparable<T> = NonNil<T> extends number | bigint | Date ? NonNil<T> : never;
58
-
59
- type RegexOperand<T> = NonNil<T> extends string
60
- ? string | RegExp | { pattern: string; options?: string }
61
- : never;
62
-
63
- type ArrayOperand<T> = ReadonlyArray<NonNil<T>>;
64
-
65
- type QueryWhereField<T> =
66
- | Friendly<NonNil<T>>
67
- | {
68
- eq?: Friendly<NonNil<T>>;
69
- $eq?: Friendly<NonNil<T>>;
70
- ne?: Friendly<NonNil<T>>;
71
- $ne?: Friendly<NonNil<T>>;
72
- in?: ReadonlyArray<Friendly<NonNil<T>>>;
73
- $in?: ReadonlyArray<Friendly<NonNil<T>>>;
74
- nin?: ReadonlyArray<Friendly<NonNil<T>>>;
75
- $nin?: ReadonlyArray<Friendly<NonNil<T>>>;
76
- gt?: Comparable<T>;
77
- $gt?: Comparable<T>;
78
- gte?: Comparable<T>;
79
- $gte?: Comparable<T>;
80
- lt?: Comparable<T>;
81
- $lt?: Comparable<T>;
82
- lte?: Comparable<T>;
83
- $lte?: Comparable<T>;
84
- exists?: boolean;
85
- $exists?: boolean;
86
- regex?: RegexOperand<T>;
87
- $regex?: RegexOperand<T>;
88
- $options?: string;
89
- };
90
-
91
- type LogicalWhere<TableName extends TableNames> = {
92
- $and?: ReadonlyArray<QueryWhere<TableName>>;
93
- and?: ReadonlyArray<QueryWhere<TableName>>;
94
- $or?: ReadonlyArray<QueryWhere<TableName>>;
95
- or?: ReadonlyArray<QueryWhere<TableName>>;
96
- $nor?: ReadonlyArray<QueryWhere<TableName>>;
97
- nor?: ReadonlyArray<QueryWhere<TableName>>;
98
- $not?: QueryWhere<TableName>;
99
- not?: QueryWhere<TableName>;
100
- };
101
-
102
- export type QueryWhere<TableName extends TableNames> = Partial<
103
- {
104
- [K in keyof TableDocMap[TableName]]?: QueryWhereField<
105
- TableDocMap[TableName][K]
106
- >;
107
- }
108
- > &
109
- LogicalWhere<TableName> &
110
- Record<string, unknown>;
111
-
112
- export type QuerySortKey<TableName extends TableNames> = keyof TableDocMap[TableName] &
113
- string;
114
-
115
- export type QuerySort<TableName extends TableNames> =
116
- | Partial<Record<QuerySortKey<TableName>, SortDirection>>
117
- | Array<[QuerySortKey<TableName>, SortDirection]>
118
- | Record<string, SortDirection>
119
- | Array<[string, SortDirection]>;
120
-
121
- type GeoCoordinates = readonly [number, number];
122
-
123
- export type GeoPoint = {
124
- type: "Point";
125
- coordinates: GeoCoordinates;
126
- };
127
-
128
- type GeoPointInput = GeoPoint | GeoCoordinates;
129
-
130
- const GEO_EARTH_RADIUS_METERS = 6_378_100;
131
-
132
- const __geoNormalizePoint = (point: GeoPointInput): GeoPoint =>
133
- Array.isArray(point)
134
- ? { type: "Point", coordinates: [point[0], point[1]] }
135
- : (point as GeoPoint);
136
-
137
- export const geo = {
138
- point(lng: number, lat: number): GeoPoint {
139
- return { type: "Point", coordinates: [lng, lat] };
140
- },
141
- near(
142
- field: string,
143
- point: GeoPointInput,
144
- options: { maxDistanceMeters?: number; minDistanceMeters?: number } = {}
145
- ): Record<string, unknown> {
146
- const $near: Record<string, unknown> = {
147
- $geometry: __geoNormalizePoint(point),
148
- };
149
- if (options.maxDistanceMeters !== undefined)
150
- $near.$maxDistance = options.maxDistanceMeters;
151
- if (options.minDistanceMeters !== undefined)
152
- $near.$minDistance = options.minDistanceMeters;
153
- return { [field]: { $near } };
154
- },
155
- withinRadius(
156
- field: string,
157
- center: GeoPointInput,
158
- radiusMeters: number
159
- ): Record<string, unknown> {
160
- return {
161
- [field]: {
162
- $geoWithin: {
163
- $centerSphere: [
164
- __geoNormalizePoint(center).coordinates,
165
- radiusMeters / GEO_EARTH_RADIUS_METERS,
166
- ],
167
- },
168
- },
169
- };
170
- },
171
- withinBox(
172
- field: string,
173
- southwest: GeoPointInput,
174
- northeast: GeoPointInput
175
- ): Record<string, unknown> {
176
- return {
177
- [field]: {
178
- $geoWithin: {
179
- $box: [
180
- __geoNormalizePoint(southwest).coordinates,
181
- __geoNormalizePoint(northeast).coordinates,
182
- ],
183
- },
184
- },
185
- };
186
- },
187
- withinPolygon(
188
- field: string,
189
- polygon: ReadonlyArray<GeoPointInput>
190
- ): Record<string, unknown> {
191
- return {
192
- [field]: {
193
- $geoWithin: {
194
- $polygon: polygon.map((p) =>
195
- __geoNormalizePoint(p).coordinates
196
- ),
197
- },
198
- },
199
- };
200
- },
201
- intersects(
202
- field: string,
203
- geometry: { type: string; coordinates: unknown }
204
- ): Record<string, unknown> {
205
- return {
206
- [field]: {
207
- $geoIntersects: {
208
- $geometry: geometry,
209
- },
210
- },
211
- };
212
- },
213
- };
214
-
215
- type SelectedKeys<TDoc, TSelect> =
216
- TSelect extends readonly (infer TKey)[]
217
- ? Extract<TKey, Keys<TDoc>>
218
- : TSelect extends Record<infer TKey, boolean>
219
- ? Extract<TKey, Keys<TDoc>>
220
- : Keys<TDoc>;
221
-
222
- type IncludedKeys<TDoc, TInclude> =
223
- TInclude extends readonly (infer TKey)[]
224
- ? Extract<TKey, PopulatableKeys<TDoc>>
225
- : TInclude extends Record<infer TKey, boolean>
226
- ? Extract<TKey, PopulatableKeys<TDoc>>
227
- : never;
228
-
229
- export type AppflareSelect<TDoc> =
230
- | ReadonlyArray<Keys<TDoc>>
231
- | Partial<Record<Keys<TDoc>, boolean>>;
232
-
233
- type PopulatedDocForKey<TDoc, TKey extends Keys<TDoc>> =
234
- NonNil<PopulateValue<TDoc[TKey]>> extends Array<infer TItem>
235
- ? NonNil<TItem>
236
- : NonNil<PopulateValue<TDoc[TKey]>>;
237
-
238
- type AggregateSpec<TDoc> = {
239
- count?: boolean;
240
- sum?: ReadonlyArray<NumericKeys<TDoc>>;
241
- avg?: ReadonlyArray<NumericKeys<TDoc>>;
242
- };
243
-
244
- type AppflareIncludeRecord<TDoc> = {
245
- [K in PopulatableKeys<TDoc>]?:
246
- | boolean
247
- | {
248
- aggregate?: AggregateSpec<PopulatedDocForKey<TDoc, K>>;
249
- includeDocs?: boolean;
250
- };
251
- };
252
-
253
- export type AppflareInclude<TDoc> =
254
- | ReadonlyArray<PopulatableKeys<TDoc>>
255
- | AppflareIncludeRecord<TDoc>;
256
-
257
- type ExtractAggregateSpec<T> = T extends { aggregate?: infer TSpec } ? TSpec : never;
258
-
259
- type AggregateResultFromSpec<TDoc, TSpec> = (TSpec extends { count: true }
260
- ? { count: number }
261
- : {}) &
262
- (TSpec extends { sum: infer TSum }
263
- ? TSum extends ReadonlyArray<infer K>
264
- ? { [P in Extract<K, NumericKeys<TDoc>> as \`sum_\${P}\`]: number }
265
- : {}
266
- : {}) &
267
- (TSpec extends { avg: infer TAvg }
268
- ? TAvg extends ReadonlyArray<infer K>
269
- ? { [P in Extract<K, NumericKeys<TDoc>> as \`avg_\${P}\`]: number }
270
- : {}
271
- : {});
272
-
273
- type AggregateMapForInclude<TDoc, TInclude> = TInclude extends ReadonlyArray<any>
274
- ? {}
275
- : {
276
- [K in keyof TInclude as ExtractAggregateSpec<TInclude[K]> extends never
277
- ? never
278
- : K]: AggregateResultFromSpec<
279
- PopulatedDocForKey<TDoc, Extract<K, Keys<TDoc>>>,
280
- ExtractAggregateSpec<TInclude[K]>
281
- >;
282
- };
283
-
284
- type WithAggregatesForInclude<TDoc, TInclude> = keyof AggregateMapForInclude<
285
- TDoc,
286
- TInclude
287
- > extends never
288
- ? {}
289
- : { _aggregates: AggregateMapForInclude<TDoc, TInclude> };
290
-
291
- type AppflareResultDoc<TDoc, TSelect, TInclude> =
292
- WithSelected<
293
- WithPopulatedMany<TDoc, IncludedKeys<TDoc, TInclude>>,
294
- SelectedKeys<TDoc, TSelect>
295
- > &
296
- WithAggregatesForInclude<TDoc, TInclude>;
297
-
298
- export type AppflareFindManyArgs<TableName extends TableNames> = {
299
- where?: QueryWhere<TableName>;
300
- orderBy?: QuerySort<TableName>;
301
- skip?: number;
302
- take?: number;
303
- select?: AppflareSelect<TableDocMap[TableName]>;
304
- include?: AppflareInclude<TableDocMap[TableName]>;
305
- };
306
-
307
- export type AppflareFindFirstArgs<TableName extends TableNames> =
308
- AppflareFindManyArgs<TableName>;
309
-
310
- export type AppflareFindUniqueArgs<TableName extends TableNames> = Omit<
311
- AppflareFindManyArgs<TableName>,
312
- "skip" | "take" | "orderBy"
313
- > & {
314
- where: Id<TableName> | QueryWhere<TableName>;
315
- };
316
-
317
- export type AppflareCreateArgs<TableName extends TableNames> = {
318
- data: EditableDoc<TableName>;
319
- select?: AppflareSelect<TableDocMap[TableName]>;
320
- include?: AppflareInclude<TableDocMap[TableName]>;
321
- };
322
-
323
- export type AppflareUpdateArgs<TableName extends TableNames> = {
324
- where: Id<TableName> | QueryWhere<TableName>;
325
- data: Partial<EditableDoc<TableName>>;
326
- select?: AppflareSelect<TableDocMap[TableName]>;
327
- include?: AppflareInclude<TableDocMap[TableName]>;
328
- };
329
-
330
- export type AppflareDeleteArgs<TableName extends TableNames> = {
331
- where: Id<TableName> | QueryWhere<TableName>;
332
- select?: AppflareSelect<TableDocMap[TableName]>;
333
- include?: AppflareInclude<TableDocMap[TableName]>;
334
- };
335
-
336
- export type AppflareUpdateManyArgs<TableName extends TableNames> = {
337
- where?: QueryWhere<TableName>;
338
- data: Partial<EditableDoc<TableName>>;
339
- };
340
-
341
- export type AppflareDeleteManyArgs<TableName extends TableNames> = {
342
- where?: QueryWhere<TableName>;
343
- };
344
-
345
- export type AppflareCountArgs<TableName extends TableNames> = {
346
- where?: QueryWhere<TableName>;
347
- };
348
-
349
- type AggregateGroupInput<TDoc> =
350
- | ReadonlyArray<keyof TDoc & string>
351
- | (keyof TDoc & string);
352
-
353
- type NormalizeGroupInput<TDoc, TGroup> =
354
- TGroup extends readonly (infer K)[]
355
- ? ReadonlyArray<Extract<K, keyof TDoc & string>>
356
- : TGroup extends string
357
- ? ReadonlyArray<Extract<TGroup, keyof TDoc & string>>
358
- : ReadonlyArray<never>;
359
-
360
- type AggregateId<TDoc, TGroup extends ReadonlyArray<keyof TDoc & string>> =
361
- TGroup extends readonly []
362
- ? null
363
- : TGroup extends readonly [infer K]
364
- ? TDoc[Extract<K, keyof TDoc>]
365
- : { [K in TGroup[number]]: TDoc[K] };
366
-
367
- type AggregateResult<
368
- TDoc,
369
- TGroup extends ReadonlyArray<keyof TDoc & string>,
370
- TSum extends ReadonlyArray<NumericKeys<TDoc>>,
371
- TAvg extends ReadonlyArray<NumericKeys<TDoc>>,
372
- > = {
373
- _id: AggregateId<TDoc, TGroup>;
374
- } & (TSum[number] extends never ? {} : { [K in TSum[number] as \`sum_\${K}\`]: number }) &
375
- (TAvg[number] extends never ? {} : { [K in TAvg[number] as \`avg_\${K}\`]: number });
376
-
377
- export type AppflareAggregateArgs<
378
- TableName extends TableNames,
379
- TGroup = AggregateGroupInput<TableDocMap[TableName]>,
380
- TSum extends ReadonlyArray<NumericKeys<TableDocMap[TableName]>> = ReadonlyArray<
381
- NumericKeys<TableDocMap[TableName]>
382
- >,
383
- TAvg extends ReadonlyArray<NumericKeys<TableDocMap[TableName]>> = ReadonlyArray<
384
- NumericKeys<TableDocMap[TableName]>
385
- >,
386
- > = {
387
- where?: QueryWhere<TableName>;
388
- groupBy?: TGroup;
389
- sum?: TSum;
390
- avg?: TAvg;
391
- /**
392
- * Populate aggregated group keys that are references to other tables.
393
- * Only keys present in groupBy are eligible for populate.
394
- */
395
- populate?: AppflareInclude<TableDocMap[TableName]>;
396
- };
397
-
398
- export type AppflareTableClient<TableName extends TableNames> = {
399
- findMany<TSelect = AppflareSelect<TableDocMap[TableName]>, TInclude = never>(
400
- args?: AppflareFindManyArgs<TableName> & {
401
- select?: TSelect;
402
- include?: TInclude;
403
- }
404
- ): Promise<
405
- Array<AppflareResultDoc<TableDocMap[TableName], TSelect, TInclude>>
406
- >;
407
- findFirst<
408
- TSelect = AppflareSelect<TableDocMap[TableName]>,
409
- TInclude = never,
410
- >(
411
- args?: AppflareFindFirstArgs<TableName> & {
412
- select?: TSelect;
413
- include?: TInclude;
414
- }
415
- ): Promise<
416
- AppflareResultDoc<TableDocMap[TableName], TSelect, TInclude> | null
417
- >;
418
- findUnique<
419
- TSelect = AppflareSelect<TableDocMap[TableName]>,
420
- TInclude = never,
421
- >(
422
- args: AppflareFindUniqueArgs<TableName> & {
423
- select?: TSelect;
424
- include?: TInclude;
425
- }
426
- ): Promise<
427
- AppflareResultDoc<TableDocMap[TableName], TSelect, TInclude> | null
428
- >;
429
- create<
430
- TSelect = AppflareSelect<TableDocMap[TableName]>,
431
- TInclude = never,
432
- >(
433
- args: AppflareCreateArgs<TableName> & {
434
- select?: TSelect;
435
- include?: TInclude;
436
- }
437
- ): Promise<
438
- AppflareResultDoc<TableDocMap[TableName], TSelect, TInclude>
439
- >;
440
- update<
441
- TSelect = AppflareSelect<TableDocMap[TableName]>,
442
- TInclude = never,
443
- >(
444
- args: AppflareUpdateArgs<TableName> & {
445
- select?: TSelect;
446
- include?: TInclude;
447
- }
448
- ): Promise<
449
- AppflareResultDoc<TableDocMap[TableName], TSelect, TInclude> | null
450
- >;
451
- updateMany(args: AppflareUpdateManyArgs<TableName>): Promise<{ count: number }>;
452
- delete<
453
- TSelect = AppflareSelect<TableDocMap[TableName]>,
454
- TInclude = never,
455
- >(
456
- args: AppflareDeleteArgs<TableName> & {
457
- select?: TSelect;
458
- include?: TInclude;
459
- }
460
- ): Promise<
461
- AppflareResultDoc<TableDocMap[TableName], TSelect, TInclude> | null
462
- >;
463
- deleteMany(args?: AppflareDeleteManyArgs<TableName>): Promise<{ count: number }>;
464
- count(args?: AppflareCountArgs<TableName>): Promise<number>;
465
- aggregate<
466
- TGroup = AggregateGroupInput<TableDocMap[TableName]>,
467
- TSum extends ReadonlyArray<NumericKeys<TableDocMap[TableName]>> = ReadonlyArray<
468
- NumericKeys<TableDocMap[TableName]>
469
- >,
470
- TAvg extends ReadonlyArray<NumericKeys<TableDocMap[TableName]>> = ReadonlyArray<
471
- NumericKeys<TableDocMap[TableName]>
472
- >,
473
- >(
474
- args: AppflareAggregateArgs<TableName, TGroup, TSum, TAvg>
475
- ): Promise<
476
- Array<
477
- AggregateResult<
478
- TableDocMap[TableName],
479
- NormalizeGroupInput<TableDocMap[TableName], TGroup>,
480
- TSum,
481
- TAvg
482
- >
483
- >
484
- >;
485
- };
486
-
487
- export type AppflareModelMap = {
488
- [K in TableNames]: AppflareTableClient<K>;
489
- };
490
-
491
- export type DatabaseReader = AppflareModelMap;
492
-
493
- declare global {
494
- interface AppflareSchedulerHandlerMap {}
495
- }
496
-
497
- type SchedulerTaskKeys = keyof AppflareSchedulerHandlerMap;
498
-
499
- export type SchedulerTaskName = [SchedulerTaskKeys] extends [never]
500
- ? string
501
- : SchedulerTaskKeys;
502
-
503
- export type SchedulerPayload<TTask extends SchedulerTaskName> =
504
- TTask extends keyof AppflareSchedulerHandlerMap
505
- ? AppflareSchedulerHandlerMap[TTask]
506
- : unknown;
507
-
508
- export type SchedulerEnqueueOptions = { delaySeconds?: number };
509
-
510
- type SchedulerEnqueueTyped = {
511
- <TTask extends SchedulerTaskName>(
512
- task: TTask,
513
- ...args: SchedulerPayload<TTask> extends undefined
514
- ? [payload?: SchedulerPayload<TTask>, options?: SchedulerEnqueueOptions]
515
- : [payload: SchedulerPayload<TTask>, options?: SchedulerEnqueueOptions]
516
- ): Promise<void>;
517
- };
518
-
519
- export type Scheduler = {
520
- enqueue: SchedulerEnqueueTyped;
521
- };
522
-
523
- export type SchedulerContext<Env = unknown> = AppflareAuthContext & {
524
- db: DatabaseReader;
525
- scheduler: Scheduler;
526
- env: Env;
527
- };
528
-
529
- export type SchedulerDefinition<
530
- TArgs extends QueryArgsShape | undefined = undefined,
531
- Env = unknown,
532
- > = {
533
- args?: TArgs;
534
- handler: (
535
- ctx: SchedulerContext<Env>,
536
- payload: TArgs extends QueryArgsShape ? InferQueryArgs<TArgs> : undefined
537
- ) => Promise<void>;
538
- };
539
-
540
- export const scheduler = <TArgs extends QueryArgsShape | undefined = undefined, Env = unknown>(
541
- definition: SchedulerDefinition<TArgs, Env>
542
- ): SchedulerDefinition<TArgs, Env> => definition;
543
-
544
- type ScheduledController = {
545
- cron: string;
546
- scheduledTime?: number;
547
- nextScheduledTime?: number;
548
- };
549
-
550
- type ExecutionContext = {
551
- waitUntil(promise: Promise<unknown>): void;
552
- };
553
-
554
- type CronTriggerInput = string | readonly string[];
555
-
556
- export type CronContext<Env = unknown> = AppflareAuthContext & {
557
- db: DatabaseReader;
558
- scheduler?: Scheduler;
559
- env: Env;
560
- controller: ScheduledController;
561
- ctx: ExecutionContext;
562
- };
563
-
564
- export type CronDefinition<Env = unknown> = {
565
- cronTrigger: CronTriggerInput;
566
- handler: (ctx: CronContext<Env>) => Promise<void>;
567
- };
568
-
569
- export const cron = <Env = unknown>(
570
- definition: CronDefinition<Env>
571
- ): CronDefinition<Env> => definition;
572
-
573
- export type AppflareHandlerError = Error & {
574
- status: number;
575
- details?: unknown;
576
- __appflareHandlerError: true;
577
- };
578
-
579
- export type AppflareErrorFactory = (
580
- status: number,
581
- message?: string,
582
- details?: unknown
583
- ) => AppflareHandlerError;
584
-
585
- export interface QueryContext extends AppflareAuthContext {
586
- db: DatabaseReader;
587
- scheduler?: Scheduler;
588
- error: AppflareErrorFactory;
589
- }
590
-
591
- export interface InternalQueryContext {
592
- db: DatabaseReader;
593
- scheduler?: Scheduler;
594
- }
595
-
596
- export type QueryArgsShape = Record<string, AnyValidator>;
597
-
598
- type InferValidator<TValidator> =
599
- TValidator extends SchemaValidator<infer TValue> ? TValue : never;
600
-
601
- export type InferQueryArgs<TArgs extends QueryArgsShape> = {
602
- [Key in keyof TArgs]: InferValidator<TArgs[Key]>;
603
- };
604
-
605
- export interface QueryDefinition<TArgs extends QueryArgsShape, TResult> {
606
- args: TArgs;
607
- middleware?: (
608
- ctx: QueryContext,
609
- args: InferQueryArgs<TArgs>
610
- ) => Promise<TResult | void>;
611
- handler: (ctx: QueryContext, args: InferQueryArgs<TArgs>) => Promise<TResult>;
612
- }
613
-
614
- export const query = <TArgs extends QueryArgsShape, TResult>(
615
- definition: QueryDefinition<TArgs, TResult>
616
- ): QueryDefinition<TArgs, TResult> => definition;
617
-
618
- export type EditableDoc<TableName extends TableNames> = FriendlyDoc<
619
- Omit<TableDocMap[TableName], "_id" | "_creationTime">
620
- >;
621
-
622
- export interface DatabaseWriter extends DatabaseReader {}
623
-
624
- export interface MutationContext extends AppflareAuthContext {
625
- db: DatabaseWriter;
626
- scheduler?: Scheduler;
627
- error: AppflareErrorFactory;
628
- }
629
-
630
- export interface MutationDefinition<TArgs extends QueryArgsShape, TResult> {
631
- args: TArgs;
632
- middleware?: (
633
- ctx: MutationContext,
634
- args: InferQueryArgs<TArgs>
635
- ) => Promise<TResult | void>;
636
- handler: (
637
- ctx: MutationContext,
638
- args: InferQueryArgs<TArgs>
639
- ) => Promise<TResult>;
640
- }
641
-
642
- export const mutation = <TArgs extends QueryArgsShape, TResult>(
643
- definition: MutationDefinition<TArgs, TResult>
644
- ): MutationDefinition<TArgs, TResult> => definition;
645
-
646
- export interface InternalMutationContext {
647
- db: DatabaseWriter;
648
- scheduler?: Scheduler;
649
- }
650
-
651
- export interface InternalQueryDefinition<
652
- TArgs extends QueryArgsShape,
653
- TResult,
654
- > {
655
- args: TArgs;
656
- middleware?: (
657
- ctx: InternalQueryContext,
658
- args: InferQueryArgs<TArgs>
659
- ) => Promise<TResult | void>;
660
- handler: (
661
- ctx: InternalQueryContext,
662
- args: InferQueryArgs<TArgs>
663
- ) => Promise<TResult>;
664
- }
665
-
666
- export const internalQuery = <TArgs extends QueryArgsShape, TResult>(
667
- definition: InternalQueryDefinition<TArgs, TResult>
668
- ): InternalQueryDefinition<TArgs, TResult> => definition;
669
-
670
- export interface InternalMutationDefinition<
671
- TArgs extends QueryArgsShape,
672
- TResult,
673
- > {
674
- args: TArgs;
675
- middleware?: (
676
- ctx: InternalMutationContext,
677
- args: InferQueryArgs<TArgs>
678
- ) => Promise<TResult | void>;
679
- handler: (
680
- ctx: InternalMutationContext,
681
- args: InferQueryArgs<TArgs>
682
- ) => Promise<TResult>;
683
- }
684
-
685
- export const internalMutation = <TArgs extends QueryArgsShape, TResult>(
686
- definition: InternalMutationDefinition<TArgs, TResult>
687
- ): InternalMutationDefinition<TArgs, TResult> => definition;
688
-
689
- export interface HttpContext extends AppflareAuthContext {
690
- db: DatabaseWriter;
691
- scheduler?: Scheduler;
692
- error: AppflareErrorFactory;
693
- }
694
-
695
- export interface HttpDefinition {
696
- handler: (ctx: HttpContext, request: Request) => Promise<Response>;
697
- }
698
-
699
- export const http = (
700
- definition: HttpDefinition
701
- ): HttpDefinition => definition;
702
- `;