@mostajs/orm-adapter 0.2.0

package/dist/adapters/prisma.adapter.js

@@ -0,0 +1,400 @@
+// prisma.adapter.ts
+// Converts Prisma schema (.prisma) to EntitySchema[] for @mostajs/orm.
+// Parser: @mrleebo/prisma-ast (pure TypeScript, no Rust binary).
+// Author: Dr Hamid MADANI drmdh@msn.com
+// License: AGPL-3.0-or-later
+import { getSchema } from '@mrleebo/prisma-ast';
+import { AbstractAdapter } from '../core/abstract.adapter.js';
+import { WarningCode } from '../core/types.js';
+import { InvalidSchemaError } from '../core/errors.js';
+import { getModels, buildEnumMap, buildModelNameSet, getFields, getBlockAttributes, hasFieldAttribute, getFieldAttribute, getDbAttribute, getArgValue, getKeyValueArg, getPositionalArgs, getFieldTypeName, isUnsupportedType, } from '../utils/prisma-ast-helpers.js';
+import { mapPrismaScalar, extractDbMetadata } from '../utils/prisma-type-mapper.js';
+import { mapPrismaDefault } from '../utils/prisma-default-mapper.js';
+/**
+ * PrismaAdapter — converts .prisma files to EntitySchema[].
+ *
+ * Supports (MVP v0.2.0):
+ *  - All scalar types (String, Int, BigInt, Float, Decimal, Boolean, DateTime, Json, Bytes)
+ *  - Modifiers (?, [])
+ *  - @id, @unique, @default, @map, @updatedAt
+ *  - @@id, @@unique, @@index, @@map
+ *  - @db.VarChar(N), @db.Decimal(p,s) (metadata extraction)
+ *  - Enums (as FieldDef.enum)
+ *  - Relations 1-1, 1-N, M-N (implicit & explicit)
+ *  - Self-relations (named)
+ *  - onDelete actions (Cascade, SetNull, Restrict, NoAction, SetDefault)
+ *
+ * Not yet supported (v0.3+):
+ *  - Composite types (MongoDB embedded docs)
+ *  - Views (preview)
+ *  - Multi-schema
+ *  - @@fulltext, specialized @@index(type: Gin)
+ */
+export class PrismaAdapter extends AbstractAdapter {
+    name = 'prisma';
+    vendor = 'prisma.io';
+    version = '0.2.0';
+    canParse(input) {
+        if (typeof input !== 'string')
+            return false;
+        // Detect presence of Prisma schema block keywords
+        return /^\s*(datasource|generator|model|enum)\s+\w+\s*\{/m.test(input);
+    }
+    async toEntitySchema(input, opts) {
+        if (typeof input !== 'string') {
+            throw new InvalidSchemaError('PrismaAdapter expects a string (.prisma file contents)');
+        }
+        let ast;
+        try {
+            ast = getSchema(input);
+        }
+        catch (e) {
+            throw new InvalidSchemaError(`Failed to parse .prisma: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+        }
+        const models = getModels(ast);
+        const enumMap = buildEnumMap(ast);
+        const modelNames = buildModelNameSet(ast);
+        // Emit a warning per preview feature detected in source (best-effort)
+        this.detectPreviewFeatures(input, opts);
+        // First pass : convert each model to EntitySchema (without M-N synthesis yet)
+        const entities = models.map(m => this.modelToEntity(m, enumMap, modelNames, opts));
+        // Second pass : detect implicit M-N relations and synthesize junction entries
+        this.synthesizeImplicitM2M(entities, models, modelNames, opts);
+        return entities;
+    }
+    // ============================================================
+    // Model -> Entity conversion
+    // ============================================================
+    modelToEntity(model, enumMap, modelNames, opts) {
+        const entity = {
+            name: model.name,
+            collection: this.resolveTableName(model),
+            fields: {},
+            relations: {},
+            indexes: [],
+            timestamps: false,
+        };
+        const fields = getFields(model);
+        // ---- Field-level : classify field vs relation ----
+        for (const field of fields) {
+            if (this.isRelationField(field, modelNames, enumMap)) {
+                const rel = this.fieldToRelation(field, model.name, opts);
+                if (rel)
+                    entity.relations[field.name] = rel;
+            }
+            else {
+                const fd = this.fieldToFieldDef(field, model.name, enumMap, opts);
+                if (fd)
+                    entity.fields[field.name] = fd;
+            }
+        }
+        // ---- Block-level : @@id, @@unique, @@index, @@map, @@schema ----
+        for (const attr of getBlockAttributes(model)) {
+            this.applyBlockAttribute(attr, entity, opts);
+        }
+        // ---- Detect timestamps convention (createdAt + updatedAt) ----
+        if (this.hasTimestampsConvention(fields)) {
+            entity.timestamps = true;
+        }
+        return entity;
+    }
+    resolveTableName(model) {
+        const mapAttr = getBlockAttributes(model).find(a => a.name === 'map');
+        if (mapAttr) {
+            const v = getArgValue(mapAttr);
+            if (typeof v === 'string')
+                return this.unquote(v);
+        }
+        return this.snakeCase(model.name);
+    }
+    // ============================================================
+    // Field classification
+    // ============================================================
+    isRelationField(field, modelNames, enumMap) {
+        // Relation = field whose type is another model (or array of a model)
+        // NOT an enum, NOT a scalar
+        if (isUnsupportedType(field))
+            return false;
+        const t = getFieldTypeName(field);
+        if (modelNames.has(t))
+            return true;
+        if (enumMap.has(t))
+            return false;
+        return false; // scalar or unknown
+    }
+    // ============================================================
+    // Field -> FieldDef
+    // ============================================================
+    fieldToFieldDef(field, entityName, enumMap, opts) {
+        const fieldName = field.name;
+        // Handle Unsupported("xxx") : not mappable
+        if (isUnsupportedType(field)) {
+            this.warn(opts, {
+                code: WarningCode.UNSUPPORTED_FEATURE,
+                message: `Unsupported type for "${fieldName}" — field ignored`,
+                entity: entityName,
+                field: fieldName,
+            });
+            return null;
+        }
+        const prismaType = getFieldTypeName(field);
+        // Check if type is an enum
+        if (enumMap.has(prismaType)) {
+            const values = enumMap.get(prismaType);
+            const fd = {
+                type: 'string',
+                required: !field.optional && !field.array,
+                enum: values,
+            };
+            this.applyFieldAttributes(field, fd, entityName, enumMap, opts);
+            return fd;
+        }
+        // Scalar type
+        const mapping = mapPrismaScalar(prismaType, fieldName, entityName, opts, w => this.warn(opts, w));
+        if (!mapping) {
+            this.warn(opts, {
+                code: WarningCode.UNSUPPORTED_FEATURE,
+                message: `Unknown type "${prismaType}" for field "${fieldName}"`,
+                entity: entityName,
+                field: fieldName,
+            });
+            return null;
+        }
+        const fd = {
+            type: mapping.type,
+            required: !field.optional && !field.array,
+        };
+        // Array modifier → arrayOf
+        if (field.array) {
+            fd.type = 'array';
+            fd.arrayOf = mapping.type;
+        }
+        this.applyFieldAttributes(field, fd, entityName, enumMap, opts);
+        return fd;
+    }
+    applyFieldAttributes(field, fd, entityName, enumMap, opts) {
+        // @unique
+        if (hasFieldAttribute(field, 'unique')) {
+            fd.unique = true;
+        }
+        // @default(...)
+        const defaultAttr = getFieldAttribute(field, 'default');
+        if (defaultAttr) {
+            const raw = getArgValue(defaultAttr);
+            const enumValues = enumMap.get(getFieldTypeName(field));
+            const mapped = mapPrismaDefault(raw, field.name, entityName, enumValues, opts, w => this.warn(opts, w));
+            if (mapped !== undefined)
+                fd.default = mapped;
+        }
+        // @db.VarChar(N), @db.Decimal(p,s) — extract metadata (not persisted in FieldDef,
+        // but can be attached via future meta field; for now, no-op)
+        const dbAttr = getDbAttribute(field);
+        if (dbAttr) {
+            const args = getPositionalArgs(dbAttr);
+            const meta = extractDbMetadata(dbAttr.name, args);
+            // TODO: persist meta if EntitySchema ever supports it
+            void meta;
+        }
+    }
+    // ============================================================
+    // Field -> RelationDef
+    // ============================================================
+    fieldToRelation(field, entityName, opts) {
+        const target = getFieldTypeName(field);
+        const isArray = !!field.array;
+        const isOptional = !!field.optional;
+        // Determine relation type :
+        // - field: Target[]          -> one-to-many (or many-to-many, resolved in second pass)
+        // - field: Target            -> many-to-one (child side of 1-N, or owning side of 1-1)
+        // - field: Target?           -> one-to-one (nullable back-reference)
+        let type;
+        if (isArray) {
+            type = 'one-to-many'; // may be upgraded to 'many-to-many' in second pass
+        }
+        else {
+            // Check if there's a @relation with fields: — indicates owning side of 1-N or 1-1
+            type = 'many-to-one';
+        }
+        const rel = {
+            target,
+            type,
+        };
+        if (!isOptional && !isArray)
+            rel.required = true;
+        if (isOptional && !isArray)
+            rel.nullable = true;
+        // Parse @relation(...)
+        const relAttr = getFieldAttribute(field, 'relation');
+        if (relAttr) {
+            const fieldsList = getKeyValueArg(relAttr, 'fields');
+            const referencesList = getKeyValueArg(relAttr, 'references');
+            const onDelete = getKeyValueArg(relAttr, 'onDelete');
+            const nameArg = getPositionalArgs(relAttr)[0];
+            if (Array.isArray(fieldsList) && fieldsList.length > 0) {
+                rel.joinColumn = String(fieldsList[0]);
+            }
+            if (Array.isArray(referencesList) && referencesList.length > 0) {
+                // references[0] = PK of target; usually 'id'. We keep for reverse-engineering.
+            }
+            if (typeof onDelete === 'string') {
+                rel.onDelete = this.mapReferentialAction(onDelete, field.name, entityName, opts);
+            }
+            if (typeof nameArg === 'string') {
+                rel.mappedBy = this.unquote(nameArg); // self-relation disambiguation name
+            }
+        }
+        return rel;
+    }
+    mapReferentialAction(action, fieldName, entityName, opts) {
+        switch (action) {
+            case 'Cascade': return 'cascade';
+            case 'SetNull': return 'set-null';
+            case 'Restrict': return 'restrict';
+            case 'NoAction': return 'no-action';
+            case 'SetDefault':
+                this.warn(opts, {
+                    code: WarningCode.UNSUPPORTED_FEATURE,
+                    message: `onDelete: SetDefault on "${fieldName}" not portable; using set-null`,
+                    entity: entityName,
+                    field: fieldName,
+                });
+                return 'set-null';
+            default:
+                return 'no-action';
+        }
+    }
+    // ============================================================
+    // Block-level attributes (@@id, @@unique, @@index, @@map, @@schema)
+    // ============================================================
+    applyBlockAttribute(attr, entity, opts) {
+        switch (attr.name) {
+            case 'id': {
+                // @@id([a, b]) — composite primary key. EntitySchema has no composite PK,
+                // so we emit as composite unique index.
+                const fields = getPositionalArgs(attr)[0];
+                if (Array.isArray(fields)) {
+                    const index = {
+                        fields: Object.fromEntries(fields.map(f => [String(f), 'asc'])),
+                        unique: true,
+                    };
+                    entity.indexes.push(index);
+                    this.warn(opts, {
+                        code: WarningCode.LOSSY_CONVERSION,
+                        message: `@@id composite PK on ${entity.name} mapped to unique index; implicit _id still expected`,
+                        entity: entity.name,
+                    });
+                }
+                break;
+            }
+            case 'unique': {
+                const fields = getPositionalArgs(attr)[0];
+                if (Array.isArray(fields)) {
+                    entity.indexes.push({
+                        fields: Object.fromEntries(fields.map(f => [String(f), 'asc'])),
+                        unique: true,
+                    });
+                }
+                break;
+            }
+            case 'index': {
+                const fields = getPositionalArgs(attr)[0];
+                if (Array.isArray(fields)) {
+                    entity.indexes.push({
+                        fields: Object.fromEntries(fields.map(f => [String(f), 'asc'])),
+                    });
+                }
+                break;
+            }
+            case 'map':
+                // Already handled in resolveTableName
+                break;
+            case 'schema':
+                this.warn(opts, {
+                    code: WarningCode.PREVIEW_FEATURE,
+                    message: `@@schema on ${entity.name} (multi-schema preview) not reflected in EntitySchema`,
+                    entity: entity.name,
+                });
+                break;
+            case 'fulltext':
+                this.warn(opts, {
+                    code: WarningCode.PREVIEW_FEATURE,
+                    message: `@@fulltext on ${entity.name} mapped to regular index`,
+                    entity: entity.name,
+                });
+                break;
+            case 'ignore':
+                this.warn(opts, {
+                    code: WarningCode.UNSUPPORTED_FEATURE,
+                    message: `@@ignore on ${entity.name} not represented in EntitySchema`,
+                    entity: entity.name,
+                });
+                break;
+        }
+    }
+    // ============================================================
+    // Implicit M-N synthesis
+    // ============================================================
+    /**
+     * Prisma allows implicit M-N: `categories Category[]` on both sides with NO join
+     * table declared. The adapter detects these and upgrades one-to-many pairs to
+     * many-to-many, synthesizing `through` as `_${A}To${B}` (Prisma's convention).
+     */
+    synthesizeImplicitM2M(entities, models, modelNames, opts) {
+        // For each pair of DISTINCT models where both sides reference each other with []
+        // and neither side has a joinColumn (fields:), upgrade to many-to-many.
+        for (const entity of entities) {
+            for (const [relName, rel] of Object.entries(entity.relations)) {
+                if (rel.type !== 'one-to-many')
+                    continue;
+                // Skip self-relations — they are 1-N hierarchies (parent/children), not M-N
+                if (rel.target === entity.name)
+                    continue;
+                const otherEntity = entities.find(e => e.name === rel.target);
+                if (!otherEntity)
+                    continue;
+                // Find the reverse relation on the other side
+                const reverseRel = Object.values(otherEntity.relations).find(r => r.target === entity.name && r.type === 'one-to-many');
+                if (!reverseRel)
+                    continue;
+                // If neither side has a joinColumn (fields:), it's implicit M-N
+                if (!rel.joinColumn && !reverseRel.joinColumn) {
+                    rel.type = 'many-to-many';
+                    reverseRel.type = 'many-to-many';
+                    // Prisma convention : table name is `_${A}To${B}` sorted alphabetically
+                    const [a, b] = [entity.name, otherEntity.name].sort();
+                    const throughName = `_${a}To${b}`;
+                    rel.through = throughName;
+                    reverseRel.through = throughName;
+                }
+            }
+        }
+    }
+    // ============================================================
+    // Utilities
+    // ============================================================
+    hasTimestampsConvention(fields) {
+        const names = new Set(fields.map(f => f.name));
+        return names.has('createdAt') && names.has('updatedAt');
+    }
+    unquote(s) {
+        if (s.startsWith('"') && s.endsWith('"'))
+            return s.slice(1, -1);
+        return s;
+    }
+    detectPreviewFeatures(source, opts) {
+        const previews = [
+            { pattern: /\bview\s+\w+\s*\{/i, name: 'views' },
+            { pattern: /\btype\s+\w+\s*\{/i, name: 'composite types (Mongo)' },
+            { pattern: /previewFeatures\s*=/i, name: 'generator previewFeatures' },
+        ];
+        for (const { pattern, name } of previews) {
+            if (pattern.test(source)) {
+                this.warn(opts, {
+                    code: WarningCode.PREVIEW_FEATURE,
+                    message: `Detected use of ${name}; MVP may not fully support this`,
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=prisma.adapter.js.map

package/dist/adapters/prisma.adapter.js.map

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

package/dist/core/abstract.adapter.d.ts

@@ -0,0 +1,39 @@
+import type { EntitySchema, FieldDef } from '@mostajs/orm';
+import type { IAdapter, AdapterOptions, AdapterWarning } from './types.js';
+/**
+ * AbstractAdapter provides shared logic for all adapters:
+ *  - warning emission (strict vs callback mode)
+ *  - case conversion (pascal / camel / snake)
+ *  - EntitySchema validation
+ *  - empty-entity factory
+ */
+export declare abstract class AbstractAdapter implements IAdapter {
+    abstract readonly name: string;
+    abstract readonly vendor: string;
+    readonly version: string;
+    abstract canParse(input: string | object): boolean;
+    abstract toEntitySchema(input: string | object, opts?: AdapterOptions): Promise<EntitySchema[]>;
+    /**
+     * Emit a warning. In strict mode, throws; otherwise calls onWarning callback.
+     */
+    protected warn(opts: AdapterOptions | undefined, warning: AdapterWarning): void;
+    /** Convert to snake_case (for table/collection names) */
+    protected snakeCase(str: string): string;
+    /** Convert to PascalCase (for entity names) */
+    protected pascalCase(str: string): string;
+    /** Convert to camelCase (for field names) */
+    protected camelCase(str: string): string;
+    /**
+     * Create an empty EntitySchema with sensible defaults.
+     * Use as starting point when building a schema from source.
+     */
+    protected createEmptyEntity(name: string, collection?: string): EntitySchema;
+    /**
+     * Validate an EntitySchema structure.
+     * Returns array of error messages (empty array = valid).
+     */
+    protected validateEntitySchema(schema: EntitySchema): string[];
+    /** Validate a single FieldDef */
+    protected validateFieldDef(key: string, field: FieldDef): string[];
+}
+//# sourceMappingURL=abstract.adapter.d.ts.map

package/dist/core/abstract.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.adapter.d.ts","sourceRoot":"","sources":["../../src/core/abstract.adapter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAa,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG3E;;;;;;GAMG;AACH,8BAAsB,eAAgB,YAAW,QAAQ;IACvD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAW;IAEnC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAClD,QAAQ,CAAC,cAAc,CACrB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1B;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAW/E,yDAAyD;IACzD,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQxC,+CAA+C;IAC/C,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAOzC,6CAA6C;IAC7C,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IASxC;;;OAGG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY;IAW5E;;;OAGG;IACH,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE;IAgD9D,iCAAiC;IACjC,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE;CAanE"}

package/dist/core/abstract.adapter.js

@@ -0,0 +1,130 @@
+// @mostajs/orm-adapter — AbstractAdapter
+// Base class providing common helpers for all adapter implementations.
+// Inspired by AbstractSqlDialect in @mostajs/orm.
+// Author: Dr Hamid MADANI drmdh@msn.com
+// License: AGPL-3.0-or-later
+import { StrictWarningError } from './errors.js';
+/**
+ * AbstractAdapter provides shared logic for all adapters:
+ *  - warning emission (strict vs callback mode)
+ *  - case conversion (pascal / camel / snake)
+ *  - EntitySchema validation
+ *  - empty-entity factory
+ */
+export class AbstractAdapter {
+    version = '0.1.0';
+    // ============================================================
+    // Warning helpers
+    // ============================================================
+    /**
+     * Emit a warning. In strict mode, throws; otherwise calls onWarning callback.
+     */
+    warn(opts, warning) {
+        if (opts?.strict) {
+            throw new StrictWarningError(warning);
+        }
+        opts?.onWarning?.(warning);
+    }
+    // ============================================================
+    // Case conversion helpers
+    // ============================================================
+    /** Convert to snake_case (for table/collection names) */
+    snakeCase(str) {
+        return str
+            .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+            .replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2')
+            .replace(/[\s-]+/g, '_')
+            .toLowerCase();
+    }
+    /** Convert to PascalCase (for entity names) */
+    pascalCase(str) {
+        return str
+            .replace(/[_\s-]+/g, ' ')
+            .replace(/\w+/g, w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+            .replace(/\s+/g, '');
+    }
+    /** Convert to camelCase (for field names) */
+    camelCase(str) {
+        const p = this.pascalCase(str);
+        return p.charAt(0).toLowerCase() + p.slice(1);
+    }
+    // ============================================================
+    // Schema helpers
+    // ============================================================
+    /**
+     * Create an empty EntitySchema with sensible defaults.
+     * Use as starting point when building a schema from source.
+     */
+    createEmptyEntity(name, collection) {
+        return {
+            name: this.pascalCase(name),
+            collection: collection ?? this.snakeCase(name) + 's',
+            fields: {},
+            relations: {},
+            indexes: [],
+            timestamps: false,
+        };
+    }
+    /**
+     * Validate an EntitySchema structure.
+     * Returns array of error messages (empty array = valid).
+     */
+    validateEntitySchema(schema) {
+        const errors = [];
+        if (!schema.name || typeof schema.name !== 'string') {
+            errors.push('name is required and must be a string');
+        }
+        else if (!/^[A-Z][a-zA-Z0-9]*$/.test(schema.name)) {
+            errors.push(`name "${schema.name}" must be PascalCase`);
+        }
+        if (!schema.collection || typeof schema.collection !== 'string') {
+            errors.push('collection is required and must be a string');
+        }
+        if (!schema.fields || typeof schema.fields !== 'object') {
+            errors.push('fields must be an object');
+        }
+        else {
+            for (const [key, field] of Object.entries(schema.fields)) {
+                const fieldErrors = this.validateFieldDef(key, field);
+                errors.push(...fieldErrors);
+            }
+        }
+        if (!schema.relations || typeof schema.relations !== 'object') {
+            errors.push('relations must be an object');
+        }
+        else {
+            for (const [key, rel] of Object.entries(schema.relations)) {
+                if (!rel.target)
+                    errors.push(`relation "${key}" missing target`);
+                if (!['one-to-one', 'many-to-one', 'one-to-many', 'many-to-many'].includes(rel.type)) {
+                    errors.push(`relation "${key}" has invalid type: ${rel.type}`);
+                }
+            }
+        }
+        if (!Array.isArray(schema.indexes)) {
+            errors.push('indexes must be an array');
+        }
+        if (typeof schema.timestamps !== 'boolean') {
+            errors.push('timestamps must be a boolean');
+        }
+        if (schema.discriminator && !schema.discriminatorValue) {
+            errors.push('discriminator requires discriminatorValue');
+        }
+        return errors;
+    }
+    /** Validate a single FieldDef */
+    validateFieldDef(key, field) {
+        const errors = [];
+        const validTypes = [
+            'string', 'text', 'number', 'boolean', 'date', 'json', 'array',
+        ];
+        if (!validTypes.includes(field.type)) {
+            errors.push(`field "${key}" has invalid type: ${field.type}`);
+        }
+        if (field.type === 'array' && !field.arrayOf) {
+            errors.push(`field "${key}" is array but arrayOf is missing`);
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=abstract.adapter.js.map

package/dist/core/abstract.adapter.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,21 @@
+import type { AdapterWarning } from './types.js';
+/** Base error class for all adapter-related errors */
+export declare class AdapterError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/** Thrown when an input cannot be parsed by any registered adapter */
+export declare class NoAdapterFoundError extends AdapterError {
+    constructor(message?: string);
+}
+/** Thrown when input is malformed or violates its own schema */
+export declare class InvalidSchemaError extends AdapterError {
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+/** Thrown in strict mode when an unsupported feature is encountered */
+export declare class StrictWarningError extends AdapterError {
+    readonly warning: AdapterWarning;
+    constructor(warning: AdapterWarning);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,sDAAsD;AACtD,qBAAa,YAAa,SAAQ,KAAK;aACQ,IAAI,EAAE,MAAM;gBAA7C,OAAO,EAAE,MAAM,EAAkB,IAAI,GAAE,MAAwB;CAI5E;AAED,sEAAsE;AACtE,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,SAAyC;CAI7D;AAED,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,YAAY;aACL,OAAO,CAAC,EAAE,OAAO;gBAAlD,OAAO,EAAE,MAAM,EAAkB,OAAO,CAAC,EAAE,OAAO,YAAA;CAI/D;AAED,uEAAuE;AACvE,qBAAa,kBAAmB,SAAQ,YAAY;aACtB,OAAO,EAAE,cAAc;gBAAvB,OAAO,EAAE,cAAc;CAIpD"}