@predicatelabs/sdk 0.99.9

package/dist/expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../src/expect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAMjD,qBAAa,WAAW;IAEpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,aAAa;IAG3B,WAAW,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBtD,OAAO,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlD,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB3E,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBjF;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,GAAG,WAAW,CAEtF"}

package/dist/expect.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Expect/Assert functionality
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Expectation = void 0;
+exports.expect = expect;
+const wait_1 = require("./wait");
+const query_1 = require("./query");
+const snapshot_1 = require("./snapshot");
+const selector_utils_1 = require("./utils/selector-utils");
+class Expectation {
+    constructor(browser, selector) {
+        this.browser = browser;
+        this.selector = selector;
+    }
+    async toBeVisible(timeout = 10000) {
+        const result = await (0, wait_1.waitFor)(this.browser, this.selector, timeout);
+        if (!result.found) {
+            throw new Error(`Element not found: ${(0, selector_utils_1.selectorToString)(this.selector)} (timeout: ${timeout}ms)`);
+        }
+        const element = result.element;
+        if (!element.in_viewport) {
+            throw new Error(`Element found but not visible in viewport: ${(0, selector_utils_1.selectorToString)(this.selector)}`);
+        }
+        return element;
+    }
+    async toExist(timeout = 10000) {
+        const result = await (0, wait_1.waitFor)(this.browser, this.selector, timeout);
+        if (!result.found) {
+            throw new Error(`Element does not exist: ${(0, selector_utils_1.selectorToString)(this.selector)} (timeout: ${timeout}ms)`);
+        }
+        return result.element;
+    }
+    async toHaveText(expectedText, timeout = 10000) {
+        const result = await (0, wait_1.waitFor)(this.browser, this.selector, timeout);
+        if (!result.found) {
+            throw new Error(`Element not found: ${(0, selector_utils_1.selectorToString)(this.selector)} (timeout: ${timeout}ms)`);
+        }
+        const element = result.element;
+        if (!element.text || !element.text.includes(expectedText)) {
+            throw new Error(`Element text mismatch. Expected '${expectedText}', got '${element.text}'`);
+        }
+        return element;
+    }
+    async toHaveCount(expectedCount, timeout = 10000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const snap = await (0, snapshot_1.snapshot)(this.browser);
+            const matches = (0, query_1.query)(snap, this.selector);
+            if (matches.length === expectedCount) {
+                return;
+            }
+            await new Promise(resolve => setTimeout(resolve, 250));
+        }
+        // Final check
+        const snap = await (0, snapshot_1.snapshot)(this.browser);
+        const matches = (0, query_1.query)(snap, this.selector);
+        const actualCount = matches.length;
+        throw new Error(`Element count mismatch. Expected ${expectedCount}, got ${actualCount}`);
+    }
+}
+exports.Expectation = Expectation;
+function expect(browser, selector) {
+    return new Expectation(browser, selector);
+}
+//# sourceMappingURL=expect.js.map

package/dist/expect.js.map

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

package/dist/failure-artifacts.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Optional logger interface for SDK users
+ */
+export interface SentienceLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export type PersistMode = 'onFail' | 'always';
+export type ClipMode = 'off' | 'auto' | 'on';
+export interface ClipOptions {
+    /**
+     * Clip generation mode:
+     * - "off": Never generate clips
+     * - "auto": Generate only if ffmpeg is available on PATH (default)
+     * - "on": Always attempt to generate (will warn if ffmpeg missing)
+     */
+    mode?: ClipMode;
+    /** Frames per second for the generated video (default: 8) */
+    fps?: number;
+    /** Duration of clip in seconds. If undefined, uses bufferSeconds */
+    seconds?: number;
+}
+export interface FailureArtifactsOptions {
+    bufferSeconds?: number;
+    captureOnAction?: boolean;
+    fps?: number;
+    persistMode?: PersistMode;
+    outputDir?: string;
+    onBeforePersist?: ((ctx: RedactionContext) => RedactionResult) | null;
+    redactSnapshotValues?: boolean;
+    clip?: ClipOptions;
+}
+export interface RedactionContext {
+    runId: string;
+    reason: string | null;
+    status: 'failure' | 'success';
+    snapshot: any;
+    diagnostics: any;
+    framePaths: string[];
+    metadata: Record<string, any>;
+}
+export interface RedactionResult {
+    snapshot?: any;
+    diagnostics?: any;
+    framePaths?: string[];
+    dropFrames?: boolean;
+}
+export declare class FailureArtifactBuffer {
+    private runId;
+    private options;
+    private frames;
+    private steps;
+    private persisted;
+    private timeNow;
+    private tempDir;
+    private framesDir;
+    constructor(runId: string, options?: FailureArtifactsOptions, timeNow?: () => number);
+    getOptions(): Required<FailureArtifactsOptions>;
+    recordStep(action: string, stepId: string | null, stepIndex: number, url?: string): void;
+    addFrame(image: Buffer, fmt?: 'jpeg' | 'png'): Promise<void>;
+    frameCount(): number;
+    private prune;
+    persist(reason: string | null, status: 'failure' | 'success', snapshot?: any, diagnostics?: any, metadata?: Record<string, any>): Promise<string | null>;
+    cleanup(): Promise<void>;
+    /**
+     * Upload persisted artifacts to cloud storage.
+     *
+     * This method uploads all artifacts from a persisted directory to cloud storage
+     * using presigned URLs from the gateway. It follows the same pattern as trace
+     * screenshot uploads.
+     *
+     * @param apiKey - Sentience API key for authentication
+     * @param apiUrl - Sentience API base URL (default: https://api.sentienceapi.com)
+     * @param persistedDir - Path to persisted artifacts directory. If undefined, uses the
+     *                       most recent persist() output directory.
+     * @param logger - Optional logger for progress/error messages
+     * @returns artifact_index_key on success, null on failure
+     *
+     * @example
+     * const buf = new FailureArtifactBuffer('run-123', options);
+     * await buf.addFrame(screenshotBytes);
+     * const runDir = await buf.persist('assertion failed', 'failure');
+     * const artifactKey = await buf.uploadToCloud('sk-...');
+     * // artifactKey can be passed to /v1/traces/complete
+     */
+    uploadToCloud(apiKey: string, apiUrl?: string, persistedDir?: string, logger?: SentienceLogger): Promise<string | null>;
+    private collectArtifactsForUpload;
+    private requestArtifactUrls;
+    private uploadArtifacts;
+    private uploadSingleArtifact;
+    private uploadArtifactIndex;
+    private completeArtifacts;
+}
+//# sourceMappingURL=failure-artifacts.d.ts.map

package/dist/failure-artifacts.d.ts.map

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