typekro 0.3.1 → 0.5.0

package/dist/core/references/schema-proxy.js

@@ -16,19 +16,76 @@ function createSchemaRefFactory(fieldPath) {
     Object.defineProperty(proxyTarget, KUBERNETES_REF_BRAND, { value: true, enumerable: false });
     Object.defineProperty(proxyTarget, 'resourceId', { value: '__schema__', enumerable: false });
     Object.defineProperty(proxyTarget, 'fieldPath', { value: fieldPath, enumerable: false });
+    // Create a single "element" proxy for iteration support.
+    // When the schema ref is used as an iterable (for-of) or array-like (.map(), .filter(), etc.),
+    // we yield a single element proxy. This causes factory calls inside loops to execute once,
+    // registering the resource. The AST analyzer later detects the loop and attaches forEach.
+    //
+    // SENTINEL: We use `$item` (not `__element__`) because the ref marker regex
+    // /__KUBERNETES_REF_{id}_{fieldPath}__/ uses [a-zA-Z0-9.] for fieldPath, and
+    // underscores in `__element__` would break the delimiter detection.
+    // `$item` uses `$` which is included in [a-zA-Z0-9.$] after we update the regex.
+    const createElement = () => createSchemaRefFactory(`${fieldPath}.$item`);
     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];
             }
-            // Only preserve essential function properties, not 'name' or other properties
-            // that might conflict with field names
-            if (prop === 'toString' ||
-                prop === 'valueOf' ||
-                prop === 'call' ||
-                prop === 'apply' ||
-                prop === 'bind') {
+            // Handle toString specially to return a detectable string for template literals
+            if (prop === 'toString') {
+                return () => `__KUBERNETES_REF___schema___${fieldPath}__`;
+            }
+            // Handle valueOf specially to return a detectable string for template literals
+            if (prop === 'valueOf') {
+                return () => `__KUBERNETES_REF___schema___${fieldPath}__`;
+            }
+            // Handle Symbol.toPrimitive for template literal coercion
+            if (prop === Symbol.toPrimitive) {
+                return () => `__KUBERNETES_REF___schema___${fieldPath}__`;
+            }
+            // Support for-of iteration: yield a single element proxy so loop bodies execute once
+            if (prop === Symbol.iterator) {
+                return function* () {
+                    yield createElement();
+                };
+            }
+            // Array iteration methods: .map(), .forEach(), .filter(), .some(), .every()
+            // Execute the callback once with a dummy element proxy so factory calls register.
+            if (prop === 'map') {
+                return (callback) => {
+                    const elem = createElement();
+                    const result = callback(elem, 0, [elem]);
+                    return [result];
+                };
+            }
+            if (prop === 'forEach') {
+                return (callback) => {
+                    callback(createElement(), 0, [createElement()]);
+                };
+            }
+            if (prop === 'filter') {
+                return (callback) => {
+                    const elem = createElement();
+                    // Execute the predicate but always return the array with the element.
+                    // The predicate's return value is only used for AST analysis.
+                    callback(elem, 0, [elem]);
+                    // Return a proxy that also supports chaining (.filter().map())
+                    return createSchemaArrayProxy(fieldPath, callback);
+                };
+            }
+            if (prop === 'some' || prop === 'every') {
+                return (callback) => {
+                    const elem = createElement();
+                    return callback(elem, 0, [elem]);
+                };
+            }
+            // .length — return 1 (single element for iteration)
+            if (prop === 'length') {
+                return 1;
+            }
+            // Preserve essential function properties
+            if (prop === 'call' || prop === 'apply' || prop === 'bind') {
                 return target[prop];
             }
             // For any other property, create a new nested reference
@@ -36,6 +93,42 @@ function createSchemaRefFactory(fieldPath) {
         },
     });
 }
+/**
+ * Creates a proxy for the result of .filter() calls on schema array refs.
+ * This allows chaining like `spec.workers.filter(...).map(...)`.
+ */
+function createSchemaArrayProxy(baseFieldPath, _filterCallback) {
+    // Use $item sentinel (same as the primary array proxy) so that the marker regex
+    // and YAML serializer's $item substitution work correctly for chained calls.
+    const createElement = () => createSchemaRefFactory(`${baseFieldPath}.$item`);
+    const arr = [createElement()];
+    return new Proxy(arr, {
+        get(target, prop) {
+            if (prop === 'map') {
+                return (callback) => {
+                    const elem = createElement();
+                    const result = callback(elem, 0, arr);
+                    return [result];
+                };
+            }
+            if (prop === 'forEach') {
+                return (callback) => {
+                    callback(createElement(), 0, arr);
+                };
+            }
+            if (prop === 'length') {
+                return 1;
+            }
+            if (prop === Symbol.iterator) {
+                return function* () {
+                    yield createElement();
+                };
+            }
+            // Default: delegate to the actual array
+            return Reflect.get(target, prop);
+        },
+    });
+}
 /**
  * Creates a MagicProxy for a specific schema section (spec or status)
  * that returns KubernetesRef objects for any accessed property
@@ -107,7 +200,7 @@ export function createResourcesProxy(resources) {
                 }
                 if (prop === 'spec' || prop === 'status') {
                     // Return a proxy that converts the MagicProxy field access to resource references
-                    return createResourceMagicProxy(resourceKey, prop, target[prop]);
+                    return createResourceMagicProxy(resourceKey, prop);
                 }
                 // For all other properties, return the original value
                 return target[prop];
@@ -117,10 +210,10 @@ export function createResourcesProxy(resources) {
     return proxiedResources;
 }
 /**
- * Create a magic proxy that converts Enhanced MagicProxy field access to resource references
- * Uses recursive proxy creation similar to createSchemaRefFactory for deep nesting support
+ * Create a magic proxy that converts Enhanced MagicProxy field access to resource references.
+ * Delegates to createResourceRefFactory for deep nesting support.
  */
-function createResourceMagicProxy(resourceId, fieldType, _originalProxy) {
+function createResourceMagicProxy(resourceId, fieldType) {
     return createResourceRefFactory(resourceId, fieldType);
 }
 /**
@@ -153,9 +246,7 @@ function createResourceRefFactory(resourceId, fieldPath) {
                 return () => `__KUBERNETES_REF_${resourceId}_${fieldPath}__`;
             }
             // Preserve essential function properties
-            if (prop === 'call' ||
-                prop === 'apply' ||
-                prop === 'bind') {
+            if (prop === 'call' || prop === 'apply' || prop === 'bind') {
                 return target[prop];
             }
             // For any other property, create a new nested reference

package/dist/core/references/schema-proxy.js.map

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

package/dist/core/resources/factory-registry.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Factory Registry
+ *
+ * A bare registry where resource factories self-register their metadata at
+ * import time. This replaces three hardcoded allowlists:
+ *
+ * 1. `KNOWN_FACTORY_NAMES` (composition-analyzer.ts)
+ *    → `isKnownFactory(name)`
+ *
+ * 2. `FACTORY_KIND_MAP` (serialization/core.ts)
+ *    → `getKindInfo(name)`
+ *
+ * 3. `semanticPatterns` (serialization/core.ts findResourceByKey)
+ *    → `getSemanticCandidateKinds(alias)`
+ *
+ * This module contains NO built-in entries. Each factory file registers itself
+ * by calling `registerFactory()` at module scope. Custom factories become
+ * first-class citizens the same way — no core files need editing.
+ */
+/** Metadata for a registered factory. */
+export interface FactoryRegistration {
+    /** The factory function name as it appears in source code (e.g. 'Deployment', 'helmRelease'). */
+    readonly factoryName: string;
+    /** The Kubernetes kind this factory creates (e.g. 'Deployment', 'HelmRelease'). */
+    readonly kind: string;
+    /** The Kubernetes apiVersion (e.g. 'apps/v1', 'v1'). */
+    readonly apiVersion: string;
+    /**
+     * Semantic aliases for fuzzy resource key matching.
+     * For example, `['database', 'db']` means a composition key named `database`
+     * or `db` will match resources of this kind.
+     */
+    readonly semanticAliases?: readonly string[];
+}
+/**
+ * Register a factory's metadata. Call this at module scope in your factory
+ * file so the registry is populated when the factory is imported.
+ *
+ * Safe to call multiple times with the same factoryName — subsequent calls
+ * overwrite silently (e.g. when a file is re-imported in tests).
+ *
+ * @example
+ * ```ts
+ * // In your factory file:
+ * import { registerFactory } from '../../core/resources/factory-registry.js';
+ *
+ * registerFactory({
+ *   factoryName: 'Deployment',
+ *   kind: 'Deployment',
+ *   apiVersion: 'apps/v1',
+ *   semanticAliases: ['deploy', 'database', 'db'],
+ * });
+ *
+ * export function deployment(config: DeploymentConfig): Enhanced<...> { ... }
+ * ```
+ */
+export declare function registerFactory(registration: FactoryRegistration): void;
+/**
+ * Bulk-register multiple factories at once.
+ */
+export declare function registerFactories(registrations: readonly FactoryRegistration[]): void;
+/**
+ * Check whether `name` is a known factory function name.
+ * Replaces `KNOWN_FACTORY_NAMES.has(name)`.
+ */
+export declare function isKnownFactory(name: string): boolean;
+/**
+ * Get the apiVersion + kind for a factory name.
+ * Replaces `FACTORY_KIND_MAP[name]`.
+ * Returns `undefined` if the factory is not registered.
+ */
+export declare function getKindInfo(factoryName: string): {
+    apiVersion: string;
+    kind: string;
+} | undefined;
+/**
+ * Get candidate Kubernetes kinds for a semantic alias
+ * (e.g. 'database' → ['deployment', 'statefulset']).
+ * Replaces the hardcoded `semanticPatterns` in `findResourceByKey`.
+ * Returns lowercase kind strings, or `undefined` if no alias matches.
+ */
+export declare function getSemanticCandidateKinds(alias: string): string[] | undefined;
+/**
+ * Get the full registration for a factory by name.
+ */
+export declare function getFactoryRegistration(factoryName: string): FactoryRegistration | undefined;
+/**
+ * Get all registered factory names. Useful for diagnostics.
+ */
+export declare function getRegisteredFactoryNames(): string[];
+/**
+ * Get the total number of registered factories.
+ */
+export declare function getRegisteredFactoryCount(): number;
+/**
+ * Clear the registry. Only used in tests.
+ */
+export declare function clearFactoryRegistry(): void;
+//# sourceMappingURL=factory-registry.d.ts.map

package/dist/core/resources/factory-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-registry.d.ts","sourceRoot":"","sources":["../../../src/core/resources/factory-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,iGAAiG;IACjG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAeD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CA2BvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAIrF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIjG;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAG7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE3F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/core/resources/factory-registry.js

@@ -0,0 +1,166 @@
+/**
+ * Factory Registry
+ *
+ * A bare registry where resource factories self-register their metadata at
+ * import time. This replaces three hardcoded allowlists:
+ *
+ * 1. `KNOWN_FACTORY_NAMES` (composition-analyzer.ts)
+ *    → `isKnownFactory(name)`
+ *
+ * 2. `FACTORY_KIND_MAP` (serialization/core.ts)
+ *    → `getKindInfo(name)`
+ *
+ * 3. `semanticPatterns` (serialization/core.ts findResourceByKey)
+ *    → `getSemanticCandidateKinds(alias)`
+ *
+ * This module contains NO built-in entries. Each factory file registers itself
+ * by calling `registerFactory()` at module scope. Custom factories become
+ * first-class citizens the same way — no core files need editing.
+ */
+/**
+ * Module-level singleton registry.
+ *
+ * We deliberately use a plain module-scoped Map rather than a class so that
+ * the registry survives across imports without requiring a global/Symbol
+ * lookup. There is exactly one registry per process.
+ */
+const factoriesByName = new Map();
+const factoriesByKind = new Map();
+const semanticAliasIndex = new Map(); // alias → candidate kind[]
+// ---------- Public API ----------
+/**
+ * Register a factory's metadata. Call this at module scope in your factory
+ * file so the registry is populated when the factory is imported.
+ *
+ * Safe to call multiple times with the same factoryName — subsequent calls
+ * overwrite silently (e.g. when a file is re-imported in tests).
+ *
+ * @example
+ * ```ts
+ * // In your factory file:
+ * import { registerFactory } from '../../core/resources/factory-registry.js';
+ *
+ * registerFactory({
+ *   factoryName: 'Deployment',
+ *   kind: 'Deployment',
+ *   apiVersion: 'apps/v1',
+ *   semanticAliases: ['deploy', 'database', 'db'],
+ * });
+ *
+ * export function deployment(config: DeploymentConfig): Enhanced<...> { ... }
+ * ```
+ */
+export function registerFactory(registration) {
+    const { factoryName, kind } = registration;
+    // Remove old entry if re-registering (e.g. in tests)
+    const old = factoriesByName.get(factoryName);
+    if (old) {
+        removeFromKindIndex(old);
+        removeFromSemanticIndex(old);
+    }
+    factoriesByName.set(factoryName, registration);
+    // Kind index
+    const kindEntries = factoriesByKind.get(kind.toLowerCase()) ?? [];
+    kindEntries.push(registration);
+    factoriesByKind.set(kind.toLowerCase(), kindEntries);
+    // Semantic alias index
+    if (registration.semanticAliases) {
+        for (const alias of registration.semanticAliases) {
+            const existing = semanticAliasIndex.get(alias.toLowerCase()) ?? [];
+            if (!existing.includes(kind.toLowerCase())) {
+                existing.push(kind.toLowerCase());
+            }
+            semanticAliasIndex.set(alias.toLowerCase(), existing);
+        }
+    }
+}
+/**
+ * Bulk-register multiple factories at once.
+ */
+export function registerFactories(registrations) {
+    for (const reg of registrations) {
+        registerFactory(reg);
+    }
+}
+/**
+ * Check whether `name` is a known factory function name.
+ * Replaces `KNOWN_FACTORY_NAMES.has(name)`.
+ */
+export function isKnownFactory(name) {
+    return factoriesByName.has(name);
+}
+/**
+ * Get the apiVersion + kind for a factory name.
+ * Replaces `FACTORY_KIND_MAP[name]`.
+ * Returns `undefined` if the factory is not registered.
+ */
+export function getKindInfo(factoryName) {
+    const reg = factoriesByName.get(factoryName);
+    if (!reg)
+        return undefined;
+    return { apiVersion: reg.apiVersion, kind: reg.kind };
+}
+/**
+ * Get candidate Kubernetes kinds for a semantic alias
+ * (e.g. 'database' → ['deployment', 'statefulset']).
+ * Replaces the hardcoded `semanticPatterns` in `findResourceByKey`.
+ * Returns lowercase kind strings, or `undefined` if no alias matches.
+ */
+export function getSemanticCandidateKinds(alias) {
+    const kinds = semanticAliasIndex.get(alias.toLowerCase());
+    return kinds && kinds.length > 0 ? kinds : undefined;
+}
+/**
+ * Get the full registration for a factory by name.
+ */
+export function getFactoryRegistration(factoryName) {
+    return factoriesByName.get(factoryName);
+}
+/**
+ * Get all registered factory names. Useful for diagnostics.
+ */
+export function getRegisteredFactoryNames() {
+    return [...factoriesByName.keys()];
+}
+/**
+ * Get the total number of registered factories.
+ */
+export function getRegisteredFactoryCount() {
+    return factoriesByName.size;
+}
+/**
+ * Clear the registry. Only used in tests.
+ */
+export function clearFactoryRegistry() {
+    factoriesByName.clear();
+    factoriesByKind.clear();
+    semanticAliasIndex.clear();
+}
+// ---------- Internal helpers ----------
+function removeFromKindIndex(reg) {
+    const kindKey = reg.kind.toLowerCase();
+    const entries = factoriesByKind.get(kindKey);
+    if (entries) {
+        const idx = entries.indexOf(reg);
+        if (idx >= 0)
+            entries.splice(idx, 1);
+        if (entries.length === 0)
+            factoriesByKind.delete(kindKey);
+    }
+}
+function removeFromSemanticIndex(reg) {
+    if (!reg.semanticAliases)
+        return;
+    for (const alias of reg.semanticAliases) {
+        const aliasKey = alias.toLowerCase();
+        const kinds = semanticAliasIndex.get(aliasKey);
+        if (kinds) {
+            const idx = kinds.indexOf(reg.kind.toLowerCase());
+            if (idx >= 0)
+                kinds.splice(idx, 1);
+            if (kinds.length === 0)
+                semanticAliasIndex.delete(aliasKey);
+        }
+    }
+}
+//# sourceMappingURL=factory-registry.js.map

package/dist/core/resources/factory-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-registry.js","sourceRoot":"","sources":["../../../src/core/resources/factory-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAqBH;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,EAA+B,CAAC;AAC/D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;AACjE,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAoB,CAAC,CAAC,2BAA2B;AAEnF,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAAC,YAAiC;IAC/D,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC;IAE3C,qDAAqD;IACrD,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,GAAG,EAAE,CAAC;QACR,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACzB,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE/C,aAAa;IACb,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAClE,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,CAAC;IAErD,uBAAuB;IACvB,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC3C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACpC,CAAC;YACD,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAA6C;IAC7E,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,eAAe,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,OAAO,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,eAAe,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,eAAe,CAAC,KAAK,EAAE,CAAC;IACxB,eAAe,CAAC,KAAK,EAAE,CAAC;IACxB,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,yCAAyC;AAEzC,SAAS,mBAAmB,CAAC,GAAwB;IACnD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAwB;IACvD,IAAI,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO;IACjC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAClD,IAAI,GAAG,IAAI,CAAC;gBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/resources/id.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Resource Identifier Generation
+ *
+ * Deterministic and random resource ID generation for Kro resource entries
+ * and deployment tracking keys.
+ */
+import type { CelExpression, KubernetesRef } from '../types/common.js';
+import type { KubernetesResource } from '../types/kubernetes.js';
+/**
+ * Resolve the resource graph identifier for a resource, using the standard
+ * fallback chain:
+ *
+ * 1. `resource.id` — explicit graph ID set by the user or by {@link createResource}
+ * 2. `resource.metadata?.name` — Kubernetes name (fallback for ad-hoc resources)
+ * 3. `fallback` — caller-provided default (defaults to `'unknown'`)
+ *
+ * This centralises a pattern that was previously duplicated across 6+ call sites.
+ *
+ * @see {@link KubernetesResource.id} for full documentation of the `id` field semantics.
+ */
+export declare function getResourceId(resource: Pick<KubernetesResource, 'id' | 'metadata'>, fallback?: string): string;
+/**
+ * Generate a deterministic resource graph identifier from resource metadata.
+ *
+ * Produces a camelCase ID suitable for use as a Kro resource entry identifier
+ * and CEL expression target.  The result is stable across invocations for the
+ * same inputs, enabling GitOps workflows.
+ *
+ * @throws {ValidationError} If `name` is a {@link KubernetesRef} or {@link CelExpression}
+ *   (dynamic names cannot produce static identifiers — provide an explicit `id` instead).
+ * @throws {ValidationError} If `name` contains template expressions (`${...}` or `{{...}}`).
+ *
+ * @example
+ * ```ts
+ * generateDeterministicResourceId('Deployment', 'my-app')         // → 'deploymentMyApp'
+ * generateDeterministicResourceId('Service', 'my-deployment-svc') // → 'myDeploymentSvc' (kind already in name)
+ * ```
+ */
+export declare function generateDeterministicResourceId(kind: string, name: string | KubernetesRef<unknown> | CelExpression<unknown>, _namespace?: string): string;
+/**
+ * Generate a unique resource ID (legacy random version for development).
+ */
+export declare function generateResourceId(name?: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/core/resources/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/core/resources/id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,UAAU,CAAC,EACrD,QAAQ,SAAY,GACnB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9D,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA8CR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/dist/core/resources/id.js

@@ -0,0 +1,78 @@
+/**
+ * Resource Identifier Generation
+ *
+ * Deterministic and random resource ID generation for Kro resource entries
+ * and deployment tracking keys.
+ */
+import { toCamelCase } from '../../utils/string.js';
+import { isCelExpression, isKubernetesRef } from '../../utils/type-guards.js';
+import { ValidationError } from '../errors.js';
+/**
+ * Resolve the resource graph identifier for a resource, using the standard
+ * fallback chain:
+ *
+ * 1. `resource.id` — explicit graph ID set by the user or by {@link createResource}
+ * 2. `resource.metadata?.name` — Kubernetes name (fallback for ad-hoc resources)
+ * 3. `fallback` — caller-provided default (defaults to `'unknown'`)
+ *
+ * This centralises a pattern that was previously duplicated across 6+ call sites.
+ *
+ * @see {@link KubernetesResource.id} for full documentation of the `id` field semantics.
+ */
+export function getResourceId(resource, fallback = 'unknown') {
+    return resource.id || resource.metadata?.name || fallback;
+}
+/**
+ * Generate a deterministic resource graph identifier from resource metadata.
+ *
+ * Produces a camelCase ID suitable for use as a Kro resource entry identifier
+ * and CEL expression target.  The result is stable across invocations for the
+ * same inputs, enabling GitOps workflows.
+ *
+ * @throws {ValidationError} If `name` is a {@link KubernetesRef} or {@link CelExpression}
+ *   (dynamic names cannot produce static identifiers — provide an explicit `id` instead).
+ * @throws {ValidationError} If `name` contains template expressions (`${...}` or `{{...}}`).
+ *
+ * @example
+ * ```ts
+ * generateDeterministicResourceId('Deployment', 'my-app')         // → 'deploymentMyApp'
+ * generateDeterministicResourceId('Service', 'my-deployment-svc') // → 'myDeploymentSvc' (kind already in name)
+ * ```
+ */
+export function generateDeterministicResourceId(kind, name, _namespace) {
+    const cleanKind = kind.toLowerCase().replace(/[^a-zA-Z0-9]/g, '');
+    if (isKubernetesRef(name)) {
+        throw new ValidationError(`Cannot generate deterministic resource ID for ${kind} with KubernetesRef name. ` +
+            `Please provide an explicit 'id' field in the resource config, e.g.: ` +
+            `simple.Deployment({ name: schema.spec.name, image: 'nginx', id: 'my-deployment' })`, kind, 'unknown', 'name');
+    }
+    if (isCelExpression(name)) {
+        throw new ValidationError(`Cannot generate deterministic resource ID for ${kind} with CEL expression name. ` +
+            `Please provide an explicit 'id' field in the resource config, e.g.: ` +
+            `simple.Deployment({ name: Cel.expr('my-', schema.spec.name), image: 'nginx', id: 'my-deployment' })`, kind, 'unknown', 'name');
+    }
+    const nameStr = name;
+    if (nameStr.includes('${') || nameStr.includes('{{') || nameStr.includes('__KUBERNETES_REF_')) {
+        throw new ValidationError(`Cannot generate deterministic resource ID for ${kind} with dynamic name: "${nameStr}". ` +
+            `When using schema references (e.g., spec.name) in resource names, ` +
+            `please provide an explicit 'id' in the resource factory options, e.g.: ` +
+            `simple.${kind}({ name: \`\${spec.name}-db\`, id: 'myDatabase' })`, kind, nameStr, 'name');
+    }
+    // If the name already contains the kind, just use the name
+    if (nameStr.toLowerCase().includes(cleanKind)) {
+        return toCamelCase(nameStr);
+    }
+    // Otherwise, prefix with kind for clarity
+    return toCamelCase(`${cleanKind}-${nameStr}`);
+}
+/**
+ * Generate a unique resource ID (legacy random version for development).
+ */
+export function generateResourceId(name) {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return name
+        ? `${name.replace(/[^a-zA-Z0-9-]/g, '')}-${timestamp}-${random}`
+        : `resource-${timestamp}-${random}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/core/resources/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../src/core/resources/id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAqD,EACrD,QAAQ,GAAG,SAAS;IAEpB,OAAO,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,QAAQ,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAY,EACZ,IAA8D,EAC9D,UAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAElE,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CACvB,iDAAiD,IAAI,4BAA4B;YAC/E,sEAAsE;YACtE,oFAAoF,EACtF,IAAI,EACJ,SAAS,EACT,MAAM,CACP,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CACvB,iDAAiD,IAAI,6BAA6B;YAChF,sEAAsE;YACtE,qGAAqG,EACvG,IAAI,EACJ,SAAS,EACT,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAc,CAAC;IAE/B,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,eAAe,CACvB,iDAAiD,IAAI,wBAAwB,OAAO,KAAK;YACvF,oEAAoE;YACpE,yEAAyE;YACzE,UAAU,IAAI,oDAAoD,EACpE,IAAI,EACJ,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,0CAA0C;IAC1C,OAAO,WAAW,CAAC,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI;QACT,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE;QAChE,CAAC,CAAC,YAAY,SAAS,IAAI,MAAM,EAAE,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Resource Utilities
+ */
+export type { FactoryRegistration } from './factory-registry.js';
+export { clearFactoryRegistry, getFactoryRegistration, getKindInfo, getRegisteredFactoryCount, getRegisteredFactoryNames, getSemanticCandidateKinds, isKnownFactory, registerFactories, registerFactory, } from './factory-registry.js';
+export { generateDeterministicResourceId, generateResourceId, getResourceId, } from './id.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,EAClB,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/core/resources/index.js

@@ -0,0 +1,6 @@
+/**
+ * Resource Utilities
+ */
+export { clearFactoryRegistry, getFactoryRegistration, getKindInfo, getRegisteredFactoryCount, getRegisteredFactoryNames, getSemanticCandidateKinds, isKnownFactory, registerFactories, registerFactory, } from './factory-registry.js';
+export { generateDeterministicResourceId, generateResourceId, getResourceId, } from './id.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,EAClB,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/core/runtime-patches/crd-patcher.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CRD Patcher Utilities
+ *
+ * Provides utilities to patch existing CRDs in a Kubernetes cluster to fix
+ * schema validation issues that occur with newer Kubernetes versions (1.33+).
+ *
+ * This is useful when CRDs were installed before the schema fix was available,
+ * and you need to update them without deleting and recreating.
+ */
+import type * as k8s from '@kubernetes/client-node';
+/**
+ * Check if a CRD needs the schema fix
+ */
+export declare function crdNeedsSchemaFix(crd: unknown): boolean;
+/**
+ * Patch a CRD in the cluster to fix schema validation issues
+ *
+ * @param kubeConfig - Kubernetes configuration
+ * @param crdName - Name of the CRD to patch (e.g., 'helmreleases.helm.toolkit.fluxcd.io')
+ * @returns true if the CRD was patched, false if no patch was needed
+ */
+export declare function patchCRDSchema(kubeConfig: k8s.KubeConfig, crdName: string): Promise<boolean>;
+/**
+ * Patch all Flux CRDs that need the schema fix
+ *
+ * @param kubeConfig - Kubernetes configuration
+ * @returns Number of CRDs that were patched
+ */
+export declare function patchFluxCRDSchemas(kubeConfig: k8s.KubeConfig): Promise<number>;
+//# sourceMappingURL=crd-patcher.d.ts.map