Skip to content

ryangrippe/ten99

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@earndrift/ten99

Year-aware IRS 1099-NEC threshold checker for JavaScript & TypeScript. Handles the OBBBA (Pub. L. 119-21) jump from $600 → $2,000 for tax year 2026 and later. Zero dependencies.

npm version License: MIT

Brought to you by EarnDrift — 1099 payroll for businesses.


Why this exists

For 70 years the IRS 1099-NEC reporting threshold was $600. The One Big Beautiful Bill Act (signed July 4, 2025) raised it to $2,000 for payments made on or after January 1, 2026, with inflation indexing starting in 2027.

That sounds simple, but in practice you can't just hardcode 2000. During Q1 of any year, businesses are still filing for the prior tax year under the prior threshold. A payment dated Dec 31 2025 still gets a 1099 at $600; the same payment dated Jan 1 2026 doesn't until it hits $2,000. Get it wrong and you either over-file (annoying) or under-file (penalties).

This package gives you a single function: pass the payment year, get the right threshold.

Install

npm install @earndrift/ten99
# or
pnpm add @earndrift/ten99
# or
yarn add @earndrift/ten99

Usage

import {
  getThresholdForYear,
  getThresholdCentsForYear,
  getApproachingForYear,
  classifyTotal,
  isOverThreshold,
} from '@earndrift/ten99';

getThresholdForYear(2025);          // 600
getThresholdForYear(2026);          // 2000
getThresholdCentsForYear(2026);     // 200000  (for amount_cents columns)
getApproachingForYear(2026);        // 1500    (75% of threshold)

isOverThreshold(1999, 2026);        // false
isOverThreshold(2000, 2026);        // true

classifyTotal(1850, 2026);
// {
//   status: 'approaching',   // 'safe' | 'approaching' | 'over'
//   threshold: 2000,
//   pct: 0.925,
// }

CLI

npx @earndrift/ten99 threshold --year 2026
# → $2,000 (tax year 2026)

npx @earndrift/ten99 check --year 2026 --amount 1850
# → APPROACHING — $1,850 is 92.5% of the $2,000 threshold for tax year 2026.

npx @earndrift/ten99 check --year 2025 --amount 750
# → OVER — $750 ≥ $600 (125.0%). 1099-NEC required for tax year 2025.

API

Function Returns Notes
getThresholdForYear(year) number (dollars) $600 for ≤ 2025, $2,000 for ≥ 2026
getThresholdCentsForYear(year) number (cents) For columns stored as amount_cents
getApproachingForYear(year) number (dollars) 75% of the year's threshold
getApproachingCentsForYear(year) number (cents) 75% of the year's threshold, in cents
formatThresholdLabel(year) string "$600" or "$2,000" for UI copy
getCurrentTaxYear(now?) number Resolved in America/New_York to avoid Dec 31 / Jan 1 drift
classifyTotal(dollars, year) { status, threshold, pct } status: 'safe' | 'approaching' | 'over'
isOverThreshold(dollars, year) boolean true once dollars ≥ threshold
centsToDollars(cents) number Trivial helper

Constants

  • OBBBA_EFFECTIVE_YEAR2026
  • LEGACY_THRESHOLD_DOLLARS600
  • OBBBA_THRESHOLD_DOLLARS2000
  • APPROACHING_PCT0.75

A few things to know

  • Pass the payment year, not new Date().getFullYear(). A payment made Dec 28 2025 is a tax year 2025 payment ($600 threshold) even if you're calculating it in February 2026.
  • 2027+ holds at $2,000 until the IRS publishes the indexed figure each year via Rev. Proc. We'll bump this package when the official numbers land.
  • No network calls, no telemetry, no auth. Pure local math.

About EarnDrift

This package was extracted from the production codebase of EarnDrift — payroll-style payments and automated 1099 filing for businesses that pay contractors. EarnDrift handles the whole thing end to end: ACH payments, W-9 collection, year-round threshold tracking, and 1099-NEC filing.

If you're a business with contractors, the 1099 threshold checker for 2026 and the state-by-state 1099 rules on earndrift.com are the fastest way to see whether you need to file. The full app handles it for you automatically.

For the legislative context behind the $600 → $2,000 jump, see our OBBBA law-changes tracker.

License

MIT © EarnDrift

About

1099 threshold calculator and compliance utilities for US small businesses

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors