gwan-pdf-engine 0.1.0

package/dist/adapters/storage/gcp.d.mts

@@ -0,0 +1,13 @@
+import { S as StorageAdapter } from '../../index-Dasg2QQ6.mjs';
+
+/**
+ * GCP Cloud Storage adapter.
+ * Requires @google-cloud/storage to be installed (optional peer dependency).
+ *
+ * Usage:
+ *   import { createGcpAdapter } from '@gwan/pdf-engine/adapters/gcp'
+ *   const storage = createGcpAdapter('my-bucket')
+ */
+declare function createGcpAdapter(bucketName: string): StorageAdapter;
+
+export { createGcpAdapter };

package/dist/adapters/storage/gcp.d.ts

@@ -0,0 +1,13 @@
+import { S as StorageAdapter } from '../../index-Dasg2QQ6.js';
+
+/**
+ * GCP Cloud Storage adapter.
+ * Requires @google-cloud/storage to be installed (optional peer dependency).
+ *
+ * Usage:
+ *   import { createGcpAdapter } from '@gwan/pdf-engine/adapters/gcp'
+ *   const storage = createGcpAdapter('my-bucket')
+ */
+declare function createGcpAdapter(bucketName: string): StorageAdapter;
+
+export { createGcpAdapter };

package/dist/adapters/storage/gcp.js

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/storage/gcp.ts
+var gcp_exports = {};
+__export(gcp_exports, {
+  createGcpAdapter: () => createGcpAdapter
+});
+module.exports = __toCommonJS(gcp_exports);
+function createGcpAdapter(bucketName) {
+  let _storage;
+  let _bucket;
+  function getBucket() {
+    if (!_bucket) {
+      try {
+        const { Storage } = require("@google-cloud/storage");
+        _storage = new Storage();
+        _bucket = _storage.bucket(bucketName);
+      } catch {
+        throw new Error(
+          "@google-cloud/storage is not installed. Run: npm install @google-cloud/storage"
+        );
+      }
+    }
+    return _bucket;
+  }
+  return {
+    async download(remotePath) {
+      const bucket = getBucket();
+      const [buffer] = await bucket.file(remotePath).download();
+      return buffer;
+    },
+    async upload(buffer, remotePath) {
+      const bucket = getBucket();
+      const file = bucket.file(remotePath);
+      await file.save(buffer, { resumable: false });
+      return `https://storage.googleapis.com/${bucketName}/${remotePath}`;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGcpAdapter
+});

package/dist/adapters/storage/gcp.mjs

@@ -0,0 +1,39 @@
+import {
+  __require
+} from "../../chunk-Y6FXYEAI.mjs";
+
+// src/adapters/storage/gcp.ts
+function createGcpAdapter(bucketName) {
+  let _storage;
+  let _bucket;
+  function getBucket() {
+    if (!_bucket) {
+      try {
+        const { Storage } = __require("@google-cloud/storage");
+        _storage = new Storage();
+        _bucket = _storage.bucket(bucketName);
+      } catch {
+        throw new Error(
+          "@google-cloud/storage is not installed. Run: npm install @google-cloud/storage"
+        );
+      }
+    }
+    return _bucket;
+  }
+  return {
+    async download(remotePath) {
+      const bucket = getBucket();
+      const [buffer] = await bucket.file(remotePath).download();
+      return buffer;
+    },
+    async upload(buffer, remotePath) {
+      const bucket = getBucket();
+      const file = bucket.file(remotePath);
+      await file.save(buffer, { resumable: false });
+      return `https://storage.googleapis.com/${bucketName}/${remotePath}`;
+    }
+  };
+}
+export {
+  createGcpAdapter
+};

package/dist/adapters/storage/local.d.mts

@@ -0,0 +1,9 @@
+import { S as StorageAdapter } from '../../index-Dasg2QQ6.mjs';
+
+/**
+ * Local filesystem storage adapter — for development and testing.
+ * All paths are resolved relative to basePath.
+ */
+declare function createLocalAdapter(basePath: string): StorageAdapter;
+
+export { createLocalAdapter };

package/dist/adapters/storage/local.d.ts

@@ -0,0 +1,9 @@
+import { S as StorageAdapter } from '../../index-Dasg2QQ6.js';
+
+/**
+ * Local filesystem storage adapter — for development and testing.
+ * All paths are resolved relative to basePath.
+ */
+declare function createLocalAdapter(basePath: string): StorageAdapter;
+
+export { createLocalAdapter };

package/dist/adapters/storage/local.js

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/storage/local.ts
+var local_exports = {};
+__export(local_exports, {
+  createLocalAdapter: () => createLocalAdapter
+});
+module.exports = __toCommonJS(local_exports);
+var import_promises = require("fs/promises");
+var import_path = require("path");
+function createLocalAdapter(basePath) {
+  return {
+    async download(remotePath) {
+      const fullPath = (0, import_path.join)(basePath, remotePath);
+      return (0, import_promises.readFile)(fullPath);
+    },
+    async upload(buffer, remotePath) {
+      const fullPath = (0, import_path.join)(basePath, remotePath);
+      await (0, import_promises.mkdir)((0, import_path.dirname)(fullPath), { recursive: true });
+      await (0, import_promises.writeFile)(fullPath, buffer);
+      return `file://${fullPath}`;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createLocalAdapter
+});

package/dist/adapters/storage/local.mjs

@@ -0,0 +1,22 @@
+import "../../chunk-Y6FXYEAI.mjs";
+
+// src/adapters/storage/local.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { dirname, join } from "path";
+function createLocalAdapter(basePath) {
+  return {
+    async download(remotePath) {
+      const fullPath = join(basePath, remotePath);
+      return readFile(fullPath);
+    },
+    async upload(buffer, remotePath) {
+      const fullPath = join(basePath, remotePath);
+      await mkdir(dirname(fullPath), { recursive: true });
+      await writeFile(fullPath, buffer);
+      return `file://${fullPath}`;
+    }
+  };
+}
+export {
+  createLocalAdapter
+};

package/dist/chunk-Y6FXYEAI.mjs

@@ -0,0 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};

package/dist/index-Dasg2QQ6.d.mts

@@ -0,0 +1,41 @@
+interface StorageAdapter {
+    download(remotePath: string): Promise<Buffer>;
+    upload(buffer: Buffer, remotePath: string): Promise<string>;
+}
+type BookSize = '6x9' | '7x9' | '5x8' | '8.5x11';
+type AssetType = 'cover' | 'template' | 'back_cover';
+interface AssetInput {
+    path: string;
+    type: AssetType;
+    repeatCount?: number;
+}
+interface BookConfig {
+    size: BookSize;
+    bleed: boolean;
+    assets: AssetInput[];
+    outputPath: string;
+    pressReady?: boolean;
+}
+interface PdfOutput {
+    buffer: Buffer;
+    url: string;
+    pageCount: number;
+}
+interface ValidationReport {
+    valid: boolean;
+    colorSpace: 'CMYK' | 'RGB' | 'unknown';
+    dpi: number;
+    hasBleed: boolean;
+    warnings: string[];
+}
+interface PageNumberOptions {
+    startPage?: number;
+    position?: 'bottom-center' | 'bottom-right' | 'bottom-left';
+    fontSize?: number;
+}
+interface SplitRange {
+    start: number;
+    end: number;
+}
+
+export type { AssetInput as A, BookConfig as B, PdfOutput as P, StorageAdapter as S, ValidationReport as V, AssetType as a, BookSize as b, PageNumberOptions as c, SplitRange as d };

package/dist/index-Dasg2QQ6.d.ts

@@ -0,0 +1,41 @@
+interface StorageAdapter {
+    download(remotePath: string): Promise<Buffer>;
+    upload(buffer: Buffer, remotePath: string): Promise<string>;
+}
+type BookSize = '6x9' | '7x9' | '5x8' | '8.5x11';
+type AssetType = 'cover' | 'template' | 'back_cover';
+interface AssetInput {
+    path: string;
+    type: AssetType;
+    repeatCount?: number;
+}
+interface BookConfig {
+    size: BookSize;
+    bleed: boolean;
+    assets: AssetInput[];
+    outputPath: string;
+    pressReady?: boolean;
+}
+interface PdfOutput {
+    buffer: Buffer;
+    url: string;
+    pageCount: number;
+}
+interface ValidationReport {
+    valid: boolean;
+    colorSpace: 'CMYK' | 'RGB' | 'unknown';
+    dpi: number;
+    hasBleed: boolean;
+    warnings: string[];
+}
+interface PageNumberOptions {
+    startPage?: number;
+    position?: 'bottom-center' | 'bottom-right' | 'bottom-left';
+    fontSize?: number;
+}
+interface SplitRange {
+    start: number;
+    end: number;
+}
+
+export type { AssetInput as A, BookConfig as B, PdfOutput as P, StorageAdapter as S, ValidationReport as V, AssetType as a, BookSize as b, PageNumberOptions as c, SplitRange as d };

package/dist/index-t66EBWt1.d.mts

@@ -0,0 +1,41 @@
+interface StorageAdapter {
+    download(remotePath: string): Promise<Buffer>;
+    upload(buffer: Buffer, remotePath: string): Promise<string>;
+}
+type BookSize = '6x9' | '5x8' | '8.5x11';
+type AssetType = 'cover' | 'template' | 'back_cover';
+interface AssetInput {
+    path: string;
+    type: AssetType;
+    repeatCount?: number;
+}
+interface BookConfig {
+    size: BookSize;
+    bleed: boolean;
+    assets: AssetInput[];
+    outputPath: string;
+    pressReady?: boolean;
+}
+interface PdfOutput {
+    buffer: Buffer;
+    url: string;
+    pageCount: number;
+}
+interface ValidationReport {
+    valid: boolean;
+    colorSpace: 'CMYK' | 'RGB' | 'unknown';
+    dpi: number;
+    hasBleed: boolean;
+    warnings: string[];
+}
+interface PageNumberOptions {
+    startPage?: number;
+    position?: 'bottom-center' | 'bottom-right' | 'bottom-left';
+    fontSize?: number;
+}
+interface SplitRange {
+    start: number;
+    end: number;
+}
+
+export type { AssetInput as A, BookConfig as B, PdfOutput as P, StorageAdapter as S, ValidationReport as V, AssetType as a, BookSize as b, PageNumberOptions as c, SplitRange as d };

package/dist/index-t66EBWt1.d.ts

@@ -0,0 +1,41 @@
+interface StorageAdapter {
+    download(remotePath: string): Promise<Buffer>;
+    upload(buffer: Buffer, remotePath: string): Promise<string>;
+}
+type BookSize = '6x9' | '5x8' | '8.5x11';
+type AssetType = 'cover' | 'template' | 'back_cover';
+interface AssetInput {
+    path: string;
+    type: AssetType;
+    repeatCount?: number;
+}
+interface BookConfig {
+    size: BookSize;
+    bleed: boolean;
+    assets: AssetInput[];
+    outputPath: string;
+    pressReady?: boolean;
+}
+interface PdfOutput {
+    buffer: Buffer;
+    url: string;
+    pageCount: number;
+}
+interface ValidationReport {
+    valid: boolean;
+    colorSpace: 'CMYK' | 'RGB' | 'unknown';
+    dpi: number;
+    hasBleed: boolean;
+    warnings: string[];
+}
+interface PageNumberOptions {
+    startPage?: number;
+    position?: 'bottom-center' | 'bottom-right' | 'bottom-left';
+    fontSize?: number;
+}
+interface SplitRange {
+    start: number;
+    end: number;
+}
+
+export type { AssetInput as A, BookConfig as B, PdfOutput as P, StorageAdapter as S, ValidationReport as V, AssetType as a, BookSize as b, PageNumberOptions as c, SplitRange as d };

package/dist/index.d.mts

@@ -0,0 +1,54 @@
+import { S as StorageAdapter, B as BookConfig, P as PdfOutput, V as ValidationReport } from './index-Dasg2QQ6.mjs';
+export { A as AssetInput, a as AssetType, b as BookSize, c as PageNumberOptions, d as SplitRange } from './index-Dasg2QQ6.mjs';
+
+declare class PdfForge {
+    private storage;
+    constructor(storage: StorageAdapter);
+    /**
+     * Assembles a press-ready PDF book from a list of CMYK image assets.
+     * Assets are downloaded from storage, assembled in order (respecting repeatCount),
+     * and the result is uploaded back to storage.
+     */
+    buildBook(config: BookConfig): Promise<PdfOutput>;
+    /**
+     * Downloads PDFs from storage, merges them into a single PDF,
+     * uploads the result to the last path's directory as 'merged.pdf',
+     * and returns the output.
+     */
+    mergePdfs(paths: string[], outputPath: string): Promise<PdfOutput>;
+    /**
+     * Downloads a PDF from storage, splits it into page ranges,
+     * uploads each part, and returns an array of PdfOutputs.
+     */
+    splitPdf(path: string, ranges: Array<[number, number]>, outputBasePath: string): Promise<PdfOutput[]>;
+    /**
+     * Downloads a PDF, compresses it, uploads the result, and returns the output.
+     */
+    compress(path: string, outputPath: string): Promise<PdfOutput>;
+    /**
+     * Downloads an asset (image or PDF) and validates CMYK color space, DPI, and bleed.
+     */
+    validate(path: string): Promise<ValidationReport>;
+}
+
+declare function validateAsset(buffer: Buffer): Promise<ValidationReport>;
+
+declare function mergePdfs(buffers: Buffer[], outputPath: string, storage: StorageAdapter): Promise<PdfOutput>;
+
+/**
+ * Splits a PDF into parts defined by inclusive [start, end] page ranges (0-indexed).
+ * Each part is uploaded to `${outputBasePath}/part-N.pdf`.
+ */
+declare function splitPdf(buffer: Buffer, ranges: Array<[number, number]>, outputBasePath: string, storage: StorageAdapter): Promise<PdfOutput[]>;
+
+/**
+ * Re-saves the PDF with object streams enabled (pdf-lib's built-in compression).
+ * For deeper compression, pass pressReady: true to use Ghostscript (requires gs installed).
+ *
+ * Note: Object stream compression reduces cross-reference table size but does not
+ * re-compress already-embedded image data. Ghostscript post-processing is needed
+ * for full image resampling/compression.
+ */
+declare function compressPdf(buffer: Buffer, outputPath: string, storage: StorageAdapter): Promise<PdfOutput>;
+
+export { BookConfig, PdfForge, PdfOutput, StorageAdapter, ValidationReport, compressPdf, mergePdfs, splitPdf, validateAsset };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { S as StorageAdapter, B as BookConfig, P as PdfOutput, V as ValidationReport } from './index-Dasg2QQ6.js';
+export { A as AssetInput, a as AssetType, b as BookSize, c as PageNumberOptions, d as SplitRange } from './index-Dasg2QQ6.js';
+
+declare class PdfForge {
+    private storage;
+    constructor(storage: StorageAdapter);
+    /**
+     * Assembles a press-ready PDF book from a list of CMYK image assets.
+     * Assets are downloaded from storage, assembled in order (respecting repeatCount),
+     * and the result is uploaded back to storage.
+     */
+    buildBook(config: BookConfig): Promise<PdfOutput>;
+    /**
+     * Downloads PDFs from storage, merges them into a single PDF,
+     * uploads the result to the last path's directory as 'merged.pdf',
+     * and returns the output.
+     */
+    mergePdfs(paths: string[], outputPath: string): Promise<PdfOutput>;
+    /**
+     * Downloads a PDF from storage, splits it into page ranges,
+     * uploads each part, and returns an array of PdfOutputs.
+     */
+    splitPdf(path: string, ranges: Array<[number, number]>, outputBasePath: string): Promise<PdfOutput[]>;
+    /**
+     * Downloads a PDF, compresses it, uploads the result, and returns the output.
+     */
+    compress(path: string, outputPath: string): Promise<PdfOutput>;
+    /**
+     * Downloads an asset (image or PDF) and validates CMYK color space, DPI, and bleed.
+     */
+    validate(path: string): Promise<ValidationReport>;
+}
+
+declare function validateAsset(buffer: Buffer): Promise<ValidationReport>;
+
+declare function mergePdfs(buffers: Buffer[], outputPath: string, storage: StorageAdapter): Promise<PdfOutput>;
+
+/**
+ * Splits a PDF into parts defined by inclusive [start, end] page ranges (0-indexed).
+ * Each part is uploaded to `${outputBasePath}/part-N.pdf`.
+ */
+declare function splitPdf(buffer: Buffer, ranges: Array<[number, number]>, outputBasePath: string, storage: StorageAdapter): Promise<PdfOutput[]>;
+
+/**
+ * Re-saves the PDF with object streams enabled (pdf-lib's built-in compression).
+ * For deeper compression, pass pressReady: true to use Ghostscript (requires gs installed).
+ *
+ * Note: Object stream compression reduces cross-reference table size but does not
+ * re-compress already-embedded image data. Ghostscript post-processing is needed
+ * for full image resampling/compression.
+ */
+declare function compressPdf(buffer: Buffer, outputPath: string, storage: StorageAdapter): Promise<PdfOutput>;
+
+export { BookConfig, PdfForge, PdfOutput, StorageAdapter, ValidationReport, compressPdf, mergePdfs, splitPdf, validateAsset };

package/dist/index.js

@@ -0,0 +1,304 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PdfForge: () => PdfForge,
+  compressPdf: () => compressPdf,
+  mergePdfs: () => mergePdfs,
+  splitPdf: () => splitPdf,
+  validateAsset: () => validateAsset
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/assembler/buildBook.ts
+var import_pdf_lib2 = require("pdf-lib");
+
+// src/assembler/pageLayout.ts
+var BLEED_PT = 9;
+var TRIM_SIZES = {
+  "6x9": { width: 432, height: 648 },
+  "7x9": { width: 504, height: 648 },
+  "5x8": { width: 360, height: 576 },
+  "8.5x11": { width: 612, height: 792 }
+};
+function getPageDimensions(size, bleed) {
+  const trim = TRIM_SIZES[size];
+  const extra = bleed ? BLEED_PT * 2 : 0;
+  return {
+    width: trim.width + extra,
+    height: trim.height + extra,
+    bleedPt: bleed ? BLEED_PT : 0
+  };
+}
+
+// src/cmyk/embedCmyk.ts
+var import_pdf_lib = require("pdf-lib");
+var import_sharp = __toESM(require("sharp"));
+async function embedImage(pdfDoc, page, buffer, pageWidth, pageHeight) {
+  const meta = await (0, import_sharp.default)(buffer).metadata();
+  const width = meta.width;
+  const height = meta.height;
+  let imageBytes;
+  let colorSpace;
+  if (meta.format === "jpeg") {
+    imageBytes = buffer;
+    if (meta.channels === 4) colorSpace = "DeviceCMYK";
+    else if (meta.channels === 1) colorSpace = "DeviceGray";
+    else colorSpace = "DeviceRGB";
+  } else {
+    imageBytes = await (0, import_sharp.default)(buffer).jpeg({ quality: 90 }).toBuffer();
+    colorSpace = "DeviceRGB";
+  }
+  const context = pdfDoc.context;
+  const imageStream = context.stream(imageBytes, {
+    Type: "XObject",
+    Subtype: "Image",
+    Width: width,
+    Height: height,
+    ColorSpace: colorSpace,
+    BitsPerComponent: 8,
+    Filter: "DCTDecode",
+    Length: imageBytes.length
+  });
+  const imageRef = context.register(imageStream);
+  const imageName = import_pdf_lib.PDFName.of(`Img${Date.now()}`);
+  const pageNode = page.node;
+  let resources = pageNode.get(import_pdf_lib.PDFName.of("Resources"));
+  if (!resources) {
+    pageNode.set(import_pdf_lib.PDFName.of("Resources"), context.obj({}));
+    resources = pageNode.get(import_pdf_lib.PDFName.of("Resources"));
+  }
+  let xObject = resources.get(import_pdf_lib.PDFName.of("XObject"));
+  if (!xObject) {
+    resources.set(import_pdf_lib.PDFName.of("XObject"), context.obj({}));
+    xObject = resources.get(import_pdf_lib.PDFName.of("XObject"));
+  }
+  xObject.set(imageName, imageRef);
+  const saveState = import_pdf_lib.PDFOperator.of("q");
+  const transform = import_pdf_lib.PDFOperator.of("cm", [
+    import_pdf_lib.PDFNumber.of(pageWidth),
+    import_pdf_lib.PDFNumber.of(0),
+    import_pdf_lib.PDFNumber.of(0),
+    import_pdf_lib.PDFNumber.of(pageHeight),
+    import_pdf_lib.PDFNumber.of(0),
+    import_pdf_lib.PDFNumber.of(0)
+  ]);
+  const drawImage = import_pdf_lib.PDFOperator.of("Do", [imageName]);
+  const restoreState = import_pdf_lib.PDFOperator.of("Q");
+  page.pushOperators(saveState, transform, drawImage, restoreState);
+}
+
+// src/assembler/buildBook.ts
+function expandAssets(assets) {
+  const expanded = [];
+  for (const asset of assets) {
+    const count = asset.repeatCount ?? 1;
+    for (let i = 0; i < count; i++) {
+      expanded.push({ ...asset, repeatCount: 1 });
+    }
+  }
+  return expanded;
+}
+async function buildBook(config, storage) {
+  const pdfDoc = await import_pdf_lib2.PDFDocument.create();
+  const { width, height } = getPageDimensions(config.size, config.bleed);
+  const pages = expandAssets(config.assets);
+  for (const asset of pages) {
+    const buffer = await storage.download(asset.path);
+    const page = pdfDoc.addPage([width, height]);
+    await embedImage(pdfDoc, page, buffer, width, height);
+  }
+  const pdfBytes = await pdfDoc.save();
+  const pdfBuffer = Buffer.from(pdfBytes);
+  const url = await storage.upload(pdfBuffer, config.outputPath);
+  return {
+    buffer: pdfBuffer,
+    url,
+    pageCount: pdfDoc.getPageCount()
+  };
+}
+
+// src/validator/validateAsset.ts
+var import_sharp2 = __toESM(require("sharp"));
+var MIN_DPI = 300;
+function mapColorSpace(space) {
+  if (!space) return "unknown";
+  if (space === "cmyk") return "CMYK";
+  if (space === "srgb" || space === "rgb") return "RGB";
+  return "unknown";
+}
+async function validateAsset(buffer) {
+  const meta = await (0, import_sharp2.default)(buffer).metadata();
+  const warnings = [];
+  const colorSpace = mapColorSpace(meta.space);
+  const dpi = meta.density ?? 0;
+  const width = meta.width ?? 0;
+  const height = meta.height ?? 0;
+  if (colorSpace !== "CMYK") {
+    warnings.push(`Color space is ${colorSpace}, expected CMYK. This file may not print correctly.`);
+  }
+  if (dpi < MIN_DPI) {
+    warnings.push(`DPI is ${dpi}, minimum recommended is ${MIN_DPI} for print.`);
+  }
+  const hasBleed = width > 0 && height > 0 ? checkHasBleed(width, height, dpi) : false;
+  if (!hasBleed) {
+    warnings.push("Image does not appear to include a bleed margin (0.125 inch). Consider adding bleed for press-ready output.");
+  }
+  return {
+    valid: warnings.length === 0,
+    colorSpace,
+    dpi,
+    hasBleed,
+    warnings
+  };
+}
+function checkHasBleed(width, height, dpi) {
+  if (dpi === 0) return false;
+  const bleedPx = Math.round(0.125 / 1 * dpi);
+  const trimSizes = [
+    { w: 6, h: 9 },
+    { w: 5, h: 8 },
+    { w: 8.5, h: 11 }
+  ];
+  for (const trim of trimSizes) {
+    const trimW = Math.round(trim.w * dpi);
+    const trimH = Math.round(trim.h * dpi);
+    const expectedW = trimW + bleedPx * 2;
+    const expectedH = trimH + bleedPx * 2;
+    const withinW = Math.abs(width - expectedW) <= expectedW * 0.05;
+    const withinH = Math.abs(height - expectedH) <= expectedH * 0.05;
+    if (withinW && withinH) return true;
+  }
+  return false;
+}
+
+// src/transformer/mergePdfs.ts
+var import_pdf_lib3 = require("pdf-lib");
+async function mergePdfs(buffers, outputPath, storage) {
+  const merged = await import_pdf_lib3.PDFDocument.create();
+  for (const buf of buffers) {
+    const src = await import_pdf_lib3.PDFDocument.load(buf);
+    const pageIndices = src.getPageIndices();
+    const copiedPages = await merged.copyPages(src, pageIndices);
+    copiedPages.forEach((p) => merged.addPage(p));
+  }
+  const pdfBytes = await merged.save();
+  const pdfBuffer = Buffer.from(pdfBytes);
+  const url = await storage.upload(pdfBuffer, outputPath);
+  return { buffer: pdfBuffer, url, pageCount: merged.getPageCount() };
+}
+
+// src/transformer/splitPdf.ts
+var import_pdf_lib4 = require("pdf-lib");
+async function splitPdf(buffer, ranges, outputBasePath, storage) {
+  const src = await import_pdf_lib4.PDFDocument.load(buffer);
+  const results = [];
+  for (let i = 0; i < ranges.length; i++) {
+    const [start, end] = ranges[i];
+    const part = await import_pdf_lib4.PDFDocument.create();
+    const pageIndices = Array.from(
+      { length: end - start + 1 },
+      (_, idx) => start + idx
+    );
+    const copiedPages = await part.copyPages(src, pageIndices);
+    copiedPages.forEach((p) => part.addPage(p));
+    const pdfBytes = await part.save();
+    const pdfBuffer = Buffer.from(pdfBytes);
+    const outputPath = `${outputBasePath}/part-${i + 1}.pdf`;
+    const url = await storage.upload(pdfBuffer, outputPath);
+    results.push({ buffer: pdfBuffer, url, pageCount: part.getPageCount() });
+  }
+  return results;
+}
+
+// src/transformer/compressPdf.ts
+var import_pdf_lib5 = require("pdf-lib");
+async function compressPdf(buffer, outputPath, storage) {
+  const pdfDoc = await import_pdf_lib5.PDFDocument.load(buffer);
+  const pdfBytes = await pdfDoc.save({ useObjectStreams: true });
+  const pdfBuffer = Buffer.from(pdfBytes);
+  const url = await storage.upload(pdfBuffer, outputPath);
+  return { buffer: pdfBuffer, url, pageCount: pdfDoc.getPageCount() };
+}
+
+// src/assembler/PdfForge.ts
+var PdfForge = class {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  /**
+   * Assembles a press-ready PDF book from a list of CMYK image assets.
+   * Assets are downloaded from storage, assembled in order (respecting repeatCount),
+   * and the result is uploaded back to storage.
+   */
+  async buildBook(config) {
+    return buildBook(config, this.storage);
+  }
+  /**
+   * Downloads PDFs from storage, merges them into a single PDF,
+   * uploads the result to the last path's directory as 'merged.pdf',
+   * and returns the output.
+   */
+  async mergePdfs(paths, outputPath) {
+    const buffers = await Promise.all(paths.map((p) => this.storage.download(p)));
+    return mergePdfs(buffers, outputPath, this.storage);
+  }
+  /**
+   * Downloads a PDF from storage, splits it into page ranges,
+   * uploads each part, and returns an array of PdfOutputs.
+   */
+  async splitPdf(path, ranges, outputBasePath) {
+    const buffer = await this.storage.download(path);
+    return splitPdf(buffer, ranges, outputBasePath, this.storage);
+  }
+  /**
+   * Downloads a PDF, compresses it, uploads the result, and returns the output.
+   */
+  async compress(path, outputPath) {
+    const buffer = await this.storage.download(path);
+    return compressPdf(buffer, outputPath, this.storage);
+  }
+  /**
+   * Downloads an asset (image or PDF) and validates CMYK color space, DPI, and bleed.
+   */
+  async validate(path) {
+    const buffer = await this.storage.download(path);
+    return validateAsset(buffer);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PdfForge,
+  compressPdf,
+  mergePdfs,
+  splitPdf,
+  validateAsset
+});

package/dist/index.mjs

@@ -0,0 +1,265 @@
+import "./chunk-Y6FXYEAI.mjs";
+
+// src/assembler/buildBook.ts
+import { PDFDocument as PDFDocument2 } from "pdf-lib";
+
+// src/assembler/pageLayout.ts
+var BLEED_PT = 9;
+var TRIM_SIZES = {
+  "6x9": { width: 432, height: 648 },
+  "7x9": { width: 504, height: 648 },
+  "5x8": { width: 360, height: 576 },
+  "8.5x11": { width: 612, height: 792 }
+};
+function getPageDimensions(size, bleed) {
+  const trim = TRIM_SIZES[size];
+  const extra = bleed ? BLEED_PT * 2 : 0;
+  return {
+    width: trim.width + extra,
+    height: trim.height + extra,
+    bleedPt: bleed ? BLEED_PT : 0
+  };
+}
+
+// src/cmyk/embedCmyk.ts
+import { PDFName, PDFNumber, PDFOperator } from "pdf-lib";
+import sharp from "sharp";
+async function embedImage(pdfDoc, page, buffer, pageWidth, pageHeight) {
+  const meta = await sharp(buffer).metadata();
+  const width = meta.width;
+  const height = meta.height;
+  let imageBytes;
+  let colorSpace;
+  if (meta.format === "jpeg") {
+    imageBytes = buffer;
+    if (meta.channels === 4) colorSpace = "DeviceCMYK";
+    else if (meta.channels === 1) colorSpace = "DeviceGray";
+    else colorSpace = "DeviceRGB";
+  } else {
+    imageBytes = await sharp(buffer).jpeg({ quality: 90 }).toBuffer();
+    colorSpace = "DeviceRGB";
+  }
+  const context = pdfDoc.context;
+  const imageStream = context.stream(imageBytes, {
+    Type: "XObject",
+    Subtype: "Image",
+    Width: width,
+    Height: height,
+    ColorSpace: colorSpace,
+    BitsPerComponent: 8,
+    Filter: "DCTDecode",
+    Length: imageBytes.length
+  });
+  const imageRef = context.register(imageStream);
+  const imageName = PDFName.of(`Img${Date.now()}`);
+  const pageNode = page.node;
+  let resources = pageNode.get(PDFName.of("Resources"));
+  if (!resources) {
+    pageNode.set(PDFName.of("Resources"), context.obj({}));
+    resources = pageNode.get(PDFName.of("Resources"));
+  }
+  let xObject = resources.get(PDFName.of("XObject"));
+  if (!xObject) {
+    resources.set(PDFName.of("XObject"), context.obj({}));
+    xObject = resources.get(PDFName.of("XObject"));
+  }
+  xObject.set(imageName, imageRef);
+  const saveState = PDFOperator.of("q");
+  const transform = PDFOperator.of("cm", [
+    PDFNumber.of(pageWidth),
+    PDFNumber.of(0),
+    PDFNumber.of(0),
+    PDFNumber.of(pageHeight),
+    PDFNumber.of(0),
+    PDFNumber.of(0)
+  ]);
+  const drawImage = PDFOperator.of("Do", [imageName]);
+  const restoreState = PDFOperator.of("Q");
+  page.pushOperators(saveState, transform, drawImage, restoreState);
+}
+
+// src/assembler/buildBook.ts
+function expandAssets(assets) {
+  const expanded = [];
+  for (const asset of assets) {
+    const count = asset.repeatCount ?? 1;
+    for (let i = 0; i < count; i++) {
+      expanded.push({ ...asset, repeatCount: 1 });
+    }
+  }
+  return expanded;
+}
+async function buildBook(config, storage) {
+  const pdfDoc = await PDFDocument2.create();
+  const { width, height } = getPageDimensions(config.size, config.bleed);
+  const pages = expandAssets(config.assets);
+  for (const asset of pages) {
+    const buffer = await storage.download(asset.path);
+    const page = pdfDoc.addPage([width, height]);
+    await embedImage(pdfDoc, page, buffer, width, height);
+  }
+  const pdfBytes = await pdfDoc.save();
+  const pdfBuffer = Buffer.from(pdfBytes);
+  const url = await storage.upload(pdfBuffer, config.outputPath);
+  return {
+    buffer: pdfBuffer,
+    url,
+    pageCount: pdfDoc.getPageCount()
+  };
+}
+
+// src/validator/validateAsset.ts
+import sharp2 from "sharp";
+var MIN_DPI = 300;
+function mapColorSpace(space) {
+  if (!space) return "unknown";
+  if (space === "cmyk") return "CMYK";
+  if (space === "srgb" || space === "rgb") return "RGB";
+  return "unknown";
+}
+async function validateAsset(buffer) {
+  const meta = await sharp2(buffer).metadata();
+  const warnings = [];
+  const colorSpace = mapColorSpace(meta.space);
+  const dpi = meta.density ?? 0;
+  const width = meta.width ?? 0;
+  const height = meta.height ?? 0;
+  if (colorSpace !== "CMYK") {
+    warnings.push(`Color space is ${colorSpace}, expected CMYK. This file may not print correctly.`);
+  }
+  if (dpi < MIN_DPI) {
+    warnings.push(`DPI is ${dpi}, minimum recommended is ${MIN_DPI} for print.`);
+  }
+  const hasBleed = width > 0 && height > 0 ? checkHasBleed(width, height, dpi) : false;
+  if (!hasBleed) {
+    warnings.push("Image does not appear to include a bleed margin (0.125 inch). Consider adding bleed for press-ready output.");
+  }
+  return {
+    valid: warnings.length === 0,
+    colorSpace,
+    dpi,
+    hasBleed,
+    warnings
+  };
+}
+function checkHasBleed(width, height, dpi) {
+  if (dpi === 0) return false;
+  const bleedPx = Math.round(0.125 / 1 * dpi);
+  const trimSizes = [
+    { w: 6, h: 9 },
+    { w: 5, h: 8 },
+    { w: 8.5, h: 11 }
+  ];
+  for (const trim of trimSizes) {
+    const trimW = Math.round(trim.w * dpi);
+    const trimH = Math.round(trim.h * dpi);
+    const expectedW = trimW + bleedPx * 2;
+    const expectedH = trimH + bleedPx * 2;
+    const withinW = Math.abs(width - expectedW) <= expectedW * 0.05;
+    const withinH = Math.abs(height - expectedH) <= expectedH * 0.05;
+    if (withinW && withinH) return true;
+  }
+  return false;
+}
+
+// src/transformer/mergePdfs.ts
+import { PDFDocument as PDFDocument3 } from "pdf-lib";
+async function mergePdfs(buffers, outputPath, storage) {
+  const merged = await PDFDocument3.create();
+  for (const buf of buffers) {
+    const src = await PDFDocument3.load(buf);
+    const pageIndices = src.getPageIndices();
+    const copiedPages = await merged.copyPages(src, pageIndices);
+    copiedPages.forEach((p) => merged.addPage(p));
+  }
+  const pdfBytes = await merged.save();
+  const pdfBuffer = Buffer.from(pdfBytes);
+  const url = await storage.upload(pdfBuffer, outputPath);
+  return { buffer: pdfBuffer, url, pageCount: merged.getPageCount() };
+}
+
+// src/transformer/splitPdf.ts
+import { PDFDocument as PDFDocument4 } from "pdf-lib";
+async function splitPdf(buffer, ranges, outputBasePath, storage) {
+  const src = await PDFDocument4.load(buffer);
+  const results = [];
+  for (let i = 0; i < ranges.length; i++) {
+    const [start, end] = ranges[i];
+    const part = await PDFDocument4.create();
+    const pageIndices = Array.from(
+      { length: end - start + 1 },
+      (_, idx) => start + idx
+    );
+    const copiedPages = await part.copyPages(src, pageIndices);
+    copiedPages.forEach((p) => part.addPage(p));
+    const pdfBytes = await part.save();
+    const pdfBuffer = Buffer.from(pdfBytes);
+    const outputPath = `${outputBasePath}/part-${i + 1}.pdf`;
+    const url = await storage.upload(pdfBuffer, outputPath);
+    results.push({ buffer: pdfBuffer, url, pageCount: part.getPageCount() });
+  }
+  return results;
+}
+
+// src/transformer/compressPdf.ts
+import { PDFDocument as PDFDocument5 } from "pdf-lib";
+async function compressPdf(buffer, outputPath, storage) {
+  const pdfDoc = await PDFDocument5.load(buffer);
+  const pdfBytes = await pdfDoc.save({ useObjectStreams: true });
+  const pdfBuffer = Buffer.from(pdfBytes);
+  const url = await storage.upload(pdfBuffer, outputPath);
+  return { buffer: pdfBuffer, url, pageCount: pdfDoc.getPageCount() };
+}
+
+// src/assembler/PdfForge.ts
+var PdfForge = class {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  /**
+   * Assembles a press-ready PDF book from a list of CMYK image assets.
+   * Assets are downloaded from storage, assembled in order (respecting repeatCount),
+   * and the result is uploaded back to storage.
+   */
+  async buildBook(config) {
+    return buildBook(config, this.storage);
+  }
+  /**
+   * Downloads PDFs from storage, merges them into a single PDF,
+   * uploads the result to the last path's directory as 'merged.pdf',
+   * and returns the output.
+   */
+  async mergePdfs(paths, outputPath) {
+    const buffers = await Promise.all(paths.map((p) => this.storage.download(p)));
+    return mergePdfs(buffers, outputPath, this.storage);
+  }
+  /**
+   * Downloads a PDF from storage, splits it into page ranges,
+   * uploads each part, and returns an array of PdfOutputs.
+   */
+  async splitPdf(path, ranges, outputBasePath) {
+    const buffer = await this.storage.download(path);
+    return splitPdf(buffer, ranges, outputBasePath, this.storage);
+  }
+  /**
+   * Downloads a PDF, compresses it, uploads the result, and returns the output.
+   */
+  async compress(path, outputPath) {
+    const buffer = await this.storage.download(path);
+    return compressPdf(buffer, outputPath, this.storage);
+  }
+  /**
+   * Downloads an asset (image or PDF) and validates CMYK color space, DPI, and bleed.
+   */
+  async validate(path) {
+    const buffer = await this.storage.download(path);
+    return validateAsset(buffer);
+  }
+};
+export {
+  PdfForge,
+  compressPdf,
+  mergePdfs,
+  splitPdf,
+  validateAsset
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "gwan-pdf-engine",
+  "version": "0.1.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Press-ready CMYK PDF assembly library for planners, journals, and print products",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./adapters/gcp": {
+      "import": "./dist/adapters/storage/gcp.js",
+      "require": "./dist/adapters/storage/gcp.cjs"
+    },
+    "./adapters/local": {
+      "import": "./dist/adapters/storage/local.js",
+      "require": "./dist/adapters/storage/local.cjs"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts src/adapters/storage/gcp.ts src/adapters/storage/local.ts --format cjs,esm --dts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "tsup --watch"
+  },
+  "keywords": ["pdf", "cmyk", "print", "planner", "journal"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "pdf-lib": "^1.17.1",
+    "sharp": "^0.34.5"
+  },
+  "optionalDependencies": {
+    "@google-cloud/storage": "^5.18.3"
+  },
+  "peerDependencies": {
+    "@google-cloud/storage": ">=5.18.3"
+  },
+  "peerDependenciesMeta": {
+    "@google-cloud/storage": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^3.2.4"
+  }
+}