docs(backend): note M2MToken timestamps are in milliseconds by SarahSoutoul · Pull Request #9122 · clerk/javascript

SarahSoutoul · 2026-07-10T10:21:05Z

Description

Clarify in the M2MToken JSDoc that expiration, createdAt, and updatedAt are Unix timestamps in milliseconds (not seconds). The constructor already converts JWT exp/iat claims via * 1000, so the values are milliseconds; only the doc comments were ambiguous.

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

Documentation
- Clarified that machine-to-machine token and related OAuth/API key timestamp fields (expiration, createdAt, lastUsedAt, updatedAt) are Unix timestamps expressed in milliseconds.
- Updated the existing release notes to reflect this documentation clarification.

Clarify in the `M2MToken` JSDoc that `expiration`, `createdAt`, and `updatedAt` are Unix timestamps in milliseconds (not seconds). The constructor already converts JWT `exp`/`iat` claims via `* 1000`, so the values are milliseconds; only the doc comments were ambiguous. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

changeset-bot · 2026-07-10T10:21:09Z

🦋 Changeset detected

Latest commit: d709d0c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 10 packages

Name	Type
@clerk/backend	Patch
@clerk/astro	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-07-10T10:21:11Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jul 10, 2026 8:20pm
swingset	Ready	Preview, Comment	Jul 10, 2026 8:20pm

coderabbitai · 2026-07-10T10:21:24Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Repository UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 36930130-9944-4db3-a764-dc7af65cfbfe

📥 Commits

Reviewing files that changed from the base of the PR and between ac6d46e and d709d0c.

📒 Files selected for processing (3)

.changeset/m2m-token-timestamp-units.md
packages/backend/src/api/resources/APIKey.ts
packages/backend/src/api/resources/IdPOAuthAccessToken.ts

✅ Files skipped from review due to trivial changes (2)

packages/backend/src/api/resources/APIKey.ts
packages/backend/src/api/resources/IdPOAuthAccessToken.ts

🚧 Files skipped from review as they are similar to previous changes (1)

.changeset/m2m-token-timestamp-units.md

📝 Walkthrough

Walkthrough

Clarifies that timestamp fields in M2MToken, APIKey, and IdPOAuthAccessToken use Unix timestamps in milliseconds, and adds a patch changeset for @clerk/backend.

Changes

Timestamp unit documentation

Layer / File(s)	Summary
Clarify timestamp units `packages/backend/src/api/resources/M2MToken.ts`, `packages/backend/src/api/resources/APIKey.ts`, `packages/backend/src/api/resources/IdPOAuthAccessToken.ts`, `.changeset/m2m-token-timestamp-units.md`	Updates JSDoc for relevant timestamp fields to specify Unix milliseconds and records the backend patch changeset.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Poem

I’m a rabbit with timestamps bright,
Milliseconds now hop into sight.
Three token docs wear a clearer tune,
A patch release follows soon.
Hop, hop—precision blooms!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main change: backend docs clarifying M2MToken timestamps are in milliseconds.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

_{Comment @coderabbitai help to get the list of available commands.}

pkg-pr-new · 2026-07-10T10:24:03Z

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9122

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9122

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9122

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9122

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9122

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9122

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9122

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9122

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9122

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9122

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9122

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9122

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9122

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9122

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9122

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9122

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9122

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9122

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9122

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9122

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9122

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9122

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9122

commit: d709d0c

github-actions · 2026-07-10T10:24:33Z

API Changes Report

Generated by Break Check on 2026-07-10T20:22:12.335Z

Summary

Metric	Count
Packages analyzed	19
Packages with changes	0
🔴 Breaking changes	0
🟡 Non-breaking changes	0
🟢 Additions	0

No API Changes Detected

All packages have stable APIs with no detected changes.

Report generated by Break Check

_{Last ran on d709d0c.}

wobsoriano

thanks!

…milliseconds Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

manovotny · 2026-07-10T20:18:35Z

Pushed one commit directly in d709d0c — extended the same clarification to the sibling machine-auth resources, which have the identical ambiguity:

APIKey: added "(in milliseconds)" to the expiration, lastUsedAt, createdAt, and updatedAt JSDoc
IdPOAuthAccessToken: those fields had no JSDoc at all, so added matching comments
Updated the changeset to mention all three resources

Both verified against the backing service the same way as M2MToken (same opaque-token store, ms-based expiry check, 13-digit test fixtures). If you'd rather keep this PR strictly M2M-scoped, feel free to drop the commit and I'll split it out.

manovotny · 2026-07-10T20:35:01Z

@wobsoriano I don't think @SarahSoutoul or I have permissions to merge in this repo. Can you mash the button for us or grant us permission?

wobsoriano · 2026-07-11T14:45:48Z

@wobsoriano I don't think @SarahSoutoul or I have permissions to merge in this repo. Can you mash the button for us or grant us permission?

Merged! I do not have powers to grant permissions 😅

SarahSoutoul self-assigned this Jul 10, 2026

vercel Bot deployed to Preview – clerk-js-sandbox July 10, 2026 10:21 View deployment

github-actions Bot added the backend label Jul 10, 2026

vercel Bot deployed to Preview – swingset July 10, 2026 10:22 View deployment

SarahSoutoul requested review from manovotny and wobsoriano July 10, 2026 10:23

wobsoriano approved these changes Jul 10, 2026

View reviewed changes

docs(backend): note APIKey and IdPOAuthAccessToken timestamps are in …

d709d0c

…milliseconds Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel Bot deployed to Preview – clerk-js-sandbox July 10, 2026 20:19 View deployment

manovotny approved these changes Jul 10, 2026

View reviewed changes

vercel Bot deployed to Preview – swingset July 10, 2026 20:20 View deployment

wobsoriano merged commit 1a19409 into main Jul 10, 2026
53 checks passed

wobsoriano deleted the ss/m2m-token-timestamps-ms branch July 10, 2026 20:45

clerk-cookie mentioned this pull request Jul 10, 2026

ci(repo): Version packages #9129

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs(backend): note M2MToken timestamps are in milliseconds#9122

docs(backend): note M2MToken timestamps are in milliseconds#9122
wobsoriano merged 2 commits into
mainfrom
ss/m2m-token-timestamps-ms

SarahSoutoul commented Jul 10, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

changeset-bot Bot commented Jul 10, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jul 10, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 10, 2026 •

edited

Loading

Walkthrough

Changes

Uh oh!

pkg-pr-new Bot commented Jul 10, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 10, 2026 •

edited

Loading

Uh oh!

wobsoriano left a comment

Uh oh!

manovotny commented Jul 10, 2026

Uh oh!

manovotny commented Jul 10, 2026

Uh oh!

Uh oh!

wobsoriano commented Jul 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

SarahSoutoul commented Jul 10, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Summary by CodeRabbit

Summary by CodeRabbit

Uh oh!

changeset-bot Bot commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel Bot commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

pkg-pr-new Bot commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Changes Report

Summary

No API Changes Detected

Uh oh!

wobsoriano left a comment

Choose a reason for hiding this comment

Uh oh!

manovotny commented Jul 10, 2026

Uh oh!

manovotny commented Jul 10, 2026

Uh oh!

Uh oh!

wobsoriano commented Jul 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

SarahSoutoul commented Jul 10, 2026 •

edited by coderabbitai Bot

Loading

changeset-bot Bot commented Jul 10, 2026 •

edited

Loading

vercel Bot commented Jul 10, 2026 •

edited

Loading

coderabbitai Bot commented Jul 10, 2026 •

edited

Loading

pkg-pr-new Bot commented Jul 10, 2026 •

edited

Loading

github-actions Bot commented Jul 10, 2026 •

edited

Loading