kustodian 1.0.0

package/dist/sources/index.js

@@ -0,0 +1,10 @@
+// Types
+// Cache
+export { cache_meta_schema, calculate_expiry, create_cache_manager, DEFAULT_TTL, is_expired, META_FILENAME, parse_ttl, TEMPLATES_DIRNAME, } from './cache/index.js';
+// Fetchers
+export { create_git_fetcher, create_http_fetcher, create_oci_fetcher, get_fetcher_for_source, } from './fetchers/index.js';
+// Template loader integration
+export { load_templates_from_sources, } from './loader.js';
+// Resolver
+export { create_source_resolver, DEFAULT_CACHE_DIR, } from './resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AAER,QAAQ;AACR,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,WAAW;AACX,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,8BAA8B;AAC9B,OAAO,EAGL,2BAA2B,GAE5B,MAAM,aAAa,CAAC;AAErB,WAAW;AACX,OAAO,EAEL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/sources/loader.d.ts

@@ -0,0 +1,34 @@
+import { type KustodianErrorType, type ResultType } from '../core/index.js';
+import { type LoadedTemplateType } from '../loader/index.js';
+import type { TemplateSourceType } from '../schema/index.js';
+import { type CreateResolverOptionsType } from './resolver.js';
+import type { FetchOptionsType, ResolvedSourceType } from './types.js';
+/**
+ * A loaded template with source information.
+ */
+export interface SourcedTemplateType extends LoadedTemplateType {
+    /** Name of the source this template came from */
+    source_name: string;
+}
+/**
+ * Result of loading templates from sources.
+ */
+export interface LoadedSourcesResultType {
+    /** All loaded templates from all sources */
+    templates: SourcedTemplateType[];
+    /** Successfully resolved sources */
+    resolved: ResolvedSourceType[];
+}
+/**
+ * Options for loading templates from sources.
+ */
+export interface LoadSourcesOptionsType extends FetchOptionsType, CreateResolverOptionsType {
+    /** Run fetches in parallel (default: true) */
+    parallel?: boolean;
+}
+/**
+ * Loads templates from all configured sources.
+ * Fetches from remote (or cache) and loads all template.yaml files found.
+ */
+export declare function load_templates_from_sources(sources: TemplateSourceType[], options?: LoadSourcesOptionsType): Promise<ResultType<LoadedSourcesResultType, KustodianErrorType>>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/sources/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/sources/loader.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAIhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,kBAAkB,EAAmC,MAAM,oBAAoB,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,KAAK,yBAAyB,EAA0B,MAAM,eAAe,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,oCAAoC;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB,EAAE,yBAAyB;IACzF,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAAE,EAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC,CA4ClE"}

package/dist/sources/loader.js

@@ -0,0 +1,89 @@
+import * as path from 'node:path';
+import { failure, is_success, success, } from '../core/index.js';
+import { list_directories, load_template } from '../loader/index.js';
+import { create_source_resolver } from './resolver.js';
+/**
+ * Loads templates from all configured sources.
+ * Fetches from remote (or cache) and loads all template.yaml files found.
+ */
+export async function load_templates_from_sources(sources, options) {
+    if (sources.length === 0) {
+        return success({ templates: [], resolved: [] });
+    }
+    // Fetch all sources
+    const resolver = create_source_resolver(options);
+    const fetch_result = await resolver.resolve_all(sources, options);
+    if (!fetch_result.success) {
+        return fetch_result;
+    }
+    // Load templates from each fetched source
+    const all_templates = [];
+    const errors = [];
+    for (const resolved of fetch_result.value) {
+        const templates_result = await load_templates_from_path(resolved.fetch_result.path);
+        if (is_success(templates_result)) {
+            // Add source name to each template
+            for (const loaded of templates_result.value) {
+                all_templates.push({
+                    ...loaded,
+                    source_name: resolved.source.name,
+                });
+            }
+        }
+        else {
+            errors.push(`${resolved.source.name}: ${templates_result.error.message}`);
+        }
+    }
+    if (errors.length > 0) {
+        return failure({
+            code: 'VALIDATION_ERROR',
+            message: `Failed to load templates from sources:\n${errors.join('\n')}`,
+        });
+    }
+    return success({
+        templates: all_templates,
+        resolved: fetch_result.value,
+    });
+}
+/**
+ * Loads all templates from a directory path.
+ * Looks for subdirectories containing template.yaml files.
+ */
+async function load_templates_from_path(source_path) {
+    // List all subdirectories that might be templates
+    const dirs_result = await list_directories(source_path);
+    if (!is_success(dirs_result)) {
+        // Check if this path itself is a template
+        const direct_result = await load_template(source_path);
+        if (is_success(direct_result)) {
+            return success([direct_result.value]);
+        }
+        return failure({
+            code: 'NOT_FOUND',
+            message: `No templates found in ${source_path}`,
+        });
+    }
+    const templates = [];
+    const errors = [];
+    for (const dir of dirs_result.value) {
+        const result = await load_template(dir);
+        if (is_success(result)) {
+            templates.push(result.value);
+        }
+        else {
+            // Only log errors for directories that look like templates
+            // (i.e., they have a template.yaml that failed validation)
+            if (result.error.code === 'SCHEMA_VALIDATION_ERROR') {
+                errors.push(`${path.basename(dir)}: ${result.error.message}`);
+            }
+        }
+    }
+    if (templates.length === 0 && errors.length > 0) {
+        return failure({
+            code: 'VALIDATION_ERROR',
+            message: `Failed to load templates:\n${errors.join('\n')}`,
+        });
+    }
+    return success(templates);
+}
+//# sourceMappingURL=loader.js.map

package/dist/sources/loader.js.map

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

package/dist/sources/resolver.d.ts

@@ -0,0 +1,17 @@
+import type { SourceResolverType } from './types.js';
+/**
+ * Default cache directory relative to project root.
+ */
+export declare const DEFAULT_CACHE_DIR = ".kustodian/templates-cache";
+/**
+ * Options for creating a source resolver.
+ */
+export interface CreateResolverOptionsType {
+    /** Base cache directory (defaults to .kustodian/templates-cache) */
+    cache_dir?: string;
+}
+/**
+ * Creates a source resolver instance.
+ */
+export declare function create_source_resolver(options?: CreateResolverOptionsType): SourceResolverType;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/sources/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/sources/resolver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,kBAAkB,CAI9F"}

package/dist/sources/resolver.js

@@ -0,0 +1,125 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { failure, success } from '../core/index.js';
+import { is_mutable_source } from '../schema/index.js';
+import { create_cache_manager } from './cache/index.js';
+import { get_fetcher_for_source } from './fetchers/index.js';
+/**
+ * Default cache directory relative to project root.
+ */
+export const DEFAULT_CACHE_DIR = '.kustodian/templates-cache';
+/**
+ * Creates a source resolver instance.
+ */
+export function create_source_resolver(options) {
+    const cache_dir = options?.cache_dir ?? path.join(process.cwd(), DEFAULT_CACHE_DIR);
+    const cache_manager = create_cache_manager(cache_dir);
+    return new SourceResolver(cache_manager);
+}
+class SourceResolver {
+    cache;
+    constructor(cache_manager) {
+        this.cache = cache_manager;
+    }
+    async resolve_all(sources, options) {
+        const parallel = options?.parallel ?? true;
+        if (parallel) {
+            const results = await Promise.all(sources.map((source) => this.resolve(source, options)));
+            // Check for first failure
+            const resolved = [];
+            for (const result of results) {
+                if (!result.success) {
+                    return failure(result.error);
+                }
+                resolved.push(result.value);
+            }
+            return success(resolved);
+        }
+        // Sequential execution
+        const resolved = [];
+        for (const source of sources) {
+            const result = await this.resolve(source, options);
+            if (!result.success) {
+                return failure(result.error);
+            }
+            resolved.push(result.value);
+        }
+        return success(resolved);
+    }
+    async resolve(source, options) {
+        const force_refresh = options?.force_refresh ?? false;
+        const fetcher = get_fetcher_for_source(source);
+        const mutable = is_mutable_source(source);
+        // Determine the version to fetch
+        const version = this.get_source_version(source);
+        // Check cache first (unless force refresh)
+        if (!force_refresh) {
+            const cached = await this.cache.get(source.name, version);
+            if (cached.success && cached.value) {
+                return success({
+                    source,
+                    fetch_result: {
+                        path: cached.value.path,
+                        version: cached.value.version,
+                        from_cache: true,
+                        fetched_at: cached.value.fetched_at,
+                    },
+                });
+            }
+        }
+        // Fetch from remote
+        const fetch_result = await fetcher.fetch(source, options);
+        if (!fetch_result.success) {
+            return fetch_result;
+        }
+        // Store in cache
+        const cache_result = await this.cache.put(source.name, fetcher.type, fetch_result.value.version, fetch_result.value.path, mutable, source.ttl);
+        if (!cache_result.success) {
+            // Log warning but don't fail - we have the content
+            console.warn(`Warning: Failed to cache source '${source.name}': ${cache_result.error.message}`);
+        }
+        // If caching succeeded, use the cached path (which is more stable)
+        const final_path = cache_result.success ? cache_result.value.path : fetch_result.value.path;
+        // Cleanup temp directory if we successfully cached
+        if (cache_result.success && fetch_result.value.path !== cache_result.value.path) {
+            await fs.rm(fetch_result.value.path, { recursive: true, force: true }).catch(() => { });
+        }
+        return success({
+            source,
+            fetch_result: {
+                path: final_path,
+                version: fetch_result.value.version,
+                from_cache: false,
+                fetched_at: fetch_result.value.fetched_at,
+            },
+        });
+    }
+    async update_all(sources) {
+        return this.resolve_all(sources, { force_refresh: true });
+    }
+    get_source_version(source) {
+        if (source.git) {
+            const ref = source.git.ref;
+            return ref.tag ?? ref.commit ?? ref.branch ?? 'unknown';
+        }
+        if (source.http) {
+            // Use checksum as version if available, otherwise use URL hash
+            return source.http.checksum ?? this.hash_url(source.http.url);
+        }
+        if (source.oci) {
+            return source.oci.digest ?? source.oci.tag ?? 'unknown';
+        }
+        return 'unknown';
+    }
+    hash_url(url) {
+        // Simple hash for URL-based versioning
+        let hash = 0;
+        for (let i = 0; i < url.length; i++) {
+            const char = url.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash;
+        }
+        return `url-${Math.abs(hash).toString(16)}`;
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/sources/resolver.js.map

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

package/dist/sources/types.d.ts

@@ -0,0 +1,151 @@
+import type { KustodianErrorType, ResultType } from '../core/index.js';
+import type { TemplateSourceType } from '../schema/index.js';
+/**
+ * Result of a successful fetch operation.
+ */
+export interface FetchResultType {
+    /** Absolute path to the fetched/extracted templates directory */
+    path: string;
+    /** Version/ref that was fetched (tag, commit, digest, etc.) */
+    version: string;
+    /** Whether this result came from cache */
+    from_cache: boolean;
+    /** Timestamp when this was fetched */
+    fetched_at: Date;
+}
+/**
+ * Options for fetching sources.
+ */
+export interface FetchOptionsType {
+    /** Force refresh, ignoring cache */
+    force_refresh?: boolean;
+    /** Target cache directory (defaults to .kustodian/templates-cache) */
+    cache_dir?: string;
+    /** Custom timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Version information from a remote source.
+ */
+export interface RemoteVersionType {
+    /** Version identifier (tag name, commit sha, etc.) */
+    version: string;
+    /** Content digest if available */
+    digest?: string;
+    /** Date of the version if available */
+    date?: Date;
+}
+/**
+ * Cache entry metadata.
+ */
+export interface CacheEntryType {
+    /** Source name from configuration */
+    source_name: string;
+    /** Source type: git, http, or oci */
+    source_type: 'git' | 'http' | 'oci';
+    /** Version/ref that was cached */
+    version: string;
+    /** Absolute path to cached content */
+    path: string;
+    /** When this was fetched */
+    fetched_at: Date;
+    /** When this expires (only for mutable refs) */
+    expires_at: Date | null;
+    /** Content checksum if available */
+    checksum?: string;
+}
+/**
+ * Template source fetcher interface.
+ * Each source type (git, http, oci) implements this interface.
+ */
+export interface SourceFetcherType {
+    /** Unique identifier for this fetcher type */
+    readonly type: 'git' | 'http' | 'oci';
+    /**
+     * Fetches templates from the source.
+     * Returns path to extracted templates directory.
+     */
+    fetch(source: TemplateSourceType, options?: FetchOptionsType): Promise<ResultType<FetchResultType, KustodianErrorType>>;
+    /**
+     * Lists available versions from the remote.
+     * For Git: tags and branches
+     * For OCI: tags
+     * For HTTP: not applicable (returns empty array)
+     */
+    list_versions(source: TemplateSourceType): Promise<ResultType<RemoteVersionType[], KustodianErrorType>>;
+    /**
+     * Determines if this source reference is mutable.
+     * Mutable refs (branches, 'latest' tag) need TTL-based refresh.
+     * Immutable refs (tags, commits, digests) can be cached forever.
+     */
+    is_mutable(source: TemplateSourceType): boolean;
+}
+/**
+ * Cache manager interface.
+ */
+export interface CacheManagerType {
+    /** Base cache directory */
+    readonly cache_dir: string;
+    /**
+     * Gets a cached entry if valid (not expired for mutable refs).
+     */
+    get(source_name: string, version: string): Promise<ResultType<CacheEntryType | null, KustodianErrorType>>;
+    /**
+     * Stores content in cache.
+     */
+    put(source_name: string, source_type: 'git' | 'http' | 'oci', version: string, content_path: string, mutable: boolean, ttl?: string): Promise<ResultType<CacheEntryType, KustodianErrorType>>;
+    /**
+     * Invalidates a specific cache entry.
+     * If version is omitted, invalidates all versions for the source.
+     */
+    invalidate(source_name: string, version?: string): Promise<ResultType<void, KustodianErrorType>>;
+    /**
+     * Clears all expired entries (mutable refs past their TTL).
+     * Returns the number of entries removed.
+     */
+    prune(): Promise<ResultType<number, KustodianErrorType>>;
+    /**
+     * Lists all cache entries.
+     */
+    list(): Promise<ResultType<CacheEntryType[], KustodianErrorType>>;
+    /**
+     * Gets total cache size in bytes.
+     */
+    size(): Promise<ResultType<number, KustodianErrorType>>;
+    /**
+     * Clears all cached content.
+     */
+    clear(): Promise<ResultType<void, KustodianErrorType>>;
+}
+/**
+ * Resolved source with fetch result.
+ */
+export interface ResolvedSourceType {
+    source: TemplateSourceType;
+    fetch_result: FetchResultType;
+}
+/**
+ * Source resolver options.
+ */
+export interface ResolverOptionsType extends FetchOptionsType {
+    /** Run fetches in parallel (default: true) */
+    parallel?: boolean;
+}
+/**
+ * Source resolver interface - main entry point for fetching templates.
+ */
+export interface SourceResolverType {
+    /**
+     * Resolves and fetches all template sources.
+     */
+    resolve_all(sources: TemplateSourceType[], options?: ResolverOptionsType): Promise<ResultType<ResolvedSourceType[], KustodianErrorType>>;
+    /**
+     * Resolves and fetches a single source.
+     */
+    resolve(source: TemplateSourceType, options?: FetchOptionsType): Promise<ResultType<ResolvedSourceType, KustodianErrorType>>;
+    /**
+     * Force updates all sources (ignores cache).
+     */
+    update_all(sources: TemplateSourceType[]): Promise<ResultType<ResolvedSourceType[], KustodianErrorType>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sources/types.d.ts.map

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

package/dist/sources/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "kustodian",
+  "version": "1.0.0",
+  "description": "A GitOps templating framework for Kubernetes with Flux CD",
+  "type": "module",
+  "packageManager": "bun@1.3.5",
+  "bin": {
+    "kustodian": "./dist/cli/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js"
+    },
+    "./k8s": {
+      "types": "./dist/k8s/index.d.ts",
+      "import": "./dist/k8s/index.js"
+    },
+    "./loader": {
+      "types": "./dist/loader/index.d.ts",
+      "import": "./dist/loader/index.js"
+    },
+    "./nodes": {
+      "types": "./dist/nodes/index.d.ts",
+      "import": "./dist/nodes/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js"
+    },
+    "./generator": {
+      "types": "./dist/generator/index.d.ts",
+      "import": "./dist/generator/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "import": "./dist/registry/index.js"
+    },
+    "./sources": {
+      "types": "./dist/sources/index.d.ts",
+      "import": "./dist/sources/index.js"
+    }
+  },
+  "files": ["dist", "package.json"],
+  "workspaces": ["plugins/*"],
+  "scripts": {
+    "postinstall": "for d in plugins/*/; do mkdir -p \"$d/node_modules\" && rm -rf \"$d/node_modules/kustodian\" && ln -s ../../.. \"$d/node_modules/kustodian\"; done",
+    "build": "tsc && turbo run build --filter='./plugins/*'",
+    "test": "bun test src/ tests/ plugins/",
+    "test:coverage": "bun test src/ tests/ plugins/ --coverage --coverage-reporter=lcov --coverage-dir=coverage",
+    "test:e2e": "bun test e2e/",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "fmt": "biome format --write .",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo coverage && turbo run clean --filter='./plugins/*'",
+    "generate-schemas": "bun run scripts/generate-json-schemas.ts"
+  },
+  "keywords": [
+    "kubernetes",
+    "gitops",
+    "flux",
+    "kustomize",
+    "templating",
+    "k0s",
+    "cluster-management"
+  ],
+  "author": "Luca Silverentand <luca@onezero.company>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lucasilverentand/kustodian.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "ora": "^9.0.0",
+    "semver": "^7.6.0",
+    "yaml": "^2.8.2",
+    "zod": "^3.25.30"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/bun": "^1.2.9",
+    "@types/semver": "^7.5.0",
+    "lefthook": "^2.0.15",
+    "turbo": "^2.7.5",
+    "typescript": "^5.8.3",
+    "zod-to-json-schema": "^3.25.1"
+  }
+}