@utilix-tech/sdk 0.79.0 → 0.81.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.81.0
+- Add `validateFenceLanguageTags` (markdown-fence-lang-validator): scan a Markdown document's fenced code blocks and flag a missing, unknown, or inconsistently-cased language tag against a curated list of common syntax-highlighter identifiers.
+- Add `countSqlPlaceholders` (sql-placeholder-counter): count positional (`?`, `$1`) and named (`:name`, `@name`) parameter placeholders in a SQL query, flagging mixed styles and numbered-sequence gaps or duplicates.
+
+## 0.80.0
+- Add `diffJsonPatch`, `applyJsonPatch`, `generateJsonPatch` (json-patch): diff two JSON documents into an RFC 6902 JSON Patch operation list (add/remove/replace/move/copy/test), or apply a patch to a target document.
+- Add `parseConnectionString` (connection-string-parser): parse a database connection URI (postgres, mysql, mongodb, redis, amqp, and similar) into its scheme, credentials, hosts, database, and query parameters.
+
 ## 0.79.0
 - Add `calculateRealRateOfReturn` (real-rate-of-return-calculator): apply the Fisher equation to solve for whichever of the nominal rate, inflation rate, or inflation-adjusted real rate is missing, given exactly two of the three.
 - Add `calculateRetryBackoffSchedule` (retry-backoff-calculator): compute the full sequence of delays an exponential-backoff retry policy would actually produce, optionally capped and with full/equal jitter ranges, plus the total best-case and worst-case wait across all retries.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**706 developer utility functions for Node.js: runs locally, no API key required.**
+**715 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)
@@ -66,7 +66,8 @@ const { formatJson } = require("@utilix-tech/sdk/json");
 
 ```ts
 import { formatJson, minifyJson, diffJson, jsonToTypescript, jsonSchemaToTypescript, validateJson,
-         evaluateJsonPath, resolveJsonPointer, applyJsonMergePatch, jsonToCsv, yamlToJson, jsonToYaml, getJsonStats } from "@utilix-tech/sdk/json";
+         evaluateJsonPath, resolveJsonPointer, applyJsonMergePatch, diffJsonPatch, applyJsonPatch,
+         jsonToCsv, yamlToJson, jsonToYaml, getJsonStats } from "@utilix-tech/sdk/json";
 
 // Format with 2-space indent
 formatJson('{"name":"alice","age":30}', { indent: 2 });
@@ -91,6 +92,12 @@ resolveJsonPointer('{"users":[{"name":"Alice"}]}', "/users/0/name");
 applyJsonMergePatch('{"a":"b","c":{"d":"e","f":"g"}}', '{"a":"z","c":{"f":null}}');
 // { result: { a: "z", c: { d: "e" } } }
 
+// Diff two documents into an RFC 6902 JSON Patch, or apply one
+diffJsonPatch({ a: 1 }, { a: 2 });
+// [{ op: "replace", path: "/a", value: 2 }]
+applyJsonPatch({ foo: "bar" }, [{ op: "add", path: "/baz", value: "qux" }]);
+// { result: { foo: "bar", baz: "qux" } }
+
 // Convert JSON to CSV
 jsonToCsv('[{"a":1,"b":2}]');
 
@@ -773,7 +780,8 @@ generateCspHeader({ "default-src": ["'self'"], "script-src": ["'self'", "cdn.exa
 import { formatSql, minifySql, testRegex, formatHtml, formatGql,
          detectDialect, splitStatements, lookupMime, parseGithubUrl,
          detectRedos, analyzeRegexGroups, testGitignorePatterns, validateEditorConfig,
-         validateTsconfig, validatePackageExports } from "@utilix-tech/sdk/code";
+         validateTsconfig, validatePackageExports, parseConnectionString,
+         validateFenceLanguageTags, countSqlPlaceholders } from "@utilix-tech/sdk/code";
 
 // SQL
 formatSql("SELECT id,name FROM users WHERE active=1 ORDER BY name");
@@ -806,6 +814,18 @@ lookupMime("image/jpeg");  // { kind: "mime", matches: [{ extension: "jpg", ...
 parseGithubUrl("https://github.com/facebook/react/pull/1234");
 // { owner: "facebook", repo: "react", type: "pull", number: 1234 }
 
+// Database connection string parsing
+parseConnectionString("postgres://user:pass@localhost:5432/mydb?sslmode=require");
+// { scheme: "postgres", user: "user", password: "pass", hosts: [{ host: "localhost", port: 5432 }], database: "mydb", params: { sslmode: "require" } }
+
+// Markdown code fence language tag validation
+validateFenceLanguageTags("```JS\nconsole.log(1)\n```\n");
+// { totalFences: 1, issues: [{ line: 1, tag: "JS", issue: "inconsistent-case", suggestion: "js" }] }
+
+// SQL query parameter placeholder counting
+countSqlPlaceholders("SELECT * FROM users WHERE id = ? AND age > $1");
+// { placeholders: [...], counts: { anonymous: 1, numbered: 1, "named-colon": 0, "named-at": 0 }, mixedStyles: true, numberedGaps: [], numberedDuplicates: [] }
+
 // Regex ReDoS (catastrophic-backtracking) detection
 detectRedos("(a+)+");
 // { risk: "high", safe: false, findings: [{ type: "nested-quantifier", ... }] }
@@ -1026,7 +1046,7 @@ readMidiInfo(new Uint8Array(midiBytes));
 | `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN/VIN/ISIN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator, savings goal calculator, ROI calculator, cash denomination/till calculator, payback period calculator, CD maturity calculator, debt-to-income ratio calculator, freelancer hourly rate calculator, debt snowball/avalanche payoff planner, tax-equivalent yield calculator, mortgage discount points break-even calculator, loan prepayment penalty calculator, data transfer time / required bandwidth estimator, real rate of return (Fisher equation) calculator |
 | `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand, Permissions-Policy header builder, Client Hints header builder/parser, Content-Disposition header builder/parser, X-Content-Type-Options header builder/risk assessor, sitemap.xml validator, sitemap index splitter, Prefer header builder/parser (RFC 7240), Retry-After header builder/parser (RFC 9110), Priority header builder/parser (RFC 9218), WebSocket close code reference/lookup, Strict-Transport-Security (HSTS) header builder/parser, X-Robots-Tag header builder/parser, WebSocket frame opcode reference/lookup, robots meta tag builder/parser, Cookie header byte-size budget calculator |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header, TOTP/HOTP code generator, webhook HMAC signature verifier |
-| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter, package.json exports field validator, package.json dependency range auditor, regex capture group/backreference visualizer, SVG sprite symbol extractor, ARIA role & attribute validator |
+| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter, package.json exports field validator, package.json dependency range auditor, regex capture group/backreference visualizer, SVG sprite symbol extractor, ARIA role & attribute validator, database connection string parser, Markdown code fence language tag validator, SQL query parameter placeholder counter |
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |

package/dist/{chunk-XT2BQWXT.js → chunk-FPFA4ZHC.js}

@@ -7,6 +7,7 @@ __export(code_exports, {
   ALL_FLAGS: () => ALL_FLAGS,
   CHEATSHEET: () => CHEATSHEET,
   DEFAULT_COMMIT_TYPES: () => DEFAULT_COMMIT_TYPES,
+  KNOWN_LANGUAGE_TAGS: () => KNOWN_LANGUAGE_TAGS,
   MIME_TABLE: () => MIME_TABLE,
   OPERATIONS: () => OPERATIONS,
   SQL_DEFAULT_OPTIONS: () => SQL_DEFAULT_OPTIONS,
@@ -19,6 +20,7 @@ __export(code_exports, {
   collapseJsWhitespace: () => collapseJsWhitespace,
   countProperties: () => countProperties,
   countRules: () => countRules,
+  countSqlPlaceholders: () => countSqlPlaceholders,
   detectDialect: () => detectDialect,
   detectOperationType: () => detectOperationType,
   detectRedos: () => detectRedos,
@@ -44,6 +46,7 @@ __export(code_exports, {
   minifySql: () => minifySql,
   normalizeRef: () => normalizeRef,
   parseCommitTrailers: () => parseCommitTrailers,
+  parseConnectionString: () => parseConnectionString,
   parseDockerImage: () => parseDockerImage,
   parseEnv: () => parseEnv,
   parseGitCommand: () => parseGitCommand,
@@ -63,6 +66,7 @@ __export(code_exports, {
   validateAria: () => validateAria,
   validateEditorConfig: () => validateEditorConfig,
   validateEnvKey: () => validateEnvKey,
+  validateFenceLanguageTags: () => validateFenceLanguageTags,
   validatePackageExports: () => validatePackageExports,
   validateTsconfig: () => validateTsconfig
 });
@@ -3876,5 +3880,393 @@ function validateAria(html) {
     valid: issues.every((i) => i.severity !== "error")
   };
 }
+var CONNECTION_STRING_RE = /^([a-zA-Z][a-zA-Z0-9+.-]*):\/\/(?:([^@/?#]*)@)?([^/?#]*)(?:\/([^?#]*))?(?:\?([^#]*))?$/;
+function _parseConnectionHost(segment) {
+  const ipv6Match = segment.match(/^\[([^\]]+)\](?::(\d+))?$/);
+  if (ipv6Match) {
+    return { host: ipv6Match[1], port: ipv6Match[2] ? parseInt(ipv6Match[2], 10) : null };
+  }
+  const lastColon = segment.lastIndexOf(":");
+  if (lastColon === -1) return { host: segment, port: null };
+  const portPart = segment.slice(lastColon + 1);
+  if (!/^\d+$/.test(portPart)) return { host: segment, port: null };
+  return { host: segment.slice(0, lastColon), port: parseInt(portPart, 10) };
+}
+function parseConnectionString(input) {
+  if (!input || typeof input !== "string" || !input.trim()) {
+    return { error: "Connection string is empty" };
+  }
+  const trimmed = input.trim();
+  const match = trimmed.match(CONNECTION_STRING_RE);
+  if (!match) {
+    return { error: "Not a valid scheme://[user[:password]@]host[,host2][/database][?params] connection string" };
+  }
+  const [, scheme, userinfo, hostPart, databasePart, queryPart] = match;
+  let user = null;
+  let password = null;
+  if (userinfo) {
+    const sepIndex = userinfo.indexOf(":");
+    if (sepIndex === -1) {
+      user = decodeURIComponent(userinfo);
+    } else {
+      user = decodeURIComponent(userinfo.slice(0, sepIndex));
+      password = decodeURIComponent(userinfo.slice(sepIndex + 1));
+    }
+  }
+  const hosts = hostPart ? hostPart.split(",").filter(Boolean).map(_parseConnectionHost) : [];
+  const database = databasePart ? decodeURIComponent(databasePart) : null;
+  const params = {};
+  if (queryPart) {
+    for (const pair of queryPart.split("&")) {
+      if (!pair) continue;
+      const eqIndex = pair.indexOf("=");
+      const key = eqIndex === -1 ? pair : pair.slice(0, eqIndex);
+      const value = eqIndex === -1 ? "" : pair.slice(eqIndex + 1);
+      params[decodeURIComponent(key)] = decodeURIComponent(value);
+    }
+  }
+  return { scheme, user, password, hosts, database, params };
+}
+var KNOWN_LANGUAGE_TAGS = /* @__PURE__ */ new Set([
+  "js",
+  "jsx",
+  "mjs",
+  "cjs",
+  "javascript",
+  "ts",
+  "tsx",
+  "typescript",
+  "json",
+  "json5",
+  "jsonc",
+  "jsonl",
+  "ndjson",
+  "yaml",
+  "yml",
+  "toml",
+  "ini",
+  "cfg",
+  "conf",
+  "properties",
+  "env",
+  "dotenv",
+  "html",
+  "htm",
+  "xml",
+  "svg",
+  "xhtml",
+  "css",
+  "scss",
+  "sass",
+  "less",
+  "stylus",
+  "styl",
+  "markdown",
+  "md",
+  "mdx",
+  "bash",
+  "sh",
+  "shell",
+  "zsh",
+  "fish",
+  "console",
+  "powershell",
+  "ps1",
+  "bat",
+  "cmd",
+  "python",
+  "py",
+  "py3",
+  "ipynb",
+  "ruby",
+  "rb",
+  "erb",
+  "php",
+  "java",
+  "kotlin",
+  "kt",
+  "kts",
+  "groovy",
+  "gradle",
+  "swift",
+  "objectivec",
+  "objc",
+  "go",
+  "golang",
+  "rust",
+  "rs",
+  "c",
+  "h",
+  "cpp",
+  "cc",
+  "cxx",
+  "hpp",
+  "c++",
+  "csharp",
+  "cs",
+  "fsharp",
+  "fs",
+  "perl",
+  "pl",
+  "lua",
+  "r",
+  "matlab",
+  "m",
+  "scala",
+  "nim",
+  "zig",
+  "julia",
+  "jl",
+  "haskell",
+  "hs",
+  "elixir",
+  "ex",
+  "exs",
+  "erlang",
+  "erl",
+  "clojure",
+  "clj",
+  "cljs",
+  "dart",
+  "ocaml",
+  "ml",
+  "sql",
+  "mysql",
+  "postgresql",
+  "plsql",
+  "sqlite",
+  "graphql",
+  "gql",
+  "dockerfile",
+  "docker",
+  "makefile",
+  "make",
+  "cmake",
+  "nginx",
+  "apache",
+  "diff",
+  "patch",
+  "git",
+  "http",
+  "proto",
+  "protobuf",
+  "csv",
+  "tsv",
+  "vim",
+  "viml",
+  "tex",
+  "latex",
+  "bibtex",
+  "plaintext",
+  "text",
+  "txt",
+  "nohighlight",
+  "none",
+  "asciidoc",
+  "adoc",
+  "rst",
+  "vue",
+  "svelte",
+  "astro",
+  "wasm",
+  "wat",
+  "handlebars",
+  "hbs",
+  "pug",
+  "jade",
+  "coffee",
+  "coffeescript",
+  "actionscript",
+  "terraform",
+  "tf",
+  "hcl",
+  "puppet",
+  "ansible"
+]);
+function _parseFenceLine(line) {
+  const match = line.match(/^( {0,3})(`{3,}|~{3,})(.*)$/);
+  if (!match) return null;
+  const [, indent, marker, rest] = match;
+  const char = marker[0];
+  if (char === "`" && rest.includes("`")) return null;
+  return { indent: indent.length, char, length: marker.length, infoString: rest.trim() };
+}
+function _isClosingFence(line, fenceChar, fenceLength) {
+  const match = line.match(/^ {0,3}(`+|~+)\s*$/);
+  if (!match) return false;
+  const marker = match[1];
+  return marker[0] === fenceChar && marker.length >= fenceLength;
+}
+function validateFenceLanguageTags(markdown) {
+  const lines = markdown.split("\n");
+  const issues = [];
+  let totalFences = 0;
+  let open = null;
+  for (let i = 0; i < lines.length; i++) {
+    const lineNumber = i + 1;
+    const line = lines[i];
+    if (open) {
+      if (_isClosingFence(line, open.char, open.length)) open = null;
+      continue;
+    }
+    const fence = _parseFenceLine(line);
+    if (!fence) continue;
+    totalFences++;
+    const tag = fence.infoString.split(/\s+/)[0] ?? "";
+    open = { char: fence.char, length: fence.length };
+    if (tag === "") {
+      issues.push({ line: lineNumber, tag, issue: "missing" });
+      continue;
+    }
+    const lower = tag.toLowerCase();
+    if (!KNOWN_LANGUAGE_TAGS.has(lower)) {
+      issues.push({ line: lineNumber, tag, issue: "unknown" });
+      continue;
+    }
+    if (tag !== lower) {
+      issues.push({ line: lineNumber, tag, issue: "inconsistent-case", suggestion: lower });
+    }
+  }
+  return { totalFences, issues };
+}
+var _IDENT_START = /[A-Za-z_]/;
+var _IDENT_CHAR = /[A-Za-z0-9_]/;
+function _readIdentifier(sql, start) {
+  let end = start;
+  while (end < sql.length && _IDENT_CHAR.test(sql[end])) end++;
+  return sql.slice(start, end);
+}
+function countSqlPlaceholders(sql) {
+  const placeholders = [];
+  let state = "normal";
+  let i = 0;
+  while (i < sql.length) {
+    const ch = sql[i];
+    const next = sql[i + 1];
+    if (state === "single") {
+      if (ch === "'" && next === "'") {
+        i += 2;
+        continue;
+      }
+      if (ch === "'") {
+        state = "normal";
+        i++;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (state === "double") {
+      if (ch === '"' && next === '"') {
+        i += 2;
+        continue;
+      }
+      if (ch === '"') {
+        state = "normal";
+        i++;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (state === "line-comment") {
+      if (ch === "\n") state = "normal";
+      i++;
+      continue;
+    }
+    if (state === "block-comment") {
+      if (ch === "*" && next === "/") {
+        state = "normal";
+        i += 2;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (ch === "'") {
+      state = "single";
+      i++;
+      continue;
+    }
+    if (ch === '"') {
+      state = "double";
+      i++;
+      continue;
+    }
+    if (ch === "-" && next === "-") {
+      state = "line-comment";
+      i += 2;
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      state = "block-comment";
+      i += 2;
+      continue;
+    }
+    if (ch === "?") {
+      placeholders.push({ style: "anonymous", raw: "?", index: i });
+      i++;
+      continue;
+    }
+    if (ch === "$" && /[0-9]/.test(next ?? "")) {
+      let end = i + 1;
+      while (end < sql.length && /[0-9]/.test(sql[end])) end++;
+      const raw = sql.slice(i, end);
+      placeholders.push({ style: "numbered", raw, index: i, number: parseInt(raw.slice(1), 10) });
+      i = end;
+      continue;
+    }
+    if (ch === ":") {
+      if (next === ":") {
+        i += 2;
+        continue;
+      }
+      if (next && _IDENT_START.test(next)) {
+        const name = _readIdentifier(sql, i + 1);
+        placeholders.push({ style: "named-colon", raw: `:${name}`, index: i, name });
+        i += 1 + name.length;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (ch === "@") {
+      if (next === "@") {
+        i += 2;
+        continue;
+      }
+      if (next && _IDENT_START.test(next)) {
+        const name = _readIdentifier(sql, i + 1);
+        placeholders.push({ style: "named-at", raw: `@${name}`, index: i, name });
+        i += 1 + name.length;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    i++;
+  }
+  const counts = { anonymous: 0, numbered: 0, "named-colon": 0, "named-at": 0 };
+  for (const p of placeholders) counts[p.style]++;
+  const stylesUsed = ["anonymous", "numbered", "named-colon", "named-at"].filter((s) => counts[s] > 0);
+  const numbers = placeholders.filter((p) => p.style === "numbered").map((p) => p.number);
+  const maxNumber = numbers.length > 0 ? Math.max(...numbers) : 0;
+  const seen = new Set(numbers);
+  const numberedGaps = [];
+  for (let n = 1; n < maxNumber; n++) {
+    if (!seen.has(n)) numberedGaps.push(n);
+  }
+  const countedMap = /* @__PURE__ */ new Map();
+  for (const n of numbers) countedMap.set(n, (countedMap.get(n) ?? 0) + 1);
+  const numberedDuplicates = [...countedMap.entries()].filter(([, c]) => c > 1).map(([n]) => n).sort((a, b) => a - b);
+  return {
+    placeholders,
+    counts,
+    stylesUsed,
+    mixedStyles: stylesUsed.length > 1,
+    numberedGaps,
+    numberedDuplicates
+  };
+}
 
-export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractMarkdownFootnotes, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseCommitTrailers, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateAria, validateEditorConfig, validateEnvKey, validatePackageExports, validateTsconfig };
+export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, KNOWN_LANGUAGE_TAGS, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, countSqlPlaceholders, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractMarkdownFootnotes, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseCommitTrailers, parseConnectionString, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateAria, validateEditorConfig, validateEnvKey, validateFenceLanguageTags, validatePackageExports, validateTsconfig };