appflare 0.0.28 → 0.1.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 (141) 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 +740 -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 +265 -0
  34. package/cli/templates/handlers/auth.ts +36 -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/index.ts +43 -0
  46. package/cli/templates/handlers/operations.ts +116 -0
  47. package/cli/templates/handlers/registration.ts +1114 -0
  48. package/cli/templates/handlers/types.ts +960 -0
  49. package/cli/templates/handlers/utils.ts +48 -0
  50. package/cli/types.ts +108 -0
  51. package/cli/utils/handler-discovery.ts +366 -0
  52. package/cli/utils/json-utils.ts +24 -0
  53. package/cli/utils/path-utils.ts +19 -0
  54. package/cli/utils/schema-discovery.ts +390 -0
  55. package/index.ts +27 -4
  56. package/package.json +23 -20
  57. package/react/index.ts +5 -3
  58. package/react/use-infinite-query.ts +190 -0
  59. package/react/use-mutation.ts +54 -0
  60. package/react/use-query.ts +158 -0
  61. package/schema.ts +262 -0
  62. package/tsconfig.json +2 -4
  63. package/cli/README.md +0 -108
  64. package/cli/core/build.ts +0 -187
  65. package/cli/core/config.ts +0 -92
  66. package/cli/core/discover-handlers.ts +0 -143
  67. package/cli/core/handlers.ts +0 -7
  68. package/cli/core/index.ts +0 -205
  69. package/cli/generators/generate-api-client/client.ts +0 -163
  70. package/cli/generators/generate-api-client/extract-configuration.ts +0 -121
  71. package/cli/generators/generate-api-client/index.ts +0 -973
  72. package/cli/generators/generate-api-client/types.ts +0 -164
  73. package/cli/generators/generate-api-client/utils.ts +0 -22
  74. package/cli/generators/generate-api-client.ts +0 -1
  75. package/cli/generators/generate-cloudflare-worker/helpers.ts +0 -24
  76. package/cli/generators/generate-cloudflare-worker/index.ts +0 -2
  77. package/cli/generators/generate-cloudflare-worker/worker.ts +0 -148
  78. package/cli/generators/generate-cloudflare-worker/wrangler.ts +0 -108
  79. package/cli/generators/generate-cloudflare-worker.ts +0 -4
  80. package/cli/generators/generate-cron-handlers/cron-handlers-block.ts +0 -2
  81. package/cli/generators/generate-cron-handlers/handler-entries.ts +0 -29
  82. package/cli/generators/generate-cron-handlers/index.ts +0 -61
  83. package/cli/generators/generate-cron-handlers/runtime-block.ts +0 -49
  84. package/cli/generators/generate-cron-handlers/type-helpers-block.ts +0 -60
  85. package/cli/generators/generate-db-handlers/index.ts +0 -33
  86. package/cli/generators/generate-db-handlers/prepare.ts +0 -24
  87. package/cli/generators/generate-db-handlers/templates.ts +0 -189
  88. package/cli/generators/generate-db-handlers.ts +0 -1
  89. package/cli/generators/generate-hono-server/auth.ts +0 -97
  90. package/cli/generators/generate-hono-server/imports.ts +0 -55
  91. package/cli/generators/generate-hono-server/index.ts +0 -52
  92. package/cli/generators/generate-hono-server/routes.ts +0 -115
  93. package/cli/generators/generate-hono-server/template.ts +0 -371
  94. package/cli/generators/generate-hono-server.ts +0 -1
  95. package/cli/generators/generate-scheduler-handlers/constants.ts +0 -8
  96. package/cli/generators/generate-scheduler-handlers/handler-entries.ts +0 -22
  97. package/cli/generators/generate-scheduler-handlers/index.ts +0 -51
  98. package/cli/generators/generate-scheduler-handlers/runtime-block.ts +0 -68
  99. package/cli/generators/generate-scheduler-handlers/scheduler-handlers-block.ts +0 -2
  100. package/cli/generators/generate-scheduler-handlers/type-helpers-block.ts +0 -68
  101. package/cli/generators/generate-scheduler-handlers.ts +0 -1
  102. package/cli/generators/generate-websocket-durable-object/auth.ts +0 -30
  103. package/cli/generators/generate-websocket-durable-object/imports.ts +0 -55
  104. package/cli/generators/generate-websocket-durable-object/index.ts +0 -41
  105. package/cli/generators/generate-websocket-durable-object/query-handlers.ts +0 -18
  106. package/cli/generators/generate-websocket-durable-object/template.ts +0 -714
  107. package/cli/generators/generate-websocket-durable-object.ts +0 -1
  108. package/cli/schema/schema-static-types.ts +0 -702
  109. package/cli/schema/schema.ts +0 -151
  110. package/cli/utils/tsc.ts +0 -54
  111. package/cli/utils/utils.ts +0 -190
  112. package/cli/utils/zod-utils.ts +0 -121
  113. package/lib/README.md +0 -50
  114. package/lib/db.ts +0 -19
  115. package/lib/location.ts +0 -110
  116. package/lib/values.ts +0 -27
  117. package/react/README.md +0 -67
  118. package/react/hooks/useMutation.ts +0 -89
  119. package/react/hooks/usePaginatedQuery.ts +0 -213
  120. package/react/hooks/useQuery.ts +0 -106
  121. package/react/shared/queryShared.ts +0 -174
  122. package/server/README.md +0 -218
  123. package/server/auth.ts +0 -107
  124. package/server/database/builders.ts +0 -83
  125. package/server/database/context.ts +0 -327
  126. package/server/database/populate.ts +0 -234
  127. package/server/database/query-builder.ts +0 -161
  128. package/server/database/query-utils.ts +0 -25
  129. package/server/db.ts +0 -2
  130. package/server/storage/auth.ts +0 -16
  131. package/server/storage/bucket.ts +0 -22
  132. package/server/storage/context.ts +0 -34
  133. package/server/storage/index.ts +0 -38
  134. package/server/storage/operations.ts +0 -149
  135. package/server/storage/route-handler.ts +0 -60
  136. package/server/storage/types.ts +0 -55
  137. package/server/storage/utils.ts +0 -47
  138. package/server/storage.ts +0 -6
  139. package/server/types/schema-refs.ts +0 -66
  140. package/server/types/types.ts +0 -633
  141. 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
- `;