@sweny-ai/core 0.1.31 → 0.1.33

package/dist/cli/e2e.d.ts

@@ -0,0 +1,82 @@
+/**
+ * sweny e2e — Generate and run agent-driven end-to-end browser tests.
+ *
+ * Pure functions for workflow generation + thin @clack/prompts interactive layer.
+ * Tests cover the pure functions; the interactive wizard is thin glue.
+ */
+import type { Workflow, Node } from "../types.js";
+export type FlowType = "registration" | "login" | "purchase" | "onboarding" | "upgrade" | "cancellation" | "custom";
+export interface FlowConfig {
+    type: FlowType;
+    /** URL path for the flow (e.g. /signup, /login, /pricing) */
+    path: string;
+    /** Required form fields (registration only) */
+    fields?: string[];
+    /** Whether email verification is required (registration only) */
+    emailVerification?: boolean;
+    /** Success redirect path (registration only) */
+    successRedirect?: string;
+    /** Payment provider name (purchase only) */
+    paymentProvider?: string;
+    /** Free-text description (custom flow only) */
+    description?: string;
+    /** What constitutes success (most flow types) */
+    successCriteria?: string;
+}
+export interface CleanupConfig {
+    enabled: boolean;
+    backend?: string;
+}
+export interface E2eSelections {
+    flows: FlowConfig[];
+    baseUrl: string;
+    cleanup: CleanupConfig;
+}
+/**
+ * Replace {var_name} placeholders in text with values from the vars map.
+ * Unknown variables are left untouched.
+ */
+export declare function resolveTemplateVars(text: string, vars: Record<string, string>): string;
+/**
+ * Build the template variable map from environment variables.
+ * Auto-generates run_id, test_email, test_password.
+ * Reads E2E_BASE_URL, E2E_EMAIL, E2E_PASSWORD, and any E2E_* custom vars.
+ */
+export declare function buildE2eVars(env: Record<string, string | undefined>): Record<string, string>;
+export declare function buildSetupNode(): Node;
+export declare function buildReportNode(testNodeIds: string[]): Node;
+export declare function buildCleanupNode(backend?: string): Node;
+interface FlowNodes {
+    nodes: Record<string, Node>;
+    testNodeIds: string[];
+}
+/**
+ * Build the test nodes for a given flow type.
+ * Auth-dependent flows (purchase, onboarding, upgrade, cancellation)
+ * automatically include a login node.
+ */
+export declare function buildFlowNodes(config: FlowConfig): FlowNodes;
+/**
+ * Build a complete Workflow object for a single e2e flow.
+ * Includes setup node, optional login, flow-specific test node,
+ * optional cleanup, and report node.
+ */
+export declare function buildFlowWorkflow(flow: FlowConfig, baseUrl: string, cleanup?: CleanupConfig): Workflow;
+/**
+ * Build .env template content for e2e testing.
+ */
+export declare function buildE2eEnvTemplate(selections: E2eSelections): string;
+/**
+ * Interactive E2E setup wizard — prompts through flow selection,
+ * then generates .sweny/e2e/*.yml and .env additions.
+ */
+export declare function runE2eInit(): Promise<void>;
+export interface E2eRunOptions {
+    file?: string;
+    timeout?: number;
+}
+/**
+ * Load and execute e2e workflow files from .sweny/e2e/.
+ */
+export declare function runE2eRun(options: E2eRunOptions): Promise<void>;
+export {};