kustodian 1.0.0

package/dist/nodes/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Node role in the cluster.
+ */
+export type NodeRoleType = 'controller' | 'worker' | 'controller+worker';
+/**
+ * SSH configuration for connecting to a node.
+ */
+export interface SshConfigType {
+    user?: string;
+    key_path?: string;
+    known_hosts_path?: string;
+    port?: number;
+}
+/**
+ * Kubernetes taint configuration.
+ */
+export interface TaintType {
+    key: string;
+    value?: string;
+    effect: 'NoSchedule' | 'PreferNoSchedule' | 'NoExecute';
+}
+/**
+ * Node definition with its configuration.
+ */
+export interface NodeType {
+    name: string;
+    role: NodeRoleType;
+    address: string;
+    profile?: string;
+    ssh?: SshConfigType;
+    labels?: Record<string, string | boolean | number>;
+    taints?: TaintType[];
+    annotations?: Record<string, string>;
+}
+/**
+ * Node list with default SSH configuration.
+ */
+export interface NodeListType {
+    cluster: string;
+    label_prefix?: string;
+    ssh?: SshConfigType;
+    nodes: NodeType[];
+}
+/**
+ * Default label prefix.
+ */
+export declare const DEFAULT_LABEL_PREFIX = "kustodian.io";
+/**
+ * Formats a label key with the configured prefix.
+ */
+export declare function format_label_key(key: string, prefix?: string): string;
+/**
+ * Formats a label value as a string.
+ */
+export declare function format_label_value(value: string | boolean | number): string;
+/**
+ * Formats all labels for a node with the configured prefix.
+ */
+export declare function format_node_labels(labels: Record<string, string | boolean | number> | undefined, prefix?: string): Record<string, string>;
+/**
+ * Gets the SSH configuration for a node, merging with defaults.
+ */
+export declare function get_node_ssh_config(node: NodeType, default_ssh?: SshConfigType): SshConfigType;
+/**
+ * Checks if a node has a controller role.
+ */
+export declare function is_controller(node: NodeType): boolean;
+/**
+ * Checks if a node has a worker role.
+ */
+export declare function is_worker(node: NodeType): boolean;
+/**
+ * Gets all controller nodes from a node list.
+ */
+export declare function get_controllers(nodes: NodeType[]): NodeType[];
+/**
+ * Gets all worker nodes from a node list.
+ */
+export declare function get_workers(nodes: NodeType[]): NodeType[];
+/**
+ * Gets the primary controller node (first controller).
+ */
+export declare function get_primary_controller(nodes: NodeType[]): NodeType | undefined;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/nodes/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,GAAG,kBAAkB,GAAG,WAAW,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAA6B,GAAG,MAAM,CAM3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAK3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,SAAS,EAC7D,MAAM,GAAE,MAA6B,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,aAAa,GAAG,aAAa,CAK9F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,SAAS,CAE9E"}

package/dist/nodes/types.js

@@ -0,0 +1,77 @@
+/**
+ * Default label prefix.
+ */
+export const DEFAULT_LABEL_PREFIX = 'kustodian.io';
+/**
+ * Formats a label key with the configured prefix.
+ */
+export function format_label_key(key, prefix = DEFAULT_LABEL_PREFIX) {
+    // If key already has a prefix (contains /), return as-is
+    if (key.includes('/')) {
+        return key;
+    }
+    return `${prefix}/${key}`;
+}
+/**
+ * Formats a label value as a string.
+ */
+export function format_label_value(value) {
+    if (typeof value === 'boolean') {
+        return value ? 'true' : 'false';
+    }
+    return String(value);
+}
+/**
+ * Formats all labels for a node with the configured prefix.
+ */
+export function format_node_labels(labels, prefix = DEFAULT_LABEL_PREFIX) {
+    if (!labels) {
+        return {};
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(labels)) {
+        const formatted_key = format_label_key(key, prefix);
+        result[formatted_key] = format_label_value(value);
+    }
+    return result;
+}
+/**
+ * Gets the SSH configuration for a node, merging with defaults.
+ */
+export function get_node_ssh_config(node, default_ssh) {
+    return {
+        ...default_ssh,
+        ...node.ssh,
+    };
+}
+/**
+ * Checks if a node has a controller role.
+ */
+export function is_controller(node) {
+    return node.role === 'controller' || node.role === 'controller+worker';
+}
+/**
+ * Checks if a node has a worker role.
+ */
+export function is_worker(node) {
+    return node.role === 'worker' || node.role === 'controller+worker';
+}
+/**
+ * Gets all controller nodes from a node list.
+ */
+export function get_controllers(nodes) {
+    return nodes.filter(is_controller);
+}
+/**
+ * Gets all worker nodes from a node list.
+ */
+export function get_workers(nodes) {
+    return nodes.filter(is_worker);
+}
+/**
+ * Gets the primary controller node (first controller).
+ */
+export function get_primary_controller(nodes) {
+    return nodes.find(is_controller);
+}
+//# sourceMappingURL=types.js.map

package/dist/nodes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/nodes/types.ts"],"names":[],"mappings":"AAgDA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,SAAiB,oBAAoB;IACjF,yDAAyD;IACzD,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IACjE,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA6D,EAC7D,SAAiB,oBAAoB;IAErC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,aAAa,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,WAA2B;IAC7E,OAAO;QACL,GAAG,WAAW;QACd,GAAG,IAAI,CAAC,GAAG;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,OAAO,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAiB;IACtD,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC"}

package/dist/plugins/generators.d.ts

@@ -0,0 +1,49 @@
+import type { KustodianErrorType, ResultType } from '../core/index.js';
+import type { ClusterType, TemplateType } from '../schema/index.js';
+import type { GeneratedResourceType } from './types.js';
+/**
+ * Object type reference that a generator handles.
+ */
+export interface ObjectTypeRefType {
+    api_version: string;
+    kind: string;
+}
+/**
+ * Context provided to generators during resource generation.
+ */
+export interface GeneratorContextType {
+    /** Current cluster being processed */
+    cluster: ClusterType;
+    /** Current template being processed (if applicable) */
+    template?: TemplateType;
+    /** Plugin configuration */
+    config: Record<string, unknown>;
+    /** All loaded objects by kind (for cross-referencing) */
+    all_objects: Map<string, unknown[]>;
+}
+/**
+ * Plugin generator interface.
+ * Generators produce Kubernetes resources from objects they handle.
+ */
+export interface PluginGeneratorType {
+    /** Generator name for identification */
+    name: string;
+    /**
+     * Object types this generator handles.
+     * When objects of these types are encountered, this generator is invoked.
+     */
+    handles: ObjectTypeRefType[];
+    /**
+     * Generates Kubernetes resources from an object.
+     *
+     * @param object The object to generate resources from
+     * @param context Generation context with cluster and config
+     * @returns Generated Kubernetes resources
+     */
+    generate(object: unknown, context: GeneratorContextType): Promise<ResultType<GeneratedResourceType[], KustodianErrorType>>;
+}
+/**
+ * Creates a generator that handles specific object types.
+ */
+export declare function define_generator(config: PluginGeneratorType): PluginGeneratorType;
+//# sourceMappingURL=generators.d.ts.map

package/dist/plugins/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/plugins/generators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,yDAAyD;IACzD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAE7B;;;;;;OAMG;IACH,QAAQ,CACN,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAEjF"}

package/dist/plugins/generators.js

@@ -0,0 +1,7 @@
+/**
+ * Creates a generator that handles specific object types.
+ */
+export function define_generator(config) {
+    return config;
+}
+//# sourceMappingURL=generators.js.map

package/dist/plugins/generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.js","sourceRoot":"","sources":["../../src/plugins/generators.ts"],"names":[],"mappings":"AAsDA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/plugins/hooks.d.ts

@@ -0,0 +1,120 @@
+import type { KustodianErrorType, ResultType } from '../core/index.js';
+import type { ClusterType, TemplateType } from '../schema/index.js';
+import type { GeneratedResourceType } from './types.js';
+/**
+ * Hook event types organized by category.
+ */
+export type GeneratorHookEventType = 'generator:before' | 'generator:after_resolve' | 'generator:after_kustomization' | 'generator:after' | 'generator:before_write' | 'generator:after_write';
+export type CLIHookEventType = 'cli:before_command' | 'cli:after_command' | 'cli:on_error';
+export type BootstrapHookEventType = 'bootstrap:before' | 'bootstrap:after' | 'bootstrap:before_step' | 'bootstrap:after_step' | 'bootstrap:on_error';
+export type ValidationHookEventType = 'validation:cluster' | 'validation:template' | 'validation:object';
+export type OutputHookEventType = 'output:before_write' | 'output:after_write';
+/**
+ * Union of all hook event types.
+ */
+export type HookEventType = GeneratorHookEventType | CLIHookEventType | BootstrapHookEventType | ValidationHookEventType | OutputHookEventType;
+/**
+ * Base hook context shared by all hooks.
+ */
+export interface BaseHookContextType {
+    cluster?: ClusterType;
+    template?: TemplateType;
+}
+/**
+ * Generator hook context.
+ */
+export interface GeneratorHookContextType extends BaseHookContextType {
+    cluster: ClusterType;
+    templates?: unknown[];
+    kustomization?: unknown;
+    flux_kustomization?: unknown;
+    result?: unknown;
+    additional_resources?: GeneratedResourceType[];
+}
+/**
+ * CLI hook context.
+ */
+export interface CLIHookContextType extends BaseHookContextType {
+    command_name: string;
+    command_path: string[];
+    args: string[];
+    options: Record<string, unknown>;
+    error?: KustodianErrorType;
+}
+/**
+ * Bootstrap hook context.
+ */
+export interface BootstrapHookContextType extends BaseHookContextType {
+    cluster: ClusterType;
+    config?: unknown;
+    state?: unknown;
+    step_name?: string;
+    error?: KustodianErrorType;
+}
+/**
+ * Validation hook context.
+ */
+export interface ValidationHookContextType extends BaseHookContextType {
+    resource: unknown;
+    resource_type: 'cluster' | 'template' | 'object';
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Output hook context.
+ */
+export interface OutputHookContextType extends BaseHookContextType {
+    file_path?: string;
+    content?: string;
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+/**
+ * Union of all hook context types.
+ */
+export type HookContextType = GeneratorHookContextType | CLIHookContextType | BootstrapHookContextType | ValidationHookContextType | OutputHookContextType;
+/**
+ * Hook handler function type.
+ */
+export type HookHandlerType<C extends HookContextType = HookContextType> = (event: HookEventType, context: C) => Promise<ResultType<C, KustodianErrorType>>;
+/**
+ * Plugin hook contribution.
+ */
+export interface PluginHookContributionType {
+    /** Event this hook listens to */
+    event: HookEventType;
+    /** Hook priority (lower runs first, default 100) */
+    priority?: number;
+    /** Hook handler */
+    handler: HookHandlerType;
+}
+/**
+ * Hook dispatcher for running hooks with priority ordering.
+ */
+export interface HookDispatcherType {
+    /**
+     * Registers a hook contribution.
+     */
+    register(contribution: PluginHookContributionType): void;
+    /**
+     * Dispatches an event to all registered handlers.
+     * Handlers run in priority order (lowest first).
+     * Context is passed through the chain, allowing modifications.
+     */
+    dispatch<C extends HookContextType>(event: HookEventType, context: C): Promise<ResultType<C, KustodianErrorType>>;
+    /**
+     * Checks if any hooks are registered for an event.
+     */
+    has_hooks(event: HookEventType): boolean;
+    /**
+     * Lists all registered events.
+     */
+    list_events(): HookEventType[];
+}
+/**
+ * Creates a new hook dispatcher.
+ */
+export declare function create_hook_dispatcher(): HookDispatcherType;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/plugins/hooks.d.ts.map

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

package/dist/plugins/hooks.js

@@ -0,0 +1,41 @@
+import { is_success, success } from '../core/index.js';
+/**
+ * Creates a new hook dispatcher.
+ */
+export function create_hook_dispatcher() {
+    const hooks = new Map();
+    return {
+        register(contribution) {
+            const { event, priority = 100, handler } = contribution;
+            if (!hooks.has(event)) {
+                hooks.set(event, []);
+            }
+            const event_hooks = hooks.get(event);
+            if (event_hooks) {
+                event_hooks.push({ priority, handler });
+                // Sort by priority (lower runs first)
+                event_hooks.sort((a, b) => a.priority - b.priority);
+            }
+        },
+        async dispatch(event, context) {
+            const event_hooks = hooks.get(event) ?? [];
+            let current_context = context;
+            for (const { handler } of event_hooks) {
+                const result = await handler(event, current_context);
+                if (!is_success(result)) {
+                    return result;
+                }
+                current_context = result.value;
+            }
+            return success(current_context);
+        },
+        has_hooks(event) {
+            const event_hooks = hooks.get(event);
+            return event_hooks !== undefined && event_hooks.length > 0;
+        },
+        list_events() {
+            return Array.from(hooks.keys());
+        },
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/plugins/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/plugins/hooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA2KvD;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuC,CAAC;IAE7D,OAAO;QACL,QAAQ,CAAC,YAAY;YACnB,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC;YAExD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvB,CAAC;YAED,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,WAAW,EAAE,CAAC;gBAChB,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBACxC,sCAAsC;gBACtC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CAA4B,KAAoB,EAAE,OAAU;YACxE,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,eAAe,GAAG,OAAO,CAAC;YAE9B,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,WAAW,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;gBACrD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACxB,OAAO,MAAM,CAAC;gBAChB,CAAC;gBACD,eAAe,GAAG,MAAM,CAAC,KAAU,CAAC;YACtC,CAAC;YAED,OAAO,OAAO,CAAC,eAAe,CAAC,CAAC;QAClC,CAAC;QAED,SAAS,CAAC,KAAK;YACb,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,OAAO,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,WAAW;YACT,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,8 @@
+export * from './generators.js';
+export * from './hooks.js';
+export * from './loader.js';
+export * from './object-types.js';
+export * from './registry.js';
+export * from './substitution-providers.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAGA,cAAc,iBAAiB,CAAC;AAGhC,cAAc,YAAY,CAAC;AAE3B,cAAc,aAAa,CAAC;AAG5B,cAAc,mBAAmB,CAAC;AAElC,cAAc,eAAe,CAAC;AAE9B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,15 @@
+// Core types
+// Generator interface
+export * from './generators.js';
+// Hook system
+export * from './hooks.js';
+// Plugin loader
+export * from './loader.js';
+// Object types system
+export * from './object-types.js';
+// Plugin registry
+export * from './registry.js';
+// Substitution providers
+export * from './substitution-providers.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,aAAa;AAEb,sBAAsB;AACtB,cAAc,iBAAiB,CAAC;AAEhC,cAAc;AACd,cAAc,YAAY,CAAC;AAC3B,gBAAgB;AAChB,cAAc,aAAa,CAAC;AAE5B,sBAAsB;AACtB,cAAc,mBAAmB,CAAC;AAClC,kBAAkB;AAClB,cAAc,eAAe,CAAC;AAC9B,yBAAyB;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,40 @@
+import type { KustodianErrorType } from '../core/index.js';
+import { type ResultType } from '../core/index.js';
+import type { LoadedPluginType, PluginLocationInfoType } from './types.js';
+/**
+ * Plugin discovery configuration.
+ */
+export interface PluginDiscoveryConfigType {
+    /** Directories to search for local plugins (default: ['./plugins']) */
+    local_plugin_dirs?: string[];
+    /** Whether to search node_modules (default: true) */
+    search_node_modules?: boolean;
+    /** Plugin name prefixes for npm packages (default: ['@kustodian/plugin-', 'kustodian-plugin-']) */
+    npm_prefixes?: string[];
+}
+/**
+ * Plugin loader interface.
+ */
+export interface PluginLoaderType {
+    /**
+     * Discovers available plugins from npm and local directories.
+     */
+    discover(): Promise<ResultType<PluginLocationInfoType[], KustodianErrorType>>;
+    /**
+     * Loads a plugin by name.
+     */
+    load(name: string): Promise<ResultType<LoadedPluginType, KustodianErrorType>>;
+    /**
+     * Loads a plugin from a specific path.
+     */
+    load_from_path(plugin_path: string): Promise<ResultType<LoadedPluginType, KustodianErrorType>>;
+    /**
+     * Loads multiple plugins by name.
+     */
+    load_all(names: string[]): Promise<ResultType<LoadedPluginType[], KustodianErrorType>>;
+}
+/**
+ * Creates a new plugin loader.
+ */
+export declare function create_plugin_loader(config?: PluginDiscoveryConfigType): PluginLoaderType;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAU,KAAK,UAAU,EAAgC,MAAM,kBAAkB,CAAC;AAEzF,OAAO,KAAK,EAEV,gBAAgB,EAChB,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAE9E;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAE9E;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAE/F;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACxF;AA4BD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,yBAA8B,GAAG,gBAAgB,CAyP7F"}