rowbound 1.0.2

package/dist/core/waterfall.d.ts

@@ -0,0 +1,26 @@
+import type { RateLimiter } from "./rate-limiter.js";
+import { type OnMissingCallback } from "./template.js";
+import type { ExecutionContext, WaterfallAction } from "./types.js";
+export interface WaterfallResult {
+    value: string;
+    provider: string;
+}
+/**
+ * Execute a waterfall action: try each provider in order until one succeeds.
+ *
+ * For each provider:
+ * 1. Resolve templates in url, headers, body
+ * 2. Make HTTP request
+ * 3. Extract value from response
+ * 4. Return first non-empty result
+ *
+ * StopProviderError and other errors cause the provider to be skipped.
+ * Returns null if no provider produces a value.
+ */
+export declare function executeWaterfall(action: WaterfallAction, context: ExecutionContext, options?: {
+    rateLimiter?: RateLimiter;
+    retryAttempts?: number;
+    retryBackoff?: string;
+    signal?: AbortSignal;
+    onMissing?: OnMissingCallback;
+}): Promise<WaterfallResult | null>;

package/dist/core/waterfall.js

@@ -0,0 +1,55 @@
+import { extractValue } from "./extractor.js";
+import { httpRequest } from "./http-client.js";
+import { resolveObject, resolveTemplate, } from "./template.js";
+/**
+ * Execute a waterfall action: try each provider in order until one succeeds.
+ *
+ * For each provider:
+ * 1. Resolve templates in url, headers, body
+ * 2. Make HTTP request
+ * 3. Extract value from response
+ * 4. Return first non-empty result
+ *
+ * StopProviderError and other errors cause the provider to be skipped.
+ * Returns null if no provider produces a value.
+ */
+export async function executeWaterfall(action, context, options = {}) {
+    for (const provider of action.providers) {
+        try {
+            const resolvedUrl = resolveTemplate(provider.url, context, options.onMissing);
+            const resolvedHeaders = provider.headers
+                ? resolveObject(provider.headers, context, options.onMissing)
+                : undefined;
+            const resolvedBody = provider.body !== undefined
+                ? resolveObject(provider.body, context, options.onMissing)
+                : undefined;
+            const response = await httpRequest({
+                method: provider.method,
+                url: resolvedUrl,
+                headers: resolvedHeaders,
+                body: resolvedBody,
+                retryAttempts: options.retryAttempts,
+                retryBackoff: options.retryBackoff,
+                onError: provider.onError,
+                rateLimiter: options.rateLimiter,
+                signal: options.signal,
+            });
+            if (response === null) {
+                // Request was skipped (e.g., onError: "skip") — try next provider
+                continue;
+            }
+            const value = extractValue(response.data, provider.extract);
+            if (value !== "") {
+                return { value, provider: provider.name };
+            }
+            // Empty extraction — try next provider
+        }
+        catch (error) {
+            // Propagate abort errors — do not try remaining providers
+            if (error instanceof Error && error.message === "Request aborted") {
+                throw error;
+            }
+        }
+    }
+    return null;
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { SheetsAdapter } from "./adapters/sheets/sheets-adapter.js";
+export { evaluateCondition } from "./core/condition.js";
+export { type RunPipelineOptions, type RunResult, runPipeline, } from "./core/engine.js";
+export { type ExecResult, executeCommand, executeExecAction, } from "./core/exec.js";
+export { extractValue } from "./core/extractor.js";
+export { type HttpRequestOptions, type HttpResponse, httpRequest, StopProviderError, } from "./core/http-client.js";
+export { RateLimiter } from "./core/rate-limiter.js";
+export { type ReconcileResult, reconcile, } from "./core/reconcile.js";
+export { formatAge, formatDuration, formatRunDetail, formatRunList, } from "./core/run-format.js";
+export { type ActionSummary, createRunState, listRuns, pruneRuns, type RunError, type RunState, readRunState, writeRunState, } from "./core/run-state.js";
+export { createRunTracker } from "./core/run-tracker.js";
+export { resolveObject, resolveTemplate } from "./core/template.js";
+export type { Action, Adapter, CellUpdate, ExecAction, HttpAction, OnErrorConfig, PipelineConfig, PipelineSettings, Row, SheetRef, TabConfig, TransformAction, WaterfallAction, WaterfallProvider, } from "./core/types.js";
+export { type ValidationResult, validateConfig, } from "./core/validator.js";
+export { executeWaterfall, type WaterfallResult, } from "./core/waterfall.js";

package/dist/index.js

@@ -0,0 +1,16 @@
+// Rowbound - Google Sheets enrichment engine
+// Re-exports for programmatic usage
+export { SheetsAdapter } from "./adapters/sheets/sheets-adapter.js";
+export { evaluateCondition } from "./core/condition.js";
+export { runPipeline, } from "./core/engine.js";
+export { executeCommand, executeExecAction, } from "./core/exec.js";
+export { extractValue } from "./core/extractor.js";
+export { httpRequest, StopProviderError, } from "./core/http-client.js";
+export { RateLimiter } from "./core/rate-limiter.js";
+export { reconcile, } from "./core/reconcile.js";
+export { formatAge, formatDuration, formatRunDetail, formatRunList, } from "./core/run-format.js";
+export { createRunState, listRuns, pruneRuns, readRunState, writeRunState, } from "./core/run-state.js";
+export { createRunTracker } from "./core/run-tracker.js";
+export { resolveObject, resolveTemplate } from "./core/template.js";
+export { validateConfig, } from "./core/validator.js";
+export { executeWaterfall, } from "./core/waterfall.js";

package/dist/mcp/server.d.ts

@@ -0,0 +1 @@
+export declare function startMcpServer(): Promise<void>;