@classytic/arc 1.1.0 → 2.1.3

package/dist/adapters/index.d.ts

@@ -1,237 +0,0 @@
-import { D as DataAdapter, y as CrudRepository, o as RepositoryLike, m as SchemaMetadata, R as RouteSchemaOptions, af as OpenApiSchemas, Q as QueryParserInterface, ae as ParsedQuery, V as ValidationResult } from '../index-B4t03KQ0.js';
-export { ag as AdapterFactory, F as FieldMetadata, n as RelationMetadata } from '../index-B4t03KQ0.js';
-import { Model } from 'mongoose';
-import 'fastify';
-import '../types-B99TBmFV.js';
-
-/**
- * Mongoose Adapter - Type-Safe Database Adapter
- *
- * Bridges Mongoose models with Arc's resource system.
- * Proper generics eliminate the need for 'as any' casts.
- */
-
-/**
- * Options for creating a Mongoose adapter
- *
- * @typeParam TDoc - The document type (inferred or explicit)
- */
-interface MongooseAdapterOptions<TDoc = unknown> {
-    /** Mongoose model instance */
-    model: Model<any>;
-    /** Repository implementing CRUD operations - accepts any repository-like object */
-    repository: CrudRepository<TDoc> | RepositoryLike;
-}
-/**
- * Mongoose data adapter with proper type safety
- *
- * @typeParam TDoc - The document type
- */
-declare class MongooseAdapter<TDoc = unknown> implements DataAdapter<TDoc> {
-    readonly type: "mongoose";
-    readonly name: string;
-    readonly model: Model<any>;
-    readonly repository: CrudRepository<TDoc> | RepositoryLike;
-    constructor(options: MongooseAdapterOptions<TDoc>);
-    /**
-     * Get schema metadata from Mongoose model
-     */
-    getSchemaMetadata(): SchemaMetadata;
-    /**
-     * Generate OpenAPI schemas from Mongoose model
-     */
-    generateSchemas(schemaOptions?: RouteSchemaOptions): OpenApiSchemas | null;
-    /**
-     * Extract relation metadata
-     */
-    private extractRelations;
-    /**
-     * Convert Mongoose type to OpenAPI type
-     */
-    private mongooseTypeToOpenApi;
-}
-/**
- * Create Mongoose adapter with flexible type acceptance
- *
- * Accepts any repository with CRUD methods - no 'as any' needed.
- *
- * @example
- * ```typescript
- * // Works with any MongoKit repository - no cast needed
- * const adapter = createMongooseAdapter({
- *   model: ProductModel,
- *   repository: productRepository,
- * });
- * ```
- */
-declare function createMongooseAdapter<TDoc = unknown>(options: MongooseAdapterOptions<TDoc>): DataAdapter<TDoc>;
-
-/**
- * Prisma Adapter - PostgreSQL/MySQL/SQLite Implementation
- *
- * Bridges Prisma Client with Arc's DataAdapter interface.
- * Supports Prisma 5+ with all database providers.
- *
- * Features:
- * ✅ Schema generation (OpenAPI docs from DMMF)
- * ✅ Health checks (database connectivity)
- * ✅ Query parsing (URL params → Prisma where/orderBy)
- * ✅ Policy filter translation
- * ✅ Soft delete preset support
- * ✅ Multi-tenant preset support
- *
- * @example
- * ```typescript
- * import { PrismaClient, Prisma } from '@prisma/client';
- * import { createPrismaAdapter, PrismaQueryParser } from '@classytic/arc/adapters';
- *
- * const prisma = new PrismaClient();
- *
- * const userAdapter = createPrismaAdapter({
- *   client: prisma,
- *   modelName: 'user',
- *   repository: new UserRepository(prisma),
- *   dmmf: Prisma.dmmf, // For schema generation
- *   queryParser: new PrismaQueryParser(), // Optional: custom parser
- * });
- * ```
- */
-
-/**
- * Options for PrismaQueryParser
- */
-interface PrismaQueryParserOptions {
-    /** Maximum allowed limit value (default: 1000) */
-    maxLimit?: number;
-    /** Default limit for pagination (default: 20) */
-    defaultLimit?: number;
-    /** Enable soft delete filtering by default (default: true) */
-    softDeleteEnabled?: boolean;
-    /** Field name for soft delete (default: 'deletedAt') */
-    softDeleteField?: string;
-}
-/**
- * Prisma Query Parser - Converts URL parameters to Prisma query format
- *
- * Translates Arc's query format to Prisma's where/orderBy/take/skip structure.
- *
- * @example
- * ```typescript
- * const parser = new PrismaQueryParser();
- *
- * // URL: ?status=active&price[gte]=100&sort=-createdAt&page=2&limit=10
- * const prismaQuery = parser.toPrismaQuery(parsedQuery);
- * // Returns:
- * // {
- * //   where: { status: 'active', price: { gte: 100 }, deletedAt: null },
- * //   orderBy: { createdAt: 'desc' },
- * //   take: 10,
- * //   skip: 10,
- * // }
- * ```
- */
-declare class PrismaQueryParser implements QueryParserInterface {
-    private readonly maxLimit;
-    private readonly defaultLimit;
-    private readonly softDeleteEnabled;
-    private readonly softDeleteField;
-    /** Map Arc operators to Prisma operators */
-    private readonly operatorMap;
-    constructor(options?: PrismaQueryParserOptions);
-    /**
-     * Parse URL query parameters (delegates to ArcQueryParser format)
-     */
-    parse(query: Record<string, unknown> | null | undefined): ParsedQuery;
-    /**
-     * Convert ParsedQuery to Prisma query options
-     */
-    toPrismaQuery(parsed: ParsedQuery, policyFilters?: Record<string, unknown>): PrismaQueryOptions;
-    /**
-     * Translate Arc/MongoDB-style filters to Prisma where clause
-     */
-    private translateFilters;
-    private parseNumber;
-    private parseSort;
-    private parseSelect;
-    private parseFilters;
-    private coerceValue;
-}
-/**
- * Prisma query options returned by toPrismaQuery
- */
-interface PrismaQueryOptions {
-    where?: Record<string, unknown>;
-    orderBy?: Array<Record<string, 'asc' | 'desc'>>;
-    take?: number;
-    skip?: number;
-    select?: Record<string, boolean>;
-    include?: Record<string, boolean>;
-}
-interface PrismaAdapterOptions<TModel> {
-    /** Prisma client instance */
-    client: any;
-    /** Model name (e.g., 'user', 'product') */
-    modelName: string;
-    /** Repository instance implementing CRUD operations */
-    repository: CrudRepository<TModel>;
-    /** Optional: Prisma DMMF (Data Model Meta Format) for schema extraction */
-    dmmf?: any;
-    /** Optional: Custom query parser (default: PrismaQueryParser) */
-    queryParser?: PrismaQueryParser;
-    /** Enable soft delete filtering (default: true) */
-    softDeleteEnabled?: boolean;
-    /** Field name for soft delete (default: 'deletedAt') */
-    softDeleteField?: string;
-}
-declare class PrismaAdapter<TModel = any> implements DataAdapter<TModel> {
-    readonly type: "prisma";
-    readonly name: string;
-    readonly repository: CrudRepository<TModel>;
-    readonly queryParser: PrismaQueryParser;
-    private client;
-    private modelName;
-    private dmmf?;
-    private softDeleteEnabled;
-    private softDeleteField;
-    constructor(options: PrismaAdapterOptions<TModel>);
-    /**
-     * Parse URL query parameters and convert to Prisma query options
-     */
-    parseQuery(query: Record<string, unknown>, policyFilters?: Record<string, unknown>): PrismaQueryOptions;
-    /**
-     * Apply policy filters to existing Prisma where clause
-     * Used for multi-tenant, ownership, and other security filters
-     */
-    applyPolicyFilters(where: Record<string, unknown>, policyFilters: Record<string, unknown>): Record<string, unknown>;
-    generateSchemas(options?: RouteSchemaOptions): OpenApiSchemas | null;
-    getSchemaMetadata(): SchemaMetadata | null;
-    validate(data: unknown): Promise<ValidationResult>;
-    healthCheck(): Promise<boolean>;
-    close(): Promise<void>;
-    private buildEntitySchema;
-    private buildCreateSchema;
-    private buildUpdateSchema;
-    private shouldSkipField;
-    private convertPrismaFieldToJsonSchema;
-    private convertPrismaFieldToMetadata;
-    private mapPrismaTypeToMetadataType;
-}
-/**
- * Factory function to create Prisma adapter
- *
- * @example
- * import { PrismaClient } from '@prisma/client';
- * import { createPrismaAdapter } from '@classytic/arc';
- *
- * const prisma = new PrismaClient();
- *
- * const userAdapter = createPrismaAdapter({
- *   client: prisma,
- *   modelName: 'user',
- *   repository: userRepository,
- *   dmmf: Prisma.dmmf, // Optional: for schema generation
- * });
- */
-declare function createPrismaAdapter<TModel>(options: PrismaAdapterOptions<TModel>): PrismaAdapter<TModel>;
-
-export { DataAdapter, MongooseAdapter, type MongooseAdapterOptions, PrismaAdapter, type PrismaAdapterOptions, type PrismaQueryOptions, PrismaQueryParser, type PrismaQueryParserOptions, RepositoryLike, SchemaMetadata, ValidationResult, createMongooseAdapter, createPrismaAdapter };