@secretdef/resend

Like @types but for environment variables — so your app (and AI coding agents) know exactly which secrets are needed before runtime.

Pre-built secretdef definitions for Resend (resend) environment variables.

This package declares the secrets required by resend. It does not install or replace the official SDK — install both side by side.

Install

npm install resend @secretdef/resend secretdef

Usage

Every import of a @secretdef/* package calls defineSecrets() under the hood, registering its secrets globally. You then call validateSecrets() once at startup — with no arguments — to validate everything that was defined:

// app entry point
import { validateSecrets } from 'secretdef';

import '@secretdef/resend';
// import '@secretdef/...';  ← other services

// Validates ALL secrets defined by any prior defineSecrets() call
validateSecrets();

You can also compose explicitly in a secrets.ts file — useful if you want to add your own app secrets alongside:

// secrets.ts
import { defineSecrets } from 'secretdef';
import { secrets as resendSecrets } from '@secretdef/resend';

export const secrets = defineSecrets({
  ...resendSecrets,
  // Add your own app secrets
  // MY_APP_SECRET: { description: 'My app secret' },
});

// app entry point
import { validateSecrets } from 'secretdef';
import './secrets'; // defineSecrets() was called, secrets are registered

validateSecrets(); // no args — validates everything

Note: validateSecrets() can also accept an explicit secrets object if you prefer full control: validateSecrets(secrets).

Secrets

| Variable | Description | Required | |----------|-------------|----------| | RESEND_API_KEY | Resend API key | Yes | | RESEND_BASE_URL | Override Resend API base URL | No |

What are Secret Definitions?

secretdef is an open standard for declaring which environment variables (secrets) a package or app requires — their names, descriptions, and constraints.

Instead of discovering missing secrets through cryptic runtime errors, secret definitions let you validate everything at startup with clear, actionable error messages. AI coding agents can also read these definitions to configure secrets automatically.

Learn more at secretdef.com

Links

• resend — Official Resend SDK
• Resend on GitHub — Source
• secretdef.com — Full documentation
• secretdef on npm — Core library