@utilix-tech/sdk 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -8894,6 +8894,7 @@ __export(api_exports, {
   parseCspHeader: () => parseCspHeader,
   parseCurl: () => parseCurl,
   parseCurlCommand: () => parseCurlCommand,
+  parseJwks: () => parseJwks,
   parseMetaTags: () => parseMetaTags,
   parseUrl: () => parseUrl,
   removeParam: () => removeParam,
@@ -9343,6 +9344,55 @@ function decodeJwt(token) {
 function formatJwtJson(obj) {
   return JSON.stringify(obj, null, 2);
 }
+function base64urlByteLength(s) {
+  const clean = s.replace(/=+$/, "");
+  return Math.floor(clean.length * 6 / 8);
+}
+function parseJwks(input) {
+  const trimmed = input.trim();
+  if (!trimmed) return { ok: false, error: "No input provided" };
+  let data;
+  try {
+    data = JSON.parse(trimmed);
+  } catch (e) {
+    return { ok: false, error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  let rawKeys;
+  if (data && typeof data === "object" && Array.isArray(data.keys)) {
+    rawKeys = data.keys;
+  } else if (data && typeof data === "object" && typeof data.kty === "string") {
+    rawKeys = [data];
+  } else {
+    return { ok: false, error: 'Input must be a JWKS object with a "keys" array, or a single JWK object with a "kty" field' };
+  }
+  const keys = rawKeys.map((k) => {
+    const key = k ?? {};
+    const kty = typeof key.kty === "string" ? key.kty : "unknown";
+    let keySize = null;
+    let curve;
+    if (kty === "RSA" && typeof key.n === "string") {
+      keySize = base64urlByteLength(key.n) * 8;
+    } else if ((kty === "EC" || kty === "OKP") && typeof key.crv === "string") {
+      curve = key.crv;
+    } else if (kty === "oct" && typeof key.k === "string") {
+      keySize = base64urlByteLength(key.k) * 8;
+    }
+    return {
+      kty,
+      use: typeof key.use === "string" ? key.use : void 0,
+      keyOps: Array.isArray(key.key_ops) ? key.key_ops.filter((x) => typeof x === "string") : void 0,
+      alg: typeof key.alg === "string" ? key.alg : void 0,
+      kid: typeof key.kid === "string" ? key.kid : void 0,
+      keySize,
+      curve,
+      raw: key
+    };
+  });
+  const kidCounts = /* @__PURE__ */ new Map();
+  for (const k of keys) if (k.kid) kidCounts.set(k.kid, (kidCounts.get(k.kid) ?? 0) + 1);
+  const duplicateKids = [...kidCounts.entries()].filter(([, c]) => c > 1).map(([kid]) => kid);
+  return { ok: true, keys, count: keys.length, duplicateKids };
+}
 var ALG_TO_NODE_HASH = {
   HS256: "sha256",
   HS384: "sha384",
@@ -16884,7 +16934,8 @@ function summarizeForLlm(text, maxTokens = 200, strategy = "extractive") {
 // src/tools/media.ts
 var media_exports = {};
 __export(media_exports, {
-  readImageInfo: () => readImageInfo
+  readImageInfo: () => readImageInfo,
+  readPdfMetadata: () => readPdfMetadata
 });
 function readU32BE(bytes, offset) {
   return (bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
@@ -17011,6 +17062,148 @@ function readImageInfo(bytes) {
   }
   return { error: "Unrecognized image format. Supported formats: PNG, JPEG, GIF, WebP, BMP" };
 }
+function bytesToLatin1(bytes) {
+  let out = "";
+  const CHUNK = 32768;
+  for (let i = 0; i < bytes.length; i += CHUNK) {
+    out += String.fromCharCode(...bytes.subarray(i, i + CHUNK));
+  }
+  return out;
+}
+function decodePdfString(raw, isHex) {
+  const bytes = [];
+  if (isHex) {
+    const hex = raw.replace(/\s+/g, "");
+    const padded = hex.length % 2 === 0 ? hex : hex + "0";
+    for (let i = 0; i < padded.length; i += 2) bytes.push(parseInt(padded.slice(i, i + 2), 16));
+  } else {
+    const s = raw.replace(/\\\r\n|\\\r|\\\n/g, "");
+    for (let i = 0; i < s.length; i++) {
+      const ch = s[i];
+      if (ch === "\\" && i + 1 < s.length) {
+        const next = s[i + 1];
+        if (next === "n") {
+          bytes.push(10);
+          i++;
+        } else if (next === "r") {
+          bytes.push(13);
+          i++;
+        } else if (next === "t") {
+          bytes.push(9);
+          i++;
+        } else if (next === "b") {
+          bytes.push(8);
+          i++;
+        } else if (next === "f") {
+          bytes.push(12);
+          i++;
+        } else if (next === "(" || next === ")" || next === "\\") {
+          bytes.push(next.charCodeAt(0));
+          i++;
+        } else if (/[0-7]/.test(next)) {
+          let oct = next;
+          i++;
+          for (let k = 0; k < 2 && i + 1 < s.length && /[0-7]/.test(s[i + 1]); k++) {
+            i++;
+            oct += s[i];
+          }
+          bytes.push(parseInt(oct, 8) & 255);
+        } else {
+          bytes.push(next.charCodeAt(0));
+          i++;
+        }
+      } else {
+        bytes.push(ch.charCodeAt(0) & 255);
+      }
+    }
+  }
+  if (bytes.length >= 2 && bytes[0] === 254 && bytes[1] === 255) {
+    let out = "";
+    for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode(bytes[i] << 8 | bytes[i + 1]);
+    return out;
+  }
+  return bytes.map((b) => String.fromCharCode(b)).join("");
+}
+function extractDictField(dict, key) {
+  const litMatch = dict.match(new RegExp(`/${key}\\s*\\(((?:\\\\.|[^\\\\()])*)\\)`));
+  if (litMatch) return decodePdfString(litMatch[1], false);
+  const hexMatch = dict.match(new RegExp(`/${key}\\s*<([0-9A-Fa-f\\s]*)>`));
+  if (hexMatch) return decodePdfString(hexMatch[1], true);
+  return null;
+}
+function findObject(text, objNum, gen) {
+  const m = text.match(new RegExp(`(?:^|[^0-9])${objNum}\\s+${gen}\\s+obj([\\s\\S]*?)endobj`));
+  return m ? m[1] : null;
+}
+function parsePdfDate(raw) {
+  const m = raw.match(/^D:(\d{4})(\d{2})?(\d{2})?(\d{2})?(\d{2})?(\d{2})?([Z+-])?(\d{2})?'?(\d{2})?'?/);
+  if (!m) return null;
+  const [, y, mo = "01", d = "01", h = "00", mi = "00", s = "00", tz, tzh, tzm] = m;
+  let iso = `${y}-${mo}-${d}T${h}:${mi}:${s}`;
+  if (tz === "Z") iso += "Z";
+  else if (tz === "+" || tz === "-") iso += `${tz}${tzh ?? "00"}:${tzm ?? "00"}`;
+  return iso;
+}
+function readPdfMetadata(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version2 = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  let infoDict = null;
+  let encrypted = false;
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    encrypted = /\/Encrypt\s+\d+\s+\d+\s+R/.test(trailer);
+    const infoRef = trailer.match(/\/Info\s+(\d+)\s+(\d+)\s+R/);
+    if (infoRef) infoDict = findObject(text, Number(infoRef[1]), Number(infoRef[2]));
+  }
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  if (!infoDict) {
+    for (const b of objBlocks) {
+      if (/\/(Title|Author|Producer|Creator|CreationDate)\b/.test(b[3]) && !/\/Type\s*\/(Page|Pages|Catalog|Font)\b/.test(b[3])) {
+        infoDict = b[3];
+        break;
+      }
+    }
+  }
+  const title = infoDict ? extractDictField(infoDict, "Title") : null;
+  const author = infoDict ? extractDictField(infoDict, "Author") : null;
+  const subject = infoDict ? extractDictField(infoDict, "Subject") : null;
+  const keywords = infoDict ? extractDictField(infoDict, "Keywords") : null;
+  const creator = infoDict ? extractDictField(infoDict, "Creator") : null;
+  const producer = infoDict ? extractDictField(infoDict, "Producer") : null;
+  const creationDateRaw = infoDict ? extractDictField(infoDict, "CreationDate") : null;
+  const modDateRaw = infoDict ? extractDictField(infoDict, "ModDate") : null;
+  let pageCount = null;
+  for (const b of objBlocks) {
+    if (!/\/Type\s*\/Pages\b/.test(b[3])) continue;
+    const countMatch = b[3].match(/\/Count\s+(\d+)/);
+    if (countMatch) {
+      const c = Number(countMatch[1]);
+      if (pageCount === null || c > pageCount) pageCount = c;
+    }
+  }
+  if (pageCount === null) {
+    const pageMatches = text.match(/\/Type\s*\/Page(?!s)\b/g);
+    if (pageMatches) pageCount = pageMatches.length;
+  }
+  return {
+    version: version2,
+    pageCount,
+    title,
+    author,
+    subject,
+    keywords,
+    creator,
+    producer,
+    creationDate: creationDateRaw ? parsePdfDate(creationDateRaw) ?? creationDateRaw : null,
+    modDate: modDateRaw ? parsePdfDate(modDateRaw) ?? modDateRaw : null,
+    encrypted
+  };
+}
 
 // src/index.ts
 var version = "0.1.0";

package/dist/index.d.cts

@@ -7,13 +7,13 @@ export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-DbT8fjaF.cjs';
 export { u as units } from './units-6lwDYBvX.cjs';
 export { n as network } from './network-DwyAjwJS.cjs';
-export { a as api } from './api-8aZtWhSj.cjs';
+export { a as api } from './api-Xl7OzIgq.cjs';
 export { c as code } from './code-BUqyaofO.cjs';
 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-DF2cx3pK.cjs';
+export { m as media } from './media-D-K5aZnq.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -7,13 +7,13 @@ export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-DbT8fjaF.js';
 export { u as units } from './units-6lwDYBvX.js';
 export { n as network } from './network-DwyAjwJS.js';
-export { a as api } from './api-8aZtWhSj.js';
+export { a as api } from './api-Xl7OzIgq.js';
 export { c as code } from './code-BUqyaofO.js';
 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-DF2cx3pK.js';
+export { m as media } from './media-D-K5aZnq.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,7 +1,7 @@
-export { media_exports as media } from './chunk-N7C52YGL.js';
+export { media_exports as media } from './chunk-WWKPLYEP.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-HFRTZE7T.js';
+export { api_exports as api } from './chunk-Q3B3YWOA.js';
 export { code_exports as code } from './chunk-V5S6OJ4A.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';
 export { css_exports as css } from './chunk-6YPV2AB5.js';

package/dist/media-D-K5aZnq.d.cts

@@ -0,0 +1,53 @@
+type ImageFormat = 'png' | 'jpeg' | 'gif' | 'webp' | 'bmp';
+interface ImageInfo {
+    format: ImageFormat;
+    width: number;
+    height: number;
+    bitDepth?: number;
+    colorType?: string;
+    hasAlpha?: boolean;
+}
+interface ImageInfoError {
+    error: string;
+}
+/**
+ * Read image format, dimensions, and basic color info straight from file
+ * bytes — no decoding, no image library, no canvas. Supports PNG, JPEG,
+ * GIF, WebP, and BMP.
+ */
+declare function readImageInfo(bytes: Uint8Array): ImageInfo | ImageInfoError;
+interface PdfMetadata {
+    version: string | null;
+    pageCount: number | null;
+    title: string | null;
+    author: string | null;
+    subject: string | null;
+    keywords: string | null;
+    creator: string | null;
+    producer: string | null;
+    creationDate: string | null;
+    modDate: string | null;
+    encrypted: boolean;
+}
+interface PdfMetadataError {
+    error: string;
+}
+/**
+ * Read PDF metadata (title, author, dates, page count, encryption flag)
+ * straight from the file's trailer/Info dictionary and page tree — no
+ * pdf.js or other PDF rendering library required.
+ */
+declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
+
+type media_ImageFormat = ImageFormat;
+type media_ImageInfo = ImageInfo;
+type media_ImageInfoError = ImageInfoError;
+type media_PdfMetadata = PdfMetadata;
+type media_PdfMetadataError = PdfMetadataError;
+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 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 };

package/dist/media-D-K5aZnq.d.ts

@@ -0,0 +1,53 @@
+type ImageFormat = 'png' | 'jpeg' | 'gif' | 'webp' | 'bmp';
+interface ImageInfo {
+    format: ImageFormat;
+    width: number;
+    height: number;
+    bitDepth?: number;
+    colorType?: string;
+    hasAlpha?: boolean;
+}
+interface ImageInfoError {
+    error: string;
+}
+/**
+ * Read image format, dimensions, and basic color info straight from file
+ * bytes — no decoding, no image library, no canvas. Supports PNG, JPEG,
+ * GIF, WebP, and BMP.
+ */
+declare function readImageInfo(bytes: Uint8Array): ImageInfo | ImageInfoError;
+interface PdfMetadata {
+    version: string | null;
+    pageCount: number | null;
+    title: string | null;
+    author: string | null;
+    subject: string | null;
+    keywords: string | null;
+    creator: string | null;
+    producer: string | null;
+    creationDate: string | null;
+    modDate: string | null;
+    encrypted: boolean;
+}
+interface PdfMetadataError {
+    error: string;
+}
+/**
+ * Read PDF metadata (title, author, dates, page count, encryption flag)
+ * straight from the file's trailer/Info dictionary and page tree — no
+ * pdf.js or other PDF rendering library required.
+ */
+declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
+
+type media_ImageFormat = ImageFormat;
+type media_ImageInfo = ImageInfo;
+type media_ImageInfoError = ImageInfoError;
+type media_PdfMetadata = PdfMetadata;
+type media_PdfMetadataError = PdfMetadataError;
+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 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 };

package/dist/tools/api.cjs

@@ -444,6 +444,55 @@ function decodeJwt(token) {
 function formatJwtJson(obj) {
   return JSON.stringify(obj, null, 2);
 }
+function base64urlByteLength(s) {
+  const clean = s.replace(/=+$/, "");
+  return Math.floor(clean.length * 6 / 8);
+}
+function parseJwks(input) {
+  const trimmed = input.trim();
+  if (!trimmed) return { ok: false, error: "No input provided" };
+  let data;
+  try {
+    data = JSON.parse(trimmed);
+  } catch (e) {
+    return { ok: false, error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  let rawKeys;
+  if (data && typeof data === "object" && Array.isArray(data.keys)) {
+    rawKeys = data.keys;
+  } else if (data && typeof data === "object" && typeof data.kty === "string") {
+    rawKeys = [data];
+  } else {
+    return { ok: false, error: 'Input must be a JWKS object with a "keys" array, or a single JWK object with a "kty" field' };
+  }
+  const keys = rawKeys.map((k) => {
+    const key = k ?? {};
+    const kty = typeof key.kty === "string" ? key.kty : "unknown";
+    let keySize = null;
+    let curve;
+    if (kty === "RSA" && typeof key.n === "string") {
+      keySize = base64urlByteLength(key.n) * 8;
+    } else if ((kty === "EC" || kty === "OKP") && typeof key.crv === "string") {
+      curve = key.crv;
+    } else if (kty === "oct" && typeof key.k === "string") {
+      keySize = base64urlByteLength(key.k) * 8;
+    }
+    return {
+      kty,
+      use: typeof key.use === "string" ? key.use : void 0,
+      keyOps: Array.isArray(key.key_ops) ? key.key_ops.filter((x) => typeof x === "string") : void 0,
+      alg: typeof key.alg === "string" ? key.alg : void 0,
+      kid: typeof key.kid === "string" ? key.kid : void 0,
+      keySize,
+      curve,
+      raw: key
+    };
+  });
+  const kidCounts = /* @__PURE__ */ new Map();
+  for (const k of keys) if (k.kid) kidCounts.set(k.kid, (kidCounts.get(k.kid) ?? 0) + 1);
+  const duplicateKids = [...kidCounts.entries()].filter(([, c]) => c > 1).map(([kid]) => kid);
+  return { ok: true, keys, count: keys.length, duplicateKids };
+}
 var ALG_TO_NODE_HASH = {
   HS256: "sha256",
   HS384: "sha384",
@@ -1207,6 +1256,7 @@ exports.normalizeUrl = normalizeUrl;
 exports.parseCspHeader = parseCspHeader;
 exports.parseCurl = parseCurl;
 exports.parseCurlCommand = parseCurlCommand;
+exports.parseJwks = parseJwks;
 exports.parseMetaTags = parseMetaTags;
 exports.parseUrl = parseUrl;
 exports.removeParam = removeParam;

package/dist/tools/api.d.cts

@@ -1 +1 @@
-export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HttpMethod, J as JwtAlgorithm, o as JwtDecodeError, p as JwtDecodeResult, q as JwtExpiry, r as JwtPart, s as JwtResult, t as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, u as TwitterTags, v as addParam, w as base64urlDecode, x as base64urlEncode, y as buildCurl, z as buildCurlMultiline, A as buildUrl, B as convertToCode, E as decodeJwt, G as decodeUrlComponent, I as detectFormat, K as encodeUrlComponent, L as extractJsonPaths, N as formatJwtJson, Q as formatResponse, U as generateCors, V as generateCspHeader, W as generateFullHeader, X as generateMetaHtml, Y as getParam, Z as getStats, _ as isValidUrl, $ as normalizeUrl, a0 as parseCspHeader, a1 as parseCurl, a2 as parseCurlCommand, a3 as parseMetaTags, a4 as parseUrl, a5 as removeParam, a6 as signJwt, a7 as validateCorsConfig, a8 as validateCspConfig, a9 as validateOgTags } from '../api-8aZtWhSj.cjs';
+export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HttpMethod, J as JwkSummary, o as JwksError, p as JwksParseResult, q as JwksResult, r as JwtAlgorithm, s as JwtDecodeError, t as JwtDecodeResult, u as JwtExpiry, v as JwtPart, w as JwtResult, x as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, y as TwitterTags, z as addParam, A as base64urlDecode, B as base64urlEncode, E as buildCurl, G as buildCurlMultiline, I as buildUrl, K as convertToCode, L as decodeJwt, N as decodeUrlComponent, Q as detectFormat, U as encodeUrlComponent, V as extractJsonPaths, W as formatJwtJson, X as formatResponse, Y as generateCors, Z as generateCspHeader, _ as generateFullHeader, $ as generateMetaHtml, a0 as getParam, a1 as getStats, a2 as isValidUrl, a3 as normalizeUrl, a4 as parseCspHeader, a5 as parseCurl, a6 as parseCurlCommand, a7 as parseJwks, a8 as parseMetaTags, a9 as parseUrl, aa as removeParam, ab as signJwt, ac as validateCorsConfig, ad as validateCspConfig, ae as validateOgTags } from '../api-Xl7OzIgq.cjs';

package/dist/tools/api.d.ts

@@ -1 +1 @@
-export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HttpMethod, J as JwtAlgorithm, o as JwtDecodeError, p as JwtDecodeResult, q as JwtExpiry, r as JwtPart, s as JwtResult, t as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, u as TwitterTags, v as addParam, w as base64urlDecode, x as base64urlEncode, y as buildCurl, z as buildCurlMultiline, A as buildUrl, B as convertToCode, E as decodeJwt, G as decodeUrlComponent, I as detectFormat, K as encodeUrlComponent, L as extractJsonPaths, N as formatJwtJson, Q as formatResponse, U as generateCors, V as generateCspHeader, W as generateFullHeader, X as generateMetaHtml, Y as getParam, Z as getStats, _ as isValidUrl, $ as normalizeUrl, a0 as parseCspHeader, a1 as parseCurl, a2 as parseCurlCommand, a3 as parseMetaTags, a4 as parseUrl, a5 as removeParam, a6 as signJwt, a7 as validateCorsConfig, a8 as validateCspConfig, a9 as validateOgTags } from '../api-8aZtWhSj.js';
+export { C as COMMON_HEADERS, b as COMMON_PRESETS, c as CORS_COMMON_HEADERS, d as CorsConfig, e as CorsOutput, f as CspConfig, g as CspDirective, h as CspSource, i as CurlCommand, j as CurlConfig, D as DEFAULT_CORS_CONFIG, k as DIRECTIVE_DESCRIPTIONS, l as DirectiveConfig, F as FormatResult, H as HTTP_METHODS, m as Header, n as HttpMethod, J as JwkSummary, o as JwksError, p as JwksParseResult, q as JwksResult, r as JwtAlgorithm, s as JwtDecodeError, t as JwtDecodeResult, u as JwtExpiry, v as JwtPart, w as JwtResult, x as JwtSignOptions, M as MetaTags, O as OgTags, P as ParsedUrl, R as ResponseFormat, S as SUPPORTED_LANGUAGES, T as TargetLanguage, y as TwitterTags, z as addParam, A as base64urlDecode, B as base64urlEncode, E as buildCurl, G as buildCurlMultiline, I as buildUrl, K as convertToCode, L as decodeJwt, N as decodeUrlComponent, Q as detectFormat, U as encodeUrlComponent, V as extractJsonPaths, W as formatJwtJson, X as formatResponse, Y as generateCors, Z as generateCspHeader, _ as generateFullHeader, $ as generateMetaHtml, a0 as getParam, a1 as getStats, a2 as isValidUrl, a3 as normalizeUrl, a4 as parseCspHeader, a5 as parseCurl, a6 as parseCurlCommand, a7 as parseJwks, a8 as parseMetaTags, a9 as parseUrl, aa as removeParam, ab as signJwt, ac as validateCorsConfig, ad as validateCspConfig, ae as validateOgTags } from '../api-Xl7OzIgq.js';

package/dist/tools/api.js

@@ -1,2 +1,2 @@
-export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, base64urlDecode, base64urlEncode, buildCurl, buildCurlMultiline, buildUrl, convertToCode, decodeJwt, decodeUrlComponent, detectFormat, encodeUrlComponent, extractJsonPaths, formatJwtJson, formatResponse, generateCors, generateCspHeader, generateFullHeader, generateMetaHtml, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags } from '../chunk-HFRTZE7T.js';
+export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, base64urlDecode, base64urlEncode, buildCurl, buildCurlMultiline, buildUrl, convertToCode, decodeJwt, decodeUrlComponent, detectFormat, encodeUrlComponent, extractJsonPaths, formatJwtJson, formatResponse, generateCors, generateCspHeader, generateFullHeader, generateMetaHtml, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseJwks, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags } from '../chunk-Q3B3YWOA.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/media.cjs

@@ -126,5 +126,148 @@ function readImageInfo(bytes) {
   }
   return { error: "Unrecognized image format. Supported formats: PNG, JPEG, GIF, WebP, BMP" };
 }
+function bytesToLatin1(bytes) {
+  let out = "";
+  const CHUNK = 32768;
+  for (let i = 0; i < bytes.length; i += CHUNK) {
+    out += String.fromCharCode(...bytes.subarray(i, i + CHUNK));
+  }
+  return out;
+}
+function decodePdfString(raw, isHex) {
+  const bytes = [];
+  if (isHex) {
+    const hex = raw.replace(/\s+/g, "");
+    const padded = hex.length % 2 === 0 ? hex : hex + "0";
+    for (let i = 0; i < padded.length; i += 2) bytes.push(parseInt(padded.slice(i, i + 2), 16));
+  } else {
+    const s = raw.replace(/\\\r\n|\\\r|\\\n/g, "");
+    for (let i = 0; i < s.length; i++) {
+      const ch = s[i];
+      if (ch === "\\" && i + 1 < s.length) {
+        const next = s[i + 1];
+        if (next === "n") {
+          bytes.push(10);
+          i++;
+        } else if (next === "r") {
+          bytes.push(13);
+          i++;
+        } else if (next === "t") {
+          bytes.push(9);
+          i++;
+        } else if (next === "b") {
+          bytes.push(8);
+          i++;
+        } else if (next === "f") {
+          bytes.push(12);
+          i++;
+        } else if (next === "(" || next === ")" || next === "\\") {
+          bytes.push(next.charCodeAt(0));
+          i++;
+        } else if (/[0-7]/.test(next)) {
+          let oct = next;
+          i++;
+          for (let k = 0; k < 2 && i + 1 < s.length && /[0-7]/.test(s[i + 1]); k++) {
+            i++;
+            oct += s[i];
+          }
+          bytes.push(parseInt(oct, 8) & 255);
+        } else {
+          bytes.push(next.charCodeAt(0));
+          i++;
+        }
+      } else {
+        bytes.push(ch.charCodeAt(0) & 255);
+      }
+    }
+  }
+  if (bytes.length >= 2 && bytes[0] === 254 && bytes[1] === 255) {
+    let out = "";
+    for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode(bytes[i] << 8 | bytes[i + 1]);
+    return out;
+  }
+  return bytes.map((b) => String.fromCharCode(b)).join("");
+}
+function extractDictField(dict, key) {
+  const litMatch = dict.match(new RegExp(`/${key}\\s*\\(((?:\\\\.|[^\\\\()])*)\\)`));
+  if (litMatch) return decodePdfString(litMatch[1], false);
+  const hexMatch = dict.match(new RegExp(`/${key}\\s*<([0-9A-Fa-f\\s]*)>`));
+  if (hexMatch) return decodePdfString(hexMatch[1], true);
+  return null;
+}
+function findObject(text, objNum, gen) {
+  const m = text.match(new RegExp(`(?:^|[^0-9])${objNum}\\s+${gen}\\s+obj([\\s\\S]*?)endobj`));
+  return m ? m[1] : null;
+}
+function parsePdfDate(raw) {
+  const m = raw.match(/^D:(\d{4})(\d{2})?(\d{2})?(\d{2})?(\d{2})?(\d{2})?([Z+-])?(\d{2})?'?(\d{2})?'?/);
+  if (!m) return null;
+  const [, y, mo = "01", d = "01", h = "00", mi = "00", s = "00", tz, tzh, tzm] = m;
+  let iso = `${y}-${mo}-${d}T${h}:${mi}:${s}`;
+  if (tz === "Z") iso += "Z";
+  else if (tz === "+" || tz === "-") iso += `${tz}${tzh ?? "00"}:${tzm ?? "00"}`;
+  return iso;
+}
+function readPdfMetadata(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  let infoDict = null;
+  let encrypted = false;
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    encrypted = /\/Encrypt\s+\d+\s+\d+\s+R/.test(trailer);
+    const infoRef = trailer.match(/\/Info\s+(\d+)\s+(\d+)\s+R/);
+    if (infoRef) infoDict = findObject(text, Number(infoRef[1]), Number(infoRef[2]));
+  }
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  if (!infoDict) {
+    for (const b of objBlocks) {
+      if (/\/(Title|Author|Producer|Creator|CreationDate)\b/.test(b[3]) && !/\/Type\s*\/(Page|Pages|Catalog|Font)\b/.test(b[3])) {
+        infoDict = b[3];
+        break;
+      }
+    }
+  }
+  const title = infoDict ? extractDictField(infoDict, "Title") : null;
+  const author = infoDict ? extractDictField(infoDict, "Author") : null;
+  const subject = infoDict ? extractDictField(infoDict, "Subject") : null;
+  const keywords = infoDict ? extractDictField(infoDict, "Keywords") : null;
+  const creator = infoDict ? extractDictField(infoDict, "Creator") : null;
+  const producer = infoDict ? extractDictField(infoDict, "Producer") : null;
+  const creationDateRaw = infoDict ? extractDictField(infoDict, "CreationDate") : null;
+  const modDateRaw = infoDict ? extractDictField(infoDict, "ModDate") : null;
+  let pageCount = null;
+  for (const b of objBlocks) {
+    if (!/\/Type\s*\/Pages\b/.test(b[3])) continue;
+    const countMatch = b[3].match(/\/Count\s+(\d+)/);
+    if (countMatch) {
+      const c = Number(countMatch[1]);
+      if (pageCount === null || c > pageCount) pageCount = c;
+    }
+  }
+  if (pageCount === null) {
+    const pageMatches = text.match(/\/Type\s*\/Page(?!s)\b/g);
+    if (pageMatches) pageCount = pageMatches.length;
+  }
+  return {
+    version,
+    pageCount,
+    title,
+    author,
+    subject,
+    keywords,
+    creator,
+    producer,
+    creationDate: creationDateRaw ? parsePdfDate(creationDateRaw) ?? creationDateRaw : null,
+    modDate: modDateRaw ? parsePdfDate(modDateRaw) ?? modDateRaw : null,
+    encrypted
+  };
+}
 
 exports.readImageInfo = readImageInfo;
+exports.readPdfMetadata = readPdfMetadata;

package/dist/tools/media.d.cts

@@ -1 +1 @@
-export { I as ImageFormat, a as ImageInfo, b as ImageInfoError, r as readImageInfo } from '../media-DF2cx3pK.cjs';
+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';

package/dist/tools/media.d.ts

@@ -1 +1 @@
-export { I as ImageFormat, a as ImageInfo, b as ImageInfoError, r as readImageInfo } from '../media-DF2cx3pK.js';
+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';

package/dist/tools/media.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.4.0",
+  "version": "0.5.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",