kustodian 1.0.0

package/dist/schema/template.d.ts.map

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

package/dist/schema/template.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { api_version_schema, auth_config_schema, health_check_expr_schema, health_check_schema, metadata_schema, namespace_config_schema, substitution_schema, version_entry_schema, } from './common.js';
+/**
+ * Raw dependency reference to an external Flux Kustomization.
+ * Used for dependencies outside the kustodian-generated system.
+ */
+export const raw_dependency_ref_schema = z.object({
+    raw: z.object({
+        name: z.string().min(1),
+        namespace: z.string().min(1),
+    }),
+});
+/**
+ * Dependency reference - either a string or a raw reference object.
+ *
+ * Supports three formats:
+ * - Within-template: `database`
+ * - Cross-template: `secrets/doppler`
+ * - Raw external: `{ raw: { name: 'legacy-infrastructure', namespace: 'gitops-system' } }`
+ */
+export const dependency_ref_schema = z.union([z.string(), raw_dependency_ref_schema]);
+/**
+ * Preservation mode for disabled kustomizations.
+ *
+ * - none: Delete all resources when disabled
+ * - stateful: Keep PVCs, Secrets, and ConfigMaps (default, safe)
+ * - custom: Keep only specified resource types
+ */
+export const preservation_mode_schema = z.enum(['none', 'stateful', 'custom']);
+/**
+ * Preservation policy for a kustomization when disabled.
+ */
+export const preservation_policy_schema = z.object({
+    mode: preservation_mode_schema.default('stateful'),
+    keep_resources: z.array(z.string()).optional(),
+});
+/**
+ * A single kustomization within a template.
+ * Maps to a Flux Kustomization resource.
+ */
+export const kustomization_schema = z.object({
+    name: z.string().min(1),
+    path: z.string().min(1),
+    namespace: namespace_config_schema.optional(),
+    depends_on: z.array(dependency_ref_schema).optional(),
+    substitutions: z.array(substitution_schema).optional(),
+    health_checks: z.array(health_check_schema).optional(),
+    health_check_exprs: z.array(health_check_expr_schema).optional(),
+    prune: z.boolean().optional().default(true),
+    wait: z.boolean().optional().default(true),
+    timeout: z.string().optional(),
+    retry_interval: z.string().optional(),
+    preservation: preservation_policy_schema.optional(),
+    /** Auth configuration for SSO integration (processed by auth plugins) */
+    auth: auth_config_schema.optional(),
+});
+/**
+ * Node label requirement - requires specific labels to be present on cluster nodes.
+ */
+export const node_label_requirement_schema = z.object({
+    type: z.literal('nodeLabel'),
+    key: z.string().min(1),
+    value: z.string().optional(),
+    atLeast: z.number().int().positive().default(1),
+});
+/**
+ * Template requirement - validates cluster prerequisites before deployment.
+ * Currently supports node label requirements, extensible for future types.
+ */
+export const template_requirement_schema = z.discriminatedUnion('type', [
+    node_label_requirement_schema,
+]);
+/**
+ * Template specification containing kustomizations.
+ */
+export const template_spec_schema = z.object({
+    requirements: z.array(template_requirement_schema).optional(),
+    /** Template-level version tracking, shared across all kustomizations */
+    versions: z.array(version_entry_schema).optional(),
+    kustomizations: z.array(kustomization_schema).min(1),
+});
+/**
+ * Complete Template resource definition.
+ */
+export const template_schema = z.object({
+    apiVersion: api_version_schema,
+    kind: z.literal('Template'),
+    metadata: metadata_schema,
+    spec: template_spec_schema,
+});
+/**
+ * Validates a template object and returns the result.
+ */
+export function validate_template(data) {
+    return template_schema.safeParse(data);
+}
+//# sourceMappingURL=template.js.map

package/dist/schema/template.js.map

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

package/dist/sources/cache/index.d.ts

@@ -0,0 +1,9 @@
+import type { CacheManagerType } from '../types.js';
+export type { CacheManagerType } from '../types.js';
+export { type CacheMetaType, cache_meta_schema, META_FILENAME, TEMPLATES_DIRNAME, } from './metadata.js';
+export { calculate_expiry, DEFAULT_TTL, is_expired, parse_ttl } from './ttl.js';
+/**
+ * Creates a cache manager instance.
+ */
+export declare function create_cache_manager(cache_dir: string): CacheManagerType;
+//# sourceMappingURL=index.d.ts.map

package/dist/sources/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sources/cache/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,KAAK,aAAa,EAClB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAgBhF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAExE"}

package/dist/sources/cache/index.js

@@ -0,0 +1,278 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { Errors, failure, success, } from '../../core/index.js';
+import { META_FILENAME, TEMPLATES_DIRNAME, cache_meta_schema, } from './metadata.js';
+import { calculate_expiry, is_expired } from './ttl.js';
+export { cache_meta_schema, META_FILENAME, TEMPLATES_DIRNAME, } from './metadata.js';
+export { calculate_expiry, DEFAULT_TTL, is_expired, parse_ttl } from './ttl.js';
+/**
+ * Creates a safe directory name from a source name.
+ */
+function sanitize_name(name) {
+    return name.replace(/[^a-zA-Z0-9-_]/g, '_');
+}
+/**
+ * Creates a safe directory name from a version.
+ */
+function sanitize_version(version) {
+    return version.replace(/[^a-zA-Z0-9-_.]/g, '_');
+}
+/**
+ * Creates a cache manager instance.
+ */
+export function create_cache_manager(cache_dir) {
+    return new CacheManager(cache_dir);
+}
+class CacheManager {
+    cache_dir;
+    constructor(cache_dir) {
+        this.cache_dir = cache_dir;
+    }
+    get_entry_path(source_name, version) {
+        return path.join(this.cache_dir, sanitize_name(source_name), sanitize_version(version));
+    }
+    get_meta_path(source_name, version) {
+        return path.join(this.get_entry_path(source_name, version), META_FILENAME);
+    }
+    get_templates_path(source_name, version) {
+        return path.join(this.get_entry_path(source_name, version), TEMPLATES_DIRNAME);
+    }
+    async get(source_name, version) {
+        const meta_path = this.get_meta_path(source_name, version);
+        try {
+            const meta_content = await fs.readFile(meta_path, 'utf-8');
+            const meta_json = JSON.parse(meta_content);
+            const parse_result = cache_meta_schema.safeParse(meta_json);
+            if (!parse_result.success) {
+                return failure(Errors.cache_corrupt(meta_path));
+            }
+            const meta = parse_result.data;
+            const expires_at = meta.expires_at ? new Date(meta.expires_at) : null;
+            // Check if expired (only for mutable refs)
+            if (is_expired(expires_at)) {
+                return success(null);
+            }
+            const templates_path = this.get_templates_path(source_name, version);
+            // Verify templates directory exists
+            try {
+                await fs.access(templates_path);
+            }
+            catch {
+                return success(null);
+            }
+            const entry = {
+                source_name: meta.source_name,
+                source_type: meta.source_type,
+                version: meta.version,
+                path: templates_path,
+                fetched_at: new Date(meta.fetched_at),
+                expires_at,
+            };
+            if (meta.checksum) {
+                entry.checksum = meta.checksum;
+            }
+            return success(entry);
+        }
+        catch (error) {
+            // File doesn't exist - not an error, just no cache entry
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                return success(null);
+            }
+            return failure(Errors.cache_read_error(meta_path, error));
+        }
+    }
+    async put(source_name, source_type, version, content_path, mutable, ttl) {
+        const entry_path = this.get_entry_path(source_name, version);
+        const meta_path = this.get_meta_path(source_name, version);
+        const templates_path = this.get_templates_path(source_name, version);
+        try {
+            // Create directory structure
+            await fs.mkdir(entry_path, { recursive: true });
+            // Copy content to templates directory
+            await fs.cp(content_path, templates_path, { recursive: true });
+            const fetched_at = new Date();
+            const expires_at = calculate_expiry(mutable, ttl);
+            const meta = {
+                source_name,
+                source_type,
+                version,
+                fetched_at: fetched_at.toISOString(),
+                expires_at: expires_at?.toISOString() ?? null,
+            };
+            // Write metadata
+            await fs.writeFile(meta_path, JSON.stringify(meta, null, 2));
+            return success({
+                source_name,
+                source_type,
+                version,
+                path: templates_path,
+                fetched_at,
+                expires_at,
+            });
+        }
+        catch (error) {
+            return failure(Errors.cache_write_error(entry_path, error));
+        }
+    }
+    async invalidate(source_name, version) {
+        try {
+            if (version) {
+                // Invalidate specific version
+                const entry_path = this.get_entry_path(source_name, version);
+                await fs.rm(entry_path, { recursive: true, force: true });
+            }
+            else {
+                // Invalidate all versions for this source
+                const source_path = path.join(this.cache_dir, sanitize_name(source_name));
+                await fs.rm(source_path, { recursive: true, force: true });
+            }
+            return success(undefined);
+        }
+        catch (error) {
+            return failure(Errors.cache_write_error(this.cache_dir, error));
+        }
+    }
+    async prune() {
+        let pruned = 0;
+        try {
+            // Check if cache directory exists
+            try {
+                await fs.access(this.cache_dir);
+            }
+            catch {
+                return success(0);
+            }
+            const sources = await fs.readdir(this.cache_dir);
+            for (const source of sources) {
+                const source_path = path.join(this.cache_dir, source);
+                const stat = await fs.stat(source_path);
+                if (!stat.isDirectory())
+                    continue;
+                const versions = await fs.readdir(source_path);
+                for (const version of versions) {
+                    const entry_path = path.join(source_path, version);
+                    const meta_path = path.join(entry_path, META_FILENAME);
+                    try {
+                        const meta_content = await fs.readFile(meta_path, 'utf-8');
+                        const meta_json = JSON.parse(meta_content);
+                        const parse_result = cache_meta_schema.safeParse(meta_json);
+                        if (parse_result.success) {
+                            const expires_at = parse_result.data.expires_at
+                                ? new Date(parse_result.data.expires_at)
+                                : null;
+                            if (is_expired(expires_at)) {
+                                await fs.rm(entry_path, { recursive: true, force: true });
+                                pruned++;
+                            }
+                        }
+                        else {
+                            // Corrupt metadata, remove entry
+                            await fs.rm(entry_path, { recursive: true, force: true });
+                            pruned++;
+                        }
+                    }
+                    catch {
+                        // Can't read metadata, skip
+                    }
+                }
+            }
+            return success(pruned);
+        }
+        catch (error) {
+            return failure(Errors.cache_read_error(this.cache_dir, error));
+        }
+    }
+    async list() {
+        const entries = [];
+        try {
+            // Check if cache directory exists
+            try {
+                await fs.access(this.cache_dir);
+            }
+            catch {
+                return success([]);
+            }
+            const sources = await fs.readdir(this.cache_dir);
+            for (const source of sources) {
+                const source_path = path.join(this.cache_dir, source);
+                const stat = await fs.stat(source_path);
+                if (!stat.isDirectory())
+                    continue;
+                const versions = await fs.readdir(source_path);
+                for (const version of versions) {
+                    const entry_path = path.join(source_path, version);
+                    const meta_path = path.join(entry_path, META_FILENAME);
+                    const templates_path = path.join(entry_path, TEMPLATES_DIRNAME);
+                    try {
+                        const meta_content = await fs.readFile(meta_path, 'utf-8');
+                        const meta_json = JSON.parse(meta_content);
+                        const parse_result = cache_meta_schema.safeParse(meta_json);
+                        if (parse_result.success) {
+                            const meta = parse_result.data;
+                            const entry = {
+                                source_name: meta.source_name,
+                                source_type: meta.source_type,
+                                version: meta.version,
+                                path: templates_path,
+                                fetched_at: new Date(meta.fetched_at),
+                                expires_at: meta.expires_at ? new Date(meta.expires_at) : null,
+                            };
+                            if (meta.checksum) {
+                                entry.checksum = meta.checksum;
+                            }
+                            entries.push(entry);
+                        }
+                    }
+                    catch {
+                        // Can't read metadata, skip
+                    }
+                }
+            }
+            return success(entries);
+        }
+        catch (error) {
+            return failure(Errors.cache_read_error(this.cache_dir, error));
+        }
+    }
+    async size() {
+        const get_dir_size = async (dir_path) => {
+            let total = 0;
+            const entries = await fs.readdir(dir_path, { withFileTypes: true });
+            for (const entry of entries) {
+                const full_path = path.join(dir_path, entry.name);
+                if (entry.isDirectory()) {
+                    total += await get_dir_size(full_path);
+                }
+                else {
+                    const stat = await fs.stat(full_path);
+                    total += stat.size;
+                }
+            }
+            return total;
+        };
+        try {
+            // Check if cache directory exists
+            try {
+                await fs.access(this.cache_dir);
+            }
+            catch {
+                return success(0);
+            }
+            const total = await get_dir_size(this.cache_dir);
+            return success(total);
+        }
+        catch (error) {
+            return failure(Errors.cache_read_error(this.cache_dir, error));
+        }
+    }
+    async clear() {
+        try {
+            await fs.rm(this.cache_dir, { recursive: true, force: true });
+            return success(undefined);
+        }
+        catch (error) {
+            return failure(Errors.cache_write_error(this.cache_dir, error));
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/sources/cache/index.js.map

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

package/dist/sources/cache/metadata.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+/**
+ * Schema for cache entry metadata stored in _meta.json files.
+ */
+export declare const cache_meta_schema: z.ZodObject<{
+    source_name: z.ZodString;
+    source_type: z.ZodEnum<["git", "http", "oci"]>;
+    version: z.ZodString;
+    fetched_at: z.ZodString;
+    expires_at: z.ZodNullable<z.ZodString>;
+    checksum: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    source_name: string;
+    source_type: "oci" | "git" | "http";
+    fetched_at: string;
+    expires_at: string | null;
+    checksum?: string | undefined;
+}, {
+    version: string;
+    source_name: string;
+    source_type: "oci" | "git" | "http";
+    fetched_at: string;
+    expires_at: string | null;
+    checksum?: string | undefined;
+}>;
+export type CacheMetaType = z.infer<typeof cache_meta_schema>;
+/**
+ * Filename for cache metadata.
+ */
+export declare const META_FILENAME = "_meta.json";
+/**
+ * Directory name for cached templates within a version directory.
+ */
+export declare const TEMPLATES_DIRNAME = "templates";
+//# sourceMappingURL=metadata.d.ts.map

package/dist/sources/cache/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/sources/cache/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,iBAAiB,cAAc,CAAC"}

package/dist/sources/cache/metadata.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/**
+ * Schema for cache entry metadata stored in _meta.json files.
+ */
+export const cache_meta_schema = z.object({
+    source_name: z.string(),
+    source_type: z.enum(['git', 'http', 'oci']),
+    version: z.string(),
+    fetched_at: z.string().datetime(),
+    expires_at: z.string().datetime().nullable(),
+    checksum: z.string().optional(),
+});
+/**
+ * Filename for cache metadata.
+ */
+export const META_FILENAME = '_meta.json';
+/**
+ * Directory name for cached templates within a version directory.
+ */
+export const TEMPLATES_DIRNAME = 'templates';
+//# sourceMappingURL=metadata.js.map

package/dist/sources/cache/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/sources/cache/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC"}

package/dist/sources/cache/ttl.d.ts

@@ -0,0 +1,20 @@
+import { type KustodianErrorType, type ResultType } from '../../core/index.js';
+/**
+ * Default TTL for mutable sources (1 hour).
+ */
+export declare const DEFAULT_TTL = "1h";
+/**
+ * Parses a TTL duration string into milliseconds.
+ * Supported formats: 30m, 1h, 24h, 7d
+ */
+export declare function parse_ttl(ttl: string): ResultType<number, KustodianErrorType>;
+/**
+ * Calculates the expiration date from a TTL string.
+ * Returns null for immutable sources (no expiration).
+ */
+export declare function calculate_expiry(mutable: boolean, ttl?: string): Date | null;
+/**
+ * Checks if a cache entry has expired.
+ */
+export declare function is_expired(expires_at: Date | null): boolean;
+//# sourceMappingURL=ttl.d.ts.map

package/dist/sources/cache/ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/sources/cache/ttl.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAGhB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAoB7E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiB5E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAK3D"}

package/dist/sources/cache/ttl.js

@@ -0,0 +1,53 @@
+import { Errors, failure, success, } from '../../core/index.js';
+/**
+ * Default TTL for mutable sources (1 hour).
+ */
+export const DEFAULT_TTL = '1h';
+/**
+ * Parses a TTL duration string into milliseconds.
+ * Supported formats: 30m, 1h, 24h, 7d
+ */
+export function parse_ttl(ttl) {
+    const match = ttl.match(/^(\d+)(m|h|d)$/);
+    if (!match) {
+        return failure(Errors.invalid_argument('ttl', `Invalid TTL format: ${ttl}. Expected format: <number>(m|h|d)`));
+    }
+    const value = match[1] ?? '0';
+    const unit = match[2];
+    const multipliers = {
+        m: 60 * 1000,
+        h: 60 * 60 * 1000,
+        d: 24 * 60 * 60 * 1000,
+    };
+    return success(Number.parseInt(value, 10) * multipliers[unit]);
+}
+/**
+ * Calculates the expiration date from a TTL string.
+ * Returns null for immutable sources (no expiration).
+ */
+export function calculate_expiry(mutable, ttl) {
+    if (!mutable) {
+        return null;
+    }
+    const ttl_ms_result = parse_ttl(ttl ?? DEFAULT_TTL);
+    if (!ttl_ms_result.success) {
+        // Fall back to default TTL on parse error
+        const default_ms_result = parse_ttl(DEFAULT_TTL);
+        if (!default_ms_result.success) {
+            // This should never happen with the hardcoded default
+            return new Date(Date.now() + 60 * 60 * 1000);
+        }
+        return new Date(Date.now() + default_ms_result.value);
+    }
+    return new Date(Date.now() + ttl_ms_result.value);
+}
+/**
+ * Checks if a cache entry has expired.
+ */
+export function is_expired(expires_at) {
+    if (expires_at === null) {
+        return false; // Immutable entries never expire
+    }
+    return new Date() > expires_at;
+}
+//# sourceMappingURL=ttl.js.map

package/dist/sources/cache/ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../../src/sources/cache/ttl.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAGN,OAAO,EACP,OAAO,GACR,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,OAAO,CACZ,MAAM,CAAC,gBAAgB,CACrB,KAAK,EACL,uBAAuB,GAAG,oCAAoC,CAC/D,CACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAoB,CAAC;IACzC,MAAM,WAAW,GAAoC;QACnD,CAAC,EAAE,EAAE,GAAG,IAAI;QACZ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;KACvB,CAAC;IAEF,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,GAAY;IAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC3B,0CAA0C;QAC1C,MAAM,iBAAiB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;YAC/B,sDAAsD;YACtD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,UAAuB;IAChD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,CAAC,iCAAiC;IACjD,CAAC;IACD,OAAO,IAAI,IAAI,EAAE,GAAG,UAAU,CAAC;AACjC,CAAC"}

package/dist/sources/fetchers/git.d.ts

@@ -0,0 +1,6 @@
+import type { SourceFetcherType } from './types.js';
+/**
+ * Creates a Git source fetcher.
+ */
+export declare function create_git_fetcher(): SourceFetcherType;
+//# sourceMappingURL=git.d.ts.map

package/dist/sources/fetchers/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/sources/fetchers/git.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAEtD"}