@juangadm/pre-post 0.1.0 → 0.1.1

package/README.md

@@ -2,11 +2,7 @@
 
 Visual diff tool that captures pre/post screenshots for PRs. Use it as a Claude Code skill for automatic visual documentation, or run it directly from the CLI.
 
-> Forked from [before-and-after](https://github.com/vercel-labs/before-and-after) by [James Clements](https://github.com/jamesclement) / Vercel Labs.
-
-## TODO
-
-- [ ] Publish to npm so `npm i -g pre-post` and `npx pre-post` work out of the box
+> Originally forked from [before-and-after](https://github.com/vercel-labs/before-and-after) by [James Clements](https://github.com/jamesclement) / Vercel Labs.
 
 ## What Changed from the Original
 
@@ -57,8 +53,11 @@ flowchart TD
 
     S --> T{Output}
     T -->|Default| U["Save to ~/Downloads"]
-    T -->|--markdown| V[Commit to PR branch]
-    V --> W[Markdown table for PR]
+    T -->|--markdown| V{Upload}
+    V -->|Default| W["Commit to .pre-post/ (blob+SHA URL)"]
+    V -->|--upload-url| Y["Custom storage"]
+    W --> Z[Markdown table for PR]
+    Y --> Z
 
     style A fill:#4f46e5,color:#fff
     style L fill:#2563eb,color:#fff
@@ -68,10 +67,9 @@ flowchart TD
 ## Prerequisites
 
 - **Node.js** 18+
-- **Chromium** (auto-installed on first run via Playwright)
+- **Chromium** — install once via Playwright:
 
 ```bash
-# Install Chromium browser for Playwright (one-time setup)
 npx playwright install chromium
 ```
 
@@ -115,7 +113,7 @@ Detect affected routes from git changes:
 
 ```bash
 pre-post detect                        # Auto-detect framework
-pre-post detect --framework nextjs     # Force framework
+pre-post detect --framework nextjs-app  # Force framework
 ```
 
 Outputs JSON with route paths, confidence levels, and source files.
@@ -177,13 +175,13 @@ Save to a custom location:
 pre-post url1 url2 --output ./screenshots
 ```
 
-Override the default upload method:
+Upload to a custom image storage service:
 
 ```bash
-pre-post url1 url2 --upload-url https://uploads.example.com
+pre-post url1 url2 --markdown --upload-url https://my-s3-bucket.amazonaws.com
 ```
 
-By default, screenshots are committed directly to the PR branch (under `.pre-post/`) and served via `raw.githubusercontent.com`. Use `--upload-url` to override with a custom storage service. Screenshots auto-append to the PR body, newest on top.
+By default, `--markdown` commits screenshots to the PR branch (under `.pre-post/`) and serves them via GitHub blob URLs pinned to the commit SHA. This works for both public and private repos. Use `--upload-url` to point at your own storage instead. It auto-detects the protocol for 0x0.st, Vercel Blob, and any generic PUT endpoint (like S3). Screenshots auto-append to the PR body, newest on top.
 
 ## Route Detection
 

package/dist/upload.d.ts

@@ -1,6 +1,6 @@
 /**
  * Image upload for generating shareable URLs.
- * Default: git-native (commits to .pre-post/ on current branch).
+ * Default: git-native (commits to .pre-post/, serves via blob+SHA URLs).
  * Opt-in: 0x0.st, Vercel Blob, generic PUT via --upload-url.
  */
 /**
@@ -9,18 +9,22 @@
  */
 export declare function uploadImage(image: Buffer, filename: string, uploadUrl?: string): Promise<string>;
 /**
- * Write an image to .pre-post/ in the repo root, stage it, and return
- * the raw.githubusercontent.com URL it will resolve to after push.
+ * Write an image to .pre-post/ in the repo root and stage it.
+ * Returns filename + ownerRepo — caller constructs blob+SHA URL after commit.
  */
-export declare function uploadGitNative(image: Buffer, filename: string): string;
+export declare function uploadGitNative(image: Buffer, filename: string): {
+    filename: string;
+    ownerRepo: string;
+};
 /**
  * Commit and push all staged .pre-post/ screenshots in one batch.
+ * Returns the full 40-char commit SHA.
  */
-export declare function commitAndPushScreenshots(): void;
+export declare function commitAndPushScreenshots(): string;
 /**
  * Upload before/after images and return URLs.
  * When uploadUrl is provided, uses the HTTP-based upload path.
- * Otherwise, uses git-native (commit to .pre-post/).
+ * Otherwise, uses git-native (commit to .pre-post/) with blob+SHA URLs.
  */
 export declare function uploadBeforeAfter(before: {
     image: Buffer;

package/dist/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,MAAM,CAAC,CAajB;AAuDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkBvE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC3C,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1C,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBlD"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,MAAM,CAAC,CAajB;AAuDD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAiBzC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CASjD;AAWD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC3C,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1C,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBlD"}

package/dist/upload.js

@@ -1,6 +1,6 @@
 /**
  * Image upload for generating shareable URLs.
- * Default: git-native (commits to .pre-post/ on current branch).
+ * Default: git-native (commits to .pre-post/, serves via blob+SHA URLs).
  * Opt-in: 0x0.st, Vercel Blob, generic PUT via --upload-url.
  */
 import { execSync } from 'child_process';
@@ -68,12 +68,11 @@ async function uploadGenericPut(image, filename, url) {
     return response.headers.get('location') || `${url}/${filename}`;
 }
 /**
- * Write an image to .pre-post/ in the repo root, stage it, and return
- * the raw.githubusercontent.com URL it will resolve to after push.
+ * Write an image to .pre-post/ in the repo root and stage it.
+ * Returns filename + ownerRepo — caller constructs blob+SHA URL after commit.
  */
 export function uploadGitNative(image, filename) {
     const repoRoot = execSync('git rev-parse --show-toplevel', { encoding: 'utf-8' }).trim();
-    const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
     const remoteUrl = execSync('git remote get-url origin', { encoding: 'utf-8' }).trim();
     // Parse owner/repo from HTTPS or SSH remote URL
     const ownerRepo = remoteUrl
@@ -84,19 +83,33 @@ export function uploadGitNative(image, filename) {
     const dest = path.join(destDir, filename);
     fs.writeFileSync(dest, image);
     execSync(`git add -f "${dest}"`);
-    return `https://raw.githubusercontent.com/${ownerRepo}/${branch}/.pre-post/${filename}`;
+    return { filename, ownerRepo };
 }
 /**
  * Commit and push all staged .pre-post/ screenshots in one batch.
+ * Returns the full 40-char commit SHA.
  */
 export function commitAndPushScreenshots() {
     execSync('git commit -m "chore: add pre/post screenshots"');
     execSync('git push origin HEAD');
+    const sha = execSync('git rev-parse HEAD', { encoding: 'utf-8' }).trim();
+    if (!/^[0-9a-f]{40}$/.test(sha)) {
+        throw new Error(`Failed to get commit SHA after push (got: "${sha}")`);
+    }
+    return sha;
+}
+/**
+ * Construct a GitHub blob URL with full SHA for an image in .pre-post/.
+ * Blob URLs are same-origin on GitHub — the markdown renderer resolves them
+ * with the viewer's auth, so they work for both public and private repos.
+ */
+function buildBlobUrl(ownerRepo, sha, filename) {
+    return `https://github.com/${ownerRepo}/blob/${sha}/.pre-post/${filename}?raw=true`;
 }
 /**
  * Upload before/after images and return URLs.
  * When uploadUrl is provided, uses the HTTP-based upload path.
- * Otherwise, uses git-native (commit to .pre-post/).
+ * Otherwise, uses git-native (commit to .pre-post/) with blob+SHA URLs.
  */
 export async function uploadBeforeAfter(before, after, uploadUrl) {
     // If an explicit upload URL is provided, use HTTP upload
@@ -107,10 +120,14 @@ export async function uploadBeforeAfter(before, after, uploadUrl) {
         ]);
         return { beforeUrl, afterUrl };
     }
-    // Default: git-native — stage both, then commit+push once
-    const beforeUrl = uploadGitNative(before.image, before.filename);
-    const afterUrl = uploadGitNative(after.image, after.filename);
-    commitAndPushScreenshots();
+    // Default: git-native with blob+SHA URLs.
+    // Works for both public and private repos — blob URLs are same-origin on GitHub,
+    // so the markdown renderer resolves them with the viewer's authentication context.
+    const beforeResult = uploadGitNative(before.image, before.filename);
+    const afterResult = uploadGitNative(after.image, after.filename);
+    const sha = commitAndPushScreenshots();
+    const beforeUrl = buildBlobUrl(beforeResult.ownerRepo, sha, beforeResult.filename);
+    const afterUrl = buildBlobUrl(afterResult.ownerRepo, sha, afterResult.filename);
     return { beforeUrl, afterUrl };
 }
 //# sourceMappingURL=upload.js.map

package/dist/upload.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juangadm/pre-post",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Visual diff tool for PRs — captures before/after screenshots of web pages",
   "author": "Juan Gabriel Delgado (forked from James Clements)",
   "license": "MIT",

package/skill/SKILL.md

@@ -222,17 +222,17 @@ npx pre-post compare --before-base URL --after-base URL
 
 ## Image Upload
 
-Screenshots are committed to `.pre-post/` on the current PR branch and served via `raw.githubusercontent.com`. This is the default — no external services needed.
+Screenshots are committed to `.pre-post/` on the current PR branch and served via
+GitHub blob URLs pinned to the commit SHA. This works for **both public and private
+repos** — blob URLs are same-origin on GitHub, so the markdown renderer resolves them
+with the viewer's authentication.
 
 ```bash
-# Default (git-native — commits to PR branch)
+# Default (git-native — commits to PR branch, works on any repo)
 ./scripts/upload-and-copy.sh before.png after.png --markdown
 
-# Fallback: 0x0.st (no signup needed, 365-day expiry)
+# Explicit override for external storage:
 IMAGE_ADAPTER=0x0st ./scripts/upload-and-copy.sh before.png after.png --markdown
-
-# GitHub Gist
-IMAGE_ADAPTER=gist ./scripts/upload-and-copy.sh before.png after.png --markdown
 ```
 
 ## Error Reference
@@ -244,3 +244,4 @@ IMAGE_ADAPTER=gist ./scripts/upload-and-copy.sh before.png after.png --markdown
 | 401/403 on production URL | See pre-flight section above |
 | Element not found | Verify selector exists on page |
 | No changed files detected | Specify routes manually with `--routes` |
+| Could not determine commit SHA | Ensure `git push` succeeded and HEAD is valid |

package/skill/scripts/adapters/git-native.sh

@@ -1,17 +1,17 @@
 #!/bin/bash
-# Git-native adapter - Commit screenshots to .pre-post/ on the PR branch
+# Git-native adapter - Stage a screenshot in .pre-post/ on the PR branch
 #
 # Usage: ./git-native.sh <file>
-# Output: raw.githubusercontent.com URL (stdout)
+# Output: filename (stdout)
 #
 # Requirements:
-#   - Inside a git repo with a remote named "origin"
-#   - Current branch pushed to origin
+#   - Inside a git repo
 #
 # Notes:
 #   - Stages only the specific file, never `git add .`
 #   - Does NOT commit or push — the caller (upload-and-copy.sh) batches that
-#   - Returns the raw GitHub URL the file will be available at after push
+#   - Returns filename only — URL is constructed by upload-and-copy.sh after
+#     commit, using the SHA for blob URLs that work on public + private repos
 
 set -e
 
@@ -33,30 +33,6 @@ if ! git rev-parse --is-inside-work-tree &>/dev/null; then
     exit 1
 fi
 
-# Parse owner/repo from origin remote
-REMOTE_URL=$(git remote get-url origin 2>/dev/null)
-if [[ -z "$REMOTE_URL" ]]; then
-    echo "Error: No 'origin' remote found" >&2
-    exit 1
-fi
-
-# Extract owner/repo from HTTPS or SSH URL
-# HTTPS: https://github.com/owner/repo.git
-# SSH:   git@github.com:owner/repo.git
-OWNER_REPO=$(echo "$REMOTE_URL" | sed -E 's#^(https?://github\.com/|git@github\.com:)##; s#\.git$##')
-
-if [[ -z "$OWNER_REPO" || ! "$OWNER_REPO" =~ / ]]; then
-    echo "Error: Could not parse owner/repo from remote: $REMOTE_URL" >&2
-    exit 1
-fi
-
-# Get current branch
-BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
-if [[ -z "$BRANCH" || "$BRANCH" == "HEAD" ]]; then
-    echo "Error: Could not determine current branch (detached HEAD?)" >&2
-    exit 1
-fi
-
 # Copy file into .pre-post/ at the repo root
 REPO_ROOT=$(git rev-parse --show-toplevel)
 DEST_DIR="$REPO_ROOT/.pre-post"
@@ -71,5 +47,5 @@ git add -f "$DEST"
 
 echo "Staged: .pre-post/$FILENAME" >&2
 
-# Return the raw GitHub URL (will resolve after push)
-echo "https://raw.githubusercontent.com/$OWNER_REPO/$BRANCH/.pre-post/$FILENAME"
+# Return just the filename — URL built by caller after commit
+echo "$FILENAME"

package/skill/scripts/upload-and-copy.sh

@@ -7,7 +7,7 @@
 #
 # Environment:
 #   IMAGE_ADAPTER    Storage adapter to use (default: git-native)
-#                    Available: git-native, 0x0st, gist, blob
+#                    Available: git-native, 0x0st, blob
 #
 # Adapter-specific environment variables:
 #   blob:  BLOB_UPLOAD_URL - Custom upload endpoint
@@ -51,7 +51,7 @@ if [[ -z "$BEFORE_FILE" || -z "$AFTER_FILE" ]]; then
     echo ""
     echo "Environment:"
     echo "  IMAGE_ADAPTER    Storage adapter (default: git-native)"
-    echo "                   Available: git-native, 0x0st, gist, blob"
+    echo "                   Available: git-native, 0x0st, blob"
     exit 1
 fi
 
@@ -79,6 +79,8 @@ if [[ ! -f "$ADAPTER_SCRIPT" ]]; then
 fi
 
 # Upload function using adapter
+# NOTE: git-native adapter returns a filename (not a URL) — the URL is
+# constructed below after commit+push, using the SHA for blob URLs.
 upload_file() {
     local file="$1"
     local filename=$(basename "$file")
@@ -89,16 +91,33 @@ upload_file() {
     "$ADAPTER_SCRIPT" "$file"
 }
 
-# Upload both files
+# Upload both files (adapter returns filename for git-native, URL for others)
 echo "=== Uploading Screenshots ==="
-BEFORE_URL=$(upload_file "$BEFORE_FILE")
-AFTER_URL=$(upload_file "$AFTER_FILE")
+BEFORE_RESULT=$(upload_file "$BEFORE_FILE")
+AFTER_RESULT=$(upload_file "$AFTER_FILE")
 
-# For git-native adapter: batch commit + push after both files are staged
+# For git-native: commit, push, then construct blob+SHA URLs.
+# Blob URLs work for both public and private repos (same-origin on GitHub).
 if [[ "$IMAGE_ADAPTER" == "git-native" ]]; then
     echo "Committing and pushing screenshots..." >&2
     git commit -m "chore: add pre/post screenshots"
     git push origin HEAD
+
+    SHA=$(git rev-parse HEAD)
+    if [[ ! "$SHA" =~ ^[0-9a-f]{40}$ ]]; then
+        echo "Error: Could not determine commit SHA after push (got: '$SHA')" >&2
+        exit 1
+    fi
+
+    REMOTE_URL=$(git remote get-url origin 2>/dev/null)
+    OWNER_REPO=$(echo "$REMOTE_URL" | sed -E 's#^(https?://github\.com/|git@github\.com:)##; s#\.git$##')
+
+    BEFORE_URL="https://github.com/$OWNER_REPO/blob/$SHA/.pre-post/$BEFORE_RESULT?raw=true"
+    AFTER_URL="https://github.com/$OWNER_REPO/blob/$SHA/.pre-post/$AFTER_RESULT?raw=true"
+else
+    # Other adapters (0x0st, blob) return full URLs directly
+    BEFORE_URL="$BEFORE_RESULT"
+    AFTER_URL="$AFTER_RESULT"
 fi
 
 echo ""

package/skill/scripts/adapters/gist.sh

@@ -1,59 +0,0 @@
-#!/bin/bash
-# GitHub Gist adapter - Upload images via gh CLI
-#
-# Usage: ./gist.sh <file>
-# Output: Raw URL to uploaded file (stdout)
-#
-# Requirements:
-#   - gh CLI installed and authenticated
-#
-# Notes:
-#   - Creates a public gist for each upload
-#   - Files persist indefinitely
-#   - Requires GitHub authentication
-
-set -e
-
-FILE="$1"
-
-if [[ -z "$FILE" ]]; then
-    echo "Usage: $0 <file>" >&2
-    exit 1
-fi
-
-if [[ ! -f "$FILE" ]]; then
-    echo "Error: File not found: $FILE" >&2
-    exit 1
-fi
-
-# Check gh is available
-if ! command -v gh &> /dev/null; then
-    echo "Error: gh CLI not found. Install from https://cli.github.com" >&2
-    exit 1
-fi
-
-# Create gist and capture output
-GIST_OUTPUT=$(gh gist create "$FILE" --public 2>&1)
-
-# Extract the gist URL from output
-GIST_URL=$(echo "$GIST_OUTPUT" | grep -o 'https://gist.github.com/[^ ]*' | head -1)
-
-if [[ -z "$GIST_URL" ]]; then
-    echo "Error: Failed to create gist. Output: $GIST_OUTPUT" >&2
-    exit 1
-fi
-
-# Convert to raw URL
-# Format: https://gist.github.com/user/id -> https://gist.githubusercontent.com/user/id/raw/filename
-GIST_ID=$(echo "$GIST_URL" | sed 's|.*/||')
-FILENAME=$(basename "$FILE")
-
-# Get the raw URL via gh api
-RAW_URL=$(gh api "gists/$GIST_ID" --jq ".files[\"$FILENAME\"].raw_url")
-
-if [[ -z "$RAW_URL" ]]; then
-    echo "Error: Could not get raw URL for gist" >&2
-    exit 1
-fi
-
-echo "$RAW_URL"