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.
- package/cli/commands/index.ts +140 -0
- package/cli/generate.ts +149 -0
- package/cli/index.ts +56 -447
- package/cli/load-config.ts +182 -0
- package/cli/schema-compiler.ts +657 -0
- package/cli/templates/auth/README.md +156 -0
- package/cli/templates/auth/config.ts +61 -0
- package/cli/templates/auth/route-config.ts +18 -0
- package/cli/templates/auth/route-handler.ts +18 -0
- package/cli/templates/auth/route-request-utils.ts +55 -0
- package/cli/templates/auth/route.ts +14 -0
- package/cli/templates/core/README.md +266 -0
- package/cli/templates/core/app-creation.ts +19 -0
- package/cli/templates/core/client/appflare.ts +37 -0
- package/cli/templates/core/client/index.ts +6 -0
- package/cli/templates/core/client/storage.ts +100 -0
- package/cli/templates/core/client/types.ts +54 -0
- package/cli/templates/core/client-modules/appflare.ts +112 -0
- package/cli/templates/core/client-modules/handlers/index.ts +740 -0
- package/cli/templates/core/client-modules/handlers.ts +1 -0
- package/cli/templates/core/client-modules/index.ts +7 -0
- package/cli/templates/core/client-modules/storage.ts +180 -0
- package/cli/templates/core/client-modules/types.ts +145 -0
- package/cli/templates/core/client.ts +39 -0
- package/cli/templates/core/drizzle.ts +15 -0
- package/cli/templates/core/export.ts +14 -0
- package/cli/templates/core/handlers-route.ts +23 -0
- package/cli/templates/core/handlers.ts +1 -0
- package/cli/templates/core/imports.ts +8 -0
- package/cli/templates/core/server.ts +38 -0
- package/cli/templates/core/types.ts +6 -0
- package/cli/templates/core/wrangler.ts +109 -0
- package/cli/templates/handlers/README.md +265 -0
- package/cli/templates/handlers/auth.ts +36 -0
- package/cli/templates/handlers/execution.ts +39 -0
- package/cli/templates/handlers/generators/context/context-creation.ts +80 -0
- package/cli/templates/handlers/generators/context/error-helpers.ts +11 -0
- package/cli/templates/handlers/generators/context/scheduler.ts +24 -0
- package/cli/templates/handlers/generators/context/storage-api.ts +112 -0
- package/cli/templates/handlers/generators/context/storage-helpers.ts +59 -0
- package/cli/templates/handlers/generators/context/types.ts +18 -0
- package/cli/templates/handlers/generators/context.ts +43 -0
- package/cli/templates/handlers/generators/execution.ts +15 -0
- package/cli/templates/handlers/generators/handlers.ts +13 -0
- package/cli/templates/handlers/index.ts +43 -0
- package/cli/templates/handlers/operations.ts +116 -0
- package/cli/templates/handlers/registration.ts +1114 -0
- package/cli/templates/handlers/types.ts +960 -0
- package/cli/templates/handlers/utils.ts +48 -0
- package/cli/types.ts +108 -0
- package/cli/utils/handler-discovery.ts +366 -0
- package/cli/utils/json-utils.ts +24 -0
- package/cli/utils/path-utils.ts +19 -0
- package/cli/utils/schema-discovery.ts +390 -0
- package/index.ts +27 -4
- package/package.json +23 -20
- package/react/index.ts +5 -3
- package/react/use-infinite-query.ts +190 -0
- package/react/use-mutation.ts +54 -0
- package/react/use-query.ts +158 -0
- package/schema.ts +262 -0
- package/tsconfig.json +2 -4
- package/cli/README.md +0 -108
- package/cli/core/build.ts +0 -187
- package/cli/core/config.ts +0 -92
- package/cli/core/discover-handlers.ts +0 -143
- package/cli/core/handlers.ts +0 -7
- package/cli/core/index.ts +0 -205
- package/cli/generators/generate-api-client/client.ts +0 -163
- package/cli/generators/generate-api-client/extract-configuration.ts +0 -121
- package/cli/generators/generate-api-client/index.ts +0 -973
- package/cli/generators/generate-api-client/types.ts +0 -164
- package/cli/generators/generate-api-client/utils.ts +0 -22
- package/cli/generators/generate-api-client.ts +0 -1
- package/cli/generators/generate-cloudflare-worker/helpers.ts +0 -24
- package/cli/generators/generate-cloudflare-worker/index.ts +0 -2
- package/cli/generators/generate-cloudflare-worker/worker.ts +0 -148
- package/cli/generators/generate-cloudflare-worker/wrangler.ts +0 -108
- package/cli/generators/generate-cloudflare-worker.ts +0 -4
- package/cli/generators/generate-cron-handlers/cron-handlers-block.ts +0 -2
- package/cli/generators/generate-cron-handlers/handler-entries.ts +0 -29
- package/cli/generators/generate-cron-handlers/index.ts +0 -61
- package/cli/generators/generate-cron-handlers/runtime-block.ts +0 -49
- package/cli/generators/generate-cron-handlers/type-helpers-block.ts +0 -60
- package/cli/generators/generate-db-handlers/index.ts +0 -33
- package/cli/generators/generate-db-handlers/prepare.ts +0 -24
- package/cli/generators/generate-db-handlers/templates.ts +0 -189
- package/cli/generators/generate-db-handlers.ts +0 -1
- package/cli/generators/generate-hono-server/auth.ts +0 -97
- package/cli/generators/generate-hono-server/imports.ts +0 -55
- package/cli/generators/generate-hono-server/index.ts +0 -52
- package/cli/generators/generate-hono-server/routes.ts +0 -115
- package/cli/generators/generate-hono-server/template.ts +0 -371
- package/cli/generators/generate-hono-server.ts +0 -1
- package/cli/generators/generate-scheduler-handlers/constants.ts +0 -8
- package/cli/generators/generate-scheduler-handlers/handler-entries.ts +0 -22
- package/cli/generators/generate-scheduler-handlers/index.ts +0 -51
- package/cli/generators/generate-scheduler-handlers/runtime-block.ts +0 -68
- package/cli/generators/generate-scheduler-handlers/scheduler-handlers-block.ts +0 -2
- package/cli/generators/generate-scheduler-handlers/type-helpers-block.ts +0 -68
- package/cli/generators/generate-scheduler-handlers.ts +0 -1
- package/cli/generators/generate-websocket-durable-object/auth.ts +0 -30
- package/cli/generators/generate-websocket-durable-object/imports.ts +0 -55
- package/cli/generators/generate-websocket-durable-object/index.ts +0 -41
- package/cli/generators/generate-websocket-durable-object/query-handlers.ts +0 -18
- package/cli/generators/generate-websocket-durable-object/template.ts +0 -714
- package/cli/generators/generate-websocket-durable-object.ts +0 -1
- package/cli/schema/schema-static-types.ts +0 -702
- package/cli/schema/schema.ts +0 -151
- package/cli/utils/tsc.ts +0 -54
- package/cli/utils/utils.ts +0 -190
- package/cli/utils/zod-utils.ts +0 -121
- package/lib/README.md +0 -50
- package/lib/db.ts +0 -19
- package/lib/location.ts +0 -110
- package/lib/values.ts +0 -27
- package/react/README.md +0 -67
- package/react/hooks/useMutation.ts +0 -89
- package/react/hooks/usePaginatedQuery.ts +0 -213
- package/react/hooks/useQuery.ts +0 -106
- package/react/shared/queryShared.ts +0 -174
- package/server/README.md +0 -218
- package/server/auth.ts +0 -107
- package/server/database/builders.ts +0 -83
- package/server/database/context.ts +0 -327
- package/server/database/populate.ts +0 -234
- package/server/database/query-builder.ts +0 -161
- package/server/database/query-utils.ts +0 -25
- package/server/db.ts +0 -2
- package/server/storage/auth.ts +0 -16
- package/server/storage/bucket.ts +0 -22
- package/server/storage/context.ts +0 -34
- package/server/storage/index.ts +0 -38
- package/server/storage/operations.ts +0 -149
- package/server/storage/route-handler.ts +0 -60
- package/server/storage/types.ts +0 -55
- package/server/storage/utils.ts +0 -47
- package/server/storage.ts +0 -6
- package/server/types/schema-refs.ts +0 -66
- package/server/types/types.ts +0 -633
- 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
|
-
`;
|