@ug.software/opposer 3.0.10

package/lib/esm/examples/orm/models/profile.d.ts

@@ -0,0 +1,7 @@
+import User from "./user.js";
+export default class Profile {
+    id: string;
+    bio: string;
+    avatarUrl: string;
+    user: User;
+}

package/lib/esm/examples/orm/models/profile.js

@@ -0,0 +1,37 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Field, PrimaryColumn, Relation } from "../../../orm/index.js";
+import User from "./user.js";
+let Profile = class Profile {
+};
+__decorate([
+    PrimaryColumn({ type: "uuid" }),
+    __metadata("design:type", String)
+], Profile.prototype, "id", void 0);
+__decorate([
+    Field({ type: "string" }),
+    __metadata("design:type", String)
+], Profile.prototype, "bio", void 0);
+__decorate([
+    Field({ type: "string" }),
+    __metadata("design:type", String)
+], Profile.prototype, "avatarUrl", void 0);
+__decorate([
+    Relation({
+        type: "one-to-one",
+        target: () => User,
+        inverseSide: "profile"
+    }),
+    __metadata("design:type", User)
+], Profile.prototype, "user", void 0);
+Profile = __decorate([
+    Entity("profiles")
+], Profile);
+export default Profile;

package/lib/esm/examples/orm/models/user.d.ts

@@ -0,0 +1,11 @@
+import Profile from "./profile.js";
+import Permission from "./permission.js";
+export default class User {
+    id: string;
+    name: string;
+    email: string;
+    age: number;
+    createdAt: Date;
+    profile?: Profile;
+    permissions?: Permission[];
+}

package/lib/esm/examples/orm/models/user.js

@@ -0,0 +1,65 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Field, PrimaryColumn, Relation, f } from "../../../orm/index.js";
+import Profile from "./profile.js";
+import Permission from "./permission.js";
+let User = class User {
+};
+__decorate([
+    PrimaryColumn({ type: "uuid" }),
+    __metadata("design:type", String)
+], User.prototype, "id", void 0);
+__decorate([
+    Field({
+        type: "string",
+        validation: () => f().string("Name must be a string").required("Name is required")
+    }),
+    __metadata("design:type", String)
+], User.prototype, "name", void 0);
+__decorate([
+    Field({
+        type: "string",
+        validation: () => f().string("Email must be a string").required("Email is required").match(/^[^\s@]+@[^\s@]+\.[^\s@]+$/, "Invalid email format")
+    }),
+    __metadata("design:type", String)
+], User.prototype, "email", void 0);
+__decorate([
+    Field({
+        type: "number",
+        default: 18,
+        validation: () => f().number("Age must be a number").min(18, "Must be at least 18 years old")
+    }),
+    __metadata("design:type", Number)
+], User.prototype, "age", void 0);
+__decorate([
+    Field({ type: "date", default: new Date() }),
+    __metadata("design:type", Date)
+], User.prototype, "createdAt", void 0);
+__decorate([
+    Relation({
+        type: "one-to-one",
+        target: () => Profile,
+        inverseSide: "user",
+        joinColumn: true
+    }),
+    __metadata("design:type", Profile)
+], User.prototype, "profile", void 0);
+__decorate([
+    Relation({
+        type: "one-to-many",
+        target: () => Permission,
+        inverseSide: "user"
+    }),
+    __metadata("design:type", Array)
+], User.prototype, "permissions", void 0);
+User = __decorate([
+    Entity("users")
+], User);
+export default User;

package/lib/esm/examples/orm/mysql/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/esm/examples/orm/mysql/index.js

@@ -0,0 +1,39 @@
+import { OpposerDatabase, MySQLDriver } from "../../../orm/index.js";
+import User from "../models/user.js";
+import Profile from "../models/profile.js";
+import Permission from "../models/permission.js";
+async function runMySQLExample() {
+    console.log("🐬 --- OpposerDatabase: MySQL Example ---");
+    const driver = new MySQLDriver({
+        type: "mysql",
+        host: "localhost",
+        port: 3306,
+        username: "root",
+        password: "password",
+        database: "opposer_db",
+    });
+    const db = new OpposerDatabase(driver, [User, Profile, Permission]);
+    try {
+        // await db.connect();
+        console.log("✅ MySQL initialized.");
+        const userRepository = db.getRepository(User);
+        console.log("\n🔍 Relationship Overview:");
+        console.log("- User 1:1 Profile (joined via User.profile)");
+        console.log("- User 1:N Permission (joined via User.permissions)");
+        // Example search using Opposer's JSON query builder (mapped to MySQL ?)
+        const results = await userRepository.find({
+            where: {
+                $or: [
+                    { name: "Admin" },
+                    { email: { $il: "root@%" } }
+                ]
+            },
+            select: ["name", "email"]
+        });
+        console.log("Example query executed on MySQL.");
+    }
+    catch (error) {
+        console.error("❌ Error:", error);
+    }
+}
+runMySQLExample();

package/lib/esm/examples/orm/postgres/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/esm/examples/orm/postgres/index.js

@@ -0,0 +1,35 @@
+import { OpposerDatabase, PostgresDriver } from "../../../orm/index.js";
+import User from "../models/user.js";
+import Profile from "../models/profile.js";
+import Permission from "../models/permission.js";
+async function runPostgresExample() {
+    console.log("🐘 --- OpposerDatabase: PostgreSQL Example ---");
+    const driver = new PostgresDriver({
+        type: "postgres",
+        host: "localhost",
+        port: 5432,
+        username: "postgres",
+        password: "password",
+        database: "opposer_db",
+    });
+    const db = new OpposerDatabase(driver, [User, Profile, Permission]);
+    try {
+        // await db.connect();
+        console.log("✅ PostgreSQL initialized.");
+        const userRepository = db.getRepository(User);
+        console.log("\n🔍 Relationship Overview:");
+        console.log("- User 1:1 Profile (joined via User.profile)");
+        console.log("- User 1:N Permission (joined via User.permissions)");
+        // Example query with relationships (using JSON structure)
+        const user = await userRepository.find({
+            where: { name: { $il: "Admin%" } },
+            select: ["name", "email", "profile", "permissions"],
+            pagination: { page: 0, take: 5 }
+        });
+        console.log("Example query executed on Postgres.");
+    }
+    catch (error) {
+        console.error("❌ Error:", error);
+    }
+}
+runPostgresExample();

package/lib/esm/examples/orm/sqlite/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/esm/examples/orm/sqlite/index.js

@@ -0,0 +1,36 @@
+import { OpposerDatabase, SQLiteDriver } from "../../../orm/index.js";
+import User from "../models/user.js";
+import Profile from "../models/profile.js";
+import Permission from "../models/permission.js";
+async function runSQLiteExample() {
+    console.log("📁 --- OpposerDatabase: SQLite Example ---");
+    const driver = new SQLiteDriver({
+        type: "sqlite",
+        database: "./opposer-test.db",
+    });
+    const db = new OpposerDatabase(driver, [User, Profile, Permission]);
+    try {
+        // await db.connect();
+        console.log("✅ SQLite initialized.");
+        const userRepository = db.getRepository(User);
+        console.log("\n🔍 Relationship Overview:");
+        console.log("- User 1:1 Profile (joined via User.profile)");
+        console.log("- User 1:N Permission (joined via User.permissions)");
+        // Validation check for relations
+        const userData = {
+            name: "Lite User",
+            email: "lite@sqlite.org",
+            profile: { bio: "My life in a small file." }
+        };
+        console.log("Validating user data with nested profile structure.");
+        const errors = userRepository.validate(userData);
+        if (Object.keys(errors).length === 0) {
+            console.log("✅ Data is valid for insertion.");
+        }
+        console.log("Example operation executed on SQLite.");
+    }
+    catch (error) {
+        console.error("❌ Error:", error);
+    }
+}
+runSQLiteExample();

package/lib/esm/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./server/index.js";
+export { default as Server } from "./server/index.js";

package/lib/esm/index.js

@@ -0,0 +1,2 @@
+export * from "./server/index.js";
+export { default as Server } from "./server/index.js";

package/lib/esm/interfaces/controller.d.ts

@@ -0,0 +1,109 @@
+import { ClassType } from './system.js';
+export interface ControllerApiProps {
+    controller?: string;
+    method: 'get' | 'insert' | 'update' | 'delete' | string;
+    model: string;
+    payload?: any;
+    data?: any;
+}
+export interface QueryBuilder {
+    [key: string]: string | number | boolean | Date | {
+        $or?: {
+            [key: string]: any;
+        }[];
+        $l?: string;
+        $il?: string;
+        $in?: (string | number | Date)[];
+        $nin?: (string | number | Date)[];
+        $btw?: [number, number];
+        $mt?: number | Date;
+        $mte?: number | Date;
+        $lt?: number | Date;
+        $lte?: number | Date;
+        $eq?: any;
+    };
+}
+export interface RelationBuilder {
+    model: string;
+    select: (string | RelationBuilder)[];
+}
+export type AggregateOperator = 'sum' | 'avg' | 'min' | 'max' | 'count';
+export interface HandleGetProps {
+    model: string;
+    pagination?: {
+        page: number;
+        take: number;
+    };
+    query: {
+        type?: 'filter' | 'find' | 'count' | 'exists' | 'aggregate' | 'distinct' | 'group';
+        select?: string[];
+        find?: QueryBuilder;
+        filter?: QueryBuilder;
+        count?: QueryBuilder;
+        exists?: QueryBuilder;
+        aggregate?: {
+            where?: QueryBuilder;
+            aggregate: {
+                [key: string]: AggregateOperator;
+            };
+        };
+        distinct?: {
+            where?: QueryBuilder;
+            field: string;
+        };
+        group?: {
+            where?: QueryBuilder;
+            by: string[];
+            aggregate?: {
+                [key: string]: AggregateOperator;
+            };
+            select?: string[];
+        };
+        relation?: (string | RelationBuilder)[];
+    };
+}
+export interface HandleDeleteProps {
+    model: string;
+    filter: QueryBuilder;
+}
+export interface HandleInsertProps {
+    model: string;
+    data: {
+        [key: string]: unknown;
+    };
+}
+export interface HandleUpdateProps {
+    model: string;
+    filter: QueryBuilder;
+    data: {
+        [key: string]: unknown;
+    };
+}
+export interface ResultGetAllControllers {
+    [key: string]: {
+        metadata: {
+            name: string;
+        };
+        methods: {
+            name: string;
+        }[];
+        controller: ClassType<any>;
+    };
+}
+export interface PayloadRequest<D> {
+    data: D;
+    headers: {
+        autorization: string;
+        contentType: string;
+        accept: string;
+        origin: string;
+        referer: string;
+        userAgent: string;
+        ip: string;
+        cookies: {
+            data: Record<string, string>;
+            set: (name: string, value: string, options: any) => void;
+            remove: (name: string, options?: any) => void;
+        };
+    };
+}

package/lib/esm/interfaces/controller.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/field.d.ts

@@ -0,0 +1,23 @@
+export type ValidationFunction = (value: unknown, context: object) => string | null;
+export interface SettingsField {
+    required?: boolean;
+    default?: any;
+    length?: number;
+    match?: RegExp;
+    min?: number;
+    max?: number;
+    relation?: {
+        target: () => any;
+        type: "many-to-one" | "one-to-many" | "many-to-many" | "one-to-one" | null;
+        inverseSide: string;
+        joinColumn?: boolean;
+        joinTable?: boolean;
+        cascade?: boolean;
+    };
+}
+export interface Field {
+    type: "string" | "boolean" | "number" | "date" | "relation" | "array" | "jsonb" | null;
+    _cases: ValidationFunction[];
+    _settings: SettingsField;
+    validate: (value: any, context: object) => string[];
+}

package/lib/esm/interfaces/field.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/handler.d.ts

@@ -0,0 +1,18 @@
+import { CookieOptions } from "express";
+export interface PayloadRequest<D> {
+    data: D;
+    headers: {
+        autorization: string;
+        contentType: string;
+        accept: string;
+        origin: string;
+        referer: string;
+        userAgent: string;
+        ip: string;
+        cookies: {
+            data: Record<string, string>;
+            set: (name: string, value: string, options: CookieOptions) => void;
+            remove: (name: string, options?: CookieOptions) => void;
+        };
+    };
+}

package/lib/esm/interfaces/handler.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/jwt.d.ts

@@ -0,0 +1,21 @@
+export interface ErrorJwt {
+    name: string;
+    message: string;
+    expiredAt: number;
+}
+export interface SignJwt {
+    id: string;
+    exp: number;
+    fn: string;
+    ln: string;
+    lg: string;
+    rl: {
+        sm: string;
+        mt: string;
+    }[];
+}
+export interface ForgetJwt {
+    lg: string;
+    ip: string;
+    ag: string;
+}

package/lib/esm/interfaces/jwt.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/model.d.ts

@@ -0,0 +1,9 @@
+import { Field } from "./field.js";
+export interface ModelDefinition {
+    [key: string]: Field;
+}
+export interface ModelResult {
+    validation: Record<string, any>;
+    entity: any;
+    definition: ModelDefinition;
+}

package/lib/esm/interfaces/model.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/request.d.ts

@@ -0,0 +1,13 @@
+export interface HandleRequestResultSuccess<R> {
+    success: true;
+    data: R;
+}
+export interface HandleRequestResultError {
+    success: false;
+    error: {
+        name: string;
+        code: number;
+        message: any;
+    };
+}
+export type HandleRequestResult<R> = HandleRequestResultSuccess<R> | HandleRequestResultError;

package/lib/esm/interfaces/request.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/schema.d.ts

@@ -0,0 +1,9 @@
+import { Field } from './field.js';
+export interface ModelDefinition {
+    [key: string]: Field;
+}
+export interface ModelResult {
+    validation: Record<string, any>;
+    entity: any;
+    definition: ModelDefinition;
+}

package/lib/esm/interfaces/schema.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/security.d.ts

@@ -0,0 +1,32 @@
+export interface PayloadAuthRegister {
+    fn: string;
+    ln: string;
+    lg: string;
+    ps: string;
+}
+export interface PayloadSocialLogin {
+    id: string;
+    fn: string;
+    ln: string;
+    lg: string;
+    rl: {
+        sm: string;
+        mt: string;
+    }[];
+}
+export interface PayloadAuthLogin {
+    lg: string;
+    ps: string;
+    ip: string;
+    ag: string;
+}
+export interface PayloadAuthForgetPassword {
+    lg: string;
+    ip: string;
+    ag: string;
+}
+export interface PayloadAuthChangePassword {
+    tk: string;
+    ps: string;
+    rw: string;
+}

package/lib/esm/interfaces/security.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/server.d.ts

@@ -0,0 +1,37 @@
+import http from "http";
+import { ClassType } from "./system.js";
+export interface CreateServerProps {
+    cors?: {
+        origin: string | string[];
+    };
+    models?: string | ClassType<unknown>[];
+    controllers?: string | ClassType<unknown>[];
+    schedules?: string | ClassType<unknown>[];
+}
+export interface Request extends http.IncomingMessage {
+    server: OpposerServer;
+    ip?: string;
+    cookies: Record<string, string>;
+    body: any;
+    url: string;
+    method: string;
+}
+export interface Response extends http.ServerResponse {
+    status: (code: number) => Response;
+    json: (data: any) => void;
+    send: (data: any) => void;
+    cookie: (name: string, value: string, options?: any) => void;
+    clearCookie: (name: string, options?: any) => void;
+}
+export type NextFunction = () => void | Promise<void>;
+export interface OpposerServer {
+    use: (middleware: any) => OpposerServer;
+    listen: (port: number, callback?: () => void) => http.Server;
+}
+export interface ServerInstance {
+    opposer: OpposerServer;
+    initialize: () => void;
+}
+export type Server = http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+export type HandleCallback = (req: http.IncomingMessage, res: http.ServerResponse) => void;
+export type ListinerCallback = () => void;

package/lib/esm/interfaces/server.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/interfaces/system.d.ts

@@ -0,0 +1,41 @@
+import { ConnectionOptions } from "../orm/index.js";
+export interface OpposerSystemConfigOptions {
+    models: string;
+    schedules: string;
+    controllers: string;
+    port: number;
+    url?: string;
+    text?: boolean;
+    urlencoded?: boolean;
+    helmet?: boolean;
+    logger?: boolean;
+    cors?: {
+        origin: string | string[];
+    };
+    rateLimit?: {
+        windowMs: number;
+        max: number;
+    };
+    auth: boolean | {
+        exposeChangePassword: boolean;
+    };
+    jwt: {
+        access: string;
+        refresh: string;
+        recover: string;
+    };
+    database: ConnectionOptions;
+    manager: {
+        firstName: string;
+        lastName: string;
+        login: string;
+        password: string;
+    };
+}
+export interface ClassType<T> {
+    new (...args: any[]): T;
+}
+export interface ModelDefinition {
+    name: string;
+    entity: ClassType<unknown>;
+}

package/lib/esm/interfaces/system.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/orm/decorators/index.d.ts

@@ -0,0 +1,33 @@
+import { FieldType } from "../metadata.js";
+import { FieldValidator } from "../validation.js";
+export interface EntityOptions {
+    description?: string;
+}
+export declare function Entity(tableName: string, optionsOrDescription?: EntityOptions | string): (target: any, context?: any) => void;
+export interface RelationOptions {
+    type: "one-to-one" | "one-to-many" | "many-to-one" | "many-to-many";
+    target: () => Function;
+    inverseSide?: string;
+    joinColumn?: boolean;
+}
+export interface FieldOptions {
+    type?: FieldType;
+    primary?: boolean;
+    generated?: boolean;
+    nullable?: boolean;
+    default?: any;
+    length?: number;
+    createDate?: boolean;
+    updateDate?: boolean;
+    relation?: RelationOptions;
+    validation?: () => FieldValidator;
+}
+export declare function Field(optionsOrValidation?: FieldOptions | (() => FieldValidator)): (target: any, contextOrKey: any) => void;
+export declare function PrimaryColumn(options?: FieldOptions): (target: any, contextOrKey: any) => void;
+export declare function Relation(options: RelationOptions): (target: any, contextOrKey: any) => void;
+export declare function CreateDateColumn(): (target: any, contextOrKey: any) => void;
+export declare function UpdateDateColumn(): (target: any, contextOrKey: any) => void;
+export declare const BeforeInsert: () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => void;
+export declare const AfterInsert: () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => void;
+export declare const BeforeUpdate: () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => void;
+export declare const AfterUpdate: () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => void;