@showrun/core 0.1.0

package/dist/dsl/target.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Target resolution utilities
+ * Converts Target types to Playwright Locators
+ */
+import type { Locator, Page, Frame } from 'playwright';
+import type { Target, TargetOrAnyOf } from './types.js';
+/**
+ * Type that can resolve locators (Page, Frame, or Locator)
+ */
+export type LocatorSource = Page | Frame | Locator;
+/**
+ * Resolves a single Target to a Playwright Locator
+ */
+export declare function resolveTarget(source: LocatorSource, target: Target): Locator;
+/**
+ * Resolves TargetOrAnyOf with fallback support
+ * Tries each target in order until one yields at least one element
+ */
+export declare function resolveTargetWithFallback(source: LocatorSource, targetOrAnyOf: TargetOrAnyOf, scope?: Target): Promise<{
+    locator: Locator;
+    matchedTarget: Target;
+    matchedCount: number;
+}>;
+/**
+ * Converts legacy selector string to Target for backward compatibility
+ */
+export declare function selectorToTarget(selector: string): Target;
+//# sourceMappingURL=target.d.ts.map

package/dist/dsl/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/dsl/target.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC;AAgBnD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAmDT;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,aAAa,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/dsl/target.js

@@ -0,0 +1,110 @@
+/**
+ * Target resolution utilities
+ * Converts Target types to Playwright Locators
+ */
+/**
+ * Check if the source is a Page (has goto method)
+ */
+function isPage(source) {
+    return 'goto' in source && typeof source.goto === 'function';
+}
+/**
+ * Check if the source is a Frame (has url method but not goto)
+ */
+function isFrame(source) {
+    return 'url' in source && typeof source.url === 'function' && !('goto' in source);
+}
+/**
+ * Resolves a single Target to a Playwright Locator
+ */
+export function resolveTarget(source, target) {
+    // Check if it's a Page or Frame (both have similar locator methods)
+    if (isPage(source) || isFrame(source)) {
+        switch (target.kind) {
+            case 'css':
+                return source.locator(target.selector);
+            case 'text':
+                return source.getByText(target.text, { exact: target.exact ?? false });
+            case 'role':
+                return source.getByRole(target.role, {
+                    name: target.name,
+                    exact: target.exact ?? false,
+                });
+            case 'label':
+                return source.getByLabel(target.text, { exact: target.exact ?? false });
+            case 'placeholder':
+                return source.getByPlaceholder(target.text, { exact: target.exact ?? false });
+            case 'altText':
+                return source.getByAltText(target.text, { exact: target.exact ?? false });
+            case 'testId':
+                return source.getByTestId(target.id);
+            default:
+                const _exhaustive = target;
+                throw new Error(`Unknown target kind: ${_exhaustive.kind}`);
+        }
+    }
+    else {
+        // It's a Locator
+        const locator = source;
+        switch (target.kind) {
+            case 'css':
+                return locator.locator(target.selector);
+            case 'text':
+                return locator.getByText(target.text, { exact: target.exact ?? false });
+            case 'role':
+                return locator.getByRole(target.role, {
+                    name: target.name,
+                    exact: target.exact ?? false,
+                });
+            case 'label':
+                return locator.getByLabel(target.text, { exact: target.exact ?? false });
+            case 'placeholder':
+                return locator.getByPlaceholder(target.text, { exact: target.exact ?? false });
+            case 'altText':
+                return locator.getByAltText(target.text, { exact: target.exact ?? false });
+            case 'testId':
+                return locator.getByTestId(target.id);
+            default:
+                const _exhaustive = target;
+                throw new Error(`Unknown target kind: ${_exhaustive.kind}`);
+        }
+    }
+}
+/**
+ * Resolves TargetOrAnyOf with fallback support
+ * Tries each target in order until one yields at least one element
+ */
+export async function resolveTargetWithFallback(source, targetOrAnyOf, scope) {
+    // Resolve scope first if provided
+    const baseLocator = scope ? resolveTarget(source, scope) : source;
+    // Handle single target
+    if (!('anyOf' in targetOrAnyOf)) {
+        const locator = resolveTarget(baseLocator, targetOrAnyOf);
+        const count = await locator.count();
+        return { locator, matchedTarget: targetOrAnyOf, matchedCount: count };
+    }
+    // Handle anyOf fallback
+    const targets = targetOrAnyOf.anyOf;
+    let lastError = null;
+    for (const target of targets) {
+        try {
+            const locator = resolveTarget(baseLocator, target);
+            const count = await locator.count();
+            if (count > 0) {
+                return { locator, matchedTarget: target, matchedCount: count };
+            }
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Continue to next target
+        }
+    }
+    // None matched
+    throw new Error(`No target matched. Tried ${targets.length} target(s). ${lastError ? `Last error: ${lastError.message}` : ''}`);
+}
+/**
+ * Converts legacy selector string to Target for backward compatibility
+ */
+export function selectorToTarget(selector) {
+    return { kind: 'css', selector };
+}

package/dist/dsl/templating.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Templating for DSL steps using Nunjucks renderString only.
+ * Supports {{inputs.key}} / {{vars.key}} and built-in filters (e.g. {{inputs.x | urlencode}}).
+ * Uses a minimal Environment with no loaders. Custom filters are limited to safe, pure functions.
+ */
+import type { VariableContext } from './types.js';
+/**
+ * Resolves a template string using variable context (Nunjucks renderString).
+ * Built-in filters available, e.g. {{ inputs.page | urlencode }}.
+ * Supports: {{inputs.x}}, {{vars.x}}, {{secret.x}}
+ */
+export declare function resolveTemplate(template: string, context: VariableContext): string;
+/**
+ * Recursively resolves templates in an object (strings use Nunjucks renderString).
+ */
+export declare function resolveTemplates<T>(obj: T, context: VariableContext): T;
+/**
+ * Checks if a string contains template syntax ({{ ... }}).
+ */
+export declare function hasTemplate(str: string): boolean;
+//# sourceMappingURL=templating.d.ts.map

package/dist/dsl/templating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.d.ts","sourceRoot":"","sources":["../../src/dsl/templating.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0BlD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAWlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,CAAC,CAkBvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/dist/dsl/templating.js

@@ -0,0 +1,73 @@
+/**
+ * Templating for DSL steps using Nunjucks renderString only.
+ * Supports {{inputs.key}} / {{vars.key}} and built-in filters (e.g. {{inputs.x | urlencode}}).
+ * Uses a minimal Environment with no loaders. Custom filters are limited to safe, pure functions.
+ */
+import nunjucks from 'nunjucks';
+import { authenticator } from 'otplib';
+/** Minimal env: null loader (renderString only), allow undefined for optional inputs. */
+const env = new nunjucks.Environment(null, {
+    autoescape: false,
+    throwOnUndefined: false, // Allow undefined values to render as empty string
+});
+/**
+ * TOTP filter: generates a 6-digit TOTP code from a base32 secret.
+ * Usage: {{secret.TOTP_KEY | totp}}
+ *
+ * This is a pure function (RFC 6238) - no code execution risk.
+ */
+env.addFilter('totp', (secret) => {
+    if (!secret || typeof secret !== 'string') {
+        throw new Error('totp filter requires a non-empty string (base32 secret)');
+    }
+    try {
+        return authenticator.generate(secret.trim().replace(/\s/g, ''));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`TOTP generation failed: ${msg}`);
+    }
+});
+/**
+ * Resolves a template string using variable context (Nunjucks renderString).
+ * Built-in filters available, e.g. {{ inputs.page | urlencode }}.
+ * Supports: {{inputs.x}}, {{vars.x}}, {{secret.x}}
+ */
+export function resolveTemplate(template, context) {
+    try {
+        return env.renderString(template, {
+            inputs: context.inputs,
+            vars: context.vars,
+            secret: context.secrets || {},
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Template resolution failed: ${msg}`);
+    }
+}
+/**
+ * Recursively resolves templates in an object (strings use Nunjucks renderString).
+ */
+export function resolveTemplates(obj, context) {
+    if (typeof obj === 'string') {
+        return resolveTemplate(obj, context);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => resolveTemplates(item, context));
+    }
+    if (obj && typeof obj === 'object') {
+        const resolved = {};
+        for (const [key, value] of Object.entries(obj)) {
+            resolved[key] = resolveTemplates(value, context);
+        }
+        return resolved;
+    }
+    return obj;
+}
+/**
+ * Checks if a string contains template syntax ({{ ... }}).
+ */
+export function hasTemplate(str) {
+    return typeof str === 'string' && str.includes('{{');
+}