typekro 0.3.1 → 0.5.0

package/dist/core/proxy/create-resource.js

@@ -0,0 +1,393 @@
+/**
+ * Core Proxy Engine & createResource Factory
+ *
+ * This module implements the magic proxy system that enables TypeScript-native
+ * Kubernetes resource composition.  It is the **single source of truth** for:
+ *
+ * - `createRefFactory` — KubernetesRef proxy builder
+ * - `createPropertyProxy` — spec/status property proxy
+ * - `createGenericProxyResource` — top-level Enhanced proxy
+ * - `createResource` — the public factory function
+ *
+ * The module lives in `core/` because it is foundational infrastructure used
+ * by both `core/references/external-refs.ts` and every factory in
+ * `factories/`.  `factories/shared.ts` re-exports `createResource` for
+ * backward compatibility.
+ */
+import { getCurrentCompositionContext, isInStatusBuilderContext } from '../composition/context.js';
+import { isDebugMode } from '../config/index.js';
+import { CEL_EXPRESSION_BRAND, KUBERNETES_REF_BRAND } from '../constants/brands.js';
+import { TypeKroError } from '../errors.js';
+import { conditionalExpressionIntegrator } from '../expressions/conditional/conditional-integration.js';
+import { getComponentLogger } from '../logging/index.js';
+import { getResourceId as getMetadataResourceId, getReadinessEvaluator, setReadinessEvaluator, setResourceId, } from '../metadata/index.js';
+import { ReadinessEvaluatorRegistry } from '../readiness/index.js';
+import { isKnownFactory, registerFactory } from '../resources/factory-registry.js';
+import { generateDeterministicResourceId } from '../resources/id.js';
+import { validateResourceId } from '../validation/cel-validator.js';
+import { detectStatusFieldTypo } from './known-status-fields.js';
+// Check for the debug environment variable
+const IS_DEBUG_MODE = isDebugMode();
+// Track which kinds have been auto-registered to avoid redundant registry lookups.
+const autoRegisteredKinds = new Set();
+const PROXY_ROOT_FIELDS = new Map([
+    ['data', { proxyMode: 'property', defaultValue: {} }],
+    ['stringData', { proxyMode: 'property', defaultValue: {} }],
+    ['rules', { proxyMode: 'property', defaultValue: [] }],
+    ['roleRef', { proxyMode: 'property', defaultValue: {} }],
+    ['subjects', { proxyMode: 'property', defaultValue: [] }],
+    ['provisioner', { proxyMode: 'value-or-ref' }],
+    ['parameters', { proxyMode: 'property', defaultValue: {} }],
+    ['subsets', { proxyMode: 'property', defaultValue: [] }],
+]);
+/**
+ * Deep clone a value, stripping functions (which are non-serializable proxies).
+ * Used by toJSON handlers on proxy objects to produce clean JSON output.
+ */
+function deepCloneValue(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value !== 'object')
+        return value;
+    if (value instanceof Date)
+        return new Date(value);
+    if (value instanceof RegExp)
+        return new RegExp(value);
+    if (Array.isArray(value)) {
+        return value.map((item) => deepCloneValue(item));
+    }
+    const cloned = {};
+    for (const k of Object.keys(value)) {
+        if (typeof value[k] !== 'function') {
+            cloned[k] = deepCloneValue(value[k]);
+        }
+    }
+    return cloned;
+}
+// Logger for debug mode
+const debugLogger = getComponentLogger('factory-proxy');
+// =============================================================================
+// PROXY ENGINE
+// =============================================================================
+function createRefFactory(resourceId, basePath) {
+    const proxyTarget = () => {
+        // Empty function used as proxy target
+    };
+    Object.defineProperty(proxyTarget, KUBERNETES_REF_BRAND, { value: true });
+    Object.defineProperty(proxyTarget, 'resourceId', { value: resourceId });
+    Object.defineProperty(proxyTarget, 'fieldPath', { value: basePath });
+    // Make the proxy compatible with string, number, and boolean types
+    Object.defineProperty(proxyTarget, 'valueOf', {
+        value: () => basePath,
+        enumerable: false,
+    });
+    Object.defineProperty(proxyTarget, 'toString', {
+        value: () => basePath,
+        enumerable: false,
+    });
+    return new Proxy(proxyTarget, {
+        get(target, prop) {
+            // Check for our defined properties first
+            if (prop === KUBERNETES_REF_BRAND || prop === 'resourceId' || prop === 'fieldPath') {
+                return target[prop];
+            }
+            // Check for other properties that exist on the target
+            if (prop in target)
+                return target[prop];
+            // .orValue(defaultValue) — returns a CelExpression with orValue helper
+            // Used for externalRef optional field access with default values
+            if (prop === 'orValue') {
+                return (defaultValue) => {
+                    const celExpr = typeof defaultValue === 'string'
+                        ? `${basePath}.orValue("${defaultValue}")`
+                        : `${basePath}.orValue(${String(defaultValue)})`;
+                    return {
+                        [CEL_EXPRESSION_BRAND]: true,
+                        expression: celExpr,
+                        _type: undefined,
+                    };
+                };
+            }
+            const propStr = String(prop);
+            // $ prefix — Kro optional access (.?field)
+            if (propStr.startsWith('$')) {
+                const actualField = propStr.substring(1);
+                return createRefFactory(resourceId, `${basePath}.?${actualField}`);
+            }
+            // For unknown properties, create nested references
+            return createRefFactory(resourceId, `${basePath}.${propStr}`);
+        },
+        // Proxy-based KubernetesRef factory: returns a dynamically-typed proxy
+    });
+}
+function createPropertyProxy(resourceId, basePath, target, kind) {
+    if (IS_DEBUG_MODE) {
+        debugLogger.debug('Proxy created', { resourceId, basePath });
+    }
+    return new Proxy(target, {
+        /**
+         * Trap for Object.keys, JSON.stringify, etc.
+         */
+        ownKeys(obj) {
+            return Reflect.ownKeys(obj);
+        },
+        /**
+         * Required for Object.keys() to work correctly with ownKeys trap
+         */
+        getOwnPropertyDescriptor(obj, prop) {
+            return Reflect.getOwnPropertyDescriptor(obj, prop);
+        },
+        get: (obj, prop) => {
+            // Handle toJSON specially to ensure proper serialization
+            if (prop === 'toJSON') {
+                return () => {
+                    const result = {};
+                    for (const key of Object.keys(obj)) {
+                        result[key] = deepCloneValue(obj[key]);
+                    }
+                    return result;
+                };
+            }
+            // 1. Immediately handle non-string properties.
+            if (typeof prop !== 'string') {
+                return obj[prop];
+            }
+            // 2. Check if the user is explicitly requesting a reference with the '$' prefix.
+            if (prop.startsWith('$')) {
+                const actualProp = prop.substring(1);
+                return createRefFactory(resourceId, `${basePath}.?${actualProp}`);
+            }
+            // 3. For any other access, default to "eager value" or "implicit ref for unknown" logic.
+            if (isInStatusBuilderContext() && (basePath === 'status' || basePath === 'spec')) {
+                return createRefFactory(resourceId, `${basePath}.${String(prop)}`);
+            }
+            if (prop in obj) {
+                return obj[prop];
+            }
+            else {
+                // Runtime typo detection for status field access (Phase 2.12).
+                // Only fires in debug mode, for known K8s kinds, when accessing status fields.
+                if (IS_DEBUG_MODE && basePath === 'status' && kind) {
+                    const suggestion = detectStatusFieldTypo(kind, prop);
+                    if (suggestion) {
+                        debugLogger.warn(`Possible typo: '${prop}' accessed on ${kind} status but not found in known fields. Did you mean '${suggestion}'?`, { resourceId, kind, accessedField: prop, suggestedField: suggestion });
+                    }
+                }
+                return createRefFactory(resourceId, `${basePath}.${String(prop)}`);
+            }
+        },
+        set: (obj, prop, value) => {
+            if (IS_DEBUG_MODE) {
+                debugLogger.debug('Proxy property set', { basePath, prop: String(prop), value });
+            }
+            return Reflect.set(obj, prop, value);
+        },
+    });
+}
+function createGenericProxyResource(resourceId, resource) {
+    setResourceId(resource, resourceId);
+    // Cache proxies to ensure the same proxy is returned each time
+    let specProxy;
+    let statusProxy;
+    return new Proxy(resource, {
+        ownKeys(target) {
+            return Reflect.ownKeys(target);
+        },
+        get(target, prop, receiver) {
+            // Handle toJSON specially to ensure proper serialization
+            if (prop === 'toJSON') {
+                return () => {
+                    // Clone and filter out internal fields
+                    const result = {};
+                    for (const key of Object.keys(target)) {
+                        if (key !== '__resourceId' &&
+                            key !== 'withReadinessEvaluator' &&
+                            key !== 'readinessEvaluator' &&
+                            key !== 'id') {
+                            result[key] = deepCloneValue(Reflect.get(target, key));
+                        }
+                    }
+                    return result;
+                };
+            }
+            if (prop === 'spec') {
+                if (!specProxy) {
+                    const spec = target.spec ?? {};
+                    specProxy = createPropertyProxy(resourceId, 'spec', spec);
+                }
+                return specProxy;
+            }
+            if (prop === 'status') {
+                if (!statusProxy) {
+                    const status = target.status ?? {};
+                    statusProxy = createPropertyProxy(resourceId, 'status', status, target.kind);
+                }
+                return statusProxy;
+            }
+            if (prop === 'metadata') {
+                const metadata = target.metadata || {};
+                const metadataProxy = createPropertyProxy(resourceId, 'metadata', metadata);
+                if (metadata && typeof metadata === 'object') {
+                    for (const [key, value] of Object.entries(metadata)) {
+                        if (!Object.hasOwn(metadataProxy, key)) {
+                            Object.defineProperty(metadataProxy, key, {
+                                value: value,
+                                enumerable: true,
+                                configurable: true,
+                                writable: true,
+                            });
+                        }
+                    }
+                }
+                return metadataProxy;
+            }
+            if (prop === 'id') {
+                return resourceId;
+            }
+            // Serve metadata from WeakMap store (backward compatibility for .readinessEvaluator / .__resourceId)
+            // Check both proxy (receiver) and target since metadata may be set on either
+            if (prop === 'readinessEvaluator') {
+                return getReadinessEvaluator(receiver) ?? getReadinessEvaluator(target);
+            }
+            if (prop === '__resourceId') {
+                return getMetadataResourceId(receiver) ?? getMetadataResourceId(target);
+            }
+            // Handle common Kubernetes resource fields as magic proxies (data-driven).
+            // See PROXY_ROOT_FIELDS above for the full registry.
+            if (typeof prop === 'string') {
+                const fieldConfig = PROXY_ROOT_FIELDS.get(prop);
+                if (fieldConfig && prop in target) {
+                    if (fieldConfig.proxyMode === 'property') {
+                        const value = Reflect.get(target, prop) ?? fieldConfig.defaultValue;
+                        // All property-mode fields are objects (Record/Array), safe to cast
+                        return createPropertyProxy(resourceId, prop, value);
+                    }
+                    // 'value-or-ref': return raw value when defined, otherwise a reference
+                    const value = Reflect.get(target, prop);
+                    if (value !== undefined) {
+                        return value;
+                    }
+                    return createRefFactory(resourceId, prop);
+                }
+            }
+            if (typeof prop === 'string' && prop.startsWith('$')) {
+                return createRefFactory(resourceId, prop.substring(1));
+            }
+            // For external refs, unknown properties should return reference proxies
+            if (typeof prop === 'string' &&
+                '__externalRef' in target &&
+                !(prop in target) &&
+                !prop.startsWith('__')) {
+                return createRefFactory(resourceId, prop);
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+        set(target, prop, value, receiver) {
+            return Reflect.set(target, prop, value, receiver);
+        },
+    });
+}
+/**
+ * Create an Enhanced proxy resource from a plain Kubernetes resource definition.
+ *
+ * This is the foundational factory function used by all TypeKro factories.
+ * It wraps a resource in the magic proxy system that enables:
+ * - Automatic KubernetesRef generation for spec/status property access
+ * - Deterministic resource ID generation for Kro
+ * - Composition context registration
+ * - Readiness evaluator attachment
+ *
+ * @example
+ * ```typescript
+ * const deploy = createResource<V1DeploymentSpec, V1DeploymentStatus>({
+ *   apiVersion: 'apps/v1',
+ *   kind: 'Deployment',
+ *   metadata: { name: 'my-app' },
+ *   spec: { replicas: 3, ... },
+ * });
+ * ```
+ */
+export function createResource(resource, options) {
+    // Validate namespace scope rules
+    if (options?.scope) {
+        const hasNamespace = !!resource.metadata?.namespace;
+        if (options.scope === 'cluster' && hasNamespace) {
+            throw new TypeKroError(`${resource.kind} is cluster-scoped and cannot have a namespace. ` +
+                `Remove the 'namespace' field from metadata.`, 'INVALID_RESOURCE_SCOPE', { kind: resource.kind, namespace: resource.metadata?.namespace });
+        }
+        if (options.scope === 'namespaced' && !hasNamespace) {
+            debugLogger.warn(`${resource.kind} is namespaced but no namespace specified. Kubernetes will use 'default'.`, {
+                kind: resource.kind,
+                name: resource.metadata?.name,
+            });
+        }
+    }
+    let resourceId;
+    // Check for id field on the resource itself
+    if (resource.id) {
+        resourceId = resource.id;
+        // Validate that the ID follows camelCase convention
+        const validation = validateResourceId(resourceId);
+        if (!validation.isValid) {
+            throw new TypeKroError(`Invalid resource ID: ${validation.error}`, 'INVALID_RESOURCE_ID', {
+                resourceId,
+                error: validation.error,
+            });
+        }
+        // Remove the id field from the resource to prevent it from being sent to Kubernetes
+        const { id: _id, ...cleanResource } = resource;
+        resource = cleanResource;
+    }
+    else {
+        // Use deterministic ID generation by default
+        const name = resource.metadata?.name || resource.kind.toLowerCase();
+        const namespace = resource.metadata?.namespace;
+        resourceId = generateDeterministicResourceId(resource.kind, name, namespace);
+    }
+    // Auto-register the factory in the central FactoryRegistry the first time
+    // we see a given kind, but ONLY if the factory doesn't already have an
+    // explicit registration (which may include semantic aliases that we must
+    // not overwrite).
+    if (!autoRegisteredKinds.has(resource.kind)) {
+        autoRegisteredKinds.add(resource.kind);
+        if (!isKnownFactory(resource.kind)) {
+            registerFactory({
+                factoryName: resource.kind,
+                kind: resource.kind,
+                apiVersion: resource.apiVersion,
+            });
+        }
+    }
+    const enhanced = createGenericProxyResource(resourceId, resource);
+    // Also store metadata for the PROXY itself (not just the target).
+    // This is critical because downstream code (e.g. getResourceId, getReadinessEvaluator)
+    // receives the proxy but the WeakMap entry was set on the target at line 194.
+    // Without this, WeakMap lookups on the proxy return undefined.
+    setResourceId(enhanced, resourceId);
+    // Auto-register with composition context if active (but not for external references)
+    const context = getCurrentCompositionContext();
+    if (context && !resource.__externalRef) {
+        context.addResource(resourceId, enhanced);
+    }
+    // Add fluent builder method for readiness evaluator
+    Object.defineProperty(enhanced, 'withReadinessEvaluator', {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accepts evaluators typed for any K8s resource
+        value: function (evaluator) {
+            // Register in global registry by KIND
+            ReadinessEvaluatorRegistry.getInstance().registerForKind(this.kind, evaluator, 'factory-defined');
+            // Attach to individual resource instance via WeakMap
+            setReadinessEvaluator(this, evaluator);
+            return this;
+        },
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    // Add conditional expression support
+    const enhancedWithConditionals = conditionalExpressionIntegrator.addConditionalSupport(enhanced, {
+        autoProcess: false,
+        validateExpressions: true,
+    });
+    return enhancedWithConditionals;
+}
+//# sourceMappingURL=create-resource.js.map

package/dist/core/proxy/create-resource.js.map

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

package/dist/core/proxy/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core Proxy Engine
+ *
+ * Exports the foundational `createResource` function and its options type.
+ */
+export type { CreateResourceOptions } from './create-resource.js';
+export { createResource } from './create-resource.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/proxy/index.js

@@ -0,0 +1,7 @@
+/**
+ * Core Proxy Engine
+ *
+ * Exports the foundational `createResource` function and its options type.
+ */
+export { createResource } from './create-resource.js';
+//# sourceMappingURL=index.js.map

package/dist/core/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/proxy/known-status-fields.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Known status fields for standard Kubernetes resource kinds
+ *
+ * Used by the proxy's status property access trap to detect typos at runtime
+ * when debug mode is enabled. Only fires for known K8s kinds — CRDs and
+ * cross-composition references have unknown kinds, so no false positives.
+ *
+ * @see ROADMAP.md Phase 2.12
+ */
+/**
+ * Check if a status field access looks like a typo of a known field.
+ *
+ * Returns the closest known field name if the accessed property:
+ * 1. Is NOT already a known field for the kind
+ * 2. Has a Levenshtein distance ≤ MAX_TYPO_DISTANCE to a known field
+ * 3. The kind is in the KNOWN_STATUS_FIELDS registry
+ *
+ * Returns `null` if no typo is detected (either valid field, unknown kind,
+ * or no close match found).
+ */
+export declare function detectStatusFieldTypo(kind: string, accessedField: string): string | null;
+/**
+ * Get the list of known status fields for a kind.
+ * Returns undefined for unknown kinds.
+ */
+export declare function getKnownStatusFields(kind: string): readonly string[] | undefined;
+//# sourceMappingURL=known-status-fields.d.ts.map

package/dist/core/proxy/known-status-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-status-fields.d.ts","sourceRoot":"","sources":["../../../src/core/proxy/known-status-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6IH;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BxF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAEhF"}

package/dist/core/proxy/known-status-fields.js

@@ -0,0 +1,185 @@
+/**
+ * Known status fields for standard Kubernetes resource kinds
+ *
+ * Used by the proxy's status property access trap to detect typos at runtime
+ * when debug mode is enabled. Only fires for known K8s kinds — CRDs and
+ * cross-composition references have unknown kinds, so no false positives.
+ *
+ * @see ROADMAP.md Phase 2.12
+ */
+import { levenshteinDistance } from '../../utils/string.js';
+/**
+ * Map of Kubernetes kind → known status field names.
+ *
+ * These are the fields defined by the standard Kubernetes API for each kind.
+ * Only includes kinds with meaningful status fields; kinds like ConfigMap
+ * and Secret that have no status are omitted (no warning needed for them).
+ */
+const KNOWN_STATUS_FIELDS = {
+    // Workloads
+    Deployment: [
+        'replicas',
+        'readyReplicas',
+        'availableReplicas',
+        'updatedReplicas',
+        'unavailableReplicas',
+        'conditions',
+        'observedGeneration',
+        'collisionCount',
+    ],
+    StatefulSet: [
+        'replicas',
+        'readyReplicas',
+        'currentReplicas',
+        'updatedReplicas',
+        'currentRevision',
+        'updateRevision',
+        'collisionCount',
+        'conditions',
+        'observedGeneration',
+        'availableReplicas',
+    ],
+    DaemonSet: [
+        'desiredNumberScheduled',
+        'numberReady',
+        'numberAvailable',
+        'numberMisscheduled',
+        'numberUnavailable',
+        'updatedNumberScheduled',
+        'currentNumberScheduled',
+        'collisionCount',
+        'conditions',
+        'observedGeneration',
+    ],
+    ReplicaSet: [
+        'replicas',
+        'readyReplicas',
+        'availableReplicas',
+        'fullyLabeledReplicas',
+        'conditions',
+        'observedGeneration',
+    ],
+    Job: [
+        'succeeded',
+        'failed',
+        'active',
+        'completionTime',
+        'startTime',
+        'conditions',
+        'completedIndexes',
+        'ready',
+        'uncountedTerminatedPods',
+    ],
+    CronJob: ['lastScheduleTime', 'lastSuccessfulTime', 'active'],
+    // Core
+    Pod: [
+        'phase',
+        'conditions',
+        'containerStatuses',
+        'initContainerStatuses',
+        'ephemeralContainerStatuses',
+        'hostIP',
+        'podIP',
+        'podIPs',
+        'startTime',
+        'message',
+        'reason',
+        'nominatedNodeName',
+        'qosClass',
+    ],
+    Namespace: ['phase', 'conditions'],
+    Node: [
+        'conditions',
+        'addresses',
+        'allocatable',
+        'capacity',
+        'daemonEndpoints',
+        'images',
+        'nodeInfo',
+        'phase',
+        'volumesAttached',
+        'volumesInUse',
+    ],
+    Service: ['loadBalancer', 'conditions'],
+    // Networking
+    Ingress: ['loadBalancer', 'observedGeneration'],
+    // Storage
+    PersistentVolumeClaim: [
+        'phase',
+        'accessModes',
+        'capacity',
+        'conditions',
+        'allocatedResources',
+        'allocatedResourceStatuses',
+    ],
+    PersistentVolume: ['phase', 'message', 'reason', 'lastPhaseTransitionTime'],
+    // Autoscaling
+    HorizontalPodAutoscaler: [
+        'currentReplicas',
+        'desiredReplicas',
+        'currentMetrics',
+        'conditions',
+        'observedGeneration',
+        'lastScaleTime',
+    ],
+    // Policy
+    PodDisruptionBudget: [
+        'currentHealthy',
+        'desiredHealthy',
+        'expectedPods',
+        'disruptionsAllowed',
+        'disruptedPods',
+        'observedGeneration',
+        'conditions',
+    ],
+};
+/**
+ * Maximum Levenshtein distance to consider a field name as a typo.
+ * 2 catches common typos like readyReplica→readyReplicas, reedyReplicas→readyReplicas.
+ */
+const MAX_TYPO_DISTANCE = 2;
+/**
+ * Check if a status field access looks like a typo of a known field.
+ *
+ * Returns the closest known field name if the accessed property:
+ * 1. Is NOT already a known field for the kind
+ * 2. Has a Levenshtein distance ≤ MAX_TYPO_DISTANCE to a known field
+ * 3. The kind is in the KNOWN_STATUS_FIELDS registry
+ *
+ * Returns `null` if no typo is detected (either valid field, unknown kind,
+ * or no close match found).
+ */
+export function detectStatusFieldTypo(kind, accessedField) {
+    const knownFields = KNOWN_STATUS_FIELDS[kind];
+    if (!knownFields) {
+        // Unknown kind (CRD, cross-composition) — no false positives
+        return null;
+    }
+    if (knownFields.length === 0) {
+        // Kind has no status fields (ConfigMap, Secret) — no warning
+        return null;
+    }
+    // Check if the field is known
+    if (knownFields.includes(accessedField)) {
+        return null;
+    }
+    // Find the closest known field
+    let bestMatch = null;
+    let bestDistance = MAX_TYPO_DISTANCE + 1;
+    for (const knownField of knownFields) {
+        const distance = levenshteinDistance(accessedField, knownField);
+        if (distance <= MAX_TYPO_DISTANCE && distance < bestDistance) {
+            bestDistance = distance;
+            bestMatch = knownField;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Get the list of known status fields for a kind.
+ * Returns undefined for unknown kinds.
+ */
+export function getKnownStatusFields(kind) {
+    return KNOWN_STATUS_FIELDS[kind];
+}
+//# sourceMappingURL=known-status-fields.js.map

package/dist/core/proxy/known-status-fields.js.map

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