@alwaysmeticulous/session-filters 2.306.0 → 2.308.0

package/dist/__tests__/session-filters.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-filters.spec.d.ts.map

package/dist/__tests__/session-filters.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-filters.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-filters.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-filters.spec.js

@@ -0,0 +1,113 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3754007a-7c83-5315-b646-b29f289c9aff")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const session_filters_1 = require("../session-filters");
+(0, vitest_1.describe)("validateSessionFilter", () => {
+    (0, vitest_1.it)("accepts a valid filter", () => {
+        const result = (0, session_filters_1.validateSessionFilter)({
+            type: "session-start-url-matches-any-regex",
+            regexes: ["my-path/", "your-path/two/"],
+        });
+        (0, vitest_1.expect)(result).toEqual({
+            valid: true,
+            filter: {
+                type: "session-start-url-matches-any-regex",
+                regexes: ["my-path/", "your-path/two/"],
+            },
+        });
+    });
+    (0, vitest_1.it)("rejects non-object values", () => {
+        for (const value of [null, undefined, "filter", 42, ["a"]]) {
+            const result = (0, session_filters_1.validateSessionFilter)(value);
+            (0, vitest_1.expect)(result.valid).toBe(false);
+        }
+    });
+    (0, vitest_1.it)("rejects unknown filter types", () => {
+        const result = (0, session_filters_1.validateSessionFilter)({
+            type: "session-navigates-to",
+            regexes: ["a"],
+        });
+        (0, vitest_1.expect)(result).toMatchObject({ valid: false });
+        if (result.valid) {
+            throw new Error("expected invalid");
+        }
+        (0, vitest_1.expect)(result.error).toContain("Unknown session filter type");
+    });
+    (0, vitest_1.it)("rejects a missing or non-array regexes field", () => {
+        for (const regexes of [undefined, "a", { a: 1 }]) {
+            const result = (0, session_filters_1.validateSessionFilter)({
+                type: "session-start-url-matches-any-regex",
+                regexes,
+            });
+            (0, vitest_1.expect)(result.valid).toBe(false);
+        }
+    });
+    (0, vitest_1.it)("rejects an empty regexes list", () => {
+        const result = (0, session_filters_1.validateSessionFilter)({
+            type: "session-start-url-matches-any-regex",
+            regexes: [],
+        });
+        (0, vitest_1.expect)(result).toMatchObject({ valid: false });
+        if (result.valid) {
+            throw new Error("expected invalid");
+        }
+        (0, vitest_1.expect)(result.error).toContain("must not be empty");
+    });
+    (0, vitest_1.it)("rejects non-string and empty-string regexes", () => {
+        for (const regexes of [[42], [""], ["ok", null]]) {
+            const result = (0, session_filters_1.validateSessionFilter)({
+                type: "session-start-url-matches-any-regex",
+                regexes,
+            });
+            (0, vitest_1.expect)(result.valid).toBe(false);
+        }
+    });
+    (0, vitest_1.it)("rejects more regexes than the maximum", () => {
+        const result = (0, session_filters_1.validateSessionFilter)({
+            type: "session-start-url-matches-any-regex",
+            regexes: Array.from({ length: session_filters_1.MAX_SESSION_FILTER_REGEXES + 1 }, () => "a"),
+        });
+        (0, vitest_1.expect)(result.valid).toBe(false);
+    });
+    (0, vitest_1.it)("rejects regexes that do not compile", () => {
+        const result = (0, session_filters_1.validateSessionFilter)({
+            type: "session-start-url-matches-any-regex",
+            regexes: ["valid", "(unclosed"],
+        });
+        (0, vitest_1.expect)(result).toMatchObject({ valid: false });
+        if (result.valid) {
+            throw new Error("expected invalid");
+        }
+        (0, vitest_1.expect)(result.error).toContain('"(unclosed"');
+        (0, vitest_1.expect)(result.error).toContain("does not compile");
+    });
+    (0, vitest_1.it)("rejects regexes with features unsupported by the linear-time engine", () => {
+        // Backreferences and lookaheads are backtracking features that RE2
+        // (deliberately) does not support.
+        const result = (0, session_filters_1.validateSessionFilter)({
+            type: "session-start-url-matches-any-regex",
+            regexes: ["(?=lookahead)"],
+        });
+        (0, vitest_1.expect)(result.valid).toBe(false);
+    });
+});
+(0, vitest_1.describe)("compileSessionFilter", () => {
+    const matcher = (0, session_filters_1.compileSessionFilter)({
+        type: "session-start-url-matches-any-regex",
+        regexes: ["/checkout/", "^https://app\\.example\\.com/settings"],
+    });
+    (0, vitest_1.it)("matches a start URL matching any of the regexes", () => {
+        (0, vitest_1.expect)(matcher("https://shop.example.com/checkout/payment")).toBe(true);
+        (0, vitest_1.expect)(matcher("https://app.example.com/settings/profile")).toBe(true);
+    });
+    (0, vitest_1.it)("does not match a start URL matching none of the regexes", () => {
+        (0, vitest_1.expect)(matcher("https://app.example.com/dashboard")).toBe(false);
+    });
+    (0, vitest_1.it)("matches anywhere in the URL (unanchored) like the underlying engine", () => {
+        (0, vitest_1.expect)(matcher("https://example.com/a/checkout/b")).toBe(true);
+    });
+});
+//# sourceMappingURL=session-filters.spec.js.map
+//# debugId=3754007a-7c83-5315-b646-b29f289c9aff

package/dist/__tests__/session-filters.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-filters.spec.js","sources":["../../src/__tests__/session-filters.spec.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"3754007a-7c83-5315-b646-b29f289c9aff"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { compileSessionFilter, validateSessionFilter, MAX_SESSION_FILTER_REGEXES, MAX_SESSION_FILTER_REGEX_LENGTH, type SessionFilterValidationResult, } from "./session-filters";
+//# 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,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,+BAA+B,EAC/B,KAAK,6BAA6B,GACnC,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="107699b2-3be3-54f4-a9f0-5f35a54bab9d")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SESSION_FILTER_REGEX_LENGTH = exports.MAX_SESSION_FILTER_REGEXES = exports.validateSessionFilter = exports.compileSessionFilter = void 0;
+var session_filters_1 = require("./session-filters");
+Object.defineProperty(exports, "compileSessionFilter", { enumerable: true, get: function () { return session_filters_1.compileSessionFilter; } });
+Object.defineProperty(exports, "validateSessionFilter", { enumerable: true, get: function () { return session_filters_1.validateSessionFilter; } });
+Object.defineProperty(exports, "MAX_SESSION_FILTER_REGEXES", { enumerable: true, get: function () { return session_filters_1.MAX_SESSION_FILTER_REGEXES; } });
+Object.defineProperty(exports, "MAX_SESSION_FILTER_REGEX_LENGTH", { enumerable: true, get: function () { return session_filters_1.MAX_SESSION_FILTER_REGEX_LENGTH; } });
+//# sourceMappingURL=index.js.map
+//# debugId=107699b2-3be3-54f4-a9f0-5f35a54bab9d

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAA,qDAM2B;AALzB,uHAAA,oBAAoB,OAAA;AACpB,wHAAA,qBAAqB,OAAA;AACrB,6HAAA,0BAA0B,OAAA;AAC1B,kIAAA,+BAA+B,OAAA","debugId":"107699b2-3be3-54f4-a9f0-5f35a54bab9d"}

package/dist/session-filters.d.ts

@@ -0,0 +1,28 @@
+import type { SessionFilter } from "@alwaysmeticulous/api";
+export declare const MAX_SESSION_FILTER_REGEXES = 100;
+export declare const MAX_SESSION_FILTER_REGEX_LENGTH = 1000;
+export type SessionFilterValidationResult = {
+    valid: true;
+    filter: SessionFilter;
+} | {
+    valid: false;
+    error: string;
+};
+/**
+ * Validates an untrusted value as a {@link SessionFilter}, including checking
+ * that every regex compiles with the same engine used for matching (Google's
+ * RE2 — linear-time, no backreferences or lookaround; see
+ * https://github.com/google/re2/wiki/Syntax).
+ *
+ * Shared by the CLI (to reject bad filters before triggering a run) and the
+ * backend (to reject bad filters at the API boundary), so validation semantics
+ * cannot drift between the two.
+ */
+export declare const validateSessionFilter: (value: unknown) => SessionFilterValidationResult;
+/**
+ * Compiles a {@link SessionFilter} into a predicate over a session's start
+ * URL. Throws if any regex does not compile — call
+ * {@link validateSessionFilter} first at the system boundary.
+ */
+export declare const compileSessionFilter: (filter: SessionFilter) => ((sessionStartUrl: string) => boolean);
+//# sourceMappingURL=session-filters.d.ts.map

package/dist/session-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-filters.d.ts","sourceRoot":"","sources":["../src/session-filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAyB3D,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,MAAM,MAAM,6BAA6B,GACrC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,UACzB,OAAO,KACb,6BA0EF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,WACvB,aAAa,KACpB,CAAC,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAKvC,CAAC"}

package/dist/session-filters.js

@@ -0,0 +1,107 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="70ea37cf-98b4-5dfc-81a1-bbe140d7b48e")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileSessionFilter = exports.validateSessionFilter = exports.MAX_SESSION_FILTER_REGEX_LENGTH = exports.MAX_SESSION_FILTER_REGEXES = void 0;
+let cachedRE2;
+const getRE2 = () => {
+    if (cachedRE2 === undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        cachedRE2 = require("re2");
+    }
+    return cachedRE2;
+};
+exports.MAX_SESSION_FILTER_REGEXES = 100;
+exports.MAX_SESSION_FILTER_REGEX_LENGTH = 1_000;
+/**
+ * Validates an untrusted value as a {@link SessionFilter}, including checking
+ * that every regex compiles with the same engine used for matching (Google's
+ * RE2 — linear-time, no backreferences or lookaround; see
+ * https://github.com/google/re2/wiki/Syntax).
+ *
+ * Shared by the CLI (to reject bad filters before triggering a run) and the
+ * backend (to reject bad filters at the API boundary), so validation semantics
+ * cannot drift between the two.
+ */
+const validateSessionFilter = (value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { valid: false, error: "Session filter must be an object." };
+    }
+    const type = value.type;
+    if (type !== "session-start-url-matches-any-regex") {
+        return {
+            valid: false,
+            error: `Unknown session filter type ${JSON.stringify(type)}. Supported types: "session-start-url-matches-any-regex".`,
+        };
+    }
+    const regexes = value.regexes;
+    if (!Array.isArray(regexes)) {
+        return {
+            valid: false,
+            error: "Session filter 'regexes' must be an array of strings.",
+        };
+    }
+    if (regexes.length === 0) {
+        return {
+            valid: false,
+            error: "Session filter 'regexes' must not be empty: an empty list would match no sessions. Omit the filter to run all selected sessions.",
+        };
+    }
+    if (regexes.length > exports.MAX_SESSION_FILTER_REGEXES) {
+        return {
+            valid: false,
+            error: `Session filter 'regexes' must contain at most ${exports.MAX_SESSION_FILTER_REGEXES} entries (got ${regexes.length}).`,
+        };
+    }
+    for (const regex of regexes) {
+        if (typeof regex !== "string") {
+            return {
+                valid: false,
+                error: "Session filter 'regexes' must be an array of strings.",
+            };
+        }
+        if (regex.length === 0) {
+            return {
+                valid: false,
+                error: "Session filter 'regexes' must not contain empty strings (an empty regex matches every session).",
+            };
+        }
+        if (regex.length > exports.MAX_SESSION_FILTER_REGEX_LENGTH) {
+            return {
+                valid: false,
+                error: `Session filter regexes must be at most ${exports.MAX_SESSION_FILTER_REGEX_LENGTH} characters long (got one of length ${regex.length}).`,
+            };
+        }
+        try {
+            const RE2Ctor = getRE2();
+            new RE2Ctor(regex);
+        }
+        catch (error) {
+            return {
+                valid: false,
+                error: `Session filter regex ${JSON.stringify(regex)} does not compile: ${error instanceof Error ? error.message : String(error)}. Regexes use the RE2 syntax (https://github.com/google/re2/wiki/Syntax).`,
+            };
+        }
+    }
+    return {
+        valid: true,
+        filter: {
+            type: "session-start-url-matches-any-regex",
+            regexes: regexes,
+        },
+    };
+};
+exports.validateSessionFilter = validateSessionFilter;
+/**
+ * Compiles a {@link SessionFilter} into a predicate over a session's start
+ * URL. Throws if any regex does not compile — call
+ * {@link validateSessionFilter} first at the system boundary.
+ */
+const compileSessionFilter = (filter) => {
+    const RE2Ctor = getRE2();
+    const compiledRegexes = filter.regexes.map((regex) => new RE2Ctor(regex));
+    return (sessionStartUrl) => compiledRegexes.some((regex) => regex.test(sessionStartUrl));
+};
+exports.compileSessionFilter = compileSessionFilter;
+//# sourceMappingURL=session-filters.js.map
+//# debugId=70ea37cf-98b4-5dfc-81a1-bbe140d7b48e

package/dist/session-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-filters.js","sources":["../src/session-filters.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"70ea37cf-98b4-5dfc-81a1-bbe140d7b48e"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwaysmeticulous/session-filters",
-  "version": "2.306.0",
+  "version": "2.308.0",
   "description": "Validation and matching for Meticulous session filters, shared between the CLI and the Meticulous backend",
   "license": "ISC",
   "main": "dist/index.js",
@@ -10,7 +10,7 @@
   ],
   "dependencies": {
     "re2": "1.24.0",
-    "@alwaysmeticulous/api": "2.306.0"
+    "@alwaysmeticulous/api": "2.307.0"
   },
   "devDependencies": {
     "vitest": "^4.1.7"