@ait-co/devtools 0.1.144 → 0.2.0

package/dist/runtime-kn9DxOeg.d.ts

@@ -1,249 +0,0 @@
-//#region src/test-runner/runtime.d.ts
-/**
- * Thin test runtime for WebView execution.
- *
- * This file is bundled by `bundle.ts` together with the user's test file
- * into a single IIFE injected into the WebView via `Runtime.evaluate`.
- * It MUST stay browser-compatible — no Node.js APIs allowed.
- *
- * Design: rather than shipping @vitest/runner verbatim into a WebView (where
- * its Node-side internals cause issues), this runtime provides a minimal
- * compatible API surface — describe/it/test/expect globals — collects results
- * into a plain JSON-safe object, and exports `runTestModule` as the entry point.
- *
- * @vitest/runner and @vitest/expect are listed as dependencies so that the
- * package's type contracts are available and so the browser-compatible subsets
- * can be referenced. The Vitest custom pool that drives this runtime through
- * Vitest's `PoolRunnerInitializer` lives in `pool.ts`.
- *
- * NOTE: this file is imported by type from Node-side code (rpc.ts / relay-worker.ts)
- * for the RunReport / TestResult type shapes. The runtime ITSELF is not imported
- * at runtime on the Node side — only the types are used.
- */
-/**
- * Result of a single test case.
- * All fields are JSON-serialisable.
- */
-interface TestResult {
-  /** Full dot-joined test name including nested suite names. */
-  name: string;
-  /** `'pass'` or `'fail'`. `'skip'` for skipped tests. */
-  status: 'pass' | 'fail' | 'skip';
-  /** Duration in milliseconds. */
-  duration: number;
-  /** Error message (fail only). Does NOT include the expression/secret. */
-  error?: string;
-  /**
-   * Optional note attached to a skip — populated when the test body itself
-   * calls `ctx.skip(cond, note)` (devtools#746), mirroring the static
-   * `it.skip`/`it.skipIf` path which has no note today. `'skip'` status only.
-   */
-  note?: string;
-  /**
-   * Number of throttle-aware re-executions of the test BODY (devtools#767) —
-   * present only when at least one retry was attempted (`>= 1`); omitted
-   * (never `0`) for every test that never hit `APP_BRIDGE_THROTTLED`, so
-   * existing consumers (sdk-example's diff script) see byte-identical reports
-   * for the common case. A test that eventually PASSES after retrying still
-   * carries this field — it is provenance, not a failure flag.
-   */
-  throttleRetries?: number;
-}
-/** Aggregate report returned by `runTestModule`. */
-interface RunReport {
-  /** ISO timestamp of when `runTestModule` was called. */
-  startedAt: string;
-  /** Total elapsed milliseconds (wall-clock). */
-  duration: number;
-  passed: number;
-  failed: number;
-  skipped: number;
-  tests: TestResult[];
-}
-/**
- * Test-only override surface for `runTestModule`. Never populated by the
- * generated bundle — see that function's doc.
- */
-interface RunTestModuleOptions {
-  /**
-   * Overrides the backoff/pacing sleep implementation. Defaults to a real
-   * `setTimeout`-backed sleep. Unit tests pass a fake (e.g. an
-   * immediately-resolving spy) so retry/pacing tests don't take real
-   * wall-clock seconds.
-   */
-  sleep?: (ms: number) => Promise<void>;
-}
-/**
- * Brand property that tags asymmetric matcher markers (`expect.any(String)`,
- * `expect.objectContaining(...)`, etc). A reserved string key is used as the
- * brand so the guard stays a plain own-property check — markers are only ever
- * compared in-process by reference, so no cross-realm Symbol coordination is
- * needed.
- */
-declare const ASYMMETRIC_BRAND: "$$asymmetricMatch";
-/**
- * An asymmetric matcher: a placeholder that, when found on the `expected` side
- * of a deep comparison, runs its own `asymmetricMatch(actual)` predicate
- * instead of being structurally compared as a plain object. This is what makes
- * `toMatchObject({ hash: expect.any(String) })` match any string `hash`.
- */
-interface AsymmetricMatcher {
-  /** Brand discriminator — present only on asymmetric markers. */
-  [ASYMMETRIC_BRAND]: true;
-  /** Human-readable label used in failure messages. */
-  toString(): string;
-  /** Returns true when `actual` satisfies this matcher. */
-  asymmetricMatch(actual: unknown): boolean;
-}
-/** The widest constructor type TypeScript allows without `any` (see toBeInstanceOf). */
-type AnyCtor = abstract new (...args: never) => unknown;
-/** Minimal expect builder compatible with Vitest's jest-style API. */
-declare class Expectation {
-  #private;
-  constructor(received: unknown);
-  get not(): this;
-  toBe(expected: unknown): void;
-  toEqual(expected: unknown): void;
-  toBeTruthy(): void;
-  toBeFalsy(): void;
-  toBeNull(): void;
-  toBeUndefined(): void;
-  toBeGreaterThan(n: number): void;
-  toBeLessThan(n: number): void;
-  toContain(sub: unknown): void;
-  toThrow(msgFragment?: string): void;
-  toMatchObject(expected: Record<string, unknown>): void;
-  toHaveProperty(dotPath: string, ...rest: unknown[]): void;
-  toBeInstanceOf(ctor: abstract new (...args: never) => unknown): void;
-  toBeTypeOf(typeStr: string): void;
-  toHaveLength(n: number): void;
-}
-/**
- * The `expect` callable plus its asymmetric-matcher static surface
- * (`expect.any`, `expect.objectContaining`, …). The user file accesses these as
- * `expect.any(String)`; the vitest redirect (`bundle.ts`) re-exports `expect` by
- * reading `globalThis.expect`, so attaching the statics to this function object
- * makes them reachable through the getter (a function's own properties survive
- * the getter that returns the function itself).
- */
-interface ExpectStatic {
-  (received: unknown): Expectation;
-  any(ctor: AnyCtor): AsymmetricMatcher;
-  anything(): AsymmetricMatcher;
-  objectContaining(expected: Record<string, unknown>): AsymmetricMatcher;
-  arrayContaining(expected: unknown[]): AsymmetricMatcher;
-  stringContaining(sub: string): AsymmetricMatcher;
-  stringMatching(re: string | RegExp): AsymmetricMatcher;
-}
-/**
- * Minimal vitest-4-compatible task context passed as the first argument to a
- * test function, e.g. `it('...', async (ctx) => { ctx.skip(cond, note); })`.
- *
- * Real vitest's `TestContext` is much larger (`expect`, `onTestFailed`, …) —
- * this shim only implements what sdk-example's device-fixture suites actually
- * use: `ctx.skip` (vitest 4 semantics below) and a trivial `ctx.task.name`.
- */
-interface TestContext {
-  /**
-   * `ctx.skip()` (no args) unconditionally skips the remainder of the test
-   * body. `ctx.skip(cond, note)` skips only when `cond` is truthy; when falsy,
-   * this is a no-op and the body continues normally. Skipping throws an
-   * internal sentinel — do not catch `InPageSkipSentinel` in user code.
-   */
-  skip(condition?: boolean, note?: string): void;
-  /** Trivial task descriptor — nice-to-have, mirrors vitest's `ctx.task.name`. */
-  task: {
-    name: string;
-  };
-}
-/** A test function as the user writes it — 0-arg or 1-arg (vitest task context). */
-type TestFn = (ctx: TestContext) => void | Promise<void>;
-/** Registers a suite scope; calls `fn` synchronously to collect inner tests. */
-declare function describe(name: string, fn: () => void): void;
-declare namespace describe {
-  var skip: (name: string, _fn: () => void) => void;
-  var skipIf: (cond: unknown) => DescribeRegistrar;
-  var runIf: (cond: unknown) => DescribeRegistrar;
-}
-/** Registers a test. */
-declare function it(name: string, fn: TestFn): void;
-declare namespace it {
-  var skip: (name: string, _fn?: TestFn) => void;
-  var skipIf: (cond: unknown) => ItRegistrar;
-  var runIf: (cond: unknown) => ItRegistrar;
-}
-/**
- * `it.skipIf(cond)(name, fn)` / `it.runIf(cond)(name, fn)` — conditional test
- * registration. `skipIf` skips when `cond` is truthy; `runIf` runs only when
- * `cond` is truthy (skips otherwise). sdk-example uses
- * `it.skipIf(cell.platform === 'mock')(...)` to skip real-SDK-only cases in env1.
- */
-type ItRegistrar = (name: string, fn: TestFn) => void;
-/**
- * `describe.skipIf(cond)(name, fn)` / `describe.runIf(cond)(name, fn)`.
- * When skipped, the suite body still runs to register its tests but every test
- * inside is marked skipped (collected via a temporary skip flag is overkill —
- * a skipped describe simply does not invoke its body, mirroring `describe.skip`).
- */
-type DescribeRegistrar = (name: string, fn: () => void) => void;
-declare function beforeAll(fn: () => void | Promise<void>): void;
-declare function afterAll(fn: () => void | Promise<void>): void;
-declare function beforeEach(fn: () => void | Promise<void>): void;
-declare function afterEach(fn: () => void | Promise<void>): void;
-interface SpyCall {
-  args: unknown[];
-  returnValue: unknown;
-}
-interface MockFn<T extends unknown[], R> {
-  (...args: T): R;
-  mock: {
-    calls: SpyCall[];
-  };
-  mockImplementation(fn: (...args: T) => R): this;
-  mockReturnValue(value: R): this;
-  mockRestore(): void;
-}
-/**
- * Runtime globals object — exported for direct use in unit tests so that
- * test factories can reference runtime's own `it`/`expect`/`beforeAll`/etc.
- * without depending on `globalThis` injection.
- *
- * In a real WebView bundle these are accessed via globals installed by
- * `runTestModule`; in Node tests, import from here directly.
- */
-declare const runtimeGlobals: {
-  readonly describe: typeof describe;
-  readonly it: typeof it;
-  readonly test: typeof it;
-  readonly expect: ExpectStatic;
-  readonly beforeAll: typeof beforeAll;
-  readonly afterAll: typeof afterAll;
-  readonly beforeEach: typeof beforeEach;
-  readonly afterEach: typeof afterEach;
-  readonly vi: {
-    /** Creates a spy on `obj[method]`, replacing it with a mock function. */spyOn<T extends Record<string, unknown>, K extends keyof T>(obj: T, method: K): MockFn<unknown[], unknown>; /** Creates a standalone mock function, optionally wrapping `impl`. */
-    fn<T extends unknown[], R>(impl?: (...args: T) => R): MockFn<T, R>; /** Restores all spies created via `vi.spyOn` to their original values. */
-    restoreAllMocks(): void;
-  };
-};
-/**
- * Installs describe/it/test/expect/afterAll/afterEach/beforeAll/beforeEach/vi
- * as globals, invokes `moduleFactory` to register the user's tests, then
- * executes them and returns a RunReport.
- *
- * This function is exported as `__testBundle.runTestModule` by the IIFE wrapper
- * that bundle.ts generates. The Node-side rpc.ts calls it via `Runtime.evaluate`.
- *
- * @param moduleFactory - A zero-argument function that contains the user's
- *   top-level test code (describe/it/test calls). The bundler wraps the entire
- *   test module so that its top-level statements become the body of this factory.
- * @param opts - Test-only overrides (see {@link RunTestModuleOptions}). Never
- *   passed by the generated bundle (`rpc.ts#buildRunTestsExpression` calls
- *   `runTestModule(__userFactory)` with exactly one argument) — this second
- *   parameter exists so unit tests can inject a fake sleep and assert the
- *   THROTTLED-retry timing without real delays.
- */
-declare function runTestModule(moduleFactory?: () => void | Promise<void>, opts?: RunTestModuleOptions): Promise<RunReport>;
-//#endregion
-export { runTestModule as a, TestResult as i, RunTestModuleOptions as n, runtimeGlobals as o, TestContext as r, RunReport as t };
-//# sourceMappingURL=runtime-kn9DxOeg.d.ts.map

package/dist/runtime-kn9DxOeg.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-kn9DxOeg.d.ts","names":[],"sources":["../src/test-runner/runtime.ts"],"mappings":";;AAgCA;;;;;;;;;;;;AA2BA;;;;;;;;;;;;UA3BiB,UAAA;EAwDA;EAtDf,IAAA;;EAEA,MAAA;EA2DA;EAzDA,QAAA;EAyDwB;EAvDxB,KAAA;EAuD+B;AAChC;;;;EAlDC,IAAA;EA8FQ;;;;;;;;EArFR,eAAA;AAAA;AA2F+B;AAAA,UAvFhB,SAAA;;EAEf,SAAA;EAmGkC;EAjGlC,QAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;EACA,KAAA,EAAO,UAAA;AAAA;;;;;UAqBQ,oBAAA;EAwTP;;;;;;EAjTR,KAAA,IAAS,EAAA,aAAe,OAAA;AAAA;;;;;;;;cAqCpB,gBAAA;;;;;;;UAQI,iBAAA;EAiXG;EAAA,CA/WV,gBAAA;EAwXY;EAtXb,QAAA;EAsXsB;EApXtB,eAAA,CAAgB,MAAA;AAAA;;KAcb,OAAA,oBAA2B,IAAA;;cAoN1B,WAAA;EAAA;cAIQ,QAAA;EAAA,IAIR,GAAA,CAAA;EAaJ,IAAA,CAAK,QAAA;EAOL,OAAA,CAAQ,QAAA;EAOR,UAAA,CAAA;EAIA,SAAA,CAAA;EAIA,QAAA,CAAA;EAIA,aAAA,CAAA;EAOA,eAAA,CAAgB,CAAA;EAOhB,YAAA,CAAa,CAAA;EAOb,SAAA,CAAU,GAAA;EAcV,OAAA,CAAQ,WAAA;EAwBR,aAAA,CAAc,QAAA,EAAU,MAAA;EAOxB,cAAA,CAAe,OAAA,aAAoB,IAAA;EAiBnC,cAAA,CAAe,IAAA,mBAAuB,IAAA;EAOtC,UAAA,CAAW,OAAA;EASX,YAAA,CAAa,CAAA;AAAA;;;;;;;;;UAiBL,YAAA;EAAA,CACP,QAAA,YAAoB,WAAA;EACrB,GAAA,CAAI,IAAA,EAAM,OAAA,GAAU,iBAAA;EACpB,QAAA,IAAY,iBAAA;EACZ,gBAAA,CAAiB,QAAA,EAAU,MAAA,oBAA0B,iBAAA;EACrD,eAAA,CAAgB,QAAA,cAAsB,iBAAA;EACtC,gBAAA,CAAiB,GAAA,WAAc,iBAAA;EAC/B,cAAA,CAAe,EAAA,WAAa,MAAA,GAAS,iBAAA;AAAA;;;;;;;;;UAoCtB,WAAA;EA4BN;;;;;;EArBT,IAAA,CAAK,SAAA,YAAqB,IAAA;EAqBsB;EAnBhD,IAAA;IAAQ,IAAA;EAAA;AAAA;;KAmBL,MAAA,IAAU,GAAA,EAAK,WAAA,YAAuB,OAAA;;iBAalC,QAAA,CAAS,IAAA,UAAc,EAAA;AAAA,kBAAvB,QAAA;EAAA,yBAeoB,GAAA;EAAA,+BAgCM,iBAAA;EAAA,8BAED,iBAAA;AAAA;;iBA1CzB,EAAA,CAAG,IAAA,UAAc,EAAA,EAAI,MAAA;AAAA,kBAArB,EAAA;EAAA,yBAWc,GAAA,GAAQ,MAAA;EAAA,+BAiBF,WAAA;EAAA,8BACD,WAAA;AAAA;AAauB;;;;;;AAAA,KApB9C,WAAA,IAAe,IAAA,UAAc,EAAA,EAAI,MAAA;;;AAtBF;;;;KAuC/B,iBAAA,IAAqB,IAAA,UAAc,EAAA;AAAA,iBAuD/B,SAAA,CAAU,EAAA,eAAiB,OAAA;AAAA,iBAG3B,QAAA,CAAS,EAAA,eAAiB,OAAA;AAAA,iBAG1B,UAAA,CAAW,EAAA,eAAiB,OAAA;AAAA,iBAG5B,SAAA,CAAU,EAAA,eAAiB,OAAA;AAAA,UAQ1B,OAAA;EACR,IAAA;EACA,WAAA;AAAA;AAAA,UAGQ,MAAA;EAAA,IACJ,IAAA,EAAM,CAAA,GAAI,CAAA;EACd,IAAA;IAAQ,KAAA,EAAO,OAAA;EAAA;EACf,kBAAA,CAAmB,EAAA,MAAQ,IAAA,EAAM,CAAA,KAAM,CAAA;EACvC,eAAA,CAAgB,KAAA,EAAO,CAAA;EACvB,WAAA;AAAA;;;;;;;;AAnG0C;cAwL/B,cAAA;EAAA;;;;;;;;;IA7GI,yFAiEC,MAAA,mCAAyC,CAAA,EAAC,GAAA,EACnD,CAAA,EAAC,MAAA,EACE,CAAA,GACP,MAAA,sBApEa;+BAoFS,IAAA,OAAa,IAAA,EAAM,CAAA,KAAM,CAAA,GAAI,MAAA,CAAO,CAAA,EAAG,CAAA,GAjFzD;;;;;AAAyC;;;;;AAGD;;;;;AAUpC;;;;;;iBA0HS,aAAA,CACpB,aAAA,gBAA6B,OAAA,QAC7B,IAAA,GAAO,oBAAA,GACN,OAAA,CAAQ,SAAA"}