@objectql/core 0.1.0

package/dist/driver.d.ts

@@ -0,0 +1,17 @@
+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>;
+    aggregate?(objectName: string, query: any, options?: any): Promise<any>;
+    distinct?(objectName: string, field: string, filters?: any, options?: any): Promise<any[]>;
+    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>;
+    beginTransaction?(): Promise<any>;
+    commitTransaction?(trx: any): Promise<void>;
+    rollbackTransaction?(trx: any): Promise<void>;
+}

package/dist/driver.js

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

package/dist/driver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+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 { Driver } from './driver';
+export declare class ObjectQL implements IObjectQL {
+    private objects;
+    private datasources;
+    constructor(config: ObjectQLConfig);
+    loadFromDirectory(dir: string): void;
+    createContext(options: ObjectQLContextOptions): ObjectQLContext;
+    registerObject(object: ObjectConfig): void;
+    getObject(name: string): ObjectConfig | undefined;
+    getConfigs(): Record<string, ObjectConfig>;
+    datasource(name: string): Driver;
+}

package/dist/index.js

@@ -0,0 +1,115 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectQL = void 0;
+__exportStar(require("./metadata"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./driver"), exports);
+__exportStar(require("./repository"), exports);
+__exportStar(require("./query"), exports);
+const repository_1 = require("./repository");
+const loader_1 = require("./loader");
+class ObjectQL {
+    constructor(config) {
+        this.objects = {};
+        this.datasources = {};
+        this.datasources = config.datasources;
+        if (config.objects) {
+            for (const obj of Object.values(config.objects)) {
+                this.registerObject(obj);
+            }
+        }
+    }
+    loadFromDirectory(dir) {
+        const objects = (0, loader_1.loadObjectConfigs)(dir);
+        for (const obj of Object.values(objects)) {
+            this.registerObject(obj);
+        }
+    }
+    createContext(options) {
+        const ctx = {
+            userId: options.userId,
+            spaceId: options.spaceId,
+            roles: options.roles || [],
+            isSystem: options.isSystem,
+            ignoreTriggers: options.ignoreTriggers,
+            object: (name) => {
+                return new repository_1.ObjectRepository(name, ctx, this);
+            },
+            transaction: async (callback) => {
+                const driver = this.datasources['default'];
+                if (!driver || !driver.beginTransaction) {
+                    return callback(ctx);
+                }
+                let trx;
+                try {
+                    trx = await driver.beginTransaction();
+                }
+                catch (e) {
+                    // If beginTransaction fails, fail.
+                    throw e;
+                }
+                const trxCtx = {
+                    ...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) {
+        // 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) {
+        return this.objects[name];
+    }
+    getConfigs() {
+        return this.objects;
+    }
+    datasource(name) {
+        const driver = this.datasources[name];
+        if (!driver) {
+            throw new Error(`Datasource '${name}' not found`);
+        }
+        return driver;
+    }
+}
+exports.ObjectQL = ObjectQL;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,2 @@
+import { ObjectConfig } from './types';
+export declare function loadObjectConfigs(dir: string): Record<string, ObjectConfig>;

package/dist/loader.js

@@ -0,0 +1,143 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadObjectConfigs = loadObjectConfigs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const glob = __importStar(require("fast-glob"));
+function loadObjectConfigs(dir) {
+    const configs = {};
+    // 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);
+            if (doc.name && doc.fields) {
+                configs[doc.name] = doc;
+            }
+            else {
+                for (const [key, value] of Object.entries(doc)) {
+                    if (typeof value === 'object' && value.fields) {
+                        configs[key] = value;
+                        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] = 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;
+                    }
+                }
+            }
+        }
+        catch (e) {
+            console.error(`Error loading hook from ${file}:`, e);
+        }
+    }
+    return configs;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/metadata.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Represents the supported field data types in the ObjectQL schema.
+ * These types determine how data is stored, validated, and rendered.
+ *
+ * - `text`: Simple string.
+ * - `textarea`: Long string.
+ * - `select`: Choice from a list.
+ * - `lookup`: Relationship to another object.
+ */
+export type FieldType = 'text' | 'textarea' | 'html' | 'select' | 'multiselect' | 'date' | 'datetime' | 'number' | 'currency' | 'boolean' | 'lookup' | 'master_detail' | 'password' | 'object' | 'grid';
+/**
+ * Defines a single option for select/multiselect fields.
+ */
+export interface FieldOption {
+    /** The display label for the option. */
+    label: string;
+    /** The actual value stored in the database. */
+    value: string | number;
+}
+/**
+ * Configuration for a single field on an object.
+ * This defines the schema, validation rules, and UI hints for the attribute.
+ */
+export interface FieldConfig {
+    /**
+     * The unique API name of the field.
+     * If defined within an object map, this is often automatically populated from the key.
+     */
+    name?: string;
+    /** The human-readable label used in UIs. */
+    label?: string;
+    /** The data type of the field. */
+    type: FieldType;
+    /** Whether the field is mandatory. Defaults to false. */
+    required?: boolean;
+    /** The default value if not provided during creation. */
+    defaultValue?: any;
+    /**
+     * Options available for `select` or `multiselect` types.
+     * Can be an array of strings or {@link FieldOption} objects.
+     */
+    options?: FieldOption[] | string[];
+    /** Number of decimal places for `currency` types (e.g., 2). */
+    scale?: number;
+    /** Total number of digits for `number` types. */
+    precision?: number;
+    /**
+     * The API name of the target object.
+     * Required when type is `lookup` or `master_detail`.
+     */
+    reference_to?: string;
+    /** Implementation hint: Whether this field should be indexed for search. */
+    searchable?: boolean;
+    /** Implementation hint: Whether this field is sortable in lists. */
+    sortable?: boolean;
+    /** Implementation hint: Whether to create a database index for this column. */
+    index?: boolean;
+    /** Description for documentation purposes. */
+    description?: string;
+}
+/**
+ * Configuration for a custom action (RPC).
+ */
+export interface ActionConfig {
+    label?: string;
+    description?: string;
+    /** Output/Result type definition. */
+    result?: {
+        type: FieldType;
+    };
+    /** Input parameters schema. */
+    params?: Record<string, FieldConfig>;
+    /** Implementation of the action. */
+    handler?: (ctx: any, params: any) => Promise<any>;
+}
+import { HookFunction } from './types';
+export interface ObjectListeners {
+    beforeCreate?: HookFunction;
+    afterCreate?: HookFunction;
+    beforeUpdate?: HookFunction;
+    afterUpdate?: HookFunction;
+    beforeDelete?: HookFunction;
+    afterDelete?: HookFunction;
+    beforeFind?: HookFunction;
+    afterFind?: HookFunction;
+}
+/**
+ * Configuration for a business object (Entity).
+ * Analogous to a Database Table or MongoDB Collection.
+ */
+export interface ObjectConfig {
+    name: string;
+    datasource?: string;
+    label?: string;
+    icon?: string;
+    description?: string;
+    fields: Record<string, FieldConfig>;
+    /** Custom Actions (RPC) defined on this object. */
+    actions?: Record<string, ActionConfig>;
+    /** Lifecycle hooks. */
+    listeners?: ObjectListeners;
+}

package/dist/metadata.js

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

package/dist/metadata.js.map

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

package/dist/query.d.ts

@@ -0,0 +1,10 @@
+export type FilterCriterion = [string, string, any];
+export type FilterExpression = FilterCriterion | 'and' | 'or' | FilterExpression[];
+export interface UnifiedQuery {
+    fields?: string[];
+    filters?: FilterExpression[];
+    sort?: [string, 'asc' | 'desc'][];
+    skip?: number;
+    limit?: number;
+    expand?: Record<string, UnifiedQuery>;
+}

package/dist/query.js

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

package/dist/query.js.map

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

package/dist/repository.d.ts

@@ -0,0 +1,26 @@
+import { ObjectQLContext, IObjectQL } from './types';
+import { ObjectConfig } from './metadata';
+import { UnifiedQuery } from './query';
+export declare class ObjectRepository {
+    private objectName;
+    private context;
+    private app;
+    constructor(objectName: string, context: ObjectQLContext, app: IObjectQL);
+    private getDriver;
+    private getOptions;
+    getSchema(): ObjectConfig;
+    private executeHook;
+    find(query?: UnifiedQuery): Promise<any[]>;
+    findOne(idOrQuery: string | number | UnifiedQuery): Promise<any>;
+    count(filters: any): Promise<number>;
+    create(doc: any): Promise<any>;
+    update(id: string | number, doc: any, options?: any): Promise<any>;
+    delete(id: string | number): Promise<any>;
+    aggregate(query: any): Promise<any>;
+    distinct(field: string, filters?: any): Promise<any[]>;
+    findOneAndUpdate(filters: any, update: any, options?: any): Promise<any>;
+    createMany(data: any[]): Promise<any>;
+    updateMany(filters: any, data: any): Promise<any>;
+    deleteMany(filters: any): Promise<any>;
+    call(actionName: string, params: any): Promise<any>;
+}