@aplaytest/core 0.1.0

package/dist-cjs/history/url.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Where history lives, expressed as one string.
+ *
+ * `--db` was already the only knob naming the store, and every consumer — the
+ * CLI, the generated workflows, `atest.config.ts` — passes it around as an
+ * opaque path. Making it a URL rather than adding `--history-account`,
+ * `--history-container` and `--history-prefix` means the blob backend needs no
+ * new flag anywhere, and a repo switches from a local file to Azure by
+ * changing one repository variable.
+ *
+ * Parsing lives in core because it is pure string work that the CLI, the
+ * Azure driver and `doctor` all need, and because a typo in a container name
+ * should fail with a readable message before any credential is acquired. The
+ * network code that acts on the result lives in `@aplaytest/store-azure`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoryUrlError = exports.DEFAULT_BLOB_ENDPOINT_SUFFIX = void 0;
+exports.parseHistoryUrl = parseHistoryUrl;
+exports.describeHistoryTarget = describeHistoryTarget;
+exports.DEFAULT_BLOB_ENDPOINT_SUFFIX = 'blob.core.windows.net';
+/** Azure's rule, enforced here so the failure names the field. */
+const CONTAINER_NAME = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const ACCOUNT_NAME = /^[a-z0-9]{3,24}$/;
+class HistoryUrlError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HistoryUrlError';
+    }
+}
+exports.HistoryUrlError = HistoryUrlError;
+function parseWindowDays(params) {
+    const raw = params.get('window');
+    if (raw === null)
+        return null;
+    const days = Number.parseInt(raw, 10);
+    if (!Number.isInteger(days) || days < 1) {
+        throw new HistoryUrlError(`?window= must be a positive integer number of days, got "${raw}".`);
+    }
+    return days;
+}
+function normalisePrefix(segments) {
+    const joined = segments.filter(s => s !== '').join('/');
+    return joined === '' ? '' : `${joined}/`;
+}
+function azureTarget(url, serviceUrl, account, segments) {
+    const container = segments[0];
+    if (container === undefined || container === '') {
+        throw new HistoryUrlError(`"${url.href}" names no container. Expected azblob://<account>/<container>[/<prefix>].`);
+    }
+    if (container.length < 3 || container.length > 63 || !CONTAINER_NAME.test(container)) {
+        throw new HistoryUrlError(`"${container}" is not a valid container name — 3-63 chars, lowercase letters, digits and single dashes.`);
+    }
+    if (!ACCOUNT_NAME.test(account)) {
+        throw new HistoryUrlError(`"${account}" is not a valid storage account name — 3-24 lowercase alphanumerics.`);
+    }
+    const readOnly = url.searchParams.get('readonly');
+    return {
+        kind: 'azure-blob',
+        serviceUrl,
+        account,
+        container,
+        prefix: normalisePrefix(segments.slice(1)),
+        windowDays: parseWindowDays(url.searchParams),
+        // Present-but-empty (`?readonly`) counts as on, because that is what
+        // somebody typing it means. Only an explicit falsy value turns it off.
+        readOnly: readOnly !== null && readOnly !== '0' && readOnly !== 'false',
+    };
+}
+/**
+ * Accepted forms:
+ *
+ *   :memory:                                        throwaway (not the config default)
+ *   .atest/history.sqlite                           a local file
+ *   azblob://<account>/<container>[/<prefix>]       Azure, via the DNS suffix
+ *   https://<account>.blob.core.windows.net/<c>/<p> Azure, fully qualified
+ *   http://127.0.0.1:10000/<account>/<c>/<p>        Azurite, account in path
+ *
+ * Anything unrecognised is a FILE PATH, not an error. `--db` has always taken
+ * one, and a Windows path like `C:\atest\history.sqlite` parses as a URL with
+ * scheme `c:` — rejecting unknown schemes would break the case the flag was
+ * built for.
+ */
+function parseHistoryUrl(url, options = {}) {
+    const trimmed = url.trim();
+    if (trimmed === ':memory:' || trimmed === '')
+        return { kind: 'memory' };
+    if (trimmed.startsWith('azblob://')) {
+        const suffix = options.endpointSuffix ?? exports.DEFAULT_BLOB_ENDPOINT_SUFFIX;
+        const parsed = new URL(trimmed);
+        // `azblob://acct/container` puts the account in the authority, so it is
+        // already lowercased and stripped of a path by the URL parser.
+        const account = parsed.hostname;
+        const segments = parsed.pathname.split('/').filter(s => s !== '');
+        return azureTarget(parsed, `https://${account}.${suffix}`, account, segments);
+    }
+    if (trimmed.startsWith('https://') || trimmed.startsWith('http://')) {
+        const parsed = new URL(trimmed);
+        const segments = parsed.pathname.split('/').filter(s => s !== '');
+        const subdomain = /^([a-z0-9]{3,24})\.blob\./.exec(parsed.hostname);
+        if (subdomain !== null && subdomain[1] !== undefined) {
+            return azureTarget(parsed, parsed.origin, subdomain[1], segments);
+        }
+        // Emulator convention: the account is the first path segment because
+        // Azurite serves every account from one host.
+        const account = segments[0];
+        if (account === undefined) {
+            throw new HistoryUrlError(`"${trimmed}" is not a blob endpoint. Expected <account>.${exports.DEFAULT_BLOB_ENDPOINT_SUFFIX}/<container>, ` +
+                `or an emulator URL with the account as the first path segment.`);
+        }
+        return azureTarget(parsed, `${parsed.origin}/${account}`, account, segments.slice(1));
+    }
+    return { kind: 'sqlite', path: trimmed };
+}
+/** Short, log-safe description. Used by `doctor` and every "what am I reading?" line. */
+function describeHistoryTarget(target) {
+    switch (target.kind) {
+        case 'memory':
+            return 'in-memory (discarded when the process exits)';
+        case 'sqlite':
+            return `sqlite · ${target.path}`;
+        case 'azure-blob':
+            return (`azure blob · ${target.account}/${target.container}/${target.prefix}` +
+                (target.readOnly ? ' (read-only)' : ''));
+    }
+}
+//# sourceMappingURL=url.js.map

package/dist-cjs/history/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/history/url.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AA6HH,0CAoCC;AAGD,sDAYC;AAnIY,QAAA,4BAA4B,GAAG,uBAAuB,CAAC;AAEpE,kEAAkE;AAClE,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAClD,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAExC,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,SAAS,eAAe,CAAC,MAAuB;IAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,eAAe,CAAC,4DAA4D,GAAG,IAAI,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,QAA2B;IAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAClB,GAAQ,EACR,UAAkB,EAClB,OAAe,EACf,QAA2B;IAE3B,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,eAAe,CACvB,IAAI,GAAG,CAAC,IAAI,2EAA2E,CACxF,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,eAAe,CACvB,IAAI,SAAS,4FAA4F,CAC1G,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,eAAe,CACvB,IAAI,OAAO,uEAAuE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAElD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,UAAU;QACV,OAAO;QACP,SAAS;QACT,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1C,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC;QAC7C,qEAAqE;QACrE,uEAAuE;QACvE,QAAQ,EAAE,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,OAAO;KACxE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAAC,GAAW,EAAE,UAAkC,EAAE;IAC/E,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAExE,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,oCAA4B,CAAC;QACtE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,wEAAwE;QACxE,+DAA+D;QAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAClE,OAAO,WAAW,CAAC,MAAM,EAAE,WAAW,OAAO,IAAI,MAAM,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEpE,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACrD,OAAO,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;QAED,qEAAqE;QACrE,8CAA8C;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,eAAe,CACvB,IAAI,OAAO,gDAAgD,oCAA4B,gBAAgB;gBACrG,gEAAgE,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC;AAED,yFAAyF;AACzF,SAAgB,qBAAqB,CAAC,MAAqB;IACzD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,8CAA8C,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,YAAY,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,KAAK,YAAY;YACf,OAAO,CACL,gBAAgB,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE;gBACrE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CACxC,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist-cjs/index.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * @aplaytest/core — types, failure taxonomy, locator ranking, and configuration.
+ *
+ * This package has no Playwright dependency, makes no network calls, and never
+ * touches a model. Everything here must be unit-testable in isolation; that
+ * constraint is what keeps the engines above it testable too.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtestConfigSchema = exports.defineAtestConfig = exports.mapPlaywrightReport = exports.ingestPlaywrightJson = exports.ingestDirectory = exports.DEFAULT_BLOB_ENDPOINT_SUFFIX = exports.HistoryUrlError = exports.describeHistoryTarget = exports.parseHistoryUrl = exports.shardKeyOf = exports.MemoryHistoryStore = exports.HistoryIndex = exports.SqliteHistoryStore = exports.isConclusive = exports.isFailure = exports.RUN_SCHEMA_VERSION = exports.isEvidenceBundle = exports.parseEvidenceBundle = exports.loadRunBundles = exports.SchemaVersionError = exports.EvidenceStore = exports.REDACTED = exports.redactUrl = exports.redactString = exports.redact = exports.isEvidenceId = exports.evidenceId = exports.formatFailingStep = exports.EVIDENCE_SCHEMA_VERSION = exports.ATEST_VERSION = exports.testIdDistance = exports.stabilityDelta = exports.stabilityRankOf = exports.parseLocator = exports.MAX_STABILITY_RANK = exports.STABILITY_RANK = exports.LOCATOR_STRATEGIES = exports.joinErrors = exports.stripCodeFrame = exports.stripAnsi = exports.splitCallLog = exports.parsePlaywrightError = exports.listRules = exports.classify = exports.countsTowardFlakeStats = exports.isHealable = exports.healEligibility = exports.ROUTING = exports.NEVER_HEAL = exports.FAILURE_KINDS = void 0;
+exports.AGGRESSIVENESS_PRESETS = exports.AggressivenessSchema = exports.ExecutionModeSchema = void 0;
+// Taxonomy
+var kinds_js_1 = require("./taxonomy/kinds.js");
+Object.defineProperty(exports, "FAILURE_KINDS", { enumerable: true, get: function () { return kinds_js_1.FAILURE_KINDS; } });
+Object.defineProperty(exports, "NEVER_HEAL", { enumerable: true, get: function () { return kinds_js_1.NEVER_HEAL; } });
+Object.defineProperty(exports, "ROUTING", { enumerable: true, get: function () { return kinds_js_1.ROUTING; } });
+Object.defineProperty(exports, "healEligibility", { enumerable: true, get: function () { return kinds_js_1.healEligibility; } });
+Object.defineProperty(exports, "isHealable", { enumerable: true, get: function () { return kinds_js_1.isHealable; } });
+Object.defineProperty(exports, "countsTowardFlakeStats", { enumerable: true, get: function () { return kinds_js_1.countsTowardFlakeStats; } });
+var classify_js_1 = require("./taxonomy/classify.js");
+Object.defineProperty(exports, "classify", { enumerable: true, get: function () { return classify_js_1.classify; } });
+Object.defineProperty(exports, "listRules", { enumerable: true, get: function () { return classify_js_1.listRules; } });
+var parse_error_js_1 = require("./taxonomy/parse-error.js");
+Object.defineProperty(exports, "parsePlaywrightError", { enumerable: true, get: function () { return parse_error_js_1.parsePlaywrightError; } });
+Object.defineProperty(exports, "splitCallLog", { enumerable: true, get: function () { return parse_error_js_1.splitCallLog; } });
+Object.defineProperty(exports, "stripAnsi", { enumerable: true, get: function () { return parse_error_js_1.stripAnsi; } });
+Object.defineProperty(exports, "stripCodeFrame", { enumerable: true, get: function () { return parse_error_js_1.stripCodeFrame; } });
+Object.defineProperty(exports, "joinErrors", { enumerable: true, get: function () { return parse_error_js_1.joinErrors; } });
+// Locators
+var stability_js_1 = require("./locator/stability.js");
+Object.defineProperty(exports, "LOCATOR_STRATEGIES", { enumerable: true, get: function () { return stability_js_1.LOCATOR_STRATEGIES; } });
+Object.defineProperty(exports, "STABILITY_RANK", { enumerable: true, get: function () { return stability_js_1.STABILITY_RANK; } });
+Object.defineProperty(exports, "MAX_STABILITY_RANK", { enumerable: true, get: function () { return stability_js_1.MAX_STABILITY_RANK; } });
+Object.defineProperty(exports, "parseLocator", { enumerable: true, get: function () { return stability_js_1.parseLocator; } });
+Object.defineProperty(exports, "stabilityRankOf", { enumerable: true, get: function () { return stability_js_1.stabilityRankOf; } });
+Object.defineProperty(exports, "stabilityDelta", { enumerable: true, get: function () { return stability_js_1.stabilityDelta; } });
+Object.defineProperty(exports, "testIdDistance", { enumerable: true, get: function () { return stability_js_1.testIdDistance; } });
+// Identity
+var version_js_1 = require("./version.js");
+Object.defineProperty(exports, "ATEST_VERSION", { enumerable: true, get: function () { return version_js_1.ATEST_VERSION; } });
+// Evidence
+var types_js_1 = require("./evidence/types.js");
+Object.defineProperty(exports, "EVIDENCE_SCHEMA_VERSION", { enumerable: true, get: function () { return types_js_1.EVIDENCE_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "formatFailingStep", { enumerable: true, get: function () { return types_js_1.formatFailingStep; } });
+var id_js_1 = require("./evidence/id.js");
+Object.defineProperty(exports, "evidenceId", { enumerable: true, get: function () { return id_js_1.evidenceId; } });
+Object.defineProperty(exports, "isEvidenceId", { enumerable: true, get: function () { return id_js_1.isEvidenceId; } });
+var redact_js_1 = require("./evidence/redact.js");
+Object.defineProperty(exports, "redact", { enumerable: true, get: function () { return redact_js_1.redact; } });
+Object.defineProperty(exports, "redactString", { enumerable: true, get: function () { return redact_js_1.redactString; } });
+Object.defineProperty(exports, "redactUrl", { enumerable: true, get: function () { return redact_js_1.redactUrl; } });
+Object.defineProperty(exports, "REDACTED", { enumerable: true, get: function () { return redact_js_1.REDACTED; } });
+var store_js_1 = require("./evidence/store.js");
+Object.defineProperty(exports, "EvidenceStore", { enumerable: true, get: function () { return store_js_1.EvidenceStore; } });
+Object.defineProperty(exports, "SchemaVersionError", { enumerable: true, get: function () { return store_js_1.SchemaVersionError; } });
+Object.defineProperty(exports, "loadRunBundles", { enumerable: true, get: function () { return store_js_1.loadRunBundles; } });
+Object.defineProperty(exports, "parseEvidenceBundle", { enumerable: true, get: function () { return store_js_1.parseEvidenceBundle; } });
+Object.defineProperty(exports, "isEvidenceBundle", { enumerable: true, get: function () { return store_js_1.isEvidenceBundle; } });
+// History
+var types_js_2 = require("./history/types.js");
+Object.defineProperty(exports, "RUN_SCHEMA_VERSION", { enumerable: true, get: function () { return types_js_2.RUN_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "isFailure", { enumerable: true, get: function () { return types_js_2.isFailure; } });
+Object.defineProperty(exports, "isConclusive", { enumerable: true, get: function () { return types_js_2.isConclusive; } });
+var store_js_2 = require("./history/store.js");
+Object.defineProperty(exports, "SqliteHistoryStore", { enumerable: true, get: function () { return store_js_2.SqliteHistoryStore; } });
+var memory_index_js_1 = require("./history/memory-index.js");
+Object.defineProperty(exports, "HistoryIndex", { enumerable: true, get: function () { return memory_index_js_1.HistoryIndex; } });
+Object.defineProperty(exports, "MemoryHistoryStore", { enumerable: true, get: function () { return memory_index_js_1.MemoryHistoryStore; } });
+Object.defineProperty(exports, "shardKeyOf", { enumerable: true, get: function () { return memory_index_js_1.shardKeyOf; } });
+var url_js_1 = require("./history/url.js");
+Object.defineProperty(exports, "parseHistoryUrl", { enumerable: true, get: function () { return url_js_1.parseHistoryUrl; } });
+Object.defineProperty(exports, "describeHistoryTarget", { enumerable: true, get: function () { return url_js_1.describeHistoryTarget; } });
+Object.defineProperty(exports, "HistoryUrlError", { enumerable: true, get: function () { return url_js_1.HistoryUrlError; } });
+Object.defineProperty(exports, "DEFAULT_BLOB_ENDPOINT_SUFFIX", { enumerable: true, get: function () { return url_js_1.DEFAULT_BLOB_ENDPOINT_SUFFIX; } });
+var ingest_js_1 = require("./history/ingest.js");
+Object.defineProperty(exports, "ingestDirectory", { enumerable: true, get: function () { return ingest_js_1.ingestDirectory; } });
+var ingest_playwright_js_1 = require("./history/ingest-playwright.js");
+Object.defineProperty(exports, "ingestPlaywrightJson", { enumerable: true, get: function () { return ingest_playwright_js_1.ingestPlaywrightJson; } });
+var playwright_report_js_1 = require("./history/playwright-report.js");
+Object.defineProperty(exports, "mapPlaywrightReport", { enumerable: true, get: function () { return playwright_report_js_1.mapPlaywrightReport; } });
+// Config
+var schema_js_1 = require("./config/schema.js");
+Object.defineProperty(exports, "defineAtestConfig", { enumerable: true, get: function () { return schema_js_1.defineAtestConfig; } });
+Object.defineProperty(exports, "AtestConfigSchema", { enumerable: true, get: function () { return schema_js_1.AtestConfigSchema; } });
+Object.defineProperty(exports, "ExecutionModeSchema", { enumerable: true, get: function () { return schema_js_1.ExecutionModeSchema; } });
+Object.defineProperty(exports, "AggressivenessSchema", { enumerable: true, get: function () { return schema_js_1.AggressivenessSchema; } });
+Object.defineProperty(exports, "AGGRESSIVENESS_PRESETS", { enumerable: true, get: function () { return schema_js_1.AGGRESSIVENESS_PRESETS; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AAEH,WAAW;AACX,gDAO6B;AAN3B,yGAAA,aAAa,OAAA;AACb,sGAAA,UAAU,OAAA;AACV,mGAAA,OAAO,OAAA;AACP,2GAAA,eAAe,OAAA;AACf,sGAAA,UAAU,OAAA;AACV,kHAAA,sBAAsB,OAAA;AASxB,sDAA6D;AAApD,uGAAA,QAAQ,OAAA;AAAE,wGAAA,SAAS,OAAA;AAG5B,4DAMmC;AALjC,sHAAA,oBAAoB,OAAA;AACpB,8GAAA,YAAY,OAAA;AACZ,2GAAA,SAAS,OAAA;AACT,gHAAA,cAAc,OAAA;AACd,4GAAA,UAAU,OAAA;AAIZ,WAAW;AACX,uDAQgC;AAP9B,kHAAA,kBAAkB,OAAA;AAClB,8GAAA,cAAc,OAAA;AACd,kHAAA,kBAAkB,OAAA;AAClB,4GAAA,YAAY,OAAA;AACZ,+GAAA,eAAe,OAAA;AACf,8GAAA,cAAc,OAAA;AACd,8GAAA,cAAc,OAAA;AAIhB,WAAW;AACX,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AAEtB,WAAW;AACX,gDAAiF;AAAxE,mHAAA,uBAAuB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AACnD,0CAA4D;AAAnD,mGAAA,UAAU,OAAA;AAAE,qGAAA,YAAY,OAAA;AAEjC,kDAAiF;AAAxE,mGAAA,MAAM,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAClD,gDAM6B;AAL3B,yGAAA,aAAa,OAAA;AACb,8GAAA,kBAAkB,OAAA;AAClB,0GAAA,cAAc,OAAA;AACd,+GAAA,mBAAmB,OAAA;AACnB,4GAAA,gBAAgB,OAAA;AAelB,UAAU;AACV,+CAAiF;AAAxE,8GAAA,kBAAkB,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,wGAAA,YAAY,OAAA;AAEpD,+CAAwD;AAA/C,8GAAA,kBAAkB,OAAA;AAE3B,6DAAyF;AAAhF,+GAAA,YAAY,OAAA;AAAE,qHAAA,kBAAkB,OAAA;AAAE,6GAAA,UAAU,OAAA;AACrD,2CAK0B;AAJxB,yGAAA,eAAe,OAAA;AACf,+GAAA,qBAAqB,OAAA;AACrB,yGAAA,eAAe,OAAA;AACf,sHAAA,4BAA4B,OAAA;AAO9B,iDAAsD;AAA7C,4GAAA,eAAe,OAAA;AACxB,uEAAsE;AAA7D,4HAAA,oBAAoB,OAAA;AAE7B,uEAAqE;AAA5D,2HAAA,mBAAmB,OAAA;AAa5B,SAAS;AACT,gDAM4B;AAL1B,8GAAA,iBAAiB,OAAA;AACjB,8GAAA,iBAAiB,OAAA;AACjB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AACpB,mHAAA,sBAAsB,OAAA"}

package/dist-cjs/locator/stability.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Locator stability ranking and parsing.
+ *
+ * A heal that makes a test pass by moving to a WEAKER locator is not a win:
+ * replacing a test id with a text match makes the test green and makes it
+ * fragile, coupling it to copy that product can change at any time. The engine
+ * therefore treats a negative stability delta as a warning that forces human
+ * review, and refuses to generate anything below a configured floor.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_STABILITY_RANK = exports.STABILITY_RANK = exports.LOCATOR_STRATEGIES = void 0;
+exports.parseLocator = parseLocator;
+exports.stabilityRankOf = stabilityRankOf;
+exports.stabilityDelta = stabilityDelta;
+exports.testIdDistance = testIdDistance;
+exports.LOCATOR_STRATEGIES = [
+    'testid',
+    'role',
+    'label',
+    'placeholder',
+    'text',
+    'css',
+    'xpath',
+];
+/** Lower is more durable. */
+exports.STABILITY_RANK = {
+    testid: 0,
+    role: 1,
+    label: 2,
+    placeholder: 3,
+    text: 4,
+    css: 5,
+    xpath: 6,
+};
+exports.MAX_STABILITY_RANK = 6;
+const ROLE_WITH_NAME = /getByRole\(\s*['"`]([^'"`]+)['"`]\s*,\s*\{[^}]*\bname:\s*['"`]([^'"`]+)['"`]/;
+const ROLE_ONLY = /getByRole\(\s*['"`]([^'"`]+)['"`]/;
+const PATTERNS = [
+    { strategy: 'testid', re: /getByTestId\(\s*['"`]([^'"`]+)['"`]/ },
+    { strategy: 'testid', re: /\[data-testid=['"]?([^\]'"]+)['"]?\]/ },
+    { strategy: 'label', re: /getByLabel\(\s*['"`]([^'"`]+)['"`]/ },
+    { strategy: 'placeholder', re: /getByPlaceholder\(\s*['"`]([^'"`]+)['"`]/ },
+    { strategy: 'text', re: /getByText\(\s*['"`]([^'"`]+)['"`]/ },
+    { strategy: 'text', re: /text=(.+)$/ },
+    { strategy: 'xpath', re: /^\s*(?:xpath=)?(\/\/.+)$/ },
+];
+/**
+ * Best-effort parse of a Playwright selector or locator expression.
+ * Returns null when nothing recognisable is present — callers must handle it
+ * rather than assuming a strategy.
+ */
+function parseLocator(expression) {
+    if (expression === null || expression === undefined)
+        return null;
+    const raw = expression.trim();
+    if (raw === '')
+        return null;
+    const namedRole = ROLE_WITH_NAME.exec(raw);
+    const role = namedRole?.[1];
+    const roleName = namedRole?.[2];
+    if (role !== undefined && role !== '' && roleName !== undefined && roleName !== '') {
+        return { strategy: 'role', value: role, raw, accessibleName: roleName };
+    }
+    const bareRole = ROLE_ONLY.exec(raw);
+    const bare = bareRole?.[1];
+    if (bare !== undefined && bare !== '') {
+        return { strategy: 'role', value: bare, raw, accessibleName: null };
+    }
+    for (const { strategy, re } of PATTERNS) {
+        const match = re.exec(raw);
+        const captured = match?.[1];
+        if (captured !== undefined && captured !== '') {
+            return { strategy, value: captured, raw, accessibleName: null };
+        }
+    }
+    // Anything left that looks like a selector is treated as CSS. This is a
+    // deliberate floor, not a guess: CSS ranks low, so an unparsed locator can
+    // never be mistaken for a durable one.
+    return { strategy: 'css', value: raw, raw, accessibleName: null };
+}
+function stabilityRankOf(strategy) {
+    return exports.STABILITY_RANK[strategy];
+}
+/**
+ * Positive = the replacement is MORE stable. Negative = less stable, which
+ * requires human review regardless of aggressiveness setting.
+ */
+function stabilityDelta(from, to) {
+    return exports.STABILITY_RANK[from] - exports.STABILITY_RANK[to];
+}
+/**
+ * Positional, prefix-weighted distance between two test ids.
+ *
+ * Test ids in a component-structured app read outside-in —
+ * `<feature>-<component>-<element>` — so the LEADING tokens identify where the
+ * element lives and the trailing token identifies what it is. Elements get
+ * renamed far more often than they move between features, so disagreement in
+ * the prefix is the stronger signal that these are different elements.
+ * Weights therefore decay from the front.
+ *
+ *   gym-card-name → gym-card-title    0.17  same place, renamed  ← the common heal
+ *   gym-card-name → gym-card-county   0.17  same place, sibling field
+ *   gym-card-name → event-card-name   0.50  different feature
+ *   gym-card-name → checkout-submit   1.00  unrelated
+ *
+ * Note that a rename and a sibling field score identically. That is honest:
+ * nothing in the STRING distinguishes them. Separating the two is exactly the
+ * judgement the Tier-1 ranker exists to make, using the failing assertion's
+ * domain arguments — which is why Tier 0 hands over candidates rather than
+ * picking one.
+ *
+ * Returns 0 (identical) .. 1 (nothing in common).
+ */
+function testIdDistance(a, b) {
+    if (a === b)
+        return 0;
+    const at = a.split(/[-_.:]/).filter(Boolean);
+    const bt = b.split(/[-_.:]/).filter(Boolean);
+    if (at.length === 0 || bt.length === 0)
+        return 1;
+    const length = Math.max(at.length, bt.length);
+    let mismatchWeight = 0;
+    let totalWeight = 0;
+    for (let i = 0; i < length; i++) {
+        // Leading tokens weigh most: position 0 of a 3-token id carries 3/6.
+        const weight = length - i;
+        totalWeight += weight;
+        if (at[i] !== bt[i])
+            mismatchWeight += weight;
+    }
+    return totalWeight === 0 ? 1 : Math.min(1, mismatchWeight / totalWeight);
+}
+//# sourceMappingURL=stability.js.map

package/dist-cjs/locator/stability.js.map

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

package/dist-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}