artarch-feedback-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tool-canvas contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,205 @@
+# artarch-feedback-sdk
+
+Headless browser SDK for collecting feedback with screenshots and screen recordings. The SDK owns browser capture and asset lifecycle; the host application owns authentication, CDN storage, and feedback APIs.
+
+## About ArtArch
+
+[ArtArch](https://www.artarch.ai/) is an AI-native Creative OS for creators and
+brands. It brings together AI-powered content creation, reusable production
+workflows, and leading AI models to help users create, express, grow, and monetize
+their work.
+
+## Purpose and capabilities
+
+The package lets users send the visual context of a problem along with their
+description. Capture and submission are separate operations: creating a screenshot
+or recording returns a local `Blob`; calling `submit()` invokes the host's upload
+and feedback adapters.
+
+| Capability | Current behavior |
+| --- | --- |
+| Screenshot | Captures a frame from a user-selected browser tab, window, or screen as PNG. Optional maximum dimensions preserve the source aspect ratio. |
+| Screen recording | Records the selected surface using `MediaRecorder`, with MIME detection, manual stop, a duration limit, and browser-ended capture handling. |
+| Shared audio | Requests audio from the selected surface with `audio: true`, subject to browser and OS support. This does not request microphone access. |
+| Capture lifecycle | Handles permission denial, cancellation, overlapping starts/stops, final media chunks, and release of tracks and listeners. |
+| Feedback submission | Accepts text alone, text with a screenshot, text with a recording, or both attachments. Uploads finish before the feedback record is submitted. |
+| Business context | Forwards host-provided `context`, such as platform, project ID, route, or node ID, without collecting it automatically. |
+
+Capture requires a secure context (HTTPS or localhost), a user gesture, and the
+browser's permission picker. The available surfaces and audio sources depend on
+the browser and OS. This is real screen capture, not DOM session replay.
+
+## SDK and host responsibilities
+
+The core is framework-independent and has no runtime dependencies on React,
+Next.js, Axios, Sentry, or a cloud storage provider.
+
+| Owner | Responsibilities |
+| --- | --- |
+| SDK | Browser capture, local media files, capture errors and cancellation, and sequencing upload/submission through `FeedbackTransport`. |
+| Host `uploadAsset` adapter | Authentication, upload credentials, storage/CDN selection, and uploading the provided file. Returns `{ url, id? }`. |
+| Host `submitFeedback` adapter | Sending the message, uploaded attachment URLs, and context to a business API. Returns `{ id? }`. |
+| Host application | Feedback button and form, previews, validation, user-facing error messages, context selection, retention, and the feedback management backend. |
+
+A host can build this user flow around the SDK:
+
+```text
+Open feedback form -> Enter description -> Capture screenshot/recording
+-> Preview in the host UI -> Submit -> Upload files -> Save feedback record
+```
+
+`uploadAsset` can target OSS, S3, R2, or any other storage system; `submitFeedback`
+can target an internal API or an adapter to another service. These are extension
+interfaces, not bundled provider integrations. The host also owns cleanup of any
+uploaded files left behind when another upload or the final submission fails.
+
+## Current scope
+
+The current deliverable is the core SDK. It does not include a feedback widget,
+preview UI, screenshot annotation/redaction, video editing, a feedback backend,
+or an administration console. It does not automatically collect console logs,
+network requests, page URLs, or historical session replays.
+
+The npm package name is `artarch-feedback-sdk`; its directory in this repository
+is `packages/feedback-sdk`. The SDK is not yet connected to the production
+`tool-canvas` feedback UI. Update this status when integrating the package.
+
+## Install
+
+```bash
+npm install artarch-feedback-sdk
+# or
+pnpm add artarch-feedback-sdk
+```
+
+For local development, run `npm pack` in this package and install the
+resulting `.tgz` in a consuming project. See the build and test commands below.
+
+## Host-provided transport
+
+```ts
+import { FeedbackClient } from 'artarch-feedback-sdk';
+
+const feedback = new FeedbackClient({
+  async uploadAsset({ asset, signal }) {
+    const ticket = await getUploadTicket({
+      filename: asset.filename,
+      contentType: asset.contentType,
+      signal,
+    });
+
+    const response = await fetch(ticket.uploadUrl, {
+      method: 'PUT',
+      body: asset.blob,
+      headers: { 'Content-Type': asset.contentType },
+      signal,
+    });
+
+    if (!response.ok) throw new Error('Asset upload failed');
+
+    return { url: ticket.cdnUrl, id: ticket.assetId };
+  },
+  submitFeedback(payload, options) {
+    return api.post('/feedback', payload, { signal: options?.signal });
+  },
+});
+```
+
+## Capture and submit
+
+`getDisplayMedia()` must be called from a user gesture. The browser will show its own permission picker every time.
+
+```ts
+const screenshot = await feedback.captureScreenshot({ preferCurrentTab: true });
+
+await feedback.submit({
+  message: '节点预览区域显示不完整',
+  screenshot,
+  context: {
+    platform: 'studio',
+    projectId,
+    route: window.location.href,
+  },
+});
+```
+
+For recording:
+
+```ts
+await feedback.startRecording({ audio: true, maxDurationMs: 60_000 });
+// User clicks stop later.
+const recording = await feedback.stopRecording();
+await feedback.submit({ message, recording });
+```
+
+To handle automatic completion (duration limit or the browser ending sharing),
+await `feedback.recorder.finished` after `startRecording()` resolves. `stop()` and
+`finished` return the same result, retained until the next `start()`. Concurrent
+stop calls include the final media chunk. Starting while permission is pending,
+recording is active, or the result is being finalized rejects with
+`recording-already-started`.
+
+Passing an `AbortSignal` cancels capture and discards the recording; use `stop()`
+to keep it. Cancelling a pending permission prompt cannot close the browser UI,
+but the SDK rejects promptly and releases a stream if permission is granted later.
+Screenshots use the selected source's pixels by default. Optional width/height
+are maximum bounds and preserve its aspect ratio.
+
+Upload and submit errors propagate to the host. The SDK never submits feedback
+after an upload fails or the operation is cancelled. Transport adapters must
+honor `signal` to abort their actual HTTP requests. Cancellation cannot roll back
+an upload or feedback record already accepted by a server; the host owns cleanup.
+
+The package intentionally has no React dependency and no CDN client. `FeedbackTransport` is the integration boundary for a presigned upload API, S3/R2/OSS, Sentry, or an internal feedback service.
+
+## Build and publish
+
+Run inside this package using the npm account authorized to publish it:
+
+```bash
+cd packages/feedback-sdk
+npm run build
+npm pack
+npm publish --access public
+```
+
+## Tests
+
+From the workspace root:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --filter artarch-feedback-sdk exec playwright install chromium
+pnpm --filter artarch-feedback-sdk test:all
+```
+
+Or, after installing this package's development dependencies, run inside this directory:
+
+```bash
+npm test                 # Node tests plus an isolated tarball consumer
+npm run test:browser     # Real Chromium capture and playback
+npm run test:all         # Both suites
+```
+
+- Node tests cover permission failures, cancellation before/during capture,
+  late permission results, first-frame readiness, dimensions, recorder errors,
+  concurrent starts/stops, automatic stops, cleanup, upload ordering and failure.
+- The package test installs the actual npm tarball in a temporary consumer
+  outside the repository and checks native Node ESM imports and NodeNext types.
+- Playwright serves a local fixture on a random port and closes it after testing.
+  It uses native `getDisplayMedia` and `MediaRecorder`, with Chromium test flags
+  selecting/rejecting the fixture tab. Tests decode PNG pixels at desktop and
+  narrow viewport sizes, play and sample changing video frames, and check cleanup.
+  No production accounts, CDN endpoints or feedback services are contacted.
+
+Successful screenshots and recordings are attached under `test-results/`.
+Failed browser tests retain screenshots and traces. Browser binaries are test
+prerequisites; on Linux CI install them with `playwright install --with-deps chromium`.
+`prepublishOnly` runs both suites and `prepack` rebuilds the package.
+
+Automated tests cover Chromium tab capture. They do not physically click the
+browser toolbar's Stop Sharing button: unit tests dispatch the track's `ended`
+event and browser tests terminate the actual stream. Before release, manually
+check that toolbar action, the native picker, window/screen capture, and audio
+sharing on each supported browser/OS. A narrow Chromium viewport is not mobile
+Safari coverage.

package/dist/abort.d.ts

@@ -0,0 +1,4 @@
+export declare function abortError(): DOMException;
+export declare function throwIfAborted(signal?: AbortSignal): void;
+export declare function abortable<T>(pending: Promise<T>, signal?: AbortSignal, releaseLateResult?: (value: T) => void): Promise<T>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAEzD;AAID,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,CAAC,EAAE,WAAW,EACpB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GACrC,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/abort.js

@@ -0,0 +1,35 @@
+export function abortError() {
+    return new DOMException('The operation was aborted.', 'AbortError');
+}
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw abortError();
+}
+// Native capture prompts cannot be dismissed programmatically. Release any
+// stream granted after cancellation, even after the caller has moved on.
+export function abortable(pending, signal, releaseLateResult) {
+    if (!signal)
+        return pending;
+    return new Promise((resolve, reject) => {
+        let cancelled = false;
+        const onAbort = () => {
+            cancelled = true;
+            signal.removeEventListener('abort', onAbort);
+            reject(abortError());
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        if (signal.aborted)
+            onAbort();
+        pending.then(value => {
+            signal.removeEventListener('abort', onAbort);
+            if (cancelled)
+                releaseLateResult?.(value);
+            else
+                resolve(value);
+        }, error => {
+            signal.removeEventListener('abort', onAbort);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=abort.js.map

package/dist/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,UAAU,EAAE,CAAC;AAC1C,CAAC;AAED,2EAA2E;AAC3E,yEAAyE;AACzE,MAAM,UAAU,SAAS,CACvB,OAAmB,EACnB,MAAoB,EACpB,iBAAsC;IAEtC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvB,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;YACnB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,SAAS;gBAAE,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC;;gBACrC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EAAE,KAAK,CAAC,EAAE;YACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/capture.d.ts

@@ -0,0 +1,14 @@
+import type { CapturedAsset, RecordingOptions, ScreenshotOptions } from './types.js';
+export declare function captureScreenshot(options?: ScreenshotOptions): Promise<CapturedAsset>;
+export declare class ScreenRecorder {
+    private phase;
+    private recorder?;
+    private completion?;
+    private requestStop?;
+    start(options?: RecordingOptions): Promise<void>;
+    /** Resolves on manual, duration-limit, or browser stop; rejects on abort/error. */
+    get finished(): Promise<CapturedAsset>;
+    stop(): Promise<CapturedAsset>;
+    get isRecording(): boolean;
+}
+//# 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":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAmDrF,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwC/F;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA4D;IACzE,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,WAAW,CAAC,CAAa;IAE3B,KAAK,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8G1D,mFAAmF;IACnF,IAAI,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAErC;IAED,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAK9B,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF"}

package/dist/capture.js

@@ -0,0 +1,256 @@
+import { abortable, abortError, throwIfAborted } from './abort.js';
+import { FeedbackCaptureError, normalizeCaptureError } from './errors.js';
+const MIME_TYPES = [
+    'video/mp4;codecs=avc1.424028,mp4a.40.2',
+    'video/mp4',
+    'video/webm;codecs=vp9,opus',
+    'video/webm;codecs=vp8,opus',
+    'video/webm',
+];
+function ensureBrowserSupport() {
+    if (typeof navigator === 'undefined' || !navigator.mediaDevices?.getDisplayMedia) {
+        throw new FeedbackCaptureError('unsupported', 'Screen capture is not supported in this browser.');
+    }
+}
+function stopTracks(stream) {
+    stream.getTracks().forEach(track => track.stop());
+}
+function waitForFrame(video, stream, signal) {
+    return new Promise((resolve, reject) => {
+        const track = stream.getVideoTracks()[0];
+        let playing = false;
+        const cleanup = () => {
+            clearTimeout(timer);
+            video.removeEventListener('loadeddata', onFrame);
+            video.removeEventListener('error', onError);
+            track?.removeEventListener('ended', onError);
+            signal?.removeEventListener('abort', onAbort);
+        };
+        const fail = (error) => { cleanup(); reject(error); };
+        const onFrame = () => {
+            if (playing && video.readyState >= 2) {
+                cleanup();
+                resolve();
+            }
+        };
+        const onError = () => fail(new Error('Unable to read a frame from the captured screen.'));
+        const onAbort = () => fail(abortError());
+        const timer = setTimeout(onError, 10000);
+        video.addEventListener('loadeddata', onFrame);
+        video.addEventListener('error', onError);
+        track?.addEventListener('ended', onError);
+        signal?.addEventListener('abort', onAbort, { once: true });
+        if (signal?.aborted) {
+            onAbort();
+            return;
+        }
+        if (!track || track.readyState === 'ended') {
+            onError();
+            return;
+        }
+        try {
+            video.srcObject = stream;
+            video.play().then(() => { playing = true; onFrame(); }, fail);
+        }
+        catch (error) {
+            fail(error);
+        }
+    });
+}
+export async function captureScreenshot(options = {}) {
+    let stream;
+    let video;
+    try {
+        throwIfAborted(options.signal);
+        ensureBrowserSupport();
+        for (const size of [options.width, options.height]) {
+            if (size !== undefined && (!Number.isFinite(size) || size < 1))
+                throw new Error('Screenshot dimensions must be positive.');
+        }
+        stream = await abortable(navigator.mediaDevices.getDisplayMedia({
+            video: true,
+            audio: false,
+            ...{ preferCurrentTab: options.preferCurrentTab ?? true },
+        }), options.signal, stopTracks);
+        throwIfAborted(options.signal);
+        video = document.createElement('video');
+        video.muted = true;
+        video.playsInline = true;
+        await waitForFrame(video, stream, options.signal);
+        const scale = Math.min(1, (options.width ?? video.videoWidth) / video.videoWidth, (options.height ?? video.videoHeight) / video.videoHeight);
+        const width = Math.max(1, Math.round(video.videoWidth * scale));
+        const height = Math.max(1, Math.round(video.videoHeight * scale));
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const context = canvas.getContext('2d');
+        if (!context)
+            throw new Error('Unable to create a screenshot canvas.');
+        context.drawImage(video, 0, 0, width, height);
+        const blob = await abortable(new Promise((resolve, reject) => {
+            canvas.toBlob(value => value ? resolve(value) : reject(new Error('Unable to encode screenshot.')), 'image/png');
+        }), options.signal);
+        throwIfAborted(options.signal);
+        return { kind: 'screenshot', blob, contentType: blob.type, filename: 'screenshot.png', width, height };
+    }
+    catch (error) {
+        throw normalizeCaptureError(error);
+    }
+    finally {
+        if (video) {
+            video.pause();
+            video.srcObject = null;
+        }
+        if (stream)
+            stopTracks(stream);
+    }
+}
+export class ScreenRecorder {
+    constructor() {
+        this.phase = 'idle';
+    }
+    async start(options = {}) {
+        if (this.phase !== 'idle') {
+            throw new FeedbackCaptureError('recording-already-started', 'A recording is already starting, running, or stopping.');
+        }
+        this.phase = 'requesting';
+        this.completion = undefined;
+        let stream;
+        try {
+            throwIfAborted(options.signal);
+            ensureBrowserSupport();
+            if (typeof MediaRecorder === 'undefined')
+                throw new FeedbackCaptureError('unsupported', 'Screen recording is not supported in this browser.');
+            if (options.maxDurationMs !== undefined && (!Number.isFinite(options.maxDurationMs) || options.maxDurationMs <= 0 || options.maxDurationMs > 2147483647)) {
+                throw new Error('Maximum duration must be a positive number within the browser timer limit.');
+            }
+            const mimeType = options.mimeType && MediaRecorder.isTypeSupported(options.mimeType)
+                ? options.mimeType : MIME_TYPES.find(type => MediaRecorder.isTypeSupported(type));
+            stream = await abortable(navigator.mediaDevices.getDisplayMedia({
+                video: options.video ?? true,
+                audio: options.audio ?? false,
+            }), options.signal, stopTracks);
+            throwIfAborted(options.signal);
+            const track = stream.getVideoTracks()[0];
+            if (!track || track.readyState === 'ended')
+                throw new Error('No live screen video track was returned.');
+            const recorder = new MediaRecorder(stream, {
+                ...(mimeType ? { mimeType } : {}),
+                ...(options.videoBitsPerSecond ? { videoBitsPerSecond: options.videoBitsPerSecond } : {}),
+                ...(options.audioBitsPerSecond ? { audioBitsPerSecond: options.audioBitsPerSecond } : {}),
+            });
+            this.recorder = recorder;
+            const capturedStream = stream;
+            const chunks = [];
+            const startedAt = Date.now();
+            let stoppedAt;
+            let settled = false;
+            let timer;
+            let fail;
+            this.completion = new Promise((resolve, reject) => {
+                const cleanup = () => {
+                    clearTimeout(timer);
+                    recorder.removeEventListener('dataavailable', onData);
+                    recorder.removeEventListener('stop', onStop);
+                    recorder.removeEventListener('error', onError);
+                    track.removeEventListener('ended', stop);
+                    options.signal?.removeEventListener('abort', onAbort);
+                    stopTracks(capturedStream);
+                    this.recorder = undefined;
+                    this.requestStop = undefined;
+                    this.phase = 'idle';
+                };
+                fail = error => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (recorder.state !== 'inactive') {
+                        try {
+                            recorder.stop();
+                        }
+                        catch { /* Track cleanup still releases capture. */ }
+                    }
+                    cleanup();
+                    chunks.length = 0;
+                    reject(normalizeCaptureError(error));
+                };
+                const onData = (event) => { if (event.data.size > 0)
+                    chunks.push(event.data); };
+                const onStop = () => {
+                    if (settled)
+                        return;
+                    const contentType = recorder.mimeType || chunks[0]?.type || 'video/webm';
+                    const blob = new Blob(chunks, { type: contentType });
+                    if (!blob.size) {
+                        fail(new Error('The recording produced no data.'));
+                        return;
+                    }
+                    const { width, height } = track.getSettings();
+                    settled = true;
+                    cleanup();
+                    chunks.length = 0;
+                    resolve({ kind: 'recording', blob, contentType,
+                        filename: contentType.includes('mp4') ? 'recording.mp4' : 'recording.webm',
+                        durationMs: (stoppedAt ?? Date.now()) - startedAt, width, height });
+                };
+                const onError = (event) => fail(event.error ?? event);
+                const onAbort = () => fail(abortError());
+                const stop = () => {
+                    if (settled || this.phase === 'stopping')
+                        return;
+                    this.phase = 'stopping';
+                    stoppedAt = Date.now();
+                    clearTimeout(timer);
+                    try {
+                        // An inactive recorder may still be dispatching its final data event.
+                        // Only the stop event resolves the result, including for concurrent stops.
+                        if (recorder.state !== 'inactive')
+                            recorder.stop();
+                    }
+                    catch (error) {
+                        fail(error);
+                    }
+                };
+                this.requestStop = stop;
+                recorder.addEventListener('dataavailable', onData);
+                recorder.addEventListener('stop', onStop);
+                recorder.addEventListener('error', onError);
+                track.addEventListener('ended', stop);
+                options.signal?.addEventListener('abort', onAbort, { once: true });
+                if (options.maxDurationMs)
+                    timer = setTimeout(stop, options.maxDurationMs);
+            });
+            // Keep automatic failures observable via finished/stop without an unhandled
+            // rejection when the host only requests the result after recording ends.
+            void this.completion.catch(() => { });
+            try {
+                recorder.start(1000);
+                this.phase = 'recording';
+            }
+            catch (error) {
+                fail(error);
+                throw error;
+            }
+        }
+        catch (error) {
+            if (stream)
+                stopTracks(stream);
+            this.recorder = undefined;
+            this.requestStop = undefined;
+            this.phase = 'idle';
+            throw normalizeCaptureError(error);
+        }
+    }
+    /** Resolves on manual, duration-limit, or browser stop; rejects on abort/error. */
+    get finished() {
+        return this.completion ?? Promise.reject(new FeedbackCaptureError('recording-not-started', 'There is no screen recording result.'));
+    }
+    stop() {
+        this.requestStop?.();
+        return this.finished;
+    }
+    get isRecording() {
+        return this.phase === 'recording' && this.recorder?.state === 'recording';
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,14 @@
+import { ScreenRecorder } from './capture.js';
+import type { CapturedAsset, FeedbackSubmission, FeedbackTransport, RecordingOptions, ScreenshotOptions } from './types.js';
+export declare class FeedbackClient {
+    private readonly transport;
+    readonly recorder: ScreenRecorder;
+    constructor(transport: FeedbackTransport);
+    captureScreenshot(options?: ScreenshotOptions): Promise<CapturedAsset>;
+    startRecording(options?: RecordingOptions): Promise<void>;
+    stopRecording(): Promise<CapturedAsset>;
+    submit(input: FeedbackSubmission): Promise<{
+        id?: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,QAAQ,CAAC,QAAQ,iBAAwB;gBAEZ,SAAS,EAAE,iBAAiB;IAEzD,iBAAiB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAItE,cAAc,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAIjC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAiBlE"}

package/dist/client.js

@@ -0,0 +1,28 @@
+import { captureScreenshot, ScreenRecorder } from './capture.js';
+import { abortable, throwIfAborted } from './abort.js';
+export class FeedbackClient {
+    constructor(transport) {
+        this.transport = transport;
+        this.recorder = new ScreenRecorder();
+    }
+    captureScreenshot(options) {
+        return captureScreenshot(options);
+    }
+    startRecording(options) {
+        return this.recorder.start(options);
+    }
+    stopRecording() {
+        return this.recorder.stop();
+    }
+    async submit(input) {
+        throwIfAborted(input.signal);
+        const assets = [input.screenshot, input.recording].filter((asset) => Boolean(asset));
+        const uploaded = await abortable(Promise.all(assets.map(async (asset) => ({
+            kind: asset.kind,
+            ...(await this.transport.uploadAsset({ asset, signal: input.signal })),
+        }))), input.signal);
+        throwIfAborted(input.signal);
+        return abortable(this.transport.submitFeedback({ message: input.message, assets: uploaded, context: input.context }, { signal: input.signal }), input.signal);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASvD,MAAM,OAAO,cAAc;IAGzB,YAA6B,SAA4B;QAA5B,cAAS,GAAT,SAAS,CAAmB;QAFhD,aAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IAEmB,CAAC;IAE7D,iBAAiB,CAAC,OAA2B;QAC3C,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,cAAc,CAAC,OAA0B;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAyB;QACpC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CACvD,CAAC,KAAK,EAA0B,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAClD,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,CAC1C,MAAM,CAAC,GAAG,CAAC,KAAK,EAAC,KAAK,EAAC,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;SACvE,CAAC,CAAC,CACJ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACjB,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAC5C,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EACpE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CACzB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export type FeedbackCaptureErrorCode = 'unsupported' | 'permission-denied' | 'cancelled' | 'capture-failed' | 'recording-not-started' | 'recording-already-started';
+export declare class FeedbackCaptureError extends Error {
+    readonly code: FeedbackCaptureErrorCode;
+    readonly cause?: unknown;
+    constructor(code: FeedbackCaptureErrorCode, message: string, cause?: unknown);
+}
+export declare function normalizeCaptureError(error: unknown): FeedbackCaptureError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,aAAa,GACb,mBAAmB,GACnB,WAAW,GACX,gBAAgB,GAChB,uBAAuB,GACvB,2BAA2B,CAAC;AAEhC,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAa1E"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+export class FeedbackCaptureError extends Error {
+    constructor(code, message, cause) {
+        super(message);
+        this.name = 'FeedbackCaptureError';
+        this.code = code;
+        this.cause = cause;
+    }
+}
+export function normalizeCaptureError(error) {
+    if (error instanceof FeedbackCaptureError)
+        return error;
+    if (typeof DOMException !== 'undefined' && error instanceof DOMException) {
+        if (error.name === 'NotAllowedError' || error.name === 'PermissionDeniedError') {
+            return new FeedbackCaptureError('permission-denied', 'Screen capture permission was denied.', error);
+        }
+        if (error.name === 'AbortError') {
+            return new FeedbackCaptureError('cancelled', 'Screen capture was cancelled.', error);
+        }
+    }
+    return new FeedbackCaptureError('capture-failed', 'Screen capture failed.', error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAI7C,YAAY,IAA8B,EAAE,OAAe,EAAE,KAAe;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,YAAY,oBAAoB;QAAE,OAAO,KAAK,CAAC;IAExD,IAAI,OAAO,YAAY,KAAK,WAAW,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QACzE,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAC/E,OAAO,IAAI,oBAAoB,CAAC,mBAAmB,EAAE,uCAAuC,EAAE,KAAK,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,OAAO,IAAI,oBAAoB,CAAC,WAAW,EAAE,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,OAAO,IAAI,oBAAoB,CAAC,gBAAgB,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC;AACrF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { FeedbackCaptureError } from './errors.js';
+export type { FeedbackCaptureErrorCode } from './errors.js';
+export { captureScreenshot, ScreenRecorder } from './capture.js';
+export { FeedbackClient } from './client.js';
+export type { CaptureKind, CapturedAsset, FeedbackPayload, FeedbackSubmission, FeedbackTransport, RecordingOptions, ScreenshotOptions, UploadAssetInput, UploadedAsset, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { FeedbackCaptureError } from './errors.js';
+export { captureScreenshot, ScreenRecorder } from './capture.js';
+export { FeedbackClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+export type CaptureKind = 'screenshot' | 'recording';
+export interface CapturedAsset {
+    kind: CaptureKind;
+    blob: Blob;
+    contentType: string;
+    filename: string;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+}
+export interface UploadedAsset {
+    url: string;
+    id?: string;
+}
+export interface UploadAssetInput {
+    asset: CapturedAsset;
+    signal?: AbortSignal;
+}
+export interface FeedbackPayload {
+    message: string;
+    assets: Array<{
+        kind: CaptureKind;
+        url: string;
+        id?: string;
+    }>;
+    context?: Record<string, unknown>;
+}
+export interface FeedbackTransport {
+    uploadAsset(input: UploadAssetInput): Promise<UploadedAsset>;
+    submitFeedback(payload: FeedbackPayload, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        id?: string;
+    }>;
+}
+export interface ScreenshotOptions {
+    /** Maximum output size. Defaults to captured pixels; aspect ratio is preserved. */
+    width?: number;
+    height?: number;
+    /** Prefer the current browser tab in Chromium's picker when supported. */
+    preferCurrentTab?: boolean;
+    signal?: AbortSignal;
+}
+export interface RecordingOptions {
+    audio?: boolean;
+    video?: MediaTrackConstraints;
+    mimeType?: string;
+    videoBitsPerSecond?: number;
+    audioBitsPerSecond?: number;
+    /** Stops the recorder automatically after this duration. */
+    maxDurationMs?: number;
+    /** Cancels capture and discards the recording. Use stop() to keep the video. */
+    signal?: AbortSignal;
+}
+export interface FeedbackSubmission {
+    message: string;
+    screenshot?: CapturedAsset;
+    recording?: CapturedAsset;
+    context?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,WAAW,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7D,cAAc,CACZ,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "artarch-feedback-sdk",
+  "version": "0.1.0",
+  "description": "Headless browser feedback capture SDK for screenshots and screen recordings.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "npm run build && node --test --test-timeout=15000 tests/*.test.mjs",
+    "test:browser": "npm run build && playwright test",
+    "test:all": "npm test && npm run test:browser",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run test:all"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.63.0",
+    "typescript": "5.8.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}