@utilix-tech/sdk 0.82.0 → 0.84.0

package/dist/tools/code.cjs

@@ -1801,6 +1801,111 @@ function normalizeRef(ref) {
   const tagPart = parsed.digest ? `@${parsed.digest}` : parsed.tag ? `:${parsed.tag}` : "";
   return `${parsed.registry}/${ns}${parsed.repository}${tagPart}`;
 }
+function _parseDockerfileInstructions(content) {
+  const rawLines = content.replace(/\r\n/g, "\n").split("\n");
+  const instructions = [];
+  let buffer = "";
+  let bufferStartLine = 0;
+  for (let i = 0; i < rawLines.length; i++) {
+    const lineNo = i + 1;
+    const line = rawLines[i];
+    const trimmed = line.trim();
+    if (buffer === "") {
+      if (trimmed === "" || trimmed.startsWith("#")) continue;
+      bufferStartLine = lineNo;
+      buffer = line.trimEnd();
+    } else {
+      buffer += "\n" + line.trimEnd();
+    }
+    if (buffer.endsWith("\\")) {
+      buffer = buffer.slice(0, -1);
+      continue;
+    }
+    const match = buffer.trim().match(/^([A-Za-z]+)\s*([\s\S]*)$/);
+    if (match) {
+      instructions.push({ instruction: match[1].toUpperCase(), args: match[2].trim(), line: bufferStartLine });
+    }
+    buffer = "";
+  }
+  return instructions;
+}
+var _DOCKERFILE_TAR_RE = /\.(tar(\.(gz|bz2|xz))?|tgz|tbz2|txz)$/i;
+function lintDockerfile(content) {
+  if (!content || !content.trim()) return { error: "Dockerfile content is required" };
+  const instructions = _parseDockerfileInstructions(content);
+  if (instructions.length === 0) return { error: "No Dockerfile instructions found" };
+  const fromInstructions = instructions.filter((i) => i.instruction === "FROM");
+  if (fromInstructions.length === 0) return { error: "No FROM instruction found; this does not look like a valid Dockerfile" };
+  const stageNames = /* @__PURE__ */ new Set();
+  const stages = fromInstructions.map((inst, idx) => {
+    const asMatch = inst.args.match(/^(\S+)(?:\s+AS\s+(\S+))?/i);
+    const baseImage = asMatch ? asMatch[1] : inst.args.split(/\s+/)[0];
+    const name = asMatch && asMatch[2] ? asMatch[2] : null;
+    if (name) stageNames.add(name.toLowerCase());
+    return { index: idx, name, baseImage, fromLine: inst.line };
+  });
+  const findings = [];
+  for (const stage of stages) {
+    const base = stage.baseImage;
+    if (base.toLowerCase() === "scratch") continue;
+    if (stageNames.has(base.toLowerCase())) continue;
+    const withoutDigest = base.split("@")[0];
+    const hasTag = withoutDigest.includes(":");
+    const tag = hasTag ? withoutDigest.split(":").pop() : null;
+    if (!hasTag) {
+      findings.push({
+        rule: "unpinned-base-image",
+        severity: "warning",
+        line: stage.fromLine,
+        message: `FROM ${base} has no tag, so it resolves to ":latest", which can silently change what gets built on a future run. Pin an explicit version tag instead.`
+      });
+    } else if (tag === "latest") {
+      findings.push({
+        rule: "unpinned-base-image",
+        severity: "warning",
+        line: stage.fromLine,
+        message: `FROM ${base} is explicitly pinned to the "latest" tag, which is a moving target rather than a fixed version. Pin an explicit version tag instead.`
+      });
+    }
+  }
+  const finalStage = stages[stages.length - 1];
+  const finalStageInstructions = instructions.filter((i) => i.line >= finalStage.fromLine);
+  if (!finalStageInstructions.some((i) => i.instruction === "WORKDIR")) {
+    findings.push({
+      rule: "missing-workdir",
+      severity: "warning",
+      line: finalStage.fromLine,
+      message: 'No WORKDIR instruction in the final stage, so RUN/CMD/ENTRYPOINT execute from "/" by default. Set an explicit WORKDIR.'
+    });
+  }
+  if (!finalStageInstructions.some((i) => i.instruction === "USER")) {
+    findings.push({
+      rule: "running-as-root",
+      severity: "warning",
+      line: finalStage.fromLine,
+      message: "No USER instruction in the final stage, so the container runs as root by default. Add a non-root USER unless root is genuinely required."
+    });
+  }
+  for (const inst of instructions) {
+    if (inst.instruction !== "ADD") continue;
+    const parts = inst.args.split(/\s+/).filter(Boolean).filter((p) => !p.startsWith("--"));
+    if (parts.length < 2) continue;
+    const sources = parts.slice(0, -1);
+    for (const src of sources) {
+      const isUrl = /^https?:\/\//i.test(src);
+      const isTar = _DOCKERFILE_TAR_RE.test(src);
+      if (!isUrl && !isTar) {
+        findings.push({
+          rule: "add-vs-copy",
+          severity: "info",
+          line: inst.line,
+          message: `ADD ${src} copies a local file/directory, not a URL or an auto-extracting archive. Use COPY instead, since ADD's extra behavior (remote fetch, tar auto-extract) doesn't apply here.`
+        });
+      }
+    }
+  }
+  return { findings, stages };
+}
 function removeJsComments(code) {
   let result = "";
   let i = 0;
@@ -4201,6 +4306,64 @@ function countSqlPlaceholders(sql) {
     numberedDuplicates
   };
 }
+var LINK_REF_DEFINITION_REGEX = /^ {0,3}\[([^\]]+)\]:\s*(\S+)(?:\s+(?:"([^"]*)"|'([^']*)'|\(([^)]*)\)))?\s*$/;
+var LINK_REF_USAGE_REGEX = /(!?)\[([^[\]\n]*)\]\[([^[\]\n]*)\]/g;
+function normalizeLinkLabel(label) {
+  return label.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function extractMarkdownLinkReferences(markdown) {
+  const trimmed = markdown.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const definitions = [];
+  const definitionsByLabel = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const match = line.match(LINK_REF_DEFINITION_REGEX);
+    if (!match) continue;
+    const label = match[1];
+    const normalized = normalizeLinkLabel(label);
+    if (definitionsByLabel.has(normalized)) continue;
+    const def = {
+      label,
+      url: match[2],
+      title: match[3] ?? match[4] ?? match[5] ?? void 0
+    };
+    definitionsByLabel.set(normalized, def);
+    definitions.push(def);
+  }
+  const usages = [];
+  for (const m of markdown.matchAll(LINK_REF_USAGE_REGEX)) {
+    const image = m[1] === "!";
+    const text = m[2];
+    const rawRef = m[3];
+    const label = rawRef.trim() === "" ? text : rawRef;
+    usages.push({ text, label, image });
+  }
+  if (definitions.length === 0 && usages.length === 0) {
+    return { error: "No reference-style links or definitions found" };
+  }
+  const usedLabels = /* @__PURE__ */ new Set();
+  const resolved = [];
+  const unresolvedReferences = [];
+  for (const usage of usages) {
+    const normalized = normalizeLinkLabel(usage.label);
+    const def = definitionsByLabel.get(normalized);
+    if (def) {
+      usedLabels.add(normalized);
+      resolved.push({ ...usage, url: def.url, title: def.title });
+    } else {
+      unresolvedReferences.push(usage);
+    }
+  }
+  const unusedDefinitions = definitions.filter((d) => !usedLabels.has(normalizeLinkLabel(d.label)));
+  return {
+    referenceCount: usages.length,
+    definitionCount: definitions.length,
+    resolved,
+    unresolvedReferences,
+    unusedDefinitions
+  };
+}
 
 exports.ALL_FLAGS = ALL_FLAGS;
 exports.CHEATSHEET = CHEATSHEET;
@@ -4225,6 +4388,7 @@ exports.detectRedos = detectRedos;
 exports.envToExport = envToExport;
 exports.envToJson = envToJson;
 exports.extractMarkdownFootnotes = extractMarkdownFootnotes;
+exports.extractMarkdownLinkReferences = extractMarkdownLinkReferences;
 exports.extractSvgSpriteSymbols = extractSvgSpriteSymbols;
 exports.formatCss = formatCss;
 exports.formatGql = formatGql;
@@ -4236,6 +4400,7 @@ exports.getJsStats = getJsStats;
 exports.getMethodColor = getMethodColor;
 exports.isValidTag = isValidTag;
 exports.lintConventionalCommit = lintConventionalCommit;
+exports.lintDockerfile = lintDockerfile;
 exports.lookupMime = lookupMime;
 exports.minifyCss = minifyCss;
 exports.minifyGql = minifyGql;

package/dist/tools/code.d.cts

@@ -1 +1 @@
-export { A as ALL_FLAGS, a as ApiEndpoint, b as ApiInfo, d as AriaIssue, e as AriaValidationResult, C as CHEATSHEET, f as CheatsheetEntry, g as CommitTrailer, h as CommitTrailerResult, i as ConnectionStringHost, j as ConnectionStringResult, k as ConventionalCommitFinding, l as ConventionalCommitFooter, m as ConventionalCommitOptions, n as ConventionalCommitParsed, o as ConventionalCommitResult, p as ConventionalCommitSeverity, q as CssResult, D as DEFAULT_COMMIT_TYPES, r as DependencyAuditDuplicate, s as DependencyAuditEntry, t as DependencyAuditIssue, u as DependencyAuditResult, v as DependencyRangeType, w as DependencySection, x as DockerImageRef, E as EditorConfigIssue, y as EditorConfigProperty, z as EditorConfigSection, B as EditorConfigValidationResult, F as EnvEntry, G as EnvParseResult, H as ExportsIssue, I as ExportsShape, J as ExportsValidationResult, K as FenceTagIssue, L as FenceTagIssueType, M as FenceValidationResult, N as GitCommandConfig, O as GitCommandResult, P as GitOperation, Q as GithubUrlInfo, R as GithubUrlType, S as GitignoreTestResult, T as GqlFormatResult, U as HtmlFormatResult, V as HtmlMinifyOptions, W as HtmlMinifyResult, X as JsMinifyOptions, Y as JsMinifyResult, Z as KNOWN_LANGUAGE_TAGS, _ as MIME_TABLE, $ as MarkdownFootnoteDefinition, a0 as MarkdownFootnoteReference, a1 as MarkdownFootnoteResult, a2 as MatchResult, a3 as MimeEntry, a4 as MimeLookupResult, a5 as OPERATIONS, a6 as ParsedSpec, a7 as PlaceholderStyle, a8 as RedosFinding, a9 as RedosResult, aa as RedosSeverity, ab as RegexBackreferenceInfo, ac as RegexError, ad as RegexFlag, ae as RegexGroupAnalysis, af as RegexGroupInfo, ag as RegexGroupIssue, ah as RegexMatch, ai as RegexResult, aj as RegexSuccess, ak as SQL_DEFAULT_OPTIONS, al as Segment, am as SpecVersion, an as SqlDialect, ao as SqlFormatOptions, ap as SqlPlaceholder, aq as SqlPlaceholderResult, ar as SvgSpriteResult, as as SvgSpriteSymbol, at as TestPatternResult, au as TsconfigIssue, av as TsconfigValidationResult, aw as analyzeRegexGroups, ax as auditDependencyRanges, ay as buildDockerPull, az as buildDockerRun, aA as buildGitCommand, aB as collapseHtmlWhitespace, aC as collapseJsWhitespace, aD as countProperties, aE as countRules, aF as countSqlPlaceholders, aG as detectDialect, aH as detectOperationType, aI as detectRedos, aJ as envToExport, aK as envToJson, aL as extractMarkdownFootnotes, aM as extractSvgSpriteSymbols, aN as formatCss, aO as formatGql, aP as formatHtml, aQ as formatSql, aR as getEndpointsByTag, aS as getHtmlStats, aT as getJsStats, aU as getMethodColor, aV as isValidTag, aW as lintConventionalCommit, aX as lookupMime, aY as minifyCss, aZ as minifyGql, a_ as minifyHtml, a$ as minifyJs, b0 as minifySql, b1 as normalizeRef, b2 as parseCommitTrailers, b3 as parseConnectionString, b4 as parseDockerImage, b5 as parseEnv, b6 as parseGitCommand, b7 as parseGithubUrl, b8 as parseSpec, b9 as removeConsoleCalls, ba as removeEmptyAttributes, bb as removeHtmlComments, bc as removeJsComments, bd as removeRedundantAttributes, be as searchCheatsheet, bf as searchEndpoints, bg as splitStatements, bh as testGitignorePatterns, bi as testPattern, bj as testRegex, bk as validateAria, bl as validateEditorConfig, bm as validateEnvKey, bn as validateFenceLanguageTags, bo as validatePackageExports, bp as validateTsconfig } from '../code-B8yHwP3m.cjs';
+export { A as ALL_FLAGS, a as ApiEndpoint, b as ApiInfo, d as AriaIssue, e as AriaValidationResult, C as CHEATSHEET, f as CheatsheetEntry, g as CommitTrailer, h as CommitTrailerResult, i as ConnectionStringHost, j as ConnectionStringResult, k as ConventionalCommitFinding, l as ConventionalCommitFooter, m as ConventionalCommitOptions, n as ConventionalCommitParsed, o as ConventionalCommitResult, p as ConventionalCommitSeverity, q as CssResult, D as DEFAULT_COMMIT_TYPES, r as DependencyAuditDuplicate, s as DependencyAuditEntry, t as DependencyAuditIssue, u as DependencyAuditResult, v as DependencyRangeType, w as DependencySection, x as DockerImageRef, y as DockerfileLintFinding, z as DockerfileLintResult, B as DockerfileStage, E as EditorConfigIssue, F as EditorConfigProperty, G as EditorConfigSection, H as EditorConfigValidationResult, I as EnvEntry, J as EnvParseResult, K as ExportsIssue, L as ExportsShape, M as ExportsValidationResult, N as FenceTagIssue, O as FenceTagIssueType, P as FenceValidationResult, Q as GitCommandConfig, R as GitCommandResult, S as GitOperation, T as GithubUrlInfo, U as GithubUrlType, V as GitignoreTestResult, W as GqlFormatResult, X as HtmlFormatResult, Y as HtmlMinifyOptions, Z as HtmlMinifyResult, _ as JsMinifyOptions, $ as JsMinifyResult, a0 as KNOWN_LANGUAGE_TAGS, a1 as LinkReferenceDefinition, a2 as LinkReferenceUsage, a3 as MIME_TABLE, a4 as MarkdownFootnoteDefinition, a5 as MarkdownFootnoteReference, a6 as MarkdownFootnoteResult, a7 as MarkdownLinkReferenceResult, a8 as MatchResult, a9 as MimeEntry, aa as MimeLookupResult, ab as OPERATIONS, ac as ParsedSpec, ad as PlaceholderStyle, ae as RedosFinding, af as RedosResult, ag as RedosSeverity, ah as RegexBackreferenceInfo, ai as RegexError, aj as RegexFlag, ak as RegexGroupAnalysis, al as RegexGroupInfo, am as RegexGroupIssue, an as RegexMatch, ao as RegexResult, ap as RegexSuccess, aq as ResolvedLinkReference, ar as SQL_DEFAULT_OPTIONS, as as Segment, at as SpecVersion, au as SqlDialect, av as SqlFormatOptions, aw as SqlPlaceholder, ax as SqlPlaceholderResult, ay as SvgSpriteResult, az as SvgSpriteSymbol, aA as TestPatternResult, aB as TsconfigIssue, aC as TsconfigValidationResult, aD as analyzeRegexGroups, aE as auditDependencyRanges, aF as buildDockerPull, aG as buildDockerRun, aH as buildGitCommand, aI as collapseHtmlWhitespace, aJ as collapseJsWhitespace, aK as countProperties, aL as countRules, aM as countSqlPlaceholders, aN as detectDialect, aO as detectOperationType, aP as detectRedos, aQ as envToExport, aR as envToJson, aS as extractMarkdownFootnotes, aT as extractMarkdownLinkReferences, aU as extractSvgSpriteSymbols, aV as formatCss, aW as formatGql, aX as formatHtml, aY as formatSql, aZ as getEndpointsByTag, a_ as getHtmlStats, a$ as getJsStats, b0 as getMethodColor, b1 as isValidTag, b2 as lintConventionalCommit, b3 as lintDockerfile, b4 as lookupMime, b5 as minifyCss, b6 as minifyGql, b7 as minifyHtml, b8 as minifyJs, b9 as minifySql, ba as normalizeRef, bb as parseCommitTrailers, bc as parseConnectionString, bd as parseDockerImage, be as parseEnv, bf as parseGitCommand, bg as parseGithubUrl, bh as parseSpec, bi as removeConsoleCalls, bj as removeEmptyAttributes, bk as removeHtmlComments, bl as removeJsComments, bm as removeRedundantAttributes, bn as searchCheatsheet, bo as searchEndpoints, bp as splitStatements, bq as testGitignorePatterns, br as testPattern, bs as testRegex, bt as validateAria, bu as validateEditorConfig, bv as validateEnvKey, bw as validateFenceLanguageTags, bx as validatePackageExports, by as validateTsconfig } from '../code-mkKV7BQ4.cjs';

package/dist/tools/code.d.ts

@@ -1 +1 @@
-export { A as ALL_FLAGS, a as ApiEndpoint, b as ApiInfo, d as AriaIssue, e as AriaValidationResult, C as CHEATSHEET, f as CheatsheetEntry, g as CommitTrailer, h as CommitTrailerResult, i as ConnectionStringHost, j as ConnectionStringResult, k as ConventionalCommitFinding, l as ConventionalCommitFooter, m as ConventionalCommitOptions, n as ConventionalCommitParsed, o as ConventionalCommitResult, p as ConventionalCommitSeverity, q as CssResult, D as DEFAULT_COMMIT_TYPES, r as DependencyAuditDuplicate, s as DependencyAuditEntry, t as DependencyAuditIssue, u as DependencyAuditResult, v as DependencyRangeType, w as DependencySection, x as DockerImageRef, E as EditorConfigIssue, y as EditorConfigProperty, z as EditorConfigSection, B as EditorConfigValidationResult, F as EnvEntry, G as EnvParseResult, H as ExportsIssue, I as ExportsShape, J as ExportsValidationResult, K as FenceTagIssue, L as FenceTagIssueType, M as FenceValidationResult, N as GitCommandConfig, O as GitCommandResult, P as GitOperation, Q as GithubUrlInfo, R as GithubUrlType, S as GitignoreTestResult, T as GqlFormatResult, U as HtmlFormatResult, V as HtmlMinifyOptions, W as HtmlMinifyResult, X as JsMinifyOptions, Y as JsMinifyResult, Z as KNOWN_LANGUAGE_TAGS, _ as MIME_TABLE, $ as MarkdownFootnoteDefinition, a0 as MarkdownFootnoteReference, a1 as MarkdownFootnoteResult, a2 as MatchResult, a3 as MimeEntry, a4 as MimeLookupResult, a5 as OPERATIONS, a6 as ParsedSpec, a7 as PlaceholderStyle, a8 as RedosFinding, a9 as RedosResult, aa as RedosSeverity, ab as RegexBackreferenceInfo, ac as RegexError, ad as RegexFlag, ae as RegexGroupAnalysis, af as RegexGroupInfo, ag as RegexGroupIssue, ah as RegexMatch, ai as RegexResult, aj as RegexSuccess, ak as SQL_DEFAULT_OPTIONS, al as Segment, am as SpecVersion, an as SqlDialect, ao as SqlFormatOptions, ap as SqlPlaceholder, aq as SqlPlaceholderResult, ar as SvgSpriteResult, as as SvgSpriteSymbol, at as TestPatternResult, au as TsconfigIssue, av as TsconfigValidationResult, aw as analyzeRegexGroups, ax as auditDependencyRanges, ay as buildDockerPull, az as buildDockerRun, aA as buildGitCommand, aB as collapseHtmlWhitespace, aC as collapseJsWhitespace, aD as countProperties, aE as countRules, aF as countSqlPlaceholders, aG as detectDialect, aH as detectOperationType, aI as detectRedos, aJ as envToExport, aK as envToJson, aL as extractMarkdownFootnotes, aM as extractSvgSpriteSymbols, aN as formatCss, aO as formatGql, aP as formatHtml, aQ as formatSql, aR as getEndpointsByTag, aS as getHtmlStats, aT as getJsStats, aU as getMethodColor, aV as isValidTag, aW as lintConventionalCommit, aX as lookupMime, aY as minifyCss, aZ as minifyGql, a_ as minifyHtml, a$ as minifyJs, b0 as minifySql, b1 as normalizeRef, b2 as parseCommitTrailers, b3 as parseConnectionString, b4 as parseDockerImage, b5 as parseEnv, b6 as parseGitCommand, b7 as parseGithubUrl, b8 as parseSpec, b9 as removeConsoleCalls, ba as removeEmptyAttributes, bb as removeHtmlComments, bc as removeJsComments, bd as removeRedundantAttributes, be as searchCheatsheet, bf as searchEndpoints, bg as splitStatements, bh as testGitignorePatterns, bi as testPattern, bj as testRegex, bk as validateAria, bl as validateEditorConfig, bm as validateEnvKey, bn as validateFenceLanguageTags, bo as validatePackageExports, bp as validateTsconfig } from '../code-B8yHwP3m.js';
+export { A as ALL_FLAGS, a as ApiEndpoint, b as ApiInfo, d as AriaIssue, e as AriaValidationResult, C as CHEATSHEET, f as CheatsheetEntry, g as CommitTrailer, h as CommitTrailerResult, i as ConnectionStringHost, j as ConnectionStringResult, k as ConventionalCommitFinding, l as ConventionalCommitFooter, m as ConventionalCommitOptions, n as ConventionalCommitParsed, o as ConventionalCommitResult, p as ConventionalCommitSeverity, q as CssResult, D as DEFAULT_COMMIT_TYPES, r as DependencyAuditDuplicate, s as DependencyAuditEntry, t as DependencyAuditIssue, u as DependencyAuditResult, v as DependencyRangeType, w as DependencySection, x as DockerImageRef, y as DockerfileLintFinding, z as DockerfileLintResult, B as DockerfileStage, E as EditorConfigIssue, F as EditorConfigProperty, G as EditorConfigSection, H as EditorConfigValidationResult, I as EnvEntry, J as EnvParseResult, K as ExportsIssue, L as ExportsShape, M as ExportsValidationResult, N as FenceTagIssue, O as FenceTagIssueType, P as FenceValidationResult, Q as GitCommandConfig, R as GitCommandResult, S as GitOperation, T as GithubUrlInfo, U as GithubUrlType, V as GitignoreTestResult, W as GqlFormatResult, X as HtmlFormatResult, Y as HtmlMinifyOptions, Z as HtmlMinifyResult, _ as JsMinifyOptions, $ as JsMinifyResult, a0 as KNOWN_LANGUAGE_TAGS, a1 as LinkReferenceDefinition, a2 as LinkReferenceUsage, a3 as MIME_TABLE, a4 as MarkdownFootnoteDefinition, a5 as MarkdownFootnoteReference, a6 as MarkdownFootnoteResult, a7 as MarkdownLinkReferenceResult, a8 as MatchResult, a9 as MimeEntry, aa as MimeLookupResult, ab as OPERATIONS, ac as ParsedSpec, ad as PlaceholderStyle, ae as RedosFinding, af as RedosResult, ag as RedosSeverity, ah as RegexBackreferenceInfo, ai as RegexError, aj as RegexFlag, ak as RegexGroupAnalysis, al as RegexGroupInfo, am as RegexGroupIssue, an as RegexMatch, ao as RegexResult, ap as RegexSuccess, aq as ResolvedLinkReference, ar as SQL_DEFAULT_OPTIONS, as as Segment, at as SpecVersion, au as SqlDialect, av as SqlFormatOptions, aw as SqlPlaceholder, ax as SqlPlaceholderResult, ay as SvgSpriteResult, az as SvgSpriteSymbol, aA as TestPatternResult, aB as TsconfigIssue, aC as TsconfigValidationResult, aD as analyzeRegexGroups, aE as auditDependencyRanges, aF as buildDockerPull, aG as buildDockerRun, aH as buildGitCommand, aI as collapseHtmlWhitespace, aJ as collapseJsWhitespace, aK as countProperties, aL as countRules, aM as countSqlPlaceholders, aN as detectDialect, aO as detectOperationType, aP as detectRedos, aQ as envToExport, aR as envToJson, aS as extractMarkdownFootnotes, aT as extractMarkdownLinkReferences, aU as extractSvgSpriteSymbols, aV as formatCss, aW as formatGql, aX as formatHtml, aY as formatSql, aZ as getEndpointsByTag, a_ as getHtmlStats, a$ as getJsStats, b0 as getMethodColor, b1 as isValidTag, b2 as lintConventionalCommit, b3 as lintDockerfile, b4 as lookupMime, b5 as minifyCss, b6 as minifyGql, b7 as minifyHtml, b8 as minifyJs, b9 as minifySql, ba as normalizeRef, bb as parseCommitTrailers, bc as parseConnectionString, bd as parseDockerImage, be as parseEnv, bf as parseGitCommand, bg as parseGithubUrl, bh as parseSpec, bi as removeConsoleCalls, bj as removeEmptyAttributes, bk as removeHtmlComments, bl as removeJsComments, bm as removeRedundantAttributes, bn as searchCheatsheet, bo as searchEndpoints, bp as splitStatements, bq as testGitignorePatterns, br as testPattern, bs as testRegex, bt as validateAria, bu as validateEditorConfig, bv as validateEnvKey, bw as validateFenceLanguageTags, bx as validatePackageExports, by as validateTsconfig } from '../code-mkKV7BQ4.js';

package/dist/tools/code.js

@@ -1,2 +1,2 @@
-export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, KNOWN_LANGUAGE_TAGS, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, 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 } from '../chunk-FPFA4ZHC.js';
+export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, KNOWN_LANGUAGE_TAGS, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, countSqlPlaceholders, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractMarkdownFootnotes, extractMarkdownLinkReferences, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lintDockerfile, 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 } from '../chunk-RMXZMYSG.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/time.cjs

@@ -659,6 +659,42 @@ function getRunInterval(dates) {
   const days = Math.round(diffMins / 1440);
   return `Every ${days} days`;
 }
+var MAX_CRON_OVERLAPS = 200;
+function findCronOverlaps(expressions, windowDays = 30, fromDate) {
+  if (expressions.length < 2) return { error: "Provide at least two cron expressions to check for overlaps" };
+  if (expressions.length > 10) return { error: "Provide 10 or fewer cron expressions" };
+  if (windowDays < 1 || windowDays > 365) return { error: "windowDays must be between 1 and 365" };
+  const parsedList = [];
+  for (let i = 0; i < expressions.length; i++) {
+    const parsed = parseCronExpression(expressions[i]);
+    if (typeof parsed === "object" && "error" in parsed) {
+      return { error: `Expression ${i + 1} ("${expressions[i]}"): ${parsed.error}` };
+    }
+    parsedList.push(parsed);
+  }
+  const start = fromDate ? new Date(fromDate) : /* @__PURE__ */ new Date();
+  const cursor = new Date(start);
+  cursor.setSeconds(0, 0);
+  cursor.setMinutes(cursor.getMinutes() + 1);
+  const endTime = cursor.getTime() + windowDays * 24 * 60 * 60 * 1e3;
+  const overlaps = [];
+  let truncated = false;
+  while (cursor.getTime() < endTime) {
+    const matched = [];
+    for (let i = 0; i < parsedList.length; i++) {
+      if (matchesCron(cursor, parsedList[i])) matched.push(i);
+    }
+    if (matched.length >= 2) {
+      if (overlaps.length >= MAX_CRON_OVERLAPS) {
+        truncated = true;
+        break;
+      }
+      overlaps.push({ date: new Date(cursor), expressionIndexes: matched });
+    }
+    cursor.setMinutes(cursor.getMinutes() + 1);
+  }
+  return { overlaps, windowDays, truncated };
+}
 var DURATION_SECONDS_PER_YEAR = 365 * 86400;
 var DURATION_SECONDS_PER_MONTH = 30 * 86400;
 function humanizeDurationParts(parts) {
@@ -756,6 +792,7 @@ exports.COMMON_DATE_PRESETS = COMMON_DATE_PRESETS;
 exports.TIMEZONES = TIMEZONES;
 exports.convertTime = convertTime;
 exports.diffDates = diffDates;
+exports.findCronOverlaps = findCronOverlaps;
 exports.formatInTimezone = formatInTimezone;
 exports.formatIso8601Duration = formatIso8601Duration;
 exports.formatRelative = formatRelative;

package/dist/tools/time.d.cts

@@ -1 +1 @@
-export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronResult, D as DateDiffResult, e as DurationFormatResult, f as DurationParseResult, P as ParsedCron, T as TIMEZONES, g as TimestampResult, h as TimezoneEntry, i as convertTime, j as diffDates, k as formatInTimezone, l as formatIso8601Duration, m as formatRelative, n as formatRunDate, o as fromIsoString, p as fromUnix, q as getAllZonesForTime, r as getNextRuns, s as getNow, u as getRunInterval, v as getTimezoneOffset, w as humanizeDiff, x as parseCron, y as parseCronExpression, z as parseDate, A as parseIso8601Duration } from '../time-KqJjdqII.cjs';
+export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronOverlap, e as CronOverlapResult, f as CronResult, D as DateDiffResult, g as DurationFormatResult, h as DurationParseResult, P as ParsedCron, T as TIMEZONES, i as TimestampResult, j as TimezoneEntry, k as convertTime, l as diffDates, m as findCronOverlaps, n as formatInTimezone, o as formatIso8601Duration, p as formatRelative, q as formatRunDate, r as fromIsoString, s as fromUnix, u as getAllZonesForTime, v as getNextRuns, w as getNow, x as getRunInterval, y as getTimezoneOffset, z as humanizeDiff, A as parseCron, B as parseCronExpression, E as parseDate, F as parseIso8601Duration } from '../time-VMAy_SrV.cjs';

package/dist/tools/time.d.ts

@@ -1 +1 @@
-export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronResult, D as DateDiffResult, e as DurationFormatResult, f as DurationParseResult, P as ParsedCron, T as TIMEZONES, g as TimestampResult, h as TimezoneEntry, i as convertTime, j as diffDates, k as formatInTimezone, l as formatIso8601Duration, m as formatRelative, n as formatRunDate, o as fromIsoString, p as fromUnix, q as getAllZonesForTime, r as getNextRuns, s as getNow, u as getRunInterval, v as getTimezoneOffset, w as humanizeDiff, x as parseCron, y as parseCronExpression, z as parseDate, A as parseIso8601Duration } from '../time-KqJjdqII.js';
+export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronOverlap, e as CronOverlapResult, f as CronResult, D as DateDiffResult, g as DurationFormatResult, h as DurationParseResult, P as ParsedCron, T as TIMEZONES, i as TimestampResult, j as TimezoneEntry, k as convertTime, l as diffDates, m as findCronOverlaps, n as formatInTimezone, o as formatIso8601Duration, p as formatRelative, q as formatRunDate, r as fromIsoString, s as fromUnix, u as getAllZonesForTime, v as getNextRuns, w as getNow, x as getRunInterval, y as getTimezoneOffset, z as humanizeDiff, A as parseCron, B as parseCronExpression, E as parseDate, F as parseIso8601Duration } from '../time-VMAy_SrV.js';

package/dist/tools/time.js

@@ -1,2 +1,2 @@
-export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, formatInTimezone, formatIso8601Duration, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate, parseIso8601Duration } from '../chunk-IEPWZERQ.js';
+export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, findCronOverlaps, formatInTimezone, formatIso8601Duration, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate, parseIso8601Duration } from '../chunk-6EJVNQSY.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.82.0",
+  "version": "0.84.0",
   "description": "154+ 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",