Credential Expiry
@sntxrr/credential-expiryv2026.11.03.1
01README
Probe the credentials a fleet actually holds and report how long each has left, distinguishing expiry from an outage in progress
02Behaviors
@sntxrr/credential-expiryv2026.11.03.1credential_expiry.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| credentials? | array | The credentials to probe. Set exactly one of `credentials` and `manifest`. |
| manifest? | strictObject | Read the credentials to probe from a YAML manifest instead. See `loadManifestCredentials` for its shape. Set exactly one of `credentials` and `manifest`. |
| warnDays? | array | Day thresholds at which a credential is reported `warn`. The largest is the point at which it first becomes visible. |
| criticalDays? | number | At or below this many days remaining, status becomes `critical` rather than `warn`. |
| apiBaseUrl? | string | GitHub API base URL, for `github-pat` probes. Override for GitHub Enterprise Server. |
| gitlabBaseUrl? | string | GitLab instance base URL, for `gitlab-pat` probes, without the /api/v4 suffix. Override for self-managed. |
| pveBaseUrl? | string | Proxmox VE base URL, for `pve-token` probes, without the /api2/json suffix. |
| b2BaseUrl? | string | Backblaze B2 authorization endpoint, for `b2-key` probes, without the /b2api suffix. |
| scwBaseUrl? | string | Scaleway API base URL, for `scaleway-key` probes, without the /iam suffix. IAM is a |
| scwOrganizationId? | string | Scaleway organization id (a UUID), for the `sweep` method only. The IAM api-keys |
| swampBin? | string | The swamp CLI, for `swamp-serve-token` probes. Run as `swamp access token list --json`. |
| swampRepoDir? | string | Repository whose server tokens a `swamp-serve-token` probe reads, passed as --repo-dir. |
| timeoutMs? | number | Abort 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
| Argument | Type | Description |
|---|---|---|
| credentialId? | string | Id 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 Versions
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
deno-command1 accepted
Spawns a subprocess with Deno.Command().
- models/credential_expiry.ts:2070 — no reason given
credentials-sensitive-field2 accepted
A field that looks like a secret but is not marked sensitive, so its value is not vaulted.
- models/credential_expiry.ts:117 — no reason given
- models/credential_expiry.ts:361 — no reason given
06Platforms
07Labels