typekro 0.5.0 → 0.7.0

package/dist/factories/cnpg/resources/cluster.js

@@ -0,0 +1,123 @@
+/**
+ * CloudNativePG Cluster Factory
+ *
+ * Creates a CNPG Cluster resource representing a PostgreSQL cluster
+ * managed by the CloudNativePG operator.
+ */
+import { createConditionBasedReadinessEvaluator } from '../../../core/readiness/index.js';
+import { createResource } from '../../shared.js';
+/**
+ * Known CNPG cluster phase strings.
+ *
+ * These are human-readable strings from the CNPG operator status.phase field.
+ * Extracted as constants for maintainability — if CNPG changes these strings
+ * in a future operator release, updates are centralized here.
+ */
+export const CNPG_CLUSTER_PHASES = {
+    HEALTHY: 'Cluster in healthy state',
+    SETTING_UP_PRIMARY: 'Setting up primary',
+    CREATING_REPLICA: 'Creating replica',
+    FAILING_OVER: 'Failing over',
+    SWITCHOVER: 'Switchover in progress',
+};
+/** Base condition-based evaluator for Cluster Ready condition. */
+const baseClusterEvaluator = createConditionBasedReadinessEvaluator({ kind: 'Cluster' });
+/**
+ * Cluster Readiness Evaluator
+ *
+ * Checks both the standard Ready condition and the CNPG-specific `phase` field.
+ * CNPG clusters report phase as a human-readable string rather than a standard
+ * Kubernetes condition in some cases.
+ */
+function clusterReadinessEvaluator(liveResource) {
+    const resource = liveResource;
+    const status = resource?.status;
+    if (!status) {
+        return {
+            ready: false,
+            message: 'Cluster has no status yet',
+            reason: 'StatusMissing',
+        };
+    }
+    const phase = status.phase;
+    if (phase === CNPG_CLUSTER_PHASES.HEALTHY) {
+        return {
+            ready: true,
+            message: `Cluster is healthy (${status.readyInstances ?? 0}/${status.instances ?? 0} instances ready)`,
+            reason: 'Healthy',
+        };
+    }
+    if (phase === CNPG_CLUSTER_PHASES.SETTING_UP_PRIMARY) {
+        return {
+            ready: false,
+            message: 'Cluster is setting up the primary instance',
+            reason: 'SettingUpPrimary',
+        };
+    }
+    if (phase === CNPG_CLUSTER_PHASES.CREATING_REPLICA) {
+        return {
+            ready: false,
+            message: `Creating replicas (${status.readyInstances ?? 0}/${status.instances ?? 0} ready)`,
+            reason: 'CreatingReplica',
+        };
+    }
+    if (phase === CNPG_CLUSTER_PHASES.FAILING_OVER || phase === CNPG_CLUSTER_PHASES.SWITCHOVER) {
+        return {
+            ready: false,
+            message: `Cluster is performing failover: ${phase}`,
+            reason: 'Failover',
+        };
+    }
+    // Fall back to condition-based evaluation for unknown phases
+    return baseClusterEvaluator(liveResource);
+}
+/**
+ * CloudNativePG Cluster Factory
+ *
+ * Creates a PostgreSQL cluster managed by the CNPG operator. Supports
+ * single-instance and multi-replica configurations with full backup,
+ * monitoring, and high-availability features.
+ *
+ * @param config - Cluster configuration following postgresql.cnpg.io/v1 API
+ * @returns Enhanced Cluster resource with readiness evaluation
+ *
+ * @example
+ * ```typescript
+ * const db = cluster({
+ *   name: 'my-database',
+ *   namespace: 'databases',
+ *   spec: {
+ *     instances: 3,
+ *     storage: { size: '50Gi', storageClass: 'gp3' },
+ *     postgresql: {
+ *       parameters: { shared_buffers: '256MB' },
+ *     },
+ *     bootstrap: {
+ *       initdb: { database: 'myapp', owner: 'myapp' },
+ *     },
+ *   },
+ *   id: 'primaryDatabase',
+ * });
+ * ```
+ */
+function createClusterResource(config) {
+    const fullConfig = {
+        ...config,
+        spec: {
+            ...config.spec,
+            instances: config.spec.instances ?? 1,
+        },
+    };
+    return createResource({
+        apiVersion: 'postgresql.cnpg.io/v1',
+        kind: 'Cluster',
+        metadata: {
+            name: fullConfig.name,
+            ...(fullConfig.namespace && { namespace: fullConfig.namespace }),
+        },
+        spec: fullConfig.spec,
+        ...(fullConfig.id && { id: fullConfig.id }),
+    }, { scope: 'namespaced' }).withReadinessEvaluator(clusterReadinessEvaluator);
+}
+export const cluster = createClusterResource;
+//# sourceMappingURL=cluster.js.map

package/dist/factories/cnpg/resources/cluster.js.map

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

package/dist/factories/cnpg/resources/helm.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CloudNativePG Helm Resource Factories
+ *
+ * Wrappers around the generic Helm factories with CNPG-specific defaults.
+ * Used by the cnpgBootstrap composition to install the operator.
+ */
+import type { Composable, Enhanced } from '../../../core/types/index.js';
+import { type HelmRepositorySpec, type HelmRepositoryStatus } from '../../helm/helm-repository.js';
+import type { HelmReleaseSpec, HelmReleaseStatus } from '../../helm/types.js';
+import type { CnpgHelmReleaseConfig, CnpgHelmRepositoryConfig } from '../types.js';
+/**
+ * Create a HelmRepository for the CloudNativePG chart repository.
+ *
+ * @param config - Repository configuration with CNPG-specific defaults
+ * @returns Enhanced HelmRepository resource
+ *
+ * @example
+ * ```typescript
+ * const repo = cnpgHelmRepository({
+ *   name: 'cnpg-repo',
+ *   namespace: 'flux-system',
+ *   id: 'cnpgHelmRepository',
+ * });
+ * ```
+ */
+export declare function cnpgHelmRepository(config: Composable<CnpgHelmRepositoryConfig>): Enhanced<HelmRepositorySpec, HelmRepositoryStatus>;
+/**
+ * Create a HelmRelease for the CloudNativePG operator.
+ *
+ * @param config - Release configuration with CNPG-specific defaults
+ * @returns Enhanced HelmRelease resource
+ *
+ * @example
+ * ```typescript
+ * const release = cnpgHelmRelease({
+ *   name: 'cnpg',
+ *   namespace: 'cnpg-system',
+ *   version: '0.23.0',
+ *   values: { crds: { create: true } },
+ *   id: 'cnpgHelmRelease',
+ * });
+ * ```
+ */
+export declare function cnpgHelmRelease(config: Composable<CnpgHelmReleaseConfig>): Enhanced<HelmReleaseSpec, HelmReleaseStatus>;
+//# sourceMappingURL=helm.d.ts.map

package/dist/factories/cnpg/resources/helm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helm.d.ts","sourceRoot":"","sources":["../../../../src/factories/cnpg/resources/helm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAQnF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,CAAC,wBAAwB,CAAC,GAC3C,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAUpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACxC,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAuB9C"}

package/dist/factories/cnpg/resources/helm.js

@@ -0,0 +1,78 @@
+/**
+ * CloudNativePG Helm Resource Factories
+ *
+ * Wrappers around the generic Helm factories with CNPG-specific defaults.
+ * Used by the cnpgBootstrap composition to install the operator.
+ */
+import { DEFAULT_FLUX_NAMESPACE } from '../../../core/config/defaults.js';
+import { createHelmRepositoryReadinessEvaluator, helmRepository, } from '../../helm/helm-repository.js';
+import { createLabeledHelmReleaseEvaluator } from '../../helm/readiness-evaluators.js';
+import { helmRelease } from '../../helm/helm-release.js';
+/** Default Helm chart repository URL for CloudNativePG. */
+const DEFAULT_CNPG_REPO_URL = 'https://cloudnative-pg.github.io/charts';
+/** Default chart version. */
+const DEFAULT_CNPG_VERSION = '0.23.0';
+/**
+ * Create a HelmRepository for the CloudNativePG chart repository.
+ *
+ * @param config - Repository configuration with CNPG-specific defaults
+ * @returns Enhanced HelmRepository resource
+ *
+ * @example
+ * ```typescript
+ * const repo = cnpgHelmRepository({
+ *   name: 'cnpg-repo',
+ *   namespace: 'flux-system',
+ *   id: 'cnpgHelmRepository',
+ * });
+ * ```
+ */
+export function cnpgHelmRepository(config) {
+    return helmRepository({
+        name: config.name || 'cnpg-repo',
+        namespace: config.namespace || DEFAULT_FLUX_NAMESPACE,
+        url: config.url || DEFAULT_CNPG_REPO_URL,
+        interval: config.interval || '5m',
+        ...(config.id && { id: config.id }),
+    }).withReadinessEvaluator(createHelmRepositoryReadinessEvaluator('CNPG'));
+}
+/**
+ * Create a HelmRelease for the CloudNativePG operator.
+ *
+ * @param config - Release configuration with CNPG-specific defaults
+ * @returns Enhanced HelmRelease resource
+ *
+ * @example
+ * ```typescript
+ * const release = cnpgHelmRelease({
+ *   name: 'cnpg',
+ *   namespace: 'cnpg-system',
+ *   version: '0.23.0',
+ *   values: { crds: { create: true } },
+ *   id: 'cnpgHelmRelease',
+ * });
+ * ```
+ */
+export function cnpgHelmRelease(config) {
+    // Pass values directly — the core proxy system handles serialization.
+    return helmRelease({
+        name: config.name,
+        namespace: config.namespace || 'cnpg-system',
+        chart: {
+            repository: DEFAULT_CNPG_REPO_URL,
+            name: 'cloudnative-pg',
+            version: config.version || DEFAULT_CNPG_VERSION,
+        },
+        sourceRef: {
+            name: config.repositoryName || 'cnpg-repo',
+            namespace: DEFAULT_FLUX_NAMESPACE,
+            kind: 'HelmRepository',
+        },
+        values: {
+            crds: { create: true },
+            ...(config.values || {}),
+        },
+        ...(config.id && { id: config.id }),
+    }).withReadinessEvaluator(createLabeledHelmReleaseEvaluator('CNPG'));
+}
+//# sourceMappingURL=helm.js.map

package/dist/factories/cnpg/resources/helm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helm.js","sourceRoot":"","sources":["../../../../src/factories/cnpg/resources/helm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EACL,sCAAsC,EACtC,cAAc,GAGf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD,2DAA2D;AAC3D,MAAM,qBAAqB,GAAG,yCAAyC,CAAC;AAExE,6BAA6B;AAC7B,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAEtC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA4C;IAE5C,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,WAAW;QAChC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,sBAAsB;QACrD,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,qBAAqB;QACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;QACjC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;KACpC,CAAC,CAAC,sBAAsB,CACvB,sCAAsC,CAAC,MAAM,CAAC,CACO,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAyC;IAEzC,sEAAsE;IACtE,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,aAAa;QAC5C,KAAK,EAAE;YACL,UAAU,EAAE,qBAAqB;YACjC,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,oBAAoB;SAChD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC,cAAc,IAAI,WAAW;YAC1C,SAAS,EAAE,sBAAsB;YACjC,IAAI,EAAE,gBAAgB;SACvB;QACD,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;YACtB,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;SACzB;QACD,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;KACpC,CAAC,CAAC,sBAAsB,CACvB,iCAAiC,CAAC,MAAM,CAAC,CACM,CAAC;AACpD,CAAC"}

package/dist/factories/cnpg/resources/index.d.ts

@@ -0,0 +1,6 @@
+export * from './cluster.js';
+export * from './backup.js';
+export * from './scheduled-backup.js';
+export * from './pooler.js';
+export * from './helm.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/cnpg/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/cnpg/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/factories/cnpg/resources/index.js

@@ -0,0 +1,6 @@
+export * from './cluster.js';
+export * from './backup.js';
+export * from './scheduled-backup.js';
+export * from './pooler.js';
+export * from './helm.js';
+//# sourceMappingURL=index.js.map

package/dist/factories/cnpg/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/factories/cnpg/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/factories/cnpg/resources/pooler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CloudNativePG Pooler Factory
+ *
+ * Creates a CNPG Pooler resource for PgBouncer connection pooling.
+ */
+import type { Composable, Enhanced } from '../../../core/types/index.js';
+import type { PoolerConfig, PoolerStatus } from '../types.js';
+/**
+ * CloudNativePG Pooler Factory
+ *
+ * Creates a PgBouncer connection pooler for a PostgreSQL cluster.
+ * Supports session and transaction pooling modes.
+ *
+ * @param config - Pooler configuration following postgresql.cnpg.io/v1 API
+ * @returns Enhanced Pooler resource with readiness evaluation
+ *
+ * @example
+ * ```typescript
+ * const pool = pooler({
+ *   name: 'my-db-pooler',
+ *   namespace: 'databases',
+ *   spec: {
+ *     cluster: { name: 'my-database' },
+ *     type: 'rw',
+ *     instances: 2,
+ *     pgbouncer: {
+ *       poolMode: 'transaction',
+ *       parameters: { default_pool_size: '25' },
+ *     },
+ *   },
+ *   id: 'dbPooler',
+ * });
+ * ```
+ */
+declare function createPoolerResource(config: Composable<PoolerConfig>): Enhanced<PoolerConfig['spec'], PoolerStatus>;
+export declare const pooler: typeof createPoolerResource;
+export {};
+//# sourceMappingURL=pooler.d.ts.map

package/dist/factories/cnpg/resources/pooler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pooler.d.ts","sourceRoot":"","sources":["../../../../src/factories/cnpg/resources/pooler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAkB,MAAM,8BAA8B,CAAC;AAEzF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgD9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,iBAAS,oBAAoB,CAC3B,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,GAC/B,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CA6B9C;AAED,eAAO,MAAM,MAAM,6BAAuB,CAAC"}

package/dist/factories/cnpg/resources/pooler.js

@@ -0,0 +1,97 @@
+/**
+ * CloudNativePG Pooler Factory
+ *
+ * Creates a CNPG Pooler resource for PgBouncer connection pooling.
+ */
+import { createResource } from '../../shared.js';
+/**
+ * Pooler Readiness Evaluator
+ *
+ * CNPG Pooler status varies by version. Some report `status.instances` and
+ * `status.conditions`, others only report `status.secrets` once configured.
+ * We check multiple signals:
+ *   1. `status.ready === true` (if available)
+ *   2. `status.instances >= 1` (if available)
+ *   3. `status.secrets` populated (PgBouncer configured and connected to cluster)
+ *   4. Condition-based fallback
+ */
+function poolerReadinessEvaluator(liveResource) {
+    const resource = liveResource;
+    const status = resource?.status;
+    if (!status) {
+        return { ready: false, message: 'Pooler has no status yet', reason: 'StatusMissing' };
+    }
+    // Explicit ready field
+    if (status.ready === true) {
+        return { ready: true, message: 'Pooler is ready', reason: 'Ready' };
+    }
+    // Instance count check
+    if (typeof status.instances === 'number' && status.instances >= 1) {
+        return { ready: true, message: `Pooler has ${status.instances} instance(s)`, reason: 'Ready' };
+    }
+    // Secrets populated = PgBouncer is configured and connected
+    if (status.secrets && typeof status.secrets === 'object' && Object.keys(status.secrets).length > 0) {
+        return { ready: true, message: 'Pooler secrets configured', reason: 'Ready' };
+    }
+    // Condition-based fallback
+    const readyCondition = status.conditions?.find((c) => c.type === 'Ready');
+    if (readyCondition?.status === 'True') {
+        return { ready: true, message: readyCondition.message || 'Pooler is ready', reason: 'Ready' };
+    }
+    if (readyCondition) {
+        return { ready: false, message: readyCondition.message || 'Pooler is not ready', reason: readyCondition.reason || 'NotReady' };
+    }
+    return { ready: false, message: 'Pooler status incomplete', reason: 'Unknown' };
+}
+/**
+ * CloudNativePG Pooler Factory
+ *
+ * Creates a PgBouncer connection pooler for a PostgreSQL cluster.
+ * Supports session and transaction pooling modes.
+ *
+ * @param config - Pooler configuration following postgresql.cnpg.io/v1 API
+ * @returns Enhanced Pooler resource with readiness evaluation
+ *
+ * @example
+ * ```typescript
+ * const pool = pooler({
+ *   name: 'my-db-pooler',
+ *   namespace: 'databases',
+ *   spec: {
+ *     cluster: { name: 'my-database' },
+ *     type: 'rw',
+ *     instances: 2,
+ *     pgbouncer: {
+ *       poolMode: 'transaction',
+ *       parameters: { default_pool_size: '25' },
+ *     },
+ *   },
+ *   id: 'dbPooler',
+ * });
+ * ```
+ */
+function createPoolerResource(config) {
+    const fullConfig = {
+        ...config,
+        spec: {
+            ...config.spec,
+            instances: config.spec.instances ?? 1,
+            pgbouncer: {
+                poolMode: 'session',
+                ...config.spec.pgbouncer,
+            },
+        },
+    };
+    return createResource({
+        apiVersion: 'postgresql.cnpg.io/v1',
+        kind: 'Pooler',
+        metadata: {
+            name: fullConfig.name,
+            ...(fullConfig.namespace && { namespace: fullConfig.namespace }),
+        },
+        spec: fullConfig.spec,
+        ...(fullConfig.id && { id: fullConfig.id }),
+    }, { scope: 'namespaced' }).withReadinessEvaluator(poolerReadinessEvaluator);
+}
+export const pooler = createPoolerResource;
+//# sourceMappingURL=pooler.js.map

package/dist/factories/cnpg/resources/pooler.js.map

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

package/dist/factories/cnpg/resources/scheduled-backup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CloudNativePG ScheduledBackup Factory
+ *
+ * Creates a CNPG ScheduledBackup resource for cron-based automated backups.
+ */
+import type { Composable, Enhanced } from '../../../core/types/index.js';
+import type { ScheduledBackupConfig, ScheduledBackupStatus } from '../types.js';
+/**
+ * CloudNativePG ScheduledBackup Factory
+ *
+ * Creates a cron-scheduled backup for a PostgreSQL cluster.
+ * Uses robfig/cron format with seconds: 'second minute hour day month day-of-week'.
+ *
+ * @param config - ScheduledBackup configuration following postgresql.cnpg.io/v1 API
+ * @returns Enhanced ScheduledBackup resource with readiness evaluation
+ *
+ * @example
+ * ```typescript
+ * const nightlyBackup = scheduledBackup({
+ *   name: 'nightly-backup',
+ *   namespace: 'databases',
+ *   spec: {
+ *     cluster: { name: 'my-database' },
+ *     schedule: '0 0 2 * * *',
+ *     immediate: true,
+ *     backupOwnerReference: 'cluster',
+ *   },
+ *   id: 'nightlyBackup',
+ * });
+ * ```
+ */
+declare function createScheduledBackupResource(config: Composable<ScheduledBackupConfig>): Enhanced<ScheduledBackupConfig['spec'], ScheduledBackupStatus>;
+export declare const scheduledBackup: typeof createScheduledBackupResource;
+export {};
+//# sourceMappingURL=scheduled-backup.d.ts.map

package/dist/factories/cnpg/resources/scheduled-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-backup.d.ts","sourceRoot":"","sources":["../../../../src/factories/cnpg/resources/scheduled-backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAkB,MAAM,8BAA8B,CAAC;AAEzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AA6BhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,6BAA6B,CACpC,MAAM,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACxC,QAAQ,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC,CAiBhE;AAED,eAAO,MAAM,eAAe,sCAAgC,CAAC"}

package/dist/factories/cnpg/resources/scheduled-backup.js

@@ -0,0 +1,68 @@
+/**
+ * CloudNativePG ScheduledBackup Factory
+ *
+ * Creates a CNPG ScheduledBackup resource for cron-based automated backups.
+ */
+import { createConditionBasedReadinessEvaluator } from '../../../core/readiness/index.js';
+import { createResource } from '../../shared.js';
+/** Base condition-based evaluator. */
+const baseEvaluator = createConditionBasedReadinessEvaluator({ kind: 'ScheduledBackup' });
+/**
+ * ScheduledBackup Readiness Evaluator
+ *
+ * Checks standard Ready condition. If no conditions exist, checks whether
+ * the schedule has been evaluated (lastScheduleTime) as a proxy for readiness.
+ */
+function scheduledBackupReadinessEvaluator(liveResource) {
+    const result = baseEvaluator(liveResource);
+    // If conditions are missing but the schedule is running, consider it ready
+    if (!result.ready && result.reason === 'ConditionsMissing') {
+        const resource = liveResource;
+        if (resource?.status?.lastScheduleTime) {
+            return {
+                ready: true,
+                message: `Schedule is active, last run: ${resource.status.lastScheduleTime}`,
+                reason: 'ScheduleActive',
+            };
+        }
+    }
+    return result;
+}
+/**
+ * CloudNativePG ScheduledBackup Factory
+ *
+ * Creates a cron-scheduled backup for a PostgreSQL cluster.
+ * Uses robfig/cron format with seconds: 'second minute hour day month day-of-week'.
+ *
+ * @param config - ScheduledBackup configuration following postgresql.cnpg.io/v1 API
+ * @returns Enhanced ScheduledBackup resource with readiness evaluation
+ *
+ * @example
+ * ```typescript
+ * const nightlyBackup = scheduledBackup({
+ *   name: 'nightly-backup',
+ *   namespace: 'databases',
+ *   spec: {
+ *     cluster: { name: 'my-database' },
+ *     schedule: '0 0 2 * * *',
+ *     immediate: true,
+ *     backupOwnerReference: 'cluster',
+ *   },
+ *   id: 'nightlyBackup',
+ * });
+ * ```
+ */
+function createScheduledBackupResource(config) {
+    return createResource({
+        apiVersion: 'postgresql.cnpg.io/v1',
+        kind: 'ScheduledBackup',
+        metadata: {
+            name: config.name,
+            ...(config.namespace && { namespace: config.namespace }),
+        },
+        spec: config.spec,
+        ...(config.id && { id: config.id }),
+    }, { scope: 'namespaced' }).withReadinessEvaluator(scheduledBackupReadinessEvaluator);
+}
+export const scheduledBackup = createScheduledBackupResource;
+//# sourceMappingURL=scheduled-backup.js.map

package/dist/factories/cnpg/resources/scheduled-backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-backup.js","sourceRoot":"","sources":["../../../../src/factories/cnpg/resources/scheduled-backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sCAAsC,EAAE,MAAM,kCAAkC,CAAC;AAE1F,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,sCAAsC;AACtC,MAAM,aAAa,GAAG,sCAAsC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAE1F;;;;;GAKG;AACH,SAAS,iCAAiC,CAAC,YAAqB;IAC9D,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAE3C,2EAA2E;IAC3E,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,YAAqE,CAAC;QACvF,IAAI,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;YACvC,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,iCAAiC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBAC5E,MAAM,EAAE,gBAAgB;aACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAS,6BAA6B,CACpC,MAAyC;IAEzC,OAAO,cAAc,CACnB;QACE,UAAU,EAAE,uBAAuB;QACnC,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;SACzD;QACD,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;KACpC,EACD,EAAE,KAAK,EAAE,YAAY,EAAE,CACxB,CAAC,sBAAsB,CAAC,iCAAiC,CAGzD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,6BAA6B,CAAC"}