@cdklabs/cdk-construct-connect-datalake 0.0.15 → 0.0.16

package/node_modules/path-expression-matcher/lib/pem.d.cts

@@ -1,715 +0,0 @@
-/**
- * TypeScript definitions for path-expression-matcher (CommonJS)
- */
-
-/**
- * Options for creating an Expression
- */
-declare interface ExpressionOptions {
-  /**
-   * Path separator character
-   * @default '.'
-   */
-  separator?: string;
-}
-
-/**
- * Parsed segment from an expression pattern
- */
-declare interface Segment {
-  /**
-   * Type of segment
-   */
-  type: 'tag' | 'deep-wildcard';
-
-  /**
-   * Tag name (e.g., "user", "*" for wildcard)
-   * Only present when type is 'tag'
-   */
-  tag?: string;
-
-  /**
-   * Namespace prefix (e.g., "ns" in "ns::user")
-   * Only present when namespace is specified
-   */
-  namespace?: string;
-
-  /**
-   * Attribute name to match (e.g., "id" in "user[id]")
-   * Only present when attribute condition exists
-   */
-  attrName?: string;
-
-  /**
-   * Attribute value to match (e.g., "123" in "user[id=123]")
-   * Only present when attribute value is specified
-   */
-  attrValue?: string;
-
-  /**
-   * Position selector type
-   * Only present when position selector exists
-   */
-  position?: 'first' | 'last' | 'odd' | 'even' | 'nth';
-
-  /**
-   * Numeric value for nth() selector
-   * Only present when position is 'nth'
-   */
-  positionValue?: number;
-}
-
-/**
- * Expression - Parses and stores a tag pattern expression
- * 
- * Patterns are parsed once and stored in an optimized structure for fast matching.
- * 
- * @example
- * ```javascript
- * const { Expression } = require('path-expression-matcher');
- * const expr = new Expression("root.users.user");
- * const expr2 = new Expression("..user[id]:first");
- * const expr3 = new Expression("root/users/user", { separator: '/' });
- * ```
- * 
- * Pattern Syntax:
- * - `root.users.user` - Match exact path
- * - `..user` - Match "user" at any depth (deep wildcard)
- * - `user[id]` - Match user tag with "id" attribute
- * - `user[id=123]` - Match user tag where id="123"
- * - `user:first` - Match first occurrence of user tag
- * - `ns::user` - Match user tag with namespace "ns"
- * - `ns::user[id]:first` - Combine namespace, attribute, and position
- * ```
- */
-declare class Expression {
-  /**
-   * Original pattern string
-   */
-  readonly pattern: string;
-
-  /**
-   * Path separator character
-   */
-  readonly separator: string;
-
-  /**
-   * Parsed segments
-   */
-  readonly segments: Segment[];
-
-  /**
-   * Create a new Expression
-   * @param pattern - Pattern string (e.g., "root.users.user", "..user[id]")
-   * @param options - Configuration options
-   */
-  constructor(pattern: string, options?: ExpressionOptions);
-
-  /**
-   * Get the number of segments
-   */
-  get length(): number;
-
-  /**
-   * Check if expression contains deep wildcard (..)
-   */
-  hasDeepWildcard(): boolean;
-
-  /**
-   * Check if expression has attribute conditions
-   */
-  hasAttributeCondition(): boolean;
-
-  /**
-   * Check if expression has position selectors
-   */
-  hasPositionSelector(): boolean;
-
-  /**
-   * Get string representation
-   */
-  toString(): string;
-}
-
-/**
- * Options for creating a Matcher
- */
-declare interface MatcherOptions {
-  /**
-   * Default path separator
-   * @default '.'
-   */
-  separator?: string;
-}
-
-/**
- * Internal node structure in the path stack
- */
-declare interface PathNode {
-  /**
-   * Tag name
-   */
-  tag: string;
-
-  /**
-   * Namespace (if present)
-   */
-  namespace?: string;
-
-  /**
-   * Position in sibling list (child index in parent)
-   */
-  position: number;
-
-  /**
-   * Counter (occurrence count of this tag name)
-   */
-  counter: number;
-
-  /**
-   * Attribute key-value pairs
-   * Only present for the current (last) node in path
-   */
-  values?: Record<string, any>;
-}
-
-/**
- * Snapshot of matcher state
- */
-declare interface MatcherSnapshot {
-  /**
-   * Copy of the path stack
-   */
-  path: PathNode[];
-
-  /**
-   * Copy of sibling tracking maps
-   */
-  siblingStacks: Map<string, number>[];
-
-  /**
-   * Copy of the kept-attrs stack (see {@link PushOptions.keep})
-   */
-  keptAttrs: KeptAttrEntry[];
-}
-
-/**
- * A single entry in the matcher's kept-attrs stack — an attribute value
- * explicitly retained at push time via `{ keep: [...] }` so it remains
- * reachable from descendants after the owning node is no longer current.
- */
-declare interface KeptAttrEntry {
-  /** Path depth (1-based) of the node that declared this kept attribute */
-  depth: number;
-  /** Attribute name */
-  name: string;
-  /** Attribute value at push time */
-  value: any;
-}
-
-/**
- * Options for {@link Matcher.push}
- */
-declare interface PushOptions {
-  /**
-   * Names of attributes (from `attrValues`) to retain for ancestor lookup
-   * (`getAnyParentAttr` / `hasAnyParentAttr`) even after this node is no
-   * longer the current node.
-   *
-   * Use sparingly — this is for attributes you know you'll need much deeper
-   * in the tree (e.g. `xml:space`, a SOAP envelope's `version`), not a
-   * general substitute for `getAttrValue()`. Cost is proportional to
-   * `keep.length`, independent of path depth.
-   */
-  keep?: string[];
-}
-
-/**
- * ReadOnlyMatcher - A safe, read-only view over a {@link Matcher} instance.
- *
- * Returned by {@link Matcher.readOnly}. Exposes all query and inspection
- * methods but **throws a `TypeError`** if any state-mutating method is called
- * (`push`, `pop`, `reset`, `updateCurrent`, `restore`).  Direct property
- * writes are also blocked.
- *
- * Pass this to consumers that only need to inspect or match the current path
- * so they cannot accidentally corrupt the parser state.
- *
- * @example
- * ```javascript
- * const matcher = new Matcher();
- * matcher.push("root", {});
- * matcher.push("users", {});
- * matcher.push("user", { id: "123" });
- *
- * const ro: ReadOnlyMatcher = matcher.readOnly();
- *
- * ro.matches(expr);      // ✓ works
- * ro.getCurrentTag();    // ✓ "user"
- * ro.getDepth();         // ✓ 3
- * ro.push("child", {}); // ✗ TypeError: Cannot call 'push' on a read-only Matcher
- * ro.reset();            // ✗ TypeError: Cannot call 'reset' on a read-only Matcher
- * ```
- */
-declare interface ReadOnlyMatcher {
-  /**
-   * Default path separator (read-only)
-   */
-  readonly separator: string;
-
-  /**
-   * Current path stack (each node is a frozen copy)
-   */
-  readonly path: ReadonlyArray<Readonly<PathNode>>;
-
-  // ── Query methods ───────────────────────────────────────────────────────────
-
-  /**
-   * Get current tag name
-   * @returns Current tag name or undefined if path is empty
-   */
-  getCurrentTag(): string | undefined;
-
-  /**
-   * Get current namespace
-   * @returns Current namespace or undefined if not present or path is empty
-   */
-  getCurrentNamespace(): string | undefined;
-
-  /**
-   * Get current node's attribute value
-   * @param attrName - Attribute name
-   * @returns Attribute value or undefined
-   */
-  getAttrValue(attrName: string): any;
-
-  /**
-   * Check if current node has an attribute
-   * @param attrName - Attribute name
-   */
-  hasAttr(attrName: string): boolean;
-
-  /**
-   * Get the value of a "kept" attribute from the nearest ancestor (or
-   * current node) that declared it via `push(tag, attrs, ns, { keep: [...] })`.
-   * Unlike `getAttrValue()`, this works regardless of how deep the path has
-   * gone since the attribute was pushed — but only for attribute names that
-   * were explicitly marked with `keep` at push time.
-   * @param attrName - Attribute name
-   * @returns The kept value, or undefined if no ancestor kept this attribute
-   */
-  getAnyParentAttr(attrName: string): any;
-
-  /**
-   * Check whether any ancestor (or the current node) kept the given
-   * attribute via `push(tag, attrs, ns, { keep: [...] })`.
-   * @param attrName - Attribute name
-   */
-  hasAnyParentAttr(attrName: string): boolean;
-
-  /**
-   * Get current node's sibling position (child index in parent)
-   * @returns Position index or -1 if path is empty
-   */
-  getPosition(): number;
-
-  /**
-   * Get current node's repeat counter (occurrence count of this tag name)
-   * @returns Counter value or -1 if path is empty
-   */
-  getCounter(): number;
-
-  /**
-   * Get current node's sibling index (alias for getPosition for backward compatibility)
-   * @returns Index or -1 if path is empty
-   * @deprecated Use getPosition() or getCounter() instead
-   */
-  getIndex(): number;
-
-  /**
-   * Get current path depth
-   * @returns Number of nodes in the path
-   */
-  getDepth(): number;
-
-  /**
-   * Get path as string
-   * @param separator - Optional separator (uses default if not provided)
-   * @param includeNamespace - Whether to include namespace in output
-   * @returns Path string (e.g., "root.users.user" or "ns:root.ns:users.user")
-   */
-  toString(separator?: string, includeNamespace?: boolean): string;
-
-  /**
-   * Get path as array of tag names
-   * @returns Array of tag names
-   */
-  toArray(): string[];
-
-  /**
-   * Match current path against an Expression
-   * @param expression - The expression to match against
-   * @returns True if current path matches the expression
-   */
-  matches(expression: Expression): boolean;
-
-  /**
-   * Test whether the matcher's current path matches **any** expression in the set.
-   *
-   * @param exprSet - A `ExpressionSet` instance
-   * @returns `true` if at least one expression matches the current path
-   */
-  matchesAny(exprSet: ExpressionSet): boolean;
-  /**
-   * Create a snapshot of current state
-   * @returns State snapshot that can be restored later
-   */
-  snapshot(): MatcherSnapshot;
-
-  // ── Blocked mutating methods ────────────────────────────────────────────────
-  // These are present in the type so callers get a compile-time error with a
-  // helpful message instead of a silent "property does not exist" error.
-
-  /**
-   * @throws {TypeError} Always – mutation is not allowed on a read-only view.
-   */
-  push(tagName: string, attrValues?: Record<string, any> | null, namespace?: string | null): never;
-
-  /**
-   * @throws {TypeError} Always – mutation is not allowed on a read-only view.
-   */
-  pop(): never;
-
-  /**
-   * @throws {TypeError} Always – mutation is not allowed on a read-only view.
-   */
-  updateCurrent(attrValues: Record<string, any>): never;
-
-  /**
-   * @throws {TypeError} Always – mutation is not allowed on a read-only view.
-   */
-  reset(): never;
-
-  /**
-   * @throws {TypeError} Always – mutation is not allowed on a read-only view.
-   */
-  restore(snapshot: MatcherSnapshot): never;
-}
-
-/**
- * Matcher - Tracks current path in XML/JSON tree and matches against Expressions
- * 
- * The matcher maintains a stack of nodes representing the current path from root to
- * current tag. It only stores attribute values for the current (top) node to minimize
- * memory usage.
- * 
- * @example
- * ```javascript
- * const { Matcher } = require('path-expression-matcher');
- * const matcher = new Matcher();
- * matcher.push("root", {});
- * matcher.push("users", {});
- * matcher.push("user", { id: "123", type: "admin" });
- * 
- * const expr = new Expression("root.users.user");
- * matcher.matches(expr); // true
- * 
- * matcher.pop();
- * matcher.matches(expr); // false
- * ```
- */
-declare class Matcher {
-  /**
-   * Default path separator
-   */
-  readonly separator: string;
-
-  /**
-   * Current path stack
-   */
-  readonly path: PathNode[];
-
-  /**
-   * Create a new Matcher
-   * @param options - Configuration options
-   */
-  constructor(options?: MatcherOptions);
-
-  /**
-   * Push a new tag onto the path
-   * @param tagName - Name of the tag
-   * @param attrValues - Attribute key-value pairs for current node (optional)
-   * @param namespace - Namespace for the tag (optional)
-   * @param options - Push options, e.g. `{ keep: ['version'] }` to retain
-   *   specific attributes for ancestor lookup after this node stops being current
-   * 
-   * @example
-   * ```javascript
-   * matcher.push("user", { id: "123", type: "admin" });
-   * matcher.push("user", { id: "456" }, "ns");
-   * matcher.push("container", null);
-   * matcher.push("Body", { version: "1.1" }, "soap", { keep: ["version"] });
-   * ```
-   */
-  push(
-    tagName: string,
-    attrValues?: Record<string, any> | null,
-    namespace?: string | null,
-    options?: PushOptions | null
-  ): void;
-
-  /**
-   * Pop the last tag from the path
-   * @returns The popped node or undefined if path is empty
-   */
-  pop(): PathNode | undefined;
-
-  /**
-   * Update current node's attribute values
-   * Useful when attributes are parsed after push
-   * @param attrValues - Attribute values
-   */
-  updateCurrent(attrValues: Record<string, any>): void;
-
-  /**
-   * Get current tag name
-   * @returns Current tag name or undefined if path is empty
-   */
-  getCurrentTag(): string | undefined;
-
-  /**
-   * Get current namespace
-   * @returns Current namespace or undefined if not present or path is empty
-   */
-  getCurrentNamespace(): string | undefined;
-
-  /**
-   * Get current node's attribute value
-   * @param attrName - Attribute name
-   * @returns Attribute value or undefined
-   */
-  getAttrValue(attrName: string): any;
-
-  /**
-   * Check if current node has an attribute
-   * @param attrName - Attribute name
-   */
-  hasAttr(attrName: string): boolean;
-
-  /**
-   * Get the value of a "kept" attribute from the nearest ancestor (or current
-   * node) that declared it via `push(tag, attrs, ns, { keep: [...] })`.
-   * Cost is proportional to the number of currently-kept attributes, not
-   * path depth.
-   * @param attrName - Attribute name
-   * @returns The kept value, or undefined if no ancestor kept this attribute
-   */
-  getAnyParentAttr(attrName: string): any;
-
-  /**
-   * Check whether any ancestor (or the current node) kept the given
-   * attribute via `push(tag, attrs, ns, { keep: [...] })`.
-   * @param attrName - Attribute name
-   */
-  hasAnyParentAttr(attrName: string): boolean;
-
-  /**
-   * Get current node's sibling position (child index in parent)
-   * @returns Position index or -1 if path is empty
-   */
-  getPosition(): number;
-
-  /**
-   * Get current node's repeat counter (occurrence count of this tag name)
-   * @returns Counter value or -1 if path is empty
-   */
-  getCounter(): number;
-
-  /**
-   * Get current node's sibling index (alias for getPosition for backward compatibility)
-   * @returns Index or -1 if path is empty
-   * @deprecated Use getPosition() or getCounter() instead
-   */
-  getIndex(): number;
-
-  /**
-   * Get current path depth
-   * @returns Number of nodes in the path
-   */
-  getDepth(): number;
-
-  /**
-   * Get path as string
-   * @param separator - Optional separator (uses default if not provided)
-   * @param includeNamespace - Whether to include namespace in output
-   * @returns Path string (e.g., "root.users.user" or "ns:root.ns:users.user")
-   */
-  toString(separator?: string, includeNamespace?: boolean): string;
-
-  /**
-   * Get path as array of tag names
-   * @returns Array of tag names
-   */
-  toArray(): string[];
-
-  /**
-   * Reset the path to empty
-   */
-  reset(): void;
-
-  /**
-   * Match current path against an Expression
-   * @param expression - The expression to match against
-   * @returns True if current path matches the expression
-   * 
-   * @example
-   * ```javascript
-   * const expr = new Expression("root.users.user[id]");
-   * const matcher = new Matcher();
-   * 
-   * matcher.push("root");
-   * matcher.push("users");
-   * matcher.push("user", { id: "123" });
-   * 
-   * matcher.matches(expr); // true
-   * ```
-   */
-  matches(expression: Expression): boolean;
-
-
-  /**
-   * Test whether the matcher's current path matches **any** expression in the set.
-   *
-   * Uses the pre-built index to evaluate only the relevant bucket(s):
-   *  1. Exact depth + tag — O(1) lookup
-   *  2. Depth-matched wildcard tag — O(1) lookup
-   *  3. Deep-wildcard expressions — always scanned (typically a small list)
-   *
-   * @param exprSet - A `ExpressionSet` instance
-   * @returns `true` if at least one expression matches the current path
-   *
-   * @example
-   * ```typescript
-   * // Replaces:
-   * // for (const expr of stopNodeExpressions) {
-   * //   if (matcher.matches(expr)) return true;
-   * // }
-   *
-   * if (matcher.matchesAny(stopNodes)) {
-   *   // current tag is a stop node
-   * }
-   * ```
-   */
-  matchesAny(exprSet: ExpressionSet): boolean;
-  /**
-   * Create a snapshot of current state
-   * @returns State snapshot that can be restored later
-   */
-  snapshot(): MatcherSnapshot;
-
-  /**
-   * Restore state from snapshot
-   * @param snapshot - State snapshot from previous snapshot() call
-   */
-  restore(snapshot: MatcherSnapshot): void;
-
-  /**
-   * Return a read-only view of this matcher.
-   */
-  readOnly(): ReadOnlyMatcher;
-}
-
-/**
- * ExpressionSet - An indexed collection of Expressions for efficient bulk matching
- *
- * Pre-indexes expressions at insertion time by depth and terminal tag name so
- * that `matchesAny()` performs an O(1) bucket lookup rather than a full O(E)
- * linear scan on every tag.
- *
- * @example
- * ```javascript
- * const { Expression, ExpressionSet, Matcher } = require('path-expression-matcher');
- *
- * // Build once at config time
- * const stopNodes = new ExpressionSet();
- * stopNodes
- *   .add(new Expression('root.users.user'))
- *   .add(new Expression('root.config.*'))
- *   .add(new Expression('..script'))
- *   .seal();
- *
- * // Per-tag — hot path
- * if (stopNodes.matchesAny(matcher)) { ... }
- * ```
- */
-declare class ExpressionSet {
-  constructor();
-
-  /** Number of expressions currently in the set. */
-  readonly size: number;
-
-  /** Whether the set has been sealed against further modifications. */
-  readonly isSealed: boolean;
-
-  /**
-   * Add a single Expression. Duplicate patterns are silently ignored.
-   * @throws {TypeError} if the set has been sealed
-   */
-  add(expression: Expression): this;
-
-  /**
-   * Add multiple expressions at once.
-   * @throws {TypeError} if the set has been sealed
-   */
-  addAll(expressions: Expression[]): this;
-
-  /** Check whether an expression with the same pattern is already present. */
-  has(expression: Expression): boolean;
-
-  /**
-   * Seal the set against further modifications.
-   * Any subsequent call to add() or addAll() will throw a TypeError.
-   */
-  seal(): this;
-
-  /**
-   * Test whether the matcher's current path matches any expression in the set.
-   * Accepts both a Matcher instance and a ReadOnlyMatcher view.
-   * 
-   * 
-  * @param matcher - A `Matcher` instance or a `ReadOnlyMatcher` view
-  * @returns Expression if at least one expression matches the current path
-   */
-  matchesAny(matcher: Matcher | ReadOnlyMatcher): boolean;
-
-  /**
-   * Find the first expression in the set that matches the matcher's current path.
-
-   *
-   * @param matcher - A `Matcher` instance or a `ReadOnlyMatcher` view
-   * @returns Expression if at least one expression matches the current path
-   *
-   * @example
-   * ```typescript
-   * const node = stopNodes.findMatch(matcher);
-   * ```
-   */
-  findMatch(matcher: Matcher | ReadOnlyMatcher): Expression;
-}
-
-declare namespace pathExpressionMatcher {
-  export {
-    Expression,
-    Matcher,
-    ExpressionSet,
-    ExpressionOptions,
-    MatcherOptions,
-    Segment,
-    PathNode,
-    MatcherSnapshot,
-    KeptAttrEntry,
-    PushOptions,
-  };
-}
-
-export = pathExpressionMatcher;