@walkeros/cli 1.1.3 → 1.3.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { Flow, Elb } from '@walkeros/core';
 export { Flow } from '@walkeros/core';
 import { BuildOptions as BuildOptions$1 } from 'esbuild';
+import { z } from '@walkeros/core/dev';
 
 /**
  * CLI Build Configuration
@@ -162,6 +163,25 @@ interface GlobalOptions {
     silent?: boolean;
 }
 
+/**
+ * Input Detector
+ *
+ * Detects whether CLI input is a config JSON or pre-built bundle.
+ * Supports both local files and URLs.
+ */
+type Platform$1 = 'web' | 'server';
+
+declare function getToken(): string | undefined;
+declare function getAuthHeaders(): Record<string, string>;
+declare function authenticatedFetch(url: string, init?: RequestInit): Promise<Response>;
+declare function resolveBaseUrl(): string;
+declare function requireProjectId(): string;
+interface ApiRequestOptions extends RequestInit {
+    responseFormat?: 'json' | 'raw';
+    timeout?: number;
+}
+declare function apiRequest(path: string, options?: ApiRequestOptions): Promise<unknown>;
+
 interface BundleStats {
     totalSize: number;
     packages: {
@@ -173,7 +193,8 @@ interface BundleStats {
 }
 
 interface BundleCommandOptions {
-    config: string;
+    config?: string;
+    output?: string;
     flow?: string;
     all?: boolean;
     stats?: boolean;
@@ -239,7 +260,8 @@ interface ApiCall {
 }
 
 interface SimulateCommandOptions {
-    config: string;
+    config?: string;
+    output?: string;
     event?: string;
     flow?: string;
     json?: boolean;
@@ -257,6 +279,36 @@ interface SimulationResult {
     duration?: number;
 }
 
+/**
+ * Simulate Command Schemas
+ *
+ * Zod schemas for simulate command parameter validation.
+ */
+
+/**
+ * Platform schema.
+ *
+ * @remarks
+ * Validates platform type for event simulation.
+ */
+declare const PlatformSchema: z.ZodEnum<{
+    web: "web";
+    server: "server";
+}>;
+type Platform = z.infer<typeof PlatformSchema>;
+/**
+ * Simulate options schema.
+ *
+ * @remarks
+ * Options for the programmatic simulate() API.
+ */
+declare const SimulateOptionsSchema: z.ZodObject<{
+    silent: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;
+
 /**
  * CLI command handler for simulate command
  */
@@ -295,29 +347,83 @@ declare function simulateCommand(options: SimulateCommandOptions): Promise<void>
  * );
  * ```
  */
-declare function simulate(configOrPath: string | unknown, event: unknown, options?: {
-    silent?: boolean;
-    verbose?: boolean;
-    json?: boolean;
+declare function simulate(configOrPath: string | unknown, event: unknown, options?: SimulateOptions & {
+    flow?: string;
+    platform?: Platform;
 }): Promise<SimulationResult>;
 
 /**
  * Push command options
  */
 interface PushCommandOptions {
-    config: string;
+    config?: string;
     event: string;
+    output?: string;
     flow?: string;
     json?: boolean;
     verbose?: boolean;
     silent?: boolean;
     platform?: 'web' | 'server';
 }
+/**
+ * Push execution result
+ */
+interface PushResult {
+    success: boolean;
+    elbResult?: Elb.PushResult;
+    duration: number;
+    error?: string;
+}
+
+/**
+ * Push Command Schemas
+ *
+ * Zod schemas for push command parameter validation.
+ */
+
+/**
+ * Push options schema.
+ *
+ * @remarks
+ * Options for the programmatic push() API.
+ */
+declare const PushOptionsSchema: z.ZodObject<{
+    silent: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type PushOptions = z.infer<typeof PushOptionsSchema>;
 
 /**
  * CLI command handler for push command
  */
 declare function pushCommand(options: PushCommandOptions): Promise<void>;
+/**
+ * High-level push function for programmatic usage.
+ *
+ * WARNING: This makes real API calls to real endpoints.
+ * Events will be sent to configured destinations (analytics, CRM, etc.).
+ *
+ * @param configOrPath - Path to flow configuration file or pre-built bundle
+ * @param event - Event object to push
+ * @param options - Push options
+ * @param options.silent - Suppress all output (default: false)
+ * @param options.verbose - Enable verbose logging (default: false)
+ * @param options.json - Format output as JSON (default: false)
+ * @returns Push result with success status, elb result, and duration
+ *
+ * @example
+ * ```typescript
+ * const result = await push('./walker.config.json', {
+ *   name: 'page view',
+ *   data: { title: 'Home Page', path: '/', url: 'https://example.com' }
+ * });
+ * ```
+ */
+declare function push(configOrPath: string | unknown, event: unknown, options?: PushOptions & {
+    flow?: string;
+    platform?: Platform$1;
+}): Promise<PushResult>;
 
 /**
  * Run Command Types
@@ -419,4 +525,81 @@ declare function runCommand(mode: string, options: RunCommandOptions): Promise<v
  */
 declare function run(mode: RunMode, options: RunOptions): Promise<RunResult>;
 
-export { type BuildOptions, type BundleStats, type CLIBuildOptions, type GlobalOptions, type MinifyOptions, type RunCommandOptions, type RunMode, type RunOptions, type RunResult, type SimulationResult, bundle, bundleCommand, pushCommand, run, runCommand, simulate, simulateCommand };
+type ValidationType = 'event' | 'flow' | 'mapping';
+interface ValidationError {
+    path: string;
+    message: string;
+    value?: unknown;
+    code?: string;
+}
+interface ValidationWarning {
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+interface ValidateResult {
+    valid: boolean;
+    type: ValidationType;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    details: Record<string, unknown>;
+}
+
+/**
+ * Programmatic API for validation.
+ * Can be called directly from code or MCP server.
+ */
+declare function validate(type: ValidationType, input: unknown, options?: {
+    flow?: string;
+}): Promise<ValidateResult>;
+
+declare function listProjects(): Promise<unknown>;
+declare function getProject(options?: {
+    projectId?: string;
+}): Promise<unknown>;
+declare function createProject(options: {
+    name: string;
+}): Promise<unknown>;
+declare function updateProject(options: {
+    projectId?: string;
+    name: string;
+}): Promise<unknown>;
+declare function deleteProject(options?: {
+    projectId?: string;
+}): Promise<unknown>;
+
+declare function whoami(): Promise<unknown>;
+
+interface ListFlowsOptions {
+    projectId?: string;
+    sort?: 'name' | 'updated_at' | 'created_at';
+    order?: 'asc' | 'desc';
+    includeDeleted?: boolean;
+}
+declare function listFlows(options?: ListFlowsOptions): Promise<unknown>;
+declare function getFlow(options: {
+    flowId: string;
+    projectId?: string;
+}): Promise<unknown>;
+declare function createFlow(options: {
+    name: string;
+    content: Record<string, unknown>;
+    projectId?: string;
+}): Promise<unknown>;
+declare function updateFlow(options: {
+    flowId: string;
+    name?: string;
+    content?: Record<string, unknown>;
+    projectId?: string;
+}): Promise<unknown>;
+declare function deleteFlow(options: {
+    flowId: string;
+    projectId?: string;
+}): Promise<unknown>;
+declare function duplicateFlow(options: {
+    flowId: string;
+    name?: string;
+    projectId?: string;
+}): Promise<unknown>;
+
+export { type ApiRequestOptions, type BuildOptions, type BundleStats, type CLIBuildOptions, type GlobalOptions, type ListFlowsOptions, type MinifyOptions, type PushResult, type RunCommandOptions, type RunMode, type RunOptions, type RunResult, type SimulationResult, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, apiRequest, authenticatedFetch, bundle, bundleCommand, createFlow, createProject, deleteFlow, deleteProject, duplicateFlow, getAuthHeaders, getFlow, getProject, getToken, listFlows, listProjects, push, pushCommand, requireProjectId, resolveBaseUrl, run, runCommand, simulate, simulateCommand, updateFlow, updateProject, validate, whoami };