@bevel-software/platform-core-backend 0.33.0 → 0.35.0

package/dist/modules/workspace/ripgrep-search.d.ts

@@ -0,0 +1,54 @@
+import { type IPatternMatcher, type IPatternSearch } from './pattern-matcher.contract.js';
+/**
+ * The one place a CALLER'S regular expression is run (see
+ * {@link IPatternMatcher}): ripgrep, as a child process of the server.
+ *
+ * Every run is `rg` started WITHOUT a shell, with the caller's pattern after
+ * `-e` and the searched path after `--`, so nothing the caller sends can
+ * become an option; `--no-config` keeps `RIPGREP_CONFIG_PATH` out of it. A
+ * tree is walked sorted by path (`--sort path`), so an answer is stable and a
+ * caller that has enough stops the walk.
+ *
+ * Each run is owned by the call that started it, which kills it on every way
+ * out: the walk finished, the caller stopped reading, the budget ran out, the
+ * search's caller went away (its abort signal), or an error. `close()` kills
+ * whatever is still running.
+ */
+export interface RipgrepPatternMatcherOptions {
+    /** Wall time one search's runs may spend, summed over every run it makes. Default 5 s. */
+    budgetMs?: number;
+    /** ripgrep runs at once; a run past this waits for one to end. Default 4. */
+    maxRunning?: number;
+    /** Runs that may wait at once; past it a search is refused with a 503. Default 16. */
+    maxWaiting?: number;
+    /** Longest pattern accepted. Default 1000. */
+    maxPatternLength?: number;
+}
+export declare class RipgrepPatternMatcher implements IPatternMatcher {
+    private readonly budgetMs;
+    private readonly maxRunning;
+    private readonly maxWaiting;
+    private readonly maxPatternLength;
+    private readonly runner;
+    private readonly live;
+    private readonly waiting;
+    private running;
+    private closed;
+    constructor(opts?: RipgrepPatternMatcherOptions);
+    search(pattern: string, opts: {
+        ignoreCase: boolean;
+        signal?: AbortSignal;
+    }): Promise<IPatternSearch>;
+    close(): Promise<void>;
+    /**
+     * A run's slot: given at once while fewer than `maxRunning` run, else after
+     * a wait bounded by the search's own limits (see {@link SlotWait}). A waiter
+     * that leaves — its caller gone, its budget spent, the matcher closed —
+     * leaves the queue too, so the slot a run gives back passes to a waiter
+     * that still wants it.
+     */
+    private slot;
+    /** Start `rg` from the server's PATH with `args`, registered so `close()` can end it. */
+    private start;
+}
+//# sourceMappingURL=ripgrep-search.d.ts.map

package/dist/modules/workspace/ripgrep-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripgrep-search.d.ts","sourceRoot":"","sources":["../../../src/modules/workspace/ripgrep-search.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,cAAc,EAOpB,MAAM,+BAA+B,CAAC;AAIvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,4BAA4B;IAC3C,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAyCD,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+D;IACvF,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,GAAE,4BAAiC;IAa7C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAiBrG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;;;;;OAMG;YACW,IAAI;IAkDlB,yFAAyF;IACzF,OAAO,CAAC,KAAK;CAcd"}