@objectstack/spec 0.6.1 → 0.7.2

package/dist/api/rest-server.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-server.zod.d.ts","sourceRoot":"","sources":["../../src/api/rest-server.zod.ts"],"names":[],"mappings":"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"}

package/dist/api/rest-server.zod.js

@@ -0,0 +1,424 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestServerConfig = exports.RestApiConfig = exports.EndpointRegistrySchema = exports.GeneratedEndpointSchema = exports.RestServerConfigSchema = exports.RouteGenerationConfigSchema = exports.BatchEndpointsConfigSchema = exports.MetadataEndpointsConfigSchema = exports.CrudEndpointsConfigSchema = exports.CrudEndpointPatternSchema = exports.CrudOperation = exports.RestApiConfigSchema = void 0;
+const zod_1 = require("zod");
+const http_zod_1 = require("../shared/http.zod");
+/**
+ * REST API Server Protocol
+ *
+ * Defines the REST API server configuration for automatically generating
+ * RESTful CRUD endpoints, metadata endpoints, and batch operations.
+ *
+ * Features:
+ * - Automatic CRUD endpoint generation from Object definitions
+ * - Standard REST conventions (GET, POST, PUT, PATCH, DELETE)
+ * - Metadata API endpoints
+ * - Batch operation endpoints
+ * - OpenAPI/Swagger documentation generation
+ *
+ * Architecture alignment:
+ * - Salesforce: REST API with Object CRUD
+ * - Microsoft Dynamics: Web API with entity operations
+ * - Strapi: Auto-generated REST endpoints
+ */
+// ==========================================
+// REST API Configuration
+// ==========================================
+/**
+ * REST API Configuration Schema
+ * Core configuration for REST API server
+ *
+ * @example
+ * {
+ *   "version": "v1",
+ *   "basePath": "/api",
+ *   "enableCrud": true,
+ *   "enableMetadata": true,
+ *   "enableBatch": true,
+ *   "documentation": {
+ *     "enabled": true,
+ *     "title": "ObjectStack API"
+ *   }
+ * }
+ */
+exports.RestApiConfigSchema = zod_1.z.object({
+    /**
+     * API version identifier
+     */
+    version: zod_1.z.string().default('v1').describe('API version (e.g., v1, v2, 2024-01)'),
+    /**
+     * Base path for all API routes
+     */
+    basePath: zod_1.z.string().default('/api').describe('Base URL path for API'),
+    /**
+     * Full API path (combines basePath and version)
+     */
+    apiPath: zod_1.z.string().optional().describe('Full API path (defaults to {basePath}/{version})'),
+    /**
+     * Enable automatic CRUD endpoints
+     */
+    enableCrud: zod_1.z.boolean().default(true).describe('Enable automatic CRUD endpoint generation'),
+    /**
+     * Enable metadata endpoints
+     */
+    enableMetadata: zod_1.z.boolean().default(true).describe('Enable metadata API endpoints'),
+    /**
+     * Enable batch operation endpoints
+     */
+    enableBatch: zod_1.z.boolean().default(true).describe('Enable batch operation endpoints'),
+    /**
+     * Enable discovery endpoint
+     */
+    enableDiscovery: zod_1.z.boolean().default(true).describe('Enable API discovery endpoint'),
+    /**
+     * API documentation configuration
+     */
+    documentation: zod_1.z.object({
+        enabled: zod_1.z.boolean().default(true).describe('Enable API documentation'),
+        title: zod_1.z.string().default('ObjectStack API').describe('API documentation title'),
+        description: zod_1.z.string().optional().describe('API description'),
+        version: zod_1.z.string().optional().describe('Documentation version'),
+        termsOfService: zod_1.z.string().optional().describe('Terms of service URL'),
+        contact: zod_1.z.object({
+            name: zod_1.z.string().optional(),
+            url: zod_1.z.string().optional(),
+            email: zod_1.z.string().optional(),
+        }).optional(),
+        license: zod_1.z.object({
+            name: zod_1.z.string(),
+            url: zod_1.z.string().optional(),
+        }).optional(),
+    }).optional().describe('OpenAPI/Swagger documentation config'),
+    /**
+     * Response format configuration
+     */
+    responseFormat: zod_1.z.object({
+        envelope: zod_1.z.boolean().default(true).describe('Wrap responses in standard envelope'),
+        includeMetadata: zod_1.z.boolean().default(true).describe('Include response metadata (timestamp, requestId)'),
+        includePagination: zod_1.z.boolean().default(true).describe('Include pagination info in list responses'),
+    }).optional().describe('Response format options'),
+});
+// ==========================================
+// CRUD Endpoint Configuration
+// ==========================================
+/**
+ * CRUD Operation Type Enum
+ */
+exports.CrudOperation = zod_1.z.enum([
+    'create', // POST /api/v1/data/{object}
+    'read', // GET /api/v1/data/{object}/:id
+    'update', // PATCH /api/v1/data/{object}/:id
+    'delete', // DELETE /api/v1/data/{object}/:id
+    'list', // GET /api/v1/data/{object}
+]);
+/**
+ * CRUD Endpoint Pattern Schema
+ * Defines the URL pattern for CRUD operations
+ *
+ * @example
+ * {
+ *   "create": { "method": "POST", "path": "/data/{object}" },
+ *   "read": { "method": "GET", "path": "/data/{object}/:id" },
+ *   "update": { "method": "PATCH", "path": "/data/{object}/:id" },
+ *   "delete": { "method": "DELETE", "path": "/data/{object}/:id" },
+ *   "list": { "method": "GET", "path": "/data/{object}" }
+ * }
+ */
+exports.CrudEndpointPatternSchema = zod_1.z.object({
+    /**
+     * HTTP method
+     */
+    method: http_zod_1.HttpMethod.describe('HTTP method'),
+    /**
+     * URL path pattern (relative to API base)
+     */
+    path: zod_1.z.string().describe('URL path pattern'),
+    /**
+     * Operation summary for documentation
+     */
+    summary: zod_1.z.string().optional().describe('Operation summary'),
+    /**
+     * Operation description
+     */
+    description: zod_1.z.string().optional().describe('Operation description'),
+});
+/**
+ * CRUD Endpoints Configuration Schema
+ * Configuration for automatic CRUD endpoint generation
+ */
+exports.CrudEndpointsConfigSchema = zod_1.z.object({
+    /**
+     * Enable/disable specific CRUD operations
+     */
+    operations: zod_1.z.object({
+        create: zod_1.z.boolean().default(true).describe('Enable create operation'),
+        read: zod_1.z.boolean().default(true).describe('Enable read operation'),
+        update: zod_1.z.boolean().default(true).describe('Enable update operation'),
+        delete: zod_1.z.boolean().default(true).describe('Enable delete operation'),
+        list: zod_1.z.boolean().default(true).describe('Enable list operation'),
+    }).optional().describe('Enable/disable operations'),
+    /**
+     * Custom endpoint patterns (override defaults)
+     */
+    patterns: zod_1.z.record(exports.CrudOperation, exports.CrudEndpointPatternSchema).optional()
+        .describe('Custom URL patterns for operations'),
+    /**
+     * Path prefix for data operations
+     */
+    dataPrefix: zod_1.z.string().default('/data').describe('URL prefix for data endpoints'),
+    /**
+     * Object name parameter style
+     */
+    objectParamStyle: zod_1.z.enum(['path', 'query']).default('path')
+        .describe('How object name is passed (path param or query param)'),
+});
+// ==========================================
+// Metadata Endpoint Configuration
+// ==========================================
+/**
+ * Metadata Endpoint Configuration Schema
+ * Configuration for metadata API endpoints
+ *
+ * @example
+ * {
+ *   "prefix": "/meta",
+ *   "enableCache": true,
+ *   "endpoints": {
+ *     "types": true,
+ *     "objects": true,
+ *     "fields": true
+ *   }
+ * }
+ */
+exports.MetadataEndpointsConfigSchema = zod_1.z.object({
+    /**
+     * Path prefix for metadata operations
+     */
+    prefix: zod_1.z.string().default('/meta').describe('URL prefix for metadata endpoints'),
+    /**
+     * Enable HTTP caching for metadata
+     */
+    enableCache: zod_1.z.boolean().default(true).describe('Enable HTTP cache headers (ETag, Last-Modified)'),
+    /**
+     * Cache TTL in seconds
+     */
+    cacheTtl: zod_1.z.number().int().default(3600).describe('Cache TTL in seconds'),
+    /**
+     * Enable specific metadata endpoints
+     */
+    endpoints: zod_1.z.object({
+        types: zod_1.z.boolean().default(true).describe('GET /meta - List all metadata types'),
+        items: zod_1.z.boolean().default(true).describe('GET /meta/:type - List items of type'),
+        item: zod_1.z.boolean().default(true).describe('GET /meta/:type/:name - Get specific item'),
+        schema: zod_1.z.boolean().default(true).describe('GET /meta/:type/:name/schema - Get JSON schema'),
+    }).optional().describe('Enable/disable specific endpoints'),
+});
+// ==========================================
+// Batch Operation Endpoint Configuration
+// ==========================================
+/**
+ * Batch Operation Endpoint Configuration Schema
+ * Configuration for batch/bulk operation endpoints
+ *
+ * @example
+ * {
+ *   "maxBatchSize": 200,
+ *   "enableBatchEndpoint": true,
+ *   "enableCreateMany": true,
+ *   "enableUpdateMany": true,
+ *   "enableDeleteMany": true
+ * }
+ */
+exports.BatchEndpointsConfigSchema = zod_1.z.object({
+    /**
+     * Maximum batch size
+     */
+    maxBatchSize: zod_1.z.number().int().min(1).max(1000).default(200)
+        .describe('Maximum records per batch operation'),
+    /**
+     * Enable generic batch endpoint
+     */
+    enableBatchEndpoint: zod_1.z.boolean().default(true)
+        .describe('Enable POST /data/:object/batch endpoint'),
+    /**
+     * Enable specific batch operations
+     */
+    operations: zod_1.z.object({
+        createMany: zod_1.z.boolean().default(true).describe('Enable POST /data/:object/createMany'),
+        updateMany: zod_1.z.boolean().default(true).describe('Enable POST /data/:object/updateMany'),
+        deleteMany: zod_1.z.boolean().default(true).describe('Enable POST /data/:object/deleteMany'),
+        upsertMany: zod_1.z.boolean().default(true).describe('Enable POST /data/:object/upsertMany'),
+    }).optional().describe('Enable/disable specific batch operations'),
+    /**
+     * Transaction mode default
+     */
+    defaultAtomic: zod_1.z.boolean().default(true)
+        .describe('Default atomic/transaction mode for batch operations'),
+});
+// ==========================================
+// Route Generation Configuration
+// ==========================================
+/**
+ * Route Generation Configuration Schema
+ * Controls automatic route generation for objects
+ */
+exports.RouteGenerationConfigSchema = zod_1.z.object({
+    /**
+     * Objects to include (if empty, include all)
+     */
+    includeObjects: zod_1.z.array(zod_1.z.string()).optional()
+        .describe('Specific objects to generate routes for (empty = all)'),
+    /**
+     * Objects to exclude
+     */
+    excludeObjects: zod_1.z.array(zod_1.z.string()).optional()
+        .describe('Objects to exclude from route generation'),
+    /**
+     * Object name transformations
+     */
+    nameTransform: zod_1.z.enum(['none', 'plural', 'kebab-case', 'camelCase']).default('none')
+        .describe('Transform object names in URLs'),
+    /**
+     * Custom route overrides per object
+     */
+    overrides: zod_1.z.record(zod_1.z.string(), zod_1.z.object({
+        enabled: zod_1.z.boolean().optional().describe('Enable/disable routes for this object'),
+        basePath: zod_1.z.string().optional().describe('Custom base path'),
+        operations: zod_1.z.record(exports.CrudOperation, zod_1.z.boolean()).optional()
+            .describe('Enable/disable specific operations'),
+    })).optional().describe('Per-object route customization'),
+});
+// ==========================================
+// Complete REST Server Configuration
+// ==========================================
+/**
+ * REST Server Configuration Schema
+ * Complete configuration for REST API server with auto-generated endpoints
+ *
+ * @example
+ * {
+ *   "api": {
+ *     "version": "v1",
+ *     "basePath": "/api",
+ *     "enableCrud": true,
+ *     "enableMetadata": true,
+ *     "enableBatch": true
+ *   },
+ *   "crud": {
+ *     "dataPrefix": "/data"
+ *   },
+ *   "metadata": {
+ *     "prefix": "/meta",
+ *     "enableCache": true
+ *   },
+ *   "batch": {
+ *     "maxBatchSize": 200
+ *   },
+ *   "routes": {
+ *     "excludeObjects": ["system_log"]
+ *   }
+ * }
+ */
+exports.RestServerConfigSchema = zod_1.z.object({
+    /**
+     * API configuration
+     */
+    api: exports.RestApiConfigSchema.optional().describe('REST API configuration'),
+    /**
+     * CRUD endpoints configuration
+     */
+    crud: exports.CrudEndpointsConfigSchema.optional().describe('CRUD endpoints configuration'),
+    /**
+     * Metadata endpoints configuration
+     */
+    metadata: exports.MetadataEndpointsConfigSchema.optional().describe('Metadata endpoints configuration'),
+    /**
+     * Batch endpoints configuration
+     */
+    batch: exports.BatchEndpointsConfigSchema.optional().describe('Batch endpoints configuration'),
+    /**
+     * Route generation configuration
+     */
+    routes: exports.RouteGenerationConfigSchema.optional().describe('Route generation configuration'),
+});
+// ==========================================
+// Endpoint Registry
+// ==========================================
+/**
+ * Generated Endpoint Schema
+ * Represents a generated REST endpoint
+ */
+exports.GeneratedEndpointSchema = zod_1.z.object({
+    /**
+     * Endpoint identifier
+     */
+    id: zod_1.z.string().describe('Unique endpoint identifier'),
+    /**
+     * HTTP method
+     */
+    method: http_zod_1.HttpMethod.describe('HTTP method'),
+    /**
+     * Full URL path
+     */
+    path: zod_1.z.string().describe('Full URL path'),
+    /**
+     * Object this endpoint operates on
+     */
+    object: zod_1.z.string().describe('Object name (snake_case)'),
+    /**
+     * Operation type
+     */
+    operation: zod_1.z.union([exports.CrudOperation, zod_1.z.string()]).describe('Operation type'),
+    /**
+     * Handler reference
+     */
+    handler: zod_1.z.string().describe('Handler function identifier'),
+    /**
+     * Endpoint metadata
+     */
+    metadata: zod_1.z.object({
+        summary: zod_1.z.string().optional(),
+        description: zod_1.z.string().optional(),
+        tags: zod_1.z.array(zod_1.z.string()).optional(),
+        deprecated: zod_1.z.boolean().optional(),
+    }).optional(),
+});
+/**
+ * Endpoint Registry Schema
+ * Registry of all generated endpoints
+ */
+exports.EndpointRegistrySchema = zod_1.z.object({
+    /**
+     * Generated endpoints
+     */
+    endpoints: zod_1.z.array(exports.GeneratedEndpointSchema).describe('All generated endpoints'),
+    /**
+     * Total endpoint count
+     */
+    total: zod_1.z.number().int().describe('Total number of endpoints'),
+    /**
+     * Endpoints by object
+     */
+    byObject: zod_1.z.record(zod_1.z.string(), zod_1.z.array(exports.GeneratedEndpointSchema)).optional()
+        .describe('Endpoints grouped by object'),
+    /**
+     * Endpoints by operation
+     */
+    byOperation: zod_1.z.record(zod_1.z.string(), zod_1.z.array(exports.GeneratedEndpointSchema)).optional()
+        .describe('Endpoints grouped by operation'),
+});
+// ==========================================
+// Helper Functions
+// ==========================================
+/**
+ * Helper to create REST API configuration
+ */
+exports.RestApiConfig = Object.assign(exports.RestApiConfigSchema, {
+    create: (config) => config,
+});
+/**
+ * Helper to create REST server configuration
+ */
+exports.RestServerConfig = Object.assign(exports.RestServerConfigSchema, {
+    create: (config) => config,
+});

package/dist/api/router.zod.d.ts

@@ -1,9 +1,6 @@
 import { z } from 'zod';
-/**
- * HTTP Method Enum
- */
-export declare const HttpMethod: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>;
-export type HttpMethod = z.infer<typeof HttpMethod>;
+import { HttpMethod } from '../shared/http.zod';
+export { HttpMethod };
 /**
  * Route Category Enum
  * Classifies routes for middleware application and security policies.
@@ -49,26 +46,26 @@ export declare const RouteDefinitionSchema: z.ZodObject<{
     rateLimit: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     path: string;
-    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
     handler: string;
-    category: "api" | "system" | "webhook" | "plugin" | "auth" | "static";
+    category: "api" | "system" | "webhook" | "auth" | "plugin" | "static";
     public: boolean;
     summary?: string | undefined;
     description?: string | undefined;
     timeout?: number | undefined;
-    permissions?: string[] | undefined;
     rateLimit?: string | undefined;
+    permissions?: string[] | undefined;
 }, {
     path: string;
-    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
     handler: string;
     summary?: string | undefined;
     description?: string | undefined;
     timeout?: number | undefined;
-    category?: "api" | "system" | "webhook" | "plugin" | "auth" | "static" | undefined;
+    category?: "api" | "system" | "webhook" | "auth" | "plugin" | "static" | undefined;
+    rateLimit?: string | undefined;
     permissions?: string[] | undefined;
     public?: boolean | undefined;
-    rateLimit?: string | undefined;
 }>;
 export type RouteDefinition = z.infer<typeof RouteDefinitionSchema>;
 /**
@@ -93,48 +90,54 @@ export declare const RouterConfigSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         data: string;
         metadata: string;
+        graphql: string;
         storage: string;
         auth: string;
         automation: string;
-        graphql: string;
     }, {
         data?: string | undefined;
         metadata?: string | undefined;
+        graphql?: string | undefined;
         storage?: string | undefined;
         auth?: string | undefined;
         automation?: string | undefined;
-        graphql?: string | undefined;
     }>>;
     /**
      * Cross-Origin Resource Sharing
      */
     cors: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
-        origin: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        origins: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         methods: z.ZodOptional<z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>, "many">>;
+        credentials: z.ZodDefault<z.ZodBoolean>;
+        maxAge: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
-        origin: string | string[];
-        methods?: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS")[] | undefined;
+        origins: string | string[];
+        credentials: boolean;
+        methods?: ("GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS")[] | undefined;
+        maxAge?: number | undefined;
     }, {
         enabled?: boolean | undefined;
-        origin?: string | string[] | undefined;
-        methods?: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS")[] | undefined;
+        origins?: string | string[] | undefined;
+        methods?: ("GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS")[] | undefined;
+        credentials?: boolean | undefined;
+        maxAge?: number | undefined;
     }>>;
     /**
      * Static asset mounts
      */
     staticMounts: z.ZodOptional<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
-        dir: z.ZodString;
+        directory: z.ZodString;
         cacheControl: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        dir: string;
+        directory: string;
         cacheControl?: string | undefined;
     }, {
         path: string;
-        dir: string;
+        directory: string;
         cacheControl?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
@@ -142,39 +145,43 @@ export declare const RouterConfigSchema: z.ZodObject<{
     mounts: {
         data: string;
         metadata: string;
+        graphql: string;
         storage: string;
         auth: string;
         automation: string;
-        graphql: string;
     };
     cors?: {
         enabled: boolean;
-        origin: string | string[];
-        methods?: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS")[] | undefined;
+        origins: string | string[];
+        credentials: boolean;
+        methods?: ("GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS")[] | undefined;
+        maxAge?: number | undefined;
     } | undefined;
     staticMounts?: {
         path: string;
-        dir: string;
+        directory: string;
         cacheControl?: string | undefined;
     }[] | undefined;
 }, {
+    cors?: {
+        enabled?: boolean | undefined;
+        origins?: string | string[] | undefined;
+        methods?: ("GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS")[] | undefined;
+        credentials?: boolean | undefined;
+        maxAge?: number | undefined;
+    } | undefined;
     basePath?: string | undefined;
     mounts?: {
         data?: string | undefined;
         metadata?: string | undefined;
+        graphql?: string | undefined;
         storage?: string | undefined;
         auth?: string | undefined;
         automation?: string | undefined;
-        graphql?: string | undefined;
-    } | undefined;
-    cors?: {
-        enabled?: boolean | undefined;
-        origin?: string | string[] | undefined;
-        methods?: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS")[] | undefined;
     } | undefined;
     staticMounts?: {
         path: string;
-        dir: string;
+        directory: string;
         cacheControl?: string | undefined;
     }[] | undefined;
 }>;

package/dist/api/router.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.zod.d.ts","sourceRoot":"","sources":["../../src/api/router.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,UAAU,yEAQrB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,aAAa,qEAOxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;OAEG;;;IAIH;;OAEG;;;IAIH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;EAGH,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;IAUH;;OAEG;;;;;;;;;;;;;;IAOH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMH,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"router.zod.d.ts","sourceRoot":"","sources":["../../src/api/router.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAuC,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;;GAGG;AACH,eAAO,MAAM,aAAa,qEAOxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;OAEG;;;IAIH;;OAEG;;;IAIH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;EAGH,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;IAUH;;OAEG;;;;;;;;;;;;;;;;;;;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/api/router.zod.js

@@ -2,18 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RouterConfigSchema = exports.RouteDefinitionSchema = exports.RouteCategory = exports.HttpMethod = void 0;
 const zod_1 = require("zod");
-/**
- * HTTP Method Enum
- */
-exports.HttpMethod = zod_1.z.enum([
-    'GET',
-    'POST',
-    'PUT',
-    'DELETE',
-    'PATCH',
-    'HEAD',
-    'OPTIONS'
-]);
+const http_zod_1 = require("../shared/http.zod");
+Object.defineProperty(exports, "HttpMethod", { enumerable: true, get: function () { return http_zod_1.HttpMethod; } });
 /**
  * Route Category Enum
  * Classifies routes for middleware application and security policies.
@@ -34,7 +24,7 @@ exports.RouteDefinitionSchema = zod_1.z.object({
     /**
      * HTTP Method
      */
-    method: exports.HttpMethod,
+    method: http_zod_1.HttpMethod,
     /**
      * URL Path Pattern (supports parameters like /user/:id)
      */
@@ -87,17 +77,9 @@ exports.RouterConfigSchema = zod_1.z.object({
     /**
      * Cross-Origin Resource Sharing
      */
-    cors: zod_1.z.object({
-        enabled: zod_1.z.boolean().default(true),
-        origin: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).default('*'),
-        methods: zod_1.z.array(exports.HttpMethod).optional(),
-    }).optional(),
+    cors: http_zod_1.CorsConfigSchema.optional(),
     /**
      * Static asset mounts
      */
-    staticMounts: zod_1.z.array(zod_1.z.object({
-        path: zod_1.z.string().describe('URL mount path'),
-        dir: zod_1.z.string().describe('Physical directory path'),
-        cacheControl: zod_1.z.string().optional()
-    })).optional(),
+    staticMounts: zod_1.z.array(http_zod_1.StaticMountSchema).optional(),
 });