@pixeyedev/storybook 0.4.0

package/dist/bundle.d.ts

@@ -0,0 +1,6 @@
+export interface BundleResult {
+    hash: string;
+    buffer: Buffer;
+    sizeBytes: number;
+}
+export declare const createBundle: (dir: string) => Promise<BundleResult>;

package/dist/bundle.js

@@ -0,0 +1,34 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { Readable } from 'node:stream';
+import { createGzip } from 'node:zlib';
+import { glob } from 'glob';
+export const createBundle = async (dir) => {
+    const files = await glob('**/*', { cwd: dir, nodir: true });
+    files.sort(); // Deterministic ordering
+    // Build a content map
+    const contentMap = {};
+    for (const file of files) {
+        const content = await readFile(join(dir, file));
+        contentMap[file] = content.toString('base64');
+    }
+    // Serialize deterministically (sorted keys)
+    const json = JSON.stringify(contentMap, Object.keys(contentMap).sort());
+    // Gzip compress
+    const compressed = await new Promise((resolve, reject) => {
+        const chunks = [];
+        const gzip = createGzip({ level: 9 });
+        gzip.on('data', (chunk) => chunks.push(chunk));
+        gzip.on('end', () => resolve(Buffer.concat(chunks)));
+        gzip.on('error', reject);
+        Readable.from(json).pipe(gzip);
+    });
+    // Content hash for dedup
+    const hash = createHash('sha256').update(compressed).digest('hex');
+    return {
+        hash,
+        buffer: compressed,
+        sizeBytes: compressed.length
+    };
+};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { BundleResult } from './bundle.js';
+export { createBundle } from './bundle.js';
+export type { UploadBundleOptions, UploadBundleResult } from './upload.js';
+export { uploadBundle } from './upload.js';
+export type { BundleValidation } from './validate.js';
+export { validateBundle } from './validate.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createBundle } from './bundle.js';
+export { uploadBundle } from './upload.js';
+export { validateBundle } from './validate.js';

package/dist/upload.d.ts

@@ -0,0 +1,27 @@
+export interface UploadBundleOptions {
+    serverUrl: string;
+    token: string;
+    commitSha: string;
+    branch: string;
+    hash: string;
+    buffer: Buffer;
+    storyCount: number;
+    componentCount: number;
+}
+export interface UploadBundleResult {
+    buildUrl: string;
+    storyCount: number;
+    skipped: boolean;
+}
+/**
+ * Upload a Storybook bundle to Pixeye for server-side rendering.
+ *
+ * Uses the existing storybook build registration endpoint. The full
+ * presigned bundle upload path (POST /storybook/uploads -> presigned PUT
+ * -> POST /storybook/uploads/:id/finalize) will be implemented when the
+ * storybook-renderer worker is built (Task 15.1).
+ *
+ * For now, this registers the build metadata so it appears in the
+ * Pixeye dashboard. Server-side rendering is not yet available.
+ */
+export declare const uploadBundle: (opts: UploadBundleOptions) => Promise<UploadBundleResult>;

package/dist/upload.js

@@ -0,0 +1,41 @@
+import { PixeyeError } from '@pixeyedev/core';
+/**
+ * Upload a Storybook bundle to Pixeye for server-side rendering.
+ *
+ * Uses the existing storybook build registration endpoint. The full
+ * presigned bundle upload path (POST /storybook/uploads -> presigned PUT
+ * -> POST /storybook/uploads/:id/finalize) will be implemented when the
+ * storybook-renderer worker is built (Task 15.1).
+ *
+ * For now, this registers the build metadata so it appears in the
+ * Pixeye dashboard. Server-side rendering is not yet available.
+ */
+export const uploadBundle = async (opts) => {
+    const baseUrl = opts.serverUrl.replace(/\/$/, '');
+    // Register the storybook build
+    const res = await fetch(`${baseUrl}/api/v1/storybook/builds`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${opts.token}`
+        },
+        body: JSON.stringify({
+            projectToken: opts.token,
+            commitSha: opts.commitSha,
+            branch: opts.branch,
+            fileCount: opts.storyCount,
+            totalBytes: opts.buffer.length,
+            storagePrefix: `storybook-bundle/${opts.hash}/`
+        })
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new PixeyeError(res.status, '/api/v1/storybook/builds', text);
+    }
+    const data = (await res.json());
+    return {
+        buildUrl: data.storybookUrl ?? `${baseUrl}/storybook/${data.build.id}`,
+        storyCount: opts.storyCount,
+        skipped: false
+    };
+};

package/dist/validate.d.ts

@@ -0,0 +1,6 @@
+export interface BundleValidation {
+    storyCount: number;
+    componentCount: number;
+    totalSizeBytes: number;
+}
+export declare const validateBundle: (dir: string) => Promise<BundleValidation>;

package/dist/validate.js

@@ -0,0 +1,53 @@
+import { readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+export const validateBundle = async (dir) => {
+    // Check required files
+    const indexHtml = join(dir, 'index.html');
+    const iframeHtml = join(dir, 'iframe.html');
+    try {
+        await stat(indexHtml);
+    }
+    catch {
+        throw new Error('Not a valid Storybook build. Missing index.html. Run "build-storybook" first.');
+    }
+    try {
+        await stat(iframeHtml);
+    }
+    catch {
+        throw new Error('Not a valid Storybook build. Missing iframe.html.');
+    }
+    // Find story manifest (Storybook 7+)
+    const indexJsonPath = join(dir, 'index.json');
+    const storiesJsonPath = join(dir, 'stories.json');
+    let manifestContent;
+    try {
+        manifestContent = await readFile(indexJsonPath, 'utf-8');
+    }
+    catch {
+        try {
+            manifestContent = await readFile(storiesJsonPath, 'utf-8');
+        }
+        catch {
+            throw new Error('Storybook 7+ required (index.json not found). Upgrade Storybook or use @pixeyedev/playwright for manual capture.');
+        }
+    }
+    // Parse manifest to count stories and components
+    const manifest = JSON.parse(manifestContent);
+    // Storybook 7 index.json format: { v: 5, entries: { [storyId]: { type, title, name, ... } } }
+    // Storybook 6 stories.json format: { v: 3, stories: { [storyId]: { ... } } }
+    const entries = manifest.entries ?? manifest.stories ?? {};
+    const storyEntries = Object.values(entries).filter((entry) => !entry.type || entry.type === 'story');
+    const storyCount = storyEntries.length;
+    // Components are unique titles (e.g., "Design System/Button")
+    const componentTitles = new Set(storyEntries.map((entry) => entry.title).filter(Boolean));
+    const componentCount = componentTitles.size;
+    // Calculate total size
+    const allFiles = await glob('**/*', { cwd: dir, nodir: true });
+    let totalSizeBytes = 0;
+    for (const file of allFiles) {
+        const fileStat = await stat(join(dir, file));
+        totalSizeBytes += fileStat.size;
+    }
+    return { storyCount, componentCount, totalSizeBytes };
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@pixeyedev/storybook",
+  "version": "0.4.0",
+  "private": false,
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "echo 'ok'",
+    "ai-check": "exit 0"
+  },
+  "dependencies": {
+    "@pixeyedev/core": "^0.4.0",
+    "@pixeyedev/shared": "^0.4.0",
+    "glob": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}