@walkeros/cli 4.2.0 → 4.3.0-next-1781171238534

package/dist/index.d.ts

@@ -197,6 +197,21 @@ interface BundleStats {
     buildTime: number;
     treeshakingEffective: boolean;
 }
+/**
+ * Build the wireConfig data payload for a flow as a plain object.
+ *
+ * This is the same object the bundler bakes into a skeleton as
+ * `__configData` (section, step id, data-layer props), produced by the
+ * same classification pass the bundler uses. Callers that inject data at
+ * simulate time (the `data` option of the simulate functions) must build
+ * the FULL payload from the FULL config with this helper; injection
+ * replaces the baked payload, it does not merge.
+ *
+ * Mirrors the bundler's own call path (`detectNamedImports` feeding
+ * `buildSplitConfigObject`) so the result stays identical to the baked
+ * payload by construction.
+ */
+declare function buildDataPayload(flowSettings: Flow): Record<string, unknown>;
 
 /**
  * Named bundle targets with frozen presets.
@@ -408,7 +423,28 @@ declare function push(configOrPath: string | unknown, event: unknown, options?:
     mock?: string[];
     snapshot?: string;
 }): Promise<PushResult>;
-interface SimulateSourceOptions {
+/**
+ * Shared data-injection seam for all simulate functions.
+ */
+interface SimulateDataOptions {
+    /**
+     * Wire-config data payload to execute instead of the bundle's baked
+     * `__configData`. Shape: the split-config data payload the bundler
+     * emits (section, step id, data-layer props), as built by
+     * `buildDataPayload`.
+     *
+     * The payload REPLACES the baked data, there is no deep-merge: build
+     * the full payload from the full config. Injection granularity follows
+     * the skeleton's `__data` references, which are emitted per TOP-LEVEL
+     * step prop. Changed values for any nested key under an existing
+     * top-level data prop (e.g. a new entity-action rule inside an existing
+     * `mapping`) take effect without a rebundle. An entirely NEW top-level
+     * data prop on a step has no `__data` reference in the skeleton, so it
+     * is IGNORED by injection and requires a rebundle.
+     */
+    data?: Record<string, unknown>;
+}
+interface SimulateSourceOptions extends SimulateDataOptions {
     sourceId: string;
     bundlePath?: string;
     flow?: string;
@@ -427,7 +463,7 @@ interface SimulateSourceOptions {
  * content shapes. The source's createTrigger defines what it expects.
  */
 declare function simulateSource(configOrPath: string | Flow.Json, input: unknown, options: SimulateSourceOptions): Promise<Simulation.Result>;
-interface SimulateTransformerOptions {
+interface SimulateTransformerOptions extends SimulateDataOptions {
     transformerId: string;
     bundlePath?: string;
     flow?: string;
@@ -453,7 +489,7 @@ interface SimulateTransformerOptions {
  * If the transformer drops the event (returns false), output event is null.
  */
 declare function simulateTransformer(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateTransformerOptions): Promise<Simulation.Result>;
-interface SimulateCollectorOptions {
+interface SimulateCollectorOptions extends SimulateDataOptions {
     collectorName: string;
     bundlePath?: string;
     flow?: string;
@@ -476,7 +512,7 @@ interface SimulateCollectorOptions {
  * the runtime's own enrichment (`enrichEvent`); it does not reimplement it.
  */
 declare function simulateCollector(configOrPath: string | Flow.Json, event: WalkerOS.DeepPartialEvent, options: SimulateCollectorOptions): Promise<Simulation.Result>;
-interface SimulateDestinationOptions {
+interface SimulateDestinationOptions extends SimulateDataOptions {
     destinationId: string;
     bundlePath?: string;
     flow?: string;
@@ -9864,7 +9900,23 @@ interface DeployOptions {
     signal?: AbortSignal;
     onStatus?: (status: string, substatus: string | null) => void;
 }
-declare function deploy(options: DeployOptions): Promise<any>;
+declare function deploy(options: DeployOptions): Promise<{
+    deploymentId: string;
+    settingsId: string;
+    status: string;
+} | {
+    deploymentId: string;
+    type: "web" | "server";
+    status: string;
+} | {
+    status: string;
+    substatus?: string | null;
+    type: string;
+    containerUrl?: string | null;
+    publicUrl?: string | null;
+    errorMessage?: string | null;
+    deploymentId: string;
+}>;
 declare function getDeployment(options: {
     flowId: string;
     projectId?: string;
@@ -9985,6 +10037,28 @@ declare function telemetryEnableCommand(): void;
  */
 declare function telemetryDisableCommand(): void;
 
+/**
+ * Check if a config value contains code markers that require esbuild compilation.
+ * Returns true if the value (or any nested value) contains:
+ * - $code: prefix (raw JS expression)
+ * - $store. prefix (JS variable reference)
+ * - __WALKEROS_ENV: prefix (process.env expression)
+ * - __WALKEROS_SECRET: prefix (guarded process.env read for a deferred secret)
+ */
+declare function containsCodeMarkers(value: unknown): boolean;
+/**
+ * Split a step's properties into code-layer (for esbuild) and data-layer (post-build).
+ *
+ * Code layer: 'code' key always, plus any property containing code markers
+ * Data layer: plain JSON values (settings, mappings, chains, etc.)
+ *
+ * Not applicable to InlineCode steps — those go entirely to the code layer.
+ */
+declare function classifyStepProperties(step: Record<string, unknown>): {
+    codeProps: Record<string, unknown>;
+    dataProps: Record<string, unknown>;
+};
+
 /**
  * Pure structural validation of a flow config — the exact checks the bundler
  * runs at codegen time, BEFORE any esbuild compile or package/archive fetch.
@@ -10167,6 +10241,9 @@ interface ApiErrorDetail {
 interface ApiErrorOptions {
     code?: string;
     details?: ApiErrorDetail[];
+    status?: number;
+    retryable?: boolean;
+    retryAfterSeconds?: number;
     minVersion?: string;
     clientVersion?: string;
     client?: string;
@@ -10176,6 +10253,9 @@ interface ApiErrorOptions {
 declare class ApiError extends Error {
     code?: string;
     details?: ApiErrorDetail[];
+    status?: number;
+    retryable?: boolean;
+    retryAfterSeconds?: number;
     minVersion?: string;
     clientVersion?: string;
     client?: string;
@@ -10185,7 +10265,6 @@ declare class ApiError extends Error {
 }
 /**
  * Extract structured error from an openapi-fetch error response and throw.
- * The error shape is: { error: { code, message, details: { errors: [] } } }
  *
  * For `code === 'CLIENT_OUTDATED'` (HTTP 426), also extracts the upgrade
  * metadata: `minVersion`, `clientVersion`, `client`, `upgrade`, `docs`.
@@ -10590,4 +10669,4 @@ declare module '@walkeros/core' {
     }
 }
 
-export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type ExampleLookupResult, type FeedbackOptions, type GetPreviewOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListSecretsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateCollectorOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type UpdateSecretOptions, VERSION, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, bundle, bundleCommand, canonicalContractHash, clientContextHeaders, compareContract, compareOutput, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, feedback, feedbackCommand, fetchHealth, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getPreview, getProject, getProjectCommand, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listPreviews, listProjects, listProjectsCommand, listSecrets, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, requestDeviceCode, requireProjectId, resetClientContext, resolveAppUrl, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, simulateCollector, simulateDestination, simulateSource, simulateTransformer, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, validateFlowStructure, whoami, whoamiCommand, wrapSkeleton, writeConfig };
+export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type ExampleLookupResult, type FeedbackOptions, type GetPreviewOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListSecretsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateCollectorOptions, type SimulateDataOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type UpdateSecretOptions, VERSION, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, buildDataPayload, bundle, bundleCommand, canonicalContractHash, classifyStepProperties, clientContextHeaders, compareContract, compareOutput, containsCodeMarkers, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, feedback, feedbackCommand, fetchHealth, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getPreview, getProject, getProjectCommand, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listPreviews, listProjects, listProjectsCommand, listSecrets, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, requestDeviceCode, requireProjectId, resetClientContext, resolveAppUrl, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, simulateCollector, simulateDestination, simulateSource, simulateTransformer, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, validateFlowStructure, whoami, whoamiCommand, wrapSkeleton, writeConfig };