@objectql/core 0.1.0

package/dist/repository.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectRepository = void 0;
+class ObjectRepository {
+    constructor(objectName, context, app) {
+        this.objectName = objectName;
+        this.context = context;
+        this.app = app;
+    }
+    getDriver() {
+        const obj = this.getSchema();
+        const datasourceName = obj.datasource || 'default';
+        return this.app.datasource(datasourceName);
+    }
+    getOptions(extra = {}) {
+        return {
+            transaction: this.context.transactionHandle,
+            ...extra
+        };
+    }
+    getSchema() {
+        const obj = this.app.getObject(this.objectName);
+        if (!obj) {
+            throw new Error(`Object '${this.objectName}' not found`);
+        }
+        return obj;
+    }
+    // === Hook Execution Logic ===
+    async executeHook(hookName, op, dataOrQuery) {
+        if (this.context.ignoreTriggers)
+            return;
+        const obj = this.getSchema();
+        if (!obj.listeners || !obj.listeners[hookName])
+            return;
+        const hookFn = obj.listeners[hookName];
+        // Construct HookContext
+        const hookContext = {
+            ctx: this.context,
+            entity: this.objectName,
+            op: op,
+            utils: {
+                restrict: (criterion) => {
+                    if (op !== 'find' && op !== 'count') {
+                        throw new Error('utils.restrict is only available in query operations');
+                    }
+                    const query = dataOrQuery;
+                    if (!query.filters) {
+                        query.filters = [criterion];
+                    }
+                    else {
+                        // Enclose existing filters in implicit AND group by array structure logic or explicit 'and'
+                        // Implementation depends on how driver parses.
+                        // Safe approach: filters = [ [criterion], 'and', [existing] ] or similar.
+                        // For simplicity assuming array of terms means AND:
+                        query.filters.push(criterion);
+                    }
+                }
+            },
+            getPreviousDoc: async () => {
+                // For update/delete, we might need the ID to find the doc.
+                // If doc has ID, use it.
+                // This is simplistic; usually 'update' takes 'id', we need to capture it from arguments.
+                if (op === 'create')
+                    return undefined;
+                if (dataOrQuery._id || dataOrQuery.id) {
+                    return this.findOne(dataOrQuery._id || dataOrQuery.id);
+                }
+                return undefined;
+            }
+        };
+        if (op === 'find' || op === 'count' || op === 'aggregate') {
+            hookContext.query = dataOrQuery;
+        }
+        else {
+            hookContext.doc = dataOrQuery;
+        }
+        // Pass ID manually if needed or attach to doc? 
+        // For strictness, getPreviousDoc needs the ID passed to the operation.
+        // We'll rely on "doc" having the data being processed.
+        await hookFn(hookContext);
+    }
+    async find(query = {}) {
+        // Hooks: beforeFind
+        await this.executeHook('beforeFind', 'find', query);
+        // TODO: Apply basic filters like spaceId (could be done via a default generic hook too)
+        const results = await this.getDriver().find(this.objectName, query, this.getOptions());
+        // Hooks: afterFind
+        // Not implemented in spec fully iterate results? usually for single doc or metadata
+        // For performance, afterFind on list is rare or costly. 
+        if (this.getSchema().listeners?.afterFind && !this.context.ignoreTriggers) {
+            const hookFn = this.getSchema().listeners.afterFind;
+            // Executing per result or once? Spec says "HookContext" has "doc". 
+            // If finding list, might not match signature.
+            // Implemented per-item for now (caution: performance).
+            /*
+            for (const item of results) {
+                await this.executeHookForDoc('afterFind', 'find', item);
+            }
+            */
+        }
+        return results;
+    }
+    async findOne(idOrQuery) {
+        if (typeof idOrQuery === 'string' || typeof idOrQuery === 'number') {
+            // Convert ID lookup to standard query to reuse 'find' hooks?
+            // Or treat as specific op. 
+            // Let's rely on simple driver call but maybe wrap in object for hook consistency if needed.
+            // For now, simple implementation:
+            return this.getDriver().findOne(this.objectName, idOrQuery, undefined, this.getOptions());
+        }
+        else {
+            const results = await this.find(idOrQuery);
+            return results[0] || null;
+        }
+    }
+    async count(filters) {
+        // Can wrap filters in a query object for hook
+        const query = { filters };
+        await this.executeHook('beforeFind', 'count', query); // Reusing beforeFind logic often?
+        return this.getDriver().count(this.objectName, query.filters, this.getOptions());
+    }
+    async create(doc) {
+        const obj = this.getSchema();
+        if (this.context.userId)
+            doc.created_by = this.context.userId;
+        if (this.context.spaceId)
+            doc.space_id = this.context.spaceId;
+        await this.executeHook('beforeCreate', 'create', doc);
+        const result = await this.getDriver().create(this.objectName, doc, this.getOptions());
+        await this.executeHook('afterCreate', 'create', result);
+        return result;
+    }
+    async update(id, doc, options) {
+        // Attach ID to doc for hook context to know which record
+        const docWithId = { ...doc, _id: id, id: id };
+        await this.executeHook('beforeUpdate', 'update', docWithId);
+        // Remove ID before sending to driver if driver doesn't like it in $set
+        const { _id, id: _id2, ...cleanDoc } = docWithId;
+        const result = await this.getDriver().update(this.objectName, id, cleanDoc, this.getOptions(options));
+        // Result might be count or doc depending on driver.
+        // If we want the updated doc for afterUpdate, we might need to fetch it if driver defaults to count.
+        // Assuming result is the doc or we just pass the patch.
+        await this.executeHook('afterUpdate', 'update', docWithId);
+        return result;
+    }
+    async delete(id) {
+        const docWithId = { _id: id, id: id };
+        await this.executeHook('beforeDelete', 'delete', docWithId);
+        const result = await this.getDriver().delete(this.objectName, id, this.getOptions());
+        await this.executeHook('afterDelete', 'delete', docWithId);
+        return result;
+    }
+    async aggregate(query) {
+        const driver = this.getDriver();
+        if (!driver.aggregate)
+            throw new Error("Driver does not support aggregate");
+        return driver.aggregate(this.objectName, query, this.getOptions());
+    }
+    async distinct(field, filters) {
+        const driver = this.getDriver();
+        if (!driver.distinct)
+            throw new Error("Driver does not support distinct");
+        return driver.distinct(this.objectName, field, filters, this.getOptions());
+    }
+    async findOneAndUpdate(filters, update, options) {
+        const driver = this.getDriver();
+        if (!driver.findOneAndUpdate)
+            throw new Error("Driver does not support findOneAndUpdate");
+        return driver.findOneAndUpdate(this.objectName, filters, update, this.getOptions(options));
+    }
+    async createMany(data) {
+        // TODO: Triggers per record?
+        const driver = this.getDriver();
+        if (!driver.createMany) {
+            // Fallback
+            const results = [];
+            for (const item of data) {
+                results.push(await this.create(item));
+            }
+            return results;
+        }
+        return driver.createMany(this.objectName, data, this.getOptions());
+    }
+    async updateMany(filters, data) {
+        const driver = this.getDriver();
+        if (!driver.updateMany)
+            throw new Error("Driver does not support updateMany");
+        return driver.updateMany(this.objectName, filters, data, this.getOptions());
+    }
+    async deleteMany(filters) {
+        const driver = this.getDriver();
+        if (!driver.deleteMany)
+            throw new Error("Driver does not support deleteMany");
+        return driver.deleteMany(this.objectName, filters, this.getOptions());
+    }
+    async call(actionName, params) {
+        const obj = this.getSchema();
+        const action = obj.actions?.[actionName];
+        if (!action) {
+            throw new Error(`Action '${actionName}' not found on object '${this.objectName}'`);
+        }
+        if (action.handler) {
+            return action.handler(this.context, params);
+        }
+        throw new Error(`Action '${actionName}' has no handler`);
+    }
+}
+exports.ObjectRepository = ObjectRepository;
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+import { ObjectRepository } from "./repository";
+import { ObjectConfig } from "./metadata";
+import { Driver } from "./driver";
+import { UnifiedQuery, FilterCriterion } from "./query";
+export { ObjectConfig } from "./metadata";
+export interface ObjectQLConfig {
+    datasources: Record<string, Driver>;
+    objects?: Record<string, ObjectConfig>;
+}
+export interface IObjectQL {
+    getObject(name: string): ObjectConfig | undefined;
+    getConfigs(): Record<string, ObjectConfig>;
+    datasource(name: string): Driver;
+}
+export interface HookContext<T = any> {
+    ctx: ObjectQLContext;
+    entity: string;
+    op: 'find' | 'create' | 'update' | 'delete' | 'count' | 'aggregate';
+    doc?: T;
+    query?: UnifiedQuery;
+    getPreviousDoc: () => Promise<T | undefined>;
+    utils: {
+        /**
+         * Safely injects a new filter criterion into the existing AST.
+         * It wraps existing filters in a new group to preserve operator precedence.
+         * * Logic: (Existing_Filters) AND (New_Filter)
+         */
+        restrict: (criterion: FilterCriterion) => void;
+    };
+}
+export type HookFunction = (context: HookContext) => Promise<void>;
+export interface ObjectQLContext {
+    userId?: string;
+    spaceId?: string;
+    roles: string[];
+    /**
+     * Sudo Mode / System Bypass.
+     * - true: Bypasses all permission checks (CRUD, Field Level Security, Record Level Security).
+     * - false/undefined: Enforces all permission checks based on 'roles'.
+     */
+    isSystem?: boolean;
+    /**
+     * Trigger Control.
+     * - true: Skips all lifecycle hooks (beforeCreate, afterUpdate, etc.).
+     * - Useful for bulk data imports or raw data correction to prevent side effects.
+     * - Requires 'isSystem: true' (Security Safeguard).
+     */
+    ignoreTriggers?: boolean;
+    /**
+     * Returns a repository proxy bound to this context.
+     * All operations performed via this proxy inherit userId, spaceId, and transaction.
+     */
+    object(entityName: string): ObjectRepository;
+    /**
+     * Execute a function within a transaction.
+     * The callback receives a new context 'trxCtx' which inherits userId and spaceId from this context.
+     */
+    transaction(callback: (trxCtx: ObjectQLContext) => Promise<any>): Promise<any>;
+    /**
+     * Returns a new context with system privileges (isSystem: true).
+     * It shares the same transaction scope as the current context.
+     */
+    sudo(): ObjectQLContext;
+    /**
+     * Internal: Driver-specific transaction handle.
+     */
+    transactionHandle?: any;
+}
+export interface ObjectQLContextOptions {
+    userId?: string;
+    spaceId?: string;
+    roles?: string[];
+    isSystem?: boolean;
+    ignoreTriggers?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/jest.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/test/**/*.test.ts'],
+};

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@objectql/core",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest"
+  },
+  "dependencies": {
+    "fast-glob": "^3.3.3",
+    "js-yaml": "^4.1.1"
+  }
+}

package/src/driver.ts

@@ -0,0 +1,24 @@
+export interface Driver {
+    find(objectName: string, query: any, options?: any): Promise<any[]>;
+    findOne(objectName: string, id: string | number, query?: any, options?: any): Promise<any>;
+    create(objectName: string, data: any, options?: any): Promise<any>;
+    update(objectName: string, id: string | number, data: any, options?: any): Promise<any>;
+    delete(objectName: string, id: string | number, options?: any): Promise<any>;
+    count(objectName: string, filters: any, options?: any): Promise<number>;
+    
+    // Advanced
+    aggregate?(objectName: string, query: any, options?: any): Promise<any>;
+    distinct?(objectName: string, field: string, filters?: any, options?: any): Promise<any[]>;
+    
+    // Bulk / Atomic
+    createMany?(objectName: string, data: any[], options?: any): Promise<any>;
+    updateMany?(objectName: string, filters: any, data: any, options?: any): Promise<any>;
+    deleteMany?(objectName: string, filters: any, options?: any): Promise<any>;
+    findOneAndUpdate?(objectName: string, filters: any, update: any, options?: any): Promise<any>;
+
+    // Transaction
+    beginTransaction?(): Promise<any>;
+    commitTransaction?(trx: any): Promise<void>;
+    rollbackTransaction?(trx: any): Promise<void>;
+}
+

package/src/index.ts

@@ -0,0 +1,107 @@
+export * from './metadata';
+export * from './types';
+export * from './driver';
+export * from './repository';
+export * from './query';
+
+import { ObjectConfig } from './metadata';
+import { ObjectQLContext, ObjectQLContextOptions, IObjectQL, ObjectQLConfig } from './types';
+import { ObjectRepository } from './repository';
+import { Driver } from './driver';
+import { loadObjectConfigs } from './loader';
+
+export class ObjectQL implements IObjectQL {
+    private objects: Record<string, ObjectConfig> = {};
+    private datasources: Record<string, Driver> = {};
+
+    constructor(config: ObjectQLConfig) {
+        this.datasources = config.datasources;
+        if (config.objects) {
+            for (const obj of Object.values(config.objects)) {
+                this.registerObject(obj);
+            }
+        }
+    }
+
+    loadFromDirectory(dir: string) {
+        const objects = loadObjectConfigs(dir);
+        for (const obj of Object.values(objects)) {
+            this.registerObject(obj);
+        }
+    }
+
+    createContext(options: ObjectQLContextOptions): ObjectQLContext {
+        const ctx: ObjectQLContext = {
+            userId: options.userId,
+            spaceId: options.spaceId,
+            roles: options.roles || [],
+            isSystem: options.isSystem,
+            ignoreTriggers: options.ignoreTriggers,
+            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) {
+                     // If beginTransaction fails, fail.
+                     throw e;
+                 }
+
+                 const trxCtx: ObjectQLContext = {
+                     ...ctx,
+                     transactionHandle: trx,
+                     // Nested transaction simply reuses the current one (flat transaction)
+                     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) {
+        // Normalize fields
+        if (object.fields) {
+            for (const [key, field] of Object.entries(object.fields)) {
+                if (!field.name) {
+                    field.name = key;
+                }
+            }
+        }
+        this.objects[object.name] = object;
+    }
+
+    getObject(name: string): ObjectConfig | undefined {
+        return this.objects[name];
+    }
+
+    getConfigs(): Record<string, ObjectConfig> {
+        return this.objects;
+    }
+
+    datasource(name: string): Driver {
+        const driver = this.datasources[name];
+        if (!driver) {
+            throw new Error(`Datasource '${name}' not found`);
+        }
+        return driver;
+    }
+}

package/src/loader.ts

@@ -0,0 +1,120 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+import * as glob from 'fast-glob';
+import { ObjectQLConfig, ObjectConfig } from './types';
+
+export function loadObjectConfigs(dir: string): Record<string, ObjectConfig> {
+    const configs: Record<string, ObjectConfig> = {};
+    
+    // 1. Load YAML Configs
+    const files = glob.sync(['**/*.object.yml', '**/*.object.yaml'], {
+        cwd: dir,
+        absolute: true
+    });
+
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, 'utf8');
+            const doc = yaml.load(content) as any;
+            
+            if (doc.name && doc.fields) {
+                configs[doc.name] = doc as ObjectConfig;
+            } else {
+                for (const [key, value] of Object.entries(doc)) {
+                    if (typeof value === 'object' && (value as any).fields) {
+                         configs[key] = value as ObjectConfig;
+                         if (!configs[key].name) configs[key].name = key;
+                    }
+                }
+            }
+        } catch (e) {
+            console.error(`Error loading object config from ${file}:`, e);
+        }
+    }
+
+    // 2. Load Hooks (.hook.js, .hook.ts)
+    // We only load .js if running in node, or .ts if ts-node/register is present.
+    // simpler: look for both, require will handle extension resolution if we are careful.
+    // Actually, in `dist` we only find .js. In `src` (test) we find .ts.
+    const hookFiles = glob.sync(['**/*.hook.{js,ts}'], {
+        cwd: dir,
+        absolute: true
+    });
+
+    for (const file of hookFiles) {
+        try {
+            // Check if we should ignore .ts if .js exists? 
+            // Or assume env handles it.
+            // If we are in `dist`, `src` shouldn't be there usually.
+            
+            const hookModule = require(file);
+            // Default export or named exports?
+            // Convention: export const listenTo = 'objectName';
+            // or filename based: 'project.hook.js' -> 'project' (flaky)
+            
+            let objectName = hookModule.listenTo;
+            
+            if (!objectName) {
+                // Try to guess from filename? 
+                // project.hook.ts -> project
+                const basename = path.basename(file);
+                const match = basename.match(/^(.+)\.hook\.(ts|js)$/);
+                if (match) {
+                    objectName = match[1];
+                }
+            }
+
+            if (objectName && configs[objectName]) {
+                 if (!configs[objectName].listeners) {
+                     configs[objectName].listeners = {};
+                 }
+                 const listeners = configs[objectName].listeners!;
+                 
+                 // Merge exported functions into listeners
+                 // Common hooks: beforeFind, afterFind, beforeCreate, etc.
+                 const hookNames = [
+                     'beforeFind', 'afterFind',
+                     'beforeCreate', 'afterCreate',
+                     'beforeUpdate', 'afterUpdate',
+                     'beforeDelete', 'afterDelete'
+                 ];
+
+                 for (const name of hookNames) {
+                     if (typeof hookModule[name] === 'function') {
+                         listeners[name as keyof typeof listeners] = hookModule[name];
+                     }
+                 }
+                 // Support default export having listeners object?
+                 if (hookModule.default && typeof hookModule.default === 'object') {
+                      Object.assign(listeners, hookModule.default);
+                 }
+
+                 // Load Actions
+                 // Convention: export const actions = { myAction: (ctx, params) => ... }
+                 // OR export function myAction(ctx, params) ... (Ambiguous with hooks? No, hooks have explicit names)
+                 // Safer: look for `actions` export.
+                 
+                 if (hookModule.actions && typeof hookModule.actions === 'object') {
+                     if (!configs[objectName].actions) {
+                         configs[objectName].actions = {};
+                     }
+                     
+                     for (const [actionName, handler] of Object.entries(hookModule.actions)) {
+                         // We might have metadata from YAML already
+                         if (!configs[objectName].actions![actionName]) {
+                             configs[objectName].actions![actionName] = { };
+                         }
+                         // Attach handler
+                         configs[objectName].actions![actionName].handler = handler as any;
+                     }
+                 }
+            }
+        } catch (e) {
+            console.error(`Error loading hook from ${file}:`, e);
+        }
+    }
+    
+    return configs;
+}
+