@arcjet/duration

@arcjet/duration

Arcjet utilities for parsing duration strings.

• npm package (@arcjet/duration)
• GitHub source code (duration/ in arcjet/arcjet-js)

Installation

npm install -S @arcjet/duration

Example

import { parse } from "@arcjet/duration";

const seconds = parse("1h");
console.log(seconds); // prints 3600

Implementation

The implementation of this library is based on the ParseDuration function in the Go stdlib. Originally licensed BSD-3.0 with the license included in our source code.

We've chosen the approach of porting this to TypeScript because our protocol operates exclusively on unsigned 32-bit integers representing seconds. However, we don't want to require our SDK users to manually calculate seconds. By providing this utility, our SDK can accept duration strings and numbers while normalizing the values for our protocol.

License

Licensed under the Apache License, Version 2.0.

Changelog

1.0.0-beta.9 (2025-07-09)

🚀 New Features

• add Fastify integration (#4538) (d5922e4)
• protocol: Add Fastify stack (#4570) (538818d)

🪲 Bug Fixes

• bun: Rely on connect-web to communicate from Bun runtime (#4523) (c9b26b0)

📝 Documentation

• add compatibility section (#4517) (506da27)
• Add relevant links to each package readme (#4429) (2653ab0)

🧹 Miscellaneous Chores

• Add keywords to package.jsons (#4408) (4f09478)
• arcjet: Reduce timeouts and other transport issues to info log (#4411) (c148bab)
• astro: add temporary warning message for fully static sites (#4278) (6d093be)
• astro: Increase minimum peerDependency (#4432) (a0453e2), closes #3094
• Ensure all sample code checking .isDenied() returns error response. (#4552) (8fc2d2d)
• example: fix typo in svelte example (#4518) (6b72298)
• Fix jco name in dependabot (#4371) (809fe76)
• Fix missing file extension in test (#4407) (b694dad)
• Fix Rollup on Node 24 (#4406) (1853b1a)
• improve Astro SDK description (#4491) (00482c5)
• remove expect, references to jest (#4415) (2c44c39)

⌨️ Code Refactoring

• Clean files fields in package.jsons (#4441) (fd7913b)
• remove unneeded nbsp with regular space (#4503) (274114d)
• rename use of deprecated method name (#4504) (2b30a4d)

📚 Tests

• add actual tests for reasons (#4516) (768f85e)
• add tests for analyze (#4564) (7ef59bb)
• clean cache tests (#4472) (92b7335)
• clean protocol tests (#4479) (c67d517)
• rename confusing test cases (#4515) (fe20b6d)

🔨 Build System

• add separate core, coverage tests (#4480) (61c2c50)

✅ Continuous Integration

• Add Node.js 22, 24 (#4414) (0fa6743)