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,65 +1,65 @@
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
-
47
- if (typeof publishMutationEvents === "function") {
48
- await publishMutationEvents(
49
- { req: { raw: new Request("http://localhost") }, env },
50
- options,
51
- ctx.mutationEvents,
52
- );
53
- }
54
- ctx.mutationEvents.length = 0;
55
- } catch (error) {
56
- if (error instanceof ZodError) {
57
- console.error("Invalid scheduler payload", task, error.issues);
58
- continue;
59
- }
60
-
61
- console.error("Scheduler task failed", task, error);
62
- }
63
- }
64
- }
65
- `;
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
+
47
+ if (typeof publishMutationEvents === "function") {
48
+ await publishMutationEvents(
49
+ { req: { raw: new Request("http://localhost") }, env },
50
+ options,
51
+ ctx.mutationEvents,
52
+ );
53
+ }
54
+ ctx.mutationEvents.length = 0;
55
+ } catch (error) {
56
+ if (error instanceof ZodError) {
57
+ console.error("Invalid scheduler payload", task, error.issues);
58
+ continue;
59
+ }
60
+
61
+ console.error("Scheduler task failed", task, error);
62
+ }
63
+ }
64
+ }
65
+ `;
@@ -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
+ `;