ushman-characterize 0.4.0

package/dist/capture.d.ts

@@ -0,0 +1,97 @@
+import { type PuppeteerHarness } from './puppeteer-harness.ts';
+import { type TraceDrainPayload } from './tracer-runtime.ts';
+import type { CaptureServerHost, SceneInspectorDriver } from './types.ts';
+export type CapturedTraceRecord = {
+    readonly args: unknown;
+    readonly bindingName: string;
+    readonly className: null | string;
+    readonly count: number;
+    readonly expected: unknown;
+    readonly functionName: string;
+    readonly memberKind: 'function' | 'method';
+    readonly methodName: null | string;
+    readonly sideEffects: readonly unknown[];
+    readonly state: string;
+    readonly thisArg: unknown;
+    readonly threw: unknown;
+};
+export type CaptureStateResult = {
+    readonly dedupeLimitReached: boolean;
+    readonly droppedUniqueCalls: number;
+    readonly functionCount: number;
+    readonly mergedExistingRecords: number;
+    readonly rawCalls: number;
+    readonly skippedExistingRecords: number;
+    readonly state: string;
+    readonly traceBytes: number;
+    readonly uniqueCalls: number;
+};
+export type CaptureStateFailure = {
+    readonly error: string;
+    readonly phase: 'capture' | 'existing-traces';
+    readonly successfulStatesBeforeFailure: readonly string[];
+    readonly state: string;
+};
+export type CaptureCharacterizationOptions = {
+    readonly bundlePath?: null | string;
+    readonly captureSideEffects?: boolean;
+    readonly harnessFactory?: (options: {
+        readonly headless?: boolean;
+    }) => PuppeteerHarness;
+    readonly maxUniqueRecordsPerState?: number;
+    readonly maxTraceBytes?: number;
+    readonly mode?: 'dev' | 'preview';
+    readonly perFunctionCap?: number;
+    readonly sceneInspectorDriver?: SceneInspectorDriver;
+    readonly sceneOnly?: boolean;
+    readonly serverHost?: CaptureServerHost;
+    readonly states?: readonly string[];
+    readonly workspaceRoot: string;
+};
+export type CaptureCharacterizationResult = {
+    readonly attemptedStates: readonly string[];
+    readonly completedStates: readonly string[];
+    readonly failures: readonly CaptureStateFailure[];
+    readonly requestedStates: readonly string[];
+    readonly skippedStates: readonly string[];
+    readonly status: 'partial' | 'success';
+    readonly states: readonly CaptureStateResult[];
+    readonly traceDir: string;
+};
+type MutableTraceState = {
+    dedupeLimitReached: boolean;
+    droppedUniqueCalls: number;
+    readonly functionNames: Set<string>;
+    mergedExistingRecords: number;
+    rawCalls: number;
+    readonly recordsByKey: Map<string, CapturedTraceRecord>;
+    readonly recordBytesByKey: Map<string, number>;
+    skippedExistingRecords: number;
+    readonly state: string;
+    traceBytes: number;
+    uniqueCalls: number;
+};
+/**
+ * Capture instrumented call traces for the requested workspace states.
+ */
+export declare const captureCharacterization: ({ bundlePath, captureSideEffects, harnessFactory, maxTraceBytes, mode, maxUniqueRecordsPerState, perFunctionCap, sceneInspectorDriver, sceneOnly, serverHost, states, workspaceRoot, }: CaptureCharacterizationOptions) => Promise<CaptureCharacterizationResult>;
+export declare const readCapturedTraceState: ({ stateId, workspaceRoot, }: {
+    readonly stateId: string;
+    readonly workspaceRoot: string;
+}) => Promise<CapturedTraceRecord[]>;
+export declare const __testOnly: {
+    buildRecordKey: (record: Omit<CapturedTraceRecord, "count" | "state">) => string;
+    mergeDrainPayload: ({ disableTracer, maxUniqueRecordsPerState, maxTraceBytes, payload, state, }: {
+        readonly disableTracer: () => Promise<void>;
+        readonly maxUniqueRecordsPerState?: number;
+        readonly maxTraceBytes: number;
+        readonly payload: TraceDrainPayload;
+        readonly state: MutableTraceState;
+    }) => Promise<void>;
+    resolveServedBundlePath: ({ bundlePath, workspaceRoot, }: {
+        readonly bundlePath: string;
+        readonly workspaceRoot: string;
+    }) => string;
+};
+export {};
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"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"}