@objectql/core 1.2.0 → 1.3.0

package/src/action.ts

@@ -0,0 +1,40 @@
+import { ActionContext, ActionHandler, MetadataRegistry } from '@objectql/types';
+
+export interface ActionEntry {
+    handler: ActionHandler;
+    packageName?: string;
+}
+
+export function registerActionHelper(
+    actions: Record<string, ActionEntry>,
+    objectName: string,
+    actionName: string,
+    handler: ActionHandler,
+    packageName?: string
+) {
+    const key = `${objectName}:${actionName}`;
+    actions[key] = { handler, packageName };
+}
+
+export async function executeActionHelper(
+    metadata: MetadataRegistry,
+    runtimeActions: Record<string, ActionEntry>,
+    objectName: string,
+    actionName: string,
+    ctx: ActionContext
+) {
+    // 1. Programmatic
+    const key = `${objectName}:${actionName}`;
+    const actionEntry = runtimeActions[key];
+    if (actionEntry) {
+        return await actionEntry.handler(ctx);
+    }
+
+    // 2. Registry (File-based)
+    const fileActions = metadata.get<any>('action', objectName);
+    if (fileActions && typeof fileActions[actionName] === 'function') {
+        return await fileActions[actionName](ctx);
+    }
+
+    throw new Error(`Action '${actionName}' not found for object '${objectName}'`);
+}

package/src/app.ts

@@ -0,0 +1,257 @@
+import { 
+    MetadataRegistry, 
+    Driver, 
+    ObjectConfig, 
+    ObjectQLContext, 
+    ObjectQLContextOptions, 
+    IObjectQL, 
+    ObjectQLConfig,
+    ObjectQLPlugin,
+    HookName,
+    HookHandler,
+    HookContext,
+    ActionHandler,
+    ActionContext,
+    LoaderPlugin
+} from '@objectql/types';
+import { ObjectLoader } from './loader';
+import { ObjectRepository } from './repository';
+import { loadPlugin } from './plugin';
+import { createDriverFromConnection } from './driver';
+import { loadRemoteFromUrl } from './remote';
+import { executeActionHelper, registerActionHelper, ActionEntry } from './action';
+import { registerHookHelper, triggerHookHelper, HookEntry } from './hook';
+import { registerObjectHelper, getConfigsHelper } from './object';
+
+export class ObjectQL implements IObjectQL {
+    public metadata: MetadataRegistry;
+    private loader: ObjectLoader;
+    private datasources: Record<string, Driver> = {};
+    private remotes: string[] = [];
+    private hooks: Record<string, HookEntry[]> = {};
+    private actions: Record<string, ActionEntry> = {};
+    private pluginsList: ObjectQLPlugin[] = [];
+    
+    // Store config for lazy loading in init()
+    private config: ObjectQLConfig;
+
+    constructor(config: ObjectQLConfig) {
+        this.config = config;
+        this.metadata = config.registry || new MetadataRegistry();
+        this.loader = new ObjectLoader(this.metadata);
+        this.datasources = config.datasources || {};
+        this.remotes = config.remotes || [];
+        
+        if (config.connection) {
+            this.datasources['default'] = createDriverFromConnection(config.connection);
+        }
+
+        // Initialize Plugin List (but don't setup yet)
+        if (config.plugins) {
+            for (const plugin of config.plugins) {
+                if (typeof plugin === 'string') {
+                    this.use(loadPlugin(plugin));
+                } else {
+                    this.use(plugin);
+                }
+            }
+        }
+    }
+
+    addPackage(name: string) {
+        this.loader.loadPackage(name);
+    }
+
+    use(plugin: ObjectQLPlugin) {
+        this.pluginsList.push(plugin);
+    }
+
+    removePackage(name: string) {
+        this.metadata.unregisterPackage(name);
+        
+        // Remove hooks
+        for (const event of Object.keys(this.hooks)) {
+            this.hooks[event] = this.hooks[event].filter(h => h.packageName !== name);
+        }
+        
+        // Remove actions
+        for (const key of Object.keys(this.actions)) {
+            if (this.actions[key].packageName === name) {
+                delete this.actions[key];
+            }
+        }
+    }
+
+    on(event: HookName, objectName: string, handler: HookHandler, packageName?: string) {
+        registerHookHelper(this.hooks, event, objectName, handler, packageName);
+    }
+
+    async triggerHook(event: HookName, objectName: string, ctx: HookContext) {
+        await triggerHookHelper(this.metadata, this.hooks, event, objectName, ctx);
+    }
+
+    registerAction(objectName: string, actionName: string, handler: ActionHandler, packageName?: string) {
+        registerActionHelper(this.actions, objectName, actionName, handler, packageName);
+    }
+
+    async executeAction(objectName: string, actionName: string, ctx: ActionContext) {
+        return await executeActionHelper(this.metadata, this.actions, objectName, actionName, ctx);
+    }
+
+    loadFromDirectory(dir: string, packageName?: string) {
+        this.loader.load(dir, packageName);
+    }
+
+    addLoader(plugin: LoaderPlugin) {
+        this.loader.use(plugin);
+    }
+
+    createContext(options: ObjectQLContextOptions): ObjectQLContext {
+        const ctx: ObjectQLContext = {
+            userId: options.userId,
+            spaceId: options.spaceId,
+            roles: options.roles || [],
+            isSystem: options.isSystem,
+            object: (name: string) => {
+                return new ObjectRepository(name, ctx, this);
+            },
+            transaction: async (callback) => {
+                 const driver = this.datasources['default'];
+                 if (!driver || !driver.beginTransaction) {
+                      return callback(ctx);
+                 }
+
+                 let trx: any;
+                 try {
+                     trx = await driver.beginTransaction();
+                 } catch (e) {
+                     throw e;
+                 }
+
+                 const trxCtx: ObjectQLContext = {
+                     ...ctx,
+                     transactionHandle: trx,
+                     transaction: async (cb) => cb(trxCtx)
+                 };
+
+                 try {
+                     const result = await callback(trxCtx);
+                     if (driver.commitTransaction) await driver.commitTransaction(trx);
+                     return result;
+                 } catch (error) {
+                     if (driver.rollbackTransaction) await driver.rollbackTransaction(trx);
+                     throw error;
+                 }
+            },
+            sudo: () => {
+                 return this.createContext({ ...options, isSystem: true });
+            }
+        };
+        return ctx;
+    }
+
+    registerObject(object: ObjectConfig) {
+        registerObjectHelper(this.metadata, object);
+    }
+
+    unregisterObject(name: string) {
+        this.metadata.unregister('object', name);
+    }
+
+    getObject(name: string): ObjectConfig | undefined {
+        return this.metadata.get<ObjectConfig>('object', name);
+    }
+
+    getConfigs(): Record<string, ObjectConfig> {
+        return getConfigsHelper(this.metadata);
+    }
+
+    datasource(name: string): Driver {
+        const driver = this.datasources[name];
+        if (!driver) {
+            throw new Error(`Datasource '${name}' not found`);
+        }
+        return driver;
+    }
+
+    async init() {
+        // 0. Init Plugins (This allows plugins to register custom loaders)
+        for (const plugin of this.pluginsList) {
+            console.log(`Initializing plugin '${plugin.name}'...`);
+            
+            let app: IObjectQL = this;
+            const pkgName = (plugin as any)._packageName;
+
+            if (pkgName) {
+                app = new Proxy(this, {
+                    get(target, prop) {
+                        if (prop === 'on') {
+                            return (event: HookName, obj: string, handler: HookHandler) => 
+                                target.on(event, obj, handler, pkgName);
+                        }
+                        if (prop === 'registerAction') {
+                            return (obj: string, act: string, handler: ActionHandler) => 
+                                target.registerAction(obj, act, handler, pkgName);
+                        }
+                        const value = (target as any)[prop];
+                        return typeof value === 'function' ? value.bind(target) : value;
+                    }
+                });
+            }
+
+            await plugin.setup(app);
+        }
+
+        // 1. Load Presets/Packages (Base Layer) - AFTER plugins, so they can use new loaders
+        if (this.config.packages) {
+            for (const name of this.config.packages) {
+                this.addPackage(name);
+            }
+        }
+        if (this.config.presets) {
+            for (const name of this.config.presets) {
+                this.addPackage(name);
+            }
+        }
+
+        // 2. Load Local Sources (Application Layer)
+        if (this.config.source) {
+            const sources = Array.isArray(this.config.source) ? this.config.source : [this.config.source];
+            for (const src of sources) {
+                this.loader.load(src);
+            }
+        }
+
+        // 3. Load In-Memory Objects (Dynamic Layer)
+        if (this.config.objects) {
+            for (const [key, obj] of Object.entries(this.config.objects)) {
+                this.registerObject(obj);
+            }
+        }
+
+        // 4. Load Remotes
+        if (this.remotes.length > 0) {
+            console.log(`Loading ${this.remotes.length} remotes...`);
+            const results = await Promise.all(this.remotes.map(url => loadRemoteFromUrl(url)));
+            for (const res of results) {
+                if (res) {
+                    this.datasources[res.driverName] = res.driver;
+                    for (const obj of res.objects) {
+                        this.registerObject(obj);
+                    }
+                }
+            }
+        }
+
+        const objects = this.metadata.list<ObjectConfig>('object');
+        
+        // 5. Init Drivers (e.g. Sync Schema)
+        // Let's pass all objects to all configured drivers.
+        for (const [name, driver] of Object.entries(this.datasources)) {
+            if (driver.init) {
+                console.log(`Initializing driver '${name}'...`);
+                await driver.init(objects);
+            }
+        }
+    }
+}

package/src/driver.ts

@@ -0,0 +1,54 @@
+import { Driver } from '@objectql/types';
+
+export function createDriverFromConnection(connection: string): Driver {
+    let driverPackage = '';
+    let driverClass = '';
+    let driverConfig: any = {};
+    
+    if (connection.startsWith('mongodb://')) {
+        driverPackage = '@objectql/driver-mongo';
+        driverClass = 'MongoDriver';
+        driverConfig = { url: connection };
+    } 
+    else if (connection.startsWith('sqlite://')) {
+        driverPackage = '@objectql/driver-knex';
+        driverClass = 'KnexDriver';
+        const filename = connection.replace('sqlite://', '');
+        driverConfig = {
+            client: 'sqlite3',
+            connection: { filename },
+            useNullAsDefault: true
+        };
+    }
+    else if (connection.startsWith('postgres://') || connection.startsWith('postgresql://')) {
+        driverPackage = '@objectql/driver-knex';
+        driverClass = 'KnexDriver';
+        driverConfig = {
+            client: 'pg',
+            connection: connection
+        };
+    }
+    else if (connection.startsWith('mysql://')) {
+        driverPackage = '@objectql/driver-knex';
+        driverClass = 'KnexDriver';
+        driverConfig = {
+            client: 'mysql2',
+            connection: connection
+        };
+    }
+    else {
+        throw new Error(`Unsupported connection protocol: ${connection}`);
+    }
+
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const pkg = require(driverPackage);
+        const DriverClass = pkg[driverClass];
+        if (!DriverClass) {
+            throw new Error(`${driverClass} not found in ${driverPackage}`);
+        }
+        return new DriverClass(driverConfig);
+    } catch (e: any) {
+        throw new Error(`Failed to load driver ${driverPackage}. Please install it: npm install ${driverPackage}. Error: ${e.message}`);
+    }
+}

package/src/hook.ts

@@ -0,0 +1,42 @@
+import { HookContext, HookHandler, HookName, MetadataRegistry } from '@objectql/types';
+
+export interface HookEntry {
+    objectName: string;
+    handler: HookHandler;
+    packageName?: string;
+}
+
+export function registerHookHelper(
+    hooks: Record<string, HookEntry[]>,
+    event: HookName,
+    objectName: string,
+    handler: HookHandler,
+    packageName?: string
+) {
+    if (!hooks[event]) {
+        hooks[event] = [];
+    }
+    hooks[event].push({ objectName, handler, packageName });
+}
+
+export async function triggerHookHelper(
+    metadata: MetadataRegistry,
+    runtimeHooks: Record<string, HookEntry[]>,
+    event: HookName,
+    objectName: string,
+    ctx: HookContext
+) {
+    // 1. Registry Hooks (File-based)
+    const fileHooks = metadata.get<any>('hook', objectName);
+    if (fileHooks && typeof fileHooks[event] === 'function') {
+        await fileHooks[event](ctx);
+    }
+
+    // 2. Programmatic Hooks
+    const hooks = runtimeHooks[event] || [];
+    for (const hook of hooks) {
+        if (hook.objectName === '*' || hook.objectName === objectName) {
+            await hook.handler(ctx);
+        }
+    }
+}