appflare 0.2.48 → 0.2.49

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 (139) hide show
  1. package/Documentation.md +898 -898
  2. package/cli/commands/index.ts +247 -247
  3. package/cli/generate.ts +360 -360
  4. package/cli/index.ts +120 -120
  5. package/cli/load-config.ts +184 -184
  6. package/cli/schema-compiler.ts +1366 -1366
  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 +763 -763
  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 +187 -187
  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 +271 -271
  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 +703 -703
  45. package/cli/templates/dashboard/builders/functions/tree-builder.ts +47 -47
  46. package/cli/templates/dashboard/builders/navigation.ts +155 -155
  47. package/cli/templates/dashboard/builders/storage/index.ts +13 -13
  48. package/cli/templates/dashboard/builders/storage/routes/create-directory-route.ts +29 -29
  49. package/cli/templates/dashboard/builders/storage/routes/delete-route.ts +18 -18
  50. package/cli/templates/dashboard/builders/storage/routes/download-route.ts +23 -23
  51. package/cli/templates/dashboard/builders/storage/routes/index.ts +22 -22
  52. package/cli/templates/dashboard/builders/storage/routes/list-route.ts +25 -25
  53. package/cli/templates/dashboard/builders/storage/routes/preview-route.ts +21 -21
  54. package/cli/templates/dashboard/builders/storage/routes/upload-route.ts +21 -21
  55. package/cli/templates/dashboard/builders/storage/runtime/helpers.ts +72 -72
  56. package/cli/templates/dashboard/builders/storage/runtime/storage-page.ts +130 -130
  57. package/cli/templates/dashboard/builders/table-routes/common/drawer-panel.ts +27 -27
  58. package/cli/templates/dashboard/builders/table-routes/common/pagination.ts +30 -30
  59. package/cli/templates/dashboard/builders/table-routes/common/search-bar.ts +23 -23
  60. package/cli/templates/dashboard/builders/table-routes/fragments.ts +257 -217
  61. package/cli/templates/dashboard/builders/table-routes/helpers.ts +45 -45
  62. package/cli/templates/dashboard/builders/table-routes/index.ts +8 -8
  63. package/cli/templates/dashboard/builders/table-routes/table/actions-cell.ts +71 -71
  64. package/cli/templates/dashboard/builders/table-routes/table/get-route.ts +291 -291
  65. package/cli/templates/dashboard/builders/table-routes/table/index.ts +80 -80
  66. package/cli/templates/dashboard/builders/table-routes/table/post-routes.ts +163 -163
  67. package/cli/templates/dashboard/builders/table-routes/table-route.ts +7 -7
  68. package/cli/templates/dashboard/builders/table-routes/users/get-route.ts +69 -69
  69. package/cli/templates/dashboard/builders/table-routes/users/html/modals.ts +57 -57
  70. package/cli/templates/dashboard/builders/table-routes/users/html/page.ts +27 -27
  71. package/cli/templates/dashboard/builders/table-routes/users/html/table.ts +128 -128
  72. package/cli/templates/dashboard/builders/table-routes/users/index.ts +32 -32
  73. package/cli/templates/dashboard/builders/table-routes/users/post-routes.ts +150 -150
  74. package/cli/templates/dashboard/builders/table-routes/users/redirect.ts +14 -14
  75. package/cli/templates/dashboard/builders/table-routes/users-route.ts +10 -10
  76. package/cli/templates/dashboard/components/dashboard-home.ts +23 -23
  77. package/cli/templates/dashboard/components/layout.ts +420 -420
  78. package/cli/templates/dashboard/components/login-page.ts +65 -65
  79. package/cli/templates/dashboard/index.ts +61 -61
  80. package/cli/templates/dashboard/types.ts +9 -9
  81. package/cli/templates/handlers/README.md +353 -353
  82. package/cli/templates/handlers/auth.ts +37 -37
  83. package/cli/templates/handlers/execution.ts +44 -42
  84. package/cli/templates/handlers/generators/context/context-creation.ts +101 -101
  85. package/cli/templates/handlers/generators/context/error-helpers.ts +11 -11
  86. package/cli/templates/handlers/generators/context/scheduler.ts +24 -24
  87. package/cli/templates/handlers/generators/context/storage-api.ts +82 -82
  88. package/cli/templates/handlers/generators/context/storage-helpers.ts +59 -59
  89. package/cli/templates/handlers/generators/context/types.ts +40 -40
  90. package/cli/templates/handlers/generators/context.ts +43 -43
  91. package/cli/templates/handlers/generators/execution.ts +15 -15
  92. package/cli/templates/handlers/generators/handlers.ts +14 -14
  93. package/cli/templates/handlers/generators/registration/modules/cron.ts +35 -35
  94. package/cli/templates/handlers/generators/registration/modules/realtime/auth.ts +75 -75
  95. package/cli/templates/handlers/generators/registration/modules/realtime/durable-object.ts +144 -144
  96. package/cli/templates/handlers/generators/registration/modules/realtime/index.ts +14 -14
  97. package/cli/templates/handlers/generators/registration/modules/realtime/publisher.ts +102 -102
  98. package/cli/templates/handlers/generators/registration/modules/realtime/routes.ts +164 -164
  99. package/cli/templates/handlers/generators/registration/modules/realtime/types.ts +30 -30
  100. package/cli/templates/handlers/generators/registration/modules/realtime/utils.ts +510 -510
  101. package/cli/templates/handlers/generators/registration/modules/scheduler.ts +65 -65
  102. package/cli/templates/handlers/generators/registration/modules/storage.ts +199 -199
  103. package/cli/templates/handlers/generators/registration/sections.ts +210 -210
  104. package/cli/templates/handlers/generators/types/context.ts +121 -121
  105. package/cli/templates/handlers/generators/types/core.ts +108 -108
  106. package/cli/templates/handlers/generators/types/operations.ts +135 -135
  107. package/cli/templates/handlers/generators/types/query-definitions/filter-and-where-types.ts +291 -291
  108. package/cli/templates/handlers/generators/types/query-definitions/query-api-types.ts +135 -135
  109. package/cli/templates/handlers/generators/types/query-definitions/query-helper-functions.ts +1382 -1382
  110. package/cli/templates/handlers/generators/types/query-definitions/schema-and-table-types.ts +278 -278
  111. package/cli/templates/handlers/generators/types/query-definitions.ts +13 -13
  112. package/cli/templates/handlers/generators/types/query-runtime/handled-error.ts +13 -13
  113. package/cli/templates/handlers/generators/types/query-runtime/runtime-aggregate-and-footer.ts +174 -174
  114. package/cli/templates/handlers/generators/types/query-runtime/runtime-read.ts +156 -156
  115. package/cli/templates/handlers/generators/types/query-runtime/runtime-setup.ts +45 -45
  116. package/cli/templates/handlers/generators/types/query-runtime/runtime-write.ts +958 -958
  117. package/cli/templates/handlers/generators/types/query-runtime.ts +15 -15
  118. package/cli/templates/handlers/index.ts +47 -47
  119. package/cli/templates/handlers/operations.ts +116 -116
  120. package/cli/templates/handlers/registration.ts +91 -91
  121. package/cli/templates/handlers/types.ts +17 -17
  122. package/cli/templates/handlers/utils.ts +48 -48
  123. package/cli/types.ts +110 -110
  124. package/cli/utils/handler-discovery.ts +501 -501
  125. package/cli/utils/json-utils.ts +24 -24
  126. package/cli/utils/path-utils.ts +19 -19
  127. package/cli/utils/schema-discovery.ts +402 -399
  128. package/dist/cli/index.js +77 -55
  129. package/dist/cli/index.mjs +77 -55
  130. package/index.ts +18 -18
  131. package/package.json +58 -58
  132. package/react/index.ts +5 -5
  133. package/react/use-infinite-query.ts +255 -255
  134. package/react/use-mutation.ts +89 -89
  135. package/react/use-query.ts +210 -210
  136. package/schema.ts +641 -641
  137. package/test-better-auth-hash.ts +2 -2
  138. package/tsconfig.json +6 -6
  139. 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
+ `;