@enfyra/mcp-server 0.1.13 → 0.1.14

package/dist/lib/response-format.js

@@ -0,0 +1,179 @@
+const RESPONSE_FORMAT = 'json+columnar-v1';
+const COLUMNAR_FORMAT = 'columnar-v1';
+const COMPRESSION_STATS_FIELD = 'compressionStats';
+function isPlainObject(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+function valueForColumn(record, column) {
+    return Object.prototype.hasOwnProperty.call(record, column) ? record[column] : null;
+}
+function collectColumns(records) {
+    const columns = [];
+    const seen = new Set();
+    for (const record of records) {
+        for (const key of Object.keys(record)) {
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            columns.push(key);
+        }
+    }
+    return columns;
+}
+function toColumnar(value, seen = new WeakSet()) {
+    if (Array.isArray(value)) {
+        if (value.length > 0 && value.every(isPlainObject)) {
+            const columns = collectColumns(value);
+            return {
+                format: COLUMNAR_FORMAT,
+                columns,
+                rows: value.map((record) => columns.map((column) => toColumnar(valueForColumn(record, column), seen))),
+                rowCount: value.length,
+            };
+        }
+        return value.map((item) => toColumnar(item, seen));
+    }
+    if (!isPlainObject(value))
+        return value;
+    if (seen.has(value))
+        return '[Circular]';
+    seen.add(value);
+    const output = {};
+    for (const [key, entry] of Object.entries(value)) {
+        output[key] = toColumnar(entry, seen);
+    }
+    seen.delete(value);
+    return output;
+}
+function safeJsonStringify(value) {
+    const seen = new WeakSet();
+    return JSON.stringify(value, (_key, entry) => {
+        if (!entry || typeof entry !== 'object')
+            return entry;
+        if (seen.has(entry))
+            return '[Circular]';
+        seen.add(entry);
+        return entry;
+    });
+}
+function estimateTokens(jsonText) {
+    if (!jsonText)
+        return 0;
+    return Math.ceil(jsonText.length / 4);
+}
+function buildCompressionStats(originalPayload, candidatePayload, selectedPayload, applied) {
+    const originalTokens = estimateTokens(safeJsonStringify(originalPayload));
+    const candidateTokens = estimateTokens(safeJsonStringify(candidatePayload));
+    const responseTokens = estimateTokens(safeJsonStringify(selectedPayload));
+    const candidateSavedTokens = originalTokens - candidateTokens;
+    const candidateSavedPercent = originalTokens > 0
+        ? Number(((candidateSavedTokens / originalTokens) * 100).toFixed(2))
+        : 0;
+    const savedTokens = originalTokens - responseTokens;
+    const savedPercent = originalTokens > 0
+        ? Number(((savedTokens / originalTokens) * 100).toFixed(2))
+        : 0;
+    return {
+        originalTokens,
+        compactTokens: responseTokens,
+        savedTokens,
+        savedPercent,
+        applied,
+        candidateCompactTokens: candidateTokens,
+        candidateSavedTokens,
+        candidateSavedPercent,
+    };
+}
+function attachCompressionStats(originalPayload, candidatePayload, selectedPayload, applied) {
+    if (isPlainObject(selectedPayload)
+        && selectedPayload.responseFormat === RESPONSE_FORMAT
+        && selectedPayload[COMPRESSION_STATS_FIELD]) {
+        return selectedPayload;
+    }
+    return {
+        ...selectedPayload,
+        [COMPRESSION_STATS_FIELD]: buildCompressionStats(originalPayload, candidatePayload, selectedPayload, applied),
+    };
+}
+function wrapPayload(payload) {
+    if (!isPlainObject(payload)) {
+        return {
+            responseFormat: RESPONSE_FORMAT,
+            value: payload,
+        };
+    }
+    return {
+        responseFormat: RESPONSE_FORMAT,
+        ...payload,
+    };
+}
+export function formatJsonPayload(payload) {
+    if (isPlainObject(payload)
+        && payload.responseFormat === RESPONSE_FORMAT
+        && payload[COMPRESSION_STATS_FIELD]) {
+        return payload;
+    }
+    const originalPayload = wrapPayload(payload);
+    const columnarPayload = wrapPayload(toColumnar(payload));
+    const originalTokens = estimateTokens(safeJsonStringify(originalPayload));
+    const candidateTokens = estimateTokens(safeJsonStringify(columnarPayload));
+    const shouldApplyColumnar = candidateTokens < originalTokens;
+    const selectedPayload = shouldApplyColumnar ? columnarPayload : originalPayload;
+    return attachCompressionStats(originalPayload, columnarPayload, selectedPayload, shouldApplyColumnar);
+}
+export function jsonContent(payload, { pretty = false } = {}) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(formatJsonPayload(payload), null, pretty ? 2 : 0),
+            }],
+    };
+}
+function tryParseJson(text) {
+    if (typeof text !== 'string')
+        return null;
+    const trimmed = text.trim();
+    if (!trimmed || !/^[\[{]/.test(trimmed))
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+function formatContentItem(item) {
+    if (!item || item.type !== 'text')
+        return item;
+    const parsed = tryParseJson(item.text);
+    if (!parsed)
+        return item;
+    return {
+        ...item,
+        text: JSON.stringify(formatJsonPayload(parsed)),
+    };
+}
+export function formatToolResult(result) {
+    if (!result || !Array.isArray(result.content))
+        return result;
+    return {
+        ...result,
+        content: result.content.map(formatContentItem),
+    };
+}
+export function installColumnarToolFormatter(server) {
+    const registerTool = server.tool.bind(server);
+    server.tool = (name, description, schema, handler) => {
+        if (typeof handler !== 'function') {
+            return registerTool(name, description, schema, handler);
+        }
+        return registerTool(name, description, schema, async (...args) => {
+            const result = await handler(...args);
+            return formatToolResult(result);
+        });
+    };
+}
+//# sourceMappingURL=response-format.js.map

package/dist/lib/response-format.js.map

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

package/dist/lib/route-guards.d.ts

@@ -0,0 +1 @@
+export declare function validateMainTableRoutePath(tables: any, mainTableId: any, routePath: any): any;

package/dist/lib/route-guards.js

@@ -0,0 +1,19 @@
+function getId(item) {
+    return item?.id ?? item?._id ?? null;
+}
+function sameId(a, b) {
+    return String(a) === String(b);
+}
+export function validateMainTableRoutePath(tables, mainTableId, routePath) {
+    const table = tables.find((item) => sameId(getId(item), mainTableId));
+    if (!table) {
+        throw new Error(`Unknown table id "${mainTableId}"`);
+    }
+    const canonicalPath = `/${table.name}`;
+    if (routePath !== canonicalPath) {
+        throw new Error(`mainTableId is only allowed for canonical table route "${canonicalPath}". ` +
+            `Omit mainTableId for custom route "${routePath}" and query explicit repos in handlers/hooks.`);
+    }
+    return table;
+}
+//# sourceMappingURL=route-guards.js.map

package/dist/lib/route-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-guards.js","sourceRoot":"","sources":["../../src/lib/route-guards.ts"],"names":[],"mappings":"AAAA,SAAS,KAAK,CAAC,IAAI;IACjB,OAAO,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;AACvC,CAAC;AAED,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS;IACvE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,WAAW,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,0DAA0D,aAAa,KAAK;YAC5E,sCAAsC,SAAS,+CAA+C,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/route-permission-tools.d.ts

@@ -0,0 +1,91 @@
+type IdLike = string | number | boolean | null | undefined;
+type RefRecord = {
+    id?: IdLike;
+    _id?: IdLike;
+    name?: unknown;
+    email?: unknown;
+    path?: unknown;
+    [key: string]: unknown;
+};
+type MethodIdNameMap = Record<string, string>;
+type RouteRecord = RefRecord & {
+    availableMethods?: unknown[];
+    publicMethods?: unknown[];
+    skipRoleGuardMethods?: unknown[];
+    isEnabled?: unknown;
+};
+type RoutePermissionRecord = RefRecord & {
+    isEnabled?: unknown;
+    description?: unknown;
+    route?: unknown;
+    role?: RefRecord | IdLike;
+    allowedUsers?: unknown[];
+    methods?: unknown[];
+};
+type RouteAccessExpected = {
+    methods?: unknown[];
+    roleId?: IdLike;
+    roleName?: string;
+    roleRequired?: boolean;
+    allowedUserIds?: unknown[];
+};
+export declare function normalizeMethodName(method: unknown): string;
+export declare function normalizeMethodNames(methods?: unknown[]): string[];
+export declare function getRecordId(record: unknown): IdLike;
+export declare function getReferenceId(value: unknown): IdLike;
+export declare function sameRecordId(a: unknown, b: unknown): boolean;
+export declare function resolveRoleByNameOrId(roles: RefRecord[], { roleId, roleName }?: RouteAccessExpected): RefRecord;
+export declare function methodNamesFromRecords(methods?: unknown[], methodIdNameMap?: MethodIdNameMap): string[];
+export declare function routeAvailableMethodNames(route: RouteRecord | null | undefined, methodIdNameMap?: MethodIdNameMap): string[];
+export declare function routePublicMethodNames(route: RouteRecord | null | undefined, methodIdNameMap?: MethodIdNameMap): string[];
+export declare function permissionMethodNames(permission: RoutePermissionRecord | null | undefined, methodIdNameMap?: MethodIdNameMap): string[];
+export declare function validateMethodsForRoute(route: RouteRecord | null | undefined, methods?: unknown[], methodMap?: MethodIdNameMap, methodIdNameMap?: MethodIdNameMap): string[];
+export declare function sortedIdStrings(values?: unknown[]): string[];
+export declare function sameIdSet(a?: unknown[], b?: unknown[]): boolean;
+export declare function routePermissionMatchesScope(permission: RoutePermissionRecord, { roleId, allowedUserIds }?: RouteAccessExpected): boolean;
+export declare function findRoutePermission(routePermissions: RoutePermissionRecord[], routeId: IdLike, scope: RouteAccessExpected): RoutePermissionRecord;
+export declare function mergeMethodNames(existingMethods?: unknown[], requestedMethods?: unknown[], mode?: string): string[];
+export declare function summarizeRoutePermission(permission: RoutePermissionRecord, methodIdNameMap?: MethodIdNameMap): {
+    id: IdLike;
+    isEnabled: boolean;
+    description: unknown;
+    route: unknown;
+    role: {
+        id: IdLike;
+        name: unknown;
+    };
+    allowedUsers: {
+        id: IdLike;
+        email: unknown;
+    }[];
+    methods: string[];
+};
+export declare function summarizeRouteAccess(route: RouteRecord, routePermissions?: RoutePermissionRecord[], methodIdNameMap?: MethodIdNameMap, expected?: RouteAccessExpected): {
+    id: IdLike;
+    path: unknown;
+    isEnabled: boolean;
+    availableMethods: string[];
+    publicMethods: string[];
+    skipRoleGuardMethods: string[];
+    permissions: {
+        id: IdLike;
+        isEnabled: boolean;
+        description: unknown;
+        route: unknown;
+        role: {
+            id: IdLike;
+            name: unknown;
+        };
+        allowedUsers: {
+            id: IdLike;
+            email: unknown;
+        }[];
+        methods: string[];
+    }[];
+    expected: {
+        methods: string[];
+        grantedMethods: string[];
+        missingMethods: string[];
+    };
+};
+export {};

package/dist/lib/route-permission-tools.js

@@ -0,0 +1,151 @@
+export function normalizeMethodName(method) {
+    return String(method || '').trim().toUpperCase();
+}
+export function normalizeMethodNames(methods = []) {
+    return [...new Set((methods || []).map(normalizeMethodName).filter(Boolean))];
+}
+export function getRecordId(record) {
+    if (!record || typeof record !== 'object')
+        return null;
+    const item = record;
+    return item.id ?? item._id ?? null;
+}
+export function getReferenceId(value) {
+    if (typeof value === 'object' && value !== null)
+        return getRecordId(value);
+    if (['string', 'number', 'boolean'].includes(typeof value))
+        return value;
+    return null;
+}
+export function sameRecordId(a, b) {
+    if (a === null || a === undefined || b === null || b === undefined)
+        return false;
+    return String(a) === String(b);
+}
+export function resolveRoleByNameOrId(roles, { roleId, roleName } = {}) {
+    if (roleId && roleName) {
+        throw new Error('Provide roleId or roleName, not both.');
+    }
+    if (!roleId && !roleName)
+        return null;
+    const normalizedRoleName = roleName ? String(roleName).trim().toLowerCase() : null;
+    const role = roles.find((item) => (roleId
+        ? sameRecordId(getRecordId(item), roleId)
+        : String(item?.name || '').trim().toLowerCase() === normalizedRoleName));
+    if (!role)
+        throw new Error(`Role not found: ${roleId || roleName}`);
+    return role;
+}
+export function methodNamesFromRecords(methods = [], methodIdNameMap = {}) {
+    return normalizeMethodNames((methods || []).map((method) => ((typeof method === 'object' && method !== null ? method.name : null)
+        || methodIdNameMap[String(getRecordId(method))]
+        || method)));
+}
+export function routeAvailableMethodNames(route, methodIdNameMap = {}) {
+    return methodNamesFromRecords(route?.availableMethods || [], methodIdNameMap);
+}
+export function routePublicMethodNames(route, methodIdNameMap = {}) {
+    return methodNamesFromRecords(route?.publicMethods || [], methodIdNameMap);
+}
+export function permissionMethodNames(permission, methodIdNameMap = {}) {
+    return methodNamesFromRecords(permission?.methods || [], methodIdNameMap);
+}
+export function validateMethodsForRoute(route, methods = [], methodMap = {}, methodIdNameMap = {}) {
+    const normalizedMethods = normalizeMethodNames(methods);
+    const knownMethods = new Set(Object.keys(methodMap || {}).map(normalizeMethodName));
+    const unknown = normalizedMethods.filter((method) => !knownMethods.has(method));
+    if (unknown.length) {
+        throw new Error(`Unknown enfyra_method.name values: ${unknown.join(', ')}`);
+    }
+    const availableMethods = routeAvailableMethodNames(route, methodIdNameMap);
+    if (availableMethods.length) {
+        const unavailable = normalizedMethods.filter((method) => !availableMethods.includes(method));
+        if (unavailable.length) {
+            throw new Error(`Route ${route?.path} does not list methods as available: ${unavailable.join(', ')}. Available: ${availableMethods.join(', ')}`);
+        }
+    }
+    return normalizedMethods;
+}
+export function sortedIdStrings(values = []) {
+    return [...new Set((values || []).map((value) => String(getReferenceId(value))).filter(Boolean))].sort();
+}
+export function sameIdSet(a = [], b = []) {
+    const left = sortedIdStrings(a);
+    const right = sortedIdStrings(b);
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+export function routePermissionMatchesScope(permission, { roleId, allowedUserIds } = {}) {
+    const expectedUsers = sortedIdStrings(allowedUserIds);
+    const permissionUsers = sortedIdStrings(permission?.allowedUsers || []);
+    const permissionRoleId = getReferenceId(permission?.role);
+    if (roleId && !sameRecordId(permissionRoleId, roleId))
+        return false;
+    if (!roleId && permissionRoleId !== null && permissionRoleId !== undefined)
+        return false;
+    return sameIdSet(permissionUsers, expectedUsers);
+}
+export function findRoutePermission(routePermissions = [], routeId, scope) {
+    return (routePermissions || []).find((permission) => (sameRecordId(getReferenceId(permission?.route), routeId)
+        && routePermissionMatchesScope(permission, scope))) || null;
+}
+export function mergeMethodNames(existingMethods = [], requestedMethods = [], mode = 'merge') {
+    const requested = normalizeMethodNames(requestedMethods);
+    if (mode === 'replace')
+        return requested;
+    return normalizeMethodNames([...normalizeMethodNames(existingMethods), ...requested]);
+}
+export function summarizeRoutePermission(permission, methodIdNameMap = {}) {
+    const role = permission?.role && typeof permission.role === 'object' ? permission.role : null;
+    return {
+        id: getRecordId(permission),
+        isEnabled: permission?.isEnabled !== false,
+        description: permission?.description || null,
+        route: typeof permission?.route === 'object' && permission.route !== null ? permission.route.path || permission.route : permission?.route || null,
+        role: permission?.role ? {
+            id: getReferenceId(permission.role),
+            name: role?.name || null,
+        } : null,
+        allowedUsers: (permission?.allowedUsers || []).map((user) => ({
+            id: getReferenceId(user),
+            email: typeof user === 'object' && user !== null ? user.email || null : null,
+        })),
+        methods: permissionMethodNames(permission, methodIdNameMap),
+    };
+}
+export function summarizeRouteAccess(route, routePermissions = [], methodIdNameMap = {}, expected = {}) {
+    const routeId = getRecordId(route);
+    const permissions = (routePermissions || [])
+        .filter((permission) => sameRecordId(getReferenceId(permission?.route), routeId))
+        .map((permission) => summarizeRoutePermission(permission, methodIdNameMap));
+    const expectedMethods = normalizeMethodNames(expected.methods || []);
+    const expectedRoleId = expected.roleId ? String(expected.roleId) : null;
+    const expectedAllowedUsers = sortedIdStrings(expected.allowedUserIds || []);
+    const hasExpectedScope = !!(expectedRoleId || expected.roleRequired || expected.allowedUserIds !== undefined);
+    const matchingPermissions = permissions.filter((permission) => {
+        if (!hasExpectedScope)
+            return true;
+        if (expectedRoleId && String(permission.role?.id) !== expectedRoleId)
+            return false;
+        if (!expectedRoleId && expected.roleRequired && permission.role)
+            return false;
+        if (!sameIdSet(permission.allowedUsers.map((user) => user.id), expectedAllowedUsers))
+            return false;
+        return true;
+    });
+    const grantedMethods = normalizeMethodNames(matchingPermissions.flatMap((permission) => (permission.isEnabled ? permission.methods : [])));
+    return {
+        id: routeId,
+        path: route?.path,
+        isEnabled: route?.isEnabled !== false,
+        availableMethods: routeAvailableMethodNames(route, methodIdNameMap),
+        publicMethods: routePublicMethodNames(route, methodIdNameMap),
+        skipRoleGuardMethods: methodNamesFromRecords(route?.skipRoleGuardMethods || [], methodIdNameMap),
+        permissions,
+        expected: expectedMethods.length ? {
+            methods: expectedMethods,
+            grantedMethods,
+            missingMethods: expectedMethods.filter((method) => !grantedMethods.includes(method)),
+        } : null,
+    };
+}
+//# sourceMappingURL=route-permission-tools.js.map

package/dist/lib/route-permission-tools.js.map

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

package/dist/lib/source-artifacts.d.ts

@@ -0,0 +1,27 @@
+type SourceArtifactInput = {
+    tableName?: string;
+    id: string | number;
+    fieldName: string;
+    source: string;
+};
+type CompactSourceFieldsOptions = {
+    tableName?: string;
+    idField?: string;
+    alwaysWrite?: boolean;
+};
+export declare function writeSourceArtifact({ tableName, id, fieldName, source }: SourceArtifactInput): {
+    tmpFile: string;
+    length: number;
+    sha256: string;
+    preview: string;
+};
+export declare function compactSourceField({ tableName, id, fieldName, source, alwaysWrite }: SourceArtifactInput & {
+    alwaysWrite?: boolean;
+}): string | {
+    tmpFile: string;
+    length: number;
+    sha256: string;
+    preview: string;
+};
+export declare function compactSourceFields(value: unknown, { tableName, idField, alwaysWrite }?: CompactSourceFieldsOptions): unknown;
+export {};

package/dist/lib/source-artifacts.js

@@ -0,0 +1,82 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+const DEFAULT_PREVIEW_CHARS = 1200;
+const DEFAULT_INLINE_LIMIT = 1400;
+const SOURCE_FIELD_NAMES = new Set([
+    'sourceCode',
+    'code',
+    'compiledCode',
+    'handlerScript',
+    'connectionHandlerScript',
+]);
+function sha256(value) {
+    return createHash('sha256').update(String(value), 'utf8').digest('hex');
+}
+function safePart(value) {
+    const source = String(value || 'source').trim();
+    return source.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 80) || 'source';
+}
+function extensionForField(fieldName) {
+    if (fieldName === 'code')
+        return '.vue';
+    return '.js';
+}
+export function writeSourceArtifact({ tableName, id, fieldName, source }) {
+    const hash = sha256(source);
+    const dir = join(tmpdir(), 'enfyra-mcp-sources');
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const fileName = [
+        safePart(tableName),
+        safePart(id),
+        safePart(fieldName),
+        hash.slice(0, 12),
+    ].join('-') + extensionForField(fieldName);
+    const path = join(dir, fileName);
+    writeFileSync(path, source, { mode: 0o600 });
+    return {
+        tmpFile: path,
+        length: source.length,
+        sha256: hash,
+        preview: source.length > DEFAULT_PREVIEW_CHARS
+            ? `${source.slice(0, DEFAULT_PREVIEW_CHARS)}...`
+            : source,
+    };
+}
+export function compactSourceField({ tableName, id, fieldName, source, alwaysWrite = false }) {
+    if (typeof source !== 'string')
+        return source;
+    if (!alwaysWrite && source.length <= DEFAULT_INLINE_LIMIT)
+        return source;
+    return writeSourceArtifact({ tableName, id, fieldName, source });
+}
+export function compactSourceFields(value, { tableName, idField = 'id', alwaysWrite = false } = {}) {
+    if (Array.isArray(value)) {
+        return value.map((item) => compactSourceFields(item, { tableName, idField, alwaysWrite }));
+    }
+    if (!value || typeof value !== 'object')
+        return value;
+    const record = value;
+    const recordId = String(record[idField] ?? record._id ?? record.id ?? 'record');
+    const out = {};
+    for (const [key, fieldValue] of Object.entries(record)) {
+        if (SOURCE_FIELD_NAMES.has(key) && typeof fieldValue === 'string') {
+            out[key] = compactSourceField({
+                tableName,
+                id: recordId,
+                fieldName: key,
+                source: fieldValue,
+                alwaysWrite,
+            });
+        }
+        else if (fieldValue && typeof fieldValue === 'object') {
+            out[key] = compactSourceFields(fieldValue, { tableName, idField, alwaysWrite });
+        }
+        else {
+            out[key] = fieldValue;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=source-artifacts.js.map

package/dist/lib/source-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-artifacts.js","sourceRoot":"","sources":["../../src/lib/source-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AACnC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,YAAY;IACZ,MAAM;IACN,cAAc;IACd,eAAe;IACf,yBAAyB;CAC1B,CAAC,CAAC;AAeH,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC;AACnG,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAuB;IAC3F,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACjD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG;QACf,QAAQ,CAAC,SAAS,CAAC;QACnB,QAAQ,CAAC,EAAE,CAAC;QACZ,QAAQ,CAAC,SAAS,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KAClB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,qBAAqB;YAC5C,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,KAAK;YAChD,CAAC,CAAC,MAAM;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAmD;IAC3I,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,IAAI,oBAAoB;QAAE,OAAO,MAAM,CAAC;IACzE,OAAO,mBAAmB,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,GAAG,KAAK,KAAiC,EAAE;IACrI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEtD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;IAChF,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAClE,GAAG,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC;gBAC5B,SAAS;gBACT,EAAE,EAAE,QAAQ;gBACZ,SAAS,EAAE,GAAG;gBACd,MAAM,EAAE,UAAU;gBAClB,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACxD,GAAG,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/table-tools.d.ts

@@ -0,0 +1,62 @@
+type AnyRecord = Record<string, any>;
+type ConstraintGroup = string[];
+type ColumnPatch = AnyRecord & {
+    id?: unknown;
+    _id?: unknown;
+    name?: string;
+    type?: string;
+    isNullable?: boolean;
+    isPrimary?: boolean;
+    isGenerated?: boolean;
+    isSystem?: boolean;
+    isPublished?: boolean;
+    isUpdatable?: boolean;
+    isEncrypted?: boolean;
+    isUnique?: boolean;
+    defaultValue?: unknown;
+    description?: string;
+    options?: unknown;
+};
+type RelationPatch = AnyRecord & {
+    id?: unknown;
+    _id?: unknown;
+    targetTable?: unknown;
+    type?: string;
+    propertyName?: string;
+    inversePropertyName?: string | null;
+    mappedBy?: unknown;
+    isNullable?: boolean;
+    onDelete?: string;
+    description?: string;
+};
+export declare function normalizeTablesFromMetadata(metadata: any): any[];
+export declare function resolveTableFromMetadata(metadata: any, tableId: any): any;
+export declare function resolveTableFromMetadataByName(metadata: any, tableName: any): any;
+export declare function resolveTableIdentifierFromMetadata(metadata: any, tableRef: any, label?: string): any;
+/**
+ * Helper: fetch table with full columns and relations.
+ * Dynamic enfyra_table relation fields can be paginated/truncated, so schema
+ * cascade tools must use /metadata as the complete source of columns/relations.
+ */
+export declare function fetchTableWithDetails(ENFYRA_API_URL: any, tableId: any): Promise<any>;
+export declare function assertIndexesDoNotReferenceUniqueFields(indexes: ConstraintGroup[], uniques: ConstraintGroup[]): void;
+export declare function normalizeRelationForTablePatch(relation: AnyRecord): RelationPatch;
+export declare function sanitizeExistingRelationForTablePatch(relation: AnyRecord): RelationPatch;
+export declare function resolveRelationTargetsFromMetadata(metadata: any, relations: RelationPatch[]): (RelationPatch | {
+    targetTable: any;
+    id?: unknown;
+    _id?: unknown;
+    type?: string;
+    propertyName?: string;
+    inversePropertyName?: string | null;
+    mappedBy?: unknown;
+    isNullable?: boolean;
+    onDelete?: string;
+    description?: string;
+})[];
+export declare function buildColumnDefinition({ name, type, isNullable, isUnique, isPublished, isUpdatable, isEncrypted, isPrimary, isGenerated, isSystem, defaultValue, description, options, }: AnyRecord): ColumnPatch;
+/**
+ * Register table tools with MCP server
+ */
+export declare function registerTableTools(server: any, ENFYRA_API_URL: any): void;
+export {};