@rangka/core 0.0.1

package/dist/plugins/lifecycle.js

@@ -0,0 +1,23 @@
+export class PluginLifecycleManager {
+    handlers;
+    constructor(handlers) {
+        this.handlers = handlers ?? new Map();
+    }
+    register(event, handler) {
+        const list = this.handlers.get(event) ?? [];
+        list.push(handler);
+        this.handlers.set(event, list);
+    }
+    async emit(event, ...args) {
+        const list = this.handlers.get(event);
+        if (!list)
+            return;
+        for (const handler of list) {
+            await handler(...args);
+        }
+    }
+    getHandlers(event) {
+        return this.handlers.get(event) ?? [];
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/plugins/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/plugins/lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,sBAAsB;IACzB,QAAQ,CAAgD;IAEhE,YAAY,QAAwD;QAClE,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,GAAG,EAAE,CAAC;IACxC,CAAC;IAED,QAAQ,CAAC,KAA2B,EAAE,OAAyB;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAA2B,EAAE,GAAG,IAAe;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;YAC3B,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,WAAW,CAAC,KAA2B;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,27 @@
+import type { PluginDefinition } from './types.js';
+import { AdapterRegistry } from './adapter-registry.js';
+import { PluginLifecycleManager } from './lifecycle.js';
+export declare class DuplicatePluginError extends Error {
+    readonly pluginName: string;
+    constructor(pluginName: string);
+}
+export declare class PluginConfigError extends Error {
+    readonly pluginName: string;
+    readonly field: string;
+    constructor(pluginName: string, field: string);
+}
+export declare class MissingAdapterImplementationError extends Error {
+    readonly pluginName: string;
+    readonly adapterName: string;
+    constructor(pluginName: string, adapterName: string);
+}
+export interface LoadPluginsOptions {
+    plugins: PluginDefinition[];
+    config?: Record<string, Record<string, unknown>>;
+}
+export interface LoadPluginsResult {
+    adapterRegistry: AdapterRegistry;
+    lifecycleManager: PluginLifecycleManager;
+}
+export declare function loadPlugins(options: LoadPluginsOptions): Promise<LoadPluginsResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAI/C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,UAAU,EAAE,MAAM;aAClB,KAAK,EAAE,MAAM;gBADb,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM;CAKhC;AAED,qBAAa,iCAAkC,SAAQ,KAAK;aAExC,UAAU,EAAE,MAAM;aAClB,WAAW,EAAE,MAAM;gBADnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM;CAOtC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,sBAAsB,CAAC;CAC1C;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiDzF"}

package/dist/plugins/loader.js

@@ -0,0 +1,96 @@
+import { AdapterRegistry } from './adapter-registry.js';
+import { PluginLifecycleManager } from './lifecycle.js';
+export class DuplicatePluginError extends Error {
+    pluginName;
+    constructor(pluginName) {
+        super(`Plugin "${pluginName}" is already registered`);
+        this.pluginName = pluginName;
+        this.name = 'DuplicatePluginError';
+    }
+}
+export class PluginConfigError extends Error {
+    pluginName;
+    field;
+    constructor(pluginName, field) {
+        super(`Plugin "${pluginName}" requires config field "${field}"`);
+        this.pluginName = pluginName;
+        this.field = field;
+        this.name = 'PluginConfigError';
+    }
+}
+export class MissingAdapterImplementationError extends Error {
+    pluginName;
+    adapterName;
+    constructor(pluginName, adapterName) {
+        super(`Plugin "${pluginName}" declares adapter "${adapterName}" in provides but did not implement it during boot`);
+        this.pluginName = pluginName;
+        this.adapterName = adapterName;
+        this.name = 'MissingAdapterImplementationError';
+    }
+}
+export async function loadPlugins(options) {
+    const { plugins, config = {} } = options;
+    const adapterRegistry = new AdapterRegistry();
+    const lifecycleManager = new PluginLifecycleManager();
+    const seen = new Set();
+    for (const plugin of plugins) {
+        if (seen.has(plugin.name)) {
+            throw new DuplicatePluginError(plugin.name);
+        }
+        seen.add(plugin.name);
+    }
+    for (const plugin of plugins) {
+        const pluginConfig = resolveConfig(plugin, config[plugin.name] ?? {});
+        const implemented = new Set();
+        const adapterProxies = {};
+        if (plugin.provides?.adapters) {
+            for (const decl of plugin.provides.adapters) {
+                adapterProxies[decl.name] = {
+                    implement(impl) {
+                        adapterRegistry.register(decl.name, impl);
+                        implemented.add(decl.name);
+                    },
+                };
+            }
+        }
+        const ctx = {
+            config: pluginConfig,
+            adapters: adapterProxies,
+            on(event, handler) {
+                lifecycleManager.register(event, handler);
+            },
+        };
+        await plugin.boot(ctx);
+        if (plugin.provides?.adapters) {
+            for (const decl of plugin.provides.adapters) {
+                if (!implemented.has(decl.name)) {
+                    throw new MissingAdapterImplementationError(plugin.name, decl.name);
+                }
+            }
+        }
+    }
+    return { adapterRegistry, lifecycleManager };
+}
+function resolveConfig(plugin, userConfig) {
+    const result = {};
+    if (!plugin.config)
+        return userConfig;
+    for (const [key, schema] of Object.entries(plugin.config)) {
+        if (userConfig[key] !== undefined) {
+            result[key] = userConfig[key];
+        }
+        else if (schema.default !== undefined) {
+            result[key] = schema.default;
+        }
+        else if (schema.required) {
+            throw new PluginConfigError(plugin.name, key);
+        }
+    }
+    for (const [key, value] of Object.entries(userConfig)) {
+        if (!(key in result)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,57 @@
+export type AdapterCapability = 'read' | 'list' | 'filter' | 'sort' | 'create' | 'update' | 'delete';
+export interface FilterExpression {
+    field: string;
+    operator: string;
+    value: unknown;
+}
+export interface ListQuery {
+    page?: number;
+    pageSize?: number;
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    filters?: FilterExpression[];
+}
+export interface ListResult {
+    data: Record<string, unknown>[];
+    total?: number;
+    hasMore?: boolean;
+}
+export interface DataAdapter {
+    get(model: string, id: string): Promise<Record<string, unknown> | null>;
+    list?(model: string, query: ListQuery): Promise<ListResult>;
+    create?(model: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    update?(model: string, id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    delete?(model: string, id: string): Promise<void>;
+    filter?(model: string, filters: FilterExpression[]): Promise<ListResult>;
+    batchGet?(model: string, ids: string[]): Promise<Record<string, unknown>[]>;
+}
+export type PluginLifecycleEvent = 'beforeBoot' | 'afterBoot' | 'beforeRequest' | 'afterRequest' | 'beforeShutdown';
+export interface PluginConfigField {
+    type: string;
+    required?: boolean;
+    default?: unknown;
+}
+export interface PluginProvides {
+    adapters?: Array<{
+        name: string;
+        capabilities: AdapterCapability[];
+    }>;
+}
+export interface PluginBootContext {
+    config: Record<string, unknown>;
+    adapters: Record<string, {
+        implement(impl: DataAdapter): void;
+    }>;
+    on(event: PluginLifecycleEvent, handler: (...args: any[]) => Promise<void>): void;
+}
+export interface PluginDefinition {
+    name: string;
+    version: string;
+    config?: Record<string, PluginConfigField>;
+    provides?: PluginProvides;
+    boot(ctx: PluginBootContext): void | Promise<void>;
+}
+export type LifecycleHandler = (...args: any[]) => Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

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

package/dist/plugins/types.js

@@ -0,0 +1,3 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

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

package/dist/plugins/validator.d.ts

@@ -0,0 +1,16 @@
+import type { AdapterRegistry } from './adapter-registry.js';
+import type { AdapterCapability, PluginDefinition } from './types.js';
+import type { ResolvedModel } from '../schema/types.js';
+export interface PluginValidationError {
+    type: 'MISSING_ADAPTER_IMPL' | 'UNRESOLVED_SOURCE' | 'CONFIG_REQUIRED' | 'DUPLICATE_PLUGIN' | 'CAPABILITY_VIOLATION';
+    plugin?: string;
+    model?: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: PluginValidationError[];
+    warnings: string[];
+}
+export declare function validatePluginSetup(adapterRegistry: AdapterRegistry, externalModels: ResolvedModel[], pluginDefinitions: PluginDefinition[], adapterCapabilities?: Record<string, AdapterCapability[]>): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/plugins/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/plugins/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EACA,sBAAsB,GACtB,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,sBAAsB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,aAAa,EAAE,EAC/B,iBAAiB,EAAE,gBAAgB,EAAE,EACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,GACxD,gBAAgB,CAelB"}

package/dist/plugins/validator.js

@@ -0,0 +1,92 @@
+export function validatePluginSetup(adapterRegistry, externalModels, pluginDefinitions, adapterCapabilities) {
+    const errors = [];
+    const warnings = [];
+    checkDuplicatePlugins(pluginDefinitions, errors);
+    checkAdapterImplementations(pluginDefinitions, adapterRegistry, errors);
+    checkExternalModelSources(externalModels, adapterRegistry, errors);
+    checkCapabilityViolations(externalModels, adapterCapabilities ?? {}, errors);
+    checkBatchGetSupport(externalModels, adapterRegistry, warnings);
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+function checkDuplicatePlugins(plugins, errors) {
+    const seen = new Set();
+    for (const plugin of plugins) {
+        if (seen.has(plugin.name)) {
+            errors.push({
+                type: 'DUPLICATE_PLUGIN',
+                plugin: plugin.name,
+                message: `Duplicate plugin name: "${plugin.name}"`,
+            });
+        }
+        seen.add(plugin.name);
+    }
+}
+function checkAdapterImplementations(plugins, adapterRegistry, errors) {
+    for (const plugin of plugins) {
+        if (!plugin.provides?.adapters)
+            continue;
+        for (const decl of plugin.provides.adapters) {
+            if (!adapterRegistry.has(decl.name)) {
+                errors.push({
+                    type: 'MISSING_ADAPTER_IMPL',
+                    plugin: plugin.name,
+                    message: `Plugin "${plugin.name}" declares adapter "${decl.name}" but it is not registered`,
+                });
+            }
+        }
+    }
+}
+function checkExternalModelSources(models, adapterRegistry, errors) {
+    for (const model of models) {
+        if (!model.source)
+            continue;
+        if (!adapterRegistry.has(model.source)) {
+            errors.push({
+                type: 'UNRESOLVED_SOURCE',
+                model: model.qualifiedName,
+                message: `External model "${model.qualifiedName}" references adapter "${model.source}" which is not registered`,
+            });
+        }
+    }
+}
+function checkBatchGetSupport(models, adapterRegistry, warnings) {
+    for (const model of models) {
+        if (!model.source)
+            continue;
+        if (!adapterRegistry.has(model.source))
+            continue;
+        const adapter = adapterRegistry.get(model.source);
+        if (!adapter.batchGet) {
+            warnings.push(`Adapter "${model.source}" used by "${model.qualifiedName}" does not implement batchGet. Relationship resolution will use N+1 get calls.`);
+        }
+    }
+}
+function checkCapabilityViolations(models, adapterCapabilities, errors) {
+    for (const model of models) {
+        if (!model.source)
+            continue;
+        const declared = adapterCapabilities[model.source];
+        if (!declared)
+            continue;
+        const capabilities = new Set(declared);
+        if (!capabilities.has('read')) {
+            errors.push({
+                type: 'CAPABILITY_VIOLATION',
+                model: model.qualifiedName,
+                message: `External model "${model.qualifiedName}" uses adapter "${model.source}" which does not declare the required "read" capability`,
+            });
+        }
+        if (!capabilities.has('list')) {
+            errors.push({
+                type: 'CAPABILITY_VIOLATION',
+                model: model.qualifiedName,
+                message: `External model "${model.qualifiedName}" uses adapter "${model.source}" which does not declare "list" capability. List endpoints will not be generated.`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/plugins/validator.js.map

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

package/dist/schema/__tests__/registry-models-by-module.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry-models-by-module.test.d.ts.map

package/dist/schema/__tests__/registry-models-by-module.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-models-by-module.test.d.ts","sourceRoot":"","sources":["../../../src/schema/__tests__/registry-models-by-module.test.ts"],"names":[],"mappings":""}

package/dist/schema/__tests__/registry-models-by-module.test.js

@@ -0,0 +1,52 @@
+import { describe, it, expect } from 'vitest';
+import { SchemaRegistry } from '../registry.js';
+function makeModel(module, name) {
+    return {
+        qualifiedName: `${module}.${name}`,
+        app: 'test',
+        module,
+        name,
+        auditLog: false,
+        traits: [],
+        fields: [{ name: 'id', config: { type: 'string' }, provenance: { source: 'base' } }],
+        indexes: [],
+    };
+}
+describe('SchemaRegistry.getModelsByModule', () => {
+    it('returns empty map for empty registry', () => {
+        const registry = new SchemaRegistry([]);
+        const result = registry.getModelsByModule();
+        expect(result.size).toBe(0);
+    });
+    it('groups models by module', () => {
+        const models = [
+            makeModel('sales', 'invoice'),
+            makeModel('sales', 'customer'),
+            makeModel('accounting', 'journal_entry'),
+        ];
+        const registry = new SchemaRegistry(models);
+        const result = registry.getModelsByModule();
+        expect(result.size).toBe(2);
+        expect(result.get('sales')).toHaveLength(2);
+        expect(result.get('accounting')).toHaveLength(1);
+    });
+    it('preserves model data', () => {
+        const models = [makeModel('sales', 'invoice')];
+        const registry = new SchemaRegistry(models);
+        const result = registry.getModelsByModule();
+        const salesModels = result.get('sales');
+        expect(salesModels[0].qualifiedName).toBe('sales.invoice');
+        expect(salesModels[0].name).toBe('invoice');
+    });
+    it('handles single module with multiple models', () => {
+        const models = [
+            makeModel('hr', 'employee'),
+            makeModel('hr', 'department'),
+            makeModel('hr', 'leave_request'),
+        ];
+        const registry = new SchemaRegistry(models);
+        const result = registry.getModelsByModule();
+        expect(result.get('hr')).toHaveLength(3);
+    });
+});
+//# sourceMappingURL=registry-models-by-module.test.js.map

package/dist/schema/__tests__/registry-models-by-module.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-models-by-module.test.js","sourceRoot":"","sources":["../../../src/schema/__tests__/registry-models-by-module.test.ts"],"names":[],"mappings":"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"}

package/dist/schema/registry.d.ts

@@ -0,0 +1,30 @@
+import type { ResolvedModel, ResolvedField, ModelRelationship, ExtensionSource } from './types.js';
+/**
+ * Central registry providing lookup access to all resolved models,
+ * their relationships, and extension metadata.
+ */
+export declare class SchemaRegistry {
+    private readonly modelMap;
+    private readonly relationships;
+    private readonly extensionSourceMap;
+    constructor(models: ResolvedModel[]);
+    /** Retrieve a single model by its fully qualified name (e.g. "sales.Invoice"). */
+    getModel(qualifiedName: string): ResolvedModel | undefined;
+    /** Return all registered models. */
+    getAllModels(): ResolvedModel[];
+    /** Return the field definitions for a given model. */
+    getFieldsForModel(qualifiedName: string): ResolvedField[];
+    /** Return all computed relationships across the schema. */
+    getRelationships(): ModelRelationship[];
+    /** Return relationships originating from a specific model. */
+    getRelationshipsForModel(qualifiedName: string): ModelRelationship[];
+    /** Return extension source metadata for a model (which apps contributed fields). */
+    getExtensionSources(qualifiedName: string): ExtensionSource[];
+    /** Group all models by their module name. */
+    getModelsByModule(): Map<string, ResolvedModel[]>;
+    /**
+     * Builds a map from model name to the list of apps that extended it with extra fields.
+     */
+    private buildExtensionSourceMap;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/schema/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/schema/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnG;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiC;gBAExD,MAAM,EAAE,aAAa,EAAE;IASnC,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1D,oCAAoC;IACpC,YAAY,IAAI,aAAa,EAAE;IAI/B,sDAAsD;IACtD,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE;IAMzD,2DAA2D;IAC3D,gBAAgB,IAAI,iBAAiB,EAAE;IAIvC,8DAA8D;IAC9D,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAIpE,oFAAoF;IACpF,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,EAAE;IAI7D,6CAA6C;IAC7C,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAUjD;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAyBhC"}

package/dist/schema/registry.js

@@ -0,0 +1,81 @@
+import { buildRelationships } from './relationships.js';
+/**
+ * Central registry providing lookup access to all resolved models,
+ * their relationships, and extension metadata.
+ */
+export class SchemaRegistry {
+    modelMap;
+    relationships;
+    extensionSourceMap;
+    constructor(models) {
+        this.modelMap = new Map();
+        for (const model of models) {
+            this.modelMap.set(model.qualifiedName, model);
+        }
+        this.relationships = buildRelationships(models);
+        this.extensionSourceMap = this.buildExtensionSourceMap(models);
+    }
+    /** Retrieve a single model by its fully qualified name (e.g. "sales.Invoice"). */
+    getModel(qualifiedName) {
+        return this.modelMap.get(qualifiedName);
+    }
+    /** Return all registered models. */
+    getAllModels() {
+        return Array.from(this.modelMap.values());
+    }
+    /** Return the field definitions for a given model. */
+    getFieldsForModel(qualifiedName) {
+        const model = this.modelMap.get(qualifiedName);
+        if (!model)
+            return [];
+        return model.fields;
+    }
+    /** Return all computed relationships across the schema. */
+    getRelationships() {
+        return this.relationships;
+    }
+    /** Return relationships originating from a specific model. */
+    getRelationshipsForModel(qualifiedName) {
+        return this.relationships.filter((r) => r.from === qualifiedName);
+    }
+    /** Return extension source metadata for a model (which apps contributed fields). */
+    getExtensionSources(qualifiedName) {
+        return this.extensionSourceMap.get(qualifiedName) ?? [];
+    }
+    /** Group all models by their module name. */
+    getModelsByModule() {
+        const moduleToModels = new Map();
+        for (const model of this.modelMap.values()) {
+            const group = moduleToModels.get(model.module) ?? [];
+            group.push(model);
+            moduleToModels.set(model.module, group);
+        }
+        return moduleToModels;
+    }
+    /**
+     * Builds a map from model name to the list of apps that extended it with extra fields.
+     */
+    buildExtensionSourceMap(models) {
+        const map = new Map();
+        for (const model of models) {
+            const extensionFields = model.fields.filter((f) => f.provenance.source === 'extension');
+            if (extensionFields.length === 0)
+                continue;
+            // Group extension fields by the app that contributed them
+            const fieldsByApp = new Map();
+            for (const field of extensionFields) {
+                const contributingApp = field.provenance.app;
+                const fieldNames = fieldsByApp.get(contributingApp) ?? [];
+                fieldNames.push(field.name);
+                fieldsByApp.set(contributingApp, fieldNames);
+            }
+            const sources = [];
+            for (const [app, fields] of fieldsByApp) {
+                sources.push({ app, fields });
+            }
+            map.set(model.qualifiedName, sources);
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/schema/registry.js.map

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

package/dist/schema/relationships.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedModel, ModelRelationship } from './types.js';
+/**
+ * Scans all models for relational fields and produces a flat list of relationships.
+ */
+export declare function buildRelationships(models: ResolvedModel[]): ModelRelationship[];
+//# sourceMappingURL=relationships.d.ts.map

package/dist/schema/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/schema/relationships.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,iBAAiB,EAAE,CAa/E"}

package/dist/schema/relationships.js

@@ -0,0 +1,81 @@
+/**
+ * Scans all models for relational fields and produces a flat list of relationships.
+ */
+export function buildRelationships(models) {
+    const relationships = [];
+    for (const model of models) {
+        for (const field of model.fields) {
+            const relationship = fieldToRelationship(field.config, field.name, model, models);
+            if (relationship) {
+                relationships.push(relationship);
+            }
+        }
+    }
+    return relationships;
+}
+/**
+ * Converts a single field config into a ModelRelationship, or returns null
+ * if the field is not a relational type.
+ */
+function fieldToRelationship(config, fieldName, sourceModel, allModels) {
+    const from = sourceModel.qualifiedName;
+    switch (config.type) {
+        case 'link': {
+            const targetModel = resolveModelName(config.model, sourceModel.module, allModels);
+            return { type: 'link', from, field: fieldName, to: targetModel };
+        }
+        case 'hasMany': {
+            const targetModel = resolveModelName(config.model, sourceModel.module, allModels);
+            return {
+                type: 'hasMany',
+                from,
+                field: fieldName,
+                to: targetModel,
+                foreignKey: config.foreignKey,
+            };
+        }
+        case 'children': {
+            const targetModel = resolveModelName(config.model, sourceModel.module, allModels);
+            return {
+                type: 'children',
+                from,
+                field: fieldName,
+                to: targetModel,
+                foreignKey: config.foreignKey,
+            };
+        }
+        case 'manyToMany': {
+            const targetModel = resolveModelName(config.model, sourceModel.module, allModels);
+            const throughModel = resolveModelName(config.through, sourceModel.module, allModels);
+            return { type: 'manyToMany', from, field: fieldName, to: targetModel, through: throughModel };
+        }
+        case 'dynamicLink': {
+            return {
+                type: 'dynamicLink',
+                from,
+                field: fieldName,
+                to: '*',
+                modelField: config.modelField,
+            };
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Resolves an unqualified model name (e.g. "Invoice") to its fully qualified form
+ * (e.g. "accounting.Invoice") by checking the current app first, then all models.
+ */
+function resolveModelName(name, currentModule, models) {
+    if (name.includes('.'))
+        return name;
+    const qualifiedInCurrentModule = `${currentModule}.${name}`;
+    const foundInCurrentModule = models.find((m) => m.qualifiedName === qualifiedInCurrentModule);
+    if (foundInCurrentModule)
+        return qualifiedInCurrentModule;
+    const foundElsewhere = models.find((m) => m.name === name);
+    if (foundElsewhere)
+        return foundElsewhere.qualifiedName;
+    return qualifiedInCurrentModule;
+}
+//# sourceMappingURL=relationships.js.map