Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Developer Utilities Tier 3 All-Access

Package.json & Dependency Upgrade Risk Judge API — Flag Breaking SemVer Bumps

Diff two package.json files to flag breaking SemVer bumps and risky dependency changes. Compare two package.json manifests or dependency maps to flag major breaking upgrades, 0.x instability, prerelease tags, git/tarball URLs, and supply-chain risks.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/semver-lockfile-judgeinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "verdict": "block",
    "risk_score": 64,
    "breaking_count": 0,
    "summary": {
      "total_changes": 3,
      "major_breaking": 0,
      "zero_ver_breaking": 0,
      "downgrades": 0,
      "unpinned_or_vcs": 1,
      "added": 0,
      "removed": 0,
      "minor_or_patch": 1
    },
    "changes": [
      {
        "package": "hono",
        "section": "dependencies",
        "before_spec": "^4.6.0",
        "after_spec": "^4.7.1",
        "change_type": "minor_upgrade",
        "risk": "low",
        "explanation": "Backward-compatible minor upgrade for hono: ^4.6.0 -> ^4.7.1."
      },
      {
        "package": "left-pad",
        "section": "dependencies",
        "before_spec": null,
        "after_spec": "github:user/repo",
        "change_type": "unpinned_or_vcs",
        "risk": "critical",
        "explanation": "Added left-pad@github:user/repo with unpinned tag, wildcard, or VCS URL."
      },
      {
        "package": "zod",
        "section": "dependencies",
        "before_spec": "^3.23.8",
        "after_spec": "^4.0.0-beta.1",
        "change_type": "prerelease_introduced",
        "risk": "high",
        "explanation": "Switched zod from stable (^3.23.8) to pre-release (^4.0.0-beta.1)."
      }
    ],
    "recommendations": [
      "Pin wildcard (*, latest) and VCS dependencies to exact SemVer ranges or commit SHAs."
    ]
  },
  "meta": {
    "request_id": "req_slj_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/semver-lockfile-judge" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"before":{"dependencies":{"zod":"^3.23.8","hono":"^4.6.0"}},"after":{"dependencies":{"zod":"^4.0.0-beta.1","hono":"^4.7.1","left-pad":"github:user/repo"}}}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/semver-lockfile-judge", {
  "before": {
    "dependencies": {
      "zod": "^3.23.8",
      "hono": "^4.6.0"
    }
  },
  "after": {
    "dependencies": {
      "zod": "^4.0.0-beta.1",
      "hono": "^4.7.1",
      "left-pad": "github:user/repo"
    }
  }
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/semver-lockfile-judge",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "before": {
    "dependencies": {
      "zod": "^3.23.8",
      "hono": "^4.6.0"
    }
  },
  "after": {
    "dependencies": {
      "zod": "^4.0.0-beta.1",
      "hono": "^4.7.1",
      "left-pad": "github:user/repo"
    }
  }
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/semver-lockfile-judge", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "before": {
    "dependencies": {
      "zod": "^3.23.8",
      "hono": "^4.6.0"
    }
  },
  "after": {
    "dependencies": {
      "zod": "^4.0.0-beta.1",
      "hono": "^4.7.1",
      "left-pad": "github:user/repo"
    }
  }
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_semver_lockfile_judge",
    "arguments": {
      "before": {
        "dependencies": {
          "zod": "^3.23.8",
          "hono": "^4.6.0"
        }
      },
      "after": {
        "dependencies": {
          "zod": "^4.0.0-beta.1",
          "hono": "^4.7.1",
          "left-pad": "github:user/repo"
        }
      }
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/semver-lockfile-judge)

ParameterType & ConstraintsDescription
before required string | object Field 'before'
after required string | object Field 'after'
include_dev_dependencies optional boolean
default: true
Field 'include_dev_dependencies'
fail_on_zero_ver_minor optional boolean
default: true
Field 'fail_on_zero_ver_minor'

Response data Object Fields (200 OK)

FieldTypeDescription
verdict "allow" | "review" | "block" Field 'verdict'
risk_score integer Field 'risk_score'
breaking_count integer Field 'breaking_count'
summary object Field 'summary'
changes object[] Field 'changes'
recommendations string[] Field 'recommendations'

What SemVer & Package Manifest / Lockfile Diff Judge API Detects & Validates

  • Parses SemVer ranges (^, ~, >=, *, workspace:, exact versions) and compares before vs after dependency maps
  • Flags major version bumps, 0.x.y minor breaking bumps, downgrades, and prerelease (-alpha, -beta, -rc) introductions
  • Supply-chain risk checks: flags unpinned git:// or github: URLs, HTTP tarball URLs, wildcard * versions, and lifecycle script additions (preinstall/postinstall)
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Evaluates manifest version ranges and script changes deterministically; does not query the live npm registry or CVE databases.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Why are 0.x minor bumps flagged as potentially breaking?

Per SemVer 2.0.0 spec clause 4, initial development versions (0.y.z) treat minor bumps (e.g. 0.4.0 -> 0.5.0) as breaking changes.

Does it inspect package.json lifecycle scripts?

Yes, if a diff adds or modifies preinstall, install, or postinstall scripts, it raises a supply-chain review flag.

Can I use it to auto-approve Dependabot or Renovate PRs?

Yes—auto-merge when verdict is 'safe' (patch/minor bumps only, no new scripts or git URLs) and require human review on 'review' or 'high_risk'.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Stateless in-memory manifest diffing; zero retention.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/schema-diff Developer Utilities

OpenAPI & JSON Schema Breaking-Change Diff API

Diff two OpenAPI 3.x or JSON Schemas to catch breaking changes and recommend SemVer bumps.

POST /v1/secret-scanner Tier 1

Log Redact & Secret Scanner API

Detect and mask leaked API keys, JWTs, and private keys in logs, diffs, and prompts.

POST /v1/mcp-manifest-linter Tier 1

MCP Server Manifest & Tool Security Linter API

Audit MCP server manifests for hidden tool poisoning, shell risks, and excessive permissions.