appflare 0.2.30 → 0.2.32

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 +243 -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 -697
  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 +366 -203
  130. package/dist/cli/index.mjs +366 -203
  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,56 +1,56 @@
1
- export const schedulerModule = `
2
- type SchedulerTaskName = keyof typeof schedulerHandlers extends never
3
- ? string
4
- : keyof typeof schedulerHandlers;
5
-
6
- type QueueMessageBody = {
7
- task?: string;
8
- payload?: unknown;
9
- };
10
-
11
- export async function executeScheduledBatch(
12
- batch: { messages?: Array<{ body?: unknown }> },
13
- env: Record<string, unknown>,
14
- options: RegisterHandlersOptions,
15
- ): Promise<void> {
16
- if (!batch?.messages || batch.messages.length === 0) {
17
- return;
18
- }
19
-
20
- const ctx = await createSchedulerExecutionContext(env, options);
21
-
22
- for (const message of batch.messages) {
23
- const body = (message?.body ?? {}) as QueueMessageBody;
24
- const task = body.task;
25
- if (!task) {
26
- console.warn("Scheduler message missing task field");
27
- continue;
28
- }
29
-
30
- const operation = (schedulerHandlers as Record<string, {
31
- definition: {
32
- handler: (ctx: AppflareContext, args: unknown) => Promise<void> | void;
33
- };
34
- schema: z.ZodTypeAny;
35
- }>)[task];
36
-
37
- if (!operation) {
38
- console.warn("Unknown scheduler task", task);
39
- continue;
40
- }
41
-
42
- try {
43
- const payloadValue = body.payload === null ? undefined : body.payload;
44
- const parsed = operation.schema.parse(payloadValue);
45
- await operation.definition.handler(ctx, parsed);
46
- } catch (error) {
47
- if (error instanceof ZodError) {
48
- console.error("Invalid scheduler payload", task, error.issues);
49
- continue;
50
- }
51
-
52
- console.error("Scheduler task failed", task, error);
53
- }
54
- }
55
- }
56
- `;
1
+ export const schedulerModule = `
2
+ type SchedulerTaskName = keyof typeof schedulerHandlers extends never
3
+ ? string
4
+ : keyof typeof schedulerHandlers;
5
+
6
+ type QueueMessageBody = {
7
+ task?: string;
8
+ payload?: unknown;
9
+ };
10
+
11
+ export async function executeScheduledBatch(
12
+ batch: { messages?: Array<{ body?: unknown }> },
13
+ env: Record<string, unknown>,
14
+ options: RegisterHandlersOptions,
15
+ ): Promise<void> {
16
+ if (!batch?.messages || batch.messages.length === 0) {
17
+ return;
18
+ }
19
+
20
+ const ctx = await createSchedulerExecutionContext(env, options);
21
+
22
+ for (const message of batch.messages) {
23
+ const body = (message?.body ?? {}) as QueueMessageBody;
24
+ const task = body.task;
25
+ if (!task) {
26
+ console.warn("Scheduler message missing task field");
27
+ continue;
28
+ }
29
+
30
+ const operation = (schedulerHandlers as Record<string, {
31
+ definition: {
32
+ handler: (ctx: AppflareContext, args: unknown) => Promise<void> | void;
33
+ };
34
+ schema: z.ZodTypeAny;
35
+ }>)[task];
36
+
37
+ if (!operation) {
38
+ console.warn("Unknown scheduler task", task);
39
+ continue;
40
+ }
41
+
42
+ try {
43
+ const payloadValue = body.payload === null ? undefined : body.payload;
44
+ const parsed = operation.schema.parse(payloadValue);
45
+ await operation.definition.handler(ctx, parsed);
46
+ } catch (error) {
47
+ if (error instanceof ZodError) {
48
+ console.error("Invalid scheduler payload", task, error.issues);
49
+ continue;
50
+ }
51
+
52
+ console.error("Scheduler task failed", task, error);
53
+ }
54
+ }
55
+ }
56
+ `;
@@ -1,199 +1,199 @@
1
- export const storageModule = `
2
- function parseExpiresIn(value: string | undefined): number | undefined {
3
- if (!value) {
4
- return undefined;
5
- }
6
-
7
- const parsed = Number(value);
8
- if (!Number.isFinite(parsed) || parsed <= 0) {
9
- return undefined;
10
- }
11
-
12
- return Math.floor(parsed);
13
- }
14
-
15
- function toStoragePath(path: string): string {
16
- const trimmed = path.trim();
17
- if (!trimmed) {
18
- throw new Error("Storage path is required");
19
- }
20
-
21
- return trimmed.startsWith("/") ? trimmed : "/" + trimmed;
22
- }
23
-
24
- function readStoragePath(c: { req: { query: (name: string) => string | undefined } }): string {
25
- const path = c.req.query("path") ?? "";
26
- return toStoragePath(path);
27
- }
28
-
29
- export function registerGeneratedStorageRoutes(
30
- app: Hono<WorkerEnv>,
31
- options: RegisterHandlersOptions,
32
- ): void {
33
- app.post("/storage/upload", async (c) => {
34
- const ctx = await createExecutionContext(c, options);
35
- try {
36
- const body = await c.req.json().catch(() => ({} as Record<string, unknown>));
37
- const path = toStoragePath(String(body.path ?? ""));
38
- const contentType =
39
- typeof body.contentType === "string" ? body.contentType : undefined;
40
- const encodedBody = typeof body.body === "string" ? body.body : undefined;
41
- const base64Body = typeof body.base64Body === "string" ? body.base64Body : undefined;
42
-
43
- if (!base64Body && !encodedBody) {
44
- return c.json(
45
- { message: "File content is required. Provide either 'body' or 'base64Body' field." },
46
- 400,
47
- );
48
- }
49
-
50
- const uploadBody = base64Body
51
- ? Uint8Array.from(atob(base64Body), (char) => char.charCodeAt(0))
52
- : encodedBody
53
- ? Uint8Array.from(atob(encodedBody), (char) => char.charCodeAt(0))
54
- : new Uint8Array();
55
-
56
- await ctx.storage.put({
57
- path,
58
- body: uploadBody,
59
- contentType,
60
- });
61
-
62
- return c.json({
63
- url: null,
64
- method: "PUT",
65
- path,
66
- contentType,
67
- uploaded: true,
68
- }, 200);
69
- } catch (error) {
70
- if (error instanceof AppflareHandledError) {
71
- return c.json(error.payload, error.status as any);
72
- }
73
-
74
- return c.json(
75
- { message: (error as Error).message ?? "Unable to create upload URL" },
76
- 400,
77
- );
78
- }
79
- });
80
-
81
- app.get("/storage/download", async (c) => {
82
- const ctx = await createExecutionContext(c, options);
83
- try {
84
- const path = readStoragePath(c);
85
- const fileName = c.req.query("fileName") ?? undefined;
86
-
87
- const file = await ctx.storage.get({ path });
88
- if (!file) {
89
- return c.json({ message: "File not found" }, 404);
90
- }
91
-
92
- const headers: Record<string, string> = {};
93
- if (file.contentType) {
94
- headers["content-type"] = file.contentType;
95
- }
96
- if (fileName) {
97
- headers["content-disposition"] = \`attachment; filename="\${fileName}"\`;
98
- }
99
-
100
- return c.body(file.body, 200, headers);
101
- } catch (error) {
102
- if (error instanceof AppflareHandledError) {
103
- return c.json(error.payload, error.status as any);
104
- }
105
-
106
- return c.json(
107
- { message: (error as Error).message ?? "Unable to download file" },
108
- 400,
109
- );
110
- }
111
- });
112
-
113
- app.get("/storage/preview", async (c) => {
114
- const ctx = await createExecutionContext(c, options);
115
- try {
116
- const path = readStoragePath(c);
117
- const expiresIn = parseExpiresIn(c.req.query("expiresIn"));
118
-
119
- // For now, we'll return an error since signed URLs are not available
120
- // In the future, we could implement direct file serving here
121
- return c.json(
122
- { message: "Preview via signed URL is not available in this runtime. Use direct file access instead." },
123
- 501,
124
- );
125
- } catch (error) {
126
- if (error instanceof AppflareHandledError) {
127
- return c.json(error.payload, error.status as any);
128
- }
129
-
130
- return c.json(
131
- { message: (error as Error).message ?? "Unable to create preview URL" },
132
- 400,
133
- );
134
- }
135
- });
136
-
137
- app.delete("/storage/object", async (c) => {
138
- const ctx = await createExecutionContext(c, options);
139
- try {
140
- const path = readStoragePath(c);
141
- await ctx.storage.delete({ path });
142
- return c.json({ ok: true, path }, 200);
143
- } catch (error) {
144
- if (error instanceof AppflareHandledError) {
145
- return c.json(error.payload, error.status as any);
146
- }
147
-
148
- return c.json(
149
- { message: (error as Error).message ?? "Unable to delete object" },
150
- 400,
151
- );
152
- }
153
- });
154
-
155
- app.get("/storage/list", async (c) => {
156
- const ctx = await createExecutionContext(c, options);
157
- try {
158
- const prefix = c.req.query("prefix") ?? undefined;
159
- const cursor = c.req.query("cursor") ?? undefined;
160
- const delimiter = c.req.query("delimiter") ?? undefined;
161
- const limitValue = c.req.query("limit");
162
- const parsedLimit = limitValue ? Number(limitValue) : undefined;
163
- const limit =
164
- typeof parsedLimit === "number" && Number.isFinite(parsedLimit) && parsedLimit > 0
165
- ? Math.floor(parsedLimit)
166
- : undefined;
167
- const methodValue = c.req.query("method");
168
- const method: StorageMethod | undefined =
169
- methodValue === "download" ||
170
- methodValue === "get" ||
171
- methodValue === "delete" ||
172
- methodValue === "list" ||
173
- methodValue === "put" ||
174
- methodValue === "preview"
175
- ? methodValue
176
- : undefined;
177
-
178
- const result = await ctx.storage.list({
179
- prefix,
180
- cursor,
181
- delimiter,
182
- limit,
183
- method,
184
- });
185
-
186
- return c.json(result, 200);
187
- } catch (error) {
188
- if (error instanceof AppflareHandledError) {
189
- return c.json(error.payload, error.status as any);
190
- }
191
-
192
- return c.json(
193
- { message: (error as Error).message ?? "Unable to list storage objects" },
194
- 400,
195
- );
196
- }
197
- });
198
- }
199
- `;
1
+ export const storageModule = `
2
+ function parseExpiresIn(value: string | undefined): number | undefined {
3
+ if (!value) {
4
+ return undefined;
5
+ }
6
+
7
+ const parsed = Number(value);
8
+ if (!Number.isFinite(parsed) || parsed <= 0) {
9
+ return undefined;
10
+ }
11
+
12
+ return Math.floor(parsed);
13
+ }
14
+
15
+ function toStoragePath(path: string): string {
16
+ const trimmed = path.trim();
17
+ if (!trimmed) {
18
+ throw new Error("Storage path is required");
19
+ }
20
+
21
+ return trimmed.startsWith("/") ? trimmed : "/" + trimmed;
22
+ }
23
+
24
+ function readStoragePath(c: { req: { query: (name: string) => string | undefined } }): string {
25
+ const path = c.req.query("path") ?? "";
26
+ return toStoragePath(path);
27
+ }
28
+
29
+ export function registerGeneratedStorageRoutes(
30
+ app: Hono<WorkerEnv>,
31
+ options: RegisterHandlersOptions,
32
+ ): void {
33
+ app.post("/storage/upload", async (c) => {
34
+ const ctx = await createExecutionContext(c, options);
35
+ try {
36
+ const body = await c.req.json().catch(() => ({} as Record<string, unknown>));
37
+ const path = toStoragePath(String(body.path ?? ""));
38
+ const contentType =
39
+ typeof body.contentType === "string" ? body.contentType : undefined;
40
+ const encodedBody = typeof body.body === "string" ? body.body : undefined;
41
+ const base64Body = typeof body.base64Body === "string" ? body.base64Body : undefined;
42
+
43
+ if (!base64Body && !encodedBody) {
44
+ return c.json(
45
+ { message: "File content is required. Provide either 'body' or 'base64Body' field." },
46
+ 400,
47
+ );
48
+ }
49
+
50
+ const uploadBody = base64Body
51
+ ? Uint8Array.from(atob(base64Body), (char) => char.charCodeAt(0))
52
+ : encodedBody
53
+ ? Uint8Array.from(atob(encodedBody), (char) => char.charCodeAt(0))
54
+ : new Uint8Array();
55
+
56
+ await ctx.storage.put({
57
+ path,
58
+ body: uploadBody,
59
+ contentType,
60
+ });
61
+
62
+ return c.json({
63
+ url: null,
64
+ method: "PUT",
65
+ path,
66
+ contentType,
67
+ uploaded: true,
68
+ }, 200);
69
+ } catch (error) {
70
+ if (error instanceof AppflareHandledError) {
71
+ return c.json(error.payload, error.status as any);
72
+ }
73
+
74
+ return c.json(
75
+ { message: (error as Error).message ?? "Unable to create upload URL" },
76
+ 400,
77
+ );
78
+ }
79
+ });
80
+
81
+ app.get("/storage/download", async (c) => {
82
+ const ctx = await createExecutionContext(c, options);
83
+ try {
84
+ const path = readStoragePath(c);
85
+ const fileName = c.req.query("fileName") ?? undefined;
86
+
87
+ const file = await ctx.storage.get({ path });
88
+ if (!file) {
89
+ return c.json({ message: "File not found" }, 404);
90
+ }
91
+
92
+ const headers: Record<string, string> = {};
93
+ if (file.contentType) {
94
+ headers["content-type"] = file.contentType;
95
+ }
96
+ if (fileName) {
97
+ headers["content-disposition"] = \`attachment; filename="\${fileName}"\`;
98
+ }
99
+
100
+ return c.body(file.body, 200, headers);
101
+ } catch (error) {
102
+ if (error instanceof AppflareHandledError) {
103
+ return c.json(error.payload, error.status as any);
104
+ }
105
+
106
+ return c.json(
107
+ { message: (error as Error).message ?? "Unable to download file" },
108
+ 400,
109
+ );
110
+ }
111
+ });
112
+
113
+ app.get("/storage/preview", async (c) => {
114
+ const ctx = await createExecutionContext(c, options);
115
+ try {
116
+ const path = readStoragePath(c);
117
+ const expiresIn = parseExpiresIn(c.req.query("expiresIn"));
118
+
119
+ // For now, we'll return an error since signed URLs are not available
120
+ // In the future, we could implement direct file serving here
121
+ return c.json(
122
+ { message: "Preview via signed URL is not available in this runtime. Use direct file access instead." },
123
+ 501,
124
+ );
125
+ } catch (error) {
126
+ if (error instanceof AppflareHandledError) {
127
+ return c.json(error.payload, error.status as any);
128
+ }
129
+
130
+ return c.json(
131
+ { message: (error as Error).message ?? "Unable to create preview URL" },
132
+ 400,
133
+ );
134
+ }
135
+ });
136
+
137
+ app.delete("/storage/object", async (c) => {
138
+ const ctx = await createExecutionContext(c, options);
139
+ try {
140
+ const path = readStoragePath(c);
141
+ await ctx.storage.delete({ path });
142
+ return c.json({ ok: true, path }, 200);
143
+ } catch (error) {
144
+ if (error instanceof AppflareHandledError) {
145
+ return c.json(error.payload, error.status as any);
146
+ }
147
+
148
+ return c.json(
149
+ { message: (error as Error).message ?? "Unable to delete object" },
150
+ 400,
151
+ );
152
+ }
153
+ });
154
+
155
+ app.get("/storage/list", async (c) => {
156
+ const ctx = await createExecutionContext(c, options);
157
+ try {
158
+ const prefix = c.req.query("prefix") ?? undefined;
159
+ const cursor = c.req.query("cursor") ?? undefined;
160
+ const delimiter = c.req.query("delimiter") ?? undefined;
161
+ const limitValue = c.req.query("limit");
162
+ const parsedLimit = limitValue ? Number(limitValue) : undefined;
163
+ const limit =
164
+ typeof parsedLimit === "number" && Number.isFinite(parsedLimit) && parsedLimit > 0
165
+ ? Math.floor(parsedLimit)
166
+ : undefined;
167
+ const methodValue = c.req.query("method");
168
+ const method: StorageMethod | undefined =
169
+ methodValue === "download" ||
170
+ methodValue === "get" ||
171
+ methodValue === "delete" ||
172
+ methodValue === "list" ||
173
+ methodValue === "put" ||
174
+ methodValue === "preview"
175
+ ? methodValue
176
+ : undefined;
177
+
178
+ const result = await ctx.storage.list({
179
+ prefix,
180
+ cursor,
181
+ delimiter,
182
+ limit,
183
+ method,
184
+ });
185
+
186
+ return c.json(result, 200);
187
+ } catch (error) {
188
+ if (error instanceof AppflareHandledError) {
189
+ return c.json(error.payload, error.status as any);
190
+ }
191
+
192
+ return c.json(
193
+ { message: (error as Error).message ?? "Unable to list storage objects" },
194
+ 400,
195
+ );
196
+ }
197
+ });
198
+ }
199
+ `;