Skip to main content

Credential Expiry

@sntxrr/credential-expiryv2026.11.03.1· MIT· 17d agoBEHAVIORSACCEPTED WARNINGS
01README

Probe the credentials a fleet actually holds and report how long each has left, distinguishing expiry from an outage in progress

02Behaviors1
@sntxrr/credential-expiryv2026.11.03.1credential_expiry.ts

Global Arguments

ArgumentTypeDescription
credentials?arrayThe credentials to probe. Set exactly one of `credentials` and `manifest`.
manifest?strictObjectRead the credentials to probe from a YAML manifest instead. See `loadManifestCredentials` for its shape. Set exactly one of `credentials` and `manifest`.
warnDays?arrayDay thresholds at which a credential is reported `warn`. The largest is the point at which it first becomes visible.
criticalDays?numberAt or below this many days remaining, status becomes `critical` rather than `warn`.
apiBaseUrl?stringGitHub API base URL, for `github-pat` probes. Override for GitHub Enterprise Server.
gitlabBaseUrl?stringGitLab instance base URL, for `gitlab-pat` probes, without the /api/v4 suffix. Override for self-managed.
pveBaseUrl?stringProxmox VE base URL, for `pve-token` probes, without the /api2/json suffix.
b2BaseUrl?stringBackblaze B2 authorization endpoint, for `b2-key` probes, without the /b2api suffix.
scwBaseUrl?stringScaleway API base URL, for `scaleway-key` probes, without the /iam suffix. IAM is a
scwOrganizationId?stringScaleway organization id (a UUID), for the `sweep` method only. The IAM api-keys
swampBin?stringThe swamp CLI, for `swamp-serve-token` probes. Run as `swamp access token list --json`.
swampRepoDir?stringRepository whose server tokens a `swamp-serve-token` probe reads, passed as --repo-dir.
timeoutMs?numberAbort any single probe request after this long.
fn audit()
Probe every configured credential and write one resource each, plus a summary
fn sweep(credentialId?: string)
List every API key in the Scaleway organization and report the ones no scaleway-key entry names, and the ones with no expiry
ArgumentTypeDescription
credentialId?stringId of the `scaleway-key` entry whose secret lists the organization. Omit it

Resources

credential(infinite)— One probed credential: its expiry, days remaining, and status
audit(infinite)— Summary of one audit pass: counts by status, the soonest expiry, and whether anything needs a human
sweep(infinite)— One sweep of a provider's whole key plane: keys missing from the manifest, and keys with no expiry
03Previous Versions12
2026.10.22.1MIT

Modified 1 behaviors

2026.10.20.2MIT
2026.10.20.1MIT
2026.10.14.1MIT(was none)

Declare SPDX license (MIT) in manifest.

2026.09.30.1
2026.09.09.1
2026.09.08.2
2026.09.08.1
2026.08.19.4
2026.08.19.3
2026.08.19.2
2026.08.19.1
04Stats
A
100 / 100
Downloads
93
Archive size
63.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

06Platforms
07Labels