@rockcarver/frodo-lib 4.10.0-1 → 4.11.0-1

package/types/utils/ForgeRockUtils.d.ts

@@ -0,0 +1,122 @@
+import { State } from '../shared/State';
+export type FRUtils = {
+    applyNameCollisionPolicy(name: string): string;
+    getRealmPath(realm: string): string;
+    getCurrentRealmPath(): string;
+    getCurrentRealmName(): string;
+    getCurrentRealmManagedUser(): string;
+    getRealmName(realm: string): string;
+    getRealmUsingExportFormat(realm: string): string;
+    /**
+     * Gets the list of realms to be used for exports in special format.
+     * e.g. if the realm is normally '/first/second', then it will return 'root-first-second'.
+     */
+    getRealmsForExport(): Promise<string[]>;
+    /**
+     * Helper that gets the normal realm name from the realm export format.
+     * It reverses the format generated by getRealmsForExport.
+     * e.g. if the realm is 'root-first-second', then it will return '/first/second'.
+     * @param realm realm in export format
+     */
+    getRealmUsingExportFormat(realm: string): string;
+    /**
+     * Get host URL without path and query params
+     * @param {string} url tenant URL with path and query params
+     * @returns {string} AM host URL without path and query params
+     */
+    getHostUrl(url: string): string;
+    /**
+     * Get IDM base URL
+     * @returns {string} IDM host URL without path and query params
+     */
+    getIdmBaseUrl(): string;
+    /**
+     * Get host URL without path and query params
+     * @param {string} url tenant URL with path and query params
+     * @returns {string} AM host URL without path and query params
+     * @deprecated since v2.1.2 use {@link FRUtils.getHostUrl | getHostUrl} instead
+     * ```javascript
+     * getHostUrl(url: string): string
+     * ```
+     * @group Deprecated
+     */
+    getHostBaseUrl(url: string): string;
+};
+declare const _default: (state: State) => FRUtils;
+export default _default;
+/**
+ * Get new name when names collide
+ * @param {string} name to apply policy to
+ * @returns {string} new name according to policy
+ */
+export declare function applyNameCollisionPolicy(name: string): string;
+/**
+ * Gets the list of realms to be used for exports in special format.
+ * e.g. if the realm is normally '/first/second', then it will return 'root-first-second'.
+ */
+export declare function getRealmsForExport({ state, }: {
+    state: State;
+}): Promise<string[]>;
+/**
+ * Helper that gets the normal realm name from the realm export format.
+ * It reverses the format generated by getRealmsForExport.
+ * e.g. if the realm is 'root-first-second', then it will return '/first/second'.
+ * @param realm realm in export format
+ */
+export declare function getRealmUsingExportFormat(realm: string): string;
+/**
+ * Helper function to get the config path required for the API call considering if the request
+ * should obtain the realm config or the global config of the service in question
+ * @param {boolean} globalConfig true if the global service is the target of the operation, false otherwise.
+ * @returns {string} The config path to be used for the request
+ */
+export declare function getConfigPath(globalConfig: boolean): string;
+/**
+ * Helper function to get the realm path required for the API call considering if the request
+ * should obtain the realm config or the global config of the service in question
+ * @param {boolean} globalConfig true if the global service is the target of the operation, false otherwise.
+ * @returns {string} The realm path to be used for the request
+ */
+export declare function getRealmPathGlobal(globalConfig: boolean, state: State): string;
+/**
+ * Get realm path
+ * @param {string} realm realm
+ * @returns {string} a CREST-compliant realm path, e.g. /realms/root/realms/alpha
+ */
+export declare function getRealmPath(realm: string): string;
+/**
+ * Get current realm path
+ * @returns {string} a CREST-compliant realm path, e.g. /realms/root/realms/alpha
+ */
+export declare function getCurrentRealmPath(state: State): string;
+/**
+ * Get current realm name
+ * @returns {string} name of the current realm. /alpha -> alpha
+ */
+export declare function getCurrentRealmName(state: State): string;
+/**
+ * Get the name of the managed user object for the current realm
+ * @returns {string} the name of the managed user object for the current realm
+ */
+export declare function getCurrentRealmManagedUser({ state, }: {
+    state: State;
+}): string;
+/**
+ * Get current realm name
+ * @param {string} realm realm
+ * @returns {string} name of the realm. /alpha -> alpha
+ */
+export declare function getRealmName(realm: string): string;
+/**
+ * Get host-only URL without path and query params
+ * @param {string} url URL with path and query params
+ * @returns {string} AM host URL without path and query params
+ */
+export declare function getHostOnlyUrl(url: string): string;
+/**
+ * Get IDM base URL
+ * @param {State} state State object
+ * @returns {string} IDM host URL without path and query params
+ */
+export declare function getIdmBaseUrl(state: State): string;
+//# sourceMappingURL=ForgeRockUtils.d.ts.map

package/types/utils/ForgeRockUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgeRockUtils.d.ts","sourceRoot":"","sources":["../../src/utils/ForgeRockUtils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGxC,MAAM,MAAM,OAAO,GAAG;IACpB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,mBAAmB,IAAI,MAAM,CAAC;IAC9B,mBAAmB,IAAI,MAAM,CAAC;IAC9B,0BAA0B,IAAI,MAAM,CAAC;IACrC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC;;;;;OAKG;IACH,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC;IAIxB;;;;;;;;;OASG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC,CAAC;yBAEc,OAAO,KAAK,KAAG,OAAO;AAAtC,wBAsCE;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,KAAK,GACN,EAAE;IACD,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYpB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,OAAO,EACrB,KAAK,EAAE,KAAK,GACX,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAQxD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,GACN,EAAE;IACD,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,MAAM,CAcT;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAKlD"}

package/types/utils/FrodoNodeHttpAdapter.d.ts

@@ -0,0 +1,5 @@
+import NodeHttpAdapter from '@pollyjs/adapter-node-http';
+export declare class FrodoNodeHttpAdapter extends NodeHttpAdapter {
+    onRequest(pollyRequest: any): Promise<void>;
+}
+//# sourceMappingURL=FrodoNodeHttpAdapter.d.ts.map

package/types/utils/FrodoNodeHttpAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrodoNodeHttpAdapter.d.ts","sourceRoot":"","sources":["../../src/utils/FrodoNodeHttpAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,4BAA4B,CAAC;AAGzD,qBAAa,oBAAqB,SAAQ,eAAe;IACjD,SAAS,CAAC,YAAY,KAAA;CAI7B"}

package/types/utils/FrodoUtils.d.ts

@@ -0,0 +1,15 @@
+export type FrodoUtils = {
+    /**
+     * Get the Frodo home directory path.
+     * @returns {string} absolute path to the Frodo home directory
+     */
+    getFrodoHome(): string;
+};
+declare const _default: () => FrodoUtils;
+export default _default;
+/**
+ * Get the Frodo home directory path in an OS-independent way.
+ * @returns {string} absolute path to the Frodo home directory
+ */
+export declare function getFrodoHome(): string;
+//# sourceMappingURL=FrodoUtils.d.ts.map

package/types/utils/FrodoUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrodoUtils.d.ts","sourceRoot":"","sources":["../../src/utils/FrodoUtils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG;IACvB;;;OAGG;IACH,YAAY,IAAI,MAAM,CAAC;CACxB,CAAC;8BAEiB,UAAU;AAA7B,wBAME;AAEF;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/types/utils/HelpUtils.d.ts

@@ -0,0 +1,19 @@
+import { type MethodHelpDoc } from '../lib/Help';
+export type HelpUtils = {
+    /**
+     * Get all generated help metadata entries.
+     * @returns {MethodHelpDoc[]} help metadata entries
+     */
+    getHelpMetadata(): MethodHelpDoc[];
+    /**
+     * Get generated help metadata entries by method name.
+     * @param {string} methodName method name
+     * @returns {MethodHelpDoc[]} matching help metadata entries
+     */
+    getHelpMetadataByMethod(methodName: string): MethodHelpDoc[];
+};
+declare const _default: () => HelpUtils;
+export default _default;
+export declare function getHelpMetadata(): MethodHelpDoc[];
+export declare function getHelpMetadataByMethod(methodName: string): MethodHelpDoc[];
+//# sourceMappingURL=HelpUtils.d.ts.map

package/types/utils/HelpUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpUtils.d.ts","sourceRoot":"","sources":["../../src/utils/HelpUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG;IACtB;;;OAGG;IACH,eAAe,IAAI,aAAa,EAAE,CAAC;IACnC;;;;OAIG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;CAC9D,CAAC;8BAEiB,SAAS;AAA5B,wBASE;AAEF,wBAAgB,eAAe,IAAI,aAAa,EAAE,CAEjD;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAE3E"}

package/types/utils/JsonUtils.d.ts

@@ -0,0 +1,105 @@
+export type Json = {
+    /**
+     * Compare two json objects
+     * @param {object} obj1 object 1
+     * @param {object} obj2 object 2
+     * @param {string[]} ignoreKeys array of keys to ignore in comparison
+     * @returns {boolean} true if the two json objects have the same length and all the properties have the same value
+     */
+    isEqualJson(obj1: object, obj2: object, ignoreKeys?: string[]): boolean;
+    /**
+     * Deep delete keys and their values from an input object. If a key in object contains substring, the key an its value is deleted.
+     * @param {Object} object input object that needs keys removed
+     * @param {String} substring substring to search for in key
+     * @returns the modified object without the matching keys and their values
+     */
+    deleteDeepByKey(object: any, substring: any): any;
+    /**
+     * Deep clone object
+     * @param {any} obj object to deep clone
+     * @returns {any} new object cloned from obj
+     */
+    cloneDeep(obj: any): any;
+    /**
+     * Deep merge two objects
+     * @param obj1 first object
+     * @param obj2 second object
+     * @returns merged first and second object
+     */
+    mergeDeep(obj1: any, obj2: any): any;
+    /**
+     * Get all paths for an object
+     * @param {any} o object
+     * @param {string} prefix prefix (path calculated up to this point). Only needed for recursion or to add a global prefix to all paths.
+     * @param {string} delim delimiter used to separate elements of the path. Default is '.'.
+     * @returns {string[]} an array of paths
+     */
+    getPaths(o: any, prefix?: string, delim?: string): string[];
+    findInArray(objs: any[], predicate: any): any;
+    get(obj: any, path: string[], defaultValue?: any): any;
+    put(obj: any, value: any, path: string[]): any;
+    /**
+     * Deterministic stringify
+     * @param {any} obj json object to stringify deterministically
+     * @returns {string} stringified json object
+     */
+    stringify(obj: any): string;
+};
+declare const _default: () => Json;
+export default _default;
+/**
+ * Compare two json objects
+ * @param {object} obj1 object 1
+ * @param {object} obj2 object 2
+ * @param {string[]} ignoreKeys array of keys to ignore in comparison
+ * @returns {boolean} true if the two json objects have the same length and all the properties have the same value
+ */
+export declare function isEqualJson(obj1: object, obj2: object, ignoreKeys?: string[]): boolean;
+/**
+ * Deep delete keys and their values from an input object. If a key in object contains or equals substring, the key and its value is deleted.
+ * @param {Object} object input object that needs keys removed
+ * @param {String} substring substring to search for in key
+ * @returns the modified object without the matching keys and their values
+ */
+export declare function deleteDeepByKey(object: any, substring: string): any;
+/**
+ * Deep delete keys and their values from an input object. If a key in object contains or equals a substring of any provided, the key and its value is deleted.
+ * @param {Object} object input object that needs keys removed
+ * @param {String[]} substrings substrings to search for in key
+ * @returns the modified object without the matching keys and their values
+ */
+export declare function deleteDeepByKeys(object: any, substrings: string[]): any;
+/**
+ * Deep clone object
+ * @param {any} obj object to deep clone
+ * @returns {any} new object cloned from obj
+ */
+export declare function cloneDeep(obj: any): any;
+/**
+ * Deep merge two objects
+ * @param obj1 first object
+ * @param obj2 second object
+ * @returns merged first and second object
+ */
+export declare function mergeDeep(obj1: any, obj2: any): any;
+/**
+ * Get all paths for an object
+ * This function was explicitly created for the shell command in the Frodo CLI
+ * and has some special casing that may not leave it generic enough to be used
+ * for what its name implies.
+ * @param {any} o object
+ * @param {string} prefix prefix (path calculated up to this point). Only needed for recursion or to add a global prefix to all paths.
+ * @param {string} delim delimiter used to separate elements of the path. Default is '.'.
+ * @returns {string[]} an array of paths
+ */
+export declare function getPaths(o: any, prefix?: string, delim?: string): string[];
+export declare function findInArray(objs: any[], predicate: any): any;
+export declare function get(obj: any, path: string[], defaultValue?: any): any;
+export declare function put(obj: any, value: any, path: string[]): any;
+/**
+ * Deterministic stringify
+ * @param obj json object to stringify deterministically
+ * @returns stringified json object
+ */
+export declare function stringify(obj: any): string;
+//# sourceMappingURL=JsonUtils.d.ts.map

package/types/utils/JsonUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonUtils.d.ts","sourceRoot":"","sources":["../../src/utils/JsonUtils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG;IACjB;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACxE;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,GAAG,CAAC;IAClD;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC;IACzB;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5D,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,GAAG,CAAC;IAC9C,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACvD,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC/C;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC;CAC7B,CAAC;8BAEiB,IAAI;AAAvB,wBAkCE;AAEF;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,EAAO,GACxB,OAAO,CAwBT;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAE7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,OAejE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,CAUnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,SAAK,EAAE,KAAK,SAAM,GAAG,MAAM,EAAE,CAoBnE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,GAAG,CAS5D;AAED,wBAAgB,GAAG,CACjB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,MAAM,EAAE,EACd,YAAY,GAAE,GAAe,GAC5B,GAAG,CAOL;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAQ7D;AAoBD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAE1C"}

package/types/utils/JwtUtils.d.ts

@@ -0,0 +1,19 @@
+export type Jwt = {
+    decodeJwtPayload(jwt: string): Record<string, unknown>;
+};
+declare const _default: () => Jwt;
+export default _default;
+/**
+ * Decode a JWT's payload (the middle, base64url-encoded segment) without
+ * verifying its signature.
+ *
+ * @remarks
+ * Signature verification is deliberately not performed — every caller in
+ * frodo-lib only ever decodes a token it just received directly from AM
+ * itself over TLS (e.g. to read the `may_act` claim off a freshly-issued
+ * access token), never a token supplied by an untrusted third party.
+ * @param {string} jwt the JSON Web Token to decode
+ * @returns {Record<string, unknown>} the decoded payload claims
+ */
+export declare function decodeJwtPayload(jwt: string): Record<string, unknown>;
+//# sourceMappingURL=JwtUtils.d.ts.map

package/types/utils/JwtUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JwtUtils.d.ts","sourceRoot":"","sources":["../../src/utils/JwtUtils.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,GAAG;IAChB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxD,CAAC;8BAEiB,GAAG;AAAtB,wBAME;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUrE"}

package/types/utils/PkceUtils.d.ts

@@ -0,0 +1,17 @@
+export type PkcePair = {
+    verifier: string;
+    challenge: string;
+    method: 'S256';
+};
+export type Pkce = {
+    createPkcePair(): PkcePair;
+};
+declare const _default: () => Pkce;
+export default _default;
+/**
+ * Generate a PKCE (RFC 7636) verifier/challenge pair for an OAuth2
+ * authorization code exchange.
+ * @returns {PkcePair} a fresh, cryptographically random verifier/challenge pair
+ */
+export declare function createPkcePair(): PkcePair;
+//# sourceMappingURL=PkceUtils.d.ts.map

package/types/utils/PkceUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PkceUtils.d.ts","sourceRoot":"","sources":["../../src/utils/PkceUtils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,cAAc,IAAI,QAAQ,CAAC;CAC5B,CAAC;8BAEiB,IAAI;AAAvB,wBAME;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAMzC"}

package/types/utils/PollyUtils.d.ts

@@ -0,0 +1,65 @@
+import { State } from '../shared/State';
+export type Recording = {
+    request: {
+        url: string;
+        headers: [{
+            name: string;
+            value: string;
+        }];
+        postData: {
+            mimeType: string;
+            text: any;
+        };
+    };
+    response: {
+        content: {
+            mimeType: string;
+            text: any;
+        };
+        cookies: {
+            httpOnly: boolean;
+            name: string;
+            path: string;
+            value: string;
+        }[];
+        headers: [{
+            name: string;
+            value: string;
+        }];
+    };
+};
+export declare function defaultMatchRequestsBy(protocol?: boolean): {
+    method: boolean;
+    headers: boolean;
+    body: boolean;
+    order: boolean;
+    url: {
+        protocol: boolean;
+        username: boolean;
+        password: boolean;
+        hostname: boolean;
+        port: boolean;
+        pathname: boolean;
+        query: boolean;
+        hash: boolean;
+    };
+};
+export declare function orderedMatchRequestsBy(protocol?: boolean): {
+    method: boolean;
+    headers: boolean;
+    body: boolean;
+    order: boolean;
+    url: {
+        protocol: boolean;
+        username: boolean;
+        password: boolean;
+        hostname: boolean;
+        port: boolean;
+        pathname: boolean;
+        query: boolean;
+        hash: boolean;
+    };
+};
+export declare function filterRecording(recording: Recording, useDefaultHost?: boolean, state?: State): void;
+export declare function cleanupProxyRequestUrl(url: string): string;
+//# sourceMappingURL=PollyUtils.d.ts.map

package/types/utils/PollyUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PollyUtils.d.ts","sourceRoot":"","sources":["../../src/utils/PollyUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGxC,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3C,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC;KAC3C,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC;QACzC,OAAO,EAAE;YACP,QAAQ,EAAE,OAAO,CAAC;YAClB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;SACf,EAAE,CAAC;QACJ,OAAO,EAAE,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,QAAQ,GAAE,OAAc;;;;;;;;;;;;;;;EAiB9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,GAAE,OAAc;;;;;;;;;;;;;;;EAiB9D;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,cAAc,UAAO,EACrB,KAAK,CAAC,EAAE,KAAK,QA0Dd;AAiHD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM1D"}

package/types/utils/ScriptValidationUtils.d.ts

@@ -0,0 +1,38 @@
+import { type ScriptSkeleton } from '../api/ScriptApi';
+import { State } from '../shared/State';
+export type ScriptValidation = {
+    validateScriptHooks(jsonData: object): void;
+    validateScript(scriptData: ScriptSkeleton): void;
+    validateJs(javascriptSource: string): void;
+    areScriptHooksValid(jsonData: object): boolean;
+    isScriptValid(scriptData: ScriptSkeleton): boolean;
+    isValidJs(javascriptSource: string): boolean;
+};
+declare const _default: (state: State) => ScriptValidation;
+export default _default;
+export interface ScriptHook {
+    type: 'text/javascript';
+    source?: string;
+}
+export declare function validateScriptHooks({ jsonData }: {
+    jsonData: object;
+}): void;
+export declare function validateScript({ scriptData, }: {
+    scriptData: ScriptSkeleton;
+}): void;
+export declare function validateJs({ javascriptSource }: {
+    javascriptSource: string;
+}): boolean;
+export declare function areScriptHooksValid({ jsonData, state, }: {
+    jsonData: object;
+    state: State;
+}): boolean;
+export declare function isScriptValid({ scriptData, state, }: {
+    scriptData: ScriptSkeleton;
+    state: State;
+}): boolean;
+export declare function isValidJs({ javascriptSource, state, }: {
+    javascriptSource: string;
+    state: State;
+}): boolean;
+//# sourceMappingURL=ScriptValidationUtils.d.ts.map

package/types/utils/ScriptValidationUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptValidationUtils.d.ts","sourceRoot":"","sources":["../../src/utils/ScriptValidationUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIxC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IACjD,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/C,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC;IACnD,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9C,CAAC;yBAEc,OAAO,KAAK,KAAG,gBAAgB;AAA/C,wBAqBE;AAEF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0BD,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU5E;AAED,wBAAgB,cAAc,CAAC,EAC7B,UAAU,GACX,EAAE;IACD,UAAU,EAAE,cAAc,CAAC;CAC5B,GAAG,IAAI,CAOP;AAED,wBAAgB,UAAU,CAAC,EAAE,gBAAgB,EAAE,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,WAK5E;AAED,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,KAAK,GACN,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,OAAO,CAcV;AAED,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,KAAK,GACN,EAAE;IACD,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,OAAO,CAaV;AAED,wBAAgB,SAAS,CAAC,EACxB,gBAAgB,EAChB,KAAK,GACN,EAAE;IACD,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;CACd,WAaA"}

package/types/utils/SemverUtils.d.ts

@@ -0,0 +1,61 @@
+export type SemverUtils = {
+    /**
+     * Compare two semantic version strings (e.g., "1.2.3" and "1.2.4").
+     * @param {string} v1 - The first semantic version string.
+     * @param {string} v2 - The second semantic version string.
+     * @returns {number} - Returns 1 if v1 > v2, -1 if v1 < v2, and 0 if they are equal.
+     */
+    compare(v1: string, v2: string): number;
+    /**
+     * Greater Than (v1 > v2)
+     * @param v1 - The first semantic version string.
+     * @param v2 - The second semantic version string.
+     * @returns {boolean} - Returns true if v1 > v2, false otherwise.
+     */
+    gt(v1: string, v2: string): boolean;
+    /**
+     * Less Than (v1 < v2)
+     * @param v1 - The first semantic version string.
+     * @param v2 - The second semantic version string.
+     * @returns {boolean} - Returns true if v1 < v2, false otherwise.
+     */
+    lt(v1: string, v2: string): boolean;
+    /**
+     * Equal (v1 === v2)
+     * @param v1 - The first semantic version string.
+     * @param v2 - The second semantic version string.
+     * @returns {boolean} - Returns true if v1 === v2, false otherwise.
+     */
+    eq(v1: string, v2: string): boolean;
+};
+declare const _default: () => SemverUtils;
+export default _default;
+/**
+ * Compare two semantic version strings (e.g., "1.2.3" and "1.2.4").
+ * @param {string} v1 - The first semantic version string.
+ * @param {string} v2 - The second semantic version string.
+ * @returns {number} - Returns 1 if v1 > v2, -1 if v1 < v2, and 0 if they are equal.
+ */
+export declare function compare(v1: string, v2: string): number;
+/**
+ * Greater Than (v1 > v2)
+ * @param v1 - The first semantic version string.
+ * @param v2 - The second semantic version string.
+ * @returns {boolean} - Returns true if v1 > v2, false otherwise.
+ */
+export declare function gt(v1: string, v2: string): boolean;
+/**
+ * Less Than (v1 < v2)
+ * @param v1 - The first semantic version string.
+ * @param v2 - The second semantic version string.
+ * @returns {boolean} - Returns true if v1 < v2, false otherwise.
+ */
+export declare function lt(v1: string, v2: string): boolean;
+/**
+ * Equal (v1 === v2)
+ * @param v1 - The first semantic version string.
+ * @param v2 - The second semantic version string.
+ * @returns {boolean} - Returns true if v1 === v2, false otherwise.
+ */
+export declare function eq(v1: string, v2: string): boolean;
+//# sourceMappingURL=SemverUtils.d.ts.map

package/types/utils/SemverUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SemverUtils.d.ts","sourceRoot":"","sources":["../../src/utils/SemverUtils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC;;;;;OAKG;IACH,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC;;;;;OAKG;IACH,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC;;;;;OAKG;IACH,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC,CAAC;8BAEiB,WAAW;AAA9B,wBAeE;AAEF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/types/utils/SetupPollyForFrodoLib.d.ts

@@ -0,0 +1,7 @@
+import { Polly } from '@pollyjs/core';
+import { State } from '../shared/State';
+export declare function setupPollyForFrodoLib({ matchRequestsBy, state, }: {
+    matchRequestsBy?: any;
+    state: State;
+}): Polly;
+//# sourceMappingURL=SetupPollyForFrodoLib.d.ts.map

package/types/utils/SetupPollyForFrodoLib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetupPollyForFrodoLib.d.ts","sourceRoot":"","sources":["../../src/utils/SetupPollyForFrodoLib.ts"],"names":[],"mappings":"AAOA,OAAO,EAAmB,KAAK,EAAE,MAAM,eAAe,CAAC;AAIvD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAwSxC,wBAAgB,qBAAqB,CAAC,EACpC,eAA+C,EAC/C,KAAK,GACN,EAAE;IACD,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,KAAK,CA4PR"}

package/types/utils/TerminalBackgroundDetection.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Best-effort detection of a terminal's actual background color via OSC 11
+ * (`ESC ] 11 ; ? BEL`, terminal replies `ESC ] 11 ; rgb:RRRR/GGGG/BBBB`).
+ *
+ * Support is real but inconsistent: well-supported in iTerm2, Kitty,
+ * WezTerm, Alacritty, and VTE-based terminals (gnome-terminal); flaky or
+ * absent over tmux (which caches the response until the client reattaches)
+ * and on some Windows terminals; and simply silent forever on a terminal
+ * that doesn't implement it at all -- which is why this always races the
+ * response against a short timeout rather than waiting indefinitely, and
+ * always restores stdin's raw-mode/listener state on both the success and
+ * timeout paths.
+ *
+ * Modeled closely on the equivalent query in the `os-theme` package (MIT,
+ * https://www.npmjs.com/package/os-theme), which solves the same raw-mode/
+ * timeout/cleanup mechanics correctly -- reimplemented locally rather than
+ * taken as a dependency because that package's public API only returns a
+ * collapsed dark/light classification, discarding the parsed RGB before it
+ * ever leaves the module; this needs the actual RGB to tell a plain white
+ * background apart from a colored one (e.g. a light blue terminal), which
+ * a dark/light-only signal can't do.
+ */
+import type { Rgb } from './TerminalContrast';
+/**
+ * Queries the terminal's actual background color via OSC 11. Resolves
+ * `null` immediately, with no query attempted, when stdin/stdout aren't a
+ * TTY (piped/scripted/CI usage) -- and resolves `null` after a short
+ * timeout if the terminal never responds (unsupported terminal, or a
+ * multiplexer/SSH chain that swallows the query).
+ */
+export declare function detectTerminalBackgroundRgb(): Promise<Rgb | null>;
+export type BackgroundPreset = {
+    /** Matches a `ThemeConfig.ts` bundled theme definition's `name`. */
+    themeName: string;
+    referenceRgb: Rgb;
+};
+/**
+ * Matches a detected background RGB against a fixed set of named presets by
+ * simple RGB-space nearest-neighbor, falling back to `fallbackDark`/
+ * `fallbackLight` (chosen by relative luminance) when nothing is close
+ * enough to be a confident match. `maxDistance` (0-441.7, the diagonal of
+ * the RGB cube) defaults to a fairly tight radius -- this is meant to catch
+ * "this terminal is unmistakably that preset's color", not to force every
+ * detected background into the nearest bucket regardless of how far off it
+ * actually is.
+ */
+export declare function matchBackgroundPreset(detectedRgb: Rgb, presets: BackgroundPreset[], fallbackDark: string, fallbackLight: string, maxDistance?: number): string;
+//# sourceMappingURL=TerminalBackgroundDetection.d.ts.map

package/types/utils/TerminalBackgroundDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalBackgroundDetection.d.ts","sourceRoot":"","sources":["../../src/utils/TerminalBackgroundDetection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAmB9C;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAwCjE;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC;CACnB,CAAC;AAQF;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,GAAG,EAChB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,SAAK,GACf,MAAM,CAgBR"}

package/types/utils/TerminalContrast.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Objective readability filtering for the standard 16-color ANSI palette.
+ *
+ * Terminal color schemes are user-configurable, so there's no single true
+ * RGB value for e.g. "red" across every terminal emulator -- the table below
+ * is the conventional xterm default palette, used here as a representative
+ * reference for building a sane default theme, not a live guarantee for any
+ * specific user's actual terminal colors.
+ *
+ * The contrast math is the standard WCAG 2 relative-luminance/contrast-ratio
+ * formula (the same one used to judge foreground/background text contrast
+ * on the web), applied here to terminal foreground colors against a plain
+ * black or white background -- giving a computed, reviewable answer to
+ * "is this color readable on this background" instead of eyeballing it.
+ */
+export type AnsiColorName = 'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'blackBright' | 'redBright' | 'greenBright' | 'yellowBright' | 'blueBright' | 'magentaBright' | 'cyanBright' | 'whiteBright';
+export type Rgb = [number, number, number];
+export type TerminalBackground = 'black' | 'white';
+/**
+ * WCAG 2 contrast ratio between two colors, from 1 (no contrast) to 21
+ * (black on white or vice versa).
+ */
+export declare function contrastRatio(a: Rgb, b: Rgb): number;
+/**
+ * Filters the standard 16-color ANSI palette down to the colors that meet a
+ * minimum WCAG contrast ratio against a background. Default minimum is 4.5,
+ * WCAG AA's threshold for normal-sized text.
+ *
+ * `background` accepts either the plain `'black'`/`'white'` reference
+ * (the two extremes every built-in theme is checked against) or an
+ * arbitrary RGB triple -- needed for theme presets tuned to a real,
+ * non-black/non-white terminal background (e.g. a detected or named
+ * background-color preset), where contrast has to be checked against that
+ * background's actual color, not just its nearest black/white extreme.
+ */
+export declare class TerminalContrastFilter {
+    private readonly backgroundRgb;
+    private readonly minRatio;
+    constructor(background: TerminalBackground | Rgb, minRatio?: number);
+    isReadable(color: AnsiColorName): boolean;
+    filter(colors: AnsiColorName[]): AnsiColorName[];
+}
+export declare const ALL_ANSI_COLOR_NAMES: AnsiColorName[];
+//# sourceMappingURL=TerminalContrast.d.ts.map

package/types/utils/TerminalContrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalContrast.d.ts","sourceRoot":"","sources":["../../src/utils/TerminalContrast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,OAAO,GACP,aAAa,GACb,WAAW,GACX,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC;AAuCnD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAMpD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAM;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,UAAU,EAAE,kBAAkB,GAAG,GAAG,EAAE,QAAQ,SAAM;IAOhE,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAOzC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE;CAGjD;AAED,eAAO,MAAM,oBAAoB,EAE5B,aAAa,EAAE,CAAC"}