@kontract/adonis 0.1.0

package/dist/builder/openapi-builder.js

@@ -0,0 +1,388 @@
+import { getApiMetadata, getEndpointMetadata, getRegisteredControllers, } from '@blog/openapi-decorators';
+/**
+ * Builds an OpenAPI specification from registered @Api and @Endpoint decorators.
+ *
+ * @example
+ * ```typescript
+ * const builder = new OpenApiBuilder({
+ *   title: 'My API',
+ *   description: 'API description',
+ *   version: '1.0.0',
+ *   servers: [{ url: 'http://localhost:3333', description: 'Development' }],
+ * })
+ *
+ * const spec = builder.build()
+ * ```
+ */
+export class OpenApiBuilder {
+    document;
+    schemas = new Map();
+    tags = new Map();
+    securitySchemeName;
+    constructor(options) {
+        this.securitySchemeName = options.securityScheme?.name ?? 'BearerAuth';
+        const securitySchemes = {
+            [this.securitySchemeName]: options.securityScheme ?? {
+                type: 'http',
+                scheme: 'bearer',
+                bearerFormat: 'JWT',
+                description: 'Access token obtained from /api/v1/auth/login',
+            },
+        };
+        this.document = {
+            openapi: options.openapiVersion ?? '3.1.0',
+            info: {
+                title: options.title,
+                description: options.description,
+                version: options.version,
+            },
+            servers: options.servers,
+            tags: [],
+            paths: {},
+            components: {
+                schemas: {},
+                securitySchemes: securitySchemes,
+            },
+        };
+    }
+    /**
+     * Build the OpenAPI document from registered decorators.
+     */
+    build() {
+        const controllers = getRegisteredControllers();
+        for (const controller of controllers) {
+            const apiMeta = getApiMetadata(controller);
+            const endpoints = getEndpointMetadata(controller);
+            if (!apiMeta)
+                continue;
+            // Register tag
+            this.tags.set(apiMeta.tag, apiMeta.description);
+            // Process endpoints
+            for (const endpoint of endpoints) {
+                this.processEndpoint(apiMeta, endpoint);
+            }
+        }
+        // Finalize tags
+        this.document.tags = Array.from(this.tags.entries())
+            .map(([name, description]) => ({ name, ...(description && { description }) }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        // Finalize schemas
+        for (const [name, schema] of this.schemas) {
+            this.document.components.schemas[name] = this.toJsonSchema(schema);
+        }
+        return this.document;
+    }
+    /**
+     * Process a single endpoint and add it to the document.
+     */
+    processEndpoint(apiMeta, endpoint) {
+        // Convert path params (:id) to OpenAPI format ({id})
+        const openApiPath = endpoint.path.replace(/:(\w+)/g, '{$1}');
+        if (!this.document.paths[openApiPath]) {
+            this.document.paths[openApiPath] = {};
+        }
+        // Build operation object incrementally
+        const operation = {
+            tags: [apiMeta.tag],
+            summary: endpoint.summary,
+            operationId: endpoint.operationId ?? this.generateOperationId(endpoint),
+        };
+        if (endpoint.description) {
+            operation.description = endpoint.description;
+        }
+        if (endpoint.deprecated) {
+            operation.deprecated = true;
+        }
+        // Security
+        if (endpoint.auth === 'required') {
+            operation.security = [{ [this.securitySchemeName]: [] }];
+        }
+        else {
+            operation.security = [];
+        }
+        // Parameters
+        const parameters = this.buildParameters(endpoint);
+        if (parameters.length > 0) {
+            operation.parameters = parameters;
+        }
+        // Request body
+        if (endpoint.file) {
+            operation.requestBody = this.buildFileRequestBody(endpoint);
+        }
+        else if (endpoint.body) {
+            const schemaName = this.registerSchema(endpoint.body);
+            const bodyDescription = endpoint.body
+                .description;
+            operation.requestBody = {
+                required: true,
+                ...(bodyDescription && { description: bodyDescription }),
+                content: {
+                    'application/json': {
+                        schema: { $ref: `#/components/schemas/${schemaName}` },
+                    },
+                },
+            };
+        }
+        // Responses (required field)
+        operation.responses = this.buildResponses(endpoint);
+        this.document.paths[openApiPath][endpoint.method] = operation;
+    }
+    /**
+     * Build file upload request body.
+     */
+    buildFileRequestBody(endpoint) {
+        const file = endpoint.file;
+        const fileSchema = file.multiple
+            ? {
+                type: 'array',
+                items: { type: 'string', format: 'binary' },
+                description: file.description ?? 'Files to upload',
+            }
+            : {
+                type: 'string',
+                format: 'binary',
+                description: file.description ?? 'File to upload',
+            };
+        const schema = {
+            type: 'object',
+            required: [file.fieldName],
+            properties: {
+                [file.fieldName]: fileSchema,
+            },
+        };
+        // Merge with body schema if present
+        if (endpoint.body?.properties) {
+            const bodyProps = endpoint.body.properties;
+            const schemaProps = schema.properties;
+            for (const [name, propSchema] of Object.entries(bodyProps)) {
+                schemaProps[name] = this.toJsonSchema(propSchema);
+            }
+            if (endpoint.body.required) {
+                const schemaRequired = schema.required;
+                for (const field of endpoint.body.required) {
+                    if (!schemaRequired.includes(field)) {
+                        schemaRequired.push(field);
+                    }
+                }
+            }
+        }
+        return {
+            required: true,
+            description: file.description ?? 'File upload',
+            content: {
+                'multipart/form-data': { schema },
+            },
+        };
+    }
+    /**
+     * Build parameters from endpoint metadata.
+     */
+    buildParameters(endpoint) {
+        const parameters = [];
+        // Extract path parameter names from URL
+        const pathParamNames = new Set();
+        const pathParamRegex = /:(\w+)/g;
+        let match;
+        while ((match = pathParamRegex.exec(endpoint.path)) !== null) {
+            pathParamNames.add(match[1]);
+        }
+        // Path parameters from schema
+        if (endpoint.params) {
+            parameters.push(...this.schemaToParameters(endpoint.params, 'path'));
+            if (endpoint.params.properties) {
+                for (const name of Object.keys(endpoint.params.properties)) {
+                    pathParamNames.delete(name);
+                }
+            }
+        }
+        // Add remaining path parameters
+        for (const name of pathParamNames) {
+            parameters.push({
+                name,
+                in: 'path',
+                required: true,
+                description: `The ${name} parameter`,
+                schema: { type: 'string' },
+            });
+        }
+        // Query parameters
+        if (endpoint.query) {
+            parameters.push(...this.schemaToParameters(endpoint.query, 'query'));
+        }
+        return parameters;
+    }
+    /**
+     * Convert a TypeBox schema to OpenAPI parameters.
+     */
+    schemaToParameters(schema, location) {
+        const parameters = [];
+        if (schema.type !== 'object' || !schema.properties) {
+            return parameters;
+        }
+        const required = new Set(schema.required ?? []);
+        for (const [name, propSchema] of Object.entries(schema.properties)) {
+            const prop = propSchema;
+            parameters.push({
+                name,
+                in: location,
+                required: location === 'path' ? true : required.has(name),
+                ...(prop.description && { description: prop.description }),
+                schema: this.toJsonSchema(prop),
+            });
+        }
+        return parameters;
+    }
+    /**
+     * Build responses from endpoint metadata.
+     */
+    buildResponses(endpoint) {
+        const responses = {};
+        for (const [status, response] of Object.entries(endpoint.responses)) {
+            if (response.schema === null) {
+                responses[status] = {
+                    description: response.description ?? this.defaultDescription(Number(status)),
+                };
+            }
+            else {
+                const schemaName = this.registerSchema(response.schema);
+                responses[status] = {
+                    description: response.description ?? this.defaultDescription(Number(status)),
+                    content: {
+                        'application/json': {
+                            schema: { $ref: `#/components/schemas/${schemaName}` },
+                        },
+                    },
+                };
+            }
+        }
+        // Auto-add 401 for auth required endpoints
+        if (endpoint.auth === 'required' && !responses['401']) {
+            responses['401'] = {
+                description: 'Unauthorized - authentication required',
+                content: {
+                    'application/json': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                message: { type: 'string', description: 'Error message' },
+                            },
+                            required: ['message'],
+                        },
+                    },
+                },
+            };
+        }
+        return responses;
+    }
+    /**
+     * Register a schema and return its name.
+     */
+    registerSchema(schema) {
+        const name = schema.$id ?? schema.title ?? `Schema${this.schemas.size + 1}`;
+        if (!this.schemas.has(name)) {
+            this.schemas.set(name, schema);
+            this.extractNestedSchemas(schema);
+        }
+        return name;
+    }
+    /**
+     * Extract and register nested schemas with $id.
+     */
+    extractNestedSchemas(schema) {
+        if (!schema || typeof schema !== 'object')
+            return;
+        if (Array.isArray(schema)) {
+            schema.forEach((item) => this.extractNestedSchemas(item));
+            return;
+        }
+        const record = schema;
+        if (record.$id && typeof record.$id === 'string') {
+            if (!this.schemas.has(record.$id)) {
+                this.schemas.set(record.$id, schema);
+            }
+        }
+        for (const value of Object.values(record)) {
+            this.extractNestedSchemas(value);
+        }
+    }
+    /**
+     * Convert TypeBox schema to JSON Schema (for OpenAPI).
+     */
+    toJsonSchema(schema) {
+        const result = JSON.parse(JSON.stringify(schema));
+        return this.removeTypeBoxProps(result);
+    }
+    /**
+     * Remove TypeBox-specific properties from schema.
+     */
+    removeTypeBoxProps(obj) {
+        if (obj === null || typeof obj !== 'object') {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.removeTypeBoxProps(item));
+        }
+        const record = obj;
+        const result = {};
+        const isSchemaDefinition = 'type' in record
+            || 'anyOf' in record
+            || 'oneOf' in record
+            || 'allOf' in record;
+        for (const [key, value] of Object.entries(record)) {
+            // Skip $id (TypeBox schema identifier)
+            if (key === '$id')
+                continue;
+            // Skip errorMessage in schema definitions
+            if (key === 'errorMessage' && isSchemaDefinition)
+                continue;
+            result[key] = this.removeTypeBoxProps(value);
+        }
+        return result;
+    }
+    /**
+     * Generate an operation ID from endpoint metadata.
+     */
+    generateOperationId(endpoint) {
+        const { method, path, methodName } = endpoint;
+        const genericNames = ['index', 'show', 'store', 'update', 'destroy'];
+        if (!genericNames.includes(methodName)) {
+            return methodName;
+        }
+        const segments = path
+            .replace(/^\/api\/v\d+\//, '')
+            .replace(/:/g, '')
+            .split('/')
+            .filter(Boolean);
+        const resource = segments[0] ?? 'resource';
+        const hasId = segments.includes('id');
+        const prefixes = {
+            get: hasId ? 'get' : 'list',
+            post: 'create',
+            put: 'update',
+            patch: 'patch',
+            delete: 'delete',
+        };
+        const prefix = prefixes[method] ?? method;
+        const singular = resource.replace(/s$/, '');
+        const name = hasId ? singular : resource;
+        return `${prefix}${name.charAt(0).toUpperCase() + name.slice(1)}`;
+    }
+    /**
+     * Get default description for a status code.
+     */
+    defaultDescription(status) {
+        const descriptions = {
+            200: 'Successful response',
+            201: 'Resource created',
+            204: 'No content',
+            400: 'Bad request',
+            401: 'Unauthorized',
+            403: 'Forbidden',
+            404: 'Not found',
+            422: 'Validation error',
+            500: 'Internal server error',
+        };
+        return descriptions[status] ?? 'Response';
+    }
+}
+//# sourceMappingURL=openapi-builder.js.map

package/dist/builder/openapi-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-builder.js","sourceRoot":"","sources":["../../src/builder/openapi-builder.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * kontract-adonis
+ *
+ * AdonisJS adapter for kontract.
+ *
+ * @example
+ * ```typescript
+ * // Using Elysia-style route builders (recommended)
+ * import { get, post, Type, registerController, defineController } from '@kontract/adonis'
+ *
+ * const getUser = get('/api/v1/users/:id',
+ *   async ({ params, reply, error }) => {
+ *     const user = await User.find(params.id)
+ *     if (!user) return error.notFound('User not found')
+ *     return reply.ok(user.serialize())
+ *   },
+ *   {
+ *     params: Type.Object({ id: Type.String() }),
+ *     responses: {
+ *       200: { schema: UserResponse },
+ *       404: { schema: ApiError },
+ *     },
+ *   }
+ * )
+ *
+ * const usersController = defineController({ tag: 'Users' }, { getUser })
+ * ```
+ */
+export { Type, type Static } from '@sinclair/typebox';
+export { binary, defineConfig, getConfig, defineController, ok, created, accepted, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, serviceUnavailable, apiError, type ApiResponse, type BinaryResponse, type EndpointMetadata, type ApiMetadata, } from 'kontract';
+export { registerController, registerControllers, get, post, put, patch, del, type RegisterControllerOptions, type AdonisHandlerContext, type AdonisRouteHandler, type AdonisRouteConfig, type AdonisRouteDefinition, type GetRouteOptions, type BodyRouteOptions, } from './adapters/controller-registrar.js';
+export { createAjvValidator, validate, stripNestedIds, getDefaultValidator, resetDefaultValidator, AjvValidationError, type AjvValidatorOptions, } from './validation/index.js';
+export { OpenApiBuilder, type OpenApiBuilderOptions } from './builder/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,EACL,MAAM,EACN,YAAY,EACZ,SAAS,EACT,gBAAgB,EAEhB,EAAE,EACF,OAAO,EACP,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAA;AAKjB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EAEnB,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,oCAAoC,CAAA;AAG3C,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,45 @@
+/**
+ * kontract-adonis
+ *
+ * AdonisJS adapter for kontract.
+ *
+ * @example
+ * ```typescript
+ * // Using Elysia-style route builders (recommended)
+ * import { get, post, Type, registerController, defineController } from '@kontract/adonis'
+ *
+ * const getUser = get('/api/v1/users/:id',
+ *   async ({ params, reply, error }) => {
+ *     const user = await User.find(params.id)
+ *     if (!user) return error.notFound('User not found')
+ *     return reply.ok(user.serialize())
+ *   },
+ *   {
+ *     params: Type.Object({ id: Type.String() }),
+ *     responses: {
+ *       200: { schema: UserResponse },
+ *       404: { schema: ApiError },
+ *     },
+ *   }
+ * )
+ *
+ * const usersController = defineController({ tag: 'Users' }, { getUser })
+ * ```
+ */
+// ============ TypeBox re-exports for schema definitions ============
+export { Type } from '@sinclair/typebox';
+// Re-export core helpers and types from kontract
+export { binary, defineConfig, getConfig, defineController, 
+// Response helpers
+ok, created, accepted, noContent, badRequest, unauthorized, forbidden, notFound, conflict, unprocessableEntity, tooManyRequests, internalServerError, serviceUnavailable, apiError, } from 'kontract';
+// ============ Adapters ============
+// Response helpers (reply.*, error.*) are provided via the handler context
+// and pre-typed based on the route's responses config.
+export { registerController, registerControllers, 
+// Elysia-style route builders (method as function name)
+get, post, put, patch, del, } from './adapters/controller-registrar.js';
+// ============ Validation ============
+export { createAjvValidator, validate, stripNestedIds, getDefaultValidator, resetDefaultValidator, AjvValidationError, } from './validation/index.js';
+// ============ Builder ============
+export { OpenApiBuilder } from './builder/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,sEAAsE;AACtE,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAA;AAErD,iDAAiD;AACjD,OAAO,EACL,MAAM,EACN,YAAY,EACZ,SAAS,EACT,gBAAgB;AAChB,mBAAmB;AACnB,EAAE,EACF,OAAO,EACP,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,GAKT,MAAM,UAAU,CAAA;AAEjB,qCAAqC;AACrC,2EAA2E;AAC3E,uDAAuD;AACvD,OAAO,EACL,kBAAkB,EAClB,mBAAmB;AACnB,wDAAwD;AACxD,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,GAQJ,MAAM,oCAAoC,CAAA;AAE3C,uCAAuC;AACvC,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GAEnB,MAAM,uBAAuB,CAAA;AAE9B,oCAAoC;AACpC,OAAO,EAAE,cAAc,EAA8B,MAAM,oBAAoB,CAAA"}

package/dist/serializers/index.d.ts

@@ -0,0 +1,2 @@
+export { isLucidModel, isTypedModel, isPaginator, hasSerialize, serializeTypedModel, serializeLucidModel, serializePaginator, typedModelSerializer, lucidModelSerializer, paginatorSerializer, serializableSerializer, lucidSerializers, type SerializableModel, type ResponseModel, type PaginatorLike, } from './lucid.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/serializers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAA"}

package/dist/serializers/index.js

@@ -0,0 +1,2 @@
+export { isLucidModel, isTypedModel, isPaginator, hasSerialize, serializeTypedModel, serializeLucidModel, serializePaginator, typedModelSerializer, lucidModelSerializer, paginatorSerializer, serializableSerializer, lucidSerializers, } from './lucid.js';
+//# sourceMappingURL=index.js.map

package/dist/serializers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serializers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GAIjB,MAAM,YAAY,CAAA"}

package/dist/serializers/lucid.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Interface for Lucid-like models with serialize method.
+ */
+export interface SerializableModel {
+    serialize(): Record<string, unknown>;
+}
+/**
+ * Interface for models with toResponse() method.
+ * This matches the TypedModel pattern from the blog-api.
+ */
+export interface ResponseModel {
+    toResponse(): unknown;
+}
+/**
+ * Interface for Lucid-like paginators.
+ */
+export interface PaginatorLike {
+    all(): unknown[];
+    total: number;
+    perPage: number;
+    currentPage: number;
+    lastPage: number;
+    firstPage: number;
+}
+/**
+ * Check if a value is a Lucid model (has serialize method).
+ */
+export declare function isLucidModel(value: unknown): value is SerializableModel;
+/**
+ * Check if a value is a TypedModel (has toResponse method).
+ */
+export declare function isTypedModel(value: unknown): value is ResponseModel;
+/**
+ * Check if a value is a Lucid paginator.
+ */
+export declare function isPaginator(value: unknown): value is PaginatorLike;
+/**
+ * Serializer for TypedModel instances.
+ * Calls toResponse() to get the API response format.
+ */
+export declare function serializeTypedModel(model: ResponseModel): unknown;
+/**
+ * Serializer for generic Lucid models.
+ * Calls serialize() to get the model data.
+ */
+export declare function serializeLucidModel(model: SerializableModel): unknown;
+/**
+ * Serializer for Lucid paginators.
+ * Converts to standard paginated response format.
+ */
+export declare function serializePaginator(paginator: PaginatorLike): unknown;
+/**
+ * Check if a value has a serialize() method (like VersionRecord).
+ */
+export declare function hasSerialize(value: unknown): value is {
+    serialize: () => Record<string, unknown>;
+};
+/**
+ * Serializer registration objects for use with defineConfig().
+ */
+export declare const typedModelSerializer: {
+    check: typeof isTypedModel;
+    serialize: typeof serializeTypedModel;
+    priority: number;
+};
+export declare const lucidModelSerializer: {
+    check: typeof isLucidModel;
+    serialize: typeof serializeLucidModel;
+    priority: number;
+};
+export declare const paginatorSerializer: {
+    check: typeof isPaginator;
+    serialize: typeof serializePaginator;
+    priority: number;
+};
+export declare const serializableSerializer: {
+    check: typeof hasSerialize;
+    serialize: (obj: {
+        serialize: () => unknown;
+    }) => unknown;
+    priority: number;
+};
+/**
+ * All Lucid-related serializers.
+ * Register these with defineConfig() to enable automatic model serialization.
+ */
+export declare const lucidSerializers: ({
+    check: typeof isTypedModel;
+    serialize: typeof serializeTypedModel;
+    priority: number;
+} | {
+    check: typeof isLucidModel;
+    serialize: typeof serializeLucidModel;
+    priority: number;
+} | {
+    check: typeof isPaginator;
+    serialize: typeof serializePaginator;
+    priority: number;
+})[];
+//# sourceMappingURL=lucid.d.ts.map

package/dist/serializers/lucid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid.d.ts","sourceRoot":"","sources":["../../src/serializers/lucid.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,IAAI,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,IAAI,OAAO,EAAE,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAOvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAUlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAErE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAsBpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAOvD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAA;AAED,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAA;AAED,eAAO,MAAM,sBAAsB;;qBAEhB;QAAE,SAAS,EAAE,MAAM,OAAO,CAAA;KAAE;;CAE9C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;IAK5B,CAAA"}