@pixzle/core 0.0.19 → 0.0.21

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+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;
+    /** Manifest data object (alternative to manifestPath) */
+    manifestData?: ManifestData;
+    /** Output directory (e.g., "./output/restored") */
+    outputDir: string;
+}
+export interface FragmentationConfig {
+    /**
+     * Pixel block size (e.g., 10x10 to 10)
+     * Smaller -> High Obfuscation / Larger -> High Performance
+     */
+    blockSize?: number;
+    /** Prefix for fragment files (optional, default: "img") */
+    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;
+    /** 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[];
+}

package/dist/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/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/validators.cjs

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFragmentImageCount = validateFragmentImageCount;
+exports.validateFileNames = validateFileNames;
+const helpers_1 = require("./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
+ */
+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
+ */
+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 = (0, helpers_1.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/validators.d.cts

@@ -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/validators.d.ts

@@ -0,0 +1,15 @@
+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;

package/dist/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/validators.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFragmentImageCount = validateFragmentImageCount;
+exports.validateFileNames = validateFileNames;
+const helpers_1 = require("./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
+ */
+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
+ */
+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 = (0, helpers_1.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/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":";;AAUA,gEAYC;AAQD,8CA0BC;AAvDD,uCAA2C;AAG3C;;;;;GAKG;AACH,SAAgB,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,SAAgB,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,IAAA,wBAAc,EAAC,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,23 +1,9 @@
 {
   "name": "@pixzle/core",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "Core image fragmentation and restoration logic",
-  "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"
-      }
-    }
-  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
     "dist"
   ],
@@ -41,10 +27,9 @@
     "vitest": "^3.1.4"
   },
   "scripts": {
-    "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": "tsc -p tsconfig.build.json",
     "build:check": "tsc -p tsconfig.build.json --noEmit",
-    "test": "vitest"
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }