@mastra/server 1.75.0 → 1.76.0-alpha.0

package/dist/common-tSamNYpt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"common-tSamNYpt.js","names":[],"sources":["../src/server/schemas/common.ts"],"sourcesContent":["import type { MessageInput } from '@mastra/core/agent/message-list';\nimport { z } from 'zod/v4';\n\n/**\n * Brands a permissive runtime schema with a concrete compile-time type.\n *\n * Some request-body fields carry values the server cannot fully validate with\n * zod: functions (stop conditions, client tools), Zod schemas (structured\n * output), or complex core types that would drift if re-declared here. For\n * those fields runtime validation stays permissive and the receiving\n * agent/workflow API performs the real validation, while handlers and\n * generated route types still get the concrete type.\n *\n * Every call site is an intentional, documented gap between runtime\n * validation and the declared type. Prefer a real zod schema whenever the\n * shape can reasonably be expressed — only reach for this when it cannot.\n */\nexport function typedPermissive<T>(schema: z.ZodType): z.ZodType<T> {\n  return schema as unknown as z.ZodType<T>;\n}\n\n// Path parameter schemas\nexport const runIdSchema = z.object({\n  runId: z.string().describe('Unique identifier for the run'),\n});\n\n/**\n * Query parameter schema for runId (optional)\n * Used by create-run route where runId is optional\n */\nexport const optionalRunIdSchema = z.object({\n  runId: z.string().optional(),\n});\n\n// ============================================================================\n// Pagination Schemas\n// ============================================================================\n\n/**\n * Pagination response info\n * Used across all paginated endpoints\n */\nexport const paginationInfoSchema = z.object({\n  total: z.number(),\n  page: z.number(),\n  perPage: z.union([z.number(), z.literal(false)]),\n  hasMore: z.boolean(),\n});\n\n/**\n * Pagination values are non-negative integers. Constraining them here keeps\n * malformed input a 400 at the request boundary: without `.int().min(0)`,\n * `z.coerce.number()` only rejects values that coerce to `NaN`, so `page=-1`\n * and `perPage=2.5` reach the storage layer, which rejects them with a plain\n * `Error` that `handleError` can only report as a 500.\n *\n * The lower bound is 0 rather than 1 because `perPage: 0` is a supported\n * storage contract (the include-only fast path).\n */\nexport const paginationNumber = () => z.coerce.number().int().min(0);\n\n/**\n * Factory function for page/perPage pagination query params\n * @param defaultPerPage - Default value for perPage (omit for no default)\n */\nexport const createPagePaginationSchema = (defaultPerPage?: number) => {\n  const baseSchema = {\n    page: paginationNumber().optional().default(0),\n  };\n\n  if (defaultPerPage !== undefined) {\n    return z.object({\n      ...baseSchema,\n      perPage: paginationNumber().optional().default(defaultPerPage),\n    });\n  } else {\n    return z.object({\n      ...baseSchema,\n      perPage: paginationNumber().optional(),\n    });\n  }\n};\n\n/**\n * Factory function for pagination that supports both page/perPage and limit/offset\n * Use this when you need backwards compatibility with older clients using limit/offset\n */\nexport const createCombinedPaginationSchema = () => {\n  return z.object({\n    page: paginationNumber().optional(),\n    perPage: paginationNumber().optional(),\n    /**\n     * @deprecated Use page and perPage instead\n     */\n    offset: paginationNumber().optional(),\n    /**\n     * @deprecated Use page and perPage instead\n     */\n    limit: paginationNumber().optional(),\n  });\n};\n\n// ============================================================================\n// Observability Schemas\n// ============================================================================\n\n/**\n * Tracing options for observability\n * Used by agents and workflows\n */\nexport const tracingOptionsSchema = z.object({\n  rootSpanName: z.string().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n  requestContextKeys: z.array(z.string()).optional(),\n  traceId: z.string().optional(),\n  parentSpanId: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  hideInput: z.boolean().optional(),\n  hideOutput: z.boolean().optional(),\n});\n\n// ============================================================================\n// Message Schemas\n// ============================================================================\n\n/**\n * Core message schema from AI SDK\n * Represents messages exchanged with AI models\n * Content can be string, array of content parts, or object (for complex message types)\n */\n// Runtime validation stays permissive (z.unknown()) so generated route types\n// don't leak `any`; typedPermissive gives handlers the concrete message type\n// expected by agent APIs (agent.generate/stream/network).\nexport const coreMessageSchema = typedPermissive<MessageInput>(z.unknown());\n// .object({\n//   role: z.enum(['system', 'user', 'assistant', 'tool']),\n//   content: z.union([\n//     z.string(),\n//     z.array(\n//       z\n//         .object({\n//           type: z.enum(['text', 'image', 'file', 'tool-call', 'tool-result']),\n//         })\n//         .passthrough(), // Preserve additional fields like text, image, toolCall, etc.\n//     ),\n//     z.unknown(), // For complex message content objects\n//   ]),\n// })\n// .passthrough();\n\n// ============================================================================\n// Common Response Schemas\n// ============================================================================\n\n/**\n * Standard success response schema\n * Used by operations that return only a success boolean\n */\nexport const successResponseSchema = z.object({\n  success: z.boolean(),\n});\n\n/**\n * Standard message response schema\n * Used by operations that return only a message string\n */\nexport const messageResponseSchema = z.object({\n  message: z.string(),\n});\n\n/**\n * Partial data query parameter schema\n * Used by list endpoints to return minimal data without schemas\n */\nexport const partialQuerySchema = z.object({\n  partial: z.string().optional(),\n});\n\n// ============================================================================\n// Status Schemas\n// ============================================================================\n\n/**\n * Status filter for get-by-id endpoints.\n * Controls which version is resolved:\n * - 'published' (default) — resolve with the active (published) version.\n * - 'draft' — resolve with the latest version (which may be ahead of the published one).\n */\nexport const statusQuerySchema = z.object({\n  status: z\n    .enum(['draft', 'published', 'archived'])\n    .optional()\n    .default('published')\n    .describe('Which version to resolve: published (active version) or draft (latest version)'),\n});\n\n// ============================================================================\n// Logging Schemas\n// ============================================================================\n\n/**\n * Base log message schema\n */\nexport const baseLogMessageSchema = z.object({\n  level: z.enum(['debug', 'info', 'warn', 'error', 'silent']),\n  msg: z.string(),\n  time: z.date(),\n  context: z.record(z.string(), z.unknown()).optional(),\n  runId: z.string().optional(),\n  pid: z.number(),\n  hostname: z.string(),\n  name: z.string(),\n});\n"],"mappings":"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"}