@kubuild/core 0.1.0 → 0.2.0

package/dist/interpolator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Template and Expression Variable Interpolator
+ *
+ * Provides safe, deterministic resolution and interpolation of template strings
+ * like `{{form.email}}`, `{{variables.token}}`, and `{{response.data.id}}` into
+ * targets without using eval() or Function().
+ */
+/**
+ * Standard structured runtime context for interpolations.
+ */
+export interface InterpolationContext {
+    form?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+    response?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Checks if a string contains one or more `{{ ... }}` template expressions.
+ */
+export declare function hasTemplateExpressions(text: unknown): boolean;
+/**
+ * Extracts all unique property keys / variable paths referenced inside `{{ ... }}`.
+ */
+export declare function extractTemplateVariables(text: string): string[];
+/**
+ * Safely traverses a nested data source to resolve a dot/bracket path
+ * (e.g. `form.user.profile.name`, `response.data[0].id`, `items.0.title`).
+ *
+ * Returns `fallback` if any segment is missing, undefined, null, or points to
+ * a function or forbidden prototype property.
+ */
+export declare function resolvePropertyPath(source: unknown, path: string, fallback?: unknown): unknown;
+/**
+ * Interpolates all `{{ path }}` placeholders in a template string using values
+ * from the provided context object.
+ *
+ * If a variable cannot be resolved, it replaces it with `fallback` (default: `""`).
+ */
+export declare function interpolateTemplateString(template: string, context?: Record<string, unknown>, fallback?: string): string;
+/**
+ * Recursively interpolates any value (string, object, array, primitive).
+ *
+ * - If string is exactly `{{ path }}`, returns the raw resolved value (retaining type: number, boolean, object, array).
+ * - If string contains embedded templates (e.g. `Bearer {{token}}`), returns the interpolated string.
+ * - If array, interpolates every element.
+ * - If object, interpolates every property value while stripping forbidden prototype keys.
+ */
+export declare function interpolateValue(value: unknown, context?: Record<string, unknown>): unknown;
+//# sourceMappingURL=interpolator.d.ts.map

package/dist/interpolator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolator.d.ts","sourceRoot":"","sources":["../src/interpolator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CA6CT;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,GAAE,MAAW,GACpB,MAAM,CAqBR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA8B3F"}

package/dist/pipeline-executor.d.ts

@@ -0,0 +1,136 @@
+import type { ActionPipeline, ActionStep, ActionStepCondition, ActionStepType } from '@kubuild/schema';
+/**
+ * Execution context shared across action steps in a pipeline.
+ */
+export interface PipelineExecutionContext {
+    form?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+    response?: unknown;
+    stepResults?: Record<string, StepExecutionResult>;
+    error?: unknown;
+    lastError?: unknown;
+    nodeId?: string;
+    document?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Status of an individual step execution.
+ */
+export type StepExecutionStatus = 'success' | 'error' | 'skipped' | 'cancelled';
+/**
+ * Result of executing an individual action step.
+ */
+export interface StepExecutionResult {
+    stepId: string;
+    stepType: ActionStepType | string;
+    status: StepExecutionStatus;
+    data?: unknown;
+    error?: Error | unknown;
+    durationMs: number;
+    subResults?: StepExecutionResult[];
+}
+/**
+ * Overall result of executing an action pipeline.
+ */
+export interface PipelineExecutionResult {
+    pipelineId: string;
+    success: boolean;
+    status: 'completed' | 'failed' | 'cancelled';
+    stepResults: StepExecutionResult[];
+    context: PipelineExecutionContext;
+    error?: Error | unknown;
+    durationMs: number;
+}
+/**
+ * Handler function signature for an individual step type.
+ */
+export type PipelineStepHandler<TContext = PipelineExecutionContext> = (step: ActionStep, context: TContext, signal: AbortSignal) => Promise<unknown> | unknown;
+/**
+ * Options for configuring the execution of an action pipeline.
+ */
+export interface ExecutePipelineOptions {
+    context?: PipelineExecutionContext;
+    signal?: AbortSignal;
+    timeout?: number;
+    throwOnError?: boolean;
+    handlers?: Record<string, PipelineStepHandler>;
+    onStepStart?: (step: ActionStep, context: PipelineExecutionContext) => void;
+    onStepComplete?: (step: ActionStep, result: StepExecutionResult, context: PipelineExecutionContext) => void;
+}
+/**
+ * Configuration options for creating an ActionPipelineExecutor instance.
+ */
+export interface ActionPipelineExecutorOptions {
+    handlers?: Record<string, PipelineStepHandler>;
+    defaultTimeout?: number;
+    throwOnError?: boolean;
+}
+/**
+ * Custom error thrown when a step or pipeline times out.
+ */
+export declare class ActionTimeoutError extends Error {
+    readonly stepId?: string;
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, stepId?: string);
+}
+/**
+ * Custom error thrown when an action execution is aborted/cancelled.
+ */
+export declare class ActionCancellationError extends Error {
+    readonly stepId?: string;
+    constructor(message?: string, stepId?: string);
+}
+/**
+ * Evaluates an ActionStepCondition against a pipeline execution context.
+ */
+export declare function evaluateActionCondition(condition: ActionStepCondition | undefined, context: PipelineExecutionContext): boolean;
+/**
+ * ActionPipelineExecutor manages step handlers, sequential execution of action pipelines,
+ * timeouts, cancellation, conditional evaluation, and onSuccess / onError branching.
+ */
+export declare class ActionPipelineExecutor {
+    private handlers;
+    private defaultTimeout?;
+    private throwOnError;
+    constructor(options?: ActionPipelineExecutorOptions);
+    /**
+     * Registers default built-in handlers for core step types like `set_state` and `reset_form`.
+     */
+    private registerBuiltInHandlers;
+    /**
+     * Registers a handler for a step type.
+     */
+    registerHandler(type: ActionStepType | string, handler: PipelineStepHandler): this;
+    /**
+     * Unregisters a handler for a step type.
+     */
+    unregisterHandler(type: ActionStepType | string): this;
+    /**
+     * Checks if a handler exists for a step type.
+     */
+    hasHandler(type: ActionStepType | string): boolean;
+    /**
+     * Gets the registered handler for a step type.
+     */
+    getHandler(type: ActionStepType | string): PipelineStepHandler | undefined;
+    /**
+     * Executes a full ActionPipeline sequentially with support for timeouts, cancellation,
+     * condition evaluation, and branching.
+     */
+    execute(pipeline: ActionPipeline, options?: ExecutePipelineOptions): Promise<PipelineExecutionResult>;
+    /**
+     * Executes an ordered list of ActionSteps sequentially.
+     */
+    private executeSteps;
+    /**
+     * Executes a single ActionStep with condition checking, payload interpolation, timeout,
+     * handler execution, response context passing, and branch execution.
+     */
+    executeSingleStep(step: ActionStep, context: PipelineExecutionContext, parentSignal: AbortSignal, options?: ExecutePipelineOptions): Promise<StepExecutionResult>;
+}
+/**
+ * Convenience helper to execute an action pipeline using default or custom executor settings.
+ */
+export declare function executeActionPipeline(pipeline: ActionPipeline, options?: ExecutePipelineOptions): Promise<PipelineExecutionResult>;
+//# sourceMappingURL=pipeline-executor.d.ts.map

package/dist/pipeline-executor.d.ts.map

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

package/dist/state-store.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Standard form state structure managed inside the store.
+ */
+export interface FormState {
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    isSubmitting: boolean;
+    isValid: boolean;
+    dirty: boolean;
+    initialValues?: Record<string, unknown>;
+}
+/**
+ * Root state managed by the RuntimeStateStore.
+ */
+export interface RuntimeStoreState {
+    variables: Record<string, unknown>;
+    forms: Record<string, FormState>;
+    state: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export type Unsubscribe = () => void;
+export type StoreListener = (state: Readonly<RuntimeStoreState>, prevState: Readonly<RuntimeStoreState>) => void;
+export type KeyChangeListener<T = unknown> = (newValue: T, prevValue: T) => void;
+export type PathChangeListener<T = unknown> = (newValue: T, prevValue: T) => void;
+export type FormChangeListener = (newForm: FormState, prevForm?: FormState) => void;
+/**
+ * Creates an initial clean FormState object.
+ */
+export declare function createDefaultFormState(initialValues?: Record<string, unknown>): FormState;
+/**
+ * Reactive State Store & Context Manager for form states and runtime variables.
+ */
+export declare class RuntimeStateStore {
+    private state;
+    private listeners;
+    private pathListeners;
+    private formListeners;
+    private isBatching;
+    private batchOldState?;
+    private isNotifying;
+    constructor(initialState?: Partial<RuntimeStoreState>);
+    /**
+     * Retrieves a value at a specified path or the entire state snapshot.
+     */
+    get<T = unknown>(path?: string, fallback?: T): T;
+    /**
+     * Gets an immutable snapshot of the current state.
+     */
+    getSnapshot(): RuntimeStoreState;
+    /**
+     * Sets a value at a dotted path and notifies subscribers.
+     */
+    set(path: string, value: unknown): this;
+    /**
+     * Performs multiple updates atomically, triggering subscriber notifications once.
+     */
+    setBatch(updates: Record<string, unknown>): this;
+    /**
+     * Deletes a property at the specified path.
+     */
+    delete(path: string): boolean;
+    /**
+     * Resets the store state to an initial or clean state.
+     */
+    reset(initialState?: Partial<RuntimeStoreState>): this;
+    /**
+     * Subscribes a listener to any state changes.
+     */
+    subscribe(listener: StoreListener): Unsubscribe;
+    /**
+     * Subscribes a listener to changes on a top-level key.
+     */
+    subscribeKey<T = unknown>(key: string, listener: KeyChangeListener<T>): Unsubscribe;
+    /**
+     * Subscribes a listener to changes at a specific dotted path.
+     */
+    subscribePath<T = unknown>(path: string, listener: PathChangeListener<T>): Unsubscribe;
+    /**
+     * Subscribes a listener to changes of a specific form state.
+     */
+    subscribeForm(formId: string, listener: FormChangeListener): Unsubscribe;
+    /**
+     * Notifies all relevant listeners when state changes.
+     */
+    private notifyChanges;
+    /**
+     * Retrieves the FormState for a formId, initializing default form state if not present.
+     */
+    getForm(formId: string): FormState;
+    /**
+     * Updates a single field value in a form and marks dirty if changed from initial.
+     */
+    setFormFieldValue(formId: string, fieldName: string, value: unknown): this;
+    /**
+     * Sets or clears an error for a form field.
+     */
+    setFormFieldError(formId: string, fieldName: string, error: string | null): this;
+    /**
+     * Marks a form field as touched (or untouched).
+     */
+    setFormFieldTouched(formId: string, fieldName: string, touched?: boolean): this;
+    /**
+     * Updates multiple form errors simultaneously.
+     */
+    setFormErrors(formId: string, errors: Record<string, string>): this;
+    /**
+     * Sets multiple form field values simultaneously.
+     */
+    setFormValues(formId: string, values: Record<string, unknown>, replace?: boolean): this;
+    /**
+     * Sets the submitting status of a form.
+     */
+    setFormSubmitting(formId: string, isSubmitting: boolean): this;
+    /**
+     * Resets a form's values, errors, touched, and submitting state to defaults or specified values.
+     */
+    resetForm(formId: string, initialValues?: Record<string, unknown>): this;
+    /**
+     * Creates an isolated child scope store for a page or component container.
+     */
+    createScope(scopeId: string, initialValues?: Record<string, unknown>): RuntimeStateStore;
+}
+/**
+ * Factory function to create a new RuntimeStateStore instance.
+ */
+export declare function createRuntimeStore(initialState?: Partial<RuntimeStoreState>): RuntimeStateStore;
+//# sourceMappingURL=state-store.d.ts.map

package/dist/state-store.d.ts.map

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

package/dist/validation-engine.d.ts

@@ -0,0 +1,39 @@
+import type { FormFieldBinding, ValidationRule } from '@kubuild/schema';
+/**
+ * Checks whether a field value is considered empty.
+ * Empty values include undefined, null, empty string, empty array, or boolean false.
+ */
+export declare function isEmptyValue(value: unknown): boolean;
+/**
+ * Applies a value transformation to a field value prior to validation.
+ */
+export declare function applyFieldTransform(value: unknown, transform?: 'trim' | 'lowercase' | 'uppercase' | 'number' | string): unknown;
+/**
+ * Evaluates a single validation rule against a field value.
+ * Returns the rule's error message if invalid, or null if valid.
+ */
+export declare function evaluateRule(rule: ValidationRule, value: unknown, allFormValues?: Record<string, unknown>): string | null;
+/**
+ * Validates a single field value against an array of ValidationRules.
+ * Returns the first failing error message, or null if all rules pass.
+ */
+export declare function validateFieldValue(value: unknown, rules?: ValidationRule[] | null, allFormValues?: Record<string, unknown>): string | null;
+/**
+ * Asynchronously validates a single field value against an array of ValidationRules.
+ */
+export declare function validateFieldValueAsync(value: unknown, rules?: ValidationRule[] | null, allFormValues?: Record<string, unknown>): Promise<string | null>;
+/**
+ * Validates an entire form values object against field configs.
+ * Returns a map of field names to error messages (Record<string, string>).
+ * If all fields are valid, returns an empty object {}.
+ */
+export declare function validateForm(values: Record<string, unknown>, fieldConfigs: FormFieldBinding[] | Record<string, FormFieldBinding | ValidationRule[]>): Record<string, string>;
+/**
+ * Asynchronously validates an entire form values object against field configs.
+ */
+export declare function validateFormAsync(values: Record<string, unknown>, fieldConfigs: FormFieldBinding[] | Record<string, FormFieldBinding | ValidationRule[]>): Promise<Record<string, string>>;
+/**
+ * Convenience helper to determine if a form error map is completely valid (no errors).
+ */
+export declare function isFormValid(errors: Record<string, string>): boolean;
+//# sourceMappingURL=validation-engine.d.ts.map

package/dist/validation-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-engine.d.ts","sourceRoot":"","sources":["../src/validation-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcpD;AAYD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GACjE,OAAO,CA6BT;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,OAAO,EACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,MAAM,GAAG,IAAI,CAoGf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,EAC/B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,MAAM,GAAG,IAAI,CAaf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,EAC/B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EACR,gBAAgB,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAAC,GACtD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2DxB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EACR,gBAAgB,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAAC,GACtD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAEjC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAEnE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubuild/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Framework-agnostic engine for KUBUILD: document utilities, command engine, history, migration, and validation",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -40,7 +40,7 @@
   "homepage": "https://github.com/kustora/kubuild#readme",
   "dependencies": {
     "fflate": "^0.8.3",
-    "@kubuild/schema": "0.1.0"
+    "@kubuild/schema": "0.2.0"
   },
   "devDependencies": {
     "tsup": "^8.3.6",