uxinspect 0.2.0 → 0.11.0

package/dist/storage-audit.js

@@ -0,0 +1,263 @@
+const LARGE_KEY_BYTES = 1024 * 1024;
+const QUOTA_WARN_PCT = 80;
+const MAX_IDB_DATABASES = 10;
+const MAX_IDB_OBJECTS_PER_STORE = 100;
+const SAMPLE_CHARS = 120;
+const PII_RE = /"?(email|ssn|credit_?card|cvv)"?\s*:\s*"[^"]+"/i;
+const JWT_KEY_RE = /token|jwt|auth|session|access/i;
+const JWT_VALUE_RE = /^eyJ[A-Za-z0-9_\-]+\.[A-Za-z0-9_\-]+\.[A-Za-z0-9_\-]+$/;
+const SECRET_RE = /sk_live_|AKIA|AIza/;
+function makeSample(value) {
+    return value.length > SAMPLE_CHARS ? value.slice(0, SAMPLE_CHARS) : value;
+}
+function addIssue(bucket, kind, key, detail) {
+    bucket.push({ kind, key, detail });
+}
+function evaluateKeyValue(entry, issues) {
+    if (entry.storage === 'localStorage' &&
+        entry.sizeBytes > LARGE_KEY_BYTES) {
+        const mb = (entry.sizeBytes / (1024 * 1024)).toFixed(2);
+        addIssue(issues, 'large-key', entry.key, `localStorage key "${entry.key}" is ${mb} MB`);
+    }
+    if (PII_RE.test(entry.value)) {
+        addIssue(issues, 'pii-pattern', entry.key, `${entry.storage} key "${entry.key}" contains PII-like field (email/ssn/credit_card/cvv)`);
+    }
+    if (entry.storage === 'localStorage' &&
+        JWT_KEY_RE.test(entry.key) &&
+        JWT_VALUE_RE.test(entry.value.trim())) {
+        addIssue(issues, 'jwt-in-localstorage', entry.key, `JWT-shaped token in localStorage key "${entry.key}"; prefer HttpOnly cookie`);
+    }
+    if (SECRET_RE.test(entry.value)) {
+        addIssue(issues, 'secret-in-storage', entry.key, `${entry.storage} key "${entry.key}" contains a provider-prefixed secret`);
+    }
+}
+function sumKeyValue(entries, target) {
+    let total = 0;
+    for (const e of entries) {
+        if (e.storage === target)
+            total += e.sizeBytes;
+    }
+    return total;
+}
+function sumSized(entries) {
+    let total = 0;
+    for (const e of entries)
+        total += e.sizeBytes;
+    return total;
+}
+async function collectInPage(options) {
+    const keyValue = [];
+    const idb = [];
+    const cache = [];
+    const quota = {};
+    const collectKv = (storage, label) => {
+        for (let i = 0; i < storage.length; i += 1) {
+            const key = storage.key(i);
+            if (key === null)
+                continue;
+            const value = storage.getItem(key) ?? '';
+            const sizeBytes = (key.length + value.length) * 2;
+            keyValue.push({ storage: label, key, value, sizeBytes });
+        }
+    };
+    try {
+        collectKv(window.localStorage, 'localStorage');
+    }
+    catch {
+        // storage may throw SecurityError in sandboxed contexts
+    }
+    try {
+        collectKv(window.sessionStorage, 'sessionStorage');
+    }
+    catch {
+        // ignore
+    }
+    const factory = window.indexedDB;
+    if (factory && typeof factory.databases === 'function') {
+        try {
+            const dbs = await factory.databases();
+            const limited = dbs.slice(0, options.maxDatabases);
+            for (const info of limited) {
+                if (!info.name)
+                    continue;
+                const dbName = info.name;
+                try {
+                    const db = await new Promise((resolve, reject) => {
+                        const req = factory.open(dbName);
+                        req.onsuccess = () => resolve(req.result);
+                        req.onerror = () => reject(req.error);
+                        req.onblocked = () => reject(new Error('blocked'));
+                    });
+                    const storeNames = Array.from(db.objectStoreNames);
+                    for (const storeName of storeNames) {
+                        let tx;
+                        try {
+                            tx = db.transaction(storeName, 'readonly');
+                        }
+                        catch {
+                            continue;
+                        }
+                        const store = tx.objectStore(storeName);
+                        const count = await new Promise((resolve) => {
+                            const req = store.count();
+                            req.onsuccess = () => resolve(req.result);
+                            req.onerror = () => resolve(0);
+                        });
+                        let sampled = 0;
+                        let approxBytes = 0;
+                        await new Promise((resolve) => {
+                            const req = store.openCursor();
+                            req.onsuccess = () => {
+                                const cursor = req.result;
+                                if (!cursor || sampled >= options.maxObjectsPerStore) {
+                                    resolve();
+                                    return;
+                                }
+                                try {
+                                    const serialized = JSON.stringify(cursor.value);
+                                    approxBytes += (serialized?.length ?? 0) * 2;
+                                }
+                                catch {
+                                    // skip unserializable entries
+                                }
+                                sampled += 1;
+                                cursor.continue();
+                            };
+                            req.onerror = () => resolve();
+                        });
+                        const scale = sampled > 0 && count > sampled ? count / sampled : 1;
+                        const estimated = Math.round(approxBytes * scale);
+                        idb.push({
+                            storage: 'indexedDB',
+                            key: `${dbName}/${storeName}`,
+                            sizeBytes: estimated,
+                        });
+                    }
+                    db.close();
+                }
+                catch {
+                    // ignore DB-level failures and continue
+                }
+            }
+        }
+        catch {
+            // indexedDB.databases rejected, skip
+        }
+    }
+    if (typeof caches !== 'undefined') {
+        try {
+            const cacheNames = await caches.keys();
+            for (const cacheName of cacheNames) {
+                try {
+                    const store = await caches.open(cacheName);
+                    const reqs = await store.keys();
+                    let total = 0;
+                    let entryCount = 0;
+                    for (const req of reqs) {
+                        entryCount += 1;
+                        try {
+                            const resp = await store.match(req);
+                            if (!resp)
+                                continue;
+                            const cloned = resp.clone();
+                            const blob = await cloned.blob();
+                            total += blob.size;
+                        }
+                        catch {
+                            // ignore entry-level failures
+                        }
+                    }
+                    cache.push({
+                        storage: 'cacheStorage',
+                        key: `${cacheName} (${entryCount} entries)`,
+                        sizeBytes: total,
+                    });
+                }
+                catch {
+                    // ignore cache-level failures
+                }
+            }
+        }
+        catch {
+            // caches.keys rejected, skip
+        }
+    }
+    if (navigator.storage && typeof navigator.storage.estimate === 'function') {
+        try {
+            const est = await navigator.storage.estimate();
+            if (typeof est.quota === 'number')
+                quota.quotaBytes = est.quota;
+            if (typeof est.usage === 'number')
+                quota.usageBytes = est.usage;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return { keyValue, idb, cache, quota };
+}
+export async function auditStorage(page) {
+    const pageUrl = page.url();
+    const raw = await page.evaluate(collectInPage, {
+        maxDatabases: MAX_IDB_DATABASES,
+        maxObjectsPerStore: MAX_IDB_OBJECTS_PER_STORE,
+    });
+    const entries = [];
+    const issues = [];
+    for (const kv of raw.keyValue) {
+        entries.push({
+            storage: kv.storage,
+            key: kv.key,
+            sizeBytes: kv.sizeBytes,
+            sample: makeSample(kv.value),
+        });
+        evaluateKeyValue(kv, issues);
+    }
+    for (const ix of raw.idb) {
+        entries.push({
+            storage: ix.storage,
+            key: ix.key,
+            sizeBytes: ix.sizeBytes,
+        });
+    }
+    for (const ch of raw.cache) {
+        entries.push({
+            storage: ch.storage,
+            key: ch.key,
+            sizeBytes: ch.sizeBytes,
+        });
+    }
+    const localStorageBytes = sumKeyValue(raw.keyValue, 'localStorage');
+    const sessionStorageBytes = sumKeyValue(raw.keyValue, 'sessionStorage');
+    const indexedDbBytes = sumSized(raw.idb);
+    const cacheStorageBytes = sumSized(raw.cache);
+    const totals = {
+        localStorageBytes,
+        sessionStorageBytes,
+        indexedDbBytes,
+        cacheStorageBytes,
+    };
+    if (typeof raw.quota.quotaBytes === 'number') {
+        totals.quotaBytes = raw.quota.quotaBytes;
+    }
+    if (typeof raw.quota.usageBytes === 'number') {
+        totals.usageBytes = raw.quota.usageBytes;
+    }
+    if (typeof totals.quotaBytes === 'number' &&
+        typeof totals.usageBytes === 'number' &&
+        totals.quotaBytes > 0) {
+        totals.percentUsed = (totals.usageBytes / totals.quotaBytes) * 100;
+        if (totals.percentUsed > QUOTA_WARN_PCT) {
+            addIssue(issues, 'over-quota-warning', 'quota', `Origin uses ${totals.percentUsed.toFixed(1)}% of storage quota (>${QUOTA_WARN_PCT}%)`);
+        }
+    }
+    const passed = issues.length === 0;
+    return {
+        page: pageUrl,
+        entries,
+        totals,
+        issues,
+        passed,
+    };
+}
+//# sourceMappingURL=storage-audit.js.map

package/dist/storage-audit.js.map

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

package/dist/storybook.d.ts

@@ -0,0 +1,48 @@
+import type { BrowserContext } from 'playwright';
+import { type MaskRegion } from './visual-mask.js';
+export interface StoryEntry {
+    id: string;
+    title: string;
+    name: string;
+    kind: string;
+}
+export interface StoryShot {
+    id: string;
+    url: string;
+    title: string;
+    name: string;
+    screenshotPath: string;
+    width: number;
+    height: number;
+    passed: boolean;
+    error?: string;
+}
+export interface StorybookViewport {
+    width: number;
+    height: number;
+    name?: string;
+}
+export interface StorybookRunResult {
+    baseUrl: string;
+    totalStories: number;
+    capturedCount: number;
+    skippedCount: number;
+    shots: StoryShot[];
+    indexFile: string;
+    passed: boolean;
+}
+export declare function listStories(baseUrl: string): Promise<StoryEntry[]>;
+export declare function captureStorybook(opts: {
+    baseUrl: string;
+    context: BrowserContext;
+    outDir: string;
+    include?: (RegExp | string)[];
+    exclude?: (RegExp | string)[];
+    viewports?: StorybookViewport[];
+    maxStories?: number;
+    fullPage?: boolean;
+    waitForSelector?: string;
+    maskRegions?: MaskRegion[];
+    concurrency?: number;
+}): Promise<StorybookRunResult>;
+//# sourceMappingURL=storybook.d.ts.map

package/dist/storybook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook.d.ts","sourceRoot":"","sources":["../src/storybook.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,YAAY,CAAC;AACvD,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAmDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAUxE;AA0HD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgC9B"}

package/dist/storybook.js

@@ -0,0 +1,191 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { applyMaskToPng, resolveMaskRegions } from './visual-mask.js';
+const DEFAULT_MAX_STORIES = 500;
+const DEFAULT_CONCURRENCY = 4;
+const DEFAULT_VIEWPORT = { width: 1280, height: 800 };
+const SETTLE_DELAY_MS = 200;
+const ROOT_SELECTORS = ['#storybook-root', '#root'];
+function trimSlash(input) {
+    return input.endsWith('/') ? input.slice(0, -1) : input;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function asStr(value, fallback) {
+    return typeof value === 'string' && value.length > 0 ? value : fallback;
+}
+async function fetchJson(url) {
+    try {
+        const res = await fetch(url, { headers: { accept: 'application/json' } });
+        if (!res.ok)
+            return null;
+        const json = await res.json();
+        return isRecord(json) ? json : null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseEntries(raw) {
+    const map = raw.entries ?? raw.stories ?? {};
+    const out = [];
+    for (const [key, value] of Object.entries(map)) {
+        if (!isRecord(value))
+            continue;
+        const type = typeof value.type === 'string' ? value.type : 'story';
+        if (type === 'docs')
+            continue;
+        const id = asStr(value.id, key);
+        const title = asStr(value.title, '');
+        if (!id)
+            continue;
+        out.push({ id, title, name: asStr(value.name, ''), kind: asStr(value.kind, title) });
+    }
+    return out;
+}
+export async function listStories(baseUrl) {
+    const base = trimSlash(baseUrl);
+    for (const url of [`${base}/index.json`, `${base}/stories.json`]) {
+        const data = await fetchJson(url);
+        if (data) {
+            const entries = parseEntries(data);
+            if (entries.length > 0)
+                return entries;
+        }
+    }
+    throw new Error(`unable to load story catalog index from ${base}`);
+}
+function compileMatchers(input) {
+    if (!input)
+        return [];
+    return input.map((m) => (m instanceof RegExp ? m : new RegExp(m)));
+}
+function matchesAny(matchers, story) {
+    for (const re of matchers) {
+        if (re.test(story.id) || re.test(story.title))
+            return true;
+    }
+    return false;
+}
+function filterStories(stories, include, exclude) {
+    const inc = compileMatchers(include);
+    const exc = compileMatchers(exclude);
+    return stories.filter((s) => {
+        if (inc.length > 0 && !matchesAny(inc, s))
+            return false;
+        if (exc.length > 0 && matchesAny(exc, s))
+            return false;
+        return true;
+    });
+}
+function safeId(id) {
+    return id.replace(/[^a-z0-9-_]+/gi, '_').slice(0, 200);
+}
+function viewportFolder(vp) {
+    return vp.name ?? `${vp.width}x${vp.height}`;
+}
+function storyUrl(base, id) {
+    return `${base}/iframe.html?id=${encodeURIComponent(id)}&viewMode=story`;
+}
+async function delay(ms) {
+    await new Promise((resolve) => { setTimeout(resolve, ms); });
+}
+async function waitForRoot(page, customSelector) {
+    if (customSelector) {
+        await page.waitForSelector(customSelector, { timeout: 15000 });
+        return;
+    }
+    for (const selector of ROOT_SELECTORS) {
+        try {
+            await page.waitForSelector(selector, { timeout: 5000 });
+            return;
+        }
+        catch {
+            // try next root selector
+        }
+    }
+}
+async function captureOne(args) {
+    const { context, story, baseUrl, viewport, outDir, fullPage, waitForSelector, maskRegions } = args;
+    const url = storyUrl(baseUrl, story.id);
+    const folder = path.join(outDir, viewportFolder(viewport));
+    const screenshotPath = path.join(folder, `${safeId(story.id)}.png`);
+    const shot = {
+        id: story.id, url, title: story.title, name: story.name,
+        screenshotPath, width: viewport.width, height: viewport.height, passed: false,
+    };
+    const page = await context.newPage();
+    try {
+        await page.setViewportSize({ width: viewport.width, height: viewport.height });
+        await page.goto(url, { waitUntil: 'load', timeout: 30000 });
+        await waitForRoot(page, waitForSelector);
+        await delay(SETTLE_DELAY_MS);
+        await fs.mkdir(folder, { recursive: true });
+        let buffer = await page.screenshot({ fullPage });
+        if (maskRegions && maskRegions.length > 0) {
+            const rects = await resolveMaskRegions(page, maskRegions);
+            buffer = applyMaskToPng(buffer, rects);
+        }
+        await fs.writeFile(screenshotPath, buffer);
+        shot.passed = true;
+    }
+    catch (err) {
+        shot.error = err instanceof Error ? err.message : String(err);
+    }
+    finally {
+        await page.close().catch(() => { });
+    }
+    return shot;
+}
+async function runPool(items, concurrency, worker) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const lanes = Math.max(1, Math.min(concurrency, items.length));
+    const workers = [];
+    for (let i = 0; i < lanes; i += 1) {
+        workers.push((async () => {
+            while (true) {
+                const idx = cursor;
+                cursor += 1;
+                if (idx >= items.length)
+                    return;
+                const item = items[idx];
+                if (item === undefined)
+                    return;
+                results[idx] = await worker(item);
+            }
+        })());
+    }
+    await Promise.all(workers);
+    return results;
+}
+export async function captureStorybook(opts) {
+    const baseUrl = trimSlash(opts.baseUrl);
+    const indexFile = `${baseUrl}/index.json`;
+    const allStories = await listStories(baseUrl);
+    const filtered = filterStories(allStories, opts.include, opts.exclude);
+    const cap = opts.maxStories ?? DEFAULT_MAX_STORIES;
+    const selected = filtered.slice(0, Math.max(0, cap));
+    const viewports = opts.viewports && opts.viewports.length > 0 ? opts.viewports : [DEFAULT_VIEWPORT];
+    const concurrency = Math.max(1, opts.concurrency ?? DEFAULT_CONCURRENCY);
+    const fullPage = opts.fullPage ?? false;
+    await fs.mkdir(opts.outDir, { recursive: true });
+    const jobs = [];
+    for (const viewport of viewports) {
+        for (const story of selected)
+            jobs.push({ story, viewport });
+    }
+    const shots = await runPool(jobs, concurrency, (job) => captureOne({
+        context: opts.context, story: job.story, baseUrl, viewport: job.viewport,
+        outDir: opts.outDir, fullPage, waitForSelector: opts.waitForSelector, maskRegions: opts.maskRegions,
+    }));
+    const capturedCount = shots.filter((s) => s.passed).length;
+    const skippedCount = Math.max(0, filtered.length - selected.length);
+    const passed = shots.length > 0 && shots.every((s) => s.passed) && capturedCount > 0;
+    return {
+        baseUrl, totalStories: allStories.length, capturedCount, skippedCount,
+        shots, indexFile, passed,
+    };
+}
+//# sourceMappingURL=storybook.js.map

package/dist/storybook.js.map

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

package/dist/structured-data.d.ts

@@ -0,0 +1,25 @@
+import type { Page } from 'playwright';
+export interface StructuredDataIssue {
+    level: 'error' | 'warn';
+    type: 'invalid-json' | 'missing-type' | 'missing-context' | 'hreflang-invalid-code' | 'hreflang-missing-return' | 'hreflang-non-200' | 'missing-required-property' | 'duplicate-type';
+    message: string;
+    snippet?: string;
+}
+export interface StructuredDataItem {
+    format: 'json-ld' | 'microdata';
+    type: string;
+    raw: unknown;
+}
+export interface StructuredDataResult {
+    page: string;
+    items: StructuredDataItem[];
+    hreflangTags: {
+        lang: string;
+        href: string;
+        valid: boolean;
+    }[];
+    issues: StructuredDataIssue[];
+    passed: boolean;
+}
+export declare function checkStructuredData(page: Page): Promise<StructuredDataResult>;
+//# sourceMappingURL=structured-data.d.ts.map

package/dist/structured-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-data.d.ts","sourceRoot":"","sources":["../src/structured-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,IAAI,EACA,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,uBAAuB,GACvB,yBAAyB,GACzB,kBAAkB,GAClB,2BAA2B,GAC3B,gBAAgB,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC/D,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB;AA4FD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2GnF"}