typekro 0.3.1 → 0.5.0

package/dist/core/composition/index.js

@@ -5,10 +5,7 @@
  * Kubernetes resource patterns. These functions wrap the lower-level
  * factory functions with sensible defaults and simplified configuration.
  */
-// Export composition functions
-export { createWebService } from './composition.js';
+export { createCompositionContext, getCurrentCompositionContext, registerDeploymentClosure, runInStatusBuilderContext, runWithCompositionContext, } from './context.js';
 // Export imperative composition pattern
 export { kubernetesComposition } from './imperative.js';
-// Export TypeKro runtime bootstrap composition
-export { typeKroRuntimeBootstrap } from './typekro-runtime/index.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/composition/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,+BAA+B;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,wCAAwC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAOxD,+CAA+C;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/composition/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,wCAAwC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/composition-debugger.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Debugging utilities for composition execution
+ *
+ * Extracted from errors.ts to break the circular dependency:
+ *   errors.ts -> logging/index.ts -> logging/config.ts -> errors.ts
+ *
+ * CompositionDebugger depends on logging (getComponentLogger), which
+ * depends on config, which depends on TypeKroError. Keeping it in
+ * errors.ts forced errors.ts to import from logging, creating the cycle.
+ */
+/**
+ * Enable debug mode for composition execution
+ */
+declare function enableDebugMode(): void;
+/**
+ * Disable debug mode
+ */
+declare function disableDebugMode(): void;
+/**
+ * Check if debug mode is enabled
+ */
+declare function isDebugEnabled(): boolean;
+/**
+ * Add a debug log entry
+ */
+declare function log(phase: string, message: string, context?: Record<string, unknown>): void;
+/**
+ * Get all debug logs
+ */
+declare function getDebugLogs(): string[];
+/**
+ * Clear debug logs
+ */
+declare function clearDebugLogs(): void;
+/**
+ * Create a debug summary for composition execution
+ */
+declare function createDebugSummary(compositionName: string, resourceCount: number, executionTimeMs: number, statusFields: string[]): string;
+/**
+ * Log resource registration
+ */
+declare function logResourceRegistration(resourceId: string, resourceKind: string, factoryName: string): void;
+/**
+ * Log composition execution start
+ */
+declare function logCompositionStart(compositionName: string): void;
+/**
+ * Log composition execution end
+ */
+declare function logCompositionEnd(compositionName: string, resourceCount: number, statusFields: string[]): void;
+/**
+ * Log status object validation
+ */
+declare function logStatusValidation(compositionName: string, statusObject: any, validationResult: 'success' | 'failure', issues?: string[]): void;
+/**
+ * Log performance metrics
+ */
+declare function logPerformanceMetrics(phase: string, startTime: number, endTime: number, additionalMetrics?: Record<string, unknown>): void;
+/**
+ * Debugging utilities for composition execution.
+ * Provides debug mode toggling, structured logging, and performance tracking.
+ */
+export declare const CompositionDebugger: {
+    readonly enableDebugMode: typeof enableDebugMode;
+    readonly disableDebugMode: typeof disableDebugMode;
+    readonly isDebugEnabled: typeof isDebugEnabled;
+    readonly log: typeof log;
+    readonly getDebugLogs: typeof getDebugLogs;
+    readonly clearDebugLogs: typeof clearDebugLogs;
+    readonly createDebugSummary: typeof createDebugSummary;
+    readonly logResourceRegistration: typeof logResourceRegistration;
+    readonly logCompositionStart: typeof logCompositionStart;
+    readonly logCompositionEnd: typeof logCompositionEnd;
+    readonly logStatusValidation: typeof logStatusValidation;
+    readonly logPerformanceMetrics: typeof logPerformanceMetrics;
+};
+export {};
+//# sourceMappingURL=composition-debugger.d.ts.map

package/dist/core/composition-debugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-debugger.d.ts","sourceRoot":"","sources":["../../src/core/composition-debugger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH;;GAEG;AACH,iBAAS,eAAe,IAAI,IAAI,CAG/B;AAED;;GAEG;AACH,iBAAS,gBAAgB,IAAI,IAAI,CAGhC;AAED;;GAEG;AACH,iBAAS,cAAc,IAAI,OAAO,CAEjC;AAED;;GAEG;AACH,iBAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWpF;AAED;;GAEG;AACH,iBAAS,YAAY,IAAI,MAAM,EAAE,CAEhC;AAED;;GAEG;AACH,iBAAS,cAAc,IAAI,IAAI,CAE9B;AAED;;GAEG;AACH,iBAAS,kBAAkB,CACzB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,CAcR;AAED;;GAEG;AACH,iBAAS,uBAAuB,CAC9B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,IAAI,CAKN;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED;;GAEG;AACH,iBAAS,iBAAiB,CACxB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EAAE,GACrB,IAAI,CAMN;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAC1B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,GAAG,EACjB,gBAAgB,EAAE,SAAS,GAAG,SAAS,EACvC,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,IAAI,CAMN;AAED;;GAEG;AACH,iBAAS,qBAAqB,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,IAAI,CAMN;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAatB,CAAC"}

package/dist/core/composition-debugger.js

@@ -0,0 +1,142 @@
+/**
+ * Debugging utilities for composition execution
+ *
+ * Extracted from errors.ts to break the circular dependency:
+ *   errors.ts -> logging/index.ts -> logging/config.ts -> errors.ts
+ *
+ * CompositionDebugger depends on logging (getComponentLogger), which
+ * depends on config, which depends on TypeKroError. Keeping it in
+ * errors.ts forced errors.ts to import from logging, creating the cycle.
+ */
+import { getComponentLogger } from './logging/index.js';
+const compositionLogger = getComponentLogger('composition-debugger');
+let debugMode = false;
+let debugLog = [];
+/**
+ * Enable debug mode for composition execution
+ */
+function enableDebugMode() {
+    debugMode = true;
+    debugLog = [];
+}
+/**
+ * Disable debug mode
+ */
+function disableDebugMode() {
+    debugMode = false;
+    debugLog = [];
+}
+/**
+ * Check if debug mode is enabled
+ */
+function isDebugEnabled() {
+    return debugMode;
+}
+/**
+ * Add a debug log entry
+ */
+function log(phase, message, context) {
+    if (!debugMode)
+        return;
+    const timestamp = new Date().toISOString();
+    const contextStr = context ? ` | Context: ${JSON.stringify(context)}` : '';
+    const logEntry = `[${timestamp}] ${phase}: ${message}${contextStr}`;
+    debugLog.push(logEntry);
+    // Also log via structured logger at debug level
+    compositionLogger.debug(logEntry, { phase, ...(context ?? {}) });
+}
+/**
+ * Get all debug logs
+ */
+function getDebugLogs() {
+    return [...debugLog];
+}
+/**
+ * Clear debug logs
+ */
+function clearDebugLogs() {
+    debugLog = [];
+}
+/**
+ * Create a debug summary for composition execution
+ */
+function createDebugSummary(compositionName, resourceCount, executionTimeMs, statusFields) {
+    const summary = [
+        `=== Composition Debug Summary ===`,
+        `Composition: ${compositionName}`,
+        `Execution Time: ${executionTimeMs}ms`,
+        `Resources Created: ${resourceCount}`,
+        `Status Fields: ${statusFields.join(', ')}`,
+        ``,
+        `=== Debug Log ===`,
+        ...debugLog,
+        `=== End Debug Summary ===`,
+    ];
+    return summary.join('\n');
+}
+/**
+ * Log resource registration
+ */
+function logResourceRegistration(resourceId, resourceKind, factoryName) {
+    log('RESOURCE_REGISTRATION', `Registered resource '${resourceId}'`, {
+        resourceKind,
+        factoryName,
+    });
+}
+/**
+ * Log composition execution start
+ */
+function logCompositionStart(compositionName) {
+    log('COMPOSITION_START', `Starting composition execution`, {
+        compositionName,
+    });
+}
+/**
+ * Log composition execution end
+ */
+function logCompositionEnd(compositionName, resourceCount, statusFields) {
+    log('COMPOSITION_END', `Completed composition execution`, {
+        compositionName,
+        resourceCount,
+        statusFields,
+    });
+}
+/**
+ * Log status object validation
+ */
+function logStatusValidation(compositionName, statusObject, validationResult, issues) {
+    log('STATUS_VALIDATION', `Status validation ${validationResult}`, {
+        compositionName,
+        statusObjectKeys: Object.keys(statusObject || {}),
+        issues,
+    });
+}
+/**
+ * Log performance metrics
+ */
+function logPerformanceMetrics(phase, startTime, endTime, additionalMetrics) {
+    const duration = endTime - startTime;
+    log('PERFORMANCE', `${phase} completed in ${duration}ms`, {
+        duration,
+        ...additionalMetrics,
+    });
+}
+/**
+ * Debugging utilities for composition execution.
+ * Provides debug mode toggling, structured logging, and performance tracking.
+ */
+export const CompositionDebugger = {
+    enableDebugMode,
+    disableDebugMode,
+    isDebugEnabled,
+    log,
+    getDebugLogs,
+    clearDebugLogs,
+    createDebugSummary,
+    logResourceRegistration,
+    logCompositionStart,
+    logCompositionEnd,
+    logStatusValidation,
+    logPerformanceMetrics,
+};
+//# sourceMappingURL=composition-debugger.js.map

package/dist/core/composition-debugger.js.map

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

package/dist/core/config/defaults.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Centralized default timeout constants for TypeKro.
+ *
+ * All timeout values are in milliseconds. These replace the previously
+ * scattered magic numbers (30000, 60000, 300000, 600000) throughout
+ * the codebase with self-documenting named constants.
+ */
+/** Default timeout for overall deployment operations (5 minutes) */
+export declare const DEFAULT_DEPLOYMENT_TIMEOUT = 300000;
+/** Default timeout for readiness polling / resource resolution (30 seconds) */
+export declare const DEFAULT_READINESS_TIMEOUT = 30000;
+/** Default timeout for RGD (ResourceGraphDefinition) deployment (1 minute) */
+export declare const DEFAULT_RGD_TIMEOUT = 60000;
+/** Default timeout for Kro custom-resource instance readiness (10 minutes) */
+export declare const DEFAULT_KRO_INSTANCE_TIMEOUT = 600000;
+/** Default timeout for HTTP read operations — GET/LIST (30 seconds) */
+export declare const DEFAULT_HTTP_READ_TIMEOUT = 30000;
+/** Default timeout for cluster readiness checks (30 seconds) */
+export declare const DEFAULT_CLUSTER_READY_TIMEOUT = 30000;
+/** Default timeout for HTTP write operations — POST/PUT/PATCH (2 minutes) */
+export declare const DEFAULT_HTTP_WRITE_TIMEOUT = 120000;
+/** Default timeout for HTTP delete operations (3 minutes) */
+export declare const DEFAULT_HTTP_DELETE_TIMEOUT = 180000;
+/** Default timeout for HTTP watch connections (1 hour) */
+export declare const DEFAULT_HTTP_WATCH_TIMEOUT = 3600000;
+/** Default maximum retries for operations that can be retried (3 attempts) */
+export declare const DEFAULT_MAX_RETRIES = 3;
+/** Default base delay for exponential backoff retries (1 second) */
+export declare const DEFAULT_RETRY_BASE_DELAY = 1000;
+/** Default multiplier for exponential backoff (doubles each retry) */
+export declare const DEFAULT_BACKOFF_MULTIPLIER = 2;
+/** Maximum retry backoff delay (30 seconds) */
+export declare const DEFAULT_MAX_RETRY_DELAY = 30000;
+/** Maximum reconnection delay for event monitors (30 seconds) */
+export declare const DEFAULT_RECONNECT_MAX_DELAY = 30000;
+/** Standard poll interval for readiness/status checks (2 seconds) */
+export declare const DEFAULT_POLL_INTERVAL = 2000;
+/** Fast poll interval for time-sensitive checks like deletion confirmation (1 second) */
+export declare const DEFAULT_FAST_POLL_INTERVAL = 1000;
+/** Maximum backoff delay for readiness polling (10 seconds) */
+export declare const DEFAULT_READINESS_MAX_BACKOFF = 10000;
+/** Short delay after delete-before-recreate on 409 conflict (500ms) */
+export declare const DEFAULT_CONFLICT_RETRY_DELAY = 500;
+/** Status cache TTL (30 seconds) */
+export declare const DEFAULT_STATUS_CACHE_TTL = 30000;
+/** Maximum timeout for status hydration — capped at 60 seconds */
+export declare const DEFAULT_HYDRATION_TIMEOUT_CAP = 60000;
+/** Timeout for namespace/resource deletion waits (30 seconds) */
+export declare const DEFAULT_DELETE_TIMEOUT = 30000;
+/** Default timeout for CRD readiness / establishment (5 minutes) */
+export declare const DEFAULT_CRD_READY_TIMEOUT = 300000;
+/** Default timeout for CRD JSON schema patching (30 seconds) */
+export declare const DEFAULT_CRD_PATCH_TIMEOUT = 30000;
+/** Default timeout for waiting on resource readiness in resolver (30 seconds) */
+export declare const DEFAULT_RESOURCE_READY_TIMEOUT = 30000;
+/** Maximum simultaneous watch connections for event monitoring */
+export declare const DEFAULT_MAX_WATCH_CONNECTIONS = 10;
+/** Maximum reconnection attempts before giving up */
+export declare const DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;
+/** Jitter factor for reconnection backoff (0.0 - 1.0) */
+export declare const DEFAULT_RECONNECT_JITTER_FACTOR = 0.2;
+/** Watch timeout in seconds for K8s API watch calls */
+export declare const DEFAULT_WATCH_TIMEOUT_SECONDS = 5;
+/** Maximum events per second before rate limiting */
+export declare const DEFAULT_MAX_EVENTS_PER_SECOND = 50;
+/** Default event batch size for batch processing */
+export declare const DEFAULT_EVENT_BATCH_SIZE = 10;
+/** Deduplication window for event filtering (seconds) */
+export declare const DEFAULT_DEDUPLICATION_WINDOW_SECONDS = 60;
+/** Maximum tracked events per resource */
+export declare const DEFAULT_MAX_EVENTS_PER_RESOURCE = 100;
+/** Maximum entries in the expression cache */
+export declare const DEFAULT_CACHE_MAX_ENTRIES = 1000;
+/** Maximum memory (MB) for the expression cache */
+export declare const DEFAULT_CACHE_MAX_MEMORY_MB = 50;
+/** Time-to-live for expression cache entries (5 minutes) */
+export declare const DEFAULT_CACHE_TTL_MS = 300000;
+/** Maximum size of status objects in debug logs (bytes) */
+export declare const DEFAULT_MAX_STATUS_OBJECT_SIZE = 1024;
+/** Default timeout for status query operations (10 seconds) */
+export declare const DEFAULT_STATUS_QUERY_TIMEOUT = 10000;
+/** Default namespace for Flux-based Helm resources (HelmRepository, HelmRelease) */
+export declare const DEFAULT_FLUX_NAMESPACE = "flux-system";
+/**
+ * Well-known Helm repository URL patterns mapped to their canonical sourceRef names.
+ *
+ * When a HelmRelease config doesn't include an explicit `sourceRef`, the factory
+ * checks this map before falling back to generic URL-path extraction. Add entries
+ * here to support additional well-known repositories without hardcoding detection
+ * logic in individual factory functions.
+ *
+ * Keys are substring patterns matched against `chart.repository` via `String.includes()`.
+ */
+export declare const WELL_KNOWN_HELM_REPOSITORIES: ReadonlyMap<string, string>;
+/** Maximum recursion depth for object traversal (circular reference protection) */
+export declare const DEFAULT_MAX_RECURSION_DEPTH = 50;
+/** Maximum depth for expression/proxy analysis traversal */
+export declare const DEFAULT_MAX_ANALYSIS_DEPTH = 10;
+/** Expected duration for "early" hydration phase fields (5 seconds) */
+export declare const DEFAULT_EARLY_HYDRATION_DURATION = 5000;
+/** Expected duration for "late" hydration phase fields (30 seconds) */
+export declare const DEFAULT_LATE_HYDRATION_DURATION = 30000;
+/** Maximum recursion depth for optionality analysis */
+export declare const DEFAULT_MAX_OPTIONALITY_DEPTH = 5;
+/** Maximum allowed YAML content size in bytes (10 MB) */
+export declare const DEFAULT_MAX_YAML_CONTENT_SIZE = 10485760;
+/** Maximum directory recursion depth for directory walking (prevents symlink loops / deep nesting) */
+export declare const DEFAULT_MAX_DIRECTORY_DEPTH = 20;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/core/config/defaults.d.ts.map

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

package/dist/core/config/defaults.js

@@ -0,0 +1,150 @@
+/**
+ * Centralized default timeout constants for TypeKro.
+ *
+ * All timeout values are in milliseconds. These replace the previously
+ * scattered magic numbers (30000, 60000, 300000, 600000) throughout
+ * the codebase with self-documenting named constants.
+ */
+// =============================================================================
+// DEPLOYMENT TIMEOUTS
+// =============================================================================
+/** Default timeout for overall deployment operations (5 minutes) */
+export const DEFAULT_DEPLOYMENT_TIMEOUT = 300_000;
+/** Default timeout for readiness polling / resource resolution (30 seconds) */
+export const DEFAULT_READINESS_TIMEOUT = 30_000;
+/** Default timeout for RGD (ResourceGraphDefinition) deployment (1 minute) */
+export const DEFAULT_RGD_TIMEOUT = 60_000;
+/** Default timeout for Kro custom-resource instance readiness (10 minutes) */
+export const DEFAULT_KRO_INSTANCE_TIMEOUT = 600_000;
+// =============================================================================
+// HTTP & NETWORK TIMEOUTS
+// =============================================================================
+/** Default timeout for HTTP read operations — GET/LIST (30 seconds) */
+export const DEFAULT_HTTP_READ_TIMEOUT = 30_000;
+/** Default timeout for cluster readiness checks (30 seconds) */
+export const DEFAULT_CLUSTER_READY_TIMEOUT = 30_000;
+/** Default timeout for HTTP write operations — POST/PUT/PATCH (2 minutes) */
+export const DEFAULT_HTTP_WRITE_TIMEOUT = 120_000;
+/** Default timeout for HTTP delete operations (3 minutes) */
+export const DEFAULT_HTTP_DELETE_TIMEOUT = 180_000;
+/** Default timeout for HTTP watch connections (1 hour) */
+export const DEFAULT_HTTP_WATCH_TIMEOUT = 3_600_000;
+// =============================================================================
+// RETRY & BACKOFF LIMITS
+// =============================================================================
+/** Default maximum retries for operations that can be retried (3 attempts) */
+export const DEFAULT_MAX_RETRIES = 3;
+/** Default base delay for exponential backoff retries (1 second) */
+export const DEFAULT_RETRY_BASE_DELAY = 1_000;
+/** Default multiplier for exponential backoff (doubles each retry) */
+export const DEFAULT_BACKOFF_MULTIPLIER = 2;
+/** Maximum retry backoff delay (30 seconds) */
+export const DEFAULT_MAX_RETRY_DELAY = 30_000;
+/** Maximum reconnection delay for event monitors (30 seconds) */
+export const DEFAULT_RECONNECT_MAX_DELAY = 30_000;
+// =============================================================================
+// POLL INTERVALS
+// =============================================================================
+/** Standard poll interval for readiness/status checks (2 seconds) */
+export const DEFAULT_POLL_INTERVAL = 2_000;
+/** Fast poll interval for time-sensitive checks like deletion confirmation (1 second) */
+export const DEFAULT_FAST_POLL_INTERVAL = 1_000;
+/** Maximum backoff delay for readiness polling (10 seconds) */
+export const DEFAULT_READINESS_MAX_BACKOFF = 10_000;
+/** Short delay after delete-before-recreate on 409 conflict (500ms) */
+export const DEFAULT_CONFLICT_RETRY_DELAY = 500;
+// =============================================================================
+// CACHE & HYDRATION TIMEOUTS
+// =============================================================================
+/** Status cache TTL (30 seconds) */
+export const DEFAULT_STATUS_CACHE_TTL = 30_000;
+/** Maximum timeout for status hydration — capped at 60 seconds */
+export const DEFAULT_HYDRATION_TIMEOUT_CAP = 60_000;
+/** Timeout for namespace/resource deletion waits (30 seconds) */
+export const DEFAULT_DELETE_TIMEOUT = 30_000;
+// =============================================================================
+// CRD TIMEOUTS
+// =============================================================================
+/** Default timeout for CRD readiness / establishment (5 minutes) */
+export const DEFAULT_CRD_READY_TIMEOUT = 300_000;
+/** Default timeout for CRD JSON schema patching (30 seconds) */
+export const DEFAULT_CRD_PATCH_TIMEOUT = 30_000;
+/** Default timeout for waiting on resource readiness in resolver (30 seconds) */
+export const DEFAULT_RESOURCE_READY_TIMEOUT = 30_000;
+// =============================================================================
+// EVENT MONITORING
+// =============================================================================
+/** Maximum simultaneous watch connections for event monitoring */
+export const DEFAULT_MAX_WATCH_CONNECTIONS = 10;
+/** Maximum reconnection attempts before giving up */
+export const DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;
+/** Jitter factor for reconnection backoff (0.0 - 1.0) */
+export const DEFAULT_RECONNECT_JITTER_FACTOR = 0.2;
+/** Watch timeout in seconds for K8s API watch calls */
+export const DEFAULT_WATCH_TIMEOUT_SECONDS = 5;
+/** Maximum events per second before rate limiting */
+export const DEFAULT_MAX_EVENTS_PER_SECOND = 50;
+/** Default event batch size for batch processing */
+export const DEFAULT_EVENT_BATCH_SIZE = 10;
+/** Deduplication window for event filtering (seconds) */
+export const DEFAULT_DEDUPLICATION_WINDOW_SECONDS = 60;
+/** Maximum tracked events per resource */
+export const DEFAULT_MAX_EVENTS_PER_RESOURCE = 100;
+// =============================================================================
+// EXPRESSION CACHE
+// =============================================================================
+/** Maximum entries in the expression cache */
+export const DEFAULT_CACHE_MAX_ENTRIES = 1_000;
+/** Maximum memory (MB) for the expression cache */
+export const DEFAULT_CACHE_MAX_MEMORY_MB = 50;
+/** Time-to-live for expression cache entries (5 minutes) */
+export const DEFAULT_CACHE_TTL_MS = 300_000;
+// =============================================================================
+// STATUS & DEBUG
+// =============================================================================
+/** Maximum size of status objects in debug logs (bytes) */
+export const DEFAULT_MAX_STATUS_OBJECT_SIZE = 1_024;
+/** Default timeout for status query operations (10 seconds) */
+export const DEFAULT_STATUS_QUERY_TIMEOUT = 10_000;
+// =============================================================================
+// KUBERNETES NAMESPACE DEFAULTS
+// =============================================================================
+/** Default namespace for Flux-based Helm resources (HelmRepository, HelmRelease) */
+export const DEFAULT_FLUX_NAMESPACE = 'flux-system';
+/**
+ * Well-known Helm repository URL patterns mapped to their canonical sourceRef names.
+ *
+ * When a HelmRelease config doesn't include an explicit `sourceRef`, the factory
+ * checks this map before falling back to generic URL-path extraction. Add entries
+ * here to support additional well-known repositories without hardcoding detection
+ * logic in individual factory functions.
+ *
+ * Keys are substring patterns matched against `chart.repository` via `String.includes()`.
+ */
+export const WELL_KNOWN_HELM_REPOSITORIES = new Map([
+    ['bitnami', 'bitnami'],
+]);
+// =============================================================================
+// RECURSION LIMITS
+// =============================================================================
+/** Maximum recursion depth for object traversal (circular reference protection) */
+export const DEFAULT_MAX_RECURSION_DEPTH = 50;
+/** Maximum depth for expression/proxy analysis traversal */
+export const DEFAULT_MAX_ANALYSIS_DEPTH = 10;
+// =============================================================================
+// OPTIONALITY / HYDRATION PHASE DURATIONS
+// =============================================================================
+/** Expected duration for "early" hydration phase fields (5 seconds) */
+export const DEFAULT_EARLY_HYDRATION_DURATION = 5_000;
+/** Expected duration for "late" hydration phase fields (30 seconds) */
+export const DEFAULT_LATE_HYDRATION_DURATION = 30_000;
+/** Maximum recursion depth for optionality analysis */
+export const DEFAULT_MAX_OPTIONALITY_DEPTH = 5;
+// =============================================================================
+// SECURITY LIMITS
+// =============================================================================
+/** Maximum allowed YAML content size in bytes (10 MB) */
+export const DEFAULT_MAX_YAML_CONTENT_SIZE = 10_485_760;
+/** Maximum directory recursion depth for directory walking (prevents symlink loops / deep nesting) */
+export const DEFAULT_MAX_DIRECTORY_DEPTH = 20;
+//# sourceMappingURL=defaults.js.map

package/dist/core/config/defaults.js.map

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

package/dist/core/config/env.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Centralized environment variable configuration
+ *
+ * Provides helpers for environment checks that are used across multiple modules.
+ * Logging and Kubernetes API env vars are intentionally NOT centralized here —
+ * they are already well-organized in their own modules.
+ */
+/** @returns true if running in a test environment (NODE_ENV=test or VITEST=true) */
+export declare function isTestEnvironment(): boolean;
+/** @returns true if TYPEKRO_DEBUG is enabled */
+export declare function isDebugMode(): boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/core/config/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/core/config/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oFAAoF;AACpF,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,gDAAgD;AAChD,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/core/config/env.js

@@ -0,0 +1,16 @@
+/**
+ * Centralized environment variable configuration
+ *
+ * Provides helpers for environment checks that are used across multiple modules.
+ * Logging and Kubernetes API env vars are intentionally NOT centralized here —
+ * they are already well-organized in their own modules.
+ */
+/** @returns true if running in a test environment (NODE_ENV=test or VITEST=true) */
+export function isTestEnvironment() {
+    return process.env.NODE_ENV === 'test' || process.env.VITEST === 'true';
+}
+/** @returns true if TYPEKRO_DEBUG is enabled */
+export function isDebugMode() {
+    return process.env.TYPEKRO_DEBUG === 'true';
+}
+//# sourceMappingURL=env.js.map

package/dist/core/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/core/config/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oFAAoF;AACpF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC;AAC1E,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,3 @@
+export * from './defaults.js';
+export { isDebugMode, isTestEnvironment } from './env.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/core/config/index.js

@@ -0,0 +1,3 @@
+export * from './defaults.js';
+export { isDebugMode, isTestEnvironment } from './env.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/core/constants/brands.d.ts

@@ -1,42 +1,9 @@
 /**
  * Brand symbols for TypeKro internal types
  *
- * Using Symbol.for() ensures consistent brand checking across modules
- * and prevents property name collisions.
+ * Re-exported from `src/shared/brands.ts` for backward compatibility.
+ * New code within `src/utils/` should import directly from `../../shared/brands.js`
+ * to maintain the clean dependency direction: `shared/ <-- utils/ <-- core/`.
  */
-/**
- * Brand symbol for KubernetesRef objects
- */
-export declare const KUBERNETES_REF_BRAND: unique symbol;
-/**
- * Brand symbol for CelExpression objects
- */
-export declare const CEL_EXPRESSION_BRAND: unique symbol;
-/**
- * Brand symbol for MixedTemplate objects
- */
-export declare const MIXED_TEMPLATE_BRAND: unique symbol;
-/**
- * Type-safe brand checking utilities
- */
-export declare const BrandChecks: {
-    /**
-     * Check if an object has the KubernetesRef brand
-     */
-    isKubernetesRef(obj: unknown): obj is {
-        [KUBERNETES_REF_BRAND]: true;
-    };
-    /**
-     * Check if an object has the CelExpression brand
-     */
-    isCelExpression(obj: unknown): obj is {
-        [CEL_EXPRESSION_BRAND]: true;
-    };
-    /**
-     * Check if an object has the MixedTemplate brand
-     */
-    isMixedTemplate(obj: unknown): obj is {
-        [MIXED_TEMPLATE_BRAND]: true;
-    };
-};
+export { CALLABLE_COMPOSITION_BRAND, CEL_EXPRESSION_BRAND, KUBERNETES_REF_BRAND, MIXED_TEMPLATE_BRAND, NESTED_COMPOSITION_BRAND, } from '../../shared/brands.js';
 //# sourceMappingURL=brands.d.ts.map

package/dist/core/constants/brands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brands.d.ts","sourceRoot":"","sources":["../../../src/core/constants/brands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;yBACkB,OAAO,GAAG,GAAG,IAAI;QAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAA;KAAE;IAStE;;OAEG;yBACkB,OAAO,GAAG,GAAG,IAAI;QAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAA;KAAE;IAItE;;OAEG;yBACkB,OAAO,GAAG,GAAG,IAAI;QAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAA;KAAE;CAGvE,CAAC"}
+{"version":3,"file":"brands.d.ts","sourceRoot":"","sources":["../../../src/core/constants/brands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC"}