@page-scanner/cli 0.1.0

package/dist/protocol.js

@@ -0,0 +1,128 @@
+/**
+ * Mirror of `extension/src/lib/bridge/protocol.ts`.
+ *
+ * The extension owns the wire contract, because it owns the features the
+ * contract describes: the export formats, the paper sizes, what to do with a
+ * video. This file restates them for a package that cannot import the
+ * extension's source, and `protocol.contract.test.ts` fails if the two drift.
+ *
+ * The direction is the other half of the mirror, too. Over there the guards
+ * check what arrives *at the extension*; here they check what arrives *at the
+ * server*: a handshake, a ping, and the frames that answer a request. A
+ * loopback port is reachable by every process on the machine, so nothing here
+ * assumes a shape it has not checked, and a frame that fails a guard is
+ * dropped rather than coerced.
+ */
+/** Bumped when a change would make an older server and a newer extension disagree. */
+export const BRIDGE_PROTOCOL_VERSION = 1;
+/** Ping cadence. Chrome resets the service worker's idle timer on every frame. */
+export const BRIDGE_PING_INTERVAL_MS = 20_000;
+/** Mirrors EXPORT_FORMAT_IDS in `extension/src/lib/export/formats.ts`. */
+export const EXPORT_FORMAT_IDS = ['pdf', 'png', 'jpeg'];
+/** Mirrors the keys of PAGE_SIZE_LABELS in `extension/src/lib/pdf/layout.ts`. */
+export const PAGE_SIZE_IDS = ['auto', 'a4', 'letter'];
+/** Mirrors DEFAULT_PAGE_SIZE in `extension/src/lib/pdf/layout.ts`. */
+export const DEFAULT_PAGE_SIZE = 'a4';
+/** Mirrors VIDEO_HANDLINGS in `extension/src/lib/capture/viewport-units.ts`. */
+export const VIDEO_HANDLINGS = ['frame', 'blank'];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/** An id has to be safe to echo back and to use as a map key, so bound it. */
+function isRequestId(value) {
+    return typeof value === 'string' && value.length > 0 && value.length <= 128;
+}
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+export function isHelloFrame(value) {
+    return (isRecord(value) &&
+        value.type === 'hello' &&
+        isFiniteNumber(value.protocol) &&
+        typeof value.token === 'string' &&
+        isNonEmptyString(value.browserId) &&
+        typeof value.label === 'string' &&
+        typeof value.extensionVersion === 'string');
+}
+export function isPingFrame(value) {
+    return isRecord(value) && value.type === 'ping';
+}
+function isWindowSummary(value) {
+    return (isRecord(value) &&
+        Number.isInteger(value.windowId) &&
+        typeof value.focused === 'boolean' &&
+        typeof value.windowType === 'string' &&
+        Number.isInteger(value.tabCount));
+}
+function isTabSummary(value) {
+    return (isRecord(value) &&
+        Number.isInteger(value.tabId) &&
+        Number.isInteger(value.windowId) &&
+        typeof value.url === 'string' &&
+        typeof value.title === 'string' &&
+        typeof value.active === 'boolean');
+}
+function isTruncationReport(value) {
+    return (isRecord(value) &&
+        isFiniteNumber(value.requestedWidth) &&
+        isFiniteNumber(value.requestedHeight) &&
+        isFiniteNumber(value.width) &&
+        isFiniteNumber(value.height) &&
+        typeof value.message === 'string');
+}
+export function isTabsResponse(value) {
+    return (isRecord(value) &&
+        value.type === 'tabs' &&
+        isRequestId(value.id) &&
+        Array.isArray(value.windows) &&
+        value.windows.every(isWindowSummary) &&
+        Array.isArray(value.tabs) &&
+        value.tabs.every(isTabSummary));
+}
+export function isScanResultResponse(value) {
+    return (isRecord(value) &&
+        value.type === 'scan-result' &&
+        isRequestId(value.id) &&
+        isFiniteNumber(value.width) &&
+        isFiniteNumber(value.height) &&
+        (value.mode === 'vector' || value.mode === 'raster') &&
+        isNonEmptyString(value.fileName) &&
+        typeof value.bytesBase64 === 'string' &&
+        (value.truncated === undefined || isTruncationReport(value.truncated)));
+}
+export function isErrorResponse(value) {
+    return (isRecord(value) &&
+        value.type === 'error' &&
+        isRequestId(value.id) &&
+        typeof value.message === 'string');
+}
+export function isBridgeResponse(value) {
+    return isTabsResponse(value) || isScanResultResponse(value) || isErrorResponse(value);
+}
+/** Everything the extension may send, parsed from one socket message. */
+export function parseInbound(raw) {
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (isHelloFrame(value))
+        return value;
+    if (isPingFrame(value))
+        return value;
+    if (isBridgeResponse(value))
+        return value;
+    return null;
+}
+export function helloAck() {
+    return { type: 'hello-ok' };
+}
+export function helloReject(message) {
+    return { type: 'hello-error', message };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The published version, as a literal.
+ *
+ * Reading it from package.json would be truer, but the file is outside
+ * `rootDir` for the tsc build and absent from the Bun single-file binary, so
+ * the two places it is needed most are exactly where that fails.
+ * `version.test.ts` asserts this matches package.json, so the copy cannot
+ * drift without a red test.
+ */
+export declare const CLI_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,11 @@
+/**
+ * The published version, as a literal.
+ *
+ * Reading it from package.json would be truer, but the file is outside
+ * `rootDir` for the tsc build and absent from the Bun single-file binary, so
+ * the two places it is needed most are exactly where that fails.
+ * `version.test.ts` asserts this matches package.json, so the copy cannot
+ * drift without a red test.
+ */
+export const CLI_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@page-scanner/cli",
+  "version": "0.1.0",
+  "description": "Capture a whole web page from the command line, through the Page Scanner Chrome extension.",
+  "keywords": [
+    "chrome",
+    "chrome-extension",
+    "screenshot",
+    "full-page-screenshot",
+    "pdf",
+    "cli",
+    "page-scanner"
+  ],
+  "author": "Byungdon Yoon",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sbd530/page-scanner.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/sbd530/page-scanner/tree/main/cli#readme",
+  "bugs": "https://github.com/sbd530/page-scanner/issues",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "page-scanner": "dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./daemon": {
+      "types": "./dist/daemon/run.d.ts",
+      "default": "./dist/daemon/run.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.1.11",
+    "esbuild": "^0.25.12",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "bundle": "node scripts/bundle.mjs",
+    "compile": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "ci:checks": "pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test:coverage",
+    "ci:build": "pnpm run build",
+    "ci": "pnpm run ci:checks && pnpm run ci:build"
+  }
+}