alepha 0.14.0 → 0.14.2

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["parsed: unknown","t","resourceContent: McpResourceContent","mcpMessages: McpPromptMessage[]","args: McpPromptArgument[]","validatedParams: any","properties: Record<string, unknown>","required: string[]","result: Record<string, unknown>","context: McpContext"],"sources":["../../src/mcp/helpers/jsonrpc.ts","../../src/mcp/errors/McpError.ts","../../src/mcp/providers/McpServerProvider.ts","../../src/mcp/primitives/$prompt.ts","../../src/mcp/primitives/$resource.ts","../../src/mcp/primitives/$tool.ts","../../src/mcp/transports/SseMcpTransport.ts","../../src/mcp/transports/StdioMcpTransport.ts","../../src/mcp/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"../interfaces/McpTypes.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const JSONRPC_VERSION = \"2.0\" as const;\n\nexport const MCP_PROTOCOL_VERSION = \"2024-11-05\" as const;\n\nexport const JsonRpcErrorCodes = {\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n} as const;\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Response Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createResponse(\n  id: string | number,\n  result: unknown,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    result,\n  };\n}\n\nexport function createErrorResponse(\n  id: string | number,\n  error: JsonRpcError,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    error,\n  };\n}\n\nexport function createNotification(\n  method: string,\n  params?: Record<string, unknown>,\n): JsonRpcNotification {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    method,\n    params,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Error Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createParseError(message = \"Parse error\"): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.PARSE_ERROR,\n    message,\n  };\n}\n\nexport function createInvalidRequestError(\n  message = \"Invalid request\",\n): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_REQUEST,\n    message,\n  };\n}\n\nexport function createMethodNotFoundError(method: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.METHOD_NOT_FOUND,\n    message: `Method not found: ${method}`,\n  };\n}\n\nexport function createInvalidParamsError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_PARAMS,\n    message,\n  };\n}\n\nexport function createInternalError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INTERNAL_ERROR,\n    message,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Message Parsing\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function parseMessage(data: string): JsonRpcRequest {\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(data);\n  } catch {\n    throw new JsonRpcParseError(\"Invalid JSON\");\n  }\n\n  if (!isValidJsonRpcRequest(parsed)) {\n    throw new JsonRpcParseError(\"Invalid JSON-RPC request\");\n  }\n\n  return parsed;\n}\n\nexport function isValidJsonRpcRequest(value: unknown): value is JsonRpcRequest {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (obj.jsonrpc !== JSONRPC_VERSION) {\n    return false;\n  }\n\n  if (typeof obj.method !== \"string\") {\n    return false;\n  }\n\n  if (\n    obj.id !== undefined &&\n    typeof obj.id !== \"string\" &&\n    typeof obj.id !== \"number\"\n  ) {\n    return false;\n  }\n\n  if (obj.params !== undefined && typeof obj.params !== \"object\") {\n    return false;\n  }\n\n  return true;\n}\n\nexport function isNotification(request: JsonRpcRequest): boolean {\n  return request.id === undefined;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class JsonRpcParseError extends AlephaError {\n  name = \"JsonRpcParseError\";\n}\n","import { JsonRpcErrorCodes } from \"../helpers/jsonrpc.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpError extends Error {\n  name = \"McpError\";\n  code: number;\n\n  constructor(\n    message: string,\n    code: number = JsonRpcErrorCodes.INTERNAL_ERROR,\n  ) {\n    super(message);\n    this.code = code;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpMethodNotFoundError extends McpError {\n  name = \"McpMethodNotFoundError\";\n\n  constructor(method: string) {\n    super(`Method not found: ${method}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpToolNotFoundError extends McpError {\n  name = \"McpToolNotFoundError\";\n  tool: string;\n\n  constructor(tool: string) {\n    super(`Tool not found: ${tool}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.tool = tool;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpResourceNotFoundError extends McpError {\n  name = \"McpResourceNotFoundError\";\n  uri: string;\n\n  constructor(uri: string) {\n    super(`Resource not found: ${uri}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.uri = uri;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpPromptNotFoundError extends McpError {\n  name = \"McpPromptNotFoundError\";\n  prompt: string;\n\n  constructor(prompt: string) {\n    super(`Prompt not found: ${prompt}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.prompt = prompt;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpInvalidParamsError extends McpError {\n  name = \"McpInvalidParamsError\";\n\n  constructor(message: string) {\n    super(message, JsonRpcErrorCodes.INVALID_PARAMS);\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  McpError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n} from \"../errors/McpError.ts\";\nimport {\n  createErrorResponse,\n  createInternalError,\n  createResponse,\n  MCP_PROTOCOL_VERSION,\n} from \"../helpers/jsonrpc.ts\";\nimport type {\n  JsonRpcRequest,\n  JsonRpcResponse,\n  McpCapabilities,\n  McpContent,\n  McpContext,\n  McpInitializeResult,\n  McpPromptDescriptor,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  McpResourceDescriptor,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallResult,\n  McpToolDescriptor,\n} from \"../interfaces/McpTypes.ts\";\nimport type { PromptPrimitive } from \"../primitives/$prompt.ts\";\nimport type { ResourcePrimitive } from \"../primitives/$resource.ts\";\nimport type { ToolPrimitive } from \"../primitives/$tool.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Core MCP server provider that handles protocol messages.\n *\n * This provider maintains registries of tools, resources, and prompts,\n * and routes incoming JSON-RPC requests to the appropriate handlers.\n *\n * It is transport-agnostic - actual communication is handled by\n * transport providers like StdioMcpTransport or SseMcpTransport.\n */\nexport class McpServerProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n\n  protected readonly tools = new Map<string, ToolPrimitive<any>>();\n  protected readonly resources = new Map<string, ResourcePrimitive>();\n  protected readonly prompts = new Map<string, PromptPrimitive<any>>();\n\n  protected initialized = false;\n\n  protected serverInfo: McpServerInfo = {\n    name: \"alepha-mcp\",\n    version: \"1.0.0\",\n  };\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Registration Methods\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Register a tool with the MCP server.\n   */\n  public registerTool(tool: ToolPrimitive<any>): void {\n    this.log.trace(`Registering MCP tool: ${tool.name}`);\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * Register a resource with the MCP server.\n   */\n  public registerResource(resource: ResourcePrimitive): void {\n    this.log.trace(`Registering MCP resource: ${resource.uri}`);\n    this.resources.set(resource.uri, resource);\n  }\n\n  /**\n   * Register a prompt with the MCP server.\n   */\n  public registerPrompt(prompt: PromptPrimitive<any>): void {\n    this.log.trace(`Registering MCP prompt: ${prompt.name}`);\n    this.prompts.set(prompt.name, prompt);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Getters\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Get the server capabilities based on registered primitives.\n   */\n  public getCapabilities(): McpCapabilities {\n    return {\n      tools: this.tools.size > 0 ? {} : undefined,\n      resources: this.resources.size > 0 ? {} : undefined,\n      prompts: this.prompts.size > 0 ? {} : undefined,\n    };\n  }\n\n  /**\n   * Get all registered tools.\n   */\n  public getTools(): ToolPrimitive<any>[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get all registered resources.\n   */\n  public getResources(): ResourcePrimitive[] {\n    return Array.from(this.resources.values());\n  }\n\n  /**\n   * Get all registered prompts.\n   */\n  public getPrompts(): PromptPrimitive<any>[] {\n    return Array.from(this.prompts.values());\n  }\n\n  /**\n   * Get a tool by name.\n   */\n  public getTool(name: string): ToolPrimitive<any> | undefined {\n    return this.tools.get(name);\n  }\n\n  /**\n   * Get a resource by URI.\n   */\n  public getResource(uri: string): ResourcePrimitive | undefined {\n    return this.resources.get(uri);\n  }\n\n  /**\n   * Get a prompt by name.\n   */\n  public getPrompt(name: string): PromptPrimitive<any> | undefined {\n    return this.prompts.get(name);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Message Handling\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Handle an incoming JSON-RPC request.\n   *\n   * @param request - The parsed JSON-RPC request\n   * @param context - Optional context from the transport layer (headers, auth, etc.)\n   * @returns The JSON-RPC response, or null for notifications\n   */\n  public async handleMessage(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<JsonRpcResponse | null> {\n    const id = request.id;\n\n    // Notifications have no id and expect no response\n    if (id === undefined) {\n      await this.handleNotification(request);\n      return null;\n    }\n\n    try {\n      const result = await this.handleRequest(request, context);\n      return createResponse(id, result);\n    } catch (error) {\n      this.log.error(\"MCP request failed\", error);\n      // Preserve error code from McpError instances\n      if (error instanceof McpError) {\n        return createErrorResponse(id, {\n          code: error.code,\n          message: error.message,\n        });\n      }\n      return createErrorResponse(\n        id,\n        createInternalError((error as Error).message),\n      );\n    }\n  }\n\n  /**\n   * Handle a JSON-RPC request that expects a response.\n   */\n  protected async handleRequest(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<unknown> {\n    const { method, params = {} } = request;\n\n    switch (method) {\n      case \"initialize\":\n        return this.handleInitialize(params);\n      case \"ping\":\n        return this.handlePing();\n      case \"tools/list\":\n        return this.handleToolsList();\n      case \"tools/call\":\n        return this.handleToolsCall(params, context);\n      case \"resources/list\":\n        return this.handleResourcesList();\n      case \"resources/read\":\n        return this.handleResourcesRead(params, context);\n      case \"prompts/list\":\n        return this.handlePromptsList();\n      case \"prompts/get\":\n        return this.handlePromptsGet(params, context);\n      default:\n        throw new McpMethodNotFoundError(method);\n    }\n  }\n\n  /**\n   * Handle a notification (no response expected).\n   */\n  protected async handleNotification(request: JsonRpcRequest): Promise<void> {\n    const { method } = request;\n\n    switch (method) {\n      case \"notifications/initialized\":\n        this.log.debug(\"MCP client initialized\");\n        break;\n      case \"notifications/cancelled\":\n        this.log.debug(\"MCP request cancelled\", request.params);\n        break;\n      default:\n        this.log.debug(`Unknown MCP notification: ${method}`);\n    }\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Protocol Handlers\n  // -----------------------------------------------------------------------------------------------------------------\n\n  protected handleInitialize(\n    params: Record<string, unknown>,\n  ): McpInitializeResult {\n    this.log.info(\"MCP client initializing\", {\n      clientInfo: params.clientInfo,\n      protocolVersion: params.protocolVersion,\n    });\n\n    this.initialized = true;\n\n    return {\n      protocolVersion: MCP_PROTOCOL_VERSION,\n      capabilities: this.getCapabilities(),\n      serverInfo: this.serverInfo,\n    };\n  }\n\n  protected handlePing(): Record<string, never> {\n    return {};\n  }\n\n  protected handleToolsList(): { tools: McpToolDescriptor[] } {\n    return {\n      tools: Array.from(this.tools.values()).map((t) => t.toDescriptor()),\n    };\n  }\n\n  protected async handleToolsCall(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpToolCallResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, unknown>;\n\n    const tool = this.tools.get(name);\n    if (!tool) {\n      throw new McpToolNotFoundError(name);\n    }\n\n    try {\n      const result = await tool.execute(args, context);\n\n      const content: McpContent[] = [\n        {\n          type: \"text\",\n          text:\n            typeof result === \"string\"\n              ? result\n              : JSON.stringify(result ?? null),\n        },\n      ];\n\n      return { content };\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: `Error: ${(error as Error).message}`,\n          },\n        ],\n        isError: true,\n      };\n    }\n  }\n\n  protected handleResourcesList(): { resources: McpResourceDescriptor[] } {\n    return {\n      resources: Array.from(this.resources.values()).map((r) =>\n        r.toDescriptor(),\n      ),\n    };\n  }\n\n  protected async handleResourcesRead(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpResourceReadResult> {\n    const uri = params.uri as string;\n\n    const resource = this.resources.get(uri);\n    if (!resource) {\n      throw new McpResourceNotFoundError(uri);\n    }\n\n    const content = await resource.read(context);\n\n    const resourceContent: McpResourceContent = {\n      uri,\n      mimeType: resource.mimeType,\n    };\n\n    if (content.text !== undefined) {\n      resourceContent.text = content.text;\n    }\n\n    if (content.blob !== undefined) {\n      // Convert binary to base64 for transport\n      resourceContent.blob = Buffer.from(content.blob).toString(\"base64\");\n    }\n\n    return {\n      contents: [resourceContent],\n    };\n  }\n\n  protected handlePromptsList(): { prompts: McpPromptDescriptor[] } {\n    return {\n      prompts: Array.from(this.prompts.values()).map((p) => p.toDescriptor()),\n    };\n  }\n\n  protected async handlePromptsGet(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpPromptGetResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, string>;\n\n    const prompt = this.prompts.get(name);\n    if (!prompt) {\n      throw new McpPromptNotFoundError(name);\n    }\n\n    const messages = await prompt.get(args, context);\n\n    const mcpMessages: McpPromptMessage[] = messages.map((msg) => ({\n      role: msg.role,\n      content: {\n        type: \"text\" as const,\n        text: msg.content,\n      },\n    }));\n\n    return {\n      description: prompt.description,\n      messages: mcpMessages,\n    };\n  }\n}\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type TObject,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpPromptArgument,\n  McpPromptDescriptor,\n  PromptHandlerArgs,\n  PromptMessage,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP prompt primitive for defining reusable prompt templates.\n *\n * Prompts allow you to define templated messages that can be filled in\n * with arguments at runtime. They're useful for creating consistent\n * interaction patterns.\n *\n * @example\n * ```ts\n * class Prompts {\n *   greeting = $prompt({\n *     description: \"Generate a personalized greeting\",\n *     args: t.object({\n *       name: t.text({ description: \"Name of the person to greet\" }),\n *       style: t.optional(t.enum([\"formal\", \"casual\"])),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: args.style === \"formal\"\n *           ? `Please greet ${args.name} in a formal manner.`\n *           : `Say hi to ${args.name}!`,\n *       },\n *     ],\n *   });\n *\n *   codeReview = $prompt({\n *     description: \"Request a code review\",\n *     args: t.object({\n *       code: t.text({ description: \"The code to review\" }),\n *       language: t.text({ description: \"Programming language\" }),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: `Please review this ${args.language} code:\\n\\n${args.code}`,\n *       },\n *     ],\n *   });\n * }\n * ```\n */\nexport const $prompt = <T extends TObject>(\n  options: PromptPrimitiveOptions<T>,\n): PromptPrimitive<T> => {\n  return createPrimitive(PromptPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface PromptPrimitiveOptions<T extends TObject> {\n  /**\n   * The name of the prompt.\n   *\n   * If not provided, defaults to the property key where the prompt is declared.\n   *\n   * @example \"greeting\"\n   * @example \"code-review\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this prompt does.\n   *\n   * Helps users understand the purpose of the prompt.\n   *\n   * @example \"Generate a personalized greeting message\"\n   */\n  description?: string;\n\n  /**\n   * TypeBox schema defining the prompt arguments.\n   *\n   * Each property in the schema becomes an argument that can be\n   * filled in when the prompt is used.\n   */\n  args?: T;\n\n  /**\n   * Handler function that generates the prompt messages.\n   *\n   * Receives the validated arguments and returns an array of messages.\n   *\n   * @param args - Object containing validated arguments\n   * @returns Array of prompt messages\n   */\n  handler: (args: PromptHandlerArgs<T>) => Async<PromptMessage[]>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class PromptPrimitive<T extends TObject> extends Primitive<\n  PromptPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the prompt.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the prompt.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerPrompt(this);\n  }\n\n  /**\n   * Get the prompt messages with the given arguments.\n   *\n   * @param rawArgs - Raw arguments to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns Array of prompt messages\n   */\n  public async get(\n    rawArgs: unknown,\n    context?: McpContext,\n  ): Promise<PromptMessage[]> {\n    let args = (rawArgs ?? {}) as Static<T>;\n\n    if (this.options.args) {\n      args = this.alepha.codec.decode(this.options.args, rawArgs ?? {});\n    }\n\n    return this.options.handler({ args, context });\n  }\n\n  /**\n   * Convert the prompt to an MCP prompt descriptor for protocol messages.\n   */\n  public toDescriptor(): McpPromptDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      arguments: this.options.args\n        ? this.schemaToArguments(this.options.args)\n        : [],\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to an array of prompt arguments.\n   */\n  protected schemaToArguments(schema: TObject): McpPromptArgument[] {\n    const args: McpPromptArgument[] = [];\n\n    for (const [name, propSchema] of Object.entries(schema.properties)) {\n      const prop = propSchema as Record<string, unknown>;\n      args.push({\n        name,\n        description: prop.description as string | undefined,\n        required: !t.schema.isOptional(propSchema),\n      });\n    }\n\n    return args;\n  }\n}\n\n$prompt[KIND] = PromptPrimitive;\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type {\n  McpContext,\n  McpResourceDescriptor,\n  ResourceContent,\n  ResourceHandler,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP resource primitive for exposing read-only data.\n *\n * Resources represent any kind of data that an LLM might want to read,\n * such as files, database records, API responses, or computed data.\n *\n * **Key Features**\n * - URI-based identification for resources\n * - Support for text and binary content\n * - MIME type specification\n * - Lazy loading via handler function\n *\n * @example\n * ```ts\n * class ProjectResources {\n *   readme = $resource({\n *     uri: \"file:///readme\",\n *     description: \"Project README file\",\n *     mimeType: \"text/markdown\",\n *     handler: async () => ({\n *       text: await fs.readFile(\"README.md\", \"utf-8\"),\n *     }),\n *   });\n *\n *   config = $resource({\n *     uri: \"config://app\",\n *     name: \"Application Configuration\",\n *     mimeType: \"application/json\",\n *     handler: async () => ({\n *       text: JSON.stringify(this.configService.getConfig()),\n *     }),\n *   });\n * }\n * ```\n */\nexport const $resource = (\n  options: ResourcePrimitiveOptions,\n): ResourcePrimitive => {\n  return createPrimitive(ResourcePrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ResourcePrimitiveOptions {\n  /**\n   * The URI that identifies this resource.\n   *\n   * URIs should follow a consistent scheme for your application.\n   * Common patterns:\n   * - `file:///path/to/file` - File system resources\n   * - `db://table/id` - Database records\n   * - `api://endpoint` - API responses\n   * - `config://name` - Configuration values\n   *\n   * @example \"file:///readme.md\"\n   * @example \"db://users/123\"\n   */\n  uri: string;\n\n  /**\n   * Human-readable name for the resource.\n   *\n   * If not provided, defaults to the property key where the resource is declared.\n   *\n   * @example \"Project README\"\n   * @example \"User Profile\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this resource contains.\n   *\n   * Helps the LLM understand the purpose and content of the resource.\n   *\n   * @example \"The main README file for the project\"\n   */\n  description?: string;\n\n  /**\n   * MIME type of the resource content.\n   *\n   * Helps clients understand how to interpret the content.\n   *\n   * @default \"text/plain\"\n   * @example \"text/markdown\"\n   * @example \"application/json\"\n   */\n  mimeType?: string;\n\n  /**\n   * Handler function that returns the resource content.\n   *\n   * Called when the resource is read. Can return text or binary content.\n   *\n   * @returns Resource content with either `text` or `blob` property\n   */\n  handler: ResourceHandler;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the resource.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the URI of the resource.\n   */\n  public get uri(): string {\n    return this.options.uri;\n  }\n\n  /**\n   * Returns the description of the resource.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  /**\n   * Returns the MIME type of the resource.\n   */\n  public get mimeType(): string {\n    return this.options.mimeType ?? \"text/plain\";\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerResource(this);\n  }\n\n  /**\n   * Read the resource content.\n   *\n   * @param context - Optional context from the transport layer\n   * @returns The resource content\n   */\n  public async read(context?: McpContext): Promise<ResourceContent> {\n    return this.options.handler({ context });\n  }\n\n  /**\n   * Convert the resource to an MCP resource descriptor for protocol messages.\n   */\n  public toDescriptor(): McpResourceDescriptor {\n    return {\n      uri: this.uri,\n      name: this.name,\n      description: this.description,\n      mimeType: this.mimeType,\n    };\n  }\n}\n\n$resource[KIND] = ResourcePrimitive;\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpJsonSchema,\n  McpToolDescriptor,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  ToolPrimitiveSchema,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP tool primitive for defining callable functions.\n *\n * Tools are the primary way for LLMs to interact with external systems through MCP.\n * Each tool has a name, description, typed parameters, and a handler function.\n *\n * **Key Features**\n * - Full TypeScript inference for parameters and results\n * - Automatic schema validation using TypeBox\n * - JSON Schema generation for MCP protocol\n * - Integration with MCP server provider\n *\n * @example\n * ```ts\n * class CalculatorTools {\n *   add = $tool({\n *     description: \"Add two numbers together\",\n *     schema: {\n *       params: t.object({\n *         a: t.number(),\n *         b: t.number(),\n *       }),\n *       result: t.number(),\n *     },\n *     handler: async ({ params }) => {\n *       return params.a + params.b;\n *     },\n *   });\n *\n *   greet = $tool({\n *     description: \"Generate a greeting message\",\n *     schema: {\n *       params: t.object({\n *         name: t.text(),\n *       }),\n *       result: t.text(),\n *     },\n *     handler: async ({ params }) => {\n *       return `Hello, ${params.name}!`;\n *     },\n *   });\n * }\n * ```\n */\nexport const $tool = <T extends ToolPrimitiveSchema>(\n  options: ToolPrimitiveOptions<T>,\n): ToolPrimitive<T> => {\n  return createPrimitive(ToolPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ToolPrimitiveOptions<T extends ToolPrimitiveSchema> {\n  /**\n   * The name of the tool.\n   *\n   * If not provided, defaults to the property key where the tool is declared.\n   * Names should be descriptive and use kebab-case or snake_case.\n   *\n   * @example \"calculate-sum\"\n   * @example \"get_weather\"\n   */\n  name?: string;\n\n  /**\n   * A human-readable description of what the tool does.\n   *\n   * This description is sent to the LLM to help it understand\n   * when and how to use the tool. Be clear and specific.\n   *\n   * @example \"Calculate the sum of two numbers\"\n   * @example \"Retrieve current weather data for a given location\"\n   */\n  description: string;\n\n  /**\n   * TypeBox schema defining the tool's parameters and result type.\n   *\n   * - **params**: TObject schema for input parameters (optional)\n   * - **result**: TSchema for the return value (optional)\n   *\n   * Schemas provide:\n   * - Type inference for handler function\n   * - Runtime validation of inputs\n   * - JSON Schema generation for MCP protocol\n   */\n  schema?: T;\n\n  /**\n   * The handler function that executes when the tool is called.\n   *\n   * Receives validated parameters and returns the result.\n   * Errors thrown here are caught and returned as MCP errors.\n   *\n   * @param args - Object containing validated params\n   * @returns The tool result (can be async)\n   */\n  handler: (args: ToolHandlerArgs<T>) => Async<ToolHandlerResult<T>>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ToolPrimitive<T extends ToolPrimitiveSchema> extends Primitive<\n  ToolPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the tool.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the tool.\n   */\n  public get description(): string {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerTool(this);\n  }\n\n  /**\n   * Execute the tool with the given parameters.\n   *\n   * @param params - Raw parameters to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns The tool result\n   */\n  public async execute(\n    params: unknown,\n    context?: McpContext,\n  ): Promise<ToolHandlerResult<T>> {\n    let validatedParams: any = params ?? {};\n\n    // Validate params using alepha.codec if schema provided\n    if (this.options.schema?.params) {\n      validatedParams = this.alepha.codec.decode(\n        this.options.schema.params,\n        validatedParams,\n      );\n    }\n\n    const result = await this.options.handler({\n      params: validatedParams,\n      context,\n    });\n\n    // Validate and encode result if schema provided\n    if (this.options.schema?.result && result !== undefined) {\n      return this.alepha.codec.encode(\n        this.options.schema.result,\n        result,\n      ) as ToolHandlerResult<T>;\n    }\n\n    return result as ToolHandlerResult<T>;\n  }\n\n  /**\n   * Convert the tool to an MCP tool descriptor for protocol messages.\n   */\n  public toDescriptor(): McpToolDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      inputSchema: this.options.schema?.params\n        ? this.schemaToJsonSchema(this.options.schema.params)\n        : { type: \"object\", properties: {}, required: [] },\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to JSON Schema format.\n   */\n  protected schemaToJsonSchema(schema: TObject): McpJsonSchema {\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      properties[key] = this.propertyToJsonSchema(propSchema as TSchema);\n\n      // Check if property is required (not optional)\n      if (!t.schema.isOptional(propSchema as TSchema)) {\n        required.push(key);\n      }\n    }\n\n    return {\n      type: \"object\",\n      properties,\n      required,\n    };\n  }\n\n  /**\n   * Convert a single property schema to JSON Schema format.\n   */\n  protected propertyToJsonSchema(schema: TSchema): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    // Check for description on all types\n    if (\"description\" in schema) {\n      result.description = schema.description;\n    }\n\n    if (t.schema.isString(schema)) {\n      result.type = \"string\";\n      if (\"minLength\" in schema) result.minLength = schema.minLength;\n      if (\"maxLength\" in schema) result.maxLength = schema.maxLength;\n      if (\"pattern\" in schema) result.pattern = schema.pattern;\n      if (\"enum\" in schema) result.enum = schema.enum;\n    } else if (t.schema.isNumber(schema)) {\n      result.type = \"number\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isInteger(schema)) {\n      result.type = \"integer\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isBoolean(schema)) {\n      result.type = \"boolean\";\n    } else if (t.schema.isArray(schema)) {\n      result.type = \"array\";\n      if (\"items\" in schema) {\n        result.items = this.propertyToJsonSchema(schema.items as TSchema);\n      }\n    } else if (t.schema.isObject(schema)) {\n      Object.assign(result, this.schemaToJsonSchema(schema));\n    } else if (t.schema.isUnsafe(schema) || t.schema.isOptional(schema)) {\n      // Handle Unsafe types (like t.enum) and optional wrappers by checking the underlying type property\n      const schemaAny = schema as { type?: string; enum?: unknown[] };\n      if (schemaAny.type === \"string\") {\n        result.type = \"string\";\n        if (\"enum\" in schema) result.enum = schema.enum;\n        if (\"pattern\" in schema) result.pattern = schema.pattern;\n      } else if (schemaAny.type === \"number\") {\n        result.type = \"number\";\n      } else if (schemaAny.type === \"integer\") {\n        result.type = \"integer\";\n      } else if (schemaAny.type === \"boolean\") {\n        result.type = \"boolean\";\n      } else if (schemaAny.type === \"array\") {\n        result.type = \"array\";\n      } else if (schemaAny.type === \"object\") {\n        result.type = \"object\";\n      } else {\n        // Fallback\n        result.type = \"string\";\n      }\n    } else {\n      // Fallback for other types\n      result.type = \"string\";\n    }\n\n    return result;\n  }\n}\n\n$tool[KIND] = ToolPrimitive;\n","import { $env, $inject, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $route } from \"alepha/server\";\nimport {\n  createErrorResponse,\n  createNotification,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport type { McpContext } from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  MCP_SSE_PATH: t.text({\n    description: \"Path for MCP SSE endpoint\",\n    default: \"/mcp\",\n  }),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SSE (Server-Sent Events) transport for MCP communication.\n *\n * This transport uses HTTP with SSE for server-to-client messages\n * and POST requests for client-to-server messages.\n *\n * Endpoints:\n * - GET /mcp - SSE stream for server events\n * - POST /mcp - JSON-RPC request endpoint\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaServer } from \"alepha/server\";\n * import { AlephaMcp, AlephaMcpSse } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaServer)\n *     .with(AlephaMcp)\n *     .with(AlephaMcpSse)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class SseMcpTransport {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * SSE endpoint for server-to-client messages.\n   *\n   * Returns a text/event-stream response with server capabilities\n   * and keeps the connection open for notifications.\n   */\n  sse = $route({\n    method: \"GET\",\n    path: this.env.MCP_SSE_PATH,\n    handler: async (request) => {\n      this.log.debug(\"MCP SSE connection established\");\n\n      const encoder = new TextEncoder();\n\n      // Create SSE stream\n      const stream = new ReadableStream({\n        start: (controller) => {\n          // Send initial endpoint info\n          const endpointEvent = this.formatSseEvent(\n            \"endpoint\",\n            `${this.env.MCP_SSE_PATH}`,\n          );\n          controller.enqueue(encoder.encode(endpointEvent));\n\n          // Send capabilities notification\n          const capabilitiesNotification = createNotification(\n            \"notifications/capabilities\",\n            { capabilities: this.mcpServer.getCapabilities() },\n          );\n          const capabilitiesEvent = this.formatSseEvent(\n            \"message\",\n            JSON.stringify(capabilitiesNotification),\n          );\n          controller.enqueue(encoder.encode(capabilitiesEvent));\n        },\n        cancel: () => {\n          this.log.debug(\"MCP SSE connection closed\");\n        },\n      });\n\n      request.reply.status = 200;\n      request.reply.headers = {\n        \"content-type\": \"text/event-stream\",\n        \"cache-control\": \"no-cache\",\n        connection: \"keep-alive\",\n      };\n      request.reply.body = stream;\n    },\n  });\n\n  /**\n   * POST endpoint for client-to-server JSON-RPC messages.\n   */\n  message = $route({\n    method: \"POST\",\n    path: this.env.MCP_SSE_PATH,\n    secure: false,\n    schema: {\n      body: t.json(),\n    },\n    handler: async (request) => {\n      try {\n        const body =\n          typeof request.body === \"string\"\n            ? request.body\n            : JSON.stringify(request.body);\n\n        this.log.debug(\"MCP request body\", {\n          body,\n          bodyType: typeof request.body,\n        });\n\n        const rpcRequest = parseMessage(body);\n\n        // Build context from request headers\n        const context: McpContext = {\n          headers: request.headers as Record<\n            string,\n            string | string[] | undefined\n          >,\n        };\n\n        const response = await this.mcpServer.handleMessage(\n          rpcRequest,\n          context,\n        );\n\n        request.reply.headers[\"content-type\"] = \"application/json\";\n        request.reply.body = response ? JSON.stringify(response) : \"\";\n      } catch (error) {\n        if (error instanceof JsonRpcParseError) {\n          request.reply.status = 400;\n          request.reply.headers[\"content-type\"] = \"application/json\";\n          request.reply.body = JSON.stringify(\n            createErrorResponse(0, createParseError(error.message)),\n          );\n        } else {\n          this.log.error(\"Failed to process MCP message\", error);\n          request.reply.status = 500;\n          request.reply.body = JSON.stringify({\n            error: (error as Error).message,\n          });\n        }\n      }\n    },\n  });\n\n  /**\n   * Format a message as an SSE event.\n   */\n  protected formatSseEvent(event: string, data: string): string {\n    return `event: ${event}\\ndata: ${data}\\n\\n`;\n  }\n}\n","import * as readline from \"node:readline\";\nimport { $hook, $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  createErrorResponse,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Stdio transport for MCP communication.\n *\n * This transport uses stdin/stdout for JSON-RPC message exchange,\n * which is the standard transport for local MCP servers.\n *\n * Messages are newline-delimited JSON objects.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaMcp, AlephaMcpStdio } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaMcp)\n *     .with(AlephaMcpStdio)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class StdioMcpTransport {\n  protected readonly log = $logger();\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  protected rl?: readline.Interface;\n  protected started = false;\n\n  onStart = $hook({\n    on: \"start\",\n    handler: () => this.start(),\n  });\n\n  onStop = $hook({\n    on: \"stop\",\n    handler: () => this.stop(),\n  });\n\n  /**\n   * Start the stdio transport.\n   */\n  protected start(): void {\n    if (this.started) return;\n    this.started = true;\n\n    this.rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout,\n      terminal: false,\n    });\n\n    this.rl.on(\"line\", (line) => this.handleLine(line));\n    this.rl.on(\"close\", () => this.handleClose());\n\n    this.log.info(\"MCP stdio transport started\");\n  }\n\n  /**\n   * Stop the stdio transport.\n   */\n  protected stop(): void {\n    if (!this.started) return;\n    this.started = false;\n\n    this.rl?.close();\n    this.rl = undefined;\n\n    this.log.info(\"MCP stdio transport stopped\");\n  }\n\n  /**\n   * Handle an incoming line from stdin.\n   */\n  protected async handleLine(line: string): Promise<void> {\n    // Skip empty lines\n    if (!line.trim()) return;\n\n    try {\n      const request = parseMessage(line);\n      const response = await this.mcpServer.handleMessage(request);\n\n      if (response) {\n        this.send(response);\n      }\n    } catch (error) {\n      if (error instanceof JsonRpcParseError) {\n        // Send parse error response\n        this.send(createErrorResponse(0, createParseError(error.message)));\n      } else {\n        this.log.error(\"Failed to process MCP message\", error);\n      }\n    }\n  }\n\n  /**\n   * Handle stdin close event.\n   */\n  protected handleClose(): void {\n    this.log.debug(\"MCP stdio input closed\");\n  }\n\n  /**\n   * Send a message to stdout.\n   */\n  protected send(message: object): void {\n    const json = JSON.stringify(message);\n    process.stdout.write(json + \"\\n\");\n  }\n}\n","import { $module } from \"alepha\";\nimport { $prompt } from \"./primitives/$prompt.ts\";\nimport { $resource } from \"./primitives/$resource.ts\";\nimport { $tool } from \"./primitives/$tool.ts\";\nimport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nimport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nimport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport {\n  McpError,\n  McpInvalidParamsError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n} from \"./errors/McpError.ts\";\nexport {\n  createErrorResponse,\n  createInternalError,\n  createInvalidParamsError,\n  createInvalidRequestError,\n  createMethodNotFoundError,\n  createNotification,\n  createParseError,\n  createResponse,\n  isNotification,\n  isValidJsonRpcRequest,\n  JSONRPC_VERSION,\n  JsonRpcErrorCodes,\n  JsonRpcParseError,\n  MCP_PROTOCOL_VERSION,\n  parseMessage,\n} from \"./helpers/jsonrpc.ts\";\nexport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  // JSON-RPC types\n  JsonRpcRequest,\n  JsonRpcResponse,\n  // MCP protocol types\n  McpCapabilities,\n  McpClientInfo,\n  McpContent,\n  // Context type for auth/headers\n  McpContext,\n  McpInitializeParams,\n  McpInitializeResult,\n  McpJsonSchema,\n  McpPromptArgument,\n  McpPromptContent,\n  // Prompt types\n  McpPromptDescriptor,\n  McpPromptGetParams,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  // Resource types\n  McpResourceDescriptor,\n  McpResourceReadParams,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallParams,\n  McpToolCallResult,\n  // Tool types\n  McpToolDescriptor,\n  PromptHandler,\n  PromptHandlerArgs,\n  PromptMessage,\n  ResourceContent,\n  ResourceHandler,\n  ResourceHandlerArgs,\n  ToolHandler,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  // Handler types\n  ToolPrimitiveSchema,\n} from \"./interfaces/McpTypes.ts\";\nexport type { PromptPrimitiveOptions } from \"./primitives/$prompt.ts\";\nexport { $prompt, PromptPrimitive } from \"./primitives/$prompt.ts\";\nexport type { ResourcePrimitiveOptions } from \"./primitives/$resource.ts\";\nexport { $resource, ResourcePrimitive } from \"./primitives/$resource.ts\";\nexport type { ToolPrimitiveOptions } from \"./primitives/$tool.ts\";\nexport { $tool, ToolPrimitive } from \"./primitives/$tool.ts\";\nexport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nexport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nexport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Core MCP module with primitives and server provider.\n *\n * This module registers the $tool, $resource, and $prompt primitives\n * and the McpServerProvider. You need to add a transport module\n * (AlephaMcpStdio or AlephaMcpSse) for actual communication.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaMcp, AlephaMcpStdio, $tool, t } from \"alepha/mcp\";\n *\n * class MyMcpServer {\n *   add = $tool({\n *     description: \"Add two numbers\",\n *     schema: {\n *       params: t.object({ a: t.number(), b: t.number() }),\n *       result: t.number(),\n *     },\n *     handler: async ({ params }) => params.a + params.b,\n *   });\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaMcp)\n *     .with(AlephaMcpStdio)\n *     .with(MyMcpServer)\n * );\n * ```\n *\n * @module alepha.mcp\n */\nexport const AlephaMcp = $module({\n  name: \"alepha.mcp\",\n  primitives: [$tool, $resource, $prompt],\n  services: [McpServerProvider, SseMcpTransport, StdioMcpTransport],\n  register: (alepha) => {\n    alepha.with(McpServerProvider);\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["t"],"sources":["../../src/mcp/helpers/jsonrpc.ts","../../src/mcp/errors/McpError.ts","../../src/mcp/providers/McpServerProvider.ts","../../src/mcp/primitives/$prompt.ts","../../src/mcp/primitives/$resource.ts","../../src/mcp/primitives/$tool.ts","../../src/mcp/transports/SseMcpTransport.ts","../../src/mcp/transports/StdioMcpTransport.ts","../../src/mcp/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"../interfaces/McpTypes.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const JSONRPC_VERSION = \"2.0\" as const;\n\nexport const MCP_PROTOCOL_VERSION = \"2024-11-05\" as const;\n\nexport const JsonRpcErrorCodes = {\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n} as const;\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Response Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createResponse(\n  id: string | number,\n  result: unknown,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    result,\n  };\n}\n\nexport function createErrorResponse(\n  id: string | number,\n  error: JsonRpcError,\n): JsonRpcResponse {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    id,\n    error,\n  };\n}\n\nexport function createNotification(\n  method: string,\n  params?: Record<string, unknown>,\n): JsonRpcNotification {\n  return {\n    jsonrpc: JSONRPC_VERSION,\n    method,\n    params,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Error Builders\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function createParseError(message = \"Parse error\"): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.PARSE_ERROR,\n    message,\n  };\n}\n\nexport function createInvalidRequestError(\n  message = \"Invalid request\",\n): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_REQUEST,\n    message,\n  };\n}\n\nexport function createMethodNotFoundError(method: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.METHOD_NOT_FOUND,\n    message: `Method not found: ${method}`,\n  };\n}\n\nexport function createInvalidParamsError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INVALID_PARAMS,\n    message,\n  };\n}\n\nexport function createInternalError(message: string): JsonRpcError {\n  return {\n    code: JsonRpcErrorCodes.INTERNAL_ERROR,\n    message,\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Message Parsing\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function parseMessage(data: string): JsonRpcRequest {\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(data);\n  } catch {\n    throw new JsonRpcParseError(\"Invalid JSON\");\n  }\n\n  if (!isValidJsonRpcRequest(parsed)) {\n    throw new JsonRpcParseError(\"Invalid JSON-RPC request\");\n  }\n\n  return parsed;\n}\n\nexport function isValidJsonRpcRequest(value: unknown): value is JsonRpcRequest {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (obj.jsonrpc !== JSONRPC_VERSION) {\n    return false;\n  }\n\n  if (typeof obj.method !== \"string\") {\n    return false;\n  }\n\n  if (\n    obj.id !== undefined &&\n    typeof obj.id !== \"string\" &&\n    typeof obj.id !== \"number\"\n  ) {\n    return false;\n  }\n\n  if (obj.params !== undefined && typeof obj.params !== \"object\") {\n    return false;\n  }\n\n  return true;\n}\n\nexport function isNotification(request: JsonRpcRequest): boolean {\n  return request.id === undefined;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class JsonRpcParseError extends AlephaError {\n  name = \"JsonRpcParseError\";\n}\n","import { JsonRpcErrorCodes } from \"../helpers/jsonrpc.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpError extends Error {\n  name = \"McpError\";\n  code: number;\n\n  constructor(\n    message: string,\n    code: number = JsonRpcErrorCodes.INTERNAL_ERROR,\n  ) {\n    super(message);\n    this.code = code;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpMethodNotFoundError extends McpError {\n  name = \"McpMethodNotFoundError\";\n\n  constructor(method: string) {\n    super(`Method not found: ${method}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpToolNotFoundError extends McpError {\n  name = \"McpToolNotFoundError\";\n  tool: string;\n\n  constructor(tool: string) {\n    super(`Tool not found: ${tool}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.tool = tool;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpResourceNotFoundError extends McpError {\n  name = \"McpResourceNotFoundError\";\n  uri: string;\n\n  constructor(uri: string) {\n    super(`Resource not found: ${uri}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.uri = uri;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpPromptNotFoundError extends McpError {\n  name = \"McpPromptNotFoundError\";\n  prompt: string;\n\n  constructor(prompt: string) {\n    super(`Prompt not found: ${prompt}`, JsonRpcErrorCodes.METHOD_NOT_FOUND);\n    this.prompt = prompt;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class McpInvalidParamsError extends McpError {\n  name = \"McpInvalidParamsError\";\n\n  constructor(message: string) {\n    super(message, JsonRpcErrorCodes.INVALID_PARAMS);\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  McpError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n} from \"../errors/McpError.ts\";\nimport {\n  createErrorResponse,\n  createInternalError,\n  createResponse,\n  MCP_PROTOCOL_VERSION,\n} from \"../helpers/jsonrpc.ts\";\nimport type {\n  JsonRpcRequest,\n  JsonRpcResponse,\n  McpCapabilities,\n  McpContent,\n  McpContext,\n  McpInitializeResult,\n  McpPromptDescriptor,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  McpResourceDescriptor,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallResult,\n  McpToolDescriptor,\n} from \"../interfaces/McpTypes.ts\";\nimport type { PromptPrimitive } from \"../primitives/$prompt.ts\";\nimport type { ResourcePrimitive } from \"../primitives/$resource.ts\";\nimport type { ToolPrimitive } from \"../primitives/$tool.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Core MCP server provider that handles protocol messages.\n *\n * This provider maintains registries of tools, resources, and prompts,\n * and routes incoming JSON-RPC requests to the appropriate handlers.\n *\n * It is transport-agnostic - actual communication is handled by\n * transport providers like StdioMcpTransport or SseMcpTransport.\n */\nexport class McpServerProvider {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n\n  protected readonly tools = new Map<string, ToolPrimitive<any>>();\n  protected readonly resources = new Map<string, ResourcePrimitive>();\n  protected readonly prompts = new Map<string, PromptPrimitive<any>>();\n\n  protected initialized = false;\n\n  protected serverInfo: McpServerInfo = {\n    name: \"alepha-mcp\",\n    version: \"1.0.0\",\n  };\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Registration Methods\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Register a tool with the MCP server.\n   */\n  public registerTool(tool: ToolPrimitive<any>): void {\n    this.log.trace(`Registering MCP tool: ${tool.name}`);\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * Register a resource with the MCP server.\n   */\n  public registerResource(resource: ResourcePrimitive): void {\n    this.log.trace(`Registering MCP resource: ${resource.uri}`);\n    this.resources.set(resource.uri, resource);\n  }\n\n  /**\n   * Register a prompt with the MCP server.\n   */\n  public registerPrompt(prompt: PromptPrimitive<any>): void {\n    this.log.trace(`Registering MCP prompt: ${prompt.name}`);\n    this.prompts.set(prompt.name, prompt);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Getters\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Get the server capabilities based on registered primitives.\n   */\n  public getCapabilities(): McpCapabilities {\n    return {\n      tools: this.tools.size > 0 ? {} : undefined,\n      resources: this.resources.size > 0 ? {} : undefined,\n      prompts: this.prompts.size > 0 ? {} : undefined,\n    };\n  }\n\n  /**\n   * Get all registered tools.\n   */\n  public getTools(): ToolPrimitive<any>[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get all registered resources.\n   */\n  public getResources(): ResourcePrimitive[] {\n    return Array.from(this.resources.values());\n  }\n\n  /**\n   * Get all registered prompts.\n   */\n  public getPrompts(): PromptPrimitive<any>[] {\n    return Array.from(this.prompts.values());\n  }\n\n  /**\n   * Get a tool by name.\n   */\n  public getTool(name: string): ToolPrimitive<any> | undefined {\n    return this.tools.get(name);\n  }\n\n  /**\n   * Get a resource by URI.\n   */\n  public getResource(uri: string): ResourcePrimitive | undefined {\n    return this.resources.get(uri);\n  }\n\n  /**\n   * Get a prompt by name.\n   */\n  public getPrompt(name: string): PromptPrimitive<any> | undefined {\n    return this.prompts.get(name);\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Message Handling\n  // -----------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Handle an incoming JSON-RPC request.\n   *\n   * @param request - The parsed JSON-RPC request\n   * @param context - Optional context from the transport layer (headers, auth, etc.)\n   * @returns The JSON-RPC response, or null for notifications\n   */\n  public async handleMessage(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<JsonRpcResponse | null> {\n    const id = request.id;\n\n    // Notifications have no id and expect no response\n    if (id === undefined) {\n      await this.handleNotification(request);\n      return null;\n    }\n\n    try {\n      const result = await this.handleRequest(request, context);\n      return createResponse(id, result);\n    } catch (error) {\n      this.log.error(\"MCP request failed\", error);\n      // Preserve error code from McpError instances\n      if (error instanceof McpError) {\n        return createErrorResponse(id, {\n          code: error.code,\n          message: error.message,\n        });\n      }\n      return createErrorResponse(\n        id,\n        createInternalError((error as Error).message),\n      );\n    }\n  }\n\n  /**\n   * Handle a JSON-RPC request that expects a response.\n   */\n  protected async handleRequest(\n    request: JsonRpcRequest,\n    context?: McpContext,\n  ): Promise<unknown> {\n    const { method, params = {} } = request;\n\n    switch (method) {\n      case \"initialize\":\n        return this.handleInitialize(params);\n      case \"ping\":\n        return this.handlePing();\n      case \"tools/list\":\n        return this.handleToolsList();\n      case \"tools/call\":\n        return this.handleToolsCall(params, context);\n      case \"resources/list\":\n        return this.handleResourcesList();\n      case \"resources/read\":\n        return this.handleResourcesRead(params, context);\n      case \"prompts/list\":\n        return this.handlePromptsList();\n      case \"prompts/get\":\n        return this.handlePromptsGet(params, context);\n      default:\n        throw new McpMethodNotFoundError(method);\n    }\n  }\n\n  /**\n   * Handle a notification (no response expected).\n   */\n  protected async handleNotification(request: JsonRpcRequest): Promise<void> {\n    const { method } = request;\n\n    switch (method) {\n      case \"notifications/initialized\":\n        this.log.debug(\"MCP client initialized\");\n        break;\n      case \"notifications/cancelled\":\n        this.log.debug(\"MCP request cancelled\", request.params);\n        break;\n      default:\n        this.log.debug(`Unknown MCP notification: ${method}`);\n    }\n  }\n\n  // -----------------------------------------------------------------------------------------------------------------\n  // Protocol Handlers\n  // -----------------------------------------------------------------------------------------------------------------\n\n  protected handleInitialize(\n    params: Record<string, unknown>,\n  ): McpInitializeResult {\n    this.log.info(\"MCP client initializing\", {\n      clientInfo: params.clientInfo,\n      protocolVersion: params.protocolVersion,\n    });\n\n    this.initialized = true;\n\n    return {\n      protocolVersion: MCP_PROTOCOL_VERSION,\n      capabilities: this.getCapabilities(),\n      serverInfo: this.serverInfo,\n    };\n  }\n\n  protected handlePing(): Record<string, never> {\n    return {};\n  }\n\n  protected handleToolsList(): { tools: McpToolDescriptor[] } {\n    return {\n      tools: Array.from(this.tools.values()).map((t) => t.toDescriptor()),\n    };\n  }\n\n  protected async handleToolsCall(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpToolCallResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, unknown>;\n\n    const tool = this.tools.get(name);\n    if (!tool) {\n      throw new McpToolNotFoundError(name);\n    }\n\n    try {\n      const result = await tool.execute(args, context);\n\n      const content: McpContent[] = [\n        {\n          type: \"text\",\n          text:\n            typeof result === \"string\"\n              ? result\n              : JSON.stringify(result ?? null),\n        },\n      ];\n\n      return { content };\n    } catch (error) {\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: `Error: ${(error as Error).message}`,\n          },\n        ],\n        isError: true,\n      };\n    }\n  }\n\n  protected handleResourcesList(): { resources: McpResourceDescriptor[] } {\n    return {\n      resources: Array.from(this.resources.values()).map((r) =>\n        r.toDescriptor(),\n      ),\n    };\n  }\n\n  protected async handleResourcesRead(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpResourceReadResult> {\n    const uri = params.uri as string;\n\n    const resource = this.resources.get(uri);\n    if (!resource) {\n      throw new McpResourceNotFoundError(uri);\n    }\n\n    const content = await resource.read(context);\n\n    const resourceContent: McpResourceContent = {\n      uri,\n      mimeType: resource.mimeType,\n    };\n\n    if (content.text !== undefined) {\n      resourceContent.text = content.text;\n    }\n\n    if (content.blob !== undefined) {\n      // Convert binary to base64 for transport\n      resourceContent.blob = Buffer.from(content.blob).toString(\"base64\");\n    }\n\n    return {\n      contents: [resourceContent],\n    };\n  }\n\n  protected handlePromptsList(): { prompts: McpPromptDescriptor[] } {\n    return {\n      prompts: Array.from(this.prompts.values()).map((p) => p.toDescriptor()),\n    };\n  }\n\n  protected async handlePromptsGet(\n    params: Record<string, unknown>,\n    context?: McpContext,\n  ): Promise<McpPromptGetResult> {\n    const name = params.name as string;\n    const args = (params.arguments ?? {}) as Record<string, string>;\n\n    const prompt = this.prompts.get(name);\n    if (!prompt) {\n      throw new McpPromptNotFoundError(name);\n    }\n\n    const messages = await prompt.get(args, context);\n\n    const mcpMessages: McpPromptMessage[] = messages.map((msg) => ({\n      role: msg.role,\n      content: {\n        type: \"text\" as const,\n        text: msg.content,\n      },\n    }));\n\n    return {\n      description: prompt.description,\n      messages: mcpMessages,\n    };\n  }\n}\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type TObject,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpPromptArgument,\n  McpPromptDescriptor,\n  PromptHandlerArgs,\n  PromptMessage,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP prompt primitive for defining reusable prompt templates.\n *\n * Prompts allow you to define templated messages that can be filled in\n * with arguments at runtime. They're useful for creating consistent\n * interaction patterns.\n *\n * @example\n * ```ts\n * class Prompts {\n *   greeting = $prompt({\n *     description: \"Generate a personalized greeting\",\n *     args: t.object({\n *       name: t.text({ description: \"Name of the person to greet\" }),\n *       style: t.optional(t.enum([\"formal\", \"casual\"])),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: args.style === \"formal\"\n *           ? `Please greet ${args.name} in a formal manner.`\n *           : `Say hi to ${args.name}!`,\n *       },\n *     ],\n *   });\n *\n *   codeReview = $prompt({\n *     description: \"Request a code review\",\n *     args: t.object({\n *       code: t.text({ description: \"The code to review\" }),\n *       language: t.text({ description: \"Programming language\" }),\n *     }),\n *     handler: async ({ args }) => [\n *       {\n *         role: \"user\",\n *         content: `Please review this ${args.language} code:\\n\\n${args.code}`,\n *       },\n *     ],\n *   });\n * }\n * ```\n */\nexport const $prompt = <T extends TObject>(\n  options: PromptPrimitiveOptions<T>,\n): PromptPrimitive<T> => {\n  return createPrimitive(PromptPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface PromptPrimitiveOptions<T extends TObject> {\n  /**\n   * The name of the prompt.\n   *\n   * If not provided, defaults to the property key where the prompt is declared.\n   *\n   * @example \"greeting\"\n   * @example \"code-review\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this prompt does.\n   *\n   * Helps users understand the purpose of the prompt.\n   *\n   * @example \"Generate a personalized greeting message\"\n   */\n  description?: string;\n\n  /**\n   * TypeBox schema defining the prompt arguments.\n   *\n   * Each property in the schema becomes an argument that can be\n   * filled in when the prompt is used.\n   */\n  args?: T;\n\n  /**\n   * Handler function that generates the prompt messages.\n   *\n   * Receives the validated arguments and returns an array of messages.\n   *\n   * @param args - Object containing validated arguments\n   * @returns Array of prompt messages\n   */\n  handler: (args: PromptHandlerArgs<T>) => Async<PromptMessage[]>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class PromptPrimitive<T extends TObject> extends Primitive<\n  PromptPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the prompt.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the prompt.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerPrompt(this);\n  }\n\n  /**\n   * Get the prompt messages with the given arguments.\n   *\n   * @param rawArgs - Raw arguments to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns Array of prompt messages\n   */\n  public async get(\n    rawArgs: unknown,\n    context?: McpContext,\n  ): Promise<PromptMessage[]> {\n    let args = (rawArgs ?? {}) as Static<T>;\n\n    if (this.options.args) {\n      args = this.alepha.codec.decode(this.options.args, rawArgs ?? {});\n    }\n\n    return this.options.handler({ args, context });\n  }\n\n  /**\n   * Convert the prompt to an MCP prompt descriptor for protocol messages.\n   */\n  public toDescriptor(): McpPromptDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      arguments: this.options.args\n        ? this.schemaToArguments(this.options.args)\n        : [],\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to an array of prompt arguments.\n   */\n  protected schemaToArguments(schema: TObject): McpPromptArgument[] {\n    const args: McpPromptArgument[] = [];\n\n    for (const [name, propSchema] of Object.entries(schema.properties)) {\n      const prop = propSchema as Record<string, unknown>;\n      args.push({\n        name,\n        description: prop.description as string | undefined,\n        required: !t.schema.isOptional(propSchema),\n      });\n    }\n\n    return args;\n  }\n}\n\n$prompt[KIND] = PromptPrimitive;\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type {\n  McpContext,\n  McpResourceDescriptor,\n  ResourceContent,\n  ResourceHandler,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP resource primitive for exposing read-only data.\n *\n * Resources represent any kind of data that an LLM might want to read,\n * such as files, database records, API responses, or computed data.\n *\n * **Key Features**\n * - URI-based identification for resources\n * - Support for text and binary content\n * - MIME type specification\n * - Lazy loading via handler function\n *\n * @example\n * ```ts\n * class ProjectResources {\n *   readme = $resource({\n *     uri: \"file:///readme\",\n *     description: \"Project README file\",\n *     mimeType: \"text/markdown\",\n *     handler: async () => ({\n *       text: await fs.readFile(\"README.md\", \"utf-8\"),\n *     }),\n *   });\n *\n *   config = $resource({\n *     uri: \"config://app\",\n *     name: \"Application Configuration\",\n *     mimeType: \"application/json\",\n *     handler: async () => ({\n *       text: JSON.stringify(this.configService.getConfig()),\n *     }),\n *   });\n * }\n * ```\n */\nexport const $resource = (\n  options: ResourcePrimitiveOptions,\n): ResourcePrimitive => {\n  return createPrimitive(ResourcePrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ResourcePrimitiveOptions {\n  /**\n   * The URI that identifies this resource.\n   *\n   * URIs should follow a consistent scheme for your application.\n   * Common patterns:\n   * - `file:///path/to/file` - File system resources\n   * - `db://table/id` - Database records\n   * - `api://endpoint` - API responses\n   * - `config://name` - Configuration values\n   *\n   * @example \"file:///readme.md\"\n   * @example \"db://users/123\"\n   */\n  uri: string;\n\n  /**\n   * Human-readable name for the resource.\n   *\n   * If not provided, defaults to the property key where the resource is declared.\n   *\n   * @example \"Project README\"\n   * @example \"User Profile\"\n   */\n  name?: string;\n\n  /**\n   * Description of what this resource contains.\n   *\n   * Helps the LLM understand the purpose and content of the resource.\n   *\n   * @example \"The main README file for the project\"\n   */\n  description?: string;\n\n  /**\n   * MIME type of the resource content.\n   *\n   * Helps clients understand how to interpret the content.\n   *\n   * @default \"text/plain\"\n   * @example \"text/markdown\"\n   * @example \"application/json\"\n   */\n  mimeType?: string;\n\n  /**\n   * Handler function that returns the resource content.\n   *\n   * Called when the resource is read. Can return text or binary content.\n   *\n   * @returns Resource content with either `text` or `blob` property\n   */\n  handler: ResourceHandler;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the resource.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the URI of the resource.\n   */\n  public get uri(): string {\n    return this.options.uri;\n  }\n\n  /**\n   * Returns the description of the resource.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  /**\n   * Returns the MIME type of the resource.\n   */\n  public get mimeType(): string {\n    return this.options.mimeType ?? \"text/plain\";\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerResource(this);\n  }\n\n  /**\n   * Read the resource content.\n   *\n   * @param context - Optional context from the transport layer\n   * @returns The resource content\n   */\n  public async read(context?: McpContext): Promise<ResourceContent> {\n    return this.options.handler({ context });\n  }\n\n  /**\n   * Convert the resource to an MCP resource descriptor for protocol messages.\n   */\n  public toDescriptor(): McpResourceDescriptor {\n    return {\n      uri: this.uri,\n      name: this.name,\n      description: this.description,\n      mimeType: this.mimeType,\n    };\n  }\n}\n\n$resource[KIND] = ResourcePrimitive;\n","import {\n  $inject,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport type {\n  McpContext,\n  McpJsonSchema,\n  McpToolDescriptor,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  ToolPrimitiveSchema,\n} from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Creates an MCP tool primitive for defining callable functions.\n *\n * Tools are the primary way for LLMs to interact with external systems through MCP.\n * Each tool has a name, description, typed parameters, and a handler function.\n *\n * **Key Features**\n * - Full TypeScript inference for parameters and results\n * - Automatic schema validation using TypeBox\n * - JSON Schema generation for MCP protocol\n * - Integration with MCP server provider\n *\n * @example\n * ```ts\n * class CalculatorTools {\n *   add = $tool({\n *     description: \"Add two numbers together\",\n *     schema: {\n *       params: t.object({\n *         a: t.number(),\n *         b: t.number(),\n *       }),\n *       result: t.number(),\n *     },\n *     handler: async ({ params }) => {\n *       return params.a + params.b;\n *     },\n *   });\n *\n *   greet = $tool({\n *     description: \"Generate a greeting message\",\n *     schema: {\n *       params: t.object({\n *         name: t.text(),\n *       }),\n *       result: t.text(),\n *     },\n *     handler: async ({ params }) => {\n *       return `Hello, ${params.name}!`;\n *     },\n *   });\n * }\n * ```\n */\nexport const $tool = <T extends ToolPrimitiveSchema>(\n  options: ToolPrimitiveOptions<T>,\n): ToolPrimitive<T> => {\n  return createPrimitive(ToolPrimitive<T>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ToolPrimitiveOptions<T extends ToolPrimitiveSchema> {\n  /**\n   * The name of the tool.\n   *\n   * If not provided, defaults to the property key where the tool is declared.\n   * Names should be descriptive and use kebab-case or snake_case.\n   *\n   * @example \"calculate-sum\"\n   * @example \"get_weather\"\n   */\n  name?: string;\n\n  /**\n   * A human-readable description of what the tool does.\n   *\n   * This description is sent to the LLM to help it understand\n   * when and how to use the tool. Be clear and specific.\n   *\n   * @example \"Calculate the sum of two numbers\"\n   * @example \"Retrieve current weather data for a given location\"\n   */\n  description: string;\n\n  /**\n   * TypeBox schema defining the tool's parameters and result type.\n   *\n   * - **params**: TObject schema for input parameters (optional)\n   * - **result**: TSchema for the return value (optional)\n   *\n   * Schemas provide:\n   * - Type inference for handler function\n   * - Runtime validation of inputs\n   * - JSON Schema generation for MCP protocol\n   */\n  schema?: T;\n\n  /**\n   * The handler function that executes when the tool is called.\n   *\n   * Receives validated parameters and returns the result.\n   * Errors thrown here are caught and returned as MCP errors.\n   *\n   * @param args - Object containing validated params\n   * @returns The tool result (can be async)\n   */\n  handler: (args: ToolHandlerArgs<T>) => Async<ToolHandlerResult<T>>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ToolPrimitive<T extends ToolPrimitiveSchema> extends Primitive<\n  ToolPrimitiveOptions<T>\n> {\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * Returns the name of the tool.\n   */\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Returns the description of the tool.\n   */\n  public get description(): string {\n    return this.options.description;\n  }\n\n  protected onInit(): void {\n    this.mcpServer.registerTool(this);\n  }\n\n  /**\n   * Execute the tool with the given parameters.\n   *\n   * @param params - Raw parameters to validate and pass to the handler\n   * @param context - Optional context from the transport layer\n   * @returns The tool result\n   */\n  public async execute(\n    params: unknown,\n    context?: McpContext,\n  ): Promise<ToolHandlerResult<T>> {\n    let validatedParams: any = params ?? {};\n\n    // Validate params using alepha.codec if schema provided\n    if (this.options.schema?.params) {\n      validatedParams = this.alepha.codec.decode(\n        this.options.schema.params,\n        validatedParams,\n      );\n    }\n\n    const result = await this.options.handler({\n      params: validatedParams,\n      context,\n    });\n\n    // Validate and encode result if schema provided\n    if (this.options.schema?.result && result !== undefined) {\n      return this.alepha.codec.encode(\n        this.options.schema.result,\n        result,\n      ) as ToolHandlerResult<T>;\n    }\n\n    return result as ToolHandlerResult<T>;\n  }\n\n  /**\n   * Convert the tool to an MCP tool descriptor for protocol messages.\n   */\n  public toDescriptor(): McpToolDescriptor {\n    return {\n      name: this.name,\n      description: this.description,\n      inputSchema: this.options.schema?.params\n        ? this.schemaToJsonSchema(this.options.schema.params)\n        : { type: \"object\", properties: {}, required: [] },\n    };\n  }\n\n  /**\n   * Convert a TypeBox schema to JSON Schema format.\n   */\n  protected schemaToJsonSchema(schema: TObject): McpJsonSchema {\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      properties[key] = this.propertyToJsonSchema(propSchema as TSchema);\n\n      // Check if property is required (not optional)\n      if (!t.schema.isOptional(propSchema as TSchema)) {\n        required.push(key);\n      }\n    }\n\n    return {\n      type: \"object\",\n      properties,\n      required,\n    };\n  }\n\n  /**\n   * Convert a single property schema to JSON Schema format.\n   */\n  protected propertyToJsonSchema(schema: TSchema): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    // Check for description on all types\n    if (\"description\" in schema) {\n      result.description = schema.description;\n    }\n\n    if (t.schema.isString(schema)) {\n      result.type = \"string\";\n      if (\"minLength\" in schema) result.minLength = schema.minLength;\n      if (\"maxLength\" in schema) result.maxLength = schema.maxLength;\n      if (\"pattern\" in schema) result.pattern = schema.pattern;\n      if (\"enum\" in schema) result.enum = schema.enum;\n    } else if (t.schema.isNumber(schema)) {\n      result.type = \"number\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isInteger(schema)) {\n      result.type = \"integer\";\n      if (\"minimum\" in schema) result.minimum = schema.minimum;\n      if (\"maximum\" in schema) result.maximum = schema.maximum;\n    } else if (t.schema.isBoolean(schema)) {\n      result.type = \"boolean\";\n    } else if (t.schema.isArray(schema)) {\n      result.type = \"array\";\n      if (\"items\" in schema) {\n        result.items = this.propertyToJsonSchema(schema.items as TSchema);\n      }\n    } else if (t.schema.isObject(schema)) {\n      Object.assign(result, this.schemaToJsonSchema(schema));\n    } else if (t.schema.isUnsafe(schema) || t.schema.isOptional(schema)) {\n      // Handle Unsafe types (like t.enum) and optional wrappers by checking the underlying type property\n      const schemaAny = schema as { type?: string; enum?: unknown[] };\n      if (schemaAny.type === \"string\") {\n        result.type = \"string\";\n        if (\"enum\" in schema) result.enum = schema.enum;\n        if (\"pattern\" in schema) result.pattern = schema.pattern;\n      } else if (schemaAny.type === \"number\") {\n        result.type = \"number\";\n      } else if (schemaAny.type === \"integer\") {\n        result.type = \"integer\";\n      } else if (schemaAny.type === \"boolean\") {\n        result.type = \"boolean\";\n      } else if (schemaAny.type === \"array\") {\n        result.type = \"array\";\n      } else if (schemaAny.type === \"object\") {\n        result.type = \"object\";\n      } else {\n        // Fallback\n        result.type = \"string\";\n      }\n    } else {\n      // Fallback for other types\n      result.type = \"string\";\n    }\n\n    return result;\n  }\n}\n\n$tool[KIND] = ToolPrimitive;\n","import { $env, $inject, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $route } from \"alepha/server\";\nimport {\n  createErrorResponse,\n  createNotification,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport type { McpContext } from \"../interfaces/McpTypes.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  MCP_SSE_PATH: t.text({\n    description: \"Path for MCP SSE endpoint\",\n    default: \"/mcp\",\n  }),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SSE (Server-Sent Events) transport for MCP communication.\n *\n * This transport uses HTTP with SSE for server-to-client messages\n * and POST requests for client-to-server messages.\n *\n * Endpoints:\n * - GET /mcp - SSE stream for server events\n * - POST /mcp - JSON-RPC request endpoint\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaServer } from \"alepha/server\";\n * import { AlephaMcp, AlephaMcpSse } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaServer)\n *     .with(AlephaMcp)\n *     .with(AlephaMcpSse)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class SseMcpTransport {\n  protected readonly log = $logger();\n  protected readonly env = $env(envSchema);\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  /**\n   * SSE endpoint for server-to-client messages.\n   *\n   * Returns a text/event-stream response with server capabilities\n   * and keeps the connection open for notifications.\n   */\n  sse = $route({\n    method: \"GET\",\n    path: this.env.MCP_SSE_PATH,\n    handler: async (request) => {\n      this.log.debug(\"MCP SSE connection established\");\n\n      const encoder = new TextEncoder();\n\n      // Create SSE stream\n      const stream = new ReadableStream({\n        start: (controller) => {\n          // Send initial endpoint info\n          const endpointEvent = this.formatSseEvent(\n            \"endpoint\",\n            `${this.env.MCP_SSE_PATH}`,\n          );\n          controller.enqueue(encoder.encode(endpointEvent));\n\n          // Send capabilities notification\n          const capabilitiesNotification = createNotification(\n            \"notifications/capabilities\",\n            { capabilities: this.mcpServer.getCapabilities() },\n          );\n          const capabilitiesEvent = this.formatSseEvent(\n            \"message\",\n            JSON.stringify(capabilitiesNotification),\n          );\n          controller.enqueue(encoder.encode(capabilitiesEvent));\n        },\n        cancel: () => {\n          this.log.debug(\"MCP SSE connection closed\");\n        },\n      });\n\n      request.reply.status = 200;\n      request.reply.headers = {\n        \"content-type\": \"text/event-stream\",\n        \"cache-control\": \"no-cache\",\n        connection: \"keep-alive\",\n      };\n      request.reply.body = stream;\n    },\n  });\n\n  /**\n   * POST endpoint for client-to-server JSON-RPC messages.\n   */\n  message = $route({\n    method: \"POST\",\n    path: this.env.MCP_SSE_PATH,\n    secure: false,\n    schema: {\n      body: t.json(),\n    },\n    handler: async (request) => {\n      try {\n        const body =\n          typeof request.body === \"string\"\n            ? request.body\n            : JSON.stringify(request.body);\n\n        this.log.debug(\"MCP request body\", {\n          body,\n          bodyType: typeof request.body,\n        });\n\n        const rpcRequest = parseMessage(body);\n\n        // Build context from request headers\n        const context: McpContext = {\n          headers: request.headers as Record<\n            string,\n            string | string[] | undefined\n          >,\n        };\n\n        const response = await this.mcpServer.handleMessage(\n          rpcRequest,\n          context,\n        );\n\n        request.reply.headers[\"content-type\"] = \"application/json\";\n        request.reply.body = response ? JSON.stringify(response) : \"\";\n      } catch (error) {\n        if (error instanceof JsonRpcParseError) {\n          request.reply.status = 400;\n          request.reply.headers[\"content-type\"] = \"application/json\";\n          request.reply.body = JSON.stringify(\n            createErrorResponse(0, createParseError(error.message)),\n          );\n        } else {\n          this.log.error(\"Failed to process MCP message\", error);\n          request.reply.status = 500;\n          request.reply.body = JSON.stringify({\n            error: (error as Error).message,\n          });\n        }\n      }\n    },\n  });\n\n  /**\n   * Format a message as an SSE event.\n   */\n  protected formatSseEvent(event: string, data: string): string {\n    return `event: ${event}\\ndata: ${data}\\n\\n`;\n  }\n}\n","import * as readline from \"node:readline\";\nimport { $hook, $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport {\n  createErrorResponse,\n  createParseError,\n  JsonRpcParseError,\n  parseMessage,\n} from \"../helpers/jsonrpc.ts\";\nimport { McpServerProvider } from \"../providers/McpServerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Stdio transport for MCP communication.\n *\n * This transport uses stdin/stdout for JSON-RPC message exchange,\n * which is the standard transport for local MCP servers.\n *\n * Messages are newline-delimited JSON objects.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaMcp, AlephaMcpStdio } from \"alepha/mcp\";\n *\n * class MyTools {\n *   // ... tool definitions\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaMcp)\n *     .with(AlephaMcpStdio)\n *     .with(MyTools)\n * );\n * ```\n */\nexport class StdioMcpTransport {\n  protected readonly log = $logger();\n  protected readonly mcpServer = $inject(McpServerProvider);\n\n  protected rl?: readline.Interface;\n  protected started = false;\n\n  onStart = $hook({\n    on: \"start\",\n    handler: () => this.start(),\n  });\n\n  onStop = $hook({\n    on: \"stop\",\n    handler: () => this.stop(),\n  });\n\n  /**\n   * Start the stdio transport.\n   */\n  protected start(): void {\n    if (this.started) return;\n    this.started = true;\n\n    this.rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout,\n      terminal: false,\n    });\n\n    this.rl.on(\"line\", (line) => this.handleLine(line));\n    this.rl.on(\"close\", () => this.handleClose());\n\n    this.log.info(\"MCP stdio transport started\");\n  }\n\n  /**\n   * Stop the stdio transport.\n   */\n  protected stop(): void {\n    if (!this.started) return;\n    this.started = false;\n\n    this.rl?.close();\n    this.rl = undefined;\n\n    this.log.info(\"MCP stdio transport stopped\");\n  }\n\n  /**\n   * Handle an incoming line from stdin.\n   */\n  protected async handleLine(line: string): Promise<void> {\n    // Skip empty lines\n    if (!line.trim()) return;\n\n    try {\n      const request = parseMessage(line);\n      const response = await this.mcpServer.handleMessage(request);\n\n      if (response) {\n        this.send(response);\n      }\n    } catch (error) {\n      if (error instanceof JsonRpcParseError) {\n        // Send parse error response\n        this.send(createErrorResponse(0, createParseError(error.message)));\n      } else {\n        this.log.error(\"Failed to process MCP message\", error);\n      }\n    }\n  }\n\n  /**\n   * Handle stdin close event.\n   */\n  protected handleClose(): void {\n    this.log.debug(\"MCP stdio input closed\");\n  }\n\n  /**\n   * Send a message to stdout.\n   */\n  protected send(message: object): void {\n    const json = JSON.stringify(message);\n    process.stdout.write(json + \"\\n\");\n  }\n}\n","import { $module } from \"alepha\";\nimport { $prompt } from \"./primitives/$prompt.ts\";\nimport { $resource } from \"./primitives/$resource.ts\";\nimport { $tool } from \"./primitives/$tool.ts\";\nimport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nimport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nimport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport {\n  McpError,\n  McpInvalidParamsError,\n  McpMethodNotFoundError,\n  McpPromptNotFoundError,\n  McpResourceNotFoundError,\n  McpToolNotFoundError,\n} from \"./errors/McpError.ts\";\nexport {\n  createErrorResponse,\n  createInternalError,\n  createInvalidParamsError,\n  createInvalidRequestError,\n  createMethodNotFoundError,\n  createNotification,\n  createParseError,\n  createResponse,\n  isNotification,\n  isValidJsonRpcRequest,\n  JSONRPC_VERSION,\n  JsonRpcErrorCodes,\n  JsonRpcParseError,\n  MCP_PROTOCOL_VERSION,\n  parseMessage,\n} from \"./helpers/jsonrpc.ts\";\nexport type {\n  JsonRpcError,\n  JsonRpcNotification,\n  // JSON-RPC types\n  JsonRpcRequest,\n  JsonRpcResponse,\n  // MCP protocol types\n  McpCapabilities,\n  McpClientInfo,\n  McpContent,\n  // Context type for auth/headers\n  McpContext,\n  McpInitializeParams,\n  McpInitializeResult,\n  McpJsonSchema,\n  McpPromptArgument,\n  McpPromptContent,\n  // Prompt types\n  McpPromptDescriptor,\n  McpPromptGetParams,\n  McpPromptGetResult,\n  McpPromptMessage,\n  McpResourceContent,\n  // Resource types\n  McpResourceDescriptor,\n  McpResourceReadParams,\n  McpResourceReadResult,\n  McpServerInfo,\n  McpToolCallParams,\n  McpToolCallResult,\n  // Tool types\n  McpToolDescriptor,\n  PromptHandler,\n  PromptHandlerArgs,\n  PromptMessage,\n  ResourceContent,\n  ResourceHandler,\n  ResourceHandlerArgs,\n  ToolHandler,\n  ToolHandlerArgs,\n  ToolHandlerResult,\n  // Handler types\n  ToolPrimitiveSchema,\n} from \"./interfaces/McpTypes.ts\";\nexport type { PromptPrimitiveOptions } from \"./primitives/$prompt.ts\";\nexport { $prompt, PromptPrimitive } from \"./primitives/$prompt.ts\";\nexport type { ResourcePrimitiveOptions } from \"./primitives/$resource.ts\";\nexport { $resource, ResourcePrimitive } from \"./primitives/$resource.ts\";\nexport type { ToolPrimitiveOptions } from \"./primitives/$tool.ts\";\nexport { $tool, ToolPrimitive } from \"./primitives/$tool.ts\";\nexport { McpServerProvider } from \"./providers/McpServerProvider.ts\";\nexport { SseMcpTransport } from \"./transports/SseMcpTransport.ts\";\nexport { StdioMcpTransport } from \"./transports/StdioMcpTransport.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Core MCP module with primitives and server provider.\n *\n * This module registers the $tool, $resource, and $prompt primitives\n * and the McpServerProvider. You need to add a transport module\n * (AlephaMcpStdio or AlephaMcpSse) for actual communication.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n * import { AlephaMcp, AlephaMcpStdio, $tool, t } from \"alepha/mcp\";\n *\n * class MyMcpServer {\n *   add = $tool({\n *     description: \"Add two numbers\",\n *     schema: {\n *       params: t.object({ a: t.number(), b: t.number() }),\n *       result: t.number(),\n *     },\n *     handler: async ({ params }) => params.a + params.b,\n *   });\n * }\n *\n * run(\n *   Alepha.create()\n *     .with(AlephaMcp)\n *     .with(AlephaMcpStdio)\n *     .with(MyMcpServer)\n * );\n * ```\n *\n * @module alepha.mcp\n */\nexport const AlephaMcp = $module({\n  name: \"alepha.mcp\",\n  primitives: [$tool, $resource, $prompt],\n  services: [McpServerProvider, SseMcpTransport, StdioMcpTransport],\n  register: (alepha) => {\n    alepha.with(McpServerProvider);\n  },\n});\n"],"mappings":"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"}

package/dist/orm/index.browser.js

@@ -476,8 +476,8 @@ var EntityPrimitive = class EntityPrimitive {
 $entity[KIND] = EntityPrimitive;
 
 //#endregion
-//#region ../../src/orm/providers/PostgresTypeProvider.ts
-var PostgresTypeProvider = class {
+//#region ../../src/orm/providers/DatabaseTypeProvider.ts
+var DatabaseTypeProvider = class {
 	attr = pgAttr;
 	/**
 	* Creates a primary key with an identity column.
@@ -560,13 +560,34 @@ var PostgresTypeProvider = class {
 	};
 	/**
 	* Creates a page schema for a given object schema.
-	* It's used by {@link RepositoryPrimitive#paginate} method.
+	* It's used by {@link Repository#paginate} method.
 	*/
 	page = (resource, options) => {
 		return pageSchema$1(resource, options);
 	};
 };
-const pg = new PostgresTypeProvider();
+/**
+* Wrapper of TypeProvider (`t`) for database types.
+*
+* Use `db` for improve TypeBox schema definitions with database-specific attributes.
+*
+* @example
+* ```ts
+* import { t } from "alepha";
+* import { db } from "alepha/orm";
+*
+* const userSchema = t.object({
+*   id: db.primaryKey(t.uuid()),
+*   email: t.email(),
+*   createdAt: db.createdAt(),
+* });
+* ```
+*/
+const db = new DatabaseTypeProvider();
+/**
+* @deprecated Use `db` instead.
+*/
+const pg = db;
 
 //#endregion
 //#region ../../src/orm/schemas/legacyIdSchema.ts
@@ -584,5 +605,5 @@ const AlephaPostgres = $module({
 });
 
 //#endregion
-export { $entity, AlephaPostgres, DbEntityNotFoundError, EntityPrimitive, PostgresTypeProvider, buildQueryString, getAttrFields, legacyIdSchema, pageQuerySchema, pageSchema, parseQueryString, pg, pgAttr };
+export { $entity, AlephaPostgres, DatabaseTypeProvider, DbEntityNotFoundError, EntityPrimitive, buildQueryString, db, getAttrFields, legacyIdSchema, pageQuerySchema, pageSchema, parseQueryString, pg, pgAttr };
 //# sourceMappingURL=index.browser.js.map

package/dist/orm/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":["path: string[]","values: any[]","filterOp: any","result: any","parts","parts: string[]","fields: Array<PgAttrField>","schema","newProperties: Record<string, any>","newProperties: Record<string, any>","schema","cols: Partial<EntityColumns<T>>","pageSchema"],"sources":["../../src/orm/errors/DbError.ts","../../src/orm/errors/DbEntityNotFoundError.ts","../../src/orm/helpers/parseQueryString.ts","../../src/orm/helpers/pgAttr.ts","../../src/orm/constants/PG_SYMBOLS.ts","../../src/orm/types/schema.ts","../../src/orm/schemas/insertSchema.ts","../../src/orm/schemas/updateSchema.ts","../../src/orm/primitives/$entity.ts","../../src/orm/providers/PostgresTypeProvider.ts","../../src/orm/schemas/legacyIdSchema.ts","../../src/orm/index.browser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class DbError extends AlephaError {\n  name = \"DbError\";\n\n  constructor(message: string, cause?: unknown) {\n    super(message, { cause });\n  }\n}\n","import { DbError } from \"./DbError.ts\";\n\nexport class DbEntityNotFoundError extends DbError {\n  readonly name = \"DbEntityNotFoundError\";\n  readonly status = 404;\n\n  constructor(entityName: string) {\n    super(`Entity from '${entityName}' was not found`);\n  }\n}\n","import { AlephaError, type TObject } from \"alepha\";\nimport type { PgQueryWhere } from \"../interfaces/PgQueryWhere.ts\";\n\n/**\n * Parse a string query into a PgQueryWhere object.\n *\n * Supported syntax:\n * - Simple equality: \"name=John\"\n * - Wildcard patterns: \"name=John*\" (startsWith), \"name=*John\" (endsWith), \"name=*John*\" (contains)\n * - Operators: \"age>18\", \"age>=18\", \"age<65\", \"age<=65\", \"status!=active\"\n * - NULL checks: \"deletedAt=null\", \"email!=null\"\n * - IN arrays: \"status=[pending,active]\"\n * - AND conditions: \"name=John&age>18\"\n * - OR conditions: \"name=John|email=john@example.com\"\n * - Nested AND/OR: \"(name=John|name=Jane)&age>18\"\n * - JSONB nested: \"profile.city=Paris\"\n *\n * @example\n * ```ts\n * // Simple equality\n * parseQueryString(\"name=John\")\n * // => { name: { eq: \"John\" } }\n *\n * // Wildcard patterns\n * parseQueryString(\"name=John*\")  // startsWith\n * // => { name: { startsWith: \"John\" } }\n * parseQueryString(\"name=*Smith\")  // endsWith\n * // => { name: { endsWith: \"Smith\" } }\n * parseQueryString(\"name=*oh*\")  // contains\n * // => { name: { contains: \"oh\" } }\n *\n * // Multiple conditions\n * parseQueryString(\"name=John&age>18\")\n * // => { and: [{ name: { eq: \"John\" } }, { age: { gt: 18 } }] }\n *\n * // OR conditions\n * parseQueryString(\"status=active|status=pending\")\n * // => { or: [{ status: { eq: \"active\" } }, { status: { eq: \"pending\" } }] }\n *\n * // Complex nested\n * parseQueryString(\"(name=John|name=Jane)&age>18&status!=archived\")\n * // => { and: [\n * //      { or: [{ name: { eq: \"John\" } }, { name: { eq: \"Jane\" } }] },\n * //      { age: { gt: 18 } },\n * //      { status: { ne: \"archived\" } }\n * //    ] }\n *\n * // JSONB nested query\n * parseQueryString(\"profile.city=Paris&profile.age>25\")\n * // => { profile: { city: { eq: \"Paris\" }, age: { gt: 25 } } }\n * ```\n */\nexport function parseQueryString<T extends TObject>(\n  query: string,\n): PgQueryWhere<T> {\n  if (!query || query.trim() === \"\") {\n    return {};\n  }\n\n  const parser = new QueryStringParser(query);\n  return parser.parse() as PgQueryWhere<T>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nclass QueryStringParser {\n  private pos = 0;\n  private readonly query: string;\n\n  constructor(query: string) {\n    this.query = query.trim();\n  }\n\n  parse(): PgQueryWhere<any> {\n    return this.parseExpression();\n  }\n\n  private parseExpression(): PgQueryWhere<any> {\n    return this.parseOr();\n  }\n\n  private parseOr(): any {\n    const left = this.parseAnd();\n\n    // Check for OR operator (|)\n    if (this.peek() === \"|\") {\n      const conditions = [left];\n\n      while (this.peek() === \"|\") {\n        this.consume(\"|\");\n        conditions.push(this.parseAnd());\n      }\n\n      return { or: conditions };\n    }\n\n    return left;\n  }\n\n  private parseAnd(): any {\n    const left = this.parsePrimary();\n\n    // Check for AND operator (&)\n    if (this.peek() === \"&\") {\n      const conditions = [left];\n\n      while (this.peek() === \"&\") {\n        this.consume(\"&\");\n        conditions.push(this.parsePrimary());\n      }\n\n      return { and: conditions };\n    }\n\n    return left;\n  }\n\n  private parsePrimary(): any {\n    this.skipWhitespace();\n\n    // Handle parentheses\n    if (this.peek() === \"(\") {\n      this.consume(\"(\");\n      const expr = this.parseExpression();\n      this.consume(\")\");\n      return expr;\n    }\n\n    // Parse field condition\n    return this.parseCondition();\n  }\n\n  private parseCondition(): any {\n    const field = this.parseFieldPath();\n    this.skipWhitespace();\n\n    // Get operator\n    const operator = this.parseOperator();\n    this.skipWhitespace();\n\n    // Get value\n    const value = this.parseValue();\n\n    if (value === \"\") {\n      throw new AlephaError(`Expected value for field '${field.join(\".\")}'`);\n    }\n\n    // Build the condition object\n    return this.buildCondition(field, operator, value);\n  }\n\n  private parseFieldPath(): string[] {\n    const path: string[] = [];\n    let current = \"\";\n\n    while (this.pos < this.query.length) {\n      const ch = this.query[this.pos];\n\n      if (ch === \".\" && current) {\n        path.push(current);\n        current = \"\";\n        this.pos++;\n        continue;\n      }\n\n      if (ch === \"=\" || ch === \"!\" || ch === \">\" || ch === \"<\" || ch === \" \") {\n        break;\n      }\n\n      current += ch;\n      this.pos++;\n    }\n\n    if (current) {\n      path.push(current);\n    }\n\n    return path;\n  }\n\n  private parseOperator(): string {\n    this.skipWhitespace();\n\n    const remaining = this.query.slice(this.pos);\n\n    // Two-character operators\n    if (remaining.startsWith(\">=\")) {\n      this.pos += 2;\n      return \">=\";\n    }\n    if (remaining.startsWith(\"<=\")) {\n      this.pos += 2;\n      return \"<=\";\n    }\n    if (remaining.startsWith(\"!=\")) {\n      this.pos += 2;\n      return \"!=\";\n    }\n\n    // Single-character operators\n    const ch = this.query[this.pos];\n    if (ch === \"=\" || ch === \">\" || ch === \"<\") {\n      this.pos++;\n      return ch;\n    }\n\n    throw new Error(`Expected operator at position ${this.pos}`);\n  }\n\n  private parseValue(): any {\n    this.skipWhitespace();\n\n    // Handle null\n    if (this.query.slice(this.pos, this.pos + 4).toLowerCase() === \"null\") {\n      this.pos += 4;\n      return null;\n    }\n\n    // Handle arrays [value1,value2,...]\n    if (this.query[this.pos] === \"[\") {\n      return this.parseArray();\n    }\n\n    // Handle quoted strings\n    if (this.query[this.pos] === '\"' || this.query[this.pos] === \"'\") {\n      return this.parseQuotedString();\n    }\n\n    // Parse unquoted value (until &, |, or ))\n    let value = \"\";\n    while (this.pos < this.query.length) {\n      const ch = this.query[this.pos];\n      if (ch === \"&\" || ch === \"|\" || ch === \")\") {\n        break;\n      }\n      value += ch;\n      this.pos++;\n    }\n\n    return this.coerceValue(value.trim());\n  }\n\n  private parseArray(): any[] {\n    this.consume(\"[\");\n    const values: any[] = [];\n\n    while (this.pos < this.query.length && this.query[this.pos] !== \"]\") {\n      this.skipWhitespace();\n\n      // Handle quoted values\n      if (this.query[this.pos] === '\"' || this.query[this.pos] === \"'\") {\n        values.push(this.parseQuotedString());\n      } else {\n        // Parse until comma or ]\n        let value = \"\";\n        while (\n          this.pos < this.query.length &&\n          this.query[this.pos] !== \",\" &&\n          this.query[this.pos] !== \"]\"\n        ) {\n          value += this.query[this.pos];\n          this.pos++;\n        }\n        values.push(this.coerceValue(value.trim()));\n      }\n\n      this.skipWhitespace();\n      if (this.query[this.pos] === \",\") {\n        this.pos++;\n      }\n    }\n\n    this.consume(\"]\");\n    return values;\n  }\n\n  private parseQuotedString(): string {\n    const quote = this.query[this.pos];\n    this.pos++; // Skip opening quote\n\n    let value = \"\";\n    let escaped = false;\n\n    while (this.pos < this.query.length) {\n      const ch = this.query[this.pos];\n\n      if (escaped) {\n        value += ch;\n        escaped = false;\n        this.pos++;\n        continue;\n      }\n\n      if (ch === \"\\\\\") {\n        escaped = true;\n        this.pos++;\n        continue;\n      }\n\n      if (ch === quote) {\n        this.pos++; // Skip closing quote\n        break;\n      }\n\n      value += ch;\n      this.pos++;\n    }\n\n    return value;\n  }\n\n  private coerceValue(value: string): any {\n    // Try to parse as number\n    if (/^-?\\d+$/.test(value)) {\n      return parseInt(value, 10);\n    }\n\n    if (/^-?\\d+\\.\\d+$/.test(value)) {\n      return parseFloat(value);\n    }\n\n    // Try to parse as boolean\n    if (value.toLowerCase() === \"true\") {\n      return true;\n    }\n    if (value.toLowerCase() === \"false\") {\n      return false;\n    }\n\n    return value;\n  }\n\n  private buildCondition(path: string[], operator: string, value: any): any {\n    // Map operator to filter operator\n    let filterOp: any;\n\n    if (operator === \"=\") {\n      if (value === null) {\n        filterOp = { isNull: true };\n      } else if (Array.isArray(value)) {\n        // Arrays should be treated as inArray regardless of content\n        filterOp = { inArray: value };\n      } else if (typeof value === \"string\" && value.includes(\"*\")) {\n        // Handle wildcard patterns\n        const startsWithAsterisk = value.startsWith(\"*\");\n        const endsWithAsterisk = value.endsWith(\"*\");\n        const cleanValue = value.replace(/^\\*|\\*$/g, \"\"); // Remove leading/trailing asterisks\n\n        if (startsWithAsterisk && endsWithAsterisk) {\n          // *text* -> contains\n          filterOp = { contains: cleanValue };\n        } else if (startsWithAsterisk) {\n          // *text -> endsWith\n          filterOp = { endsWith: cleanValue };\n        } else if (endsWithAsterisk) {\n          // text* -> startsWith\n          filterOp = { startsWith: cleanValue };\n        } else {\n          // Has asterisk in the middle, treat as literal\n          filterOp = { eq: value };\n        }\n      } else {\n        filterOp = { eq: value };\n      }\n    } else if (operator === \"!=\") {\n      if (value === null) {\n        filterOp = { isNotNull: true };\n      } else {\n        filterOp = { ne: value };\n      }\n    } else if (operator === \">\") {\n      filterOp = { gt: value };\n    } else if (operator === \">=\") {\n      filterOp = { gte: value };\n    } else if (operator === \"<\") {\n      filterOp = { lt: value };\n    } else if (operator === \"<=\") {\n      filterOp = { lte: value };\n    } else {\n      throw new Error(`Unsupported operator: ${operator}`);\n    }\n\n    // Build nested object for path\n    if (path.length === 1) {\n      return { [path[0]]: filterOp };\n    }\n\n    // Handle nested paths (JSONB)\n    let result: any = filterOp;\n    for (let i = path.length - 1; i >= 0; i--) {\n      result = { [path[i]]: result };\n    }\n\n    return result;\n  }\n\n  private peek(): string {\n    this.skipWhitespace();\n    return this.query[this.pos] || \"\";\n  }\n\n  private consume(expected: string): void {\n    this.skipWhitespace();\n    if (this.query[this.pos] !== expected) {\n      throw new Error(\n        `Expected '${expected}' at position ${this.pos}, got '${this.query[this.pos]}'`,\n      );\n    }\n    this.pos++;\n  }\n\n  private skipWhitespace(): void {\n    while (this.pos < this.query.length && /\\s/.test(this.query[this.pos])) {\n      this.pos++;\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Helper function to build query strings programmatically\n *\n * @example\n * ```ts\n * buildQueryString({\n *   and: [\n *     { name: \"eq:John\" },\n *     { age: \"gt:18\" }\n *   ]\n * })\n * // => \"name=John&age>18\"\n * ```\n */\nexport function buildQueryString(where: any): string {\n  if (!where || typeof where !== \"object\") {\n    return \"\";\n  }\n\n  // Handle logical operators\n  if (\"and\" in where && Array.isArray(where.and)) {\n    return where.and.map((w: any) => buildQueryString(w)).join(\"&\");\n  }\n\n  if (\"or\" in where && Array.isArray(where.or)) {\n    const parts = where.or.map((w: any) => buildQueryString(w));\n    return parts.length > 1 ? `(${parts.join(\"|\")})` : parts[0];\n  }\n\n  if (\"not\" in where) {\n    // Not operator is harder to represent in string form\n    // For now, we'll skip it or you could add a syntax like \"!field=value\"\n    return \"\";\n  }\n\n  // Handle field conditions\n  const parts: string[] = [];\n\n  for (const [field, condition] of Object.entries(where)) {\n    if (typeof condition !== \"object\" || condition === null) {\n      parts.push(`${field}=${condition}`);\n      continue;\n    }\n\n    if (\"eq\" in condition) {\n      parts.push(`${field}=${condition.eq}`);\n    } else if (\"ne\" in condition) {\n      parts.push(`${field}!=${condition.ne}`);\n    } else if (\"gt\" in condition) {\n      parts.push(`${field}>${condition.gt}`);\n    } else if (\"gte\" in condition) {\n      parts.push(`${field}>=${condition.gte}`);\n    } else if (\"lt\" in condition) {\n      parts.push(`${field}<${condition.lt}`);\n    } else if (\"lte\" in condition) {\n      parts.push(`${field}<=${condition.lte}`);\n    } else if (\"contains\" in condition) {\n      parts.push(`${field}=*${condition.contains}*`);\n    } else if (\"startsWith\" in condition) {\n      parts.push(`${field}=${condition.startsWith}*`);\n    } else if (\"endsWith\" in condition) {\n      parts.push(`${field}=*${condition.endsWith}`);\n    } else if (\"isNull\" in condition && condition.isNull) {\n      parts.push(`${field}=null`);\n    } else if (\"isNotNull\" in condition && condition.isNotNull) {\n      parts.push(`${field}!=null`);\n    } else if (\"inArray\" in condition && Array.isArray(condition.inArray)) {\n      const values = condition.inArray.map((v: any) =>\n        typeof v === \"string\" ? `\"${v}\"` : v,\n      );\n      parts.push(`${field}=[${values.join(\",\")}]`);\n    } else {\n      // Nested object (JSONB)\n      const nested = buildQueryString(condition);\n      if (nested) {\n        parts.push(`${field}.${nested}`);\n      }\n    }\n  }\n\n  return parts.join(\"&\");\n}\n","import type { TObject, TSchema } from \"alepha\";\nimport type { PgSymbolKeys, PgSymbols } from \"../constants/PG_SYMBOLS.ts\";\n\n/**\n * Decorates a typebox schema with a Postgres attribute.\n *\n * > It's just a fancy way to add Symbols to a field.\n *\n * @example\n * ```ts\n * import { t } from \"alepha\";\n * import { PG_UPDATED_AT } from \"../constants/PG_SYMBOLS\";\n *\n * export const updatedAtSchema = pgAttr(\n *   t.datetime(), PG_UPDATED_AT,\n * );\n * ```\n */\nexport const pgAttr = <T extends TSchema, Attr extends PgSymbolKeys>(\n  type: T,\n  attr: Attr,\n  value?: PgSymbols[Attr],\n): PgAttr<T, Attr> => {\n  Object.assign(type, { [attr]: value ?? {} });\n  return type as PgAttr<T, Attr>;\n};\n\n/**\n * Retrieves the fields of a schema that have a specific attribute.\n */\nexport const getAttrFields = (\n  schema: TObject,\n  name: PgSymbolKeys,\n): PgAttrField[] => {\n  const fields: Array<PgAttrField> = [];\n\n  for (const key of Object.keys(schema.properties)) {\n    const value = schema.properties[key];\n    if (name in value) {\n      fields.push({\n        type: value as TSchema,\n        key: key,\n        data: (value as any)[name],\n      });\n    }\n  }\n\n  return fields;\n};\n\n/**\n * Type representation.\n */\nexport type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & {\n  [K in TAttr]: PgSymbols[K];\n};\n\nexport interface PgAttrField {\n  key: string;\n  type: TSchema;\n  data: any;\n  nested?: any[];\n  one?: boolean;\n}\n","import type {\n  PgSequenceOptions,\n  UpdateDeleteAction,\n} from \"drizzle-orm/pg-core\";\nimport type { EntityPrimitive } from \"../primitives/$entity.ts\";\n\nexport const PG_DEFAULT = Symbol.for(\"Alepha.Postgres.Default\");\nexport const PG_PRIMARY_KEY = Symbol.for(\"Alepha.Postgres.PrimaryKey\");\nexport const PG_CREATED_AT = Symbol.for(\"Alepha.Postgres.CreatedAt\");\nexport const PG_UPDATED_AT = Symbol.for(\"Alepha.Postgres.UpdatedAt\");\nexport const PG_DELETED_AT = Symbol.for(\"Alepha.Postgres.DeletedAt\");\nexport const PG_VERSION = Symbol.for(\"Alepha.Postgres.Version\");\nexport const PG_IDENTITY = Symbol.for(\"Alepha.Postgres.Identity\");\nexport const PG_ENUM = Symbol.for(\"Alepha.Postgres.Enum\");\nexport const PG_REF = Symbol.for(\"Alepha.Postgres.Ref\");\n\n/**\n * @deprecated Use `PG_IDENTITY` instead.\n */\nexport const PG_SERIAL = Symbol.for(\"Alepha.Postgres.Serial\");\n\nexport type PgDefault = typeof PG_DEFAULT;\nexport type PgRef = typeof PG_REF;\nexport type PgPrimaryKey = typeof PG_PRIMARY_KEY;\n\nexport type PgSymbols = {\n  [PG_DEFAULT]: {};\n  [PG_PRIMARY_KEY]: {};\n  [PG_CREATED_AT]: {};\n  [PG_UPDATED_AT]: {};\n  [PG_DELETED_AT]: {};\n  [PG_VERSION]: {};\n  [PG_IDENTITY]: PgIdentityOptions;\n  [PG_REF]: PgRefOptions;\n  [PG_ENUM]: PgEnumOptions;\n\n  /**\n   * @deprecated Use `PG_IDENTITY` instead.\n   */\n  [PG_SERIAL]: {};\n};\n\nexport type PgSymbolKeys = keyof PgSymbols;\n\nexport type PgIdentityOptions = {\n  mode: \"always\" | \"byDefault\";\n} & PgSequenceOptions & {\n    name?: string;\n  };\n\nexport interface PgEnumOptions {\n  name?: string;\n  description?: string;\n}\n\nexport interface PgRefOptions {\n  ref: () => {\n    name: string;\n    entity: EntityPrimitive;\n  };\n  actions?: {\n    onUpdate?: UpdateDeleteAction;\n    onDelete?: UpdateDeleteAction;\n  };\n}\n","import type { Static, TSchema } from \"alepha\";\nimport { customType } from \"drizzle-orm/pg-core\";\n\n/**\n * Postgres schema type.\n */\nexport const schema = <TDocument extends TSchema>(\n  name: string,\n  document: TDocument,\n) =>\n  customType<{\n    data: Static<TDocument>;\n    driverData: string;\n    config: { document: TDocument };\n    configRequired: true;\n  }>({\n    dataType: () => \"jsonb\",\n    toDriver: (value) => JSON.stringify(value),\n    fromDriver: (value: TDocument | string) =>\n      value && typeof value === \"string\" ? JSON.parse(value) : value,\n  })(name, { document }).$type<Static<TDocument>>();\n","import type { TObject, TOptional } from \"alepha\";\nimport { t } from \"alepha\";\nimport { PG_DEFAULT } from \"../constants/PG_SYMBOLS.ts\";\nimport { schema } from \"../types/schema.ts\";\n\n/**\n * Transforms a TObject schema for insert operations.\n * All default properties at the root level are made optional.\n *\n * @example\n * Before: { name: string; age: number(default=0); }\n * After:  { name: string; age?: number; }\n */\nexport type TObjectInsert<T extends TObject> = TObject<{\n  [K in keyof T[\"properties\"]]: T[\"properties\"][K] extends\n    | { [PG_DEFAULT]: any }\n    | { \"~optional\": true }\n    ? TOptional<T[\"properties\"][K]>\n    : T[\"properties\"][K];\n}>;\n\nexport const insertSchema = <T extends TObject>(obj: T): TObjectInsert<T> => {\n  const newProperties: Record<string, any> = {};\n\n  for (const key in obj.properties) {\n    const prop = obj.properties[key];\n\n    if (PG_DEFAULT in prop) {\n      newProperties[key] = t.optional(prop);\n    } else {\n      newProperties[key] = prop;\n    }\n  }\n\n  return t.object(\n    newProperties,\n    \"options\" in schema && typeof schema.options === \"object\"\n      ? { ...schema.options }\n      : {},\n  ) as TObjectInsert<T>;\n};\n","import {\n  type TNull,\n  type TObject,\n  type TOptional,\n  type TUnion,\n  t,\n} from \"alepha\";\n\n/**\n * Transforms a TObject schema for update operations.\n * All optional properties at the root level are made nullable (i.e., `T | null`).\n * This allows an API endpoint to explicitly accept `null` to clear an optional field in the database.\n *\n * @example\n * Before: { name?: string; age: number; }\n * After:  { name?: string | null; age: number; }\n */\nexport type TObjectUpdate<T extends TObject> = TObject<{\n  [K in keyof T[\"properties\"]]: T[\"properties\"][K] extends TOptional<infer U>\n    ? TOptional<TUnion<[U, TNull]>>\n    : T[\"properties\"][K];\n}>;\n\nexport const updateSchema = <T extends TObject>(\n  schema: T,\n): TObjectUpdate<T> => {\n  const newProperties: Record<string, any> = {};\n\n  for (const key in schema.properties) {\n    const prop = schema.properties[key];\n    if (t.schema.isOptional(prop)) {\n      newProperties[key] = t.optional(t.union([prop, t.raw.Null()]));\n    } else {\n      newProperties[key] = prop;\n    }\n  }\n\n  return t.object(\n    newProperties,\n    \"options\" in schema && typeof schema.options === \"object\"\n      ? { ...schema.options }\n      : {},\n  ) as TObjectUpdate<T>;\n};\n","import { KIND, type Static, type TObject } from \"alepha\";\nimport type { BuildExtraConfigColumns, SQL } from \"drizzle-orm\";\nimport type {\n  PgColumn,\n  PgColumnBuilderBase,\n  PgTableExtraConfigValue,\n} from \"drizzle-orm/pg-core\";\nimport { insertSchema, type TObjectInsert } from \"../schemas/insertSchema.ts\";\nimport { type TObjectUpdate, updateSchema } from \"../schemas/updateSchema.ts\";\n\n/**\n * Creates a database entity primitive that defines table structure using TypeBox schemas.\n *\n * @example\n * ```ts\n * import { t } from \"alepha\";\n * import { $entity } from \"alepha/orm\";\n *\n * const userEntity = $entity({\n *   name: \"users\",\n *   schema: t.object({\n *     id: pg.primaryKey(),\n *     name: t.text(),\n *     email: t.email(),\n *   }),\n * });\n * ```\n */\nexport const $entity = <TSchema extends TObject>(\n  options: EntityPrimitiveOptions<TSchema>,\n): EntityPrimitive<TSchema> => {\n  return new EntityPrimitive<TSchema>(options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface EntityPrimitiveOptions<\n  T extends TObject,\n  Keys = keyof Static<T>,\n> {\n  /**\n   * The database table name that will be created for this entity.\n   * If not provided, name will be inferred from the $repository variable name.\n   */\n  name: string;\n\n  /**\n   * TypeBox schema defining the table structure and column types.\n   */\n  schema: T;\n\n  /**\n   * Database indexes to create for query optimization.\n   */\n  indexes?: (\n    | Keys\n    | {\n        /**\n         * Single column to index.\n         */\n        column: Keys;\n        /**\n         * Whether this should be a unique index (enforces uniqueness constraint).\n         */\n        unique?: boolean;\n        /**\n         * Custom name for the index. If not provided, generates name automatically.\n         */\n        name?: string;\n      }\n    | {\n        /**\n         * Multiple columns for composite index (order matters for query optimization).\n         */\n        columns: Keys[];\n        /**\n         * Whether this should be a unique index (enforces uniqueness constraint).\n         */\n        unique?: boolean;\n        /**\n         * Custom name for the index. If not provided, generates name automatically.\n         */\n        name?: string;\n      }\n  )[];\n\n  /**\n   * Foreign key constraints to maintain referential integrity.\n   */\n  foreignKeys?: Array<{\n    /**\n     * Optional name for the foreign key constraint.\n     */\n    name?: string;\n    /**\n     * Local columns that reference the foreign table.\n     */\n    columns: Array<keyof Static<T>>;\n    /**\n     * Referenced columns in the foreign table.\n     * Must be EntityColumn references from other entities.\n     */\n    foreignColumns: Array<() => EntityColumn<any>>;\n  }>;\n\n  /**\n   * Additional table constraints for data validation.\n   *\n   * Constraints enforce business rules at the database level, providing\n   * an additional layer of data integrity beyond application validation.\n   *\n   * **Constraint Types**:\n   * - **Unique constraints**: Prevent duplicate values across columns\n   * - **Check constraints**: Enforce custom validation rules with SQL expressions\n   *\n   * @example\n   * ```ts\n   * constraints: [\n   *   {\n   *     name: \"unique_user_email\",\n   *     columns: [\"email\"],\n   *     unique: true\n   *   },\n   *   {\n   *     name: \"valid_age_range\",\n   *     columns: [\"age\"],\n   *     check: sql`age >= 0 AND age <= 150`\n   *   },\n   *   {\n   *     name: \"unique_user_username_per_tenant\",\n   *     columns: [\"tenantId\", \"username\"],\n   *     unique: true\n   *   }\n   * ]\n   * ```\n   */\n  constraints?: Array<{\n    /**\n     * Columns involved in this constraint.\n     */\n    columns: Array<keyof Static<T>>;\n    /**\n     * Optional name for the constraint.\n     */\n    name?: string;\n    /**\n     * Whether this is a unique constraint.\n     */\n    unique?: boolean | {} /* options */;\n    /**\n     * SQL expression for check constraint validation.\n     */\n    check?: SQL;\n  }>;\n\n  /**\n   * Advanced Drizzle ORM configuration for complex table setups.\n   */\n  config?: (\n    self: BuildExtraConfigColumns<string, FromSchema<T>, \"pg\">,\n  ) => PgTableExtraConfigValue[];\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class EntityPrimitive<T extends TObject = TObject> {\n  public readonly options: EntityPrimitiveOptions<T>;\n\n  constructor(options: EntityPrimitiveOptions<T>) {\n    this.options = options;\n  }\n\n  alias(alias: string): this {\n    const aliased = new EntityPrimitive<T>(this.options);\n    return new Proxy(aliased, {\n      get(target, prop, receiver) {\n        if (prop === \"$alias\") {\n          return alias;\n        }\n        return Reflect.get(target, prop, receiver);\n      },\n    }) as this;\n  }\n\n  get cols(): EntityColumns<T> {\n    const cols: Partial<EntityColumns<T>> = {};\n    for (const key of Object.keys(this.schema.properties) as Array<\n      keyof T[\"properties\"]\n    >) {\n      cols[key] = {\n        name: key as string,\n        entity: this,\n      };\n    }\n\n    return cols as EntityColumns<T>;\n  }\n\n  get name(): string {\n    return this.options.name;\n  }\n\n  get schema(): T {\n    return this.options.schema;\n  }\n\n  get insertSchema(): TObjectInsert<T> {\n    return insertSchema(this.options.schema);\n  }\n\n  get updateSchema(): TObjectUpdate<T> {\n    return updateSchema(this.options.schema);\n  }\n}\n\n$entity[KIND] = EntityPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Convert a schema to columns.\n */\nexport type FromSchema<T extends TObject> = {\n  [key in keyof T[\"properties\"]]: PgColumnBuilderBase;\n};\n\nexport type SchemaToTableConfig<T extends TObject> = {\n  name: string;\n  schema: string | undefined;\n  columns: {\n    [key in keyof T[\"properties\"]]: PgColumn;\n  };\n  dialect: string;\n};\n\nexport type EntityColumn<T extends TObject> = {\n  name: string;\n  entity: EntityPrimitive<T>;\n};\n\nexport type EntityColumns<T extends TObject> = {\n  [key in keyof T[\"properties\"]]: EntityColumn<T>;\n};\n","import {\n  AlephaError,\n  pageSchema,\n  type Static,\n  type TBigInt,\n  type TInteger,\n  type TNumber,\n  type TNumberOptions,\n  type TObject,\n  type TObjectOptions,\n  type TPage,\n  type TSchema,\n  type TString,\n  type TStringOptions,\n  type TUnsafe,\n  t,\n} from \"alepha\";\nimport type { UpdateDeleteAction } from \"drizzle-orm/pg-core/foreign-keys\";\nimport {\n  PG_CREATED_AT,\n  PG_DEFAULT,\n  PG_DELETED_AT,\n  PG_ENUM,\n  PG_IDENTITY,\n  PG_PRIMARY_KEY,\n  PG_REF,\n  PG_UPDATED_AT,\n  PG_VERSION,\n  type PgDefault,\n  type PgEnumOptions,\n  type PgIdentityOptions,\n  type PgPrimaryKey,\n  type PgRef,\n} from \"../constants/PG_SYMBOLS.ts\";\nimport type { PgAttr } from \"../helpers/pgAttr.ts\";\nimport { pgAttr } from \"../helpers/pgAttr.ts\";\n\nexport class PostgresTypeProvider {\n  public readonly attr = pgAttr;\n\n  /**\n   * Creates a primary key with an identity column.\n   */\n  public readonly identityPrimaryKey = (\n    identity?: PgIdentityOptions,\n    options?: TNumberOptions,\n  ) =>\n    pgAttr(\n      pgAttr(pgAttr(t.integer(options), PG_PRIMARY_KEY), PG_IDENTITY, identity),\n      PG_DEFAULT,\n    );\n\n  /**\n   * Creates a primary key with a big identity column. (default)\n   */\n  public readonly bigIdentityPrimaryKey = (\n    identity?: PgIdentityOptions,\n    options?: TNumberOptions,\n  ) =>\n    pgAttr(\n      pgAttr(pgAttr(t.int64(options), PG_PRIMARY_KEY), PG_IDENTITY, identity),\n      PG_DEFAULT,\n    );\n\n  /**\n   * Creates a primary key with a UUID column.\n   */\n  public readonly uuidPrimaryKey = () =>\n    pgAttr(pgAttr(t.uuid(), PG_PRIMARY_KEY), PG_DEFAULT);\n\n  /**\n   * Creates a primary key for a given type. Supports:\n   * - `t.integer()` -> PG INT (default)\n   * - `t.bigint()` -> PG BIGINT\n   * - `t.uuid()` -> PG UUID\n   */\n  public primaryKey(): PgAttr<PgAttr<TInteger, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TString,\n    options?: TStringOptions,\n  ): PgAttr<PgAttr<TString, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TInteger,\n    options?: TNumberOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TInteger, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TNumber,\n    options?: TNumberOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TNumber, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TBigInt,\n    options?: TNumberOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TBigInt, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type?: TSchema,\n    options?: TNumberOptions | TStringOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TSchema, PgPrimaryKey>, PgDefault> {\n    if (!type || t.schema.isInteger(type)) {\n      return pgAttr(\n        pgAttr(\n          pgAttr(t.integer(options), PG_PRIMARY_KEY),\n          PG_IDENTITY,\n          identity,\n        ),\n        PG_DEFAULT,\n      );\n    }\n\n    if (t.schema.isString(type) && type.format === \"uuid\") {\n      return pgAttr(pgAttr(t.uuid(), PG_PRIMARY_KEY), PG_DEFAULT);\n    }\n\n    if (t.schema.isNumber(type) && type.format === \"int64\") {\n      return pgAttr(\n        pgAttr(\n          pgAttr(t.number(options), PG_PRIMARY_KEY),\n          PG_IDENTITY,\n          identity,\n        ),\n        PG_DEFAULT,\n      );\n    }\n\n    if (t.schema.isBigInt(type)) {\n      return pgAttr(\n        pgAttr(\n          pgAttr(t.bigint(options), PG_PRIMARY_KEY),\n          PG_IDENTITY,\n          identity,\n        ),\n        PG_DEFAULT,\n      );\n    }\n\n    throw new AlephaError(`Unsupported type for primary key: ${type}`);\n  }\n\n  /**\n   * Wrap a schema with \"default\" attribute.\n   * This is used to set a default value for a column in the database.\n   */\n  public readonly default = <T extends TSchema>(\n    type: T,\n    value?: Static<T>,\n  ): PgAttr<T, PgDefault> => {\n    if (value != null) {\n      Object.assign(type, { default: value });\n    }\n\n    return this.attr(type, PG_DEFAULT);\n  };\n\n  /**\n   * Creates a column 'version'.\n   *\n   * This is used to track the version of a row in the database.\n   *\n   * You can use it for optimistic concurrency control (OCC) with {@link RepositoryPrimitive#save}.\n   *\n   * @see {@link RepositoryPrimitive#save}\n   * @see {@link PgVersionMismatchError}\n   */\n  public readonly version = (options: TNumberOptions = {}) =>\n    this.default(pgAttr(t.integer(options), PG_VERSION), 0);\n\n  /**\n   * Creates a column Created At. So just a datetime column with a default value of the current timestamp.\n   */\n  public readonly createdAt = (options?: TStringOptions) =>\n    pgAttr(pgAttr(t.datetime(options), PG_CREATED_AT), PG_DEFAULT);\n\n  /**\n   * Creates a column Updated At. Like createdAt, but it is updated on every update of the row.\n   */\n  public readonly updatedAt = (options?: TStringOptions) =>\n    pgAttr(pgAttr(t.datetime(options), PG_UPDATED_AT), PG_DEFAULT);\n\n  /**\n   * Creates a column Deleted At for soft delete functionality.\n   * This is used to mark rows as deleted without actually removing them from the database.\n   * The column is nullable - NULL means not deleted, timestamp means deleted.\n   */\n  public readonly deletedAt = (options?: TStringOptions) =>\n    pgAttr(t.optional(t.datetime(options)), PG_DELETED_AT);\n\n  /**\n   * Creates a Postgres ENUM type.\n   *\n   * > By default, `t.enum()` is mapped to a TEXT column in Postgres.\n   * > Using this method, you can create a real ENUM type in the database.\n   *\n   * @example\n   * ```ts\n   * const statusEnum = pg.enum([\"pending\", \"active\", \"archived\"], { name: \"status_enum\" });\n   * ```\n   */\n  public readonly enum = <T extends string[]>(\n    values: [...T],\n    pgEnumOptions?: PgEnumOptions,\n    typeOptions?: TStringOptions,\n  ): PgAttr<TUnsafe<T[number]>, typeof PG_ENUM> => {\n    return pgAttr(\n      t.enum(values, {\n        description: pgEnumOptions?.description,\n        ...typeOptions,\n      }),\n      PG_ENUM,\n      pgEnumOptions,\n    );\n  };\n\n  /**\n   * Creates a reference to another table or schema. Basically a foreign key.\n   */\n  public readonly ref = <T extends TSchema>(\n    type: T,\n    ref: () => any,\n    actions?: {\n      onUpdate?: UpdateDeleteAction;\n      onDelete?: UpdateDeleteAction;\n    },\n  ): PgAttr<T, PgRef> => {\n    // If actions are not provided, set default onDelete based on type\n    const finalActions = actions ?? {\n      onDelete: t.schema.isOptional(type) ? \"set null\" : \"cascade\",\n    };\n\n    return this.attr(type, PG_REF, {\n      ref,\n      actions: finalActions,\n    });\n  };\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Creates a page schema for a given object schema.\n   * It's used by {@link RepositoryPrimitive#paginate} method.\n   */\n  public readonly page = <T extends TObject>(\n    resource: T,\n    options?: TObjectOptions,\n  ): TPage<T> => {\n    return pageSchema(resource, options);\n  };\n}\n\nexport const pg = new PostgresTypeProvider();\n","import { t } from \"alepha\";\nimport {\n  PG_DEFAULT,\n  PG_PRIMARY_KEY,\n  PG_SERIAL,\n} from \"../constants/PG_SYMBOLS.ts\";\nimport { pgAttr } from \"../helpers/pgAttr.ts\";\n\n/**\n * @deprecated Use `pg.primaryKey()` instead.\n */\nexport const legacyIdSchema = pgAttr(\n  pgAttr(pgAttr(t.integer(), PG_PRIMARY_KEY), PG_SERIAL),\n  PG_DEFAULT,\n);\n","import { $module } from \"alepha\";\nimport { AlephaDateTime } from \"alepha/datetime\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport {\n  type Page,\n  type PageQuery,\n  pageQuerySchema,\n  pageSchema,\n} from \"alepha\";\nexport * from \"./errors/DbEntityNotFoundError.ts\";\nexport * from \"./helpers/parseQueryString.ts\";\nexport * from \"./helpers/pgAttr.ts\";\nexport * from \"./interfaces/FilterOperators.ts\";\nexport * from \"./interfaces/PgQuery.ts\";\nexport * from \"./interfaces/PgQueryWhere.ts\";\nexport * from \"./primitives/$entity.ts\";\nexport * from \"./providers/PostgresTypeProvider.ts\";\nexport * from \"./schemas/legacyIdSchema.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaPostgres = $module({\n  name: \"alepha.postgres\",\n  primitives: [],\n  services: [AlephaDateTime],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.browser.js","names":["parts","schema","schema","pageSchema"],"sources":["../../src/orm/errors/DbError.ts","../../src/orm/errors/DbEntityNotFoundError.ts","../../src/orm/helpers/parseQueryString.ts","../../src/orm/helpers/pgAttr.ts","../../src/orm/constants/PG_SYMBOLS.ts","../../src/orm/types/schema.ts","../../src/orm/schemas/insertSchema.ts","../../src/orm/schemas/updateSchema.ts","../../src/orm/primitives/$entity.ts","../../src/orm/providers/DatabaseTypeProvider.ts","../../src/orm/schemas/legacyIdSchema.ts","../../src/orm/index.browser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class DbError extends AlephaError {\n  name = \"DbError\";\n\n  constructor(message: string, cause?: unknown) {\n    super(message, { cause });\n  }\n}\n","import { DbError } from \"./DbError.ts\";\n\nexport class DbEntityNotFoundError extends DbError {\n  readonly name = \"DbEntityNotFoundError\";\n  readonly status = 404;\n\n  constructor(entityName: string) {\n    super(`Entity from '${entityName}' was not found`);\n  }\n}\n","import { AlephaError, type TObject } from \"alepha\";\nimport type { PgQueryWhere } from \"../interfaces/PgQueryWhere.ts\";\n\n/**\n * Parse a string query into a PgQueryWhere object.\n *\n * Supported syntax:\n * - Simple equality: \"name=John\"\n * - Wildcard patterns: \"name=John*\" (startsWith), \"name=*John\" (endsWith), \"name=*John*\" (contains)\n * - Operators: \"age>18\", \"age>=18\", \"age<65\", \"age<=65\", \"status!=active\"\n * - NULL checks: \"deletedAt=null\", \"email!=null\"\n * - IN arrays: \"status=[pending,active]\"\n * - AND conditions: \"name=John&age>18\"\n * - OR conditions: \"name=John|email=john@example.com\"\n * - Nested AND/OR: \"(name=John|name=Jane)&age>18\"\n * - JSONB nested: \"profile.city=Paris\"\n *\n * @example\n * ```ts\n * // Simple equality\n * parseQueryString(\"name=John\")\n * // => { name: { eq: \"John\" } }\n *\n * // Wildcard patterns\n * parseQueryString(\"name=John*\")  // startsWith\n * // => { name: { startsWith: \"John\" } }\n * parseQueryString(\"name=*Smith\")  // endsWith\n * // => { name: { endsWith: \"Smith\" } }\n * parseQueryString(\"name=*oh*\")  // contains\n * // => { name: { contains: \"oh\" } }\n *\n * // Multiple conditions\n * parseQueryString(\"name=John&age>18\")\n * // => { and: [{ name: { eq: \"John\" } }, { age: { gt: 18 } }] }\n *\n * // OR conditions\n * parseQueryString(\"status=active|status=pending\")\n * // => { or: [{ status: { eq: \"active\" } }, { status: { eq: \"pending\" } }] }\n *\n * // Complex nested\n * parseQueryString(\"(name=John|name=Jane)&age>18&status!=archived\")\n * // => { and: [\n * //      { or: [{ name: { eq: \"John\" } }, { name: { eq: \"Jane\" } }] },\n * //      { age: { gt: 18 } },\n * //      { status: { ne: \"archived\" } }\n * //    ] }\n *\n * // JSONB nested query\n * parseQueryString(\"profile.city=Paris&profile.age>25\")\n * // => { profile: { city: { eq: \"Paris\" }, age: { gt: 25 } } }\n * ```\n */\nexport function parseQueryString<T extends TObject>(\n  query: string,\n): PgQueryWhere<T> {\n  if (!query || query.trim() === \"\") {\n    return {};\n  }\n\n  const parser = new QueryStringParser(query);\n  return parser.parse() as PgQueryWhere<T>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nclass QueryStringParser {\n  private pos = 0;\n  private readonly query: string;\n\n  constructor(query: string) {\n    this.query = query.trim();\n  }\n\n  parse(): PgQueryWhere<any> {\n    return this.parseExpression();\n  }\n\n  private parseExpression(): PgQueryWhere<any> {\n    return this.parseOr();\n  }\n\n  private parseOr(): any {\n    const left = this.parseAnd();\n\n    // Check for OR operator (|)\n    if (this.peek() === \"|\") {\n      const conditions = [left];\n\n      while (this.peek() === \"|\") {\n        this.consume(\"|\");\n        conditions.push(this.parseAnd());\n      }\n\n      return { or: conditions };\n    }\n\n    return left;\n  }\n\n  private parseAnd(): any {\n    const left = this.parsePrimary();\n\n    // Check for AND operator (&)\n    if (this.peek() === \"&\") {\n      const conditions = [left];\n\n      while (this.peek() === \"&\") {\n        this.consume(\"&\");\n        conditions.push(this.parsePrimary());\n      }\n\n      return { and: conditions };\n    }\n\n    return left;\n  }\n\n  private parsePrimary(): any {\n    this.skipWhitespace();\n\n    // Handle parentheses\n    if (this.peek() === \"(\") {\n      this.consume(\"(\");\n      const expr = this.parseExpression();\n      this.consume(\")\");\n      return expr;\n    }\n\n    // Parse field condition\n    return this.parseCondition();\n  }\n\n  private parseCondition(): any {\n    const field = this.parseFieldPath();\n    this.skipWhitespace();\n\n    // Get operator\n    const operator = this.parseOperator();\n    this.skipWhitespace();\n\n    // Get value\n    const value = this.parseValue();\n\n    if (value === \"\") {\n      throw new AlephaError(`Expected value for field '${field.join(\".\")}'`);\n    }\n\n    // Build the condition object\n    return this.buildCondition(field, operator, value);\n  }\n\n  private parseFieldPath(): string[] {\n    const path: string[] = [];\n    let current = \"\";\n\n    while (this.pos < this.query.length) {\n      const ch = this.query[this.pos];\n\n      if (ch === \".\" && current) {\n        path.push(current);\n        current = \"\";\n        this.pos++;\n        continue;\n      }\n\n      if (ch === \"=\" || ch === \"!\" || ch === \">\" || ch === \"<\" || ch === \" \") {\n        break;\n      }\n\n      current += ch;\n      this.pos++;\n    }\n\n    if (current) {\n      path.push(current);\n    }\n\n    return path;\n  }\n\n  private parseOperator(): string {\n    this.skipWhitespace();\n\n    const remaining = this.query.slice(this.pos);\n\n    // Two-character operators\n    if (remaining.startsWith(\">=\")) {\n      this.pos += 2;\n      return \">=\";\n    }\n    if (remaining.startsWith(\"<=\")) {\n      this.pos += 2;\n      return \"<=\";\n    }\n    if (remaining.startsWith(\"!=\")) {\n      this.pos += 2;\n      return \"!=\";\n    }\n\n    // Single-character operators\n    const ch = this.query[this.pos];\n    if (ch === \"=\" || ch === \">\" || ch === \"<\") {\n      this.pos++;\n      return ch;\n    }\n\n    throw new Error(`Expected operator at position ${this.pos}`);\n  }\n\n  private parseValue(): any {\n    this.skipWhitespace();\n\n    // Handle null\n    if (this.query.slice(this.pos, this.pos + 4).toLowerCase() === \"null\") {\n      this.pos += 4;\n      return null;\n    }\n\n    // Handle arrays [value1,value2,...]\n    if (this.query[this.pos] === \"[\") {\n      return this.parseArray();\n    }\n\n    // Handle quoted strings\n    if (this.query[this.pos] === '\"' || this.query[this.pos] === \"'\") {\n      return this.parseQuotedString();\n    }\n\n    // Parse unquoted value (until &, |, or ))\n    let value = \"\";\n    while (this.pos < this.query.length) {\n      const ch = this.query[this.pos];\n      if (ch === \"&\" || ch === \"|\" || ch === \")\") {\n        break;\n      }\n      value += ch;\n      this.pos++;\n    }\n\n    return this.coerceValue(value.trim());\n  }\n\n  private parseArray(): any[] {\n    this.consume(\"[\");\n    const values: any[] = [];\n\n    while (this.pos < this.query.length && this.query[this.pos] !== \"]\") {\n      this.skipWhitespace();\n\n      // Handle quoted values\n      if (this.query[this.pos] === '\"' || this.query[this.pos] === \"'\") {\n        values.push(this.parseQuotedString());\n      } else {\n        // Parse until comma or ]\n        let value = \"\";\n        while (\n          this.pos < this.query.length &&\n          this.query[this.pos] !== \",\" &&\n          this.query[this.pos] !== \"]\"\n        ) {\n          value += this.query[this.pos];\n          this.pos++;\n        }\n        values.push(this.coerceValue(value.trim()));\n      }\n\n      this.skipWhitespace();\n      if (this.query[this.pos] === \",\") {\n        this.pos++;\n      }\n    }\n\n    this.consume(\"]\");\n    return values;\n  }\n\n  private parseQuotedString(): string {\n    const quote = this.query[this.pos];\n    this.pos++; // Skip opening quote\n\n    let value = \"\";\n    let escaped = false;\n\n    while (this.pos < this.query.length) {\n      const ch = this.query[this.pos];\n\n      if (escaped) {\n        value += ch;\n        escaped = false;\n        this.pos++;\n        continue;\n      }\n\n      if (ch === \"\\\\\") {\n        escaped = true;\n        this.pos++;\n        continue;\n      }\n\n      if (ch === quote) {\n        this.pos++; // Skip closing quote\n        break;\n      }\n\n      value += ch;\n      this.pos++;\n    }\n\n    return value;\n  }\n\n  private coerceValue(value: string): any {\n    // Try to parse as number\n    if (/^-?\\d+$/.test(value)) {\n      return parseInt(value, 10);\n    }\n\n    if (/^-?\\d+\\.\\d+$/.test(value)) {\n      return parseFloat(value);\n    }\n\n    // Try to parse as boolean\n    if (value.toLowerCase() === \"true\") {\n      return true;\n    }\n    if (value.toLowerCase() === \"false\") {\n      return false;\n    }\n\n    return value;\n  }\n\n  private buildCondition(path: string[], operator: string, value: any): any {\n    // Map operator to filter operator\n    let filterOp: any;\n\n    if (operator === \"=\") {\n      if (value === null) {\n        filterOp = { isNull: true };\n      } else if (Array.isArray(value)) {\n        // Arrays should be treated as inArray regardless of content\n        filterOp = { inArray: value };\n      } else if (typeof value === \"string\" && value.includes(\"*\")) {\n        // Handle wildcard patterns\n        const startsWithAsterisk = value.startsWith(\"*\");\n        const endsWithAsterisk = value.endsWith(\"*\");\n        const cleanValue = value.replace(/^\\*|\\*$/g, \"\"); // Remove leading/trailing asterisks\n\n        if (startsWithAsterisk && endsWithAsterisk) {\n          // *text* -> contains\n          filterOp = { contains: cleanValue };\n        } else if (startsWithAsterisk) {\n          // *text -> endsWith\n          filterOp = { endsWith: cleanValue };\n        } else if (endsWithAsterisk) {\n          // text* -> startsWith\n          filterOp = { startsWith: cleanValue };\n        } else {\n          // Has asterisk in the middle, treat as literal\n          filterOp = { eq: value };\n        }\n      } else {\n        filterOp = { eq: value };\n      }\n    } else if (operator === \"!=\") {\n      if (value === null) {\n        filterOp = { isNotNull: true };\n      } else {\n        filterOp = { ne: value };\n      }\n    } else if (operator === \">\") {\n      filterOp = { gt: value };\n    } else if (operator === \">=\") {\n      filterOp = { gte: value };\n    } else if (operator === \"<\") {\n      filterOp = { lt: value };\n    } else if (operator === \"<=\") {\n      filterOp = { lte: value };\n    } else {\n      throw new Error(`Unsupported operator: ${operator}`);\n    }\n\n    // Build nested object for path\n    if (path.length === 1) {\n      return { [path[0]]: filterOp };\n    }\n\n    // Handle nested paths (JSONB)\n    let result: any = filterOp;\n    for (let i = path.length - 1; i >= 0; i--) {\n      result = { [path[i]]: result };\n    }\n\n    return result;\n  }\n\n  private peek(): string {\n    this.skipWhitespace();\n    return this.query[this.pos] || \"\";\n  }\n\n  private consume(expected: string): void {\n    this.skipWhitespace();\n    if (this.query[this.pos] !== expected) {\n      throw new Error(\n        `Expected '${expected}' at position ${this.pos}, got '${this.query[this.pos]}'`,\n      );\n    }\n    this.pos++;\n  }\n\n  private skipWhitespace(): void {\n    while (this.pos < this.query.length && /\\s/.test(this.query[this.pos])) {\n      this.pos++;\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Helper function to build query strings programmatically\n *\n * @example\n * ```ts\n * buildQueryString({\n *   and: [\n *     { name: \"eq:John\" },\n *     { age: \"gt:18\" }\n *   ]\n * })\n * // => \"name=John&age>18\"\n * ```\n */\nexport function buildQueryString(where: any): string {\n  if (!where || typeof where !== \"object\") {\n    return \"\";\n  }\n\n  // Handle logical operators\n  if (\"and\" in where && Array.isArray(where.and)) {\n    return where.and.map((w: any) => buildQueryString(w)).join(\"&\");\n  }\n\n  if (\"or\" in where && Array.isArray(where.or)) {\n    const parts = where.or.map((w: any) => buildQueryString(w));\n    return parts.length > 1 ? `(${parts.join(\"|\")})` : parts[0];\n  }\n\n  if (\"not\" in where) {\n    // Not operator is harder to represent in string form\n    // For now, we'll skip it or you could add a syntax like \"!field=value\"\n    return \"\";\n  }\n\n  // Handle field conditions\n  const parts: string[] = [];\n\n  for (const [field, condition] of Object.entries(where)) {\n    if (typeof condition !== \"object\" || condition === null) {\n      parts.push(`${field}=${condition}`);\n      continue;\n    }\n\n    if (\"eq\" in condition) {\n      parts.push(`${field}=${condition.eq}`);\n    } else if (\"ne\" in condition) {\n      parts.push(`${field}!=${condition.ne}`);\n    } else if (\"gt\" in condition) {\n      parts.push(`${field}>${condition.gt}`);\n    } else if (\"gte\" in condition) {\n      parts.push(`${field}>=${condition.gte}`);\n    } else if (\"lt\" in condition) {\n      parts.push(`${field}<${condition.lt}`);\n    } else if (\"lte\" in condition) {\n      parts.push(`${field}<=${condition.lte}`);\n    } else if (\"contains\" in condition) {\n      parts.push(`${field}=*${condition.contains}*`);\n    } else if (\"startsWith\" in condition) {\n      parts.push(`${field}=${condition.startsWith}*`);\n    } else if (\"endsWith\" in condition) {\n      parts.push(`${field}=*${condition.endsWith}`);\n    } else if (\"isNull\" in condition && condition.isNull) {\n      parts.push(`${field}=null`);\n    } else if (\"isNotNull\" in condition && condition.isNotNull) {\n      parts.push(`${field}!=null`);\n    } else if (\"inArray\" in condition && Array.isArray(condition.inArray)) {\n      const values = condition.inArray.map((v: any) =>\n        typeof v === \"string\" ? `\"${v}\"` : v,\n      );\n      parts.push(`${field}=[${values.join(\",\")}]`);\n    } else {\n      // Nested object (JSONB)\n      const nested = buildQueryString(condition);\n      if (nested) {\n        parts.push(`${field}.${nested}`);\n      }\n    }\n  }\n\n  return parts.join(\"&\");\n}\n","import type { TObject, TSchema } from \"alepha\";\nimport type { PgSymbolKeys, PgSymbols } from \"../constants/PG_SYMBOLS.ts\";\n\n/**\n * Decorates a typebox schema with a Postgres attribute.\n *\n * > It's just a fancy way to add Symbols to a field.\n *\n * @example\n * ```ts\n * import { t } from \"alepha\";\n * import { PG_UPDATED_AT } from \"../constants/PG_SYMBOLS\";\n *\n * export const updatedAtSchema = pgAttr(\n *   t.datetime(), PG_UPDATED_AT,\n * );\n * ```\n */\nexport const pgAttr = <T extends TSchema, Attr extends PgSymbolKeys>(\n  type: T,\n  attr: Attr,\n  value?: PgSymbols[Attr],\n): PgAttr<T, Attr> => {\n  Object.assign(type, { [attr]: value ?? {} });\n  return type as PgAttr<T, Attr>;\n};\n\n/**\n * Retrieves the fields of a schema that have a specific attribute.\n */\nexport const getAttrFields = (\n  schema: TObject,\n  name: PgSymbolKeys,\n): PgAttrField[] => {\n  const fields: Array<PgAttrField> = [];\n\n  for (const key of Object.keys(schema.properties)) {\n    const value = schema.properties[key];\n    if (name in value) {\n      fields.push({\n        type: value as TSchema,\n        key: key,\n        data: (value as any)[name],\n      });\n    }\n  }\n\n  return fields;\n};\n\n/**\n * Type representation.\n */\nexport type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & {\n  [K in TAttr]: PgSymbols[K];\n};\n\nexport interface PgAttrField {\n  key: string;\n  type: TSchema;\n  data: any;\n  nested?: any[];\n  one?: boolean;\n}\n","import type {\n  PgSequenceOptions,\n  UpdateDeleteAction,\n} from \"drizzle-orm/pg-core\";\nimport type { EntityPrimitive } from \"../primitives/$entity.ts\";\n\nexport const PG_DEFAULT = Symbol.for(\"Alepha.Postgres.Default\");\nexport const PG_PRIMARY_KEY = Symbol.for(\"Alepha.Postgres.PrimaryKey\");\nexport const PG_CREATED_AT = Symbol.for(\"Alepha.Postgres.CreatedAt\");\nexport const PG_UPDATED_AT = Symbol.for(\"Alepha.Postgres.UpdatedAt\");\nexport const PG_DELETED_AT = Symbol.for(\"Alepha.Postgres.DeletedAt\");\nexport const PG_VERSION = Symbol.for(\"Alepha.Postgres.Version\");\nexport const PG_IDENTITY = Symbol.for(\"Alepha.Postgres.Identity\");\nexport const PG_ENUM = Symbol.for(\"Alepha.Postgres.Enum\");\nexport const PG_REF = Symbol.for(\"Alepha.Postgres.Ref\");\n\n/**\n * @deprecated Use `PG_IDENTITY` instead.\n */\nexport const PG_SERIAL = Symbol.for(\"Alepha.Postgres.Serial\");\n\nexport type PgDefault = typeof PG_DEFAULT;\nexport type PgRef = typeof PG_REF;\nexport type PgPrimaryKey = typeof PG_PRIMARY_KEY;\n\nexport type PgSymbols = {\n  [PG_DEFAULT]: {};\n  [PG_PRIMARY_KEY]: {};\n  [PG_CREATED_AT]: {};\n  [PG_UPDATED_AT]: {};\n  [PG_DELETED_AT]: {};\n  [PG_VERSION]: {};\n  [PG_IDENTITY]: PgIdentityOptions;\n  [PG_REF]: PgRefOptions;\n  [PG_ENUM]: PgEnumOptions;\n\n  /**\n   * @deprecated Use `PG_IDENTITY` instead.\n   */\n  [PG_SERIAL]: {};\n};\n\nexport type PgSymbolKeys = keyof PgSymbols;\n\nexport type PgIdentityOptions = {\n  mode: \"always\" | \"byDefault\";\n} & PgSequenceOptions & {\n    name?: string;\n  };\n\nexport interface PgEnumOptions {\n  name?: string;\n  description?: string;\n}\n\nexport interface PgRefOptions {\n  ref: () => {\n    name: string;\n    entity: EntityPrimitive;\n  };\n  actions?: {\n    onUpdate?: UpdateDeleteAction;\n    onDelete?: UpdateDeleteAction;\n  };\n}\n","import type { Static, TSchema } from \"alepha\";\nimport { customType } from \"drizzle-orm/pg-core\";\n\n/**\n * Postgres schema type.\n */\nexport const schema = <TDocument extends TSchema>(\n  name: string,\n  document: TDocument,\n) =>\n  customType<{\n    data: Static<TDocument>;\n    driverData: string;\n    config: { document: TDocument };\n    configRequired: true;\n  }>({\n    dataType: () => \"jsonb\",\n    toDriver: (value) => JSON.stringify(value),\n    fromDriver: (value: TDocument | string) =>\n      value && typeof value === \"string\" ? JSON.parse(value) : value,\n  })(name, { document }).$type<Static<TDocument>>();\n","import type { TObject, TOptional } from \"alepha\";\nimport { t } from \"alepha\";\nimport { PG_DEFAULT } from \"../constants/PG_SYMBOLS.ts\";\nimport { schema } from \"../types/schema.ts\";\n\n/**\n * Transforms a TObject schema for insert operations.\n * All default properties at the root level are made optional.\n *\n * @example\n * Before: { name: string; age: number(default=0); }\n * After:  { name: string; age?: number; }\n */\nexport type TObjectInsert<T extends TObject> = TObject<{\n  [K in keyof T[\"properties\"]]: T[\"properties\"][K] extends\n    | { [PG_DEFAULT]: any }\n    | { \"~optional\": true }\n    ? TOptional<T[\"properties\"][K]>\n    : T[\"properties\"][K];\n}>;\n\nexport const insertSchema = <T extends TObject>(obj: T): TObjectInsert<T> => {\n  const newProperties: Record<string, any> = {};\n\n  for (const key in obj.properties) {\n    const prop = obj.properties[key];\n\n    if (PG_DEFAULT in prop) {\n      newProperties[key] = t.optional(prop);\n    } else {\n      newProperties[key] = prop;\n    }\n  }\n\n  return t.object(\n    newProperties,\n    \"options\" in schema && typeof schema.options === \"object\"\n      ? { ...schema.options }\n      : {},\n  ) as TObjectInsert<T>;\n};\n","import {\n  type TNull,\n  type TObject,\n  type TOptional,\n  type TUnion,\n  t,\n} from \"alepha\";\n\n/**\n * Transforms a TObject schema for update operations.\n * All optional properties at the root level are made nullable (i.e., `T | null`).\n * This allows an API endpoint to explicitly accept `null` to clear an optional field in the database.\n *\n * @example\n * Before: { name?: string; age: number; }\n * After:  { name?: string | null; age: number; }\n */\nexport type TObjectUpdate<T extends TObject> = TObject<{\n  [K in keyof T[\"properties\"]]: T[\"properties\"][K] extends TOptional<infer U>\n    ? TOptional<TUnion<[U, TNull]>>\n    : T[\"properties\"][K];\n}>;\n\nexport const updateSchema = <T extends TObject>(\n  schema: T,\n): TObjectUpdate<T> => {\n  const newProperties: Record<string, any> = {};\n\n  for (const key in schema.properties) {\n    const prop = schema.properties[key];\n    if (t.schema.isOptional(prop)) {\n      newProperties[key] = t.optional(t.union([prop, t.raw.Null()]));\n    } else {\n      newProperties[key] = prop;\n    }\n  }\n\n  return t.object(\n    newProperties,\n    \"options\" in schema && typeof schema.options === \"object\"\n      ? { ...schema.options }\n      : {},\n  ) as TObjectUpdate<T>;\n};\n","import { KIND, type Static, type TObject } from \"alepha\";\nimport type { BuildExtraConfigColumns, SQL } from \"drizzle-orm\";\nimport type {\n  PgColumn,\n  PgColumnBuilderBase,\n  PgTableExtraConfigValue,\n} from \"drizzle-orm/pg-core\";\nimport { insertSchema, type TObjectInsert } from \"../schemas/insertSchema.ts\";\nimport { type TObjectUpdate, updateSchema } from \"../schemas/updateSchema.ts\";\n\n/**\n * Creates a database entity primitive that defines table structure using TypeBox schemas.\n *\n * @example\n * ```ts\n * import { t } from \"alepha\";\n * import { $entity } from \"alepha/orm\";\n *\n * const userEntity = $entity({\n *   name: \"users\",\n *   schema: t.object({\n *     id: pg.primaryKey(),\n *     name: t.text(),\n *     email: t.email(),\n *   }),\n * });\n * ```\n */\nexport const $entity = <TSchema extends TObject>(\n  options: EntityPrimitiveOptions<TSchema>,\n): EntityPrimitive<TSchema> => {\n  return new EntityPrimitive<TSchema>(options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface EntityPrimitiveOptions<\n  T extends TObject,\n  Keys = keyof Static<T>,\n> {\n  /**\n   * The database table name that will be created for this entity.\n   * If not provided, name will be inferred from the $repository variable name.\n   */\n  name: string;\n\n  /**\n   * TypeBox schema defining the table structure and column types.\n   */\n  schema: T;\n\n  /**\n   * Database indexes to create for query optimization.\n   */\n  indexes?: (\n    | Keys\n    | {\n        /**\n         * Single column to index.\n         */\n        column: Keys;\n        /**\n         * Whether this should be a unique index (enforces uniqueness constraint).\n         */\n        unique?: boolean;\n        /**\n         * Custom name for the index. If not provided, generates name automatically.\n         */\n        name?: string;\n      }\n    | {\n        /**\n         * Multiple columns for composite index (order matters for query optimization).\n         */\n        columns: Keys[];\n        /**\n         * Whether this should be a unique index (enforces uniqueness constraint).\n         */\n        unique?: boolean;\n        /**\n         * Custom name for the index. If not provided, generates name automatically.\n         */\n        name?: string;\n      }\n  )[];\n\n  /**\n   * Foreign key constraints to maintain referential integrity.\n   */\n  foreignKeys?: Array<{\n    /**\n     * Optional name for the foreign key constraint.\n     */\n    name?: string;\n    /**\n     * Local columns that reference the foreign table.\n     */\n    columns: Array<keyof Static<T>>;\n    /**\n     * Referenced columns in the foreign table.\n     * Must be EntityColumn references from other entities.\n     */\n    foreignColumns: Array<() => EntityColumn<any>>;\n  }>;\n\n  /**\n   * Additional table constraints for data validation.\n   *\n   * Constraints enforce business rules at the database level, providing\n   * an additional layer of data integrity beyond application validation.\n   *\n   * **Constraint Types**:\n   * - **Unique constraints**: Prevent duplicate values across columns\n   * - **Check constraints**: Enforce custom validation rules with SQL expressions\n   *\n   * @example\n   * ```ts\n   * constraints: [\n   *   {\n   *     name: \"unique_user_email\",\n   *     columns: [\"email\"],\n   *     unique: true\n   *   },\n   *   {\n   *     name: \"valid_age_range\",\n   *     columns: [\"age\"],\n   *     check: sql`age >= 0 AND age <= 150`\n   *   },\n   *   {\n   *     name: \"unique_user_username_per_tenant\",\n   *     columns: [\"tenantId\", \"username\"],\n   *     unique: true\n   *   }\n   * ]\n   * ```\n   */\n  constraints?: Array<{\n    /**\n     * Columns involved in this constraint.\n     */\n    columns: Array<keyof Static<T>>;\n    /**\n     * Optional name for the constraint.\n     */\n    name?: string;\n    /**\n     * Whether this is a unique constraint.\n     */\n    unique?: boolean | {} /* options */;\n    /**\n     * SQL expression for check constraint validation.\n     */\n    check?: SQL;\n  }>;\n\n  /**\n   * Advanced Drizzle ORM configuration for complex table setups.\n   */\n  config?: (\n    self: BuildExtraConfigColumns<string, FromSchema<T>, \"pg\">,\n  ) => PgTableExtraConfigValue[];\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class EntityPrimitive<T extends TObject = TObject> {\n  public readonly options: EntityPrimitiveOptions<T>;\n\n  constructor(options: EntityPrimitiveOptions<T>) {\n    this.options = options;\n  }\n\n  alias(alias: string): this {\n    const aliased = new EntityPrimitive<T>(this.options);\n    return new Proxy(aliased, {\n      get(target, prop, receiver) {\n        if (prop === \"$alias\") {\n          return alias;\n        }\n        return Reflect.get(target, prop, receiver);\n      },\n    }) as this;\n  }\n\n  get cols(): EntityColumns<T> {\n    const cols: Partial<EntityColumns<T>> = {};\n    for (const key of Object.keys(this.schema.properties) as Array<\n      keyof T[\"properties\"]\n    >) {\n      cols[key] = {\n        name: key as string,\n        entity: this,\n      };\n    }\n\n    return cols as EntityColumns<T>;\n  }\n\n  get name(): string {\n    return this.options.name;\n  }\n\n  get schema(): T {\n    return this.options.schema;\n  }\n\n  get insertSchema(): TObjectInsert<T> {\n    return insertSchema(this.options.schema);\n  }\n\n  get updateSchema(): TObjectUpdate<T> {\n    return updateSchema(this.options.schema);\n  }\n}\n\n$entity[KIND] = EntityPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Convert a schema to columns.\n */\nexport type FromSchema<T extends TObject> = {\n  [key in keyof T[\"properties\"]]: PgColumnBuilderBase;\n};\n\nexport type SchemaToTableConfig<T extends TObject> = {\n  name: string;\n  schema: string | undefined;\n  columns: {\n    [key in keyof T[\"properties\"]]: PgColumn;\n  };\n  dialect: string;\n};\n\nexport type EntityColumn<T extends TObject> = {\n  name: string;\n  entity: EntityPrimitive<T>;\n};\n\nexport type EntityColumns<T extends TObject> = {\n  [key in keyof T[\"properties\"]]: EntityColumn<T>;\n};\n","import {\n  AlephaError,\n  pageSchema,\n  type Static,\n  type TBigInt,\n  type TInteger,\n  type TNumber,\n  type TNumberOptions,\n  type TObject,\n  type TObjectOptions,\n  type TPage,\n  type TSchema,\n  type TString,\n  type TStringOptions,\n  type TUnsafe,\n  t,\n} from \"alepha\";\nimport type { UpdateDeleteAction } from \"drizzle-orm/pg-core/foreign-keys\";\nimport {\n  PG_CREATED_AT,\n  PG_DEFAULT,\n  PG_DELETED_AT,\n  PG_ENUM,\n  PG_IDENTITY,\n  PG_PRIMARY_KEY,\n  PG_REF,\n  PG_UPDATED_AT,\n  PG_VERSION,\n  type PgDefault,\n  type PgEnumOptions,\n  type PgIdentityOptions,\n  type PgPrimaryKey,\n  type PgRef,\n} from \"../constants/PG_SYMBOLS.ts\";\nimport type { PgAttr } from \"../helpers/pgAttr.ts\";\nimport { pgAttr } from \"../helpers/pgAttr.ts\";\n\nexport class DatabaseTypeProvider {\n  public readonly attr = pgAttr;\n\n  /**\n   * Creates a primary key with an identity column.\n   */\n  public readonly identityPrimaryKey = (\n    identity?: PgIdentityOptions,\n    options?: TNumberOptions,\n  ) =>\n    pgAttr(\n      pgAttr(pgAttr(t.integer(options), PG_PRIMARY_KEY), PG_IDENTITY, identity),\n      PG_DEFAULT,\n    );\n\n  /**\n   * Creates a primary key with a big identity column. (default)\n   */\n  public readonly bigIdentityPrimaryKey = (\n    identity?: PgIdentityOptions,\n    options?: TNumberOptions,\n  ) =>\n    pgAttr(\n      pgAttr(pgAttr(t.int64(options), PG_PRIMARY_KEY), PG_IDENTITY, identity),\n      PG_DEFAULT,\n    );\n\n  /**\n   * Creates a primary key with a UUID column.\n   */\n  public readonly uuidPrimaryKey = () =>\n    pgAttr(pgAttr(t.uuid(), PG_PRIMARY_KEY), PG_DEFAULT);\n\n  /**\n   * Creates a primary key for a given type. Supports:\n   * - `t.integer()` -> PG INT (default)\n   * - `t.bigint()` -> PG BIGINT\n   * - `t.uuid()` -> PG UUID\n   */\n  public primaryKey(): PgAttr<PgAttr<TInteger, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TString,\n    options?: TStringOptions,\n  ): PgAttr<PgAttr<TString, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TInteger,\n    options?: TNumberOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TInteger, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TNumber,\n    options?: TNumberOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TNumber, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type: TBigInt,\n    options?: TNumberOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TBigInt, PgPrimaryKey>, PgDefault>;\n  public primaryKey(\n    type?: TSchema,\n    options?: TNumberOptions | TStringOptions,\n    identity?: PgIdentityOptions,\n  ): PgAttr<PgAttr<TSchema, PgPrimaryKey>, PgDefault> {\n    if (!type || t.schema.isInteger(type)) {\n      return pgAttr(\n        pgAttr(\n          pgAttr(t.integer(options), PG_PRIMARY_KEY),\n          PG_IDENTITY,\n          identity,\n        ),\n        PG_DEFAULT,\n      );\n    }\n\n    if (t.schema.isString(type) && type.format === \"uuid\") {\n      return pgAttr(pgAttr(t.uuid(), PG_PRIMARY_KEY), PG_DEFAULT);\n    }\n\n    if (t.schema.isNumber(type) && type.format === \"int64\") {\n      return pgAttr(\n        pgAttr(\n          pgAttr(t.number(options), PG_PRIMARY_KEY),\n          PG_IDENTITY,\n          identity,\n        ),\n        PG_DEFAULT,\n      );\n    }\n\n    if (t.schema.isBigInt(type)) {\n      return pgAttr(\n        pgAttr(\n          pgAttr(t.bigint(options), PG_PRIMARY_KEY),\n          PG_IDENTITY,\n          identity,\n        ),\n        PG_DEFAULT,\n      );\n    }\n\n    throw new AlephaError(`Unsupported type for primary key: ${type}`);\n  }\n\n  /**\n   * Wrap a schema with \"default\" attribute.\n   * This is used to set a default value for a column in the database.\n   */\n  public readonly default = <T extends TSchema>(\n    type: T,\n    value?: Static<T>,\n  ): PgAttr<T, PgDefault> => {\n    if (value != null) {\n      Object.assign(type, { default: value });\n    }\n\n    return this.attr(type, PG_DEFAULT);\n  };\n\n  /**\n   * Creates a column 'version'.\n   *\n   * This is used to track the version of a row in the database.\n   *\n   * You can use it for optimistic concurrency control (OCC) with {@link RepositoryPrimitive#save}.\n   *\n   * @see {@link RepositoryPrimitive#save}\n   * @see {@link PgVersionMismatchError}\n   */\n  public readonly version = (options: TNumberOptions = {}) =>\n    this.default(pgAttr(t.integer(options), PG_VERSION), 0);\n\n  /**\n   * Creates a column Created At. So just a datetime column with a default value of the current timestamp.\n   */\n  public readonly createdAt = (options?: TStringOptions) =>\n    pgAttr(pgAttr(t.datetime(options), PG_CREATED_AT), PG_DEFAULT);\n\n  /**\n   * Creates a column Updated At. Like createdAt, but it is updated on every update of the row.\n   */\n  public readonly updatedAt = (options?: TStringOptions) =>\n    pgAttr(pgAttr(t.datetime(options), PG_UPDATED_AT), PG_DEFAULT);\n\n  /**\n   * Creates a column Deleted At for soft delete functionality.\n   * This is used to mark rows as deleted without actually removing them from the database.\n   * The column is nullable - NULL means not deleted, timestamp means deleted.\n   */\n  public readonly deletedAt = (options?: TStringOptions) =>\n    pgAttr(t.optional(t.datetime(options)), PG_DELETED_AT);\n\n  /**\n   * Creates a Postgres ENUM type.\n   *\n   * > By default, `t.enum()` is mapped to a TEXT column in Postgres.\n   * > Using this method, you can create a real ENUM type in the database.\n   *\n   * @example\n   * ```ts\n   * const statusEnum = pg.enum([\"pending\", \"active\", \"archived\"], { name: \"status_enum\" });\n   * ```\n   */\n  public readonly enum = <T extends string[]>(\n    values: [...T],\n    pgEnumOptions?: PgEnumOptions,\n    typeOptions?: TStringOptions,\n  ): PgAttr<TUnsafe<T[number]>, typeof PG_ENUM> => {\n    return pgAttr(\n      t.enum(values, {\n        description: pgEnumOptions?.description,\n        ...typeOptions,\n      }),\n      PG_ENUM,\n      pgEnumOptions,\n    );\n  };\n\n  /**\n   * Creates a reference to another table or schema. Basically a foreign key.\n   */\n  public readonly ref = <T extends TSchema>(\n    type: T,\n    ref: () => any,\n    actions?: {\n      onUpdate?: UpdateDeleteAction;\n      onDelete?: UpdateDeleteAction;\n    },\n  ): PgAttr<T, PgRef> => {\n    // If actions are not provided, set default onDelete based on type\n    const finalActions = actions ?? {\n      onDelete: t.schema.isOptional(type) ? \"set null\" : \"cascade\",\n    };\n\n    return this.attr(type, PG_REF, {\n      ref,\n      actions: finalActions,\n    });\n  };\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Creates a page schema for a given object schema.\n   * It's used by {@link Repository#paginate} method.\n   */\n  public readonly page = <T extends TObject>(\n    resource: T,\n    options?: TObjectOptions,\n  ): TPage<T> => {\n    return pageSchema(resource, options);\n  };\n}\n\n/**\n * Wrapper of TypeProvider (`t`) for database types.\n *\n * Use `db` for improve TypeBox schema definitions with database-specific attributes.\n *\n * @example\n * ```ts\n * import { t } from \"alepha\";\n * import { db } from \"alepha/orm\";\n *\n * const userSchema = t.object({\n *   id: db.primaryKey(t.uuid()),\n *   email: t.email(),\n *   createdAt: db.createdAt(),\n * });\n * ```\n */\nexport const db = new DatabaseTypeProvider();\n\n/**\n * @deprecated Use `db` instead.\n */\nexport const pg = db;\n","import { t } from \"alepha\";\nimport {\n  PG_DEFAULT,\n  PG_PRIMARY_KEY,\n  PG_SERIAL,\n} from \"../constants/PG_SYMBOLS.ts\";\nimport { pgAttr } from \"../helpers/pgAttr.ts\";\n\n/**\n * @deprecated Use `pg.primaryKey()` instead.\n */\nexport const legacyIdSchema = pgAttr(\n  pgAttr(pgAttr(t.integer(), PG_PRIMARY_KEY), PG_SERIAL),\n  PG_DEFAULT,\n);\n","import { $module } from \"alepha\";\nimport { AlephaDateTime } from \"alepha/datetime\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport {\n  type Page,\n  type PageQuery,\n  pageQuerySchema,\n  pageSchema,\n} from \"alepha\";\nexport * from \"./errors/DbEntityNotFoundError.ts\";\nexport * from \"./helpers/parseQueryString.ts\";\nexport * from \"./helpers/pgAttr.ts\";\nexport * from \"./interfaces/FilterOperators.ts\";\nexport * from \"./interfaces/PgQuery.ts\";\nexport * from \"./interfaces/PgQueryWhere.ts\";\nexport * from \"./primitives/$entity.ts\";\nexport * from \"./providers/DatabaseTypeProvider.ts\";\nexport * from \"./schemas/legacyIdSchema.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaPostgres = $module({\n  name: \"alepha.postgres\",\n  primitives: [],\n  services: [AlephaDateTime],\n});\n"],"mappings":"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"}