@alpha.consultings/eloquent-orm.js 1.0.1

package/dist/core/model/CoreModelPersistenceState.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMongoPrimaryFilter = buildMongoPrimaryFilter;
+exports.getPersistenceSchema = getPersistenceSchema;
+exports.getColumnFieldNames = getColumnFieldNames;
+exports.resolvePrimaryKey = resolvePrimaryKey;
+exports.getPrimaryKeyValue = getPrimaryKeyValue;
+exports.getOriginalPrimaryKeyValue = getOriginalPrimaryKeyValue;
+exports.createPersistedSnapshot = createPersistedSnapshot;
+exports.sanitizeAssignableData = sanitizeAssignableData;
+exports.extractPersistableAttributes = extractPersistableAttributes;
+exports.assertPrimaryKeyNotMutated = assertPrimaryKeyNotMutated;
+exports.getDirtyAttributes = getDirtyAttributes;
+function buildMongoPrimaryFilter(pk, id) {
+    if (pk === "_id") {
+        return { _id: id };
+    }
+    if (pk === "id") {
+        return { $or: [{ id }, { _id: id }] };
+    }
+    return { [pk]: id };
+}
+function getPersistenceSchema(modelName, schema) {
+    if (!schema) {
+        throw new Error(`${modelName} must define a schema to use fill(), save(), or patch().`);
+    }
+    return schema;
+}
+function getColumnFieldNames(schema) {
+    return Object.entries(schema)
+        .filter(([, field]) => field.kind === "column")
+        .map(([fieldName]) => fieldName);
+}
+function resolvePrimaryKey(schema) {
+    if (schema) {
+        for (const [fieldName, field] of Object.entries(schema)) {
+            if (field.kind === "column" && field.options.primary) {
+                return fieldName;
+            }
+        }
+        if (schema._id?.kind === "column")
+            return "_id";
+        if (schema.id?.kind === "column")
+            return "id";
+    }
+    return "id";
+}
+function getPrimaryKeyValue(record, pk) {
+    if (pk === "_id") {
+        return record._id ?? record.id;
+    }
+    if (pk === "id") {
+        return record.id ?? record._id;
+    }
+    return record[pk];
+}
+function getOriginalPrimaryKeyValue(originalAttributes, pk) {
+    if (Object.prototype.hasOwnProperty.call(originalAttributes, pk)) {
+        return originalAttributes[pk];
+    }
+    if (pk === "_id" && Object.prototype.hasOwnProperty.call(originalAttributes, "id")) {
+        return originalAttributes.id;
+    }
+    if (pk === "id" && Object.prototype.hasOwnProperty.call(originalAttributes, "_id")) {
+        return originalAttributes._id;
+    }
+    return undefined;
+}
+function createPersistedSnapshot(options) {
+    const { source, schema, primaryKey } = options;
+    if (!schema) {
+        return Object.fromEntries(Object.entries(source).filter(([field]) => !field.startsWith("_")));
+    }
+    const snapshot = {};
+    for (const [fieldName, field] of Object.entries(schema)) {
+        if (field.kind !== "column")
+            continue;
+        if (Object.prototype.hasOwnProperty.call(source, fieldName)) {
+            snapshot[fieldName] = source[fieldName];
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(snapshot, primaryKey)) {
+        if (primaryKey === "_id" && source.id !== undefined) {
+            snapshot._id = source.id;
+        }
+        else if (primaryKey === "id" && source._id !== undefined) {
+            snapshot.id = source._id;
+        }
+    }
+    return snapshot;
+}
+function assertAssignableField(options) {
+    const { field, usage, schema, modelName } = options;
+    const definition = schema[field];
+    if (!definition || definition.kind !== "column") {
+        throw new Error(`Unknown ${usage} field '${field}' on ${modelName}.`);
+    }
+}
+function sanitizeAssignableData(options) {
+    const { data, usage, schema, modelName } = options;
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        throw new Error(`${usage}() expects a plain object payload.`);
+    }
+    const sanitized = {};
+    for (const [field, value] of Object.entries(data)) {
+        assertAssignableField({ field, usage, schema, modelName });
+        sanitized[field] = value;
+    }
+    return sanitized;
+}
+function extractPersistableAttributes(options) {
+    const { record, columnFieldNames } = options;
+    const attributes = {};
+    for (const fieldName of columnFieldNames) {
+        if (Object.prototype.hasOwnProperty.call(record, fieldName)) {
+            attributes[fieldName] = record[fieldName];
+        }
+    }
+    return attributes;
+}
+function assertPrimaryKeyNotMutated(options) {
+    const { exists, primaryKey, currentPrimaryKey, originalPrimaryKey, modelName } = options;
+    if (!exists)
+        return;
+    if (!Object.is(currentPrimaryKey, originalPrimaryKey)) {
+        throw new Error(`Cannot change persisted primary key '${primaryKey}' on ${modelName}.`);
+    }
+}
+function getDirtyAttributes(options) {
+    const { currentAttributes, originalAttributes, primaryKey } = options;
+    const dirtyAttributes = {};
+    for (const [field, value] of Object.entries(currentAttributes)) {
+        if (field === primaryKey)
+            continue;
+        if (!Object.is(originalAttributes[field], value)) {
+            dirtyAttributes[field] = value;
+        }
+    }
+    return dirtyAttributes;
+}
+//# sourceMappingURL=CoreModelPersistenceState.js.map

package/dist/core/model/CoreModelPersistenceState.js.map

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

package/dist/core/model/CoreModelSafeFinderSupport.d.ts

@@ -0,0 +1,5 @@
+import type { SafeFinderFilters, SafeFinderModelInstance, SafeFinderModelStatic } from "./SafeFinder";
+import { SafeFinderQuery } from "./SafeFinder";
+export declare function createSafeFinderQuery<TModel extends SafeFinderModelInstance>(model: TModel, modelClass: SafeFinderModelStatic<TModel>): SafeFinderQuery<TModel>;
+export declare function applySafeFinderFilters<TModel extends SafeFinderModelInstance>(finder: SafeFinderQuery<TModel>, filters: SafeFinderFilters): SafeFinderQuery<TModel>;
+//# sourceMappingURL=CoreModelSafeFinderSupport.d.ts.map

package/dist/core/model/CoreModelSafeFinderSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreModelSafeFinderSupport.d.ts","sourceRoot":"","sources":["../../../src/core/model/CoreModelSafeFinderSupport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,wBAAgB,qBAAqB,CAAC,MAAM,SAAS,uBAAuB,EAC1E,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACxC,eAAe,CAAC,MAAM,CAAC,CAEzB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,uBAAuB,EAC3E,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,OAAO,EAAE,iBAAiB,GACzB,eAAe,CAAC,MAAM,CAAC,CAMzB"}

package/dist/core/model/CoreModelSafeFinderSupport.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSafeFinderQuery = createSafeFinderQuery;
+exports.applySafeFinderFilters = applySafeFinderFilters;
+const SafeFinder_1 = require("./SafeFinder");
+function createSafeFinderQuery(model, modelClass) {
+    return new SafeFinder_1.SafeFinderQuery(model, modelClass);
+}
+function applySafeFinderFilters(finder, filters) {
+    for (const [field, value] of Object.entries(filters)) {
+        finder.where(field, value);
+    }
+    return finder;
+}
+//# sourceMappingURL=CoreModelSafeFinderSupport.js.map

package/dist/core/model/CoreModelSafeFinderSupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreModelSafeFinderSupport.js","sourceRoot":"","sources":["../../../src/core/model/CoreModelSafeFinderSupport.ts"],"names":[],"mappings":";;AAOA,sDAKC;AAED,wDASC;AAlBD,6CAA+C;AAE/C,SAAgB,qBAAqB,CACnC,KAAa,EACb,UAAyC;IAEzC,OAAO,IAAI,4BAAe,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,sBAAsB,CACpC,MAA+B,EAC/B,OAA0B;IAE1B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/model/CoreModelValidationEvents.d.ts

@@ -0,0 +1,24 @@
+import { SchemaValidatorOptions } from "../schema/SchemaValidator";
+import type { SchemaField, ValidationRule } from "../schema/SchemaBlueprint";
+export type CoreModelEventHandler = (payload: unknown) => Promise<unknown> | unknown;
+export declare function shouldSkipModelHooks(envValue?: string): boolean;
+export declare function buildValidationRules(options: {
+    schema: Record<string, SchemaField>;
+    data: Record<string, unknown>;
+    partial: boolean;
+}): Record<string, ValidationRule>;
+export declare function validateModelData(options: {
+    tableName: string;
+    schema?: Record<string, SchemaField>;
+    hooks?: SchemaValidatorOptions["hooks"];
+    customRules?: SchemaValidatorOptions["customRules"];
+    data: Record<string, unknown>;
+    partial: boolean;
+    skipModelHooks: boolean;
+}): Promise<void>;
+export declare function fireModelEvent(options: {
+    skipModelHooks: boolean;
+    handler?: CoreModelEventHandler;
+    payload?: unknown;
+}): Promise<boolean>;
+//# sourceMappingURL=CoreModelValidationEvents.d.ts.map

package/dist/core/model/CoreModelValidationEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreModelValidationEvents.d.ts","sourceRoot":"","sources":["../../../src/core/model/CoreModelValidationEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE7E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAErF,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAcjC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnB"}

package/dist/core/model/CoreModelValidationEvents.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldSkipModelHooks = shouldSkipModelHooks;
+exports.buildValidationRules = buildValidationRules;
+exports.validateModelData = validateModelData;
+exports.fireModelEvent = fireModelEvent;
+const SchemaValidator_1 = require("../schema/SchemaValidator");
+function shouldSkipModelHooks(envValue) {
+    return envValue === "1" || envValue === "true";
+}
+function buildValidationRules(options) {
+    const { schema, data, partial } = options;
+    const validationRules = {};
+    for (const [key, field] of Object.entries(schema)) {
+        if (field.kind === "column" && field.validate) {
+            if (partial && !Object.prototype.hasOwnProperty.call(data, key)) {
+                continue;
+            }
+            validationRules[key] = field.validate;
+        }
+    }
+    return validationRules;
+}
+async function validateModelData(options) {
+    const { tableName, schema, hooks, customRules, data, partial, skipModelHooks } = options;
+    if (!schema)
+        return;
+    const validationRules = buildValidationRules({ schema, data, partial });
+    const errors = await SchemaValidator_1.SchemaValidator.validateData(data, validationRules, {
+        hooks: skipModelHooks ? undefined : hooks,
+        customRules,
+    });
+    if (errors.length > 0) {
+        const formatted = errors.map((error) => `- ${error.field} ${error.message}`).join("\n");
+        throw new Error(`Validation failed for ${tableName}:\n${formatted}`);
+    }
+}
+async function fireModelEvent(options) {
+    const { skipModelHooks, handler, payload } = options;
+    if (skipModelHooks || !handler)
+        return true;
+    const result = await handler(payload);
+    return result !== false;
+}
+//# sourceMappingURL=CoreModelValidationEvents.js.map

package/dist/core/model/CoreModelValidationEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreModelValidationEvents.js","sourceRoot":"","sources":["../../../src/core/model/CoreModelValidationEvents.ts"],"names":[],"mappings":";;AAKA,oDAEC;AAED,oDAkBC;AAED,8CAuBC;AAED,wCAUC;AAhED,+DAAoF;AAKpF,SAAgB,oBAAoB,CAAC,QAAiB;IACpD,OAAO,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,MAAM,CAAC;AACjD,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAIpC;IACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC1C,MAAM,eAAe,GAAmC,EAAE,CAAC;IAE3D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9C,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAEM,KAAK,UAAU,iBAAiB,CAAC,OAQvC;IACC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAEzF,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,eAAe,GAAG,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,iCAAe,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE;QACvE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;QACzC,WAAW;KACZ,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,MAAM,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,OAIpC;IACC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACrD,IAAI,cAAc,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,MAAM,KAAK,KAAK,CAAC;AAC1B,CAAC"}

package/dist/core/model/SafeFinder.d.ts

@@ -0,0 +1,46 @@
+import type { SchemaField } from "../schema/SchemaBlueprint";
+export type SafeFinderDirection = "asc" | "desc";
+export type SafeFinderFilters = Record<string, unknown>;
+export interface SafeFinderModelInstance {
+    tableName: string;
+    connectionName: string;
+    getDB(): Promise<unknown>;
+}
+export interface SafeFinderModelStatic<TModel extends SafeFinderModelInstance = SafeFinderModelInstance> {
+    name: string;
+    schema?: Record<string, SchemaField>;
+    hydrateRow(row: Record<string, unknown> | null): TModel | null;
+    hydrateMany(rows: Record<string, unknown>[]): TModel[];
+    scopeActive?(query: SafeFinderQuery<TModel>, ...args: unknown[]): SafeFinderQuery<TModel> | void;
+    scopeInactive?(query: SafeFinderQuery<TModel>, ...args: unknown[]): SafeFinderQuery<TModel> | void;
+    scopePublished?(query: SafeFinderQuery<TModel>, ...args: unknown[]): SafeFinderQuery<TModel> | void;
+}
+export declare class SafeFinderQuery<TModel extends SafeFinderModelInstance = SafeFinderModelInstance> {
+    private readonly model;
+    private readonly modelClass;
+    private readonly filters;
+    private readonly eagerRelations;
+    private orderField?;
+    private orderDirection;
+    private limitCount?;
+    constructor(model: TModel, modelClass: SafeFinderModelStatic<TModel>);
+    where(field: string, value: unknown): this;
+    with(...relations: string[]): this;
+    active(...args: unknown[]): this;
+    inactive(...args: unknown[]): this;
+    published(...args: unknown[]): this;
+    orderBy(field: string, direction?: SafeFinderDirection): this;
+    limit(count: number): this;
+    get(): Promise<TModel[]>;
+    first(): Promise<TModel | null>;
+    private getDriverName;
+    private getSchema;
+    private assertColumnField;
+    private hasColumnField;
+    private assertRelationPath;
+    private applyEagerLoading;
+    private applyNamedScope;
+    private buildSqlSelect;
+    private buildMongoFilter;
+}
+//# sourceMappingURL=SafeFinder.d.ts.map

package/dist/core/model/SafeFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafeFinder.d.ts","sourceRoot":"","sources":["../../../src/core/model/SafeFinder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/D,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IACvD,WAAW,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACjG,aAAa,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACnG,cAAc,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACrG;AAOD,qBAAa,eAAe,CAAC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IAQzF,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,UAAU,CAAC,CAAS;gBAGT,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,CAAC,MAAM,CAAC;IAG5D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAM1C,IAAI,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAQlC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAoBhC,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAoBlC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAoBnC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,mBAA2B,GAAG,IAAI;IAYpE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASpB,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA+BxB,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqCrC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,kBAAkB;YAiBZ,iBAAiB;IAiB/B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/core/model/SafeFinder.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafeFinderQuery = void 0;
+const database_1 = require("../../config/database");
+class SafeFinderQuery {
+    constructor(model, modelClass) {
+        this.model = model;
+        this.modelClass = modelClass;
+        this.filters = [];
+        this.eagerRelations = [];
+        this.orderDirection = "asc";
+    }
+    where(field, value) {
+        this.assertColumnField(field, "filter");
+        this.filters.push({ field, value });
+        return this;
+    }
+    with(...relations) {
+        for (const relation of relations) {
+            this.assertRelationPath(relation);
+            this.eagerRelations.push(relation);
+        }
+        return this;
+    }
+    active(...args) {
+        return this.applyNamedScope("active", this.modelClass.scopeActive, () => {
+            if (this.hasColumnField("status")) {
+                return this.where("status", "active");
+            }
+            if (this.hasColumnField("active")) {
+                return this.where("active", true);
+            }
+            return undefined;
+        }, args, "Define static scopeActive(query) or add a 'status'/'active' column.");
+    }
+    inactive(...args) {
+        return this.applyNamedScope("inactive", this.modelClass.scopeInactive, () => {
+            if (this.hasColumnField("status")) {
+                return this.where("status", "inactive");
+            }
+            if (this.hasColumnField("active")) {
+                return this.where("active", false);
+            }
+            return undefined;
+        }, args, "Define static scopeInactive(query) or add a 'status'/'active' column.");
+    }
+    published(...args) {
+        return this.applyNamedScope("published", this.modelClass.scopePublished, () => {
+            if (this.hasColumnField("published")) {
+                return this.where("published", true);
+            }
+            if (this.hasColumnField("status")) {
+                return this.where("status", "published");
+            }
+            return undefined;
+        }, args, "Define static scopePublished(query) or add a 'published'/'status' column.");
+    }
+    orderBy(field, direction = "asc") {
+        this.assertColumnField(field, "sort");
+        const normalized = String(direction).toLowerCase();
+        if (normalized !== "asc" && normalized !== "desc") {
+            throw new Error(`Unsupported sort direction '${direction}'. Use 'asc' or 'desc'.`);
+        }
+        this.orderField = field;
+        this.orderDirection = normalized;
+        return this;
+    }
+    limit(count) {
+        if (!Number.isInteger(count) || count < 1) {
+            throw new Error("limit() expects a positive integer.");
+        }
+        this.limitCount = count;
+        return this;
+    }
+    async get() {
+        const db = await this.model.getDB();
+        const driver = this.getDriverName();
+        switch (driver) {
+            case "sqlite":
+            case "mysql":
+            case "pg": {
+                const adapter = db;
+                const { sql, params } = this.buildSqlSelect(adapter);
+                const rows = await adapter.query(sql, params);
+                return this.applyEagerLoading(this.modelClass.hydrateMany(rows));
+            }
+            case "mongo": {
+                let cursor = db.collection(this.model.tableName).find(this.buildMongoFilter());
+                if (this.orderField) {
+                    cursor = cursor.sort({ [this.orderField]: this.orderDirection === "asc" ? 1 : -1 });
+                }
+                if (this.limitCount !== undefined) {
+                    cursor = cursor.limit(this.limitCount);
+                }
+                const rows = await cursor.toArray();
+                return this.applyEagerLoading(this.modelClass.hydrateMany(rows));
+            }
+            default:
+                throw new Error(`Unsupported driver: ${driver}`);
+        }
+    }
+    async first() {
+        const db = await this.model.getDB();
+        const driver = this.getDriverName();
+        switch (driver) {
+            case "sqlite":
+            case "mysql":
+            case "pg": {
+                const adapter = db;
+                const { sql, params } = this.buildSqlSelect(adapter, 1);
+                const row = await adapter.queryOne(sql, params);
+                const hydrated = this.modelClass.hydrateRow(row);
+                if (!hydrated)
+                    return null;
+                const loaded = await this.applyEagerLoading([hydrated]);
+                return loaded[0] ?? null;
+            }
+            case "mongo": {
+                let cursor = db.collection(this.model.tableName).find(this.buildMongoFilter());
+                if (this.orderField) {
+                    cursor = cursor.sort({ [this.orderField]: this.orderDirection === "asc" ? 1 : -1 });
+                }
+                cursor = cursor.limit(1);
+                const rows = await cursor.toArray();
+                const hydrated = this.modelClass.hydrateRow(rows[0] ?? null);
+                if (!hydrated)
+                    return null;
+                const loaded = await this.applyEagerLoading([hydrated]);
+                return loaded[0] ?? null;
+            }
+            default:
+                throw new Error(`Unsupported driver: ${driver}`);
+        }
+    }
+    getDriverName() {
+        const connections = database_1.dbConfig.connections;
+        return connections[this.model.connectionName]?.driver ?? this.model.connectionName;
+    }
+    getSchema() {
+        const schema = this.modelClass.schema;
+        if (!schema) {
+            throw new Error(`${this.modelClass.name} must define a schema to use the safe finder API.`);
+        }
+        return schema;
+    }
+    assertColumnField(field, usage) {
+        const schema = this.getSchema();
+        const definition = schema[field];
+        if (!definition || definition.kind !== "column") {
+            throw new Error(`Unknown ${usage} field '${field}' on ${this.modelClass.name}.`);
+        }
+    }
+    hasColumnField(field) {
+        const schema = this.getSchema();
+        return schema[field]?.kind === "column";
+    }
+    assertRelationPath(relation) {
+        if (typeof relation !== "string" || relation.trim() === "") {
+            throw new Error(`with() expects non-empty relation names on ${this.modelClass.name}.`);
+        }
+        const segments = relation.split(".");
+        if (segments.some((segment) => segment.trim() === "")) {
+            throw new Error(`Invalid relation path '${relation}' on ${this.modelClass.name}.`);
+        }
+        const topLevel = segments[0];
+        const relationFn = this.model[topLevel];
+        if (typeof relationFn !== "function") {
+            throw new Error(`Relation '${topLevel}' is not defined on ${this.modelClass.name}.`);
+        }
+    }
+    async applyEagerLoading(records) {
+        if (this.eagerRelations.length === 0 || records.length === 0) {
+            return records;
+        }
+        const loader = this.model;
+        const eagerLoadRelations = loader["eagerLoadRelations"];
+        if (typeof eagerLoadRelations !== "function") {
+            throw new Error(`${this.modelClass.name} does not support eager loading on the safe finder path.`);
+        }
+        loader["eagerRelations"] = [...this.eagerRelations];
+        return (await eagerLoadRelations.call(this.model, records));
+    }
+    applyNamedScope(name, scope, fallback, args, guidance) {
+        if (typeof scope === "function") {
+            const result = scope.call(this.modelClass, this, ...args);
+            return result ?? this;
+        }
+        const fallbackResult = fallback(...args);
+        if (fallbackResult) {
+            return fallbackResult;
+        }
+        throw new Error(`No ${name} scope available on ${this.modelClass.name}. ${guidance}`);
+    }
+    buildSqlSelect(adapter, forcedLimit) {
+        const table = adapter.wrapId(this.model.tableName);
+        let sql = `SELECT * FROM ${table}`;
+        const params = [];
+        if (this.filters.length > 0) {
+            const clauses = this.filters.map(({ field, value }, index) => {
+                params.push(value);
+                return `${adapter.wrapId(field)} = ${adapter.placeholder(index + 1)}`;
+            });
+            sql += ` WHERE ${clauses.join(" AND ")}`;
+        }
+        if (this.orderField) {
+            sql += ` ORDER BY ${adapter.wrapId(this.orderField)} ${this.orderDirection.toUpperCase()}`;
+        }
+        const finalLimit = forcedLimit ?? this.limitCount;
+        if (finalLimit !== undefined) {
+            sql += ` LIMIT ${finalLimit}`;
+        }
+        return { sql, params };
+    }
+    buildMongoFilter() {
+        const filter = {};
+        for (const entry of this.filters) {
+            filter[entry.field] = entry.value;
+        }
+        return filter;
+    }
+}
+exports.SafeFinderQuery = SafeFinderQuery;
+//# sourceMappingURL=SafeFinder.js.map

package/dist/core/model/SafeFinder.js.map

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

package/dist/core/orm/Relation.d.ts

@@ -0,0 +1,47 @@
+export interface RelationModel {
+    tableName: string;
+    getDB(): Promise<unknown>;
+}
+export type CoreModelClass<TRelated extends RelationModel = RelationModel> = {
+    new (): TRelated;
+    hydrateRow(row: Record<string, unknown> | null): TRelated | null;
+    hydrateMany(rows: Record<string, unknown>[]): TRelated[];
+};
+/**
+ * ًں§© Base Relation
+ * Handles relation definition + auto-detected name from caller method.
+ */
+export declare abstract class Relation<TRelated extends RelationModel = RelationModel> {
+    protected relatedModel: CoreModelClass<TRelated> | null;
+    protected foreignKey: string;
+    protected localKey: string;
+    protected name?: string;
+    constructor(relatedModel: CoreModelClass<TRelated> | null, foreignKey: string, localKey: string, name?: string);
+    /**
+     * ًں§  Auto-detect relation name (e.g., "posts" from user.posts())
+     */
+    private detectRelationName;
+    /**
+     * Each relation must fetch related data for a parent
+     */
+    abstract getResults(parent: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Each relation must match related rows for eager loading
+     */
+    abstract match(parents: Record<string, unknown>[]): Promise<void>;
+    protected isMongoDatabase(db: unknown): db is {
+        collection(name: string): {
+            findOne(filter: Record<string, unknown>): Promise<Record<string, unknown> | null>;
+            find(filter: Record<string, unknown>): {
+                toArray(): Promise<Record<string, unknown>[]>;
+            };
+            insertOne?(doc: Record<string, unknown>): Promise<unknown>;
+            insertMany?(docs: Record<string, unknown>[]): Promise<unknown>;
+            deleteMany?(filter: Record<string, unknown>): Promise<unknown>;
+        };
+    };
+    protected buildMongoEqualityFilter(field: string, value: unknown): Record<string, unknown>;
+    protected buildMongoInFilter(field: string, values: unknown[]): Record<string, unknown>;
+    protected getMongoComparableValues(record: Record<string, unknown>, field: string): unknown[];
+}
+//# sourceMappingURL=Relation.d.ts.map

package/dist/core/orm/Relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relation.d.ts","sourceRoot":"","sources":["../../../src/core/orm/Relation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,IAAI;IAC3E,QAAQ,QAAQ,CAAC;IACjB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;IACjE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;CAC1D,CAAC;AAEF;;;GAGG;AACH,8BAAsB,QAAQ,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IAC3E,SAAS,CAAC,YAAY,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACxD,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAGtB,YAAY,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAC7C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM;IAQf;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAEtE;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjE,SAAS,CAAC,eAAe,CACvB,EAAE,EAAE,OAAO,GACV,EAAE,IAAI;QACP,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;YACxB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YAClF,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;gBAAE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;aAAE,CAAC;YACzF,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3D,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/D,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;SAChE,CAAC;KACH;IAID,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAY1F,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYvF,SAAS,CAAC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;CAQ9F"}