@utilix-tech/sdk 0.5.0 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**523 developer utility functions for Node.js: runs locally, no API key required.**
+**524 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -416,10 +416,10 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
-### `/media`: Image Header Parsing & PDF Metadata
+### `/media`: Image Header Parsing, EXIF & PDF Metadata
 
 ```ts
-import { readImageInfo, readPdfMetadata } from "@utilix-tech/sdk/media";
+import { readImageInfo, readExifData, readPdfMetadata } from "@utilix-tech/sdk/media";
 
 // Reads format, dimensions, bit depth, and alpha channel straight from
 // file bytes: no decoding, no canvas, no image library.
@@ -427,6 +427,12 @@ const bytes = await fs.promises.readFile("photo.png");
 readImageInfo(new Uint8Array(bytes));
 // { format: "png", width: 1920, height: 1080, bitDepth: 8, colorType: "rgba", hasAlpha: true }
 
+// Reads camera make/model, orientation, timestamps, exposure settings, and
+// GPS coordinates directly from a JPEG's EXIF data. JPEG only.
+const jpegBytes = await fs.promises.readFile("photo.jpg");
+readExifData(new Uint8Array(jpegBytes));
+// { make: "Canon", model: "EOS R5", orientation: 1, exposureTime: "1/125", fNumber: 2.8, ... }
+
 // Reads title, author, dates, page count, and encryption flag from a PDF's
 // trailer/Info dictionary: no pdf.js or other PDF library required.
 const pdfBytes = await fs.promises.readFile("report.pdf");
@@ -434,7 +440,7 @@ readPdfMetadata(new Uint8Array(pdfBytes));
 // { version: "1.7", pageCount: 12, title: "Q3 Report", author: "Jane Doe", ... }
 ```
 
-Supports PNG, JPEG, GIF, WebP, and BMP.
+`readImageInfo` supports PNG, JPEG, GIF, WebP, and BMP. `readExifData` supports JPEG only.
 
 ---
 

package/dist/{chunk-WWKPLYEP.js → chunk-FXBB7O5A.js}

@@ -3,6 +3,7 @@ import { __export } from './chunk-MLKGABMK.js';
 // src/tools/media.ts
 var media_exports = {};
 __export(media_exports, {
+  readExifData: () => readExifData,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata
 });
@@ -131,6 +132,195 @@ function readImageInfo(bytes) {
   }
   return { error: "Unrecognized image format. Supported formats: PNG, JPEG, GIF, WebP, BMP" };
 }
+var ORIENTATION_LABELS = {
+  1: "Normal",
+  2: "Mirrored horizontal",
+  3: "Rotated 180\xB0",
+  4: "Mirrored vertical",
+  5: "Mirrored horizontal, rotated 90\xB0 CCW",
+  6: "Rotated 90\xB0 CW",
+  7: "Mirrored horizontal, rotated 90\xB0 CW",
+  8: "Rotated 90\xB0 CCW"
+};
+function tu16(r, o) {
+  return r.view.getUint16(o, r.little);
+}
+function tu32(r, o) {
+  return r.view.getUint32(o, r.little);
+}
+function readIfdEntries(r, ifdOffset) {
+  if (ifdOffset < 0 || ifdOffset + 2 > r.bytes.length) return null;
+  const numEntries = tu16(r, ifdOffset);
+  const entries = [];
+  for (let i = 0; i < numEntries; i++) {
+    const entryOffset = ifdOffset + 2 + i * 12;
+    if (entryOffset + 12 > r.bytes.length) break;
+    entries.push({
+      tag: tu16(r, entryOffset),
+      type: tu16(r, entryOffset + 2),
+      count: tu32(r, entryOffset + 4),
+      valueOffsetField: entryOffset + 8
+    });
+  }
+  return { entries };
+}
+function findEntry(entries, tag) {
+  return entries.find((e) => e.tag === tag);
+}
+function readAscii(r, entry) {
+  const size = entry.count;
+  const inline = size <= 4;
+  const dataOffset = inline ? entry.valueOffsetField : r.tiffStart + tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + size > r.bytes.length) return null;
+  let out = "";
+  for (let i = 0; i < size; i++) {
+    const c = r.bytes[dataOffset + i];
+    if (c === 0) break;
+    out += String.fromCharCode(c);
+  }
+  const trimmed = out.trim();
+  return trimmed || null;
+}
+function readRational(r, entry) {
+  const dataOffset = r.tiffStart + tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 8 > r.bytes.length) return null;
+  return { num: tu32(r, dataOffset), den: tu32(r, dataOffset + 4) };
+}
+function readGpsCoordinate(r, entries, valueTag, refTag) {
+  const valueEntry = findEntry(entries, valueTag);
+  if (!valueEntry) return null;
+  const dataOffset = r.tiffStart + tu32(r, valueEntry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 24 > r.bytes.length) return null;
+  const deg = tu32(r, dataOffset) / (tu32(r, dataOffset + 4) || 1);
+  const min = tu32(r, dataOffset + 8) / (tu32(r, dataOffset + 12) || 1);
+  const sec = tu32(r, dataOffset + 16) / (tu32(r, dataOffset + 20) || 1);
+  let decimal = deg + min / 60 + sec / 3600;
+  const refEntry = findEntry(entries, refTag);
+  const ref = refEntry ? readAscii(r, refEntry) : null;
+  if (ref === "S" || ref === "W") decimal = -decimal;
+  return Math.round(decimal * 1e6) / 1e6;
+}
+function gcd(a, b) {
+  return b === 0 ? a : gcd(b, a % b);
+}
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function formatExposureTime(num, den) {
+  if (num === 0) return "0s";
+  if (num >= den) return `${round2(num / den)}s`;
+  const divisor = gcd(num, den) || 1;
+  const n = num / divisor;
+  const d = den / divisor;
+  return `1/${Math.round(d / n)}`;
+}
+function readExifData(bytes) {
+  if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) {
+    return { error: "Not a JPEG file (EXIF is only read from JPEG files)" };
+  }
+  let offset = 2;
+  let exifStart = -1;
+  while (offset + 4 <= bytes.length) {
+    if (bytes[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = bytes[offset + 1];
+    if (marker === 216 || marker === 1 || marker >= 208 && marker <= 215) {
+      offset += 2;
+      continue;
+    }
+    if (marker === 217 || marker === 218) break;
+    const segmentLength = bytes[offset + 2] << 8 | bytes[offset + 3];
+    if (marker === 225) {
+      const idOffset = offset + 4;
+      if (idOffset + 6 <= bytes.length && bytes[idOffset] === 69 && bytes[idOffset + 1] === 120 && bytes[idOffset + 2] === 105 && bytes[idOffset + 3] === 102 && bytes[idOffset + 4] === 0 && bytes[idOffset + 5] === 0) {
+        exifStart = idOffset + 6;
+        break;
+      }
+    }
+    offset += 2 + segmentLength;
+  }
+  if (exifStart === -1) return { error: "No EXIF segment found in this JPEG" };
+  if (exifStart + 8 > bytes.length) return { error: "Truncated EXIF segment" };
+  const byteOrder = String.fromCharCode(bytes[exifStart], bytes[exifStart + 1]);
+  if (byteOrder !== "II" && byteOrder !== "MM") return { error: "Invalid TIFF byte order marker in EXIF data" };
+  const little = byteOrder === "II";
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const r = { bytes, view, little, tiffStart: exifStart };
+  if (tu16(r, exifStart + 2) !== 42) return { error: "Invalid TIFF magic number in EXIF data" };
+  const ifd0Offset = exifStart + tu32(r, exifStart + 4);
+  const ifd0 = readIfdEntries(r, ifd0Offset);
+  if (!ifd0) return { error: "Could not read IFD0 from EXIF data" };
+  const result = { tagCount: ifd0.entries.length };
+  const makeEntry = findEntry(ifd0.entries, 271);
+  if (makeEntry) {
+    const v = readAscii(r, makeEntry);
+    if (v) result.make = v;
+  }
+  const modelEntry = findEntry(ifd0.entries, 272);
+  if (modelEntry) {
+    const v = readAscii(r, modelEntry);
+    if (v) result.model = v;
+  }
+  const softwareEntry = findEntry(ifd0.entries, 305);
+  if (softwareEntry) {
+    const v = readAscii(r, softwareEntry);
+    if (v) result.software = v;
+  }
+  const dateTimeEntry = findEntry(ifd0.entries, 306);
+  if (dateTimeEntry) {
+    const v = readAscii(r, dateTimeEntry);
+    if (v) result.dateTime = v;
+  }
+  const orientEntry = findEntry(ifd0.entries, 274);
+  if (orientEntry) {
+    const v = tu16(r, orientEntry.valueOffsetField);
+    result.orientation = v;
+    result.orientationLabel = ORIENTATION_LABELS[v] ?? "Unknown";
+  }
+  const exifIfdPtr = findEntry(ifd0.entries, 34665);
+  if (exifIfdPtr) {
+    const subOffset = exifStart + tu32(r, exifIfdPtr.valueOffsetField);
+    const sub = readIfdEntries(r, subOffset);
+    if (sub) {
+      const dtoEntry = findEntry(sub.entries, 36867);
+      if (dtoEntry) {
+        const v = readAscii(r, dtoEntry);
+        if (v) result.dateTimeOriginal = v;
+      }
+      const expEntry = findEntry(sub.entries, 33434);
+      if (expEntry) {
+        const rat = readRational(r, expEntry);
+        if (rat && rat.den !== 0) result.exposureTime = formatExposureTime(rat.num, rat.den);
+      }
+      const fEntry = findEntry(sub.entries, 33437);
+      if (fEntry) {
+        const rat = readRational(r, fEntry);
+        if (rat && rat.den !== 0) result.fNumber = round2(rat.num / rat.den);
+      }
+      const isoEntry = findEntry(sub.entries, 34855);
+      if (isoEntry) result.isoSpeed = tu16(r, isoEntry.valueOffsetField);
+      const focalEntry = findEntry(sub.entries, 37386);
+      if (focalEntry) {
+        const rat = readRational(r, focalEntry);
+        if (rat && rat.den !== 0) result.focalLength = round2(rat.num / rat.den);
+      }
+    }
+  }
+  const gpsIfdPtr = findEntry(ifd0.entries, 34853);
+  if (gpsIfdPtr) {
+    const gpsOffset = exifStart + tu32(r, gpsIfdPtr.valueOffsetField);
+    const gps = readIfdEntries(r, gpsOffset);
+    if (gps) {
+      const lat = readGpsCoordinate(r, gps.entries, 2, 1);
+      const lon = readGpsCoordinate(r, gps.entries, 4, 3);
+      if (lat !== null) result.gpsLatitude = lat;
+      if (lon !== null) result.gpsLongitude = lon;
+    }
+  }
+  return result;
+}
 function bytesToLatin1(bytes) {
   let out = "";
   const CHUNK = 32768;
@@ -274,4 +464,4 @@ function readPdfMetadata(bytes) {
   };
 }
 
-export { media_exports, readImageInfo, readPdfMetadata };
+export { media_exports, readExifData, readImageInfo, readPdfMetadata };

package/dist/{chunk-FL53T24A.js → chunk-GEFVMGZR.js}

@@ -189,13 +189,7 @@ function generateMd5Hash(password) {
   return "$apr1$" + md5(password);
 }
 function generateBcryptHash(password, rounds = 10) {
-  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789./";
-  let salt = "";
-  for (let i = 0; i < 22; i++) salt += chars[Math.floor(Math.random() * chars.length)];
-  const roundStr = rounds.toString().padStart(2, "0");
-  let hash = "";
-  for (let i = 0; i < 31; i++) hash += chars[Math.floor(Math.random() * chars.length)];
-  return `$2b$${roundStr}$${salt}${hash}`;
+  return bcrypt.hashSync(password, rounds);
 }
 function generatePlain(password) {
   return password;
@@ -204,7 +198,7 @@ function createEntry(username, password, algorithm = "bcrypt") {
   let hashedPassword;
   switch (algorithm) {
     case "bcrypt":
-      hashedPassword = generateBcryptHash();
+      hashedPassword = generateBcryptHash(password);
       break;
     case "sha1":
       hashedPassword = generateSha1Hash(password);

package/dist/index.cjs

@@ -1736,13 +1736,7 @@ function generateMd5Hash(password) {
   return "$apr1$" + md5__default.default(password);
 }
 function generateBcryptHash(password, rounds = 10) {
-  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789./";
-  let salt = "";
-  for (let i = 0; i < 22; i++) salt += chars[Math.floor(Math.random() * chars.length)];
-  const roundStr = rounds.toString().padStart(2, "0");
-  let hash = "";
-  for (let i = 0; i < 31; i++) hash += chars[Math.floor(Math.random() * chars.length)];
-  return `$2b$${roundStr}$${salt}${hash}`;
+  return bcrypt__default.default.hashSync(password, rounds);
 }
 function generatePlain(password) {
   return password;
@@ -1751,7 +1745,7 @@ function createEntry(username, password, algorithm = "bcrypt") {
   let hashedPassword;
   switch (algorithm) {
     case "bcrypt":
-      hashedPassword = generateBcryptHash();
+      hashedPassword = generateBcryptHash(password);
       break;
     case "sha1":
       hashedPassword = generateSha1Hash(password);
@@ -16934,6 +16928,7 @@ function summarizeForLlm(text, maxTokens = 200, strategy = "extractive") {
 // src/tools/media.ts
 var media_exports = {};
 __export(media_exports, {
+  readExifData: () => readExifData,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata
 });
@@ -17062,6 +17057,195 @@ function readImageInfo(bytes) {
   }
   return { error: "Unrecognized image format. Supported formats: PNG, JPEG, GIF, WebP, BMP" };
 }
+var ORIENTATION_LABELS = {
+  1: "Normal",
+  2: "Mirrored horizontal",
+  3: "Rotated 180\xB0",
+  4: "Mirrored vertical",
+  5: "Mirrored horizontal, rotated 90\xB0 CCW",
+  6: "Rotated 90\xB0 CW",
+  7: "Mirrored horizontal, rotated 90\xB0 CW",
+  8: "Rotated 90\xB0 CCW"
+};
+function tu16(r, o) {
+  return r.view.getUint16(o, r.little);
+}
+function tu32(r, o) {
+  return r.view.getUint32(o, r.little);
+}
+function readIfdEntries(r, ifdOffset) {
+  if (ifdOffset < 0 || ifdOffset + 2 > r.bytes.length) return null;
+  const numEntries = tu16(r, ifdOffset);
+  const entries = [];
+  for (let i = 0; i < numEntries; i++) {
+    const entryOffset = ifdOffset + 2 + i * 12;
+    if (entryOffset + 12 > r.bytes.length) break;
+    entries.push({
+      tag: tu16(r, entryOffset),
+      type: tu16(r, entryOffset + 2),
+      count: tu32(r, entryOffset + 4),
+      valueOffsetField: entryOffset + 8
+    });
+  }
+  return { entries };
+}
+function findEntry(entries, tag) {
+  return entries.find((e) => e.tag === tag);
+}
+function readAscii(r, entry) {
+  const size = entry.count;
+  const inline = size <= 4;
+  const dataOffset = inline ? entry.valueOffsetField : r.tiffStart + tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + size > r.bytes.length) return null;
+  let out = "";
+  for (let i = 0; i < size; i++) {
+    const c = r.bytes[dataOffset + i];
+    if (c === 0) break;
+    out += String.fromCharCode(c);
+  }
+  const trimmed = out.trim();
+  return trimmed || null;
+}
+function readRational(r, entry) {
+  const dataOffset = r.tiffStart + tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 8 > r.bytes.length) return null;
+  return { num: tu32(r, dataOffset), den: tu32(r, dataOffset + 4) };
+}
+function readGpsCoordinate(r, entries, valueTag, refTag) {
+  const valueEntry = findEntry(entries, valueTag);
+  if (!valueEntry) return null;
+  const dataOffset = r.tiffStart + tu32(r, valueEntry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 24 > r.bytes.length) return null;
+  const deg = tu32(r, dataOffset) / (tu32(r, dataOffset + 4) || 1);
+  const min = tu32(r, dataOffset + 8) / (tu32(r, dataOffset + 12) || 1);
+  const sec = tu32(r, dataOffset + 16) / (tu32(r, dataOffset + 20) || 1);
+  let decimal = deg + min / 60 + sec / 3600;
+  const refEntry = findEntry(entries, refTag);
+  const ref = refEntry ? readAscii(r, refEntry) : null;
+  if (ref === "S" || ref === "W") decimal = -decimal;
+  return Math.round(decimal * 1e6) / 1e6;
+}
+function gcd2(a, b) {
+  return b === 0 ? a : gcd2(b, a % b);
+}
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function formatExposureTime(num, den) {
+  if (num === 0) return "0s";
+  if (num >= den) return `${round2(num / den)}s`;
+  const divisor = gcd2(num, den) || 1;
+  const n = num / divisor;
+  const d = den / divisor;
+  return `1/${Math.round(d / n)}`;
+}
+function readExifData(bytes) {
+  if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) {
+    return { error: "Not a JPEG file (EXIF is only read from JPEG files)" };
+  }
+  let offset = 2;
+  let exifStart = -1;
+  while (offset + 4 <= bytes.length) {
+    if (bytes[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = bytes[offset + 1];
+    if (marker === 216 || marker === 1 || marker >= 208 && marker <= 215) {
+      offset += 2;
+      continue;
+    }
+    if (marker === 217 || marker === 218) break;
+    const segmentLength = bytes[offset + 2] << 8 | bytes[offset + 3];
+    if (marker === 225) {
+      const idOffset = offset + 4;
+      if (idOffset + 6 <= bytes.length && bytes[idOffset] === 69 && bytes[idOffset + 1] === 120 && bytes[idOffset + 2] === 105 && bytes[idOffset + 3] === 102 && bytes[idOffset + 4] === 0 && bytes[idOffset + 5] === 0) {
+        exifStart = idOffset + 6;
+        break;
+      }
+    }
+    offset += 2 + segmentLength;
+  }
+  if (exifStart === -1) return { error: "No EXIF segment found in this JPEG" };
+  if (exifStart + 8 > bytes.length) return { error: "Truncated EXIF segment" };
+  const byteOrder = String.fromCharCode(bytes[exifStart], bytes[exifStart + 1]);
+  if (byteOrder !== "II" && byteOrder !== "MM") return { error: "Invalid TIFF byte order marker in EXIF data" };
+  const little = byteOrder === "II";
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const r = { bytes, view, little, tiffStart: exifStart };
+  if (tu16(r, exifStart + 2) !== 42) return { error: "Invalid TIFF magic number in EXIF data" };
+  const ifd0Offset = exifStart + tu32(r, exifStart + 4);
+  const ifd0 = readIfdEntries(r, ifd0Offset);
+  if (!ifd0) return { error: "Could not read IFD0 from EXIF data" };
+  const result = { tagCount: ifd0.entries.length };
+  const makeEntry = findEntry(ifd0.entries, 271);
+  if (makeEntry) {
+    const v = readAscii(r, makeEntry);
+    if (v) result.make = v;
+  }
+  const modelEntry = findEntry(ifd0.entries, 272);
+  if (modelEntry) {
+    const v = readAscii(r, modelEntry);
+    if (v) result.model = v;
+  }
+  const softwareEntry = findEntry(ifd0.entries, 305);
+  if (softwareEntry) {
+    const v = readAscii(r, softwareEntry);
+    if (v) result.software = v;
+  }
+  const dateTimeEntry = findEntry(ifd0.entries, 306);
+  if (dateTimeEntry) {
+    const v = readAscii(r, dateTimeEntry);
+    if (v) result.dateTime = v;
+  }
+  const orientEntry = findEntry(ifd0.entries, 274);
+  if (orientEntry) {
+    const v = tu16(r, orientEntry.valueOffsetField);
+    result.orientation = v;
+    result.orientationLabel = ORIENTATION_LABELS[v] ?? "Unknown";
+  }
+  const exifIfdPtr = findEntry(ifd0.entries, 34665);
+  if (exifIfdPtr) {
+    const subOffset = exifStart + tu32(r, exifIfdPtr.valueOffsetField);
+    const sub = readIfdEntries(r, subOffset);
+    if (sub) {
+      const dtoEntry = findEntry(sub.entries, 36867);
+      if (dtoEntry) {
+        const v = readAscii(r, dtoEntry);
+        if (v) result.dateTimeOriginal = v;
+      }
+      const expEntry = findEntry(sub.entries, 33434);
+      if (expEntry) {
+        const rat = readRational(r, expEntry);
+        if (rat && rat.den !== 0) result.exposureTime = formatExposureTime(rat.num, rat.den);
+      }
+      const fEntry = findEntry(sub.entries, 33437);
+      if (fEntry) {
+        const rat = readRational(r, fEntry);
+        if (rat && rat.den !== 0) result.fNumber = round2(rat.num / rat.den);
+      }
+      const isoEntry = findEntry(sub.entries, 34855);
+      if (isoEntry) result.isoSpeed = tu16(r, isoEntry.valueOffsetField);
+      const focalEntry = findEntry(sub.entries, 37386);
+      if (focalEntry) {
+        const rat = readRational(r, focalEntry);
+        if (rat && rat.den !== 0) result.focalLength = round2(rat.num / rat.den);
+      }
+    }
+  }
+  const gpsIfdPtr = findEntry(ifd0.entries, 34853);
+  if (gpsIfdPtr) {
+    const gpsOffset = exifStart + tu32(r, gpsIfdPtr.valueOffsetField);
+    const gps = readIfdEntries(r, gpsOffset);
+    if (gps) {
+      const lat = readGpsCoordinate(r, gps.entries, 2, 1);
+      const lon = readGpsCoordinate(r, gps.entries, 4, 3);
+      if (lat !== null) result.gpsLatitude = lat;
+      if (lon !== null) result.gpsLongitude = lon;
+    }
+  }
+  return result;
+}
 function bytesToLatin1(bytes) {
   let out = "";
   const CHUNK = 32768;

package/dist/index.d.cts

@@ -13,7 +13,7 @@ export { c as color } from './color-tPwZCr9H.cjs';
 export { c as css } from './css-Cf7AMGM-.cjs';
 export { m as misc } from './misc-CA3N198T.cjs';
 export { a as ai_agent } from './ai_agent-CcpkV2DR.cjs';
-export { m as media } from './media-D-K5aZnq.cjs';
+export { m as media } from './media-CHaBS1dI.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { c as color } from './color-tPwZCr9H.js';
 export { c as css } from './css-Cf7AMGM-.js';
 export { m as misc } from './misc-CA3N198T.js';
 export { a as ai_agent } from './ai_agent-CcpkV2DR.js';
-export { m as media } from './media-D-K5aZnq.js';
+export { m as media } from './media-CHaBS1dI.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,4 +1,4 @@
-export { media_exports as media } from './chunk-WWKPLYEP.js';
+export { media_exports as media } from './chunk-FXBB7O5A.js';
 export { units_exports as units } from './chunk-QJE743LY.js';
 export { network_exports as network } from './chunk-V5JKVDBA.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
@@ -9,7 +9,7 @@ export { misc_exports as misc } from './chunk-GX7H6TAX.js';
 export { ai_agent_exports as ai_agent } from './chunk-M35VJETW.js';
 export { json_exports as json } from './chunk-TSAGO3XP.js';
 export { encoding_exports as encoding } from './chunk-IPR7FSX4.js';
-export { hashing_exports as hashing } from './chunk-FL53T24A.js';
+export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
 export { text_exports as text } from './chunk-YBBYFAOV.js';
 export { data_exports as data } from './chunk-DNCOIO5N.js';
 export { generators_exports as generators } from './chunk-2CJSLYWI.js';

package/dist/{media-D-K5aZnq.d.cts → media-CHaBS1dI.d.cts}

@@ -16,6 +16,32 @@ interface ImageInfoError {
  * GIF, WebP, and BMP.
  */
 declare function readImageInfo(bytes: Uint8Array): ImageInfo | ImageInfoError;
+interface ExifData {
+    make?: string;
+    model?: string;
+    software?: string;
+    orientation?: number;
+    orientationLabel?: string;
+    dateTime?: string;
+    dateTimeOriginal?: string;
+    exposureTime?: string;
+    fNumber?: number;
+    isoSpeed?: number;
+    focalLength?: number;
+    gpsLatitude?: number;
+    gpsLongitude?: number;
+    tagCount: number;
+}
+interface ExifError {
+    error: string;
+}
+/**
+ * Read common EXIF tags (make, model, orientation, timestamps, exposure
+ * settings, GPS coordinates) directly from a JPEG's APP1 segment. Only
+ * JPEG is supported: PNG, WebP, and other formats don't carry EXIF the
+ * same way and are rejected with an error.
+ */
+declare function readExifData(bytes: Uint8Array): ExifData | ExifError;
 interface PdfMetadata {
     version: string | null;
     pageCount: number | null;
@@ -39,15 +65,18 @@ interface PdfMetadataError {
  */
 declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
 
+type media_ExifData = ExifData;
+type media_ExifError = ExifError;
 type media_ImageFormat = ImageFormat;
 type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
+declare const media_readExifData: typeof readExifData;
 declare const media_readImageInfo: typeof readImageInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
 declare namespace media {
-  export { type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, media_readExifData as readExifData, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata };
 }
 
-export { type ImageFormat as I, type PdfMetadata as P, type ImageInfo as a, type ImageInfoError as b, type PdfMetadataError as c, readPdfMetadata as d, media as m, readImageInfo as r };
+export { type ExifData as E, type ImageFormat as I, type PdfMetadata as P, type ExifError as a, type ImageInfo as b, type ImageInfoError as c, type PdfMetadataError as d, readImageInfo as e, readPdfMetadata as f, media as m, readExifData as r };

package/dist/{media-D-K5aZnq.d.ts → media-CHaBS1dI.d.ts}

@@ -16,6 +16,32 @@ interface ImageInfoError {
  * GIF, WebP, and BMP.
  */
 declare function readImageInfo(bytes: Uint8Array): ImageInfo | ImageInfoError;
+interface ExifData {
+    make?: string;
+    model?: string;
+    software?: string;
+    orientation?: number;
+    orientationLabel?: string;
+    dateTime?: string;
+    dateTimeOriginal?: string;
+    exposureTime?: string;
+    fNumber?: number;
+    isoSpeed?: number;
+    focalLength?: number;
+    gpsLatitude?: number;
+    gpsLongitude?: number;
+    tagCount: number;
+}
+interface ExifError {
+    error: string;
+}
+/**
+ * Read common EXIF tags (make, model, orientation, timestamps, exposure
+ * settings, GPS coordinates) directly from a JPEG's APP1 segment. Only
+ * JPEG is supported: PNG, WebP, and other formats don't carry EXIF the
+ * same way and are rejected with an error.
+ */
+declare function readExifData(bytes: Uint8Array): ExifData | ExifError;
 interface PdfMetadata {
     version: string | null;
     pageCount: number | null;
@@ -39,15 +65,18 @@ interface PdfMetadataError {
  */
 declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
 
+type media_ExifData = ExifData;
+type media_ExifError = ExifError;
 type media_ImageFormat = ImageFormat;
 type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
+declare const media_readExifData: typeof readExifData;
 declare const media_readImageInfo: typeof readImageInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
 declare namespace media {
-  export { type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, media_readExifData as readExifData, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata };
 }
 
-export { type ImageFormat as I, type PdfMetadata as P, type ImageInfo as a, type ImageInfoError as b, type PdfMetadataError as c, readPdfMetadata as d, media as m, readImageInfo as r };
+export { type ExifData as E, type ImageFormat as I, type PdfMetadata as P, type ExifError as a, type ImageInfo as b, type ImageInfoError as c, type PdfMetadataError as d, readImageInfo as e, readPdfMetadata as f, media as m, readExifData as r };

package/dist/tools/hashing.cjs

@@ -175,13 +175,7 @@ function generateMd5Hash(password) {
   return "$apr1$" + md5__default.default(password);
 }
 function generateBcryptHash(password, rounds = 10) {
-  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789./";
-  let salt = "";
-  for (let i = 0; i < 22; i++) salt += chars[Math.floor(Math.random() * chars.length)];
-  const roundStr = rounds.toString().padStart(2, "0");
-  let hash = "";
-  for (let i = 0; i < 31; i++) hash += chars[Math.floor(Math.random() * chars.length)];
-  return `$2b$${roundStr}$${salt}${hash}`;
+  return bcrypt__default.default.hashSync(password, rounds);
 }
 function generatePlain(password) {
   return password;
@@ -190,7 +184,7 @@ function createEntry(username, password, algorithm = "bcrypt") {
   let hashedPassword;
   switch (algorithm) {
     case "bcrypt":
-      hashedPassword = generateBcryptHash();
+      hashedPassword = generateBcryptHash(password);
       break;
     case "sha1":
       hashedPassword = generateSha1Hash(password);

package/dist/tools/hashing.js

@@ -1,2 +1,2 @@
-export { HASH_ALGORITHMS, HASH_BITS, ROUND_OPTIONS, createEntry, generateBcryptHash, generateHtpasswdFile, generateMd5Hash, generatePlain, generateSha1Hash, hashAll, hashOne, hashPassword, hashWithTiming, parseHtpasswdFile, validateRounds, validateUsername, verifyPassword } from '../chunk-FL53T24A.js';
+export { HASH_ALGORITHMS, HASH_BITS, ROUND_OPTIONS, createEntry, generateBcryptHash, generateHtpasswdFile, generateMd5Hash, generatePlain, generateSha1Hash, hashAll, hashOne, hashPassword, hashWithTiming, parseHtpasswdFile, validateRounds, validateUsername, verifyPassword } from '../chunk-GEFVMGZR.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/media.cjs

@@ -126,6 +126,195 @@ function readImageInfo(bytes) {
   }
   return { error: "Unrecognized image format. Supported formats: PNG, JPEG, GIF, WebP, BMP" };
 }
+var ORIENTATION_LABELS = {
+  1: "Normal",
+  2: "Mirrored horizontal",
+  3: "Rotated 180\xB0",
+  4: "Mirrored vertical",
+  5: "Mirrored horizontal, rotated 90\xB0 CCW",
+  6: "Rotated 90\xB0 CW",
+  7: "Mirrored horizontal, rotated 90\xB0 CW",
+  8: "Rotated 90\xB0 CCW"
+};
+function tu16(r, o) {
+  return r.view.getUint16(o, r.little);
+}
+function tu32(r, o) {
+  return r.view.getUint32(o, r.little);
+}
+function readIfdEntries(r, ifdOffset) {
+  if (ifdOffset < 0 || ifdOffset + 2 > r.bytes.length) return null;
+  const numEntries = tu16(r, ifdOffset);
+  const entries = [];
+  for (let i = 0; i < numEntries; i++) {
+    const entryOffset = ifdOffset + 2 + i * 12;
+    if (entryOffset + 12 > r.bytes.length) break;
+    entries.push({
+      tag: tu16(r, entryOffset),
+      type: tu16(r, entryOffset + 2),
+      count: tu32(r, entryOffset + 4),
+      valueOffsetField: entryOffset + 8
+    });
+  }
+  return { entries };
+}
+function findEntry(entries, tag) {
+  return entries.find((e) => e.tag === tag);
+}
+function readAscii(r, entry) {
+  const size = entry.count;
+  const inline = size <= 4;
+  const dataOffset = inline ? entry.valueOffsetField : r.tiffStart + tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + size > r.bytes.length) return null;
+  let out = "";
+  for (let i = 0; i < size; i++) {
+    const c = r.bytes[dataOffset + i];
+    if (c === 0) break;
+    out += String.fromCharCode(c);
+  }
+  const trimmed = out.trim();
+  return trimmed || null;
+}
+function readRational(r, entry) {
+  const dataOffset = r.tiffStart + tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 8 > r.bytes.length) return null;
+  return { num: tu32(r, dataOffset), den: tu32(r, dataOffset + 4) };
+}
+function readGpsCoordinate(r, entries, valueTag, refTag) {
+  const valueEntry = findEntry(entries, valueTag);
+  if (!valueEntry) return null;
+  const dataOffset = r.tiffStart + tu32(r, valueEntry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 24 > r.bytes.length) return null;
+  const deg = tu32(r, dataOffset) / (tu32(r, dataOffset + 4) || 1);
+  const min = tu32(r, dataOffset + 8) / (tu32(r, dataOffset + 12) || 1);
+  const sec = tu32(r, dataOffset + 16) / (tu32(r, dataOffset + 20) || 1);
+  let decimal = deg + min / 60 + sec / 3600;
+  const refEntry = findEntry(entries, refTag);
+  const ref = refEntry ? readAscii(r, refEntry) : null;
+  if (ref === "S" || ref === "W") decimal = -decimal;
+  return Math.round(decimal * 1e6) / 1e6;
+}
+function gcd(a, b) {
+  return b === 0 ? a : gcd(b, a % b);
+}
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function formatExposureTime(num, den) {
+  if (num === 0) return "0s";
+  if (num >= den) return `${round2(num / den)}s`;
+  const divisor = gcd(num, den) || 1;
+  const n = num / divisor;
+  const d = den / divisor;
+  return `1/${Math.round(d / n)}`;
+}
+function readExifData(bytes) {
+  if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) {
+    return { error: "Not a JPEG file (EXIF is only read from JPEG files)" };
+  }
+  let offset = 2;
+  let exifStart = -1;
+  while (offset + 4 <= bytes.length) {
+    if (bytes[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = bytes[offset + 1];
+    if (marker === 216 || marker === 1 || marker >= 208 && marker <= 215) {
+      offset += 2;
+      continue;
+    }
+    if (marker === 217 || marker === 218) break;
+    const segmentLength = bytes[offset + 2] << 8 | bytes[offset + 3];
+    if (marker === 225) {
+      const idOffset = offset + 4;
+      if (idOffset + 6 <= bytes.length && bytes[idOffset] === 69 && bytes[idOffset + 1] === 120 && bytes[idOffset + 2] === 105 && bytes[idOffset + 3] === 102 && bytes[idOffset + 4] === 0 && bytes[idOffset + 5] === 0) {
+        exifStart = idOffset + 6;
+        break;
+      }
+    }
+    offset += 2 + segmentLength;
+  }
+  if (exifStart === -1) return { error: "No EXIF segment found in this JPEG" };
+  if (exifStart + 8 > bytes.length) return { error: "Truncated EXIF segment" };
+  const byteOrder = String.fromCharCode(bytes[exifStart], bytes[exifStart + 1]);
+  if (byteOrder !== "II" && byteOrder !== "MM") return { error: "Invalid TIFF byte order marker in EXIF data" };
+  const little = byteOrder === "II";
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const r = { bytes, view, little, tiffStart: exifStart };
+  if (tu16(r, exifStart + 2) !== 42) return { error: "Invalid TIFF magic number in EXIF data" };
+  const ifd0Offset = exifStart + tu32(r, exifStart + 4);
+  const ifd0 = readIfdEntries(r, ifd0Offset);
+  if (!ifd0) return { error: "Could not read IFD0 from EXIF data" };
+  const result = { tagCount: ifd0.entries.length };
+  const makeEntry = findEntry(ifd0.entries, 271);
+  if (makeEntry) {
+    const v = readAscii(r, makeEntry);
+    if (v) result.make = v;
+  }
+  const modelEntry = findEntry(ifd0.entries, 272);
+  if (modelEntry) {
+    const v = readAscii(r, modelEntry);
+    if (v) result.model = v;
+  }
+  const softwareEntry = findEntry(ifd0.entries, 305);
+  if (softwareEntry) {
+    const v = readAscii(r, softwareEntry);
+    if (v) result.software = v;
+  }
+  const dateTimeEntry = findEntry(ifd0.entries, 306);
+  if (dateTimeEntry) {
+    const v = readAscii(r, dateTimeEntry);
+    if (v) result.dateTime = v;
+  }
+  const orientEntry = findEntry(ifd0.entries, 274);
+  if (orientEntry) {
+    const v = tu16(r, orientEntry.valueOffsetField);
+    result.orientation = v;
+    result.orientationLabel = ORIENTATION_LABELS[v] ?? "Unknown";
+  }
+  const exifIfdPtr = findEntry(ifd0.entries, 34665);
+  if (exifIfdPtr) {
+    const subOffset = exifStart + tu32(r, exifIfdPtr.valueOffsetField);
+    const sub = readIfdEntries(r, subOffset);
+    if (sub) {
+      const dtoEntry = findEntry(sub.entries, 36867);
+      if (dtoEntry) {
+        const v = readAscii(r, dtoEntry);
+        if (v) result.dateTimeOriginal = v;
+      }
+      const expEntry = findEntry(sub.entries, 33434);
+      if (expEntry) {
+        const rat = readRational(r, expEntry);
+        if (rat && rat.den !== 0) result.exposureTime = formatExposureTime(rat.num, rat.den);
+      }
+      const fEntry = findEntry(sub.entries, 33437);
+      if (fEntry) {
+        const rat = readRational(r, fEntry);
+        if (rat && rat.den !== 0) result.fNumber = round2(rat.num / rat.den);
+      }
+      const isoEntry = findEntry(sub.entries, 34855);
+      if (isoEntry) result.isoSpeed = tu16(r, isoEntry.valueOffsetField);
+      const focalEntry = findEntry(sub.entries, 37386);
+      if (focalEntry) {
+        const rat = readRational(r, focalEntry);
+        if (rat && rat.den !== 0) result.focalLength = round2(rat.num / rat.den);
+      }
+    }
+  }
+  const gpsIfdPtr = findEntry(ifd0.entries, 34853);
+  if (gpsIfdPtr) {
+    const gpsOffset = exifStart + tu32(r, gpsIfdPtr.valueOffsetField);
+    const gps = readIfdEntries(r, gpsOffset);
+    if (gps) {
+      const lat = readGpsCoordinate(r, gps.entries, 2, 1);
+      const lon = readGpsCoordinate(r, gps.entries, 4, 3);
+      if (lat !== null) result.gpsLatitude = lat;
+      if (lon !== null) result.gpsLongitude = lon;
+    }
+  }
+  return result;
+}
 function bytesToLatin1(bytes) {
   let out = "";
   const CHUNK = 32768;
@@ -269,5 +458,6 @@ function readPdfMetadata(bytes) {
   };
 }
 
+exports.readExifData = readExifData;
 exports.readImageInfo = readImageInfo;
 exports.readPdfMetadata = readPdfMetadata;

package/dist/tools/media.d.cts

@@ -1 +1 @@
-export { I as ImageFormat, a as ImageInfo, b as ImageInfoError, P as PdfMetadata, c as PdfMetadataError, r as readImageInfo, d as readPdfMetadata } from '../media-D-K5aZnq.cjs';
+export { E as ExifData, a as ExifError, I as ImageFormat, b as ImageInfo, c as ImageInfoError, P as PdfMetadata, d as PdfMetadataError, r as readExifData, e as readImageInfo, f as readPdfMetadata } from '../media-CHaBS1dI.cjs';

package/dist/tools/media.d.ts

@@ -1 +1 @@
-export { I as ImageFormat, a as ImageInfo, b as ImageInfoError, P as PdfMetadata, c as PdfMetadataError, r as readImageInfo, d as readPdfMetadata } from '../media-D-K5aZnq.js';
+export { E as ExifData, a as ExifError, I as ImageFormat, b as ImageInfo, c as ImageInfoError, P as PdfMetadata, d as PdfMetadataError, r as readExifData, e as readImageInfo, f as readPdfMetadata } from '../media-CHaBS1dI.js';

package/dist/tools/media.js

@@ -1,2 +1,2 @@
-export { readImageInfo, readPdfMetadata } from '../chunk-WWKPLYEP.js';
+export { readExifData, readImageInfo, readPdfMetadata } from '../chunk-FXBB7O5A.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "140+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",
@@ -138,7 +138,7 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "devDependencies": {
-    "@types/bcryptjs": "^2.4.6",
+    "@types/bcryptjs": "^3.0.0",
     "@types/blueimp-md5": "^2.18.2",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.0.0",
@@ -148,7 +148,7 @@
     "vitest": "^2.0.0"
   },
   "dependencies": {
-    "bcryptjs": "^2.4.3",
+    "bcryptjs": "^3.0.3",
     "blueimp-md5": "^2.19.0",
     "cron-parser": "^4.9.0",
     "date-fns": "^3.6.0",