@pixzle/core 0.0.13 → 0.0.15

package/dist/esm/helpers.js

@@ -0,0 +1,93 @@
+/**
+ * Encode file name to base64 for safe storage (cross-platform)
+ * @param name - Original file name
+ * @returns Base64 encoded file name
+ */
+export function encodeFileName(name) {
+    // Use TextEncoder for UTF-8 encoding (available in both browser and Node.js)
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(name);
+    // Convert bytes to binary string for btoa (cross-platform)
+    // Use loop to avoid stack overflow with large arrays
+    let binaryString = "";
+    for (let i = 0; i < bytes.length; i++) {
+        const byte = bytes[i];
+        binaryString += String.fromCharCode(byte);
+    }
+    return btoa(binaryString);
+}
+/**
+ * Decode file name from base64 (cross-platform)
+ * @param encodedName - Base64 encoded file name
+ * @returns Decoded original file name
+ */
+export function decodeFileName(encodedName) {
+    // Use atob for base64 decoding (cross-platform)
+    const binaryString = atob(encodedName);
+    // Convert binary string to bytes
+    const bytes = Uint8Array.from(binaryString, (c) => c.charCodeAt(0));
+    // Use TextDecoder for UTF-8 decoding (available in both browser and Node.js)
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+/**
+ * Generate a file name with prefix, 1-based zero-padded index, and extension
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @param options - Options for the file name
+ * @param options.isFragmented - Whether the fragment is fragmented
+ * @returns File name (e.g., img_1.png.enc)
+ */
+export function generateFileName(manifest, index, options = {
+    isFragmented: false,
+}) {
+    const prefix = manifest.config.prefix;
+    const totalLength = manifest.images.length;
+    const extension = "png";
+    const numDigits = String(totalLength).length;
+    const paddedIndex = String(index + 1).padStart(numDigits, "0");
+    const filenameSuffix = options.isFragmented ? "_fragmented" : "";
+    const filename = `${prefix}_${paddedIndex}${filenameSuffix}`;
+    return `${filename}.${extension}`;
+}
+/**
+ * Generate a fragment file name
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @returns Fragment file name (e.g., img_1_fragmented.png)
+ */
+export function generateFragmentFileName(manifest, index) {
+    return generateFileName(manifest, index, {
+        isFragmented: true,
+    });
+}
+/**
+ * Generate a restored file name
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @returns Restored file name (e.g., img_1.png)
+ */
+export function generateRestoredFileName(manifest, index) {
+    return generateFileName(manifest, index, {
+        isFragmented: false,
+    });
+}
+/**
+ * Generate a restored original file name
+ * @param imageInfo - Image information
+ * @returns Restored original file name
+ */
+export function generateRestoredOriginalFileName(imageInfo) {
+    if (!imageInfo.name) {
+        return undefined;
+    }
+    try {
+        const decodedName = decodeFileName(imageInfo.name);
+        return decodedName ? `${decodedName}.png` : undefined;
+    }
+    catch {
+        // Fallback: if decoding fails, treat as already decoded (backward compatibility)
+        return `${imageInfo.name}.png`;
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/esm/helpers.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types";
+export * from "./constants";
+export * from "./helpers";
+export * from "./block-utils";
+export * from "./block-operations";
+export * from "./validators";
+export { DEFAULT_FRAGMENTATION_CONFIG } from "./constants";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,9 @@
+export * from "./types";
+export * from "./constants";
+export * from "./helpers";
+export * from "./block-utils";
+export * from "./block-operations";
+export * from "./validators";
+// Re-export constants with old name for backward compatibility
+export { DEFAULT_FRAGMENTATION_CONFIG } from "./constants";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B,+DAA+D;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/types.d.ts

@@ -0,0 +1,65 @@
+export interface ShuffleOptions {
+    /** Image paths (e.g., ["image1.png", "image2.png"]) */
+    imagePaths: string[];
+    /** Fragmentation config */
+    config?: FragmentationConfig;
+    /** Output directory (e.g., "./output/fragments") */
+    outputDir: string;
+}
+export interface RestoreOptions {
+    /** Image paths (e.g., ["fragment1.png", "fragment2.png"]) */
+    imagePaths: string[];
+    /** Manifest path (e.g., "./output/fragments/manifest.json") */
+    manifestPath: string;
+    /** Output directory (e.g., "./output/restored") */
+    outputDir: string;
+}
+export interface FragmentationConfig {
+    /** Pixel block size (e.g., 10x10 to 10) */
+    blockSize?: number;
+    /** Prefix for fragment files (optional, default: "fragment") */
+    prefix?: string;
+    /** Random seed (auto-generated if not specified) */
+    seed?: number | string;
+    /** Preserve original file name (optional, default: false) */
+    preserveName?: boolean;
+    /** Shuffle blocks across all images instead of within each image independently (optional, default: false) */
+    crossImageShuffle?: boolean;
+}
+/**
+ * Information about the image before fragmentation.
+ * This includes dimensions, channels, and block counts.
+ */
+export interface ImageInfo {
+    /** Width */
+    w: number;
+    /** Height */
+    h: number;
+    /** Number of channels */
+    c: number;
+    /** Number of blocks X */
+    x: number;
+    /** Number of blocks Y */
+    y: number;
+    /** Original file name in base64 encoding (optional) */
+    name?: string;
+}
+export interface ManifestData {
+    /** UUID */
+    id: string;
+    /** Version */
+    version: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Config */
+    config: Required<FragmentationConfig>;
+    /** Image information */
+    images: ImageInfo[];
+}
+export interface FragmentationResult {
+    /** Manifest data */
+    manifest: ManifestData;
+    /** Fragmented images */
+    fragmentedImages: Buffer[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6GAA6G;IAC7G,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACtC,wBAAwB;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/esm/validators.d.ts

@@ -0,0 +1,16 @@
+import type { ImageInfo, ManifestData } from "./types";
+/**
+ * Validates that the number of fragment images matches the number of images in the manifest
+ * @param fragmentImages - Array of fragment images (file paths or buffers)
+ * @param manifest - The manifest data containing image information
+ * @throws {Error} When the counts don't match
+ */
+export declare function validateFragmentImageCount(fragmentImages: (string | Buffer)[], manifest: ManifestData): void;
+/**
+ * Validates that there are no duplicate file names in the image infos
+ * @param imageInfos - Array of image information objects
+ * @param preserveName - Whether name preservation is enabled
+ * @throws {Error} When duplicate file names are detected
+ */
+export declare function validateFileNames(imageInfos: ImageInfo[], preserveName: boolean): void;
+//# sourceMappingURL=validators.d.ts.map

package/dist/esm/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACnC,QAAQ,EAAE,YAAY,GACrB,IAAI,CASN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,EAAE,EACvB,YAAY,EAAE,OAAO,GACpB,IAAI,CAuBN"}

package/dist/esm/validators.js

@@ -0,0 +1,44 @@
+import { decodeFileName } from "./helpers";
+/**
+ * Validates that the number of fragment images matches the number of images in the manifest
+ * @param fragmentImages - Array of fragment images (file paths or buffers)
+ * @param manifest - The manifest data containing image information
+ * @throws {Error} When the counts don't match
+ */
+export function validateFragmentImageCount(fragmentImages, manifest) {
+    const manifestImageCount = manifest.images.length;
+    const fragmentImageCount = fragmentImages.length;
+    if (manifestImageCount !== fragmentImageCount) {
+        throw new Error(`Fragment image count mismatch: expected ${manifestImageCount} but got ${fragmentImageCount}`);
+    }
+}
+/**
+ * Validates that there are no duplicate file names in the image infos
+ * @param imageInfos - Array of image information objects
+ * @param preserveName - Whether name preservation is enabled
+ * @throws {Error} When duplicate file names are detected
+ */
+export function validateFileNames(imageInfos, preserveName) {
+    if (!preserveName || imageInfos.length <= 1) {
+        return;
+    }
+    const nameSet = new Set();
+    for (const info of imageInfos) {
+        if (info.name !== undefined) {
+            // Decode base64 to get original name for comparison
+            let decodedName;
+            try {
+                decodedName = decodeFileName(info.name);
+            }
+            catch {
+                // If decoding fails, treat as already decoded (backward compatibility)
+                decodedName = info.name;
+            }
+            if (nameSet.has(decodedName)) {
+                throw new Error(`Duplicate file name detected: ${decodedName}`);
+            }
+            nameSet.add(decodedName);
+        }
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/esm/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,cAAmC,EACnC,QAAsB;IAEtB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAClD,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC;IAEjD,IAAI,kBAAkB,KAAK,kBAAkB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,2CAA2C,kBAAkB,YAAY,kBAAkB,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAuB,EACvB,YAAqB;IAErB,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,oDAAoD;YACpD,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,uEAAuE;gBACvE,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;YAC1B,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,9 +1,23 @@
 {
   "name": "@pixzle/core",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Core image fragmentation and restoration logic",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
   "files": [
     "dist"
   ],
@@ -27,7 +41,9 @@
     "vitest": "^3.1.4"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "pnpm run build:esm && pnpm run build:cjs",
+    "build:esm": "tsc -p tsconfig.build.json --outDir dist/esm --module ES2022 --moduleResolution bundler",
+    "build:cjs": "tsc -p tsconfig.build.json --outDir dist/cjs --module CommonJS --moduleResolution node && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
     "build:check": "tsc -p tsconfig.build.json --noEmit",
     "test": "vitest"
   }