@browserflow-ai/core 0.0.6

package/dist/duration.js

@@ -0,0 +1,111 @@
+/**
+ * Duration string parser
+ *
+ * Parses human-readable duration strings like "30s", "5m", "1h30m"
+ * into milliseconds.
+ *
+ * @see bf-x1q for implementation task
+ */
+const UNITS = {
+    ms: 1,
+    s: 1000,
+    m: 60 * 1000,
+    h: 60 * 60 * 1000,
+};
+/**
+ * Validates a duration string without parsing it.
+ *
+ * @param input - Duration string to validate
+ * @returns true if valid, false otherwise
+ */
+export function isValidDuration(input) {
+    if (typeof input !== 'string') {
+        return false;
+    }
+    const trimmed = input.trim().toLowerCase();
+    if (!trimmed) {
+        return false;
+    }
+    // Plain number (milliseconds)
+    if (/^\d+$/.test(trimmed)) {
+        return true;
+    }
+    // Duration with units
+    const regex = /(\d+(?:\.\d+)?)(ms|s|m|h)/g;
+    let hasMatch = false;
+    // Check if entire string matches expected pattern
+    let lastIndex = 0;
+    let match;
+    while ((match = regex.exec(trimmed)) !== null) {
+        if (match.index !== lastIndex) {
+            return false; // Gap in matching
+        }
+        hasMatch = true;
+        lastIndex = regex.lastIndex;
+    }
+    return hasMatch && lastIndex === trimmed.length;
+}
+/**
+ * Parses a duration string into milliseconds.
+ *
+ * Supported formats:
+ * - "30s" -> 30000
+ * - "5m" -> 300000
+ * - "1h" -> 3600000
+ * - "1h30m" -> 5400000
+ * - "500ms" -> 500
+ * - "500" -> 500 (plain numbers treated as ms)
+ *
+ * @param input - Duration string to parse
+ * @returns Duration in milliseconds
+ * @throws Error if format is invalid
+ */
+export function parseDuration(input) {
+    if (typeof input === 'number') {
+        return input;
+    }
+    if (typeof input !== 'string' || !input.trim()) {
+        throw new Error('Duration must be a non-empty string');
+    }
+    const trimmed = input.trim().toLowerCase();
+    // Plain number (milliseconds)
+    if (/^\d+$/.test(trimmed)) {
+        return parseInt(trimmed, 10);
+    }
+    let total = 0;
+    const regex = /(\d+(?:\.\d+)?)(ms|s|m|h)/g;
+    let match;
+    let hasMatch = false;
+    while ((match = regex.exec(trimmed)) !== null) {
+        hasMatch = true;
+        const [, value, unit] = match;
+        total += parseFloat(value) * UNITS[unit];
+    }
+    if (!hasMatch) {
+        throw new Error(`Invalid duration "${input}". Use format like "3s", "2m", "500ms", or "1m30s"`);
+    }
+    return Math.round(total);
+}
+/**
+ * Formats milliseconds into a human-readable duration string.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Human-readable duration string
+ */
+export function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const hours = Math.floor(ms / 3600000);
+    const minutes = Math.floor((ms % 3600000) / 60000);
+    const seconds = Math.floor((ms % 60000) / 1000);
+    const parts = [];
+    if (hours > 0)
+        parts.push(`${hours}h`);
+    if (minutes > 0)
+        parts.push(`${minutes}m`);
+    if (seconds > 0)
+        parts.push(`${seconds}s`);
+    return parts.join('') || '0s';
+}
+//# sourceMappingURL=duration.js.map

package/dist/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @browserflow-ai/core - Shared types, schemas, and utilities
+ */
+export { specSchema, specStepSchema, stepSchema, actionTypeSchema, verifyCheckSchema, expectedOutcomeSchema, highlightRegionSchema, maskRegionSchema, durationSchema, targetSchema, preconditionsSchema, stateSchema, type ActionType, type VerifyCheck, type HighlightRegion, type MaskRegion, type SpecStep, type LegacySpecStep, type ExpectedOutcome, type BrowserFlowSpec, type Target, type State, type Preconditions, } from './spec-schema.js';
+export { normalizePreconditions, loadSpec } from './spec-loader.js';
+export { type LocatorObject, type LocatorStrategy, type LocatorStrategyType, type LocatorScoping, type LocatorProof, type DOMFingerprint, type BoundingBox, type ResolveOptions, type LocatorMethod, type LocatorArgs, type LegacyLocatorObject, locatorObjectSchema, locatorStrategySchema, locatorStrategyTypeSchema, locatorScopingSchema, locatorProofSchema, domFingerprintSchema, boundingBoxSchema, resolveLocator, strategyToLocator, resolveLegacyLocator, } from './locator-object.js';
+export { type Lockfile, type Mask, type Assertion, type AssertionType, type GenerationMetadata, type ExplorationReport, type ExplorationLockfile, type ExplorationStep, type StepExecution, type OutcomeCheck, type ExplorationError, lockfileSchema, maskSchema, assertionSchema, assertionTypeSchema, generationMetadataSchema, validateLockfile, computeSpecHash, readLockfile, writeLockfile, } from './lockfile.js';
+export { parseDuration, formatDuration, isValidDuration } from './duration.js';
+export { type RunDirectoryPaths, type RunStore, createRunStore, createRunId, getRunPaths, generateExplorationId, getScreenshotPath, } from './run-store.js';
+export { type GeneratorOutputFormat, type BrowserType, type PlaywrightProject, type PlaywrightConfigOptions, type GeneratorConfig, type ReviewStepData, type ReviewData, type GeneratedTest, type GeneratedConfig, } from './config.js';
+export { browserflowConfigSchema, browserTypeSchema, viewportSchema, projectConfigSchema, runtimeConfigSchema, locatorsConfigSchema, explorationConfigSchema, reviewConfigSchema, outputConfigSchema, ciConfigSchema, validateBrowserflowConfig, parseBrowserflowConfig, type BrowserTypeConfig, type ViewportConfig, type ProjectConfig, type RuntimeConfig, type LocatorsConfig, type ExplorationConfig, type ReviewConfig, type OutputConfig, type CiConfig, type BrowserflowConfig, } from './config-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,UAAU,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,cAAc,EACd,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG/E,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @browserflow-ai/core - Shared types, schemas, and utilities
+ */
+// Spec schema and types
+export { specSchema, specStepSchema, stepSchema, actionTypeSchema, verifyCheckSchema, expectedOutcomeSchema, highlightRegionSchema, maskRegionSchema, durationSchema, targetSchema, preconditionsSchema, stateSchema, } from './spec-schema.js';
+// Spec loading and normalization
+export { normalizePreconditions, loadSpec } from './spec-loader.js';
+// Locator types and resolution
+export { locatorObjectSchema, locatorStrategySchema, locatorStrategyTypeSchema, locatorScopingSchema, locatorProofSchema, domFingerprintSchema, boundingBoxSchema, resolveLocator, strategyToLocator, resolveLegacyLocator, } from './locator-object.js';
+// Lockfile types
+export { lockfileSchema, maskSchema, assertionSchema, assertionTypeSchema, generationMetadataSchema, validateLockfile, computeSpecHash, readLockfile, writeLockfile, } from './lockfile.js';
+// Duration utilities
+export { parseDuration, formatDuration, isValidDuration } from './duration.js';
+// Run store utilities
+export { createRunStore, createRunId, getRunPaths, generateExplorationId, getScreenshotPath, } from './run-store.js';
+// Configuration types
+export {} from './config.js';
+// Browserflow config schema (for browserflow.yaml validation)
+export { browserflowConfigSchema, browserTypeSchema, viewportSchema, projectConfigSchema, runtimeConfigSchema, locatorsConfigSchema, explorationConfigSchema, reviewConfigSchema, outputConfigSchema, ciConfigSchema, validateBrowserflowConfig, parseBrowserflowConfig, } from './config-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAwB;AACxB,OAAO,EACL,UAAU,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,WAAW,GAYZ,MAAM,kBAAkB,CAAC;AAE1B,iCAAiC;AACjC,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEpE,+BAA+B;AAC/B,OAAO,EAYL,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EAYL,cAAc,EACd,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/E,sBAAsB;AACtB,OAAO,EAGL,cAAc,EACd,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,sBAAsB;AACtB,OAAO,EAUN,MAAM,aAAa,CAAC;AAErB,8DAA8D;AAC9D,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,sBAAsB,GAWvB,MAAM,oBAAoB,CAAC"}