@venizia/dev-configs 0.4.7-0 → 0.4.7-1

package/dist/linters/house/promise-chain-support.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromiseChainSupport = void 0;
+const common_1 = require("./common");
+const CHAIN_METHODS = new Set(['then', 'catch', 'finally']);
+/** Wrappers that leave the value of the expression they hold unchanged: `x!`, `x as T`, `x satisfies T`, `<T>x`, `a?.b`. */
+const VALUE_WRAPPERS = new Set([
+    'TSAsExpression',
+    'TSSatisfiesExpression',
+    'TSNonNullExpression',
+    'TSTypeAssertion',
+    'ChainExpression',
+]);
+const CONSTANT_UNARY_OPERATORS = new Set(['-', '+', '!', 'void']);
+/** The shared parts of the promise chain rules: what a chain call is, what a constant is, what a silent handler body is. */
+class PromiseChainSupport {
+    /** `node` without the wrappers that do not change its value (`!`, `as`, `satisfies`, `<T>`, an optional chain). */
+    static unwrap(opts) {
+        let current = opts.node;
+        while (VALUE_WRAPPERS.has(common_1.AstNode.getType({ node: current }) ?? '')) {
+            current = common_1.AstNode.readField({ node: current, key: 'expression' });
+        }
+        return current;
+    }
+    /** The name a member access reads: `a.name`, `a['name']`, ``a[`name`]``; `undefined` for a computed key. */
+    static memberName(opts) {
+        const { member } = opts;
+        const property = common_1.AstNode.readField({ node: member, key: 'property' });
+        if (common_1.AstNode.readField({ node: member, key: 'computed' }) !== true) {
+            const name = common_1.AstNode.readField({ node: property, key: 'name' });
+            return typeof name === 'string' ? name : undefined;
+        }
+        if (common_1.AstNode.getType({ node: property }) === 'Literal') {
+            const value = common_1.AstNode.readField({ node: property, key: 'value' });
+            return typeof value === 'string' ? value : undefined;
+        }
+        const expressions = common_1.AstNode.readField({ node: property, key: 'expressions' });
+        const quasis = common_1.AstNode.readField({ node: property, key: 'quasis' });
+        if (common_1.AstNode.getType({ node: property }) === 'TemplateLiteral' &&
+            Array.isArray(expressions) &&
+            expressions.length === 0 &&
+            Array.isArray(quasis)) {
+            const cooked = common_1.AstNode.readField({
+                node: common_1.AstNode.readField({ node: quasis[0], key: 'value' }),
+                key: 'cooked',
+            });
+            return typeof cooked === 'string' ? cooked : undefined;
+        }
+        return undefined;
+    }
+    /**
+     * `then`, `catch` or `finally` when `node` (after `unwrap`) is a call of that method - `p.then(f)`, `p?.catch(f)`,
+     * `p['finally'](f)` - and `undefined` for anything else. It reads the syntax only, so a thenable counts too.
+     */
+    static chainMethodOf(opts) {
+        const call = PromiseChainSupport.unwrap({ node: opts.node });
+        if (common_1.AstNode.getType({ node: call }) !== 'CallExpression') {
+            return undefined;
+        }
+        const callee = PromiseChainSupport.unwrap({
+            node: common_1.AstNode.readField({ node: call, key: 'callee' }),
+        });
+        if (common_1.AstNode.getType({ node: callee }) !== 'MemberExpression') {
+            return undefined;
+        }
+        const name = PromiseChainSupport.memberName({ member: callee });
+        return name !== undefined && CHAIN_METHODS.has(name) ? name : undefined;
+    }
+    /**
+     * Whether a chain call (`.then`, `.catch`, `.finally`) sits anywhere on the spine of `node`: the receivers and
+     * callees a call chain is built from (`a.then(f).limit(1)` has one, `a.where(x).limit(1)` has none).
+     */
+    static hasChainOnSpine(opts) {
+        let current = PromiseChainSupport.unwrap({ node: opts.node });
+        for (;;) {
+            const type = common_1.AstNode.getType({ node: current });
+            if (type === 'CallExpression') {
+                if (PromiseChainSupport.chainMethodOf({ node: current }) !== undefined) {
+                    return true;
+                }
+                current = PromiseChainSupport.unwrap({
+                    node: common_1.AstNode.readField({ node: current, key: 'callee' }),
+                });
+                continue;
+            }
+            if (type === 'MemberExpression') {
+                current = PromiseChainSupport.unwrap({
+                    node: common_1.AstNode.readField({ node: current, key: 'object' }),
+                });
+                continue;
+            }
+            return false;
+        }
+    }
+    /**
+     * A value that is the same every time and reads nothing: a literal, `undefined`, a template with no `${}`, `-1`,
+     * `void 0`, and an array or object literal built only from those (`[]`, `{}`, `{ items: [] }`).
+     */
+    static isConstant(opts) {
+        const node = PromiseChainSupport.unwrapTypes({ node: opts.node });
+        const type = common_1.AstNode.getType({ node }) ?? '';
+        const constant = (child) => PromiseChainSupport.isConstant({ node: child });
+        switch (type) {
+            case 'Literal': {
+                return true;
+            }
+            case 'Identifier': {
+                return common_1.AstNode.readField({ node, key: 'name' }) === 'undefined';
+            }
+            case 'TemplateLiteral': {
+                const expressions = common_1.AstNode.readField({ node, key: 'expressions' });
+                return Array.isArray(expressions) && expressions.length === 0;
+            }
+            case 'UnaryExpression': {
+                return (CONSTANT_UNARY_OPERATORS.has(String(common_1.AstNode.readField({ node, key: 'operator' }))) &&
+                    constant(common_1.AstNode.readField({ node, key: 'argument' })));
+            }
+            case 'ArrayExpression': {
+                const elements = common_1.AstNode.readField({ node, key: 'elements' });
+                return (Array.isArray(elements) &&
+                    elements.every((element) => element === null || constant(element)));
+            }
+            case 'ObjectExpression': {
+                const properties = common_1.AstNode.readField({ node, key: 'properties' });
+                return (Array.isArray(properties) &&
+                    properties.every((property) => common_1.AstNode.getType({ node: property }) === 'Property' &&
+                        common_1.AstNode.readField({ node: property, key: 'computed' }) !== true &&
+                        common_1.AstNode.readField({ node: property, key: 'method' }) !== true &&
+                        common_1.AstNode.readField({ node: property, key: 'kind' }) === 'init' &&
+                        constant(common_1.AstNode.readField({ node: property, key: 'value' }))));
+            }
+            default: {
+                return false;
+            }
+        }
+    }
+    /**
+     * Whether the statements of a handler or a `catch` block leave no trace of the error: none at all (a comment does
+     * not count), or only `return;`, `return <constant>;` and `<name or member> = <constant>;`. Anything else - a
+     * call, a `throw`, a read of a variable - is a decision someone made, and counts as handled.
+     */
+    static isSilentBlock(opts) {
+        const { statements } = opts;
+        return (Array.isArray(statements) &&
+            statements.every((statement) => {
+                const type = common_1.AstNode.getType({ node: statement });
+                if (type === 'EmptyStatement') {
+                    return true;
+                }
+                if (type === 'ReturnStatement') {
+                    const argument = common_1.AstNode.readField({ node: statement, key: 'argument' });
+                    return argument === null || PromiseChainSupport.isConstant({ node: argument });
+                }
+                const expression = common_1.AstNode.readField({ node: statement, key: 'expression' });
+                return (type === 'ExpressionStatement' &&
+                    common_1.AstNode.getType({ node: expression }) === 'AssignmentExpression' &&
+                    common_1.AstNode.readField({ node: expression, key: 'operator' }) === '=' &&
+                    PromiseChainSupport.isPlainTarget({
+                        node: common_1.AstNode.readField({ node: expression, key: 'left' }),
+                    }) &&
+                    PromiseChainSupport.isConstant({
+                        node: common_1.AstNode.readField({ node: expression, key: 'right' }),
+                    }));
+            }));
+    }
+    /** `name`, `this.name`, `a.b.c`: an assignment target that reads no computed key and calls nothing. */
+    static isPlainTarget(opts) {
+        const { node } = opts;
+        const type = common_1.AstNode.getType({ node });
+        if (type === 'Identifier' || type === 'ThisExpression') {
+            return true;
+        }
+        return (type === 'MemberExpression' &&
+            common_1.AstNode.readField({ node, key: 'computed' }) !== true &&
+            PromiseChainSupport.isPlainTarget({ node: common_1.AstNode.readField({ node, key: 'object' }) }));
+    }
+    /** `node` without the type-only wrappers (`as`, `satisfies`, `!`, `<T>`), keeping an optional chain. */
+    static unwrapTypes(opts) {
+        let current = opts.node;
+        while (VALUE_WRAPPERS.has(common_1.AstNode.getType({ node: current }) ?? '') &&
+            common_1.AstNode.getType({ node: current }) !== 'ChainExpression') {
+            current = common_1.AstNode.readField({ node: current, key: 'expression' });
+        }
+        return current;
+    }
+}
+exports.PromiseChainSupport = PromiseChainSupport;
+//# sourceMappingURL=promise-chain-support.js.map

package/dist/linters/house/promise-chain-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-chain-support.js","sourceRoot":"","sources":["../../../src/linters/house/promise-chain-support.ts"],"names":[],"mappings":"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","sourcesContent":["import { AstNode } from './common';\n\nconst CHAIN_METHODS = new Set(['then', 'catch', 'finally']);\n/** Wrappers that leave the value of the expression they hold unchanged: `x!`, `x as T`, `x satisfies T`, `<T>x`, `a?.b`. */\nconst VALUE_WRAPPERS = new Set([\n  'TSAsExpression',\n  'TSSatisfiesExpression',\n  'TSNonNullExpression',\n  'TSTypeAssertion',\n  'ChainExpression',\n]);\nconst CONSTANT_UNARY_OPERATORS = new Set(['-', '+', '!', 'void']);\n\n/** The shared parts of the promise chain rules: what a chain call is, what a constant is, what a silent handler body is. */\nexport class PromiseChainSupport {\n  /** `node` without the wrappers that do not change its value (`!`, `as`, `satisfies`, `<T>`, an optional chain). */\n  static unwrap(opts: { node: unknown }): unknown {\n    let current = opts.node;\n\n    while (VALUE_WRAPPERS.has(AstNode.getType({ node: current }) ?? '')) {\n      current = AstNode.readField({ node: current, key: 'expression' });\n    }\n\n    return current;\n  }\n\n  /** The name a member access reads: `a.name`, `a['name']`, ``a[`name`]``; `undefined` for a computed key. */\n  static memberName(opts: { member: unknown }): string | undefined {\n    const { member } = opts;\n    const property = AstNode.readField({ node: member, key: 'property' });\n\n    if (AstNode.readField({ node: member, key: 'computed' }) !== true) {\n      const name = AstNode.readField({ node: property, key: 'name' });\n      return typeof name === 'string' ? name : undefined;\n    }\n\n    if (AstNode.getType({ node: property }) === 'Literal') {\n      const value = AstNode.readField({ node: property, key: 'value' });\n      return typeof value === 'string' ? value : undefined;\n    }\n\n    const expressions = AstNode.readField({ node: property, key: 'expressions' });\n    const quasis = AstNode.readField({ node: property, key: 'quasis' });\n    if (\n      AstNode.getType({ node: property }) === 'TemplateLiteral' &&\n      Array.isArray(expressions) &&\n      expressions.length === 0 &&\n      Array.isArray(quasis)\n    ) {\n      const cooked = AstNode.readField({\n        node: AstNode.readField({ node: quasis[0], key: 'value' }),\n        key: 'cooked',\n      });\n      return typeof cooked === 'string' ? cooked : undefined;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * `then`, `catch` or `finally` when `node` (after `unwrap`) is a call of that method - `p.then(f)`, `p?.catch(f)`,\n   * `p['finally'](f)` - and `undefined` for anything else. It reads the syntax only, so a thenable counts too.\n   */\n  static chainMethodOf(opts: { node: unknown }): string | undefined {\n    const call = PromiseChainSupport.unwrap({ node: opts.node });\n    if (AstNode.getType({ node: call }) !== 'CallExpression') {\n      return undefined;\n    }\n\n    const callee = PromiseChainSupport.unwrap({\n      node: AstNode.readField({ node: call, key: 'callee' }),\n    });\n    if (AstNode.getType({ node: callee }) !== 'MemberExpression') {\n      return undefined;\n    }\n\n    const name = PromiseChainSupport.memberName({ member: callee });\n    return name !== undefined && CHAIN_METHODS.has(name) ? name : undefined;\n  }\n\n  /**\n   * Whether a chain call (`.then`, `.catch`, `.finally`) sits anywhere on the spine of `node`: the receivers and\n   * callees a call chain is built from (`a.then(f).limit(1)` has one, `a.where(x).limit(1)` has none).\n   */\n  static hasChainOnSpine(opts: { node: unknown }): boolean {\n    let current = PromiseChainSupport.unwrap({ node: opts.node });\n\n    for (;;) {\n      const type = AstNode.getType({ node: current });\n\n      if (type === 'CallExpression') {\n        if (PromiseChainSupport.chainMethodOf({ node: current }) !== undefined) {\n          return true;\n        }\n        current = PromiseChainSupport.unwrap({\n          node: AstNode.readField({ node: current, key: 'callee' }),\n        });\n        continue;\n      }\n\n      if (type === 'MemberExpression') {\n        current = PromiseChainSupport.unwrap({\n          node: AstNode.readField({ node: current, key: 'object' }),\n        });\n        continue;\n      }\n\n      return false;\n    }\n  }\n\n  /**\n   * A value that is the same every time and reads nothing: a literal, `undefined`, a template with no `${}`, `-1`,\n   * `void 0`, and an array or object literal built only from those (`[]`, `{}`, `{ items: [] }`).\n   */\n  static isConstant(opts: { node: unknown }): boolean {\n    const node = PromiseChainSupport.unwrapTypes({ node: opts.node });\n    const type = AstNode.getType({ node }) ?? '';\n    const constant = (child: unknown) => PromiseChainSupport.isConstant({ node: child });\n\n    switch (type) {\n      case 'Literal': {\n        return true;\n      }\n      case 'Identifier': {\n        return AstNode.readField({ node, key: 'name' }) === 'undefined';\n      }\n      case 'TemplateLiteral': {\n        const expressions = AstNode.readField({ node, key: 'expressions' });\n        return Array.isArray(expressions) && expressions.length === 0;\n      }\n      case 'UnaryExpression': {\n        return (\n          CONSTANT_UNARY_OPERATORS.has(String(AstNode.readField({ node, key: 'operator' }))) &&\n          constant(AstNode.readField({ node, key: 'argument' }))\n        );\n      }\n      case 'ArrayExpression': {\n        const elements = AstNode.readField({ node, key: 'elements' });\n        return (\n          Array.isArray(elements) &&\n          elements.every((element) => element === null || constant(element))\n        );\n      }\n      case 'ObjectExpression': {\n        const properties = AstNode.readField({ node, key: 'properties' });\n        return (\n          Array.isArray(properties) &&\n          properties.every(\n            (property) =>\n              AstNode.getType({ node: property }) === 'Property' &&\n              AstNode.readField({ node: property, key: 'computed' }) !== true &&\n              AstNode.readField({ node: property, key: 'method' }) !== true &&\n              AstNode.readField({ node: property, key: 'kind' }) === 'init' &&\n              constant(AstNode.readField({ node: property, key: 'value' })),\n          )\n        );\n      }\n      default: {\n        return false;\n      }\n    }\n  }\n\n  /**\n   * Whether the statements of a handler or a `catch` block leave no trace of the error: none at all (a comment does\n   * not count), or only `return;`, `return <constant>;` and `<name or member> = <constant>;`. Anything else - a\n   * call, a `throw`, a read of a variable - is a decision someone made, and counts as handled.\n   */\n  static isSilentBlock(opts: { statements: unknown }): boolean {\n    const { statements } = opts;\n\n    return (\n      Array.isArray(statements) &&\n      statements.every((statement) => {\n        const type = AstNode.getType({ node: statement });\n\n        if (type === 'EmptyStatement') {\n          return true;\n        }\n\n        if (type === 'ReturnStatement') {\n          const argument = AstNode.readField({ node: statement, key: 'argument' });\n          return argument === null || PromiseChainSupport.isConstant({ node: argument });\n        }\n\n        const expression = AstNode.readField({ node: statement, key: 'expression' });\n        return (\n          type === 'ExpressionStatement' &&\n          AstNode.getType({ node: expression }) === 'AssignmentExpression' &&\n          AstNode.readField({ node: expression, key: 'operator' }) === '=' &&\n          PromiseChainSupport.isPlainTarget({\n            node: AstNode.readField({ node: expression, key: 'left' }),\n          }) &&\n          PromiseChainSupport.isConstant({\n            node: AstNode.readField({ node: expression, key: 'right' }),\n          })\n        );\n      })\n    );\n  }\n\n  /** `name`, `this.name`, `a.b.c`: an assignment target that reads no computed key and calls nothing. */\n  static isPlainTarget(opts: { node: unknown }): boolean {\n    const { node } = opts;\n    const type = AstNode.getType({ node });\n\n    if (type === 'Identifier' || type === 'ThisExpression') {\n      return true;\n    }\n\n    return (\n      type === 'MemberExpression' &&\n      AstNode.readField({ node, key: 'computed' }) !== true &&\n      PromiseChainSupport.isPlainTarget({ node: AstNode.readField({ node, key: 'object' }) })\n    );\n  }\n\n  /** `node` without the type-only wrappers (`as`, `satisfies`, `!`, `<T>`), keeping an optional chain. */\n  static unwrapTypes(opts: { node: unknown }): unknown {\n    let current = opts.node;\n\n    while (\n      VALUE_WRAPPERS.has(AstNode.getType({ node: current }) ?? '') &&\n      AstNode.getType({ node: current }) !== 'ChainExpression'\n    ) {\n      current = AstNode.readField({ node: current, key: 'expression' });\n    }\n\n    return current;\n  }\n}\n"]}

package/dist/linters/rules/no-restricted-properties.rule.js

@@ -12,7 +12,7 @@ class NoRestrictedPropertiesRule {
     static { this.SECURE_CONTEXT = [
         {
             property: 'randomUUID',
-            message: 'crypto.randomUUID exists only in a secure context (https, localhost) - on a plain-http origin it is undefined. Use uuidV4 from @venizia/ignis-helpers/uuid.',
+            message: 'crypto.randomUUID exists only in a secure context (https, localhost) - on a plain-http origin it is undefined. Use UuidV4Generator.generate() from @venizia/ignis-helpers/uuid.',
         },
     ]; }
     static build(opts = {}) {

package/dist/linters/rules/no-restricted-properties.rule.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-restricted-properties.rule.js","sourceRoot":"","sources":["../../../src/linters/rules/no-restricted-properties.rule.ts"],"names":[],"mappings":";;;AASA;;;;;GAKG;AACH,MAAa,0BAA0B;aACrB,SAAI,GAAG,0BAA0B,CAAC;aAElC,mBAAc,GAAmC;QAC/D;YACE,QAAQ,EAAE,YAAY;YACtB,OAAO,EACL,6JAA6J;SAChK;KACF,CAAC;IAEF,MAAM,CAAC,KAAK,CACV,OAA8E,EAAE;QAEhF,MAAM,EAAE,QAAQ,GAAG,OAAO,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QAC1D,OAAO,CAAC,QAAQ,EAAE,GAAG,0BAA0B,CAAC,cAAc,EAAE,GAAG,eAAe,CAAC,CAAC;IACtF,CAAC;;AAhBH,gEAiBC","sourcesContent":["import type { TOxlintRuleEntry, TRuleSeverity } from './common';\n\n/** One forbidden property access, with the message the author sees. */\nexport interface IRestrictedProperty {\n  property: string;\n  object?: string;\n  message: string;\n}\n\n/**\n * `no-restricted-properties`. The default bans what exists only in a secure context (https,\n * localhost): on a plain-http LAN origin or in a WebView, `crypto.randomUUID` is `undefined` and the\n * first call throws. Catches the call, `globalThis.crypto.randomUUID`, the bracket form and\n * destructuring; leaves `getRandomValues` alone.\n */\nexport class NoRestrictedPropertiesRule {\n  static readonly NAME = 'no-restricted-properties';\n\n  static readonly SECURE_CONTEXT: readonly IRestrictedProperty[] = [\n    {\n      property: 'randomUUID',\n      message:\n        'crypto.randomUUID exists only in a secure context (https, localhost) - on a plain-http origin it is undefined. Use uuidV4 from @venizia/ignis-helpers/uuid.',\n    },\n  ];\n\n  static build(\n    opts: { severity?: TRuleSeverity; extraProperties?: IRestrictedProperty[] } = {},\n  ): TOxlintRuleEntry<'no-restricted-properties'> {\n    const { severity = 'error', extraProperties = [] } = opts;\n    return [severity, ...NoRestrictedPropertiesRule.SECURE_CONTEXT, ...extraProperties];\n  }\n}\n"]}
+{"version":3,"file":"no-restricted-properties.rule.js","sourceRoot":"","sources":["../../../src/linters/rules/no-restricted-properties.rule.ts"],"names":[],"mappings":";;;AASA;;;;;GAKG;AACH,MAAa,0BAA0B;aACrB,SAAI,GAAG,0BAA0B,CAAC;aAElC,mBAAc,GAAmC;QAC/D;YACE,QAAQ,EAAE,YAAY;YACtB,OAAO,EACL,iLAAiL;SACpL;KACF,CAAC;IAEF,MAAM,CAAC,KAAK,CACV,OAA8E,EAAE;QAEhF,MAAM,EAAE,QAAQ,GAAG,OAAO,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QAC1D,OAAO,CAAC,QAAQ,EAAE,GAAG,0BAA0B,CAAC,cAAc,EAAE,GAAG,eAAe,CAAC,CAAC;IACtF,CAAC;;AAhBH,gEAiBC","sourcesContent":["import type { TOxlintRuleEntry, TRuleSeverity } from './common';\n\n/** One forbidden property access, with the message the author sees. */\nexport interface IRestrictedProperty {\n  property: string;\n  object?: string;\n  message: string;\n}\n\n/**\n * `no-restricted-properties`. The default bans what exists only in a secure context (https,\n * localhost): on a plain-http LAN origin or in a WebView, `crypto.randomUUID` is `undefined` and the\n * first call throws. Catches the call, `globalThis.crypto.randomUUID`, the bracket form and\n * destructuring; leaves `getRandomValues` alone.\n */\nexport class NoRestrictedPropertiesRule {\n  static readonly NAME = 'no-restricted-properties';\n\n  static readonly SECURE_CONTEXT: readonly IRestrictedProperty[] = [\n    {\n      property: 'randomUUID',\n      message:\n        'crypto.randomUUID exists only in a secure context (https, localhost) - on a plain-http origin it is undefined. Use UuidV4Generator.generate() from @venizia/ignis-helpers/uuid.',\n    },\n  ];\n\n  static build(\n    opts: { severity?: TRuleSeverity; extraProperties?: IRestrictedProperty[] } = {},\n  ): TOxlintRuleEntry<'no-restricted-properties'> {\n    const { severity = 'error', extraProperties = [] } = opts;\n    return [severity, ...NoRestrictedPropertiesRule.SECURE_CONTEXT, ...extraProperties];\n  }\n}\n"]}

package/dist/testing/rejection.helper.d.ts

@@ -1,21 +1,26 @@
-/**
- * Awaits a task that must reject and returns what it rejected with; throws when the task resolves.
- *
- * bun types the async matchers (`expect(task).rejects` / `.resolves`) as `void`, so
- * `await expect(task).rejects.toThrow()` is refused by `await-thenable` - and left un-awaited the
- * assertion never runs. Awaiting the task itself needs no matcher and no cast:
- * `expectRejection({ task, message })` or `expect(await rejectionOf(task)).toBeInstanceOf(Error)`,
- * and for a resolution `expect(await task).toMatchObject(...)`.
- */
-export declare const rejectionOf: (task: Promise<unknown>) => Promise<unknown>;
-/**
- * The task rejects with an Error whose message contains `message` (a string) or matches it (a
- * RegExp). The message is compared as a string on purpose: bun 1.4.2 `toMatchObject` with an
- * asymmetric matcher overwrites the matched property on the object it checks, so a later read of
- * `error.message` gets the matcher back.
- */
-export declare const expectRejection: (opts: {
-    task: Promise<unknown>;
-    message: string | RegExp;
-}) => Promise<void>;
+export declare class RejectionHelper {
+    /**
+     * Awaits a task that must reject and returns what it rejected with; throws when the task resolves.
+     *
+     * bun types the async matchers (`expect(task).rejects` / `.resolves`) as `void`, so
+     * `await expect(task).rejects.toThrow()` is refused by `await-thenable` - and left un-awaited the
+     * assertion never runs. Awaiting the task itself needs no matcher and no cast:
+     * `RejectionHelper.expectRejection({ task, message })` or
+     * `expect(await RejectionHelper.rejectionOf({ task })).toBeInstanceOf(Error)`,
+     * and for a resolution `expect(await task).toMatchObject(...)`.
+     */
+    static rejectionOf(opts: {
+        task: Promise<unknown>;
+    }): Promise<unknown>;
+    /**
+     * The task rejects with an Error whose message contains `message` (a string) or matches it (a
+     * RegExp). The message is compared as a string on purpose: bun 1.4.2 `toMatchObject` with an
+     * asymmetric matcher overwrites the matched property on the object it checks, so a later read of
+     * `error.message` gets the matcher back.
+     */
+    static expectRejection(opts: {
+        task: Promise<unknown>;
+        message: string | RegExp;
+    }): Promise<void>;
+}
 //# sourceMappingURL=rejection.helper.d.ts.map

package/dist/testing/rejection.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rejection.helper.d.ts","sourceRoot":"","sources":["../../src/testing/rejection.helper.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAU,MAAM,OAAO,CAAC,OAAO,CAAC,KAAG,OAAO,CAAC,OAAO,CAQzE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,MAAM;IAC1C,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B,KAAG,OAAO,CAAC,IAAI,CAMf,CAAC"}
+{"version":3,"file":"rejection.helper.d.ts","sourceRoot":"","sources":["../../src/testing/rejection.helper.ts"],"names":[],"mappings":"AAEA,qBAAa,eAAe;IAC1B;;;;;;;;;OASG;WACU,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5E;;;;;OAKG;WACU,eAAe,CAAC,IAAI,EAAE;QACjC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;CAOlB"}

package/dist/testing/rejection.helper.js

@@ -1,37 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expectRejection = exports.rejectionOf = void 0;
+exports.RejectionHelper = void 0;
 const bun_test_1 = require("bun:test");
-/**
- * Awaits a task that must reject and returns what it rejected with; throws when the task resolves.
- *
- * bun types the async matchers (`expect(task).rejects` / `.resolves`) as `void`, so
- * `await expect(task).rejects.toThrow()` is refused by `await-thenable` - and left un-awaited the
- * assertion never runs. Awaiting the task itself needs no matcher and no cast:
- * `expectRejection({ task, message })` or `expect(await rejectionOf(task)).toBeInstanceOf(Error)`,
- * and for a resolution `expect(await task).toMatchObject(...)`.
- */
-const rejectionOf = async (task) => {
-    try {
-        await task;
+class RejectionHelper {
+    /**
+     * Awaits a task that must reject and returns what it rejected with; throws when the task resolves.
+     *
+     * bun types the async matchers (`expect(task).rejects` / `.resolves`) as `void`, so
+     * `await expect(task).rejects.toThrow()` is refused by `await-thenable` - and left un-awaited the
+     * assertion never runs. Awaiting the task itself needs no matcher and no cast:
+     * `RejectionHelper.expectRejection({ task, message })` or
+     * `expect(await RejectionHelper.rejectionOf({ task })).toBeInstanceOf(Error)`,
+     * and for a resolution `expect(await task).toMatchObject(...)`.
+     */
+    static async rejectionOf(opts) {
+        try {
+            await opts.task;
+        }
+        catch (error) {
+            return error;
+        }
+        return bun_test_1.expect.unreachable('Expected the task to reject, but it resolved');
     }
-    catch (error) {
-        return error;
+    /**
+     * The task rejects with an Error whose message contains `message` (a string) or matches it (a
+     * RegExp). The message is compared as a string on purpose: bun 1.4.2 `toMatchObject` with an
+     * asymmetric matcher overwrites the matched property on the object it checks, so a later read of
+     * `error.message` gets the matcher back.
+     */
+    static async expectRejection(opts) {
+        const { task, message } = opts;
+        const reason = await RejectionHelper.rejectionOf({ task });
+        (0, bun_test_1.expect)(reason).toBeInstanceOf(Error);
+        (0, bun_test_1.expect)(reason instanceof Error ? reason.message : String(reason)).toMatch(message);
     }
-    return bun_test_1.expect.unreachable('Expected the task to reject, but it resolved');
-};
-exports.rejectionOf = rejectionOf;
-/**
- * The task rejects with an Error whose message contains `message` (a string) or matches it (a
- * RegExp). The message is compared as a string on purpose: bun 1.4.2 `toMatchObject` with an
- * asymmetric matcher overwrites the matched property on the object it checks, so a later read of
- * `error.message` gets the matcher back.
- */
-const expectRejection = async (opts) => {
-    const { task, message } = opts;
-    const reason = await (0, exports.rejectionOf)(task);
-    (0, bun_test_1.expect)(reason).toBeInstanceOf(Error);
-    (0, bun_test_1.expect)(reason instanceof Error ? reason.message : String(reason)).toMatch(message);
-};
-exports.expectRejection = expectRejection;
+}
+exports.RejectionHelper = RejectionHelper;
 //# sourceMappingURL=rejection.helper.js.map

package/dist/testing/rejection.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"rejection.helper.js","sourceRoot":"","sources":["../../src/testing/rejection.helper.ts"],"names":[],"mappings":";;;AAAA,uCAAkC;AAElC;;;;;;;;GAQG;AACI,MAAM,WAAW,GAAG,KAAK,EAAE,IAAsB,EAAoB,EAAE;IAC5E,IAAI,CAAC;QACH,MAAM,IAAI,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,iBAAM,CAAC,WAAW,CAAC,8CAA8C,CAAC,CAAC;AAC5E,CAAC,CAAC;AARW,QAAA,WAAW,eAQtB;AAEF;;;;;GAKG;AACI,MAAM,eAAe,GAAG,KAAK,EAAE,IAGrC,EAAiB,EAAE;IAClB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAW,EAAC,IAAI,CAAC,CAAC;IAEvC,IAAA,iBAAM,EAAC,MAAM,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,IAAA,iBAAM,EAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACrF,CAAC,CAAC;AATW,QAAA,eAAe,mBAS1B","sourcesContent":["import { expect } from 'bun:test';\n\n/**\n * Awaits a task that must reject and returns what it rejected with; throws when the task resolves.\n *\n * bun types the async matchers (`expect(task).rejects` / `.resolves`) as `void`, so\n * `await expect(task).rejects.toThrow()` is refused by `await-thenable` - and left un-awaited the\n * assertion never runs. Awaiting the task itself needs no matcher and no cast:\n * `expectRejection({ task, message })` or `expect(await rejectionOf(task)).toBeInstanceOf(Error)`,\n * and for a resolution `expect(await task).toMatchObject(...)`.\n */\nexport const rejectionOf = async (task: Promise<unknown>): Promise<unknown> => {\n  try {\n    await task;\n  } catch (error) {\n    return error;\n  }\n\n  return expect.unreachable('Expected the task to reject, but it resolved');\n};\n\n/**\n * The task rejects with an Error whose message contains `message` (a string) or matches it (a\n * RegExp). The message is compared as a string on purpose: bun 1.4.2 `toMatchObject` with an\n * asymmetric matcher overwrites the matched property on the object it checks, so a later read of\n * `error.message` gets the matcher back.\n */\nexport const expectRejection = async (opts: {\n  task: Promise<unknown>;\n  message: string | RegExp;\n}): Promise<void> => {\n  const { task, message } = opts;\n  const reason = await rejectionOf(task);\n\n  expect(reason).toBeInstanceOf(Error);\n  expect(reason instanceof Error ? reason.message : String(reason)).toMatch(message);\n};\n"]}
+{"version":3,"file":"rejection.helper.js","sourceRoot":"","sources":["../../src/testing/rejection.helper.ts"],"names":[],"mappings":";;;AAAA,uCAAkC;AAElC,MAAa,eAAe;IAC1B;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAgC;QACvD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,iBAAM,CAAC,WAAW,CAAC,8CAA8C,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,IAG5B;QACC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,IAAA,iBAAM,EAAC,MAAM,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACrC,IAAA,iBAAM,EAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrF,CAAC;CACF;AArCD,0CAqCC","sourcesContent":["import { expect } from 'bun:test';\n\nexport class RejectionHelper {\n  /**\n   * Awaits a task that must reject and returns what it rejected with; throws when the task resolves.\n   *\n   * bun types the async matchers (`expect(task).rejects` / `.resolves`) as `void`, so\n   * `await expect(task).rejects.toThrow()` is refused by `await-thenable` - and left un-awaited the\n   * assertion never runs. Awaiting the task itself needs no matcher and no cast:\n   * `RejectionHelper.expectRejection({ task, message })` or\n   * `expect(await RejectionHelper.rejectionOf({ task })).toBeInstanceOf(Error)`,\n   * and for a resolution `expect(await task).toMatchObject(...)`.\n   */\n  static async rejectionOf(opts: { task: Promise<unknown> }): Promise<unknown> {\n    try {\n      await opts.task;\n    } catch (error) {\n      return error;\n    }\n\n    return expect.unreachable('Expected the task to reject, but it resolved');\n  }\n\n  /**\n   * The task rejects with an Error whose message contains `message` (a string) or matches it (a\n   * RegExp). The message is compared as a string on purpose: bun 1.4.2 `toMatchObject` with an\n   * asymmetric matcher overwrites the matched property on the object it checks, so a later read of\n   * `error.message` gets the matcher back.\n   */\n  static async expectRejection(opts: {\n    task: Promise<unknown>;\n    message: string | RegExp;\n  }): Promise<void> {\n    const { task, message } = opts;\n    const reason = await RejectionHelper.rejectionOf({ task });\n\n    expect(reason).toBeInstanceOf(Error);\n    expect(reason instanceof Error ? reason.message : String(reason)).toMatch(message);\n  }\n}\n"]}

package/dist/testing/repo-tmp.d.ts

@@ -1,12 +1,22 @@
 /** The folder under the repository root that holds a test run's temp folders. */
 export declare const REPO_TMP_DIRECTORY: string;
-/** The nearest ancestor of `start` that holds a `.git` (folder or file); `start` itself when there is none. */
-export declare const findRepositoryRoot: (start?: string) => string;
-/**
- * Points TMPDIR at the repository's test folder unless it is already inside it (make's value, or a
- * private folder a caller made there), and returns the folder now in force. Idempotent.
- */
-export declare const useRepoTmp: (opts?: {
-    root?: string;
-}) => string;
+export declare class RepoTmp {
+    /** The nearest ancestor of `start` that holds a `.git` (folder or file); `start` itself when there is none. */
+    static findRoot(opts?: {
+        start?: string;
+    }): string;
+    /**
+     * `Bun.spawn` and `Bun.spawnSync` hand a child the environment the process started with, not the one
+     * it has now, so a TMPDIR set here would never reach it. Wrapped to default to the current one; an
+     * `env` a caller passes wins. `spawn(cmd, options)` and `spawn({ cmd, ...options })` are both handled.
+     */
+    private static withCurrentEnv;
+    /**
+     * Points TMPDIR at the repository's test folder unless it is already inside it (make's value, or a
+     * private folder a caller made there), and returns the folder now in force. Idempotent.
+     */
+    static apply(opts?: {
+        root?: string;
+    }): string;
+}
 //# sourceMappingURL=repo-tmp.d.ts.map

package/dist/testing/repo-tmp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-tmp.d.ts","sourceRoot":"","sources":["../../src/testing/repo-tmp.ts"],"names":[],"mappings":"AAWA,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAE3E,+GAA+G;AAC/G,eAAO,MAAM,kBAAkB,GAAI,QAAO,MAAsB,KAAG,MAelE,CAAC;AAwBF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,KAAG,MAkBzD,CAAC"}
+{"version":3,"file":"repo-tmp.d.ts","sourceRoot":"","sources":["../../src/testing/repo-tmp.ts"],"names":[],"mappings":"AAWA,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAI3E,qBAAa,OAAO;IAClB,+GAA+G;IAC/G,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;IAkBtD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAe7B;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;CAqBnD"}

package/dist/testing/repo-tmp.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useRepoTmp = exports.findRepositoryRoot = exports.REPO_TMP_DIRECTORY = void 0;
+exports.RepoTmp = exports.REPO_TMP_DIRECTORY = void 0;
 /**
  * Where a test makes its temp folders: `.agents/local/tmp/tests` of the repository, never the system
  * temp. `make test` sets TMPDIR to a folder like it; this does the same for a run without make - a
@@ -13,55 +13,57 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 /** The folder under the repository root that holds a test run's temp folders. */
 exports.REPO_TMP_DIRECTORY = (0, node_path_1.join)('.agents', 'local', 'tmp', 'tests');
-/** The nearest ancestor of `start` that holds a `.git` (folder or file); `start` itself when there is none. */
-const findRepositoryRoot = (start = process.cwd()) => {
-    let current = (0, node_path_1.resolve)(start);
-    for (;;) {
-        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(current, '.git'))) {
-            return current;
-        }
-        const parent = (0, node_path_1.dirname)(current);
-        if (parent === current) {
-            return (0, node_path_1.resolve)(start);
+class RepoTmp {
+    /** The nearest ancestor of `start` that holds a `.git` (folder or file); `start` itself when there is none. */
+    static findRoot(opts = {}) {
+        const { start = process.cwd() } = opts;
+        let current = (0, node_path_1.resolve)(start);
+        for (;;) {
+            if ((0, node_fs_1.existsSync)((0, node_path_1.join)(current, '.git'))) {
+                return current;
+            }
+            const parent = (0, node_path_1.dirname)(current);
+            if (parent === current) {
+                return (0, node_path_1.resolve)(start);
+            }
+            current = parent;
         }
-        current = parent;
     }
-};
-exports.findRepositoryRoot = findRepositoryRoot;
-/**
- * `Bun.spawn` and `Bun.spawnSync` hand a child the environment the process started with, not the one
- * it has now, so a TMPDIR set here would never reach it. Wrapped to default to the current one; an
- * `env` a caller passes wins. `spawn(cmd, options)` and `spawn({ cmd, ...options })` are both handled.
- */
-const withCurrentEnv = (spawn) => {
-    return (...args) => {
-        const [first, second] = args;
-        const options = Array.isArray(first) ? second : first;
-        if (options?.env !== undefined) {
-            return spawn(...args);
+    /**
+     * `Bun.spawn` and `Bun.spawnSync` hand a child the environment the process started with, not the one
+     * it has now, so a TMPDIR set here would never reach it. Wrapped to default to the current one; an
+     * `env` a caller passes wins. `spawn(cmd, options)` and `spawn({ cmd, ...options })` are both handled.
+     */
+    static withCurrentEnv(spawn) {
+        return (...args) => {
+            const [first, second] = args;
+            const options = Array.isArray(first) ? second : first;
+            if (options?.env !== undefined) {
+                return spawn(...args);
+            }
+            return Array.isArray(first)
+                ? spawn(first, { ...second, env: process.env })
+                : spawn({ ...first, env: process.env });
+        };
+    }
+    /**
+     * Points TMPDIR at the repository's test folder unless it is already inside it (make's value, or a
+     * private folder a caller made there), and returns the folder now in force. Idempotent.
+     */
+    static apply(opts = {}) {
+        const root = opts.root ?? RepoTmp.findRoot();
+        const testTmp = (0, node_path_1.join)(root, exports.REPO_TMP_DIRECTORY);
+        const current = process.env.TMPDIR;
+        if (current !== undefined && `${(0, node_path_1.resolve)(current)}${node_path_1.sep}`.startsWith(`${testTmp}${node_path_1.sep}`)) {
+            return current;
         }
-        return Array.isArray(first)
-            ? spawn(first, { ...second, env: process.env })
-            : spawn({ ...first, env: process.env });
-    };
-};
-/**
- * Points TMPDIR at the repository's test folder unless it is already inside it (make's value, or a
- * private folder a caller made there), and returns the folder now in force. Idempotent.
- */
-const useRepoTmp = (opts = {}) => {
-    const root = opts.root ?? (0, exports.findRepositoryRoot)();
-    const testTmp = (0, node_path_1.join)(root, exports.REPO_TMP_DIRECTORY);
-    const current = process.env.TMPDIR;
-    if (current !== undefined && `${(0, node_path_1.resolve)(current)}${node_path_1.sep}`.startsWith(`${testTmp}${node_path_1.sep}`)) {
-        return current;
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(testTmp, '.git'), { recursive: true });
+        process.env.TMPDIR = testTmp;
+        process.env.GIT_CEILING_DIRECTORIES = testTmp;
+        Bun.spawn = RepoTmp.withCurrentEnv(Bun.spawn);
+        Bun.spawnSync = RepoTmp.withCurrentEnv(Bun.spawnSync);
+        return testTmp;
     }
-    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(testTmp, '.git'), { recursive: true });
-    process.env.TMPDIR = testTmp;
-    process.env.GIT_CEILING_DIRECTORIES = testTmp;
-    Bun.spawn = withCurrentEnv(Bun.spawn);
-    Bun.spawnSync = withCurrentEnv(Bun.spawnSync);
-    return testTmp;
-};
-exports.useRepoTmp = useRepoTmp;
+}
+exports.RepoTmp = RepoTmp;
 //# sourceMappingURL=repo-tmp.js.map

package/dist/testing/repo-tmp.js.map

@@ -1 +1 @@
-{"version":3,"file":"repo-tmp.js","sourceRoot":"","sources":["../../src/testing/repo-tmp.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,qCAAgD;AAChD,yCAAwD;AAExD,iFAAiF;AACpE,QAAA,kBAAkB,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAE3E,+GAA+G;AACxG,MAAM,kBAAkB,GAAG,CAAC,QAAgB,OAAO,CAAC,GAAG,EAAE,EAAU,EAAE;IAC1E,IAAI,OAAO,GAAG,IAAA,mBAAO,EAAC,KAAK,CAAC,CAAC;IAE7B,SAAS,CAAC;QACR,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAA,mBAAO,EAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAfW,QAAA,kBAAkB,sBAe7B;AAIF;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE;IAC/C,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE;QACjB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAEtD,IAAK,OAAyC,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;YAClE,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACzB,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,GAAI,MAAiB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;YAC3D,CAAC,CAAC,KAAK,CAAC,EAAE,GAAI,KAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,UAAU,GAAG,CAAC,OAA0B,EAAE,EAAU,EAAE;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,0BAAkB,GAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,0BAAkB,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;IAEnC,IAAI,OAAO,KAAK,SAAS,IAAI,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,eAAG,EAAE,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,eAAG,EAAE,CAAC,EAAE,CAAC;QACxF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,OAAO,CAAC;IAC9C,GAAG,CAAC,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,KAA0B,CAAgC,CAAC;IAC1F,GAAG,CAAC,SAAS,GAAG,cAAc,CAC5B,GAAG,CAAC,SAA8B,CACA,CAAC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAlBW,QAAA,UAAU,cAkBrB","sourcesContent":["/**\n * Where a test makes its temp folders: `.agents/local/tmp/tests` of the repository, never the system\n * temp. `make test` sets TMPDIR to a folder like it; this does the same for a run without make - a\n * bare `bun test` on one file - and is the one place that knows the path.\n *\n * The empty `.git` marker in it stops git and bun's ignore lookup from reading the enclosing\n * repository, so GIT_CEILING_DIRECTORIES is set to the same folder.\n */\nimport { existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join, resolve, sep } from 'node:path';\n\n/** The folder under the repository root that holds a test run's temp folders. */\nexport const REPO_TMP_DIRECTORY = join('.agents', 'local', 'tmp', 'tests');\n\n/** The nearest ancestor of `start` that holds a `.git` (folder or file); `start` itself when there is none. */\nexport const findRepositoryRoot = (start: string = process.cwd()): string => {\n  let current = resolve(start);\n\n  for (;;) {\n    if (existsSync(join(current, '.git'))) {\n      return current;\n    }\n\n    const parent = dirname(current);\n    if (parent === current) {\n      return resolve(start);\n    }\n\n    current = parent;\n  }\n};\n\ntype TSpawn = (...args: unknown[]) => unknown;\n\n/**\n * `Bun.spawn` and `Bun.spawnSync` hand a child the environment the process started with, not the one\n * it has now, so a TMPDIR set here would never reach it. Wrapped to default to the current one; an\n * `env` a caller passes wins. `spawn(cmd, options)` and `spawn({ cmd, ...options })` are both handled.\n */\nconst withCurrentEnv = (spawn: TSpawn): TSpawn => {\n  return (...args) => {\n    const [first, second] = args;\n    const options = Array.isArray(first) ? second : first;\n\n    if ((options as { env?: unknown } | undefined)?.env !== undefined) {\n      return spawn(...args);\n    }\n\n    return Array.isArray(first)\n      ? spawn(first, { ...(second as object), env: process.env })\n      : spawn({ ...(first as object), env: process.env });\n  };\n};\n\n/**\n * Points TMPDIR at the repository's test folder unless it is already inside it (make's value, or a\n * private folder a caller made there), and returns the folder now in force. Idempotent.\n */\nexport const useRepoTmp = (opts: { root?: string } = {}): string => {\n  const root = opts.root ?? findRepositoryRoot();\n  const testTmp = join(root, REPO_TMP_DIRECTORY);\n  const current = process.env.TMPDIR;\n\n  if (current !== undefined && `${resolve(current)}${sep}`.startsWith(`${testTmp}${sep}`)) {\n    return current;\n  }\n\n  mkdirSync(join(testTmp, '.git'), { recursive: true });\n  process.env.TMPDIR = testTmp;\n  process.env.GIT_CEILING_DIRECTORIES = testTmp;\n  Bun.spawn = withCurrentEnv(Bun.spawn as unknown as TSpawn) as unknown as typeof Bun.spawn;\n  Bun.spawnSync = withCurrentEnv(\n    Bun.spawnSync as unknown as TSpawn,\n  ) as unknown as typeof Bun.spawnSync;\n\n  return testTmp;\n};\n"]}
+{"version":3,"file":"repo-tmp.js","sourceRoot":"","sources":["../../src/testing/repo-tmp.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,qCAAgD;AAChD,yCAAwD;AAExD,iFAAiF;AACpE,QAAA,kBAAkB,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAI3E,MAAa,OAAO;IAClB,+GAA+G;IAC/G,MAAM,CAAC,QAAQ,CAAC,OAA2B,EAAE;QAC3C,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QACvC,IAAI,OAAO,GAAG,IAAA,mBAAO,EAAC,KAAK,CAAC,CAAC;QAE7B,SAAS,CAAC;YACR,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;gBACtC,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,MAAM,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,CAAC;YAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,OAAO,IAAA,mBAAO,EAAC,KAAK,CAAC,CAAC;YACxB,CAAC;YAED,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,cAAc,CAAC,KAAa;QACzC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE;YACjB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;YAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YAEtD,IAAK,OAAyC,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;gBAClE,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YACxB,CAAC;YAED,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACzB,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,GAAI,MAAiB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC3D,CAAC,CAAC,KAAK,CAAC,EAAE,GAAI,KAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,OAA0B,EAAE;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,0BAAkB,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QAEnC,IAAI,OAAO,KAAK,SAAS,IAAI,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,eAAG,EAAE,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,eAAG,EAAE,CAAC,EAAE,CAAC;YACxF,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,OAAO,CAAC;QAC9C,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,cAAc,CAChC,GAAG,CAAC,KAA0B,CACA,CAAC;QACjC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,cAAc,CACpC,GAAG,CAAC,SAA8B,CACA,CAAC;QAErC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAjED,0BAiEC","sourcesContent":["/**\n * Where a test makes its temp folders: `.agents/local/tmp/tests` of the repository, never the system\n * temp. `make test` sets TMPDIR to a folder like it; this does the same for a run without make - a\n * bare `bun test` on one file - and is the one place that knows the path.\n *\n * The empty `.git` marker in it stops git and bun's ignore lookup from reading the enclosing\n * repository, so GIT_CEILING_DIRECTORIES is set to the same folder.\n */\nimport { existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join, resolve, sep } from 'node:path';\n\n/** The folder under the repository root that holds a test run's temp folders. */\nexport const REPO_TMP_DIRECTORY = join('.agents', 'local', 'tmp', 'tests');\n\ntype TSpawn = (...args: unknown[]) => unknown;\n\nexport class RepoTmp {\n  /** The nearest ancestor of `start` that holds a `.git` (folder or file); `start` itself when there is none. */\n  static findRoot(opts: { start?: string } = {}): string {\n    const { start = process.cwd() } = opts;\n    let current = resolve(start);\n\n    for (;;) {\n      if (existsSync(join(current, '.git'))) {\n        return current;\n      }\n\n      const parent = dirname(current);\n      if (parent === current) {\n        return resolve(start);\n      }\n\n      current = parent;\n    }\n  }\n\n  /**\n   * `Bun.spawn` and `Bun.spawnSync` hand a child the environment the process started with, not the one\n   * it has now, so a TMPDIR set here would never reach it. Wrapped to default to the current one; an\n   * `env` a caller passes wins. `spawn(cmd, options)` and `spawn({ cmd, ...options })` are both handled.\n   */\n  private static withCurrentEnv(spawn: TSpawn): TSpawn {\n    return (...args) => {\n      const [first, second] = args;\n      const options = Array.isArray(first) ? second : first;\n\n      if ((options as { env?: unknown } | undefined)?.env !== undefined) {\n        return spawn(...args);\n      }\n\n      return Array.isArray(first)\n        ? spawn(first, { ...(second as object), env: process.env })\n        : spawn({ ...(first as object), env: process.env });\n    };\n  }\n\n  /**\n   * Points TMPDIR at the repository's test folder unless it is already inside it (make's value, or a\n   * private folder a caller made there), and returns the folder now in force. Idempotent.\n   */\n  static apply(opts: { root?: string } = {}): string {\n    const root = opts.root ?? RepoTmp.findRoot();\n    const testTmp = join(root, REPO_TMP_DIRECTORY);\n    const current = process.env.TMPDIR;\n\n    if (current !== undefined && `${resolve(current)}${sep}`.startsWith(`${testTmp}${sep}`)) {\n      return current;\n    }\n\n    mkdirSync(join(testTmp, '.git'), { recursive: true });\n    process.env.TMPDIR = testTmp;\n    process.env.GIT_CEILING_DIRECTORIES = testTmp;\n    Bun.spawn = RepoTmp.withCurrentEnv(\n      Bun.spawn as unknown as TSpawn,\n    ) as unknown as typeof Bun.spawn;\n    Bun.spawnSync = RepoTmp.withCurrentEnv(\n      Bun.spawnSync as unknown as TSpawn,\n    ) as unknown as typeof Bun.spawnSync;\n\n    return testTmp;\n  }\n}\n"]}

package/dist/testing/spawn.helper.d.ts

@@ -1,13 +1,15 @@
 /** Long enough for a cold `bun build` under a loaded parallel run; it bounds a stall, not a slow run. */
 export declare const SPAWN_TIMEOUT_MS = 120000;
-/**
- * `Bun.spawnSync`, bounded. A sync spawn blocks the worker thread, so bun's own test timeout cannot
- * fire while it waits: the `timeout` option is the only bound. Its default signal, SIGTERM, can be
- * outlived by a stuck child - one such child once stalled a whole suite for 770s - so this kills with
- * SIGKILL, and throws naming the command instead of returning a half-finished result.
- */
-export declare const spawnSyncBounded: <const In extends Bun.SpawnOptions.Writable = "ignore", const Out extends Bun.SpawnOptions.Readable = "pipe", const Err extends Bun.SpawnOptions.Readable = "pipe">(opts: Bun.SpawnOptions.SpawnSyncOptions<In, Out, Err> & {
-    cmd: string[];
-    onExit?: undefined;
-}) => Bun.SyncSubprocess<Out, Err>;
+export declare class SpawnHelper {
+    /**
+     * `Bun.spawnSync`, bounded. A sync spawn blocks the worker thread, so bun's own test timeout cannot
+     * fire while it waits: the `timeout` option is the only bound. Its default signal, SIGTERM, can be
+     * outlived by a stuck child - one such child once stalled a whole suite for 770s - so this kills with
+     * SIGKILL, and throws naming the command instead of returning a half-finished result.
+     */
+    static spawnSyncBounded<const In extends Bun.SpawnOptions.Writable = 'ignore', const Out extends Bun.SpawnOptions.Readable = 'pipe', const Err extends Bun.SpawnOptions.Readable = 'pipe'>(opts: Bun.SpawnOptions.SpawnSyncOptions<In, Out, Err> & {
+        cmd: string[];
+        onExit?: undefined;
+    }): Bun.SyncSubprocess<Out, Err>;
+}
 //# sourceMappingURL=spawn.helper.d.ts.map