@rangka/core 0.0.1

package/dist/external-model/__tests__/mutation-executor.test.js

@@ -0,0 +1,135 @@
+import { describe, it, expect, vi } from 'vitest';
+import { ExternalMutationExecutor, CapabilityNotSupportedError } from '../mutation-executor.js';
+function makeAdapter(overrides) {
+    return {
+        async get(_model, _id) {
+            return null;
+        },
+        ...overrides,
+    };
+}
+const baseFields = {
+    id: { type: 'string' },
+    email: { type: 'string' },
+    name: { type: 'string', from: 'metadata.company_name' },
+};
+describe('ExternalMutationExecutor', () => {
+    describe('create', () => {
+        it('calls adapter.create with reverse-mapped data', async () => {
+            const create = vi.fn().mockResolvedValue({
+                id: 'cus_1',
+                email: 'a@b.com',
+                metadata: { company_name: 'Acme' },
+            });
+            const adapter = makeAdapter({ create });
+            const executor = new ExternalMutationExecutor({
+                adapter,
+                adapterName: 'stripe',
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'create'],
+            });
+            const result = await executor.create({ email: 'a@b.com', name: 'Acme' });
+            expect(create).toHaveBeenCalledWith('billing.Customer', {
+                email: 'a@b.com',
+                metadata: { company_name: 'Acme' },
+            });
+            expect(result).toEqual({ id: 'cus_1', email: 'a@b.com', name: 'Acme' });
+        });
+        it('throws CapabilityNotSupportedError when create not supported', async () => {
+            const adapter = makeAdapter();
+            const executor = new ExternalMutationExecutor({
+                adapter,
+                adapterName: 'stripe',
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read'],
+            });
+            await expect(executor.create({ email: 'test' })).rejects.toThrow(CapabilityNotSupportedError);
+            await expect(executor.create({ email: 'test' })).rejects.toThrow('Adapter "stripe" does not support operation "create"');
+        });
+        it('evaluates computed fields on response', async () => {
+            const fields = {
+                id: { type: 'string' },
+                name: { type: 'string' },
+                upper: {
+                    type: 'string',
+                    computed: { depends: ['name'], compute: (r) => r.name.toUpperCase() },
+                },
+            };
+            const create = vi.fn().mockResolvedValue({ id: '1', name: 'alice' });
+            const adapter = makeAdapter({ create });
+            const executor = new ExternalMutationExecutor({
+                adapter,
+                adapterName: 'test',
+                modelName: 'test.Model',
+                fields,
+                capabilities: ['read', 'create'],
+            });
+            const result = await executor.create({ name: 'alice' });
+            expect(result.upper).toBe('ALICE');
+        });
+    });
+    describe('update', () => {
+        it('calls adapter.update with reverse-mapped data', async () => {
+            const update = vi.fn().mockResolvedValue({
+                id: 'cus_1',
+                email: 'new@b.com',
+                metadata: { company_name: 'NewCo' },
+            });
+            const adapter = makeAdapter({ update });
+            const executor = new ExternalMutationExecutor({
+                adapter,
+                adapterName: 'stripe',
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'update'],
+            });
+            const result = await executor.update('cus_1', { email: 'new@b.com', name: 'NewCo' });
+            expect(update).toHaveBeenCalledWith('billing.Customer', 'cus_1', {
+                email: 'new@b.com',
+                metadata: { company_name: 'NewCo' },
+            });
+            expect(result).toEqual({ id: 'cus_1', email: 'new@b.com', name: 'NewCo' });
+        });
+        it('throws CapabilityNotSupportedError when update not supported', async () => {
+            const adapter = makeAdapter();
+            const executor = new ExternalMutationExecutor({
+                adapter,
+                adapterName: 'stripe',
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read'],
+            });
+            await expect(executor.update('1', { email: 'test' })).rejects.toThrow(CapabilityNotSupportedError);
+        });
+    });
+    describe('delete', () => {
+        it('calls adapter.delete', async () => {
+            const del = vi.fn().mockResolvedValue(undefined);
+            const adapter = makeAdapter({ delete: del });
+            const executor = new ExternalMutationExecutor({
+                adapter,
+                adapterName: 'stripe',
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'delete'],
+            });
+            await executor.delete('cus_1');
+            expect(del).toHaveBeenCalledWith('billing.Customer', 'cus_1');
+        });
+        it('throws CapabilityNotSupportedError when delete not supported', async () => {
+            const adapter = makeAdapter();
+            const executor = new ExternalMutationExecutor({
+                adapter,
+                adapterName: 'stripe',
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read'],
+            });
+            await expect(executor.delete('cus_1')).rejects.toThrow(CapabilityNotSupportedError);
+            await expect(executor.delete('cus_1')).rejects.toThrow('Adapter "stripe" does not support operation "delete"');
+        });
+    });
+});
+//# sourceMappingURL=mutation-executor.test.js.map

package/dist/external-model/__tests__/mutation-executor.test.js.map

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

package/dist/external-model/__tests__/query-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-executor.test.d.ts.map

package/dist/external-model/__tests__/query-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-executor.test.d.ts","sourceRoot":"","sources":["../../../src/external-model/__tests__/query-executor.test.ts"],"names":[],"mappings":""}

package/dist/external-model/__tests__/query-executor.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect, vi } from 'vitest';
+import { ExternalQueryExecutor } from '../query-executor.js';
+function makeAdapter(overrides) {
+    return {
+        async get(_model, _id) {
+            return null;
+        },
+        ...overrides,
+    };
+}
+const baseFields = {
+    id: { type: 'string' },
+    email: { type: 'string' },
+    name: { type: 'string', from: 'metadata.company_name' },
+};
+describe('ExternalQueryExecutor', () => {
+    describe('execGet', () => {
+        it('returns null when adapter returns null', async () => {
+            const adapter = makeAdapter({
+                async get() {
+                    return null;
+                },
+            });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read'],
+            });
+            expect(await executor.execGet('non-existent')).toBeNull();
+        });
+        it('returns mapped record', async () => {
+            const adapter = makeAdapter({
+                async get() {
+                    return { id: 'cus_1', email: 'a@b.com', metadata: { company_name: 'Acme' } };
+                },
+            });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read'],
+            });
+            const result = await executor.execGet('cus_1');
+            expect(result).toEqual({ id: 'cus_1', email: 'a@b.com', name: 'Acme' });
+        });
+        it('evaluates computed fields', async () => {
+            const fields = {
+                id: { type: 'string' },
+                name: { type: 'string' },
+                upper: {
+                    type: 'string',
+                    computed: { depends: ['name'], compute: (r) => r.name.toUpperCase() },
+                },
+            };
+            const adapter = makeAdapter({
+                async get() {
+                    return { id: '1', name: 'alice' };
+                },
+            });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'test.Model',
+                fields,
+                capabilities: ['read'],
+            });
+            const result = await executor.execGet('1');
+            expect(result?.upper).toBe('ALICE');
+        });
+        it('passes model name to adapter', async () => {
+            const get = vi.fn().mockResolvedValue({ id: '1' });
+            const adapter = makeAdapter({ get });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: { id: { type: 'string' } },
+                capabilities: ['read'],
+            });
+            await executor.execGet('cus_1');
+            expect(get).toHaveBeenCalledWith('billing.Customer', 'cus_1');
+        });
+    });
+    describe('execList', () => {
+        it('calls adapter.list when capability is available', async () => {
+            const list = vi.fn().mockResolvedValue({
+                data: [
+                    { id: '1', email: 'a@b.com', metadata: { company_name: 'A' } },
+                    { id: '2', email: 'c@d.com', metadata: { company_name: 'B' } },
+                ],
+                total: 2,
+            });
+            const adapter = makeAdapter({ list });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'list'],
+            });
+            const result = await executor.execList({
+                filters: [],
+                sorts: [],
+                fieldNames: [],
+            });
+            expect(result.data).toHaveLength(2);
+            expect(result.data[0]).toEqual({ id: '1', email: 'a@b.com', name: 'A' });
+            expect(result.total).toBe(2);
+        });
+        it('passes filters to adapter when filter capability exists', async () => {
+            const list = vi.fn().mockResolvedValue({ data: [], total: 0 });
+            const adapter = makeAdapter({ list });
+            const capabilities = ['read', 'list', 'filter'];
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities,
+            });
+            await executor.execList({
+                filters: [{ field: 'email', operator: 'eq', value: 'test@test.com' }],
+                sorts: [],
+                fieldNames: [],
+            });
+            expect(list).toHaveBeenCalledWith('billing.Customer', expect.objectContaining({
+                filters: [{ field: 'email', operator: 'eq', value: 'test@test.com' }],
+            }));
+        });
+        it('applies in-memory filter when adapter lacks filter capability', async () => {
+            const list = vi.fn().mockResolvedValue({
+                data: [
+                    { id: '1', email: 'alice@acme.com', metadata: { company_name: 'Acme' } },
+                    { id: '2', email: 'bob@other.com', metadata: { company_name: 'Other' } },
+                ],
+                total: 2,
+            });
+            const adapter = makeAdapter({ list });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'list'],
+            });
+            const result = await executor.execList({
+                filters: [{ field: 'email', operator: 'contains', value: 'acme' }],
+                sorts: [],
+                fieldNames: [],
+            });
+            expect(result.data).toHaveLength(1);
+            expect(result.data[0].email).toBe('alice@acme.com');
+        });
+        it('applies in-memory sort when adapter lacks sort capability', async () => {
+            const list = vi.fn().mockResolvedValue({
+                data: [
+                    { id: '2', email: 'b@b.com', metadata: { company_name: 'B' } },
+                    { id: '1', email: 'a@a.com', metadata: { company_name: 'A' } },
+                ],
+                total: 2,
+            });
+            const adapter = makeAdapter({ list });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'list'],
+            });
+            const result = await executor.execList({
+                filters: [],
+                sorts: [{ field: 'email', direction: 'asc' }],
+                fieldNames: [],
+            });
+            expect(result.data[0].email).toBe('a@a.com');
+            expect(result.data[1].email).toBe('b@b.com');
+        });
+        it('returns empty data when no list capability', async () => {
+            const adapter = makeAdapter();
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read'],
+            });
+            const result = await executor.execList({
+                filters: [],
+                sorts: [],
+                fieldNames: [],
+            });
+            expect(result.data).toEqual([]);
+            expect(result.total).toBe(0);
+        });
+        it('uses default limit of 25', async () => {
+            const list = vi.fn().mockResolvedValue({ data: [], total: 0 });
+            const adapter = makeAdapter({ list });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'list'],
+            });
+            await executor.execList({ filters: [], sorts: [], fieldNames: [] });
+            expect(list).toHaveBeenCalledWith('billing.Customer', expect.objectContaining({ pageSize: 25 }));
+        });
+        it('respects custom limit', async () => {
+            const list = vi.fn().mockResolvedValue({ data: [], total: 0 });
+            const adapter = makeAdapter({ list });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: baseFields,
+                capabilities: ['read', 'list'],
+            });
+            await executor.execList({ filters: [], sorts: [], fieldNames: [], limitVal: 10 });
+            expect(list).toHaveBeenCalledWith('billing.Customer', expect.objectContaining({ pageSize: 10 }));
+        });
+    });
+    describe('execCount', () => {
+        it('returns total from list result', async () => {
+            const list = vi.fn().mockResolvedValue({ data: [{ id: '1' }, { id: '2' }], total: 50 });
+            const adapter = makeAdapter({ list });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: { id: { type: 'string' } },
+                capabilities: ['read', 'list'],
+            });
+            const count = await executor.execCount({ filters: [], sorts: [], fieldNames: [] });
+            expect(count).toBe(50);
+        });
+        it('falls back to data length when total not provided', async () => {
+            const list = vi.fn().mockResolvedValue({ data: [{ id: '1' }, { id: '2' }] });
+            const adapter = makeAdapter({ list });
+            const executor = new ExternalQueryExecutor({
+                adapter,
+                modelName: 'billing.Customer',
+                fields: { id: { type: 'string' } },
+                capabilities: ['read', 'list'],
+            });
+            const count = await executor.execCount({ filters: [], sorts: [], fieldNames: [] });
+            expect(count).toBe(2);
+        });
+    });
+});
+//# sourceMappingURL=query-executor.test.js.map

package/dist/external-model/__tests__/query-executor.test.js.map

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

package/dist/external-model/__tests__/schema-converter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-converter.test.d.ts.map

package/dist/external-model/__tests__/schema-converter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.test.d.ts","sourceRoot":"","sources":["../../../src/external-model/__tests__/schema-converter.test.ts"],"names":[],"mappings":""}

package/dist/external-model/__tests__/schema-converter.test.js

@@ -0,0 +1,152 @@
+import { describe, it, expect } from 'vitest';
+import { externalModelToResolved } from '../schema-converter.js';
+describe('externalModelToResolved', () => {
+    const baseConfig = {
+        name: 'Customer',
+        source: 'stripe',
+        label: 'Stripe Customer',
+        fields: {
+            id: { type: 'string' },
+            email: { type: 'string' },
+            name: { type: 'string', from: 'metadata.company_name' },
+        },
+    };
+    it('produces correct qualifiedName', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.qualifiedName).toBe('billing.Customer');
+    });
+    it('sets source from config', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.source).toBe('stripe');
+    });
+    it('sets app and module', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.app).toBe('billing-app');
+        expect(model.module).toBe('billing');
+    });
+    it('sets name and label', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.name).toBe('Customer');
+        expect(model.label).toBe('Stripe Customer');
+    });
+    it('has empty traits', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.traits).toEqual([]);
+    });
+    it('has empty indexes', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.indexes).toEqual([]);
+    });
+    it('sets auditLog to false', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.auditLog).toBe(false);
+    });
+    it('converts fields to ResolvedField array', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        expect(model.fields).toHaveLength(3);
+        const idField = model.fields.find((f) => f.name === 'id');
+        expect(idField).toEqual({
+            name: 'id',
+            config: { type: 'string', label: undefined, required: undefined },
+            provenance: { source: 'base' },
+        });
+    });
+    it('preserves field type and label', () => {
+        const config = {
+            name: 'Invoice',
+            source: 'stripe',
+            fields: {
+                amount: { type: 'decimal', label: 'Amount', required: true },
+            },
+        };
+        const { model } = externalModelToResolved(config, 'app', 'billing');
+        const amountField = model.fields.find((f) => f.name === 'amount');
+        expect(amountField?.config).toEqual({ type: 'decimal', label: 'Amount', required: true });
+    });
+    it('sets provenance to base for all fields', () => {
+        const { model } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+        for (const field of model.fields) {
+            expect(field.provenance).toEqual({ source: 'base' });
+        }
+    });
+    it('handles config without label', () => {
+        const config = {
+            name: 'Product',
+            source: 'shopify',
+            fields: { id: { type: 'string' } },
+        };
+        const { model } = externalModelToResolved(config, 'app', 'store');
+        expect(model.label).toBeUndefined();
+    });
+    describe('relationships', () => {
+        it('returns empty relationships when no relationship fields', () => {
+            const { relationships } = externalModelToResolved(baseConfig, 'billing-app', 'billing');
+            expect(relationships).toEqual([]);
+        });
+        it('extracts link relationships from fields', () => {
+            const config = {
+                name: 'Invoice',
+                source: 'stripe',
+                fields: {
+                    id: { type: 'string' },
+                    order: {
+                        type: 'string',
+                        from: 'metadata.order_id',
+                        relationship: { type: 'link', model: 'sales.Order' },
+                    },
+                },
+            };
+            const { relationships } = externalModelToResolved(config, 'app', 'billing');
+            expect(relationships).toHaveLength(1);
+            expect(relationships[0]).toEqual({
+                type: 'link',
+                from: 'billing.Invoice',
+                field: 'order',
+                to: 'sales.Order',
+                foreignKey: undefined,
+            });
+        });
+        it('extracts hasMany relationships with foreignKey', () => {
+            const config = {
+                name: 'Customer',
+                source: 'stripe',
+                fields: {
+                    id: { type: 'string' },
+                    invoices: {
+                        type: 'json',
+                        relationship: { type: 'hasMany', model: 'billing.Invoice', foreignKey: 'customer_id' },
+                    },
+                },
+            };
+            const { relationships } = externalModelToResolved(config, 'app', 'billing');
+            expect(relationships).toHaveLength(1);
+            expect(relationships[0]).toEqual({
+                type: 'hasMany',
+                from: 'billing.Customer',
+                field: 'invoices',
+                to: 'billing.Invoice',
+                foreignKey: 'customer_id',
+            });
+        });
+        it('extracts multiple relationships', () => {
+            const config = {
+                name: 'Order',
+                source: 'stripe',
+                fields: {
+                    id: { type: 'string' },
+                    customer: {
+                        type: 'string',
+                        relationship: { type: 'link', model: 'billing.Customer' },
+                    },
+                    items: {
+                        type: 'json',
+                        relationship: { type: 'hasMany', model: 'billing.LineItem', foreignKey: 'order_id' },
+                    },
+                },
+            };
+            const { relationships } = externalModelToResolved(config, 'app', 'billing');
+            expect(relationships).toHaveLength(2);
+        });
+    });
+});
+//# sourceMappingURL=schema-converter.test.js.map

package/dist/external-model/__tests__/schema-converter.test.js.map

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

package/dist/external-model/computed-fields.d.ts

@@ -0,0 +1,3 @@
+import type { ExternalFieldConfig } from './types.js';
+export declare function evaluateComputedFields(record: Record<string, unknown>, fields: Record<string, ExternalFieldConfig>): Record<string, unknown>;
+//# sourceMappingURL=computed-fields.d.ts.map

package/dist/external-model/computed-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-fields.d.ts","sourceRoot":"","sources":["../../src/external-model/computed-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/external-model/computed-fields.js

@@ -0,0 +1,10 @@
+export function evaluateComputedFields(record, fields) {
+    const result = { ...record };
+    for (const [fieldName, config] of Object.entries(fields)) {
+        if (!config.computed)
+            continue;
+        result[fieldName] = config.computed.compute(result);
+    }
+    return result;
+}
+//# sourceMappingURL=computed-fields.js.map

package/dist/external-model/computed-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-fields.js","sourceRoot":"","sources":["../../src/external-model/computed-fields.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CACpC,MAA+B,EAC/B,MAA2C;IAE3C,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,SAAS;QAC/B,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/external-model/define.d.ts

@@ -0,0 +1,3 @@
+import type { ExternalModelConfig } from './types.js';
+export declare function defineExternalModel(config: ExternalModelConfig): ExternalModelConfig;
+//# sourceMappingURL=define.d.ts.map

package/dist/external-model/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/external-model/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAEpF"}

package/dist/external-model/define.js

@@ -0,0 +1,4 @@
+export function defineExternalModel(config) {
+    return config;
+}
+//# sourceMappingURL=define.js.map

package/dist/external-model/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/external-model/define.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC"}