appflare 0.2.24 → 0.2.26

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 (138) 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 -749
  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 +180 -180
  23. package/cli/templates/core/client/types.ts +184 -184
  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 +134 -112
  87. package/cli/templates/handlers/generators/context/storage-helpers.ts +59 -59
  88. package/cli/templates/handlers/generators/context/types.ts +18 -18
  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 +196 -194
  102. package/cli/templates/handlers/generators/registration/sections.ts +210 -210
  103. package/cli/templates/handlers/generators/types/context.ts +68 -66
  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 +259 -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 +1031 -1031
  109. package/cli/templates/handlers/generators/types/query-definitions/schema-and-table-types.ts +246 -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 +121 -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 +676 -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 -83
  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.js +61 -28
  128. package/dist/cli/index.mjs +61 -28
  129. package/index.ts +18 -18
  130. package/package.json +58 -58
  131. package/react/index.ts +5 -5
  132. package/react/use-infinite-query.ts +252 -252
  133. package/react/use-mutation.ts +89 -89
  134. package/react/use-query.ts +207 -207
  135. package/schema.ts +415 -415
  136. package/test-better-auth-hash.ts +2 -2
  137. package/tsconfig.json +6 -6
  138. 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,194 +1,196 @@
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 expiresIn =
41
- typeof body.expiresIn === "number" && body.expiresIn > 0
42
- ? Math.floor(body.expiresIn)
43
- : undefined;
44
-
45
- const url = await ctx.storage.signedUrl({
46
- path,
47
- method: "PUT",
48
- expiresIn,
49
- contentType,
50
- });
51
-
52
- return c.json({
53
- url,
54
- method: "PUT",
55
- path,
56
- expiresIn: expiresIn ?? 300,
57
- }, 200);
58
- } catch (error) {
59
- if (error instanceof AppflareHandledError) {
60
- return c.json(error.payload, error.status as any);
61
- }
62
-
63
- return c.json(
64
- { message: (error as Error).message ?? "Unable to create upload URL" },
65
- 400,
66
- );
67
- }
68
- });
69
-
70
- app.get("/storage/download", async (c) => {
71
- const ctx = await createExecutionContext(c, options);
72
- try {
73
- const path = readStoragePath(c);
74
- const fileName = c.req.query("fileName") ?? undefined;
75
- const expiresIn = parseExpiresIn(c.req.query("expiresIn"));
76
- const url = await ctx.storage.signedUrl({
77
- path,
78
- method: "GET",
79
- expiresIn,
80
- downloadAsAttachment: true,
81
- fileName,
82
- });
83
-
84
- return c.json({
85
- url,
86
- method: "GET",
87
- path,
88
- disposition: "attachment",
89
- }, 200);
90
- } catch (error) {
91
- if (error instanceof AppflareHandledError) {
92
- return c.json(error.payload, error.status as any);
93
- }
94
-
95
- return c.json(
96
- { message: (error as Error).message ?? "Unable to create download URL" },
97
- 400,
98
- );
99
- }
100
- });
101
-
102
- app.get("/storage/preview", async (c) => {
103
- const ctx = await createExecutionContext(c, options);
104
- try {
105
- const path = readStoragePath(c);
106
- const expiresIn = parseExpiresIn(c.req.query("expiresIn"));
107
- const url = await ctx.storage.signedUrl({
108
- path,
109
- method: "GET",
110
- expiresIn,
111
- downloadAsAttachment: false,
112
- });
113
-
114
- return c.json({
115
- url,
116
- method: "GET",
117
- path,
118
- disposition: "inline",
119
- }, 200);
120
- } catch (error) {
121
- if (error instanceof AppflareHandledError) {
122
- return c.json(error.payload, error.status as any);
123
- }
124
-
125
- return c.json(
126
- { message: (error as Error).message ?? "Unable to create preview URL" },
127
- 400,
128
- );
129
- }
130
- });
131
-
132
- app.delete("/storage/object", async (c) => {
133
- const ctx = await createExecutionContext(c, options);
134
- try {
135
- const path = readStoragePath(c);
136
- await ctx.storage.delete({ path });
137
- return c.json({ ok: true, path }, 200);
138
- } catch (error) {
139
- if (error instanceof AppflareHandledError) {
140
- return c.json(error.payload, error.status as any);
141
- }
142
-
143
- return c.json(
144
- { message: (error as Error).message ?? "Unable to delete object" },
145
- 400,
146
- );
147
- }
148
- });
149
-
150
- app.get("/storage/list", async (c) => {
151
- const ctx = await createExecutionContext(c, options);
152
- try {
153
- const prefix = c.req.query("prefix") ?? undefined;
154
- const cursor = c.req.query("cursor") ?? undefined;
155
- const delimiter = c.req.query("delimiter") ?? undefined;
156
- const limitValue = c.req.query("limit");
157
- const parsedLimit = limitValue ? Number(limitValue) : undefined;
158
- const limit =
159
- typeof parsedLimit === "number" && Number.isFinite(parsedLimit) && parsedLimit > 0
160
- ? Math.floor(parsedLimit)
161
- : undefined;
162
- const methodValue = c.req.query("method");
163
- const method: StorageMethod | undefined =
164
- methodValue === "download" ||
165
- methodValue === "get" ||
166
- methodValue === "delete" ||
167
- methodValue === "list" ||
168
- methodValue === "put" ||
169
- methodValue === "preview"
170
- ? methodValue
171
- : undefined;
172
-
173
- const result = await ctx.storage.list({
174
- prefix,
175
- cursor,
176
- delimiter,
177
- limit,
178
- method,
179
- });
180
-
181
- return c.json(result, 200);
182
- } catch (error) {
183
- if (error instanceof AppflareHandledError) {
184
- return c.json(error.payload, error.status as any);
185
- }
186
-
187
- return c.json(
188
- { message: (error as Error).message ?? "Unable to list storage objects" },
189
- 400,
190
- );
191
- }
192
- });
193
- }
194
- `;
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 expiresIn =
41
+ typeof body.expiresIn === "number" && body.expiresIn > 0
42
+ ? Math.floor(body.expiresIn)
43
+ : undefined;
44
+
45
+ const url = await ctx.storage.put({
46
+ path,
47
+ body: "",
48
+ contentType,
49
+ expiresIn,
50
+ returnSignedUrlOnly: true,
51
+ });
52
+
53
+ return c.json({
54
+ url,
55
+ method: "PUT",
56
+ path,
57
+ contentType,
58
+ expiresIn: expiresIn ?? 300,
59
+ }, 200);
60
+ } catch (error) {
61
+ if (error instanceof AppflareHandledError) {
62
+ return c.json(error.payload, error.status as any);
63
+ }
64
+
65
+ return c.json(
66
+ { message: (error as Error).message ?? "Unable to create upload URL" },
67
+ 400,
68
+ );
69
+ }
70
+ });
71
+
72
+ app.get("/storage/download", async (c) => {
73
+ const ctx = await createExecutionContext(c, options);
74
+ try {
75
+ const path = readStoragePath(c);
76
+ const fileName = c.req.query("fileName") ?? undefined;
77
+ const expiresIn = parseExpiresIn(c.req.query("expiresIn"));
78
+ const url = await ctx.storage.signedUrl({
79
+ path,
80
+ method: "GET",
81
+ expiresIn,
82
+ downloadAsAttachment: true,
83
+ fileName,
84
+ });
85
+
86
+ return c.json({
87
+ url,
88
+ method: "GET",
89
+ path,
90
+ disposition: "attachment",
91
+ }, 200);
92
+ } catch (error) {
93
+ if (error instanceof AppflareHandledError) {
94
+ return c.json(error.payload, error.status as any);
95
+ }
96
+
97
+ return c.json(
98
+ { message: (error as Error).message ?? "Unable to create download URL" },
99
+ 400,
100
+ );
101
+ }
102
+ });
103
+
104
+ app.get("/storage/preview", async (c) => {
105
+ const ctx = await createExecutionContext(c, options);
106
+ try {
107
+ const path = readStoragePath(c);
108
+ const expiresIn = parseExpiresIn(c.req.query("expiresIn"));
109
+ const url = await ctx.storage.signedUrl({
110
+ path,
111
+ method: "GET",
112
+ expiresIn,
113
+ downloadAsAttachment: false,
114
+ });
115
+
116
+ return c.json({
117
+ url,
118
+ method: "GET",
119
+ path,
120
+ disposition: "inline",
121
+ }, 200);
122
+ } catch (error) {
123
+ if (error instanceof AppflareHandledError) {
124
+ return c.json(error.payload, error.status as any);
125
+ }
126
+
127
+ return c.json(
128
+ { message: (error as Error).message ?? "Unable to create preview URL" },
129
+ 400,
130
+ );
131
+ }
132
+ });
133
+
134
+ app.delete("/storage/object", async (c) => {
135
+ const ctx = await createExecutionContext(c, options);
136
+ try {
137
+ const path = readStoragePath(c);
138
+ await ctx.storage.delete({ path });
139
+ return c.json({ ok: true, path }, 200);
140
+ } catch (error) {
141
+ if (error instanceof AppflareHandledError) {
142
+ return c.json(error.payload, error.status as any);
143
+ }
144
+
145
+ return c.json(
146
+ { message: (error as Error).message ?? "Unable to delete object" },
147
+ 400,
148
+ );
149
+ }
150
+ });
151
+
152
+ app.get("/storage/list", async (c) => {
153
+ const ctx = await createExecutionContext(c, options);
154
+ try {
155
+ const prefix = c.req.query("prefix") ?? undefined;
156
+ const cursor = c.req.query("cursor") ?? undefined;
157
+ const delimiter = c.req.query("delimiter") ?? undefined;
158
+ const limitValue = c.req.query("limit");
159
+ const parsedLimit = limitValue ? Number(limitValue) : undefined;
160
+ const limit =
161
+ typeof parsedLimit === "number" && Number.isFinite(parsedLimit) && parsedLimit > 0
162
+ ? Math.floor(parsedLimit)
163
+ : undefined;
164
+ const methodValue = c.req.query("method");
165
+ const method: StorageMethod | undefined =
166
+ methodValue === "download" ||
167
+ methodValue === "get" ||
168
+ methodValue === "delete" ||
169
+ methodValue === "list" ||
170
+ methodValue === "put" ||
171
+ methodValue === "preview"
172
+ ? methodValue
173
+ : undefined;
174
+
175
+ const result = await ctx.storage.list({
176
+ prefix,
177
+ cursor,
178
+ delimiter,
179
+ limit,
180
+ method,
181
+ });
182
+
183
+ return c.json(result, 200);
184
+ } catch (error) {
185
+ if (error instanceof AppflareHandledError) {
186
+ return c.json(error.payload, error.status as any);
187
+ }
188
+
189
+ return c.json(
190
+ { message: (error as Error).message ?? "Unable to list storage objects" },
191
+ 400,
192
+ );
193
+ }
194
+ });
195
+ }
196
+ `;