appflare 0.2.29 → 0.2.31

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 (140) hide show
  1. package/Documentation.md +758 -758
  2. package/cli/commands/index.ts +238 -238
  3. package/cli/generate.ts +178 -178
  4. package/cli/index.ts +120 -120
  5. package/cli/load-config.ts +184 -184
  6. package/cli/schema-compiler.ts +1183 -1183
  7. package/cli/templates/auth/README.md +156 -156
  8. package/cli/templates/auth/config.ts +61 -61
  9. package/cli/templates/auth/route-config.ts +1 -1
  10. package/cli/templates/auth/route-handler.ts +1 -1
  11. package/cli/templates/auth/route-request-utils.ts +5 -5
  12. package/cli/templates/auth/route.config.ts +18 -18
  13. package/cli/templates/auth/route.handler.ts +18 -18
  14. package/cli/templates/auth/route.request-utils.ts +55 -55
  15. package/cli/templates/auth/route.ts +14 -14
  16. package/cli/templates/core/README.md +266 -266
  17. package/cli/templates/core/app-creation.ts +19 -19
  18. package/cli/templates/core/client/appflare.ts +112 -112
  19. package/cli/templates/core/client/handlers/index.ts +748 -748
  20. package/cli/templates/core/client/handlers.ts +1 -1
  21. package/cli/templates/core/client/index.ts +7 -7
  22. package/cli/templates/core/client/storage.ts +195 -195
  23. package/cli/templates/core/client/types.ts +186 -186
  24. package/cli/templates/core/client-modules/appflare.ts +1 -1
  25. package/cli/templates/core/client-modules/handlers.ts +1 -1
  26. package/cli/templates/core/client-modules/index.ts +1 -1
  27. package/cli/templates/core/client-modules/storage.ts +1 -1
  28. package/cli/templates/core/client-modules/types.ts +1 -1
  29. package/cli/templates/core/client.artifacts.ts +39 -39
  30. package/cli/templates/core/client.ts +4 -4
  31. package/cli/templates/core/drizzle.ts +15 -15
  32. package/cli/templates/core/export.ts +14 -14
  33. package/cli/templates/core/handlers.route.ts +24 -24
  34. package/cli/templates/core/handlers.ts +1 -1
  35. package/cli/templates/core/imports.ts +9 -9
  36. package/cli/templates/core/server.ts +38 -38
  37. package/cli/templates/core/types.ts +6 -6
  38. package/cli/templates/core/wrangler.ts +109 -109
  39. package/cli/templates/dashboard/builders/functions/index.ts +17 -17
  40. package/cli/templates/dashboard/builders/functions/render-page/header.ts +20 -20
  41. package/cli/templates/dashboard/builders/functions/render-page/index.ts +33 -33
  42. package/cli/templates/dashboard/builders/functions/render-page/request-panel.ts +171 -171
  43. package/cli/templates/dashboard/builders/functions/render-page/result-panel.ts +85 -85
  44. package/cli/templates/dashboard/builders/functions/render-page/scripts.ts +554 -554
  45. package/cli/templates/dashboard/builders/navigation.ts +122 -122
  46. package/cli/templates/dashboard/builders/storage/index.ts +13 -13
  47. package/cli/templates/dashboard/builders/storage/routes/create-directory-route.ts +29 -29
  48. package/cli/templates/dashboard/builders/storage/routes/delete-route.ts +18 -18
  49. package/cli/templates/dashboard/builders/storage/routes/download-route.ts +23 -23
  50. package/cli/templates/dashboard/builders/storage/routes/index.ts +22 -22
  51. package/cli/templates/dashboard/builders/storage/routes/list-route.ts +25 -25
  52. package/cli/templates/dashboard/builders/storage/routes/preview-route.ts +21 -21
  53. package/cli/templates/dashboard/builders/storage/routes/upload-route.ts +21 -21
  54. package/cli/templates/dashboard/builders/storage/runtime/helpers.ts +72 -72
  55. package/cli/templates/dashboard/builders/storage/runtime/storage-page.ts +130 -130
  56. package/cli/templates/dashboard/builders/table-routes/common/drawer-panel.ts +27 -27
  57. package/cli/templates/dashboard/builders/table-routes/common/pagination.ts +30 -30
  58. package/cli/templates/dashboard/builders/table-routes/common/search-bar.ts +23 -23
  59. package/cli/templates/dashboard/builders/table-routes/fragments.ts +217 -217
  60. package/cli/templates/dashboard/builders/table-routes/helpers.ts +45 -45
  61. package/cli/templates/dashboard/builders/table-routes/index.ts +8 -8
  62. package/cli/templates/dashboard/builders/table-routes/table/actions-cell.ts +71 -71
  63. package/cli/templates/dashboard/builders/table-routes/table/get-route.ts +291 -291
  64. package/cli/templates/dashboard/builders/table-routes/table/index.ts +80 -80
  65. package/cli/templates/dashboard/builders/table-routes/table/post-routes.ts +163 -163
  66. package/cli/templates/dashboard/builders/table-routes/table-route.ts +7 -7
  67. package/cli/templates/dashboard/builders/table-routes/users/get-route.ts +69 -69
  68. package/cli/templates/dashboard/builders/table-routes/users/html/modals.ts +57 -57
  69. package/cli/templates/dashboard/builders/table-routes/users/html/page.ts +27 -27
  70. package/cli/templates/dashboard/builders/table-routes/users/html/table.ts +128 -128
  71. package/cli/templates/dashboard/builders/table-routes/users/index.ts +32 -32
  72. package/cli/templates/dashboard/builders/table-routes/users/post-routes.ts +150 -150
  73. package/cli/templates/dashboard/builders/table-routes/users/redirect.ts +14 -14
  74. package/cli/templates/dashboard/builders/table-routes/users-route.ts +10 -10
  75. package/cli/templates/dashboard/components/dashboard-home.ts +23 -23
  76. package/cli/templates/dashboard/components/layout.ts +388 -388
  77. package/cli/templates/dashboard/components/login-page.ts +65 -65
  78. package/cli/templates/dashboard/index.ts +61 -61
  79. package/cli/templates/dashboard/types.ts +9 -9
  80. package/cli/templates/handlers/README.md +353 -353
  81. package/cli/templates/handlers/auth.ts +37 -37
  82. package/cli/templates/handlers/execution.ts +42 -42
  83. package/cli/templates/handlers/generators/context/context-creation.ts +101 -101
  84. package/cli/templates/handlers/generators/context/error-helpers.ts +11 -11
  85. package/cli/templates/handlers/generators/context/scheduler.ts +24 -24
  86. package/cli/templates/handlers/generators/context/storage-api.ts +82 -82
  87. package/cli/templates/handlers/generators/context/storage-helpers.ts +59 -59
  88. package/cli/templates/handlers/generators/context/types.ts +40 -40
  89. package/cli/templates/handlers/generators/context.ts +43 -43
  90. package/cli/templates/handlers/generators/execution.ts +15 -15
  91. package/cli/templates/handlers/generators/handlers.ts +13 -13
  92. package/cli/templates/handlers/generators/registration/modules/cron.ts +26 -26
  93. package/cli/templates/handlers/generators/registration/modules/realtime/auth.ts +75 -75
  94. package/cli/templates/handlers/generators/registration/modules/realtime/durable-object.ts +144 -144
  95. package/cli/templates/handlers/generators/registration/modules/realtime/index.ts +14 -14
  96. package/cli/templates/handlers/generators/registration/modules/realtime/publisher.ts +102 -102
  97. package/cli/templates/handlers/generators/registration/modules/realtime/routes.ts +164 -164
  98. package/cli/templates/handlers/generators/registration/modules/realtime/types.ts +30 -30
  99. package/cli/templates/handlers/generators/registration/modules/realtime/utils.ts +516 -516
  100. package/cli/templates/handlers/generators/registration/modules/scheduler.ts +56 -56
  101. package/cli/templates/handlers/generators/registration/modules/storage.ts +199 -199
  102. package/cli/templates/handlers/generators/registration/sections.ts +210 -210
  103. package/cli/templates/handlers/generators/types/context.ts +92 -92
  104. package/cli/templates/handlers/generators/types/core.ts +106 -106
  105. package/cli/templates/handlers/generators/types/operations.ts +135 -135
  106. package/cli/templates/handlers/generators/types/query-definitions/filter-and-where-types.ts +281 -259
  107. package/cli/templates/handlers/generators/types/query-definitions/query-api-types.ts +135 -135
  108. package/cli/templates/handlers/generators/types/query-definitions/query-helper-functions.ts +1103 -1031
  109. package/cli/templates/handlers/generators/types/query-definitions/schema-and-table-types.ts +278 -246
  110. package/cli/templates/handlers/generators/types/query-definitions.ts +13 -13
  111. package/cli/templates/handlers/generators/types/query-runtime/handled-error.ts +13 -13
  112. package/cli/templates/handlers/generators/types/query-runtime/runtime-aggregate-and-footer.ts +174 -174
  113. package/cli/templates/handlers/generators/types/query-runtime/runtime-read.ts +157 -121
  114. package/cli/templates/handlers/generators/types/query-runtime/runtime-setup.ts +45 -45
  115. package/cli/templates/handlers/generators/types/query-runtime/runtime-write.ts +697 -676
  116. package/cli/templates/handlers/generators/types/query-runtime.ts +15 -15
  117. package/cli/templates/handlers/index.ts +43 -43
  118. package/cli/templates/handlers/operations.ts +116 -116
  119. package/cli/templates/handlers/registration.ts +91 -91
  120. package/cli/templates/handlers/types.ts +15 -15
  121. package/cli/templates/handlers/utils.ts +48 -48
  122. package/cli/types.ts +110 -110
  123. package/cli/utils/handler-discovery.ts +466 -466
  124. package/cli/utils/json-utils.ts +24 -24
  125. package/cli/utils/path-utils.ts +19 -19
  126. package/cli/utils/schema-discovery.ts +399 -399
  127. package/dist/cli/index.d.mts +2 -0
  128. package/dist/cli/index.d.ts +2 -0
  129. package/dist/cli/index.js +301 -118
  130. package/dist/cli/index.mjs +301 -118
  131. package/index.ts +18 -18
  132. package/package.json +58 -58
  133. package/react/index.ts +5 -5
  134. package/react/use-infinite-query.ts +252 -252
  135. package/react/use-mutation.ts +89 -89
  136. package/react/use-query.ts +207 -207
  137. package/schema.ts +415 -415
  138. package/test-better-auth-hash.ts +2 -2
  139. package/tsconfig.json +6 -6
  140. package/tsup.config.ts +82 -82
@@ -1,164 +1,164 @@
1
- export const realtimeRoutesModule = `
2
- function registerRealtimeRoutes(
3
- app: Hono<WorkerEnv>,
4
- options: RegisterHandlersOptions,
5
- ): void {
6
- const subscribePath = options.realtimeSubscribePath ?? "/realtime/subscribe";
7
- const unsubscribePath = "/realtime/unsubscribe";
8
- const websocketPath = options.realtimeWebsocketPath ?? "/realtime/ws";
9
- const protocol = options.realtimeProtocol ?? "appflare.realtime.v1";
10
-
11
- app.post(subscribePath, async (c) => {
12
- const body = await c.req.json().catch(() => ({} as Record<string, unknown>));
13
- const queryName = typeof body.queryName === "string" ? body.queryName : "";
14
- const authToken = typeof body.authToken === "string" ? body.authToken : "";
15
- const rawArgs = isRecord(body.args) ? body.args : {};
16
-
17
- if (!queryName) {
18
- return c.json({ message: "queryName is required" }, 400);
19
- }
20
-
21
- const operation = (realtimeQueryHandlers as Record<
22
- string,
23
- {
24
- definition: unknown;
25
- schema: z.ZodTypeAny;
26
- }
27
- >)[queryName as RealtimeQueryName];
28
- if (!operation) {
29
- return c.json({ message: "Unknown queryName" }, 404);
30
- }
31
-
32
- const authSession = await validateAuthToken(
33
- c.req.raw,
34
- c.env,
35
- options,
36
- authToken,
37
- );
38
-
39
-
40
- let args: Record<string, unknown>;
41
- try {
42
- args = operation.schema.parse(rawArgs) as Record<string, unknown>;
43
- } catch (error) {
44
- if (error instanceof ZodError) {
45
- return c.json({ message: "Invalid query args", issues: error.issues }, 400);
46
- }
47
- return c.json({ message: "Invalid query args" }, 400);
48
- }
49
-
50
- const token = crypto.randomUUID();
51
- const signature = createSubscriptionSignature(queryName, args);
52
- const stub = getRealtimeStub(c.env, options);
53
- if (!stub) {
54
- return c.json({ message: "Realtime binding is not configured" }, 500);
55
- }
56
-
57
- await stub.fetch(
58
- new Request("https://realtime.internal/subscribe", {
59
- method: "POST",
60
- headers: {
61
- "content-type": "application/json",
62
- },
63
- body: JSON.stringify({
64
- token,
65
- signature,
66
- queryName,
67
- args,
68
- authToken,
69
- userId: extractUserId(authSession?.user),
70
- createdAt: Date.now(),
71
- }),
72
- }),
73
- );
74
-
75
- const websocketUrl = buildRealtimeWsUrl(c.req.raw.url, websocketPath);
76
- return c.json(
77
- {
78
- token,
79
- signature,
80
- websocket: {
81
- url: websocketUrl,
82
- protocol,
83
- params: {
84
- tokenParam: "token",
85
- authTokenParam: "authToken",
86
- },
87
- },
88
- },
89
- 200,
90
- );
91
- });
92
-
93
- app.post(unsubscribePath, async (c) => {
94
- const body = await c.req.json().catch(() => ({} as Record<string, unknown>));
95
- const token = typeof body.token === "string" ? body.token : "";
96
- const authToken = typeof body.authToken === "string" ? body.authToken : "";
97
-
98
- if (!token ) {
99
- return c.json({ message: "token is required" }, 400);
100
- }
101
-
102
- const authSession = await validateAuthToken(
103
- c.req.raw,
104
- c.env,
105
- options,
106
- authToken,
107
- );
108
-
109
-
110
- const stub = getRealtimeStub(c.env, options);
111
- if (!stub) {
112
- return c.json({ message: "Realtime binding is not configured" }, 500);
113
- }
114
-
115
- const response = await stub.fetch(
116
- new Request("https://realtime.internal/unsubscribe", {
117
- method: "POST",
118
- headers: {
119
- "content-type": "application/json",
120
- },
121
- body: JSON.stringify({
122
- token,
123
- authToken,
124
- }),
125
- }),
126
- );
127
-
128
- if (!response.ok) {
129
- const payload = (await response.json().catch(() => null)) as {
130
- message?: string;
131
- } | null;
132
- return c.json(
133
- { message: payload?.message ?? "Unable to remove subscription" },
134
- response.status as any,
135
- );
136
- }
137
-
138
- return c.json({ ok: true }, 200);
139
- });
140
-
141
- app.get(websocketPath, async (c) => {
142
- const token = c.req.query("token") ?? "";
143
- const authToken = c.req.query("authToken") ?? "";
144
-
145
- if (!token) {
146
- return c.json({ message: "token and authToken are required" }, 400);
147
- }
148
-
149
- const authSession = await validateAuthToken(
150
- c.req.raw,
151
- c.env,
152
- options,
153
- authToken,
154
- );
155
-
156
- const stub = getRealtimeStub(c.env, options);
157
- if (!stub) {
158
- return c.json({ message: "Realtime binding is not configured" }, 500);
159
- }
160
-
161
- return stub.fetch(c.req.raw);
162
- });
163
- }
164
- `;
1
+ export const realtimeRoutesModule = `
2
+ function registerRealtimeRoutes(
3
+ app: Hono<WorkerEnv>,
4
+ options: RegisterHandlersOptions,
5
+ ): void {
6
+ const subscribePath = options.realtimeSubscribePath ?? "/realtime/subscribe";
7
+ const unsubscribePath = "/realtime/unsubscribe";
8
+ const websocketPath = options.realtimeWebsocketPath ?? "/realtime/ws";
9
+ const protocol = options.realtimeProtocol ?? "appflare.realtime.v1";
10
+
11
+ app.post(subscribePath, async (c) => {
12
+ const body = await c.req.json().catch(() => ({} as Record<string, unknown>));
13
+ const queryName = typeof body.queryName === "string" ? body.queryName : "";
14
+ const authToken = typeof body.authToken === "string" ? body.authToken : "";
15
+ const rawArgs = isRecord(body.args) ? body.args : {};
16
+
17
+ if (!queryName) {
18
+ return c.json({ message: "queryName is required" }, 400);
19
+ }
20
+
21
+ const operation = (realtimeQueryHandlers as Record<
22
+ string,
23
+ {
24
+ definition: unknown;
25
+ schema: z.ZodTypeAny;
26
+ }
27
+ >)[queryName as RealtimeQueryName];
28
+ if (!operation) {
29
+ return c.json({ message: "Unknown queryName" }, 404);
30
+ }
31
+
32
+ const authSession = await validateAuthToken(
33
+ c.req.raw,
34
+ c.env,
35
+ options,
36
+ authToken,
37
+ );
38
+
39
+
40
+ let args: Record<string, unknown>;
41
+ try {
42
+ args = operation.schema.parse(rawArgs) as Record<string, unknown>;
43
+ } catch (error) {
44
+ if (error instanceof ZodError) {
45
+ return c.json({ message: "Invalid query args", issues: error.issues }, 400);
46
+ }
47
+ return c.json({ message: "Invalid query args" }, 400);
48
+ }
49
+
50
+ const token = crypto.randomUUID();
51
+ const signature = createSubscriptionSignature(queryName, args);
52
+ const stub = getRealtimeStub(c.env, options);
53
+ if (!stub) {
54
+ return c.json({ message: "Realtime binding is not configured" }, 500);
55
+ }
56
+
57
+ await stub.fetch(
58
+ new Request("https://realtime.internal/subscribe", {
59
+ method: "POST",
60
+ headers: {
61
+ "content-type": "application/json",
62
+ },
63
+ body: JSON.stringify({
64
+ token,
65
+ signature,
66
+ queryName,
67
+ args,
68
+ authToken,
69
+ userId: extractUserId(authSession?.user),
70
+ createdAt: Date.now(),
71
+ }),
72
+ }),
73
+ );
74
+
75
+ const websocketUrl = buildRealtimeWsUrl(c.req.raw.url, websocketPath);
76
+ return c.json(
77
+ {
78
+ token,
79
+ signature,
80
+ websocket: {
81
+ url: websocketUrl,
82
+ protocol,
83
+ params: {
84
+ tokenParam: "token",
85
+ authTokenParam: "authToken",
86
+ },
87
+ },
88
+ },
89
+ 200,
90
+ );
91
+ });
92
+
93
+ app.post(unsubscribePath, async (c) => {
94
+ const body = await c.req.json().catch(() => ({} as Record<string, unknown>));
95
+ const token = typeof body.token === "string" ? body.token : "";
96
+ const authToken = typeof body.authToken === "string" ? body.authToken : "";
97
+
98
+ if (!token ) {
99
+ return c.json({ message: "token is required" }, 400);
100
+ }
101
+
102
+ const authSession = await validateAuthToken(
103
+ c.req.raw,
104
+ c.env,
105
+ options,
106
+ authToken,
107
+ );
108
+
109
+
110
+ const stub = getRealtimeStub(c.env, options);
111
+ if (!stub) {
112
+ return c.json({ message: "Realtime binding is not configured" }, 500);
113
+ }
114
+
115
+ const response = await stub.fetch(
116
+ new Request("https://realtime.internal/unsubscribe", {
117
+ method: "POST",
118
+ headers: {
119
+ "content-type": "application/json",
120
+ },
121
+ body: JSON.stringify({
122
+ token,
123
+ authToken,
124
+ }),
125
+ }),
126
+ );
127
+
128
+ if (!response.ok) {
129
+ const payload = (await response.json().catch(() => null)) as {
130
+ message?: string;
131
+ } | null;
132
+ return c.json(
133
+ { message: payload?.message ?? "Unable to remove subscription" },
134
+ response.status as any,
135
+ );
136
+ }
137
+
138
+ return c.json({ ok: true }, 200);
139
+ });
140
+
141
+ app.get(websocketPath, async (c) => {
142
+ const token = c.req.query("token") ?? "";
143
+ const authToken = c.req.query("authToken") ?? "";
144
+
145
+ if (!token) {
146
+ return c.json({ message: "token and authToken are required" }, 400);
147
+ }
148
+
149
+ const authSession = await validateAuthToken(
150
+ c.req.raw,
151
+ c.env,
152
+ options,
153
+ authToken,
154
+ );
155
+
156
+ const stub = getRealtimeStub(c.env, options);
157
+ if (!stub) {
158
+ return c.json({ message: "Realtime binding is not configured" }, 500);
159
+ }
160
+
161
+ return stub.fetch(c.req.raw);
162
+ });
163
+ }
164
+ `;
@@ -1,30 +1,30 @@
1
- export const realtimeTypesModule = `
2
- type RealtimeSubscription = {
3
- token: string;
4
- signature: string;
5
- queryName: string;
6
- args: Record<string, unknown>;
7
- authToken: string;
8
- userId: string;
9
- createdAt: number;
10
- };
11
-
12
- type RealtimeEmitPayload = {
13
- token: string;
14
- event: string;
15
- payload: unknown;
16
- };
17
-
18
- type RealtimeStub = {
19
- fetch: (request: Request) => Promise<Response>;
20
- };
21
-
22
- type RealtimeDurableObjectNamespace = {
23
- idFromName: (name: string) => unknown;
24
- get: (id: unknown) => RealtimeStub;
25
- };
26
-
27
- type RealtimeQueryName = keyof typeof realtimeQueryHandlers extends never
28
- ? string
29
- : Extract<keyof typeof realtimeQueryHandlers, string>;
30
- `;
1
+ export const realtimeTypesModule = `
2
+ type RealtimeSubscription = {
3
+ token: string;
4
+ signature: string;
5
+ queryName: string;
6
+ args: Record<string, unknown>;
7
+ authToken: string;
8
+ userId: string;
9
+ createdAt: number;
10
+ };
11
+
12
+ type RealtimeEmitPayload = {
13
+ token: string;
14
+ event: string;
15
+ payload: unknown;
16
+ };
17
+
18
+ type RealtimeStub = {
19
+ fetch: (request: Request) => Promise<Response>;
20
+ };
21
+
22
+ type RealtimeDurableObjectNamespace = {
23
+ idFromName: (name: string) => unknown;
24
+ get: (id: unknown) => RealtimeStub;
25
+ };
26
+
27
+ type RealtimeQueryName = keyof typeof realtimeQueryHandlers extends never
28
+ ? string
29
+ : Extract<keyof typeof realtimeQueryHandlers, string>;
30
+ `;