@utilix-tech/sdk 0.19.0 → 0.21.0

package/dist/index.cjs

@@ -62,6 +62,7 @@ __export(json_exports, {
   minifyJson: () => minifyJson,
   parseJson: () => parseJson,
   parseStructs: () => parseStructs,
+  resolveJsonPointer: () => resolveJsonPointer,
   toPascalCase: () => toPascalCase,
   toSnakeCase: () => toSnakeCase,
   validateJson: () => validateJson,
@@ -1287,6 +1288,58 @@ function jsonToZod(json, options) {
 
 export const ${rootName}Schema = ${schema}`;
 }
+function _unescapePointerToken(token) {
+  return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function resolveJsonPointer(json, pointer) {
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    return { pointer, found: false, tokens: [], error: "Invalid JSON input" };
+  }
+  let ptr = pointer;
+  if (ptr.startsWith("#")) {
+    ptr = ptr.slice(1);
+    try {
+      ptr = decodeURIComponent(ptr);
+    } catch {
+      return { pointer, found: false, tokens: [], error: "Invalid percent-encoding in URI-fragment pointer" };
+    }
+  }
+  if (ptr === "") {
+    return { pointer, found: true, value: parsed, tokens: [] };
+  }
+  if (!ptr.startsWith("/")) {
+    return { pointer, found: false, tokens: [], error: "Pointer must be empty or start with '/' (RFC 6901)" };
+  }
+  const tokens = ptr.split("/").slice(1).map(_unescapePointerToken);
+  let current = parsed;
+  for (const token of tokens) {
+    if (Array.isArray(current)) {
+      if (token === "-") {
+        return { pointer, found: false, tokens, failedAt: token, reason: '"-" refers to the nonexistent element after the end of the array' };
+      }
+      if (!/^(0|[1-9][0-9]*)$/.test(token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `"${token}" is not a valid array index` };
+      }
+      const idx = Number(token);
+      if (idx >= current.length) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `array index ${idx} is out of bounds (length ${current.length})` };
+      }
+      current = current[idx];
+    } else if (current !== null && typeof current === "object") {
+      const obj = current;
+      if (!Object.prototype.hasOwnProperty.call(obj, token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `key "${token}" not found` };
+      }
+      current = obj[token];
+    } else {
+      return { pointer, found: false, tokens, failedAt: token, reason: `cannot descend into ${current === null ? "null" : typeof current} at "${token}"` };
+    }
+  }
+  return { pointer, found: true, value: current, tokens };
+}
 
 // src/tools/encoding.ts
 var encoding_exports = {};
@@ -1874,6 +1927,7 @@ __export(text_exports, {
   csvToHtml: () => csvToHtml,
   csvToMarkdown: () => csvToMarkdown,
   detectDelimiter: () => detectDelimiter,
+  detectFillerWords: () => detectFillerWords,
   detectPassiveVoice: () => detectPassiveVoice,
   diffLines: () => diffLines,
   diffLinesSimple: () => diffLinesSimple,
@@ -4311,6 +4365,104 @@ function scoreReadability(text) {
     readingLevel: readabilityGradeLabel(fleschReadingEase)
   };
 }
+var FILLER_WORDS = [
+  "very",
+  "really",
+  "just",
+  "actually",
+  "basically",
+  "literally",
+  "simply",
+  "totally",
+  "definitely",
+  "certainly",
+  "essentially",
+  "absolutely",
+  "completely",
+  "extremely",
+  "truly",
+  "honestly",
+  "seriously",
+  "obviously",
+  "clearly",
+  "quite",
+  "rather",
+  "somewhat",
+  "fairly",
+  "virtually"
+];
+var HEDGE_PHRASES = [
+  "maybe",
+  "perhaps",
+  "probably",
+  "possibly",
+  "arguably",
+  "kind of",
+  "sort of",
+  "a bit",
+  "a little",
+  "more or less",
+  "in my opinion",
+  "i think",
+  "i believe",
+  "to some extent"
+];
+var CLICHE_PHRASES = [
+  "at the end of the day",
+  "think outside the box",
+  "low-hanging fruit",
+  "move the needle",
+  "circle back",
+  "touch base",
+  "on the same page",
+  "hit the ground running",
+  "paradigm shift",
+  "win-win",
+  "game changer",
+  "best of both worlds",
+  "only time will tell",
+  "back to the drawing board",
+  "the tip of the iceberg",
+  "a perfect storm",
+  "needle in a haystack",
+  "raise the bar",
+  "push the envelope",
+  "the elephant in the room",
+  "boil the ocean",
+  "when it rains it pours"
+];
+var FILLER_DICTIONARY = [
+  ...FILLER_WORDS.map((phrase) => ({ phrase, category: "filler" })),
+  ...HEDGE_PHRASES.map((phrase) => ({ phrase, category: "hedge" })),
+  ...CLICHE_PHRASES.map((phrase) => ({ phrase, category: "cliche" }))
+];
+function _fillerRegex(phrase) {
+  const tokens = phrase.split(/\s+/).map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+  return new RegExp("\\b" + tokens.join("\\s+") + "\\b", "gi");
+}
+function detectFillerWords(text) {
+  const totalWords = (text.match(/[A-Za-z0-9']+/g) ?? []).length;
+  const matches = [];
+  for (const entry of FILLER_DICTIONARY) {
+    const re = _fillerRegex(entry.phrase);
+    const indices = [];
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      indices.push(m.index);
+      if (m.index === re.lastIndex) re.lastIndex++;
+    }
+    if (indices.length > 0) {
+      matches.push({ phrase: entry.phrase, category: entry.category, count: indices.length, indices });
+    }
+  }
+  matches.sort((a, b) => b.count - a.count || a.category.localeCompare(b.category) || a.phrase.localeCompare(b.phrase));
+  const fillerCount = matches.filter((x) => x.category === "filler").reduce((s, x) => s + x.count, 0);
+  const hedgeCount = matches.filter((x) => x.category === "hedge").reduce((s, x) => s + x.count, 0);
+  const clicheCount = matches.filter((x) => x.category === "cliche").reduce((s, x) => s + x.count, 0);
+  const totalMatches = fillerCount + hedgeCount + clicheCount;
+  const density = totalWords > 0 ? Math.round(totalMatches / totalWords * 1e3) / 10 : 0;
+  return { totalWords, totalMatches, fillerCount, hedgeCount, clicheCount, density, matches };
+}
 
 // src/tools/data.ts
 var data_exports = {};
@@ -6685,6 +6837,7 @@ __export(units_exports, {
   calcSubnet: () => calcSubnet,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
+  calculatePercentageChange: () => calculatePercentageChange,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
   calculateTimeValue: () => calculateTimeValue,
@@ -8002,6 +8155,29 @@ function calculateTimeValue(amount, annualRatePercent, years, direction, compoun
     interest: round23(futureValue - presentValue)
   };
 }
+function calculatePercentageChange(oldValue, newValue) {
+  if (!Number.isFinite(oldValue)) return { error: "Original value must be a finite number" };
+  if (!Number.isFinite(newValue)) return { error: "New value must be a finite number" };
+  if (oldValue === 0 && newValue !== 0) {
+    return { error: "Percentage change from zero is undefined (division by zero); use a nonzero original value" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const absoluteChange = newValue - oldValue;
+  const percentChange = oldValue === 0 ? 0 : absoluteChange / Math.abs(oldValue) * 100;
+  const multiplier = oldValue === 0 ? 1 : newValue / oldValue;
+  let direction;
+  if (absoluteChange > 0) direction = "increase";
+  else if (absoluteChange < 0) direction = "decrease";
+  else direction = "no change";
+  return {
+    oldValue,
+    newValue,
+    absoluteChange: round4(absoluteChange),
+    percentChange: round4(percentChange),
+    direction,
+    multiplier: round4(multiplier)
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -8009,6 +8185,7 @@ __export(network_exports, {
   DNS_RECORD_TYPES: () => DNS_RECORD_TYPES,
   HTTP_HEADERS: () => HTTP_HEADERS,
   STATUS_CODES: () => STATUS_CODES,
+  buildCacheControl: () => buildCacheControl,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
   buildMapUrl: () => buildMapUrl,
@@ -9724,6 +9901,98 @@ function parseUserAgent(ua) {
   const device = { type: _detectUaDeviceType(s) };
   return { browser, engine, os, device, raw: s };
 }
+var _CACHE_NUM_FIELDS = ["maxAge", "sMaxAge", "staleWhileRevalidate", "staleIfError"];
+function _humanizeSeconds(s) {
+  if (s === 0) return "0 seconds";
+  const units = [
+    [86400, "day"],
+    [3600, "hour"],
+    [60, "minute"],
+    [1, "second"]
+  ];
+  const parts = [];
+  let rem = s;
+  for (const [size, label] of units) {
+    if (rem >= size) {
+      const n = Math.floor(rem / size);
+      rem -= n * size;
+      parts.push(`${n} ${label}${n === 1 ? "" : "s"}`);
+    }
+  }
+  return parts.slice(0, 2).join(" ");
+}
+function buildCacheControl(options = {}) {
+  const nums = {
+    maxAge: null,
+    sMaxAge: null,
+    staleWhileRevalidate: null,
+    staleIfError: null
+  };
+  for (const field of _CACHE_NUM_FIELDS) {
+    const v = options[field];
+    if (v === void 0 || v === null) continue;
+    if (typeof v !== "number" || !Number.isFinite(v) || !Number.isInteger(v) || v < 0) {
+      return { error: `${field} must be a non-negative integer number of seconds` };
+    }
+    nums[field] = v;
+  }
+  const directives = [];
+  const warnings = [];
+  if (options.visibility === "public") {
+    directives.push({ name: "public", value: null, explanation: "Any cache, including shared caches and CDNs, may store this response." });
+  }
+  if (options.visibility === "private") {
+    directives.push({ name: "private", value: null, explanation: "Only the user's browser may cache this response; shared caches and CDNs must not." });
+  }
+  if (options.noCache) {
+    directives.push({ name: "no-cache", value: null, explanation: "A cache may store the response but must revalidate it with the origin before every reuse." });
+  }
+  if (options.noStore) {
+    directives.push({ name: "no-store", value: null, explanation: "No cache may store any part of this request or response." });
+  }
+  if (nums.maxAge !== null) {
+    directives.push({ name: "max-age", value: String(nums.maxAge), explanation: `Considered fresh for ${_humanizeSeconds(nums.maxAge)} (${nums.maxAge}s), after which it becomes stale.` });
+  }
+  if (nums.sMaxAge !== null) {
+    directives.push({ name: "s-maxage", value: String(nums.sMaxAge), explanation: `For shared caches (CDNs, proxies) it is fresh for ${_humanizeSeconds(nums.sMaxAge)} (${nums.sMaxAge}s), overriding max-age there.` });
+  }
+  if (options.mustRevalidate) {
+    directives.push({ name: "must-revalidate", value: null, explanation: "Once stale, a cache must revalidate with the origin and never serve the stale copy." });
+  }
+  if (options.proxyRevalidate) {
+    directives.push({ name: "proxy-revalidate", value: null, explanation: "Like must-revalidate, but the requirement applies only to shared caches." });
+  }
+  if (options.immutable) {
+    directives.push({ name: "immutable", value: null, explanation: "The body will not change while fresh, so browsers should not revalidate it on reload." });
+  }
+  if (options.noTransform) {
+    directives.push({ name: "no-transform", value: null, explanation: "Intermediaries must not modify the response body (for example, recompressing images)." });
+  }
+  if (nums.staleWhileRevalidate !== null) {
+    directives.push({ name: "stale-while-revalidate", value: String(nums.staleWhileRevalidate), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleWhileRevalidate)} (${nums.staleWhileRevalidate}s) while it revalidates in the background.` });
+  }
+  if (nums.staleIfError !== null) {
+    directives.push({ name: "stale-if-error", value: String(nums.staleIfError), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleIfError)} (${nums.staleIfError}s) if the origin returns an error.` });
+  }
+  if (options.mustUnderstand) {
+    directives.push({ name: "must-understand", value: null, explanation: "A cache should store the response only if it understands the caching requirements of the response's status code." });
+  }
+  if (options.noStore && directives.length > 1) {
+    warnings.push("no-store means nothing is cached, so the other directives have no effect.");
+  }
+  if (options.noCache && nums.maxAge !== null) {
+    warnings.push("no-cache forces revalidation on every use, so max-age has little practical effect alongside it.");
+  }
+  if (options.immutable && nums.maxAge === null) {
+    warnings.push("immutable only applies while the response is fresh \u2014 add a max-age so it has a freshness lifetime.");
+  }
+  if (directives.length === 0) {
+    warnings.push("No directives set \u2014 an empty Cache-Control header has no effect.");
+  }
+  const header = directives.map((d) => d.value === null ? d.name : `${d.name}=${d.value}`).join(", ");
+  const snippet = `Cache-Control: ${header}`;
+  return { header, headerName: "Cache-Control", snippet, directives, warnings };
+}
 
 // src/tools/api.ts
 var api_exports = {};

package/dist/index.d.cts

@@ -1,12 +1,12 @@
-export { j as json } from './json-BjSoIS1h.cjs';
+export { j as json } from './json-DEVFIpsC.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CnetQFD_.cjs';
-export { t as text } from './text-Bbx-tZ43.cjs';
+export { t as text } from './text-DS70aMY5.cjs';
 export { d as data } from './data-D8XTI7Du.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-DbT8fjaF.cjs';
-export { u as units } from './units-BFTQwpBu.cjs';
-export { n as network } from './network-DZugNyAQ.cjs';
+export { u as units } from './units-pIRkHnsU.cjs';
+export { n as network } from './network-BJOjJnmY.cjs';
 export { a as api } from './api-Xl7OzIgq.cjs';
 export { c as code } from './code-DaRvff2v.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-export { j as json } from './json-BjSoIS1h.js';
+export { j as json } from './json-DEVFIpsC.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
 export { h as hashing } from './hashing-CnetQFD_.js';
-export { t as text } from './text-Bbx-tZ43.js';
+export { t as text } from './text-DS70aMY5.js';
 export { d as data } from './data-D8XTI7Du.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-DbT8fjaF.js';
-export { u as units } from './units-BFTQwpBu.js';
-export { n as network } from './network-DZugNyAQ.js';
+export { u as units } from './units-pIRkHnsU.js';
+export { n as network } from './network-BJOjJnmY.js';
 export { a as api } from './api-Xl7OzIgq.js';
 export { c as code } from './code-DaRvff2v.js';
 export { c as color } from './color-tPwZCr9H.js';

package/dist/index.js

@@ -1,16 +1,16 @@
 export { media_exports as media } from './chunk-XMKJYVKB.js';
-export { units_exports as units } from './chunk-U34B5XPK.js';
-export { network_exports as network } from './chunk-3QMUUTBH.js';
+export { units_exports as units } from './chunk-TFNCFD3E.js';
+export { network_exports as network } from './chunk-Y5OOP6WN.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
 export { code_exports as code } from './chunk-LXKIPPDG.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';
 export { css_exports as css } from './chunk-6YPV2AB5.js';
 export { misc_exports as misc } from './chunk-GX7H6TAX.js';
 export { ai_agent_exports as ai_agent } from './chunk-265NPGKH.js';
-export { json_exports as json } from './chunk-TSAGO3XP.js';
+export { json_exports as json } from './chunk-WO3LJMVV.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
-export { text_exports as text } from './chunk-F57WMKZO.js';
+export { text_exports as text } from './chunk-2I4O5YCT.js';
 export { data_exports as data } from './chunk-TINQFTLO.js';
 export { generators_exports as generators } from './chunk-2CJSLYWI.js';
 export { time_exports as time } from './chunk-ZPQZEIXP.js';

package/dist/{json-BjSoIS1h.d.cts → json-DEVFIpsC.d.cts}

@@ -148,6 +148,28 @@ interface ZodOptions {
 declare function jsonToZod(json: string, options?: ZodOptions): string | {
     error: string;
 };
+interface JsonPointerResult {
+    pointer: string;
+    found: boolean;
+    value?: unknown;
+    /** Decoded reference tokens (after ~1 -> / and ~0 -> ~ unescaping). */
+    tokens: string[];
+    /** Set when the input JSON is invalid or the pointer syntax is malformed. */
+    error?: string;
+    /** The reference token at which resolution stopped (found === false). */
+    failedAt?: string;
+    /** Why resolution stopped at `failedAt`. */
+    reason?: string;
+}
+/**
+ * Resolve an RFC 6901 JSON Pointer against a JSON document. Accepts both the
+ * plain form ("" for the whole document, or "/foo/0") and the URI-fragment
+ * form ("#/foo/0", percent-decoded). Distinguishes an invalid document /
+ * malformed pointer (`error`) from a syntactically valid pointer whose target
+ * is simply absent (`found: false` with `failedAt` + `reason`). Pure
+ * traversal, no external calls.
+ */
+declare function resolveJsonPointer(json: string, pointer: string): JsonPointerResult;
 
 type json_ConvertOptions = ConvertOptions;
 type json_CsvOptions = CsvOptions;
@@ -158,6 +180,7 @@ type json_GoStruct = GoStruct;
 type json_JsonDiffResult = JsonDiffResult;
 type json_JsonParseResult = JsonParseResult;
 type json_JsonPathResult = JsonPathResult;
+type json_JsonPointerResult = JsonPointerResult;
 type json_ParseStatus = ParseStatus;
 type json_PythonClass = PythonClass;
 type json_PythonField = PythonField;
@@ -185,6 +208,7 @@ declare const json_jsonToZod: typeof jsonToZod;
 declare const json_minifyJson: typeof minifyJson;
 declare const json_parseJson: typeof parseJson;
 declare const json_parseStructs: typeof parseStructs;
+declare const json_resolveJsonPointer: typeof resolveJsonPointer;
 declare const json_toPascalCase: typeof toPascalCase;
 declare const json_toSnakeCase: typeof toSnakeCase;
 declare const json_validateJson: typeof validateJson;
@@ -192,7 +216,7 @@ declare const json_validateJsonPath: typeof validateJsonPath;
 declare const json_validateJsonString: typeof validateJsonString;
 declare const json_yamlToJson: typeof yamlToJson;
 declare namespace json {
-  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
+  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_JsonPointerResult as JsonPointerResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_resolveJsonPointer as resolveJsonPointer, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
 }
 
-export { jsonToZod as A, minifyJson as B, type ConvertOptions as C, type DiffNode as D, parseJson as E, parseStructs as F, type GoField as G, toPascalCase as H, toSnakeCase as I, type JsonDiffResult as J, validateJson as K, validateJsonPath as L, validateJsonString as M, yamlToJson as N, type ParseStatus as P, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type PythonClass as f, type PythonField as g, type PythonMode as h, type ValidationResult as i, json as j, csvToJson as k, detectFormat as l, diffJson as m, evaluateJsonPath as n, formatDiffLine as o, formatJson as p, generateExample as q, getJsonStats as r, inferGoType as s, inferPythonType as t, inferType as u, jsonToCsv as v, jsonToGo as w, jsonToPython as x, jsonToTypescript as y, jsonToYaml as z };
+export { jsonToYaml as A, jsonToZod as B, type ConvertOptions as C, type DiffNode as D, minifyJson as E, parseJson as F, type GoField as G, parseStructs as H, resolveJsonPointer as I, type JsonDiffResult as J, toPascalCase as K, toSnakeCase as L, validateJson as M, validateJsonPath as N, validateJsonString as O, type ParseStatus as P, yamlToJson as Q, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type JsonPointerResult as f, type PythonClass as g, type PythonField as h, type PythonMode as i, json as j, type ValidationResult as k, csvToJson as l, detectFormat as m, diffJson as n, evaluateJsonPath as o, formatDiffLine as p, formatJson as q, generateExample as r, getJsonStats as s, inferGoType as t, inferPythonType as u, inferType as v, jsonToCsv as w, jsonToGo as x, jsonToPython as y, jsonToTypescript as z };

package/dist/{json-BjSoIS1h.d.ts → json-DEVFIpsC.d.ts}

@@ -148,6 +148,28 @@ interface ZodOptions {
 declare function jsonToZod(json: string, options?: ZodOptions): string | {
     error: string;
 };
+interface JsonPointerResult {
+    pointer: string;
+    found: boolean;
+    value?: unknown;
+    /** Decoded reference tokens (after ~1 -> / and ~0 -> ~ unescaping). */
+    tokens: string[];
+    /** Set when the input JSON is invalid or the pointer syntax is malformed. */
+    error?: string;
+    /** The reference token at which resolution stopped (found === false). */
+    failedAt?: string;
+    /** Why resolution stopped at `failedAt`. */
+    reason?: string;
+}
+/**
+ * Resolve an RFC 6901 JSON Pointer against a JSON document. Accepts both the
+ * plain form ("" for the whole document, or "/foo/0") and the URI-fragment
+ * form ("#/foo/0", percent-decoded). Distinguishes an invalid document /
+ * malformed pointer (`error`) from a syntactically valid pointer whose target
+ * is simply absent (`found: false` with `failedAt` + `reason`). Pure
+ * traversal, no external calls.
+ */
+declare function resolveJsonPointer(json: string, pointer: string): JsonPointerResult;
 
 type json_ConvertOptions = ConvertOptions;
 type json_CsvOptions = CsvOptions;
@@ -158,6 +180,7 @@ type json_GoStruct = GoStruct;
 type json_JsonDiffResult = JsonDiffResult;
 type json_JsonParseResult = JsonParseResult;
 type json_JsonPathResult = JsonPathResult;
+type json_JsonPointerResult = JsonPointerResult;
 type json_ParseStatus = ParseStatus;
 type json_PythonClass = PythonClass;
 type json_PythonField = PythonField;
@@ -185,6 +208,7 @@ declare const json_jsonToZod: typeof jsonToZod;
 declare const json_minifyJson: typeof minifyJson;
 declare const json_parseJson: typeof parseJson;
 declare const json_parseStructs: typeof parseStructs;
+declare const json_resolveJsonPointer: typeof resolveJsonPointer;
 declare const json_toPascalCase: typeof toPascalCase;
 declare const json_toSnakeCase: typeof toSnakeCase;
 declare const json_validateJson: typeof validateJson;
@@ -192,7 +216,7 @@ declare const json_validateJsonPath: typeof validateJsonPath;
 declare const json_validateJsonString: typeof validateJsonString;
 declare const json_yamlToJson: typeof yamlToJson;
 declare namespace json {
-  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
+  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_JsonPointerResult as JsonPointerResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_resolveJsonPointer as resolveJsonPointer, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
 }
 
-export { jsonToZod as A, minifyJson as B, type ConvertOptions as C, type DiffNode as D, parseJson as E, parseStructs as F, type GoField as G, toPascalCase as H, toSnakeCase as I, type JsonDiffResult as J, validateJson as K, validateJsonPath as L, validateJsonString as M, yamlToJson as N, type ParseStatus as P, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type PythonClass as f, type PythonField as g, type PythonMode as h, type ValidationResult as i, json as j, csvToJson as k, detectFormat as l, diffJson as m, evaluateJsonPath as n, formatDiffLine as o, formatJson as p, generateExample as q, getJsonStats as r, inferGoType as s, inferPythonType as t, inferType as u, jsonToCsv as v, jsonToGo as w, jsonToPython as x, jsonToTypescript as y, jsonToYaml as z };
+export { jsonToYaml as A, jsonToZod as B, type ConvertOptions as C, type DiffNode as D, minifyJson as E, parseJson as F, type GoField as G, parseStructs as H, resolveJsonPointer as I, type JsonDiffResult as J, toPascalCase as K, toSnakeCase as L, validateJson as M, validateJsonPath as N, validateJsonString as O, type ParseStatus as P, yamlToJson as Q, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type JsonPointerResult as f, type PythonClass as g, type PythonField as h, type PythonMode as i, json as j, type ValidationResult as k, csvToJson as l, detectFormat as m, diffJson as n, evaluateJsonPath as o, formatDiffLine as p, formatJson as q, generateExample as r, getJsonStats as s, inferGoType as t, inferPythonType as u, inferType as v, jsonToCsv as w, jsonToGo as x, jsonToPython as y, jsonToTypescript as z };

package/dist/{network-DZugNyAQ.d.cts → network-BJOjJnmY.d.cts}

@@ -11,6 +11,7 @@
  *   - sitemap-validator: validateSitemap
  *   - robots-txt-validator: validateRobotsTxt
  *   - user-agent-parser: parseUserAgent
+ *   - cache-control-builder: buildCacheControl
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -252,7 +253,48 @@ interface UserAgentInfo {
 declare function parseUserAgent(ua: string): UserAgentInfo | {
     error: string;
 };
+interface CacheControlOptions {
+    /** `public` (any cache) or `private` (browser only). */
+    visibility?: 'public' | 'private' | null;
+    noCache?: boolean;
+    noStore?: boolean;
+    noTransform?: boolean;
+    mustRevalidate?: boolean;
+    proxyRevalidate?: boolean;
+    immutable?: boolean;
+    mustUnderstand?: boolean;
+    /** Freshness lifetime in seconds. */
+    maxAge?: number | null;
+    /** Freshness lifetime for shared caches, in seconds. */
+    sMaxAge?: number | null;
+    staleWhileRevalidate?: number | null;
+    staleIfError?: number | null;
+}
+interface CacheControlDirective {
+    name: string;
+    value: string | null;
+    explanation: string;
+}
+interface CacheControlResult {
+    header: string;
+    headerName: 'Cache-Control';
+    snippet: string;
+    directives: CacheControlDirective[];
+    warnings: string[];
+}
+/**
+ * Build a `Cache-Control` response-header value from a set of directives,
+ * with a plain-English explanation of each and warnings for combinations
+ * that cancel each other out. Pure string assembly: it never fetches or
+ * validates against a live origin.
+ */
+declare function buildCacheControl(options?: CacheControlOptions): CacheControlResult | {
+    error: string;
+};
 
+type network_CacheControlDirective = CacheControlDirective;
+type network_CacheControlOptions = CacheControlOptions;
+type network_CacheControlResult = CacheControlResult;
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
 type network_DnsRecordType = DnsRecordType;
@@ -278,6 +320,7 @@ type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
 type network_UaDeviceType = UaDeviceType;
 type network_UserAgentInfo = UserAgentInfo;
+declare const network_buildCacheControl: typeof buildCacheControl;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
 declare const network_buildMapUrl: typeof buildMapUrl;
@@ -309,7 +352,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { validateHeaderValue as $, getHeader as A, getHeadersByCategory as B, getStatusByCategory as C, DNS_RECORD_TYPES as D, getStatusCode as E, isClientError as F, type GeoResult as G, HTTP_HEADERS as H, isServerError as I, isSuccess as J, isValidIp as K, isValidIpv4 as L, isValidIpv6 as M, parseDnsResponse as N, parseGeoResponse as O, type ParsedDnsResult as P, parseHar as Q, type RobotsGroup as R, STATUS_CODES as S, parseUserAgent as T, type UaDeviceType as U, searchHeaders as V, searchStatusCodes as W, statusCodeToText as X, typeNumberToLabel as Y, validateDomain as Z, validateHeaderName as _, type DnsRecord as a, validateRobotsTxt as a0, validateSitemap as a1, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, type UserAgentInfo as s, buildDnsQueryUrl as t, buildGeoUrl as u, buildMapUrl as v, countryCodeToFlag as w, formatCoordinates as x, formatTtl as y, getByCategory as z };
+export { statusCodeToText as $, formatCoordinates as A, formatTtl as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, getByCategory as E, getHeader as F, type GeoResult as G, HTTP_HEADERS as H, getHeadersByCategory as I, getStatusByCategory as J, getStatusCode as K, isClientError as L, isServerError as M, isSuccess as N, isValidIp as O, type ParsedDnsResult as P, isValidIpv4 as Q, type RobotsGroup as R, STATUS_CODES as S, isValidIpv6 as T, type UaDeviceType as U, parseDnsResponse as V, parseGeoResponse as W, parseHar as X, parseUserAgent as Y, searchHeaders as Z, searchStatusCodes as _, type CacheControlOptions as a, typeNumberToLabel as a0, validateDomain as a1, validateHeaderName as a2, validateHeaderValue as a3, validateRobotsTxt as a4, validateSitemap as a5, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type ParsedGeoResult as k, type RobotsIssue as l, type RobotsRule as m, network as n, type RobotsValidationResult as o, type SitemapIndexEntry as p, type SitemapIssue as q, type SitemapUrlEntry as r, type SitemapValidationResult as s, type StatusCode as t, type UserAgentInfo as u, buildCacheControl as v, buildDnsQueryUrl as w, buildGeoUrl as x, buildMapUrl as y, countryCodeToFlag as z };