@zintrust/core 0.1.0

package/src/orm/Relationships.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Relationship Types
+ * Define how models relate to each other
+ */
+import { IModel, Model, ModelStatic } from './Model';
+export type RelationshipType = 'hasOne' | 'hasMany' | 'belongsTo' | 'belongsToMany';
+export interface Relation {
+    type: RelationshipType;
+    related: typeof Model;
+    foreignKey: string;
+    localKey: string;
+    throughTable?: string;
+}
+export interface IRelationship {
+    get(instance: IModel): Promise<unknown>;
+}
+/**
+ * HasOne Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export declare const HasOne: Readonly<{
+    create(relatedModel: ModelStatic, foreignKey: string, localKey: string): IRelationship;
+}>;
+/**
+ * HasMany Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export declare const HasMany: Readonly<{
+    create(relatedModel: ModelStatic, foreignKey: string, localKey: string): IRelationship;
+}>;
+/**
+ * BelongsTo Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export declare const BelongsTo: Readonly<{
+    create(relatedModel: ModelStatic, foreignKey: string, localKey: string): IRelationship;
+}>;
+/**
+ * BelongsToMany Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export declare const BelongsToMany: Readonly<{
+    create(relatedModel: ModelStatic, throughTable: string, foreignKey: string, relatedKey: string): IRelationship;
+}>;
+//# sourceMappingURL=Relationships.d.ts.map

package/src/orm/Relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relationships.d.ts","sourceRoot":"","sources":["../../../src/orm/Relationships.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CAAC;AAEpF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAUD;;;;;GAKG;AACH,eAAO,MAAM,MAAM;yBACI,WAAW,cAAc,MAAM,YAAY,MAAM,GAAG,aAAa;EAUtF,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,OAAO;yBACG,WAAW,cAAc,MAAM,YAAY,MAAM,GAAG,aAAa;EAUtF,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,SAAS;yBACC,WAAW,cAAc,MAAM,YAAY,MAAM,GAAG,aAAa;EAUtF,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa;yBAER,WAAW,gBACX,MAAM,cACR,MAAM,cACN,MAAM,GACjB,aAAa;EA8BhB,CAAC"}

package/src/orm/Relationships.js

@@ -0,0 +1,98 @@
+/**
+ * Relationship Types
+ * Define how models relate to each other
+ */
+import { ErrorFactory } from '../exceptions/ZintrustError';
+const getRelatedTableName = (relatedModel) => {
+    if (typeof relatedModel.getTable === 'function') {
+        return relatedModel.getTable();
+    }
+    throw ErrorFactory.createConfigError('Related model does not provide a table name');
+};
+/**
+ * HasOne Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export const HasOne = Object.freeze({
+    create(relatedModel, foreignKey, localKey) {
+        return {
+            async get(instance) {
+                const value = instance.getAttribute(localKey);
+                if (value === undefined || value === null || value === '')
+                    return null;
+                return relatedModel.query().where(foreignKey, '=', value).first();
+            },
+        };
+    },
+});
+/**
+ * HasMany Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export const HasMany = Object.freeze({
+    create(relatedModel, foreignKey, localKey) {
+        return {
+            async get(instance) {
+                const value = instance.getAttribute(localKey);
+                if (value === undefined || value === null || value === '')
+                    return [];
+                return relatedModel.query().where(foreignKey, '=', value).get();
+            },
+        };
+    },
+});
+/**
+ * BelongsTo Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export const BelongsTo = Object.freeze({
+    create(relatedModel, foreignKey, localKey) {
+        return {
+            async get(instance) {
+                const value = instance.getAttribute(foreignKey);
+                if (value === undefined || value === null || value === '')
+                    return null;
+                return relatedModel.query().where(localKey, '=', value).first();
+            },
+        };
+    },
+});
+/**
+ * BelongsToMany Relationship
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export const BelongsToMany = Object.freeze({
+    create(relatedModel, throughTable, foreignKey, relatedKey) {
+        const isValidInstance = (instance) => {
+            const instanceId = instance.getAttribute('id');
+            return (instanceId !== undefined &&
+                instanceId !== null &&
+                instanceId !== '' &&
+                throughTable !== '' &&
+                foreignKey !== '' &&
+                relatedKey !== '');
+        };
+        return {
+            async get(instance) {
+                if (!isValidInstance(instance)) {
+                    return [];
+                }
+                const instanceId = instance.getAttribute('id');
+                const relatedTable = getRelatedTableName(relatedModel);
+                return relatedModel
+                    .query()
+                    .join(throughTable, `${relatedTable}.id = ${throughTable}.${relatedKey}`)
+                    .where(`${throughTable}.${foreignKey}`, instanceId)
+                    .get();
+            },
+        };
+    },
+});

package/src/orm/Schema.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Schema - Column definition and type system
+ * Defines database columns with type safety
+ */
+export type ColumnType = 'string' | 'integer' | 'boolean' | 'date' | 'datetime' | 'json' | 'text' | 'timestamp' | 'decimal' | 'uuid' | 'float' | 'double' | 'binary' | 'enum' | 'bigInteger' | 'smallInteger' | 'tinyInteger' | 'mediumInteger' | 'time' | 'year' | 'char' | 'longText' | 'mediumText' | 'tinyText' | 'blob' | 'mediumBlob' | 'longBlob' | 'tinyBlob' | 'ipAddress' | 'macAddress' | 'geometry' | 'point' | 'lineString' | 'polygon' | 'geometryCollection' | 'multiPoint' | 'multiLineString' | 'multiPolygon';
+export interface ColumnDefinition {
+    name: string;
+    type: ColumnType;
+    nullable: boolean;
+    default?: unknown;
+    unique: boolean;
+    primary: boolean;
+    index: boolean;
+    autoIncrement?: boolean;
+    unsigned?: boolean;
+    comment?: string;
+    references?: string;
+    on?: string;
+    onDelete?: string;
+    onUpdate?: string;
+    renameTo?: string;
+    change?: boolean;
+    drop?: boolean;
+    after?: string;
+    first?: boolean;
+    charset?: string;
+    collation?: string;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    values?: string[];
+}
+export interface IColumn {
+    nullable(): IColumn;
+    default(value: unknown): IColumn;
+    unique(): IColumn;
+    primary(): IColumn;
+    index(): IColumn;
+    autoIncrement(): IColumn;
+    unsigned(): IColumn;
+    comment(text: string): IColumn;
+    references(column: string): IColumn;
+    on(table: string): IColumn;
+    onDelete(action: string): IColumn;
+    onUpdate(action: string): IColumn;
+    renameTo(name: string): IColumn;
+    change(): IColumn;
+    drop(): IColumn;
+    after(column: string): IColumn;
+    first(): IColumn;
+    charset(value: string): IColumn;
+    collation(value: string): IColumn;
+    length(value: number): IColumn;
+    precision(value: number): IColumn;
+    scale(value: number): IColumn;
+    values(value: string[]): IColumn;
+    getDefinition(): ColumnDefinition;
+}
+/**
+ * Column - Column definition builder
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export declare const Column: Readonly<{
+    /**
+     * Create a new column instance
+     */
+    create(name: string, type: ColumnType): IColumn;
+}>;
+export interface ISchema {
+    string(name: string, length?: number): IColumn;
+    integer(name: string): IColumn;
+    boolean(name: string): IColumn;
+    date(name: string): IColumn;
+    datetime(name: string): IColumn;
+    json(name: string): IColumn;
+    text(name: string): IColumn;
+    timestamp(name: string): IColumn;
+    decimal(name: string, precision?: number, scale?: number): IColumn;
+    uuid(name: string): IColumn;
+    float(name: string): IColumn;
+    double(name: string): IColumn;
+    binary(name: string): IColumn;
+    enum(name: string, values: string[]): IColumn;
+    bigInteger(name: string): IColumn;
+    smallInteger(name: string): IColumn;
+    tinyInteger(name: string): IColumn;
+    mediumInteger(name: string): IColumn;
+    time(name: string): IColumn;
+    year(name: string): IColumn;
+    char(name: string, length?: number): IColumn;
+    longText(name: string): IColumn;
+    mediumText(name: string): IColumn;
+    tinyText(name: string): IColumn;
+    blob(name: string): IColumn;
+    mediumBlob(name: string): IColumn;
+    longBlob(name: string): IColumn;
+    tinyBlob(name: string): IColumn;
+    ipAddress(name: string): IColumn;
+    macAddress(name: string): IColumn;
+    geometry(name: string): IColumn;
+    point(name: string): IColumn;
+    lineString(name: string): IColumn;
+    polygon(name: string): IColumn;
+    geometryCollection(name: string): IColumn;
+    multiPoint(name: string): IColumn;
+    multiLineString(name: string): IColumn;
+    multiPolygon(name: string): IColumn;
+    increments(name: string): IColumn;
+    bigIncrements(name: string): IColumn;
+    timestamps(): void;
+    softDeletes(): void;
+    getColumns(): Map<string, IColumn>;
+    getTable(): string;
+}
+export declare const Schema: Readonly<{
+    /**
+     * Create a new schema instance
+     */
+    create(table: string): ISchema;
+}>;
+//# sourceMappingURL=Schema.d.ts.map

package/src/orm/Schema.d.ts.map

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

package/src/orm/Schema.js

@@ -0,0 +1,169 @@
+/**
+ * Schema - Column definition and type system
+ * Defines database columns with type safety
+ */
+const definitionBuilder = (name, type) => {
+    return {
+        name,
+        type,
+        nullable: false,
+        unique: false,
+        primary: false,
+        index: false,
+    };
+};
+const createColumnFromDefinition = (definition) => {
+    const column = {};
+    const enable = (key) => {
+        return () => {
+            definition[key] = true;
+            return column;
+        };
+    };
+    const assign = (key) => {
+        return (value) => {
+            definition[key] = value;
+            return column;
+        };
+    };
+    column.nullable = enable('nullable');
+    column.unique = enable('unique');
+    column.primary = enable('primary');
+    column.index = enable('index');
+    column.autoIncrement = enable('autoIncrement');
+    column.unsigned = enable('unsigned');
+    column.change = enable('change');
+    column.drop = enable('drop');
+    column.first = enable('first');
+    column.default = assign('default');
+    column.comment = assign('comment');
+    column.references = assign('references');
+    column.on = assign('on');
+    column.onDelete = assign('onDelete');
+    column.onUpdate = assign('onUpdate');
+    column.renameTo = assign('renameTo');
+    column.after = assign('after');
+    column.charset = assign('charset');
+    column.collation = assign('collation');
+    column.length = assign('length');
+    column.precision = assign('precision');
+    column.scale = assign('scale');
+    column.values = assign('values');
+    column.getDefinition = () => ({ ...definition });
+    return column;
+};
+/**
+ * Column - Column definition builder
+ * Sealed namespace object following Pattern 2
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export const Column = Object.freeze({
+    /**
+     * Create a new column instance
+     */
+    create(name, type) {
+        const definition = definitionBuilder(name, type);
+        return createColumnFromDefinition(definition);
+    },
+});
+/**
+ * Schema - Table definition builder
+ * Refactored to Functional Object pattern
+ */
+/**
+ * Create a column proxy to track definition updates
+ */
+const createColumnProxy = (name, type, columns) => {
+    const column = Column.create(name, type);
+    columns.set(name, column);
+    return column;
+};
+const SIMPLE_SCHEMA_COLUMN_TYPES = [
+    'integer',
+    'boolean',
+    'date',
+    'datetime',
+    'json',
+    'text',
+    'timestamp',
+    'uuid',
+    'float',
+    'double',
+    'binary',
+    'bigInteger',
+    'smallInteger',
+    'tinyInteger',
+    'mediumInteger',
+    'time',
+    'year',
+    'longText',
+    'mediumText',
+    'tinyText',
+    'blob',
+    'mediumBlob',
+    'longBlob',
+    'tinyBlob',
+    'ipAddress',
+    'macAddress',
+    'geometry',
+    'point',
+    'lineString',
+    'polygon',
+    'geometryCollection',
+    'multiPoint',
+    'multiLineString',
+    'multiPolygon',
+];
+const setSchemaMethod = (target, key, fn) => {
+    target[key] = fn;
+};
+export const Schema = Object.freeze({
+    /**
+     * Create a new schema instance
+     */
+    create(table) {
+        const columns = new Map();
+        const schema = {};
+        setSchemaMethod(schema, 'string', (name, length) => {
+            const col = createColumnProxy(name, 'string', columns);
+            if (length !== undefined)
+                col.length(length);
+            return col;
+        });
+        setSchemaMethod(schema, 'decimal', (name, precision, scale) => {
+            const col = createColumnProxy(name, 'decimal', columns);
+            if (precision !== undefined)
+                col.precision(precision);
+            if (scale !== undefined)
+                col.scale(scale);
+            return col;
+        });
+        setSchemaMethod(schema, 'enum', (name, values) => {
+            const col = createColumnProxy(name, 'enum', columns);
+            col.values(values);
+            return col;
+        });
+        setSchemaMethod(schema, 'char', (name, length) => {
+            const col = createColumnProxy(name, 'char', columns);
+            if (length !== undefined)
+                col.length(length);
+            return col;
+        });
+        for (const type of SIMPLE_SCHEMA_COLUMN_TYPES) {
+            setSchemaMethod(schema, type, (name) => createColumnProxy(name, type, columns));
+        }
+        setSchemaMethod(schema, 'increments', (name) => createColumnProxy(name, 'integer', columns).primary().autoIncrement());
+        setSchemaMethod(schema, 'bigIncrements', (name) => createColumnProxy(name, 'bigInteger', columns).primary().autoIncrement());
+        setSchemaMethod(schema, 'timestamps', () => {
+            createColumnProxy('created_at', 'timestamp', columns).nullable();
+            createColumnProxy('updated_at', 'timestamp', columns).nullable();
+        });
+        setSchemaMethod(schema, 'softDeletes', () => {
+            createColumnProxy('deleted_at', 'timestamp', columns).nullable();
+        });
+        setSchemaMethod(schema, 'getColumns', () => columns);
+        setSchemaMethod(schema, 'getTable', () => table);
+        return schema;
+    },
+});

package/src/orm/adapters/D1Adapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cloudflare D1 Database Adapter
+ */
+import { DatabaseConfig, IDatabaseAdapter } from '../DatabaseAdapter';
+/**
+ * D1 adapter implementation
+ */
+export declare const D1Adapter: Readonly<{
+    /**
+     * Create a new D1 adapter instance
+     */
+    create(_config: DatabaseConfig): IDatabaseAdapter;
+}>;
+export default D1Adapter;
+//# sourceMappingURL=D1Adapter.d.ts.map

package/src/orm/adapters/D1Adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"D1Adapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/D1Adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAe,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAoBlG;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;oBAEa,cAAc,GAAG,gBAAgB;EAkGjD,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/src/orm/adapters/D1Adapter.js

@@ -0,0 +1,125 @@
+/**
+ * Cloudflare D1 Database Adapter
+ */
+import { FeatureFlags } from '../../config/features';
+import { Logger } from '../../config/logger';
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+/**
+ * Get D1 binding from config or global environment
+ */
+function getD1Binding(_config) {
+    // 1. Check config
+    if (_config.d1 !== undefined && _config.d1 !== null)
+        return _config.d1;
+    // 2. Check global env (Cloudflare Workers)
+    const globalEnv = globalThis.env;
+    if (globalEnv?.DB !== undefined)
+        return globalEnv.DB;
+    // 3. Check global scope
+    const globalDB = globalThis.DB;
+    if (globalDB !== undefined)
+        return globalDB;
+    return null;
+}
+/**
+ * D1 adapter implementation
+ */
+export const D1Adapter = Object.freeze({
+    /**
+     * Create a new D1 adapter instance
+     */
+    // eslint-disable-next-line max-lines-per-function
+    create(_config) {
+        let connected = false;
+        return {
+            // eslint-disable-next-line @typescript-eslint/require-await
+            async connect() {
+                connected = true;
+                Logger.info('✓ D1 connected');
+            },
+            // eslint-disable-next-line @typescript-eslint/require-await
+            async disconnect() {
+                connected = false;
+                Logger.info('✓ D1 disconnected');
+            },
+            async query(sql, parameters) {
+                if (!connected)
+                    throw ErrorFactory.createConnectionError('Database not connected');
+                const db = getD1Binding(_config);
+                if (db === null) {
+                    throw ErrorFactory.createConfigError('D1 database binding not found');
+                }
+                try {
+                    const stmt = db.prepare(sql);
+                    const result = await stmt.bind(...parameters).all();
+                    const rows = result.results ?? [];
+                    return {
+                        rows,
+                        rowCount: rows.length,
+                    };
+                }
+                catch (error) {
+                    throw ErrorFactory.createTryCatchError(`D1 query failed: ${sql}`, error);
+                }
+            },
+            async queryOne(sql, parameters) {
+                if (!connected)
+                    throw ErrorFactory.createConnectionError('Database not connected');
+                const db = getD1Binding(_config);
+                if (db === null) {
+                    throw ErrorFactory.createConfigError('D1 database binding not found');
+                }
+                try {
+                    const stmt = db.prepare(sql);
+                    const result = await stmt.bind(...parameters).first();
+                    return result ?? null;
+                }
+                catch (error) {
+                    throw ErrorFactory.createTryCatchError(`D1 queryOne failed: ${sql}`, error);
+                }
+            },
+            async transaction(callback) {
+                if (!connected)
+                    throw ErrorFactory.createConnectionError('Database not connected');
+                try {
+                    const result = await callback(this);
+                    return result;
+                }
+                catch (error) {
+                    throw ErrorFactory.createTryCatchError('Transaction failed', error);
+                }
+            },
+            getType() {
+                return 'd1';
+            },
+            isConnected() {
+                return connected;
+            },
+            async rawQuery(sql, parameters) {
+                if (!FeatureFlags.isRawQueryEnabled()) {
+                    throw ErrorFactory.createConfigError('Raw SQL queries are disabled');
+                }
+                if (!connected) {
+                    throw ErrorFactory.createConnectionError('Database not connected');
+                }
+                const db = getD1Binding(_config);
+                if (db === null) {
+                    throw ErrorFactory.createConfigError('D1 database binding not found');
+                }
+                try {
+                    Logger.warn(`Raw SQL Query executed: ${sql}`, { parameters });
+                    const stmt = db.prepare(sql);
+                    const result = await stmt.bind(...(parameters ?? [])).all();
+                    return result.results ?? [];
+                }
+                catch (error) {
+                    throw ErrorFactory.createTryCatchError(`Raw SQL query failed: ${sql}`, error);
+                }
+            },
+            getPlaceholder(_index) {
+                return '?';
+            },
+        };
+    },
+});
+export default D1Adapter;

package/src/orm/adapters/MySQLAdapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MySQL Database Adapter
+ */
+import { DatabaseConfig, IDatabaseAdapter } from '../DatabaseAdapter';
+/**
+ * MySQL adapter implementation
+ * Sealed namespace for immutability
+ */
+export declare const MySQLAdapter: Readonly<{
+    /**
+     * Create a new MySQL adapter instance
+     */
+    create(config: DatabaseConfig): IDatabaseAdapter;
+}>;
+export default MySQLAdapter;
+//# sourceMappingURL=MySQLAdapter.d.ts.map

package/src/orm/adapters/MySQLAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/MySQLAdapter.ts"],"names":[],"mappings":"AAEA;;GAEG;AAKH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;mBACY,cAAc,GAAG,gBAAgB;EA0EhD,CAAC;AAEH,eAAe,YAAY,CAAC"}