typekro 0.3.1 → 0.4.0

package/dist/core/kubernetes/errors.js

@@ -0,0 +1,298 @@
+/**
+ * Kubernetes Error Handling Utilities
+ *
+ * Centralized error handling for Kubernetes API errors.
+ * Supports both the old request-based errors (0.x) and new fetch-based errors (1.x+).
+ *
+ * This module provides consistent error handling across the codebase,
+ * making it easier to handle API errors and prepare for future client upgrades.
+ */
+import { getComponentLogger } from '../logging/index.js';
+const logger = getComponentLogger('kubernetes-errors');
+/**
+ * Extract the HTTP status code from a Kubernetes API error.
+ *
+ * Handles multiple error structures from different client versions:
+ * - Direct statusCode property (0.x style)
+ * - Nested response.statusCode (1.x+ fetch style)
+ * - Nested body.code (some error responses)
+ *
+ * @param error - The error object to extract status code from
+ * @returns The HTTP status code, or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.read(resource);
+ * } catch (error) {
+ *   const statusCode = getErrorStatusCode(error);
+ *   if (statusCode === 404) {
+ *     // Handle not found
+ *   }
+ * }
+ * ```
+ */
+export function getErrorStatusCode(error) {
+    if (typeof error !== 'object' || error === null) {
+        return undefined;
+    }
+    const err = error;
+    // Try direct statusCode first (0.x style and some 1.x errors)
+    if (typeof err.statusCode === 'number') {
+        return err.statusCode;
+    }
+    // Try nested response.statusCode (1.x+ fetch style)
+    if (typeof err.response?.statusCode === 'number') {
+        return err.response.statusCode;
+    }
+    // Try nested body.code (some Kubernetes error responses)
+    if (typeof err.body?.code === 'number') {
+        return err.body.code;
+    }
+    // Log unexpected error shape at debug level for diagnostics
+    logger.debug('Could not extract status code from error', {
+        errorType: typeof error,
+        hasStatusCode: 'statusCode' in err,
+        hasResponse: 'response' in err,
+        hasBody: 'body' in err,
+        errorKeys: Object.keys(err),
+    });
+    return undefined;
+}
+/**
+ * Check if an error is a "Not Found" (404) error.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a 404 Not Found error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.read(resource);
+ * } catch (error) {
+ *   if (isNotFoundError(error)) {
+ *     console.log('Resource does not exist');
+ *   }
+ * }
+ * ```
+ */
+export function isNotFoundError(error) {
+    return getErrorStatusCode(error) === 404;
+}
+/**
+ * Check if an error is a "Conflict" (409) error.
+ *
+ * Conflict errors typically occur when:
+ * - Trying to create a resource that already exists
+ * - Optimistic locking fails due to resource version mismatch
+ *
+ * @param error - The error to check
+ * @returns true if the error is a 409 Conflict error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.create(resource);
+ * } catch (error) {
+ *   if (isConflictError(error)) {
+ *     console.log('Resource already exists');
+ *   }
+ * }
+ * ```
+ */
+export function isConflictError(error) {
+    return getErrorStatusCode(error) === 409;
+}
+/**
+ * HTTP status codes that are typically retryable.
+ * These indicate temporary issues that may resolve on retry.
+ */
+const RETRYABLE_STATUS_CODES = [
+    408, // Request Timeout
+    429, // Too Many Requests
+    500, // Internal Server Error
+    502, // Bad Gateway
+    503, // Service Unavailable
+    504, // Gateway Timeout
+];
+/**
+ * Check if an error is retryable.
+ *
+ * An error is considered retryable if:
+ * - It has a retryable HTTP status code (408, 429, 500, 502, 503, 504)
+ * - It's a network connectivity error (ECONNREFUSED, ENOTFOUND, ETIMEDOUT)
+ * - It's a fetch-related TypeError (network failure)
+ * - It's an AbortError (timeout)
+ *
+ * @param error - The error to check
+ * @returns true if the error is retryable
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.read(resource);
+ * } catch (error) {
+ *   if (isRetryableError(error)) {
+ *     // Retry the operation
+ *   } else {
+ *     // Don't retry, handle the error
+ *   }
+ * }
+ * ```
+ */
+export function isRetryableError(error) {
+    // Check for retryable HTTP status codes
+    const statusCode = getErrorStatusCode(error);
+    if (statusCode !== undefined && RETRYABLE_STATUS_CODES.includes(statusCode)) {
+        return true;
+    }
+    // Check for network errors by message content
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        // Network connectivity issues
+        if (message.includes('econnrefused') ||
+            message.includes('enotfound') ||
+            message.includes('etimedout') ||
+            message.includes('network error') ||
+            message.includes('socket hang up') ||
+            message.includes('connection reset')) {
+            return true;
+        }
+        // Fetch-related network errors (1.x+ client)
+        if (error instanceof TypeError && message.includes('fetch')) {
+            return true;
+        }
+        // Abort errors (timeout)
+        if (error.name === 'AbortError') {
+            return true;
+        }
+    }
+    // Check for DOMException AbortError (browser/Node.js fetch)
+    if (typeof error === 'object' &&
+        error !== null &&
+        'name' in error &&
+        error.name === 'AbortError') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Format a Kubernetes API error into a human-readable message.
+ *
+ * Extracts relevant information from the error and formats it consistently.
+ *
+ * @param error - The error to format
+ * @returns A formatted error message string
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.read(resource);
+ * } catch (error) {
+ *   console.error(formatKubernetesError(error));
+ *   // Output: "Kubernetes API error (404): Not Found - the resource does not exist"
+ * }
+ * ```
+ */
+export function formatKubernetesError(error) {
+    if (typeof error !== 'object' || error === null) {
+        return String(error);
+    }
+    const err = error;
+    const statusCode = getErrorStatusCode(error);
+    const parts = [];
+    // Add status code if available
+    if (statusCode !== undefined) {
+        parts.push(`Kubernetes API error (${statusCode})`);
+    }
+    else {
+        parts.push('Kubernetes API error');
+    }
+    // Add reason if available from body
+    if (err.body?.reason) {
+        parts.push(err.body.reason);
+    }
+    // Add message
+    if (err.body?.message) {
+        parts.push(err.body.message);
+    }
+    else if (err.message) {
+        parts.push(err.message);
+    }
+    return parts.join(': ');
+}
+/**
+ * Check if an error is an "Unauthorized" (401) error.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a 401 Unauthorized error
+ */
+export function isUnauthorizedError(error) {
+    return getErrorStatusCode(error) === 401;
+}
+/**
+ * Check if an error is a "Forbidden" (403) error.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a 403 Forbidden error
+ */
+export function isForbiddenError(error) {
+    return getErrorStatusCode(error) === 403;
+}
+/**
+ * Check if an error is a "Bad Request" (400) error.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a 400 Bad Request error
+ */
+export function isBadRequestError(error) {
+    return getErrorStatusCode(error) === 400;
+}
+/**
+ * Check if an error is a "Unprocessable Entity" (422) error.
+ *
+ * This typically indicates validation errors in the request body.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a 422 Unprocessable Entity error
+ */
+export function isValidationError(error) {
+    return getErrorStatusCode(error) === 422;
+}
+/**
+ * Extract the error reason from a Kubernetes API error.
+ *
+ * @param error - The error to extract reason from
+ * @returns The error reason string, or undefined if not available
+ */
+export function getErrorReason(error) {
+    if (typeof error !== 'object' || error === null) {
+        return undefined;
+    }
+    const err = error;
+    return err.body?.reason;
+}
+/**
+ * Extract detailed error information from a Kubernetes API error.
+ *
+ * @param error - The error to extract details from
+ * @returns An object containing all available error details
+ */
+export function getErrorDetails(error) {
+    if (typeof error !== 'object' || error === null) {
+        return {
+            statusCode: undefined,
+            reason: undefined,
+            message: String(error),
+            details: undefined,
+        };
+    }
+    const err = error;
+    return {
+        statusCode: getErrorStatusCode(error),
+        reason: err.body?.reason,
+        message: err.body?.message ?? err.message,
+        details: err.body?.details,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/kubernetes/errors.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Kubernetes Module
+ *
+ * Centralized exports for Kubernetes client functionality.
+ * This module provides:
+ * - Client provider for managing Kubernetes API clients
+ * - API utilities for common operations
+ * - Error handling utilities for consistent error management
+ */
+export { KubernetesClientProvider, createKubernetesClientProvider, createKubernetesClientProviderWithKubeConfig, getKubernetesClientProvider, getKubernetesApi, getKubeConfig, getCoreV1Api, getAppsV1Api, } from './client-provider.js';
+export type { KubernetesClientConfig, KubernetesApiConsumer, KubeConfigConsumer, RetryOptions, } from './client-provider.js';
+export { KubernetesApi } from './api.js';
+export { getErrorStatusCode, isNotFoundError, isConflictError, isRetryableError, formatKubernetesError, isUnauthorizedError, isForbiddenError, isBadRequestError, isValidationError, getErrorReason, getErrorDetails, } from './errors.js';
+export type { KubernetesApiError } from './errors.js';
+export { isKubernetesResponse, isKubernetesError, hasStatusCode, isKubernetesResource, hasBody, isKubernetesList, hasResourceVersion, } from './type-guards.js';
+export type { KubernetesResponse, KubernetesResourceShape, } from './type-guards.js';
+export { BunCompatibleHttpLibrary, isBunRuntime, getHttpLibraryForRuntime, } from './bun-http-library.js';
+export { createBunCompatibleApiClient, createBunCompatibleCoreV1Api, createBunCompatibleAppsV1Api, createBunCompatibleCustomObjectsApi, createBunCompatibleBatchV1Api, createBunCompatibleNetworkingV1Api, createBunCompatibleRbacAuthorizationV1Api, createBunCompatibleStorageV1Api, createBunCompatibleApiextensionsV1Api, createBunCompatibleKubernetesObjectApi, } from './bun-api-client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/kubernetes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,4CAA4C,EAC5C,2BAA2B,EAC3B,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,OAAO,EACP,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,mCAAmC,EACnC,6BAA6B,EAC7B,kCAAkC,EAClC,yCAAyC,EACzC,+BAA+B,EAC/B,qCAAqC,EACrC,sCAAsC,GACvC,MAAM,qBAAqB,CAAC"}

package/dist/core/kubernetes/index.js

@@ -0,0 +1,23 @@
+/**
+ * Kubernetes Module
+ *
+ * Centralized exports for Kubernetes client functionality.
+ * This module provides:
+ * - Client provider for managing Kubernetes API clients
+ * - API utilities for common operations
+ * - Error handling utilities for consistent error management
+ */
+// Client provider and configuration
+export { KubernetesClientProvider, createKubernetesClientProvider, createKubernetesClientProviderWithKubeConfig, getKubernetesClientProvider, getKubernetesApi, getKubeConfig, getCoreV1Api, getAppsV1Api, } from './client-provider.js';
+// API utilities
+export { KubernetesApi } from './api.js';
+// Error handling utilities
+export { getErrorStatusCode, isNotFoundError, isConflictError, isRetryableError, formatKubernetesError, isUnauthorizedError, isForbiddenError, isBadRequestError, isValidationError, getErrorReason, getErrorDetails, } from './errors.js';
+// Type guards
+export { isKubernetesResponse, isKubernetesError, hasStatusCode, isKubernetesResource, hasBody, isKubernetesList, hasResourceVersion, } from './type-guards.js';
+// Bun compatibility utilities
+// These provide workarounds for Bun's fetch TLS issues
+// See: https://github.com/oven-sh/bun/issues/10642
+export { BunCompatibleHttpLibrary, isBunRuntime, getHttpLibraryForRuntime, } from './bun-http-library.js';
+export { createBunCompatibleApiClient, createBunCompatibleCoreV1Api, createBunCompatibleAppsV1Api, createBunCompatibleCustomObjectsApi, createBunCompatibleBatchV1Api, createBunCompatibleNetworkingV1Api, createBunCompatibleRbacAuthorizationV1Api, createBunCompatibleStorageV1Api, createBunCompatibleApiextensionsV1Api, createBunCompatibleKubernetesObjectApi, } from './bun-api-client.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/kubernetes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oCAAoC;AACpC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,4CAA4C,EAC5C,2BAA2B,EAC3B,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAS9B,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AAIrB,cAAc;AACd,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,OAAO,EACP,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAO1B,8BAA8B;AAC9B,uDAAuD;AACvD,mDAAmD;AACnD,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,mCAAmC,EACnC,6BAA6B,EAC7B,kCAAkC,EAClC,yCAAyC,EACzC,+BAA+B,EAC/B,qCAAqC,EACrC,sCAAsC,GACvC,MAAM,qBAAqB,CAAC"}

package/dist/core/kubernetes/type-guards.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Kubernetes Type Guards
+ *
+ * Type guards for validating Kubernetes API response shapes.
+ * These guards help ensure type safety when working with API responses
+ * that may have different structures across client versions.
+ */
+import type { KubernetesApiError } from './errors.js';
+/**
+ * Interface representing a standard Kubernetes API response.
+ * The response typically contains a body property with the actual data.
+ */
+export interface KubernetesResponse<T> {
+    body: T;
+    response?: {
+        statusCode?: number;
+        headers?: Record<string, string>;
+    };
+}
+/**
+ * Interface representing a Kubernetes resource with standard metadata.
+ */
+export interface KubernetesResourceShape {
+    apiVersion?: string;
+    kind?: string;
+    metadata?: {
+        name?: string;
+        namespace?: string;
+        uid?: string;
+        resourceVersion?: string;
+        creationTimestamp?: string;
+        labels?: Record<string, string>;
+        annotations?: Record<string, string>;
+    };
+    spec?: unknown;
+    status?: unknown;
+}
+/**
+ * Check if a value is a Kubernetes API response with a body property.
+ *
+ * @param response - The value to check
+ * @returns true if the value is a KubernetesResponse
+ *
+ * @example
+ * ```typescript
+ * const result = await api.read(resource);
+ * if (isKubernetesResponse(result)) {
+ *   const resource = result.body;
+ * }
+ * ```
+ */
+export declare function isKubernetesResponse<T>(response: unknown): response is KubernetesResponse<T>;
+/**
+ * Check if an error is a Kubernetes API error with expected properties.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a KubernetesApiError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.read(resource);
+ * } catch (error) {
+ *   if (isKubernetesError(error)) {
+ *     console.log('Status:', error.statusCode);
+ *   }
+ * }
+ * ```
+ */
+export declare function isKubernetesError(error: unknown): error is KubernetesApiError;
+/**
+ * Check if an object has a statusCode property.
+ *
+ * @param obj - The object to check
+ * @returns true if the object has a numeric statusCode property
+ *
+ * @example
+ * ```typescript
+ * if (hasStatusCode(error)) {
+ *   console.log('HTTP Status:', error.statusCode);
+ * }
+ * ```
+ */
+export declare function hasStatusCode(obj: unknown): obj is {
+    statusCode: number;
+};
+/**
+ * Check if a value is a Kubernetes resource with standard shape.
+ *
+ * @param value - The value to check
+ * @returns true if the value has Kubernetes resource shape
+ *
+ * @example
+ * ```typescript
+ * if (isKubernetesResource(obj)) {
+ *   console.log('Kind:', obj.kind);
+ *   console.log('Name:', obj.metadata?.name);
+ * }
+ * ```
+ */
+export declare function isKubernetesResource(value: unknown): value is KubernetesResourceShape;
+/**
+ * Check if a value has a body property with a specific shape.
+ *
+ * @param value - The value to check
+ * @param bodyGuard - A type guard function to validate the body
+ * @returns true if the value has a body that passes the guard
+ *
+ * @example
+ * ```typescript
+ * if (hasBody(response, isKubernetesResource)) {
+ *   console.log('Resource:', response.body.kind);
+ * }
+ * ```
+ */
+export declare function hasBody<T>(value: unknown, bodyGuard: (body: unknown) => body is T): value is {
+    body: T;
+};
+/**
+ * Check if a value is a list response from the Kubernetes API.
+ *
+ * @param value - The value to check
+ * @returns true if the value is a Kubernetes list response
+ */
+export declare function isKubernetesList(value: unknown): value is {
+    items: unknown[];
+    metadata?: {
+        resourceVersion?: string;
+    };
+};
+/**
+ * Check if a response has a resourceVersion in its metadata.
+ *
+ * @param value - The value to check
+ * @returns true if the value has a resourceVersion
+ */
+export declare function hasResourceVersion(value: unknown): value is {
+    metadata: {
+        resourceVersion: string;
+    };
+};
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/core/kubernetes/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../../src/core/kubernetes/type-guards.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAMnC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAiB7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAOzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,uBAAuB,CAalC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,GACtC,KAAK,IAAI;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAOtB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAOxE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,QAAQ,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAYpD"}

package/dist/core/kubernetes/type-guards.js

@@ -0,0 +1,151 @@
+/**
+ * Kubernetes Type Guards
+ *
+ * Type guards for validating Kubernetes API response shapes.
+ * These guards help ensure type safety when working with API responses
+ * that may have different structures across client versions.
+ */
+/**
+ * Check if a value is a Kubernetes API response with a body property.
+ *
+ * @param response - The value to check
+ * @returns true if the value is a KubernetesResponse
+ *
+ * @example
+ * ```typescript
+ * const result = await api.read(resource);
+ * if (isKubernetesResponse(result)) {
+ *   const resource = result.body;
+ * }
+ * ```
+ */
+export function isKubernetesResponse(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        'body' in response);
+}
+/**
+ * Check if an error is a Kubernetes API error with expected properties.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a KubernetesApiError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.read(resource);
+ * } catch (error) {
+ *   if (isKubernetesError(error)) {
+ *     console.log('Status:', error.statusCode);
+ *   }
+ * }
+ * ```
+ */
+export function isKubernetesError(error) {
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    const err = error;
+    // Check for common Kubernetes error properties
+    return (typeof err.statusCode === 'number' ||
+        (typeof err.response === 'object' &&
+            err.response !== null &&
+            typeof err.response.statusCode === 'number') ||
+        (typeof err.body === 'object' &&
+            err.body !== null &&
+            typeof err.body.code === 'number'));
+}
+/**
+ * Check if an object has a statusCode property.
+ *
+ * @param obj - The object to check
+ * @returns true if the object has a numeric statusCode property
+ *
+ * @example
+ * ```typescript
+ * if (hasStatusCode(error)) {
+ *   console.log('HTTP Status:', error.statusCode);
+ * }
+ * ```
+ */
+export function hasStatusCode(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'statusCode' in obj &&
+        typeof obj.statusCode === 'number');
+}
+/**
+ * Check if a value is a Kubernetes resource with standard shape.
+ *
+ * @param value - The value to check
+ * @returns true if the value has Kubernetes resource shape
+ *
+ * @example
+ * ```typescript
+ * if (isKubernetesResource(obj)) {
+ *   console.log('Kind:', obj.kind);
+ *   console.log('Name:', obj.metadata?.name);
+ * }
+ * ```
+ */
+export function isKubernetesResource(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    // A Kubernetes resource should have at least apiVersion and kind
+    return ((typeof obj.apiVersion === 'string' || obj.apiVersion === undefined) &&
+        (typeof obj.kind === 'string' || obj.kind === undefined) &&
+        (typeof obj.metadata === 'object' || obj.metadata === undefined));
+}
+/**
+ * Check if a value has a body property with a specific shape.
+ *
+ * @param value - The value to check
+ * @param bodyGuard - A type guard function to validate the body
+ * @returns true if the value has a body that passes the guard
+ *
+ * @example
+ * ```typescript
+ * if (hasBody(response, isKubernetesResource)) {
+ *   console.log('Resource:', response.body.kind);
+ * }
+ * ```
+ */
+export function hasBody(value, bodyGuard) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'body' in value &&
+        bodyGuard(value.body));
+}
+/**
+ * Check if a value is a list response from the Kubernetes API.
+ *
+ * @param value - The value to check
+ * @returns true if the value is a Kubernetes list response
+ */
+export function isKubernetesList(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return Array.isArray(obj.items);
+}
+/**
+ * Check if a response has a resourceVersion in its metadata.
+ *
+ * @param value - The value to check
+ * @returns true if the value has a resourceVersion
+ */
+export function hasResourceVersion(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    if (typeof obj.metadata !== 'object' || obj.metadata === null) {
+        return false;
+    }
+    const metadata = obj.metadata;
+    return typeof metadata.resourceVersion === 'string';
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/core/kubernetes/type-guards.js.map

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

package/dist/core/logging/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/logging/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyD7E;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,aAAa,CAoC1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,aAAa,CAGf;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,aAA8B,CAAC;AAEpD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACtC,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACtC,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACtC,aAAa,CAEf"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/logging/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiE7E;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,aAAa,CAoC1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,aAAa,CAGf;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,aAA8B,CAAC;AAEpD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACtC,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACtC,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACtC,aAAa,CAEf"}