@objectql/core 3.0.1 → 4.0.0

package/dist/action.d.ts

@@ -1,7 +0,0 @@
-import { ActionContext, ActionHandler, MetadataRegistry } from '@objectql/types';
-export interface ActionEntry {
-    handler: ActionHandler;
-    packageName?: string;
-}
-export declare function registerActionHelper(actions: Record<string, ActionEntry>, objectName: string, actionName: string, handler: ActionHandler, packageName?: string): void;
-export declare function executeActionHelper(metadata: MetadataRegistry, runtimeActions: Record<string, ActionEntry>, objectName: string, actionName: string, ctx: ActionContext): Promise<any>;

package/dist/action.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerActionHelper = registerActionHelper;
-exports.executeActionHelper = executeActionHelper;
-function registerActionHelper(actions, objectName, actionName, handler, packageName) {
-    const key = `${objectName}:${actionName}`;
-    actions[key] = { handler, packageName };
-}
-async function executeActionHelper(metadata, runtimeActions, objectName, actionName, ctx) {
-    // 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('action', objectName);
-    if (fileActions && typeof fileActions[actionName] === 'function') {
-        return await fileActions[actionName](ctx);
-    }
-    throw new Error(`Action '${actionName}' not found for object '${objectName}'`);
-}
-//# sourceMappingURL=action.js.map

package/dist/action.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":";;AAOA,oDASC;AAED,kDAqBC;AAhCD,SAAgB,oBAAoB,CAChC,OAAoC,EACpC,UAAkB,EAClB,UAAkB,EAClB,OAAsB,EACtB,WAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC5C,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACrC,QAA0B,EAC1B,cAA2C,EAC3C,UAAkB,EAClB,UAAkB,EAClB,GAAkB;IAElB,kBAAkB;IAClB,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,WAAW,EAAE,CAAC;QACd,OAAO,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,2BAA2B;IAC3B,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAM,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC5D,IAAI,WAAW,IAAI,OAAO,WAAW,CAAC,UAAU,CAAC,KAAK,UAAU,EAAE,CAAC;QAC/D,OAAO,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,2BAA2B,UAAU,GAAG,CAAC,CAAC;AACnF,CAAC"}

package/dist/hook.d.ts

@@ -1,8 +0,0 @@
-import { HookContext, HookHandler, HookName, MetadataRegistry } from '@objectql/types';
-export interface HookEntry {
-    objectName: string;
-    handler: HookHandler;
-    packageName?: string;
-}
-export declare function registerHookHelper(hooks: Record<string, HookEntry[]>, event: HookName, objectName: string, handler: HookHandler, packageName?: string): void;
-export declare function triggerHookHelper(metadata: MetadataRegistry, runtimeHooks: Record<string, HookEntry[]>, event: HookName, objectName: string, ctx: HookContext): Promise<void>;

package/dist/hook.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerHookHelper = registerHookHelper;
-exports.triggerHookHelper = triggerHookHelper;
-function registerHookHelper(hooks, event, objectName, handler, packageName) {
-    if (!hooks[event]) {
-        hooks[event] = [];
-    }
-    hooks[event].push({ objectName, handler, packageName });
-}
-async function triggerHookHelper(metadata, runtimeHooks, event, objectName, ctx) {
-    // 1. Registry Hooks (File-based)
-    const fileHooks = metadata.get('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);
-        }
-    }
-}
-//# sourceMappingURL=hook.js.map

package/dist/hook.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":";;AAQA,gDAWC;AAED,8CAoBC;AAjCD,SAAgB,kBAAkB,CAC9B,KAAkC,EAClC,KAAe,EACf,UAAkB,EAClB,OAAoB,EACpB,WAAoB;IAEpB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC;AAEM,KAAK,UAAU,iBAAiB,CACnC,QAA0B,EAC1B,YAAyC,EACzC,KAAe,EACf,UAAkB,EAClB,GAAgB;IAEhB,iCAAiC;IACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAM,MAAM,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,UAAU,EAAE,CAAC;QACtD,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,wBAAwB;IACxB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/object.d.ts

@@ -1,3 +0,0 @@
-import { ObjectConfig, MetadataRegistry } from '@objectql/types';
-export declare function registerObjectHelper(metadata: MetadataRegistry, object: ObjectConfig): void;
-export declare function getConfigsHelper(metadata: MetadataRegistry): Record<string, ObjectConfig>;

package/dist/object.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerObjectHelper = registerObjectHelper;
-exports.getConfigsHelper = getConfigsHelper;
-function registerObjectHelper(metadata, object) {
-    // Normalize fields
-    if (object.fields) {
-        for (const [key, field] of Object.entries(object.fields)) {
-            if (!field.name) {
-                field.name = key;
-            }
-        }
-    }
-    metadata.register('object', {
-        type: 'object',
-        id: object.name,
-        content: object
-    });
-}
-function getConfigsHelper(metadata) {
-    const result = {};
-    const objects = metadata.list('object');
-    for (const obj of objects) {
-        result[obj.name] = obj;
-    }
-    return result;
-}
-//# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":";;AAEA,oDAcC;AAED,4CAOC;AAvBD,SAAgB,oBAAoB,CAAC,QAA0B,EAAE,MAAoB;IACjF,mBAAmB;IACnB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACd,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;YACrB,CAAC;QACL,CAAC;IACL,CAAC;IACD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACxB,IAAI,EAAE,QAAQ;QACd,EAAE,EAAE,MAAM,CAAC,IAAI;QACf,OAAO,EAAE,MAAM;KAClB,CAAC,CAAC;AACP,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAA0B;IACvD,MAAM,MAAM,GAAiC,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAe,QAAQ,CAAC,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/src/action.ts

@@ -1,40 +0,0 @@
-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/hook.ts

@@ -1,42 +0,0 @@
-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);
-        }
-    }
-}

package/src/object.ts

@@ -1,26 +0,0 @@
-import { ObjectConfig, MetadataRegistry } from '@objectql/types';
-
-export function registerObjectHelper(metadata: MetadataRegistry, object: ObjectConfig) {
-    // Normalize fields
-    if (object.fields) {
-        for (const [key, field] of Object.entries(object.fields)) {
-            if (!field.name) {
-                field.name = key;
-            }
-        }
-    }
-    metadata.register('object', {
-        type: 'object',
-        id: object.name,
-        content: object
-    });
-}
-
-export function getConfigsHelper(metadata: MetadataRegistry): Record<string, ObjectConfig> {
-    const result: Record<string, ObjectConfig> = {};
-    const objects = metadata.list<ObjectConfig>('object');
-    for (const obj of objects) {
-        result[obj.name] = obj;
-    }
-    return result;
-}

package/test/action.test.ts

@@ -1,276 +0,0 @@
-import { ObjectQL } from '../src';
-import { MockDriver } from './mock-driver';
-
-describe('ObjectQL Actions', () => {
-    let app: ObjectQL;
-    let driver: MockDriver;
-
-    beforeEach(async () => {
-        driver = new MockDriver();
-        app = new ObjectQL({
-            datasources: {
-                default: driver
-            },
-            objects: {
-                'invoice': {
-                    name: 'invoice',
-                    fields: {
-                        amount: { type: 'number' },
-                        status: { type: 'text' },
-                        paid_amount: { type: 'number' }
-                    },
-                    actions: {
-                        'pay': {
-                            type: 'record',
-                            label: 'Pay Invoice',
-                            params: {
-                                method: { type: 'text' }
-                            }
-                        },
-                        'import_invoices': {
-                            type: 'global',
-                            label: 'Import Invoices',
-                            params: {
-                                source: { type: 'text' }
-                            }
-                        }
-                    }
-                }
-            }
-        });
-        await app.init();
-    });
-
-    describe('Record Actions', () => {
-        it('should execute record action with id parameter', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            // Create an invoice first
-            const invoice = await repo.create({ amount: 1000, status: 'pending' });
-            
-            let actionCalled = false;
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                actionCalled = true;
-                expect(ctx.objectName).toBe('invoice');
-                expect(ctx.actionName).toBe('pay');
-                expect(ctx.id).toBe(invoice._id);
-                expect(ctx.input.method).toBe('credit_card');
-                
-                // Update the invoice status
-                await ctx.api.update('invoice', ctx.id!, { 
-                    status: 'paid',
-                    paid_amount: ctx.input.amount || 1000
-                });
-                
-                return { success: true, paid: true };
-            });
-
-            const result = await repo.execute('pay', invoice._id, { method: 'credit_card', amount: 1000 });
-            
-            expect(actionCalled).toBe(true);
-            expect(result.success).toBe(true);
-            expect(result.paid).toBe(true);
-        });
-
-        it('should provide access to record data via api', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            const invoice = await repo.create({ amount: 500, status: 'pending' });
-            
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                // Fetch current record
-                const current = await ctx.api.findOne('invoice', ctx.id!);
-                expect(current).toBeDefined();
-                expect(current.amount).toBe(500);
-                
-                return { currentAmount: current.amount };
-            });
-
-            const result = await repo.execute('pay', invoice._id, { method: 'cash' });
-            expect(result.currentAmount).toBe(500);
-        });
-
-        it('should validate business rules in record action', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            const invoice = await repo.create({ amount: 1000, status: 'paid' });
-            
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                const current = await ctx.api.findOne('invoice', ctx.id!);
-                if (current.status === 'paid') {
-                    throw new Error('Invoice is already paid');
-                }
-                return { success: true };
-            });
-
-            await expect(repo.execute('pay', invoice._id, { method: 'credit_card' }))
-                .rejects
-                .toThrow('Invoice is already paid');
-        });
-
-        it('should provide user context in action', async () => {
-            const repo = app.createContext({ userId: 'user123', userName: 'John Doe' }).object('invoice');
-            
-            const invoice = await repo.create({ amount: 100, status: 'pending' });
-            
-            let capturedUser: any;
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                capturedUser = ctx.user;
-                return { success: true };
-            });
-
-            await repo.execute('pay', invoice._id, { method: 'cash' });
-            
-            expect(capturedUser).toBeDefined();
-            expect(capturedUser.id).toBe('user123');
-        });
-    });
-
-    describe('Global Actions', () => {
-        it('should execute global action without id parameter', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            let actionCalled = false;
-            app.registerAction('invoice', 'import_invoices', async (ctx) => {
-                actionCalled = true;
-                expect(ctx.objectName).toBe('invoice');
-                expect(ctx.actionName).toBe('import_invoices');
-                expect(ctx.id).toBeUndefined();
-                expect(ctx.input.source).toBe('external_api');
-                
-                // Create multiple records
-                await ctx.api.create('invoice', { amount: 100, status: 'pending' });
-                await ctx.api.create('invoice', { amount: 200, status: 'pending' });
-                
-                return { imported: 2 };
-            });
-
-            const result = await repo.execute('import_invoices', undefined, { source: 'external_api' });
-            
-            expect(actionCalled).toBe(true);
-            expect(result.imported).toBe(2);
-        });
-
-        it('should perform batch operations in global action', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            // Create some test invoices
-            await repo.create({ amount: 100, status: 'pending' });
-            await repo.create({ amount: 200, status: 'pending' });
-            await repo.create({ amount: 300, status: 'paid' });
-            
-            app.registerAction('invoice', 'import_invoices', async (ctx) => {
-                // Count pending invoices
-                const count = await ctx.api.count('invoice', { 
-                    filters: [['status', '=', 'pending']] 
-                });
-                
-                return { pendingCount: count };
-            });
-
-            const result = await repo.execute('import_invoices', undefined, { source: 'test' });
-            expect(result.pendingCount).toBe(2);
-        });
-    });
-
-    describe('Action Input Validation', () => {
-        it('should receive validated input parameters', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            const invoice = await repo.create({ amount: 1000, status: 'pending' });
-            
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                // Input should match the params defined in action config
-                expect(ctx.input).toBeDefined();
-                expect(typeof ctx.input.method).toBe('string');
-                
-                return { method: ctx.input.method };
-            });
-
-            const result = await repo.execute('pay', invoice._id, { method: 'bank_transfer' });
-            expect(result.method).toBe('bank_transfer');
-        });
-
-        it('should handle missing optional parameters', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            const invoice = await repo.create({ amount: 1000, status: 'pending' });
-            
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                // Optional parameters might be undefined
-                const comment = ctx.input.comment || 'No comment';
-                return { comment };
-            });
-
-            const result = await repo.execute('pay', invoice._id, { method: 'cash' });
-            expect(result.comment).toBe('No comment');
-        });
-    });
-
-    describe('Error Handling', () => {
-        it('should throw error if action not registered', async () => {
-            const repo = app.createContext({}).object('invoice');
-            await expect(repo.execute('refund', '1', {}))
-                .rejects
-                .toThrow("Action 'refund' not found for object 'invoice'");
-        });
-
-        it('should propagate errors from action handler', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            const invoice = await repo.create({ amount: 1000, status: 'pending' });
-            
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                throw new Error('Payment gateway is down');
-            });
-
-            await expect(repo.execute('pay', invoice._id, { method: 'credit_card' }))
-                .rejects
-                .toThrow('Payment gateway is down');
-        });
-    });
-
-    describe('Complex Action Workflows', () => {
-        it('should perform multi-step operations in action', async () => {
-            const repo = app.createContext({}).object('invoice');
-            
-            const invoice = await repo.create({ amount: 1000, status: 'pending', paid_amount: 0 });
-            
-            app.registerAction('invoice', 'pay', async (ctx) => {
-                // Step 1: Fetch current state
-                const current = await ctx.api.findOne('invoice', ctx.id!);
-                
-                // Step 2: Validate
-                if (current.status === 'paid') {
-                    throw new Error('Already paid');
-                }
-                
-                // Step 3: Update invoice
-                await ctx.api.update('invoice', ctx.id!, {
-                    status: 'paid',
-                    paid_amount: current.amount
-                });
-                
-                // Step 4: Could create related records (e.g., payment record)
-                // await ctx.api.create('payment', { ... });
-                
-                return { 
-                    success: true, 
-                    amount: current.amount,
-                    newStatus: 'paid'
-                };
-            });
-
-            const result = await repo.execute('pay', invoice._id, { method: 'credit_card' });
-            
-            expect(result.success).toBe(true);
-            expect(result.amount).toBe(1000);
-            expect(result.newStatus).toBe('paid');
-            
-            // Verify the update
-            const updated = await repo.findOne(invoice._id);
-            expect(updated.status).toBe('paid');
-            expect(updated.paid_amount).toBe(1000);
-        });
-    });
-});