@rayselfs/cf-rule-engine 1.5.0

package/dist/helpers/preflight-request.d.ts

@@ -0,0 +1,38 @@
+import { Rule } from '../core/types.js';
+import { CorsOptions } from '../behaviors/set-cors-headers.js';
+
+/**
+ * Returns a `Rule` that responds 204 to OPTIONS preflight requests with CORS headers.
+ *
+ * Accepts the same `CorsOptions` as `setCorsHeaders` — pass the same object to both
+ * to define CORS config in one place.
+ *
+ * @example
+ * ```ts
+ * import { preflightRequest } from '@viverse/cf-engine/helpers'
+ * import { setCorsHeaders } from '@viverse/cf-engine/behaviors'
+ * import { defineViewerRequest, defineViewerResponse } from '@viverse/cf-engine/adapters/cf-function'
+ * import type { CorsOptions } from '@viverse/cf-engine/behaviors'
+ *
+ * const CORS: CorsOptions = {
+ *   allowedOrigins: ['*'],
+ *   allowedMethods: 'GET, POST, OPTIONS',
+ *   allowedHeaders: 'Content-Type, Cache-Control, Pragma, Range',
+ * }
+ *
+ * // viewer-request.ts
+ * export default defineViewerRequest([
+ *   preflightRequest(CORS),
+ * ])
+ *
+ * // viewer-response.ts
+ * export default defineViewerResponse([
+ *   setCorsHeaders(CORS),
+ * ])
+ * ```
+ *
+ * @returns A `Rule` ready to pass into `defineViewerRequest`.
+ */
+declare function preflightRequest(options?: CorsOptions): Rule;
+
+export { preflightRequest };

package/dist/helpers/preflight-request.js

@@ -0,0 +1,8 @@
+import {
+  preflightRequest
+} from "../chunk-H2LO6MQG.js";
+import "../chunk-PY3JMRDG.js";
+import "../chunk-MLKGABMK.js";
+export {
+  preflightRequest
+};

package/dist/helpers/send-country-code.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkLSCC62CZcjs = require('../chunk-LSCC62CZ.cjs');
+require('../chunk-JU5WX5RU.cjs');
+require('../chunk-75ZPJI57.cjs');
+
+
+exports.sendCountryCode = _chunkLSCC62CZcjs.sendCountryCode;

package/dist/helpers/send-country-code.d.cts

@@ -0,0 +1,35 @@
+import { BehaviorFn } from '../core/types.cjs';
+
+/**
+ * Copies the `CloudFront-Viewer-Country` header value into a custom request header,
+ * making the viewer's country code available to the origin server.
+ *
+ * CloudFront sets `CloudFront-Viewer-Country` to the ISO 3166-1 alpha-2 country code
+ * of the viewer (e.g. `'US'`, `'TW'`, `'JP'`). This helper copies it to the header name
+ * your origin expects, defaulting to `'x-htc-request-country-code'`.
+ *
+ * Note: The `CloudFront-Viewer-Country` header must be enabled in the CloudFront
+ * cache policy (under "Headers") for the origin behavior.
+ *
+ * @param targetHeader - The request header to copy the country code into.
+ *   Default: `'x-htc-request-country-code'`.
+ * @returns A `BehaviorFn` to use as the second argument to `rule()`.
+ *
+ * @example
+ * ```ts
+ * import { sendCountryCode } from '@viverse/cf-engine/helpers'
+ * import { rule } from '@viverse/cf-engine'
+ * import { defineViewerRequest } from '@viverse/cf-engine/adapters/cf-function'
+ *
+ * export default defineViewerRequest([
+ *   // Forward country code using the default header name
+ *   rule(sendCountryCode()),
+ *
+ *   // Forward using a custom header name
+ *   rule(sendCountryCode('x-viewer-country')),
+ * ])
+ * ```
+ */
+declare function sendCountryCode(targetHeader?: string): BehaviorFn;
+
+export { sendCountryCode };

package/dist/helpers/send-country-code.d.ts

@@ -0,0 +1,35 @@
+import { BehaviorFn } from '../core/types.js';
+
+/**
+ * Copies the `CloudFront-Viewer-Country` header value into a custom request header,
+ * making the viewer's country code available to the origin server.
+ *
+ * CloudFront sets `CloudFront-Viewer-Country` to the ISO 3166-1 alpha-2 country code
+ * of the viewer (e.g. `'US'`, `'TW'`, `'JP'`). This helper copies it to the header name
+ * your origin expects, defaulting to `'x-htc-request-country-code'`.
+ *
+ * Note: The `CloudFront-Viewer-Country` header must be enabled in the CloudFront
+ * cache policy (under "Headers") for the origin behavior.
+ *
+ * @param targetHeader - The request header to copy the country code into.
+ *   Default: `'x-htc-request-country-code'`.
+ * @returns A `BehaviorFn` to use as the second argument to `rule()`.
+ *
+ * @example
+ * ```ts
+ * import { sendCountryCode } from '@viverse/cf-engine/helpers'
+ * import { rule } from '@viverse/cf-engine'
+ * import { defineViewerRequest } from '@viverse/cf-engine/adapters/cf-function'
+ *
+ * export default defineViewerRequest([
+ *   // Forward country code using the default header name
+ *   rule(sendCountryCode()),
+ *
+ *   // Forward using a custom header name
+ *   rule(sendCountryCode('x-viewer-country')),
+ * ])
+ * ```
+ */
+declare function sendCountryCode(targetHeader?: string): BehaviorFn;
+
+export { sendCountryCode };

package/dist/helpers/send-country-code.js

@@ -0,0 +1,8 @@
+import {
+  sendCountryCode
+} from "../chunk-C32DL3EP.js";
+import "../chunk-BDNPQ7AU.js";
+import "../chunk-MLKGABMK.js";
+export {
+  sendCountryCode
+};

package/dist/helpers/staging-whitelist.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkWW7YVRAIcjs = require('../chunk-WW7YVRAI.cjs');
+require('../chunk-D47P7HVZ.cjs');
+require('../chunk-YVUR35RN.cjs');
+require('../chunk-CF5PWWTF.cjs');
+require('../chunk-MVGYPBYB.cjs');
+require('../chunk-IBXAK2A4.cjs');
+require('../chunk-WKYMSRCD.cjs');
+require('../chunk-WWSRNCUP.cjs');
+require('../chunk-75ZPJI57.cjs');
+
+
+exports.stagingWhitelist = _chunkWW7YVRAIcjs.stagingWhitelist;

package/dist/helpers/staging-whitelist.d.cts

@@ -0,0 +1,73 @@
+import { Rule } from '../core/types.cjs';
+
+/**
+ * Configuration options for the staging environment access whitelist.
+ */
+interface StagingWhitelistOptions {
+    /**
+     * CIDR ranges to allow (e.g. office IPs, VPN, stage VPCs).
+     * At least one of `cidrs` or `userAgents` must be non-empty, otherwise
+     * every request will be redirected.
+     *
+     * @example `['203.0.113.0/24', '10.0.0.0/8']`
+     */
+    cidrs: string[];
+    /**
+     * User-Agent wildcard patterns to allow (supports `*` and `?`).
+     * Requests matching any pattern are passed through regardless of IP.
+     *
+     * @example `['*InternalBot*', '*Prerender*']`
+     */
+    userAgents?: string[];
+    /**
+     * URL to redirect blocked requests to. Redirects with HTTP 302.
+     *
+     * @example `'https://www.example.com'`
+     */
+    redirectUrl: string;
+    /**
+     * URL path patterns that bypass the whitelist check entirely.
+     * Supports wildcard patterns (`*`, `?`).
+     *
+     * @example `['/api/health', '/public/*']`
+     */
+    bypassPaths?: string[];
+}
+/**
+ * Creates a `Rule` that restricts access to a staging environment by
+ * IP CIDR range and/or User-Agent pattern. Any request that does not
+ * match an allowed CIDR or User-Agent (and is not on a bypassed path)
+ * is redirected with HTTP 302 to `options.redirectUrl`.
+ *
+ * No default allowlists are included — callers must supply all allowed
+ * CIDRs and User-Agent patterns explicitly.
+ *
+ * @param options - Whitelist configuration.
+ * @returns A `Rule` ready to pass as an element of `defineViewerRequest`.
+ *
+ * @example
+ * ```ts
+ * import { stagingWhitelist } from '@viverse/cf-engine/helpers'
+ * import { defineViewerRequest } from '@viverse/cf-engine/adapters/cf-function'
+ *
+ * export default defineViewerRequest([
+ *   stagingWhitelist({
+ *     cidrs: ['203.0.113.0/24', '10.0.0.0/8'],
+ *     userAgents: ['*InternalBot*'],
+ *     redirectUrl: 'https://www.example.com',
+ *   }),
+ * ])
+ *
+ * // With bypass paths:
+ * export default defineViewerRequest([
+ *   stagingWhitelist({
+ *     cidrs: ['203.0.113.0/24'],
+ *     redirectUrl: 'https://www.example.com',
+ *     bypassPaths: ['/api/health', '/robots.txt'],
+ *   }),
+ * ])
+ * ```
+ */
+declare function stagingWhitelist(options: StagingWhitelistOptions): Rule;
+
+export { type StagingWhitelistOptions, stagingWhitelist };

package/dist/helpers/staging-whitelist.d.ts

@@ -0,0 +1,73 @@
+import { Rule } from '../core/types.js';
+
+/**
+ * Configuration options for the staging environment access whitelist.
+ */
+interface StagingWhitelistOptions {
+    /**
+     * CIDR ranges to allow (e.g. office IPs, VPN, stage VPCs).
+     * At least one of `cidrs` or `userAgents` must be non-empty, otherwise
+     * every request will be redirected.
+     *
+     * @example `['203.0.113.0/24', '10.0.0.0/8']`
+     */
+    cidrs: string[];
+    /**
+     * User-Agent wildcard patterns to allow (supports `*` and `?`).
+     * Requests matching any pattern are passed through regardless of IP.
+     *
+     * @example `['*InternalBot*', '*Prerender*']`
+     */
+    userAgents?: string[];
+    /**
+     * URL to redirect blocked requests to. Redirects with HTTP 302.
+     *
+     * @example `'https://www.example.com'`
+     */
+    redirectUrl: string;
+    /**
+     * URL path patterns that bypass the whitelist check entirely.
+     * Supports wildcard patterns (`*`, `?`).
+     *
+     * @example `['/api/health', '/public/*']`
+     */
+    bypassPaths?: string[];
+}
+/**
+ * Creates a `Rule` that restricts access to a staging environment by
+ * IP CIDR range and/or User-Agent pattern. Any request that does not
+ * match an allowed CIDR or User-Agent (and is not on a bypassed path)
+ * is redirected with HTTP 302 to `options.redirectUrl`.
+ *
+ * No default allowlists are included — callers must supply all allowed
+ * CIDRs and User-Agent patterns explicitly.
+ *
+ * @param options - Whitelist configuration.
+ * @returns A `Rule` ready to pass as an element of `defineViewerRequest`.
+ *
+ * @example
+ * ```ts
+ * import { stagingWhitelist } from '@viverse/cf-engine/helpers'
+ * import { defineViewerRequest } from '@viverse/cf-engine/adapters/cf-function'
+ *
+ * export default defineViewerRequest([
+ *   stagingWhitelist({
+ *     cidrs: ['203.0.113.0/24', '10.0.0.0/8'],
+ *     userAgents: ['*InternalBot*'],
+ *     redirectUrl: 'https://www.example.com',
+ *   }),
+ * ])
+ *
+ * // With bypass paths:
+ * export default defineViewerRequest([
+ *   stagingWhitelist({
+ *     cidrs: ['203.0.113.0/24'],
+ *     redirectUrl: 'https://www.example.com',
+ *     bypassPaths: ['/api/health', '/robots.txt'],
+ *   }),
+ * ])
+ * ```
+ */
+declare function stagingWhitelist(options: StagingWhitelistOptions): Rule;
+
+export { type StagingWhitelistOptions, stagingWhitelist };

package/dist/helpers/staging-whitelist.js

@@ -0,0 +1,14 @@
+import {
+  stagingWhitelist
+} from "../chunk-UKB5JAX4.js";
+import "../chunk-KW5YBTSD.js";
+import "../chunk-LNQPYKGG.js";
+import "../chunk-LO2BO3RU.js";
+import "../chunk-S2AAATFN.js";
+import "../chunk-2DE6WPPL.js";
+import "../chunk-Q4NP4C3B.js";
+import "../chunk-DSSFFJWL.js";
+import "../chunk-MLKGABMK.js";
+export {
+  stagingWhitelist
+};

package/dist/index.cjs

@@ -0,0 +1,26 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-MEHWLQLR.cjs');
+
+
+var _chunkSAXDN5NScjs = require('./chunk-SAXDN5NS.cjs');
+
+
+var _chunk3BBLG4IXcjs = require('./chunk-3BBLG4IX.cjs');
+
+
+
+
+
+
+
+var _chunkWKYMSRCDcjs = require('./chunk-WKYMSRCD.cjs');
+require('./chunk-75ZPJI57.cjs');
+
+
+
+
+
+
+
+
+
+exports.all = _chunkWKYMSRCDcjs.all; exports.any = _chunkWKYMSRCDcjs.any; exports.cfFunction = _chunkSAXDN5NScjs.cf_function_exports; exports.chain = _chunkWKYMSRCDcjs.chain; exports.lambdaEdge = _chunk3BBLG4IXcjs.lambda_edge_exports; exports.not = _chunkWKYMSRCDcjs.not; exports.rule = _chunkWKYMSRCDcjs.rule; exports.runRules = _chunkWKYMSRCDcjs.runRules;

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+export { BehaviorFn, BehaviorResult, CriteriaFn, HttpRequest, HttpResponse, ResponseBehaviorFn, ResponseRule, Rule, ViewerRequestHandler, ViewerResponseHandler } from './core/types.cjs';
+export { all, any, chain, not, rule, runRules } from './core/rule.cjs';
+export { c as cfFunction } from './cf-function-D27hUVtN.cjs';
+export { l as lambdaEdge } from './lambda-edge-DxTOa2cg.cjs';

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { BehaviorFn, BehaviorResult, CriteriaFn, HttpRequest, HttpResponse, ResponseBehaviorFn, ResponseRule, Rule, ViewerRequestHandler, ViewerResponseHandler } from './core/types.js';
+export { all, any, chain, not, rule, runRules } from './core/rule.js';
+export { c as cfFunction } from './cf-function-u0PvbW_s.js';
+export { l as lambdaEdge } from './lambda-edge-D15Nf__n.js';

package/dist/index.js

@@ -0,0 +1,26 @@
+import "./chunk-KZ72PI2A.js";
+import {
+  cf_function_exports
+} from "./chunk-NPMGSPNL.js";
+import {
+  lambda_edge_exports
+} from "./chunk-WEBU4R5C.js";
+import {
+  all,
+  any,
+  chain,
+  not,
+  rule,
+  runRules
+} from "./chunk-Q4NP4C3B.js";
+import "./chunk-MLKGABMK.js";
+export {
+  all,
+  any,
+  cf_function_exports as cfFunction,
+  chain,
+  lambda_edge_exports as lambdaEdge,
+  not,
+  rule,
+  runRules
+};

package/dist/lambda-edge-D15Nf__n.d.ts

@@ -0,0 +1,66 @@
+import { Rule, ResponseBehaviorFn, ResponseRule } from './core/types.js';
+
+/**
+ * Creates a Lambda@Edge viewer-request handler from an ordered list of rules.
+ *
+ * The returned async function is the Lambda handler entry point. Export it as
+ * `export const handler` and set `handler = "index.handler"` in the Lambda config.
+ *
+ * Rules are evaluated in order. Processing stops at the first rule whose behavior
+ * returns a response (e.g. `redirect`, `constructResponse`). If all rules continue,
+ * the (possibly mutated) request is forwarded to the origin.
+ *
+ * Header format differences from CF Function are handled automatically by this adapter —
+ * Lambda@Edge uses `[{ key, value }]` arrays; cf-engine uses `{ value }` flat objects.
+ *
+ * @param rules - Ordered array of `Rule` objects created with `rule()`.
+ * @returns An async Lambda handler `async (event) => request | response`.
+ *
+ * @example
+ * ```ts
+ * import { rule } from '@viverse/cf-engine'
+ * import { verifyToken, stripQueryParams } from '@viverse/cf-engine/behaviors'
+ * import { defineViewerRequest } from '@viverse/cf-engine/adapters/lambda-edge'
+ *
+ * export const handler = defineViewerRequest([
+ *   rule(verifyToken({ key: process.env.EDGE_AUTH_KEY! })),
+ *   rule(stripQueryParams(['hdnts'])),
+ * ])
+ * ```
+ */
+declare function defineViewerRequest(rules: Rule[]): (event: unknown) => unknown;
+/**
+ * Creates a Lambda@Edge viewer-response handler from an ordered list of
+ * response behaviors or response rules.
+ *
+ * Each entry can be either:
+ * - A bare `ResponseBehaviorFn` — runs unconditionally on every response.
+ * - A `ResponseRule` `{ criteria, behavior }` — runs only when `criteria` returns `true`
+ *   for the current request.
+ *
+ * Header format normalization (Lambda@Edge ↔ cf-engine) is handled automatically.
+ *
+ * @param responseBehaviors - Ordered array of `ResponseBehaviorFn` functions or
+ *   `ResponseRule` objects `{ criteria?, behavior }`.
+ * @returns An async Lambda handler `async (event) => response`.
+ *
+ * @example
+ * ```ts
+ * import { setSecurityHeaders, setCorsHeaders } from '@viverse/cf-engine/behaviors'
+ * import { defineViewerResponse } from '@viverse/cf-engine/adapters/lambda-edge'
+ *
+ * export const handler = defineViewerResponse([
+ *   setSecurityHeaders(),
+ *   setCorsHeaders({ allowedOrigins: ['https://www.viverse.com'], allowOriginEcho: true }),
+ * ])
+ * ```
+ */
+declare function defineViewerResponse(responseBehaviors: Array<ResponseBehaviorFn | ResponseRule>): (event: unknown) => unknown;
+
+declare const lambdaEdge_defineViewerRequest: typeof defineViewerRequest;
+declare const lambdaEdge_defineViewerResponse: typeof defineViewerResponse;
+declare namespace lambdaEdge {
+  export { lambdaEdge_defineViewerRequest as defineViewerRequest, lambdaEdge_defineViewerResponse as defineViewerResponse };
+}
+
+export { defineViewerResponse as a, defineViewerRequest as d, lambdaEdge as l };

package/dist/lambda-edge-DxTOa2cg.d.cts

@@ -0,0 +1,66 @@
+import { Rule, ResponseBehaviorFn, ResponseRule } from './core/types.cjs';
+
+/**
+ * Creates a Lambda@Edge viewer-request handler from an ordered list of rules.
+ *
+ * The returned async function is the Lambda handler entry point. Export it as
+ * `export const handler` and set `handler = "index.handler"` in the Lambda config.
+ *
+ * Rules are evaluated in order. Processing stops at the first rule whose behavior
+ * returns a response (e.g. `redirect`, `constructResponse`). If all rules continue,
+ * the (possibly mutated) request is forwarded to the origin.
+ *
+ * Header format differences from CF Function are handled automatically by this adapter —
+ * Lambda@Edge uses `[{ key, value }]` arrays; cf-engine uses `{ value }` flat objects.
+ *
+ * @param rules - Ordered array of `Rule` objects created with `rule()`.
+ * @returns An async Lambda handler `async (event) => request | response`.
+ *
+ * @example
+ * ```ts
+ * import { rule } from '@viverse/cf-engine'
+ * import { verifyToken, stripQueryParams } from '@viverse/cf-engine/behaviors'
+ * import { defineViewerRequest } from '@viverse/cf-engine/adapters/lambda-edge'
+ *
+ * export const handler = defineViewerRequest([
+ *   rule(verifyToken({ key: process.env.EDGE_AUTH_KEY! })),
+ *   rule(stripQueryParams(['hdnts'])),
+ * ])
+ * ```
+ */
+declare function defineViewerRequest(rules: Rule[]): (event: unknown) => unknown;
+/**
+ * Creates a Lambda@Edge viewer-response handler from an ordered list of
+ * response behaviors or response rules.
+ *
+ * Each entry can be either:
+ * - A bare `ResponseBehaviorFn` — runs unconditionally on every response.
+ * - A `ResponseRule` `{ criteria, behavior }` — runs only when `criteria` returns `true`
+ *   for the current request.
+ *
+ * Header format normalization (Lambda@Edge ↔ cf-engine) is handled automatically.
+ *
+ * @param responseBehaviors - Ordered array of `ResponseBehaviorFn` functions or
+ *   `ResponseRule` objects `{ criteria?, behavior }`.
+ * @returns An async Lambda handler `async (event) => response`.
+ *
+ * @example
+ * ```ts
+ * import { setSecurityHeaders, setCorsHeaders } from '@viverse/cf-engine/behaviors'
+ * import { defineViewerResponse } from '@viverse/cf-engine/adapters/lambda-edge'
+ *
+ * export const handler = defineViewerResponse([
+ *   setSecurityHeaders(),
+ *   setCorsHeaders({ allowedOrigins: ['https://www.viverse.com'], allowOriginEcho: true }),
+ * ])
+ * ```
+ */
+declare function defineViewerResponse(responseBehaviors: Array<ResponseBehaviorFn | ResponseRule>): (event: unknown) => unknown;
+
+declare const lambdaEdge_defineViewerRequest: typeof defineViewerRequest;
+declare const lambdaEdge_defineViewerResponse: typeof defineViewerResponse;
+declare namespace lambdaEdge {
+  export { lambdaEdge_defineViewerRequest as defineViewerRequest, lambdaEdge_defineViewerResponse as defineViewerResponse };
+}
+
+export { defineViewerResponse as a, defineViewerRequest as d, lambdaEdge as l };

package/dist/shared/cidr.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkYVUR35RNcjs = require('../chunk-YVUR35RN.cjs');
+require('../chunk-75ZPJI57.cjs');
+
+
+
+
+exports.inCidr = _chunkYVUR35RNcjs.inCidr; exports.ipToInt = _chunkYVUR35RNcjs.ipToInt; exports.matchesAnyCidr = _chunkYVUR35RNcjs.matchesAnyCidr;

package/dist/shared/cidr.d.cts

@@ -0,0 +1,8 @@
+/** Convert IPv4 string to unsigned 32-bit integer */
+declare function ipToInt(ip: string): number;
+/** Returns true if `ip` falls within the `cidr` range (e.g. "10.0.0.0/8") */
+declare function inCidr(ip: string, cidr: string): boolean;
+/** Returns true if `ip` matches ANY of the given CIDR ranges */
+declare function matchesAnyCidr(ip: string, cidrs: string[]): boolean;
+
+export { inCidr, ipToInt, matchesAnyCidr };

package/dist/shared/cidr.d.ts

@@ -0,0 +1,8 @@
+/** Convert IPv4 string to unsigned 32-bit integer */
+declare function ipToInt(ip: string): number;
+/** Returns true if `ip` falls within the `cidr` range (e.g. "10.0.0.0/8") */
+declare function inCidr(ip: string, cidr: string): boolean;
+/** Returns true if `ip` matches ANY of the given CIDR ranges */
+declare function matchesAnyCidr(ip: string, cidrs: string[]): boolean;
+
+export { inCidr, ipToInt, matchesAnyCidr };

package/dist/shared/cidr.js

@@ -0,0 +1,11 @@
+import {
+  inCidr,
+  ipToInt,
+  matchesAnyCidr
+} from "../chunk-LNQPYKGG.js";
+import "../chunk-MLKGABMK.js";
+export {
+  inCidr,
+  ipToInt,
+  matchesAnyCidr
+};

package/dist/shared/wildcard.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkIBXAK2A4cjs = require('../chunk-IBXAK2A4.cjs');
+require('../chunk-75ZPJI57.cjs');
+
+
+
+
+exports.matchesAnyWildcard = _chunkIBXAK2A4cjs.matchesAnyWildcard; exports.matchesWildcard = _chunkIBXAK2A4cjs.matchesWildcard; exports.wildcardToRegex = _chunkIBXAK2A4cjs.wildcardToRegex;

package/dist/shared/wildcard.d.cts

@@ -0,0 +1,8 @@
+/** Convert a wildcard pattern to a RegExp. `*` matches any chars, `?` matches one char. Case-insensitive. */
+declare function wildcardToRegex(pattern: string): RegExp;
+/** Returns true if `str` matches the given wildcard pattern */
+declare function matchesWildcard(str: string, pattern: string): boolean;
+/** Returns true if `str` matches ANY of the given wildcard patterns */
+declare function matchesAnyWildcard(str: string, patterns: string[]): boolean;
+
+export { matchesAnyWildcard, matchesWildcard, wildcardToRegex };

package/dist/shared/wildcard.d.ts

@@ -0,0 +1,8 @@
+/** Convert a wildcard pattern to a RegExp. `*` matches any chars, `?` matches one char. Case-insensitive. */
+declare function wildcardToRegex(pattern: string): RegExp;
+/** Returns true if `str` matches the given wildcard pattern */
+declare function matchesWildcard(str: string, pattern: string): boolean;
+/** Returns true if `str` matches ANY of the given wildcard patterns */
+declare function matchesAnyWildcard(str: string, patterns: string[]): boolean;
+
+export { matchesAnyWildcard, matchesWildcard, wildcardToRegex };

package/dist/shared/wildcard.js

@@ -0,0 +1,11 @@
+import {
+  matchesAnyWildcard,
+  matchesWildcard,
+  wildcardToRegex
+} from "../chunk-2DE6WPPL.js";
+import "../chunk-MLKGABMK.js";
+export {
+  matchesAnyWildcard,
+  matchesWildcard,
+  wildcardToRegex
+};