Upgrade Vercel SDK v4 -> v5 + zod@v4 + 💀 zsa server actions abstraction

Author: andresgutgon

.gitignore

@@ -59,8 +59,9 @@ apps/web/scripts-dist
 
 # File uploads in development
 apps/web/uploads
+apps/web/storage
 apps/web/public/uploads
-apps/web/public/storage
+apps/web/public/files
 uploads
 storage
 

AGENTS.md

@@ -60,23 +60,41 @@
 
 ### Action Layer (`apps/web/src/actions/`)
 
-- Server actions use `authProcedure.createServerAction()` pattern
+- Server actions use `authProcedure` pattern
 - Input validation with Zod schemas
 - Actions fetch model instances using repositories before calling services
 - **Admin-only actions**: Place under `actions/admin/` directory for backoffice functionality
 - Example pattern:
 
   ```typescript
   export const updateApiKeyAction = authProcedure
-    .createServerAction()
-    .input(z.object({ id: z.number(), name: z.string() }))
-    .handler(async ({ input, ctx }) => {
+    .inputSchema(z.object({ id: z.number(), name: z.string() }))
+    .action(async ({ parsedInput, ctx }) => {
       const repo = new Repository(ctx.workspace.id)
-      const model = await repo.find(input.id).then((r) => r.unwrap())
-      return updateService(model, { name: input.name }).then((r) => r.unwrap())
+      const model = await repo.find(parsedInput.id).then((r) => r.unwrap())
+      return updateService(model, { name: parsedInput.name }).then((r) =>
+        r.unwrap(),
+      )
     })
   ```
 
+- For writing an action with a different scope. Let's say withing projects:
+
+  ```typescript
+  import { withProject, withProjectSchema } from '../../procedures'
+  export const updateProjectAction = withProject
+    .inputSchema(withProjectSchema.extend({ id: z.number(), name: z.string() }))
+    .action(async ({ parsedInput, ctx }) => {
+      const repo = new ProjectRepository(ctx.workspace.id)
+      const model = await repo.find(parsedInput.id).then((r) => r.unwrap())
+      return updateProjectService(model, { name: parsedInput.name }).then((r) =>
+        r.unwrap(),
+      )
+    })
+  ```
+
+  `withProject` procedure inherits from `authProcedure` and adds project validation.
+
 ### Store Layer (`apps/web/src/stores/`)
 
 - Use SWR for data fetching with custom hooks

apps/gateway/package.json

@@ -16,7 +16,7 @@
   "dependencies": {
     "@hono/node-server": "1.13.2",
     "@hono/swagger-ui": "0.4.1",
-    "@hono/zod-openapi": "0.16.4",
+    "@hono/zod-openapi": "1.1.1",
     "@latitude-data/constants": "workspace:^",
     "@latitude-data/core": "workspace:^",
     "@latitude-data/env": "workspace:^",

apps/gateway/src/openApi/schemas/ai.ts

@@ -15,11 +15,11 @@ export const languageModelUsageSchema = z.object({
 export const toolCallSchema = z.object({
   id: z.string(),
   name: z.string(),
-  arguments: z.record(z.any()),
+  arguments: z.record(z.string(), z.any()),
 })
 
-export const configSchema = z.object({}).passthrough()
-export const providerLogSchema = z.object({}).passthrough()
+export const configSchema = z.record(z.string(), z.any())
+export const providerLogSchema = z.record(z.string(), z.any())
 export const chainStepResponseSchema = z.discriminatedUnion('streamType', [
   z.object({
     streamType: z.literal('text'),
@@ -58,7 +58,7 @@ export const chainEventDtoResponseSchema = z.discriminatedUnion('streamType', [
 export const legacyChainEventDtoSchema = z.discriminatedUnion('event', [
   z.object({
     event: z.literal(StreamEventTypes.Provider),
-    data: z.object({}).passthrough(),
+    data: z.record(z.string(), z.any()),
   }),
   z.object({
     event: z.literal(StreamEventTypes.Latitude),
@@ -79,7 +79,7 @@ export const legacyChainEventDtoSchema = z.discriminatedUnion('event', [
         type: z.literal(LegacyChainEventTypes.Complete),
         config: configSchema,
         messages: z.array(messageSchema).optional(),
-        object: z.object({}).passthrough().optional(),
+        object: z.record(z.string(), z.any()).optional(),
         response: chainEventDtoResponseSchema,
         uuid: z.string().optional(),
       }),
@@ -110,8 +110,8 @@ export const ProjectSchema = z.object({
   id: z.number(),
   name: z.string(),
   workspaceId: z.number(),
-  createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime(),
-  lastEditedAt: z.string().datetime().optional(),
-  deletedAt: z.string().datetime().nullable().optional(),
+  createdAt: z.iso.datetime(),
+  updatedAt: z.iso.datetime(),
+  lastEditedAt: z.iso.datetime().optional(),
+  deletedAt: z.iso.datetime().nullable().optional(),
 })

apps/gateway/src/openApi/schemas/utils.ts

@@ -4,7 +4,7 @@ import { LogSources } from '@latitude-data/core/browser'
 export const internalInfoSchema = z.object({
   __internal: z
     .object({
-      source: z.nativeEnum(LogSources).optional(),
+      source: z.enum(LogSources).optional(),
     })
     .optional(),
 })

apps/gateway/src/presenters/documentPresenter.ts

@@ -16,9 +16,9 @@ export const documentPresenterSchema = z.object({
   path: z.string(),
   content: z.string(),
   contentHash: z.string().optional(),
-  config: z.object({}).passthrough(),
-  parameters: z.record(z.object({ type: z.nativeEnum(ParameterType) })),
-  provider: z.nativeEnum(Providers).optional(),
+  config: z.record(z.string(), z.any()),
+  parameters: z.record(z.string(), z.object({ type: z.enum(ParameterType) })),
+  provider: z.enum(Providers).optional(),
 })
 type Parameters = z.infer<typeof documentPresenterSchema>['parameters']
 

apps/gateway/src/routes/api/v1/run/run.route.ts

@@ -20,7 +20,7 @@ export const runRoute = createRoute({
           schema: internalInfoSchema.extend({
             path: z.string(),
             customIdentifier: z.string().optional(),
-            parameters: z.record(z.any()).optional().default({}),
+            parameters: z.record(z.string(), z.any()).optional().default({}),
           }),
         },
       },

apps/gateway/src/routes/api/v2/documents/run/run.route.ts

@@ -22,7 +22,7 @@ export const runRoute = createRoute({
             path: z.string(),
             stream: z.boolean().default(false),
             customIdentifier: z.string().optional(),
-            parameters: z.record(z.any()).optional().default({}),
+            parameters: z.record(z.string(), z.any()).optional().default({}),
           }),
         },
       },

apps/gateway/src/routes/api/v3/conversations/chat/chat.handler.test.ts

@@ -77,7 +77,15 @@ const step: ChainStepResponse<'text'> = {
   streamType: 'text',
   text: 'fake-response-text',
   reasoning: undefined,
-  usage: { promptTokens: 4, completionTokens: 6, totalTokens: 10 },
+  usage: {
+    inputTokens: 4,
+    outputTokens: 6,
+    promptTokens: 4,
+    completionTokens: 6,
+    totalTokens: 10,
+    reasoningTokens: 0,
+    cachedInputTokens: 0,
+  },
   toolCalls: [],
   documentLogUuid: 'fake-document-log-uuid',
   providerLog: {

apps/gateway/src/routes/api/v3/projects/versions/create/createCommit.route.ts

@@ -11,8 +11,8 @@ export const CommitSchema = z.object({
   authorName: z.string().nullable(),
   authorEmail: z.string().nullable(),
   authorId: z.number().nullable(),
-  createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime(),
+  createdAt: z.iso.datetime(),
+  updatedAt: z.iso.datetime(),
   status: z.string(),
   parentCommitUuid: z.string().nullable(),
 })