@arcjet/env

@arcjet/env

Arcjet environment detection.

Currently operates on an environment object with the type:

type Env = {
  FLY_APP_NAME?: string;
  NODE_ENV?: string;
  ARCJET_KEY?: string;
  ARCJET_ENV?: string;
  ARCJET_LOG_LEVEL?: string;
  ARCJET_BASE_URL?: string;
};

Installation

npm install -S @arcjet/env

Example

import * as env from "@arcjet/env";

env.platform({ FLY_APP_NAME: "foobar" }) === "fly-io";
env.platform({}) === undefined;

env.isDevelopment({ NODE_ENV: "production" }) === false;
env.isDevelopment({ NODE_ENV: "development" }) === true;
env.isDevelopment({ ARCJET_ENV: "production" }) === false;
env.isDevelopment({ ARCJET_ENV: "development" }) === true;

env.logLevel({ ARCJET_LOG_LEVEL: "debug" }) === "debug";
env.logLevel({ ARCJET_LOG_LEVEL: "info" }) === "info";
env.logLevel({ ARCJET_LOG_LEVEL: "warn" }) === "warn";
env.logLevel({ ARCJET_LOG_LEVEL: "error" }) === "error";
env.logLevel({ ARCJET_LOG_LEVEL: "" }) === "warn"; // default

// Will use various environment variables to detect the proper base URL
env.baseUrl(process.env);

env.apiKey({ ARCJET_KEY: "ajkey_abc123" }) === "ajkey_abc123";
env.apiKey({ ARCJET_KEY: "invalid" }) === undefined;

License

Licensed under the Apache License, Version 2.0.

Changelog

1.0.0-alpha.29 (2024-11-19)

🚀 New Features

• Create nosecone package for creating secure headers (#2237) (1e8e73b)

🪲 Bug Fixes

• arcjet: Log error message when fingerprint cannot be built (#2139) (56e5319)
• Guard against incorrectly written local rules (#2191) (0885ccf)
• sveltekit: Load env from node:process (#2156) (346a350), closes #2154

🧹 Miscellaneous Chores

• Add initial contributing help (#2158) (d21b81e), closes #1122
• arcjet: Increase test coverage to 100% (#2157) (17f8a9a), closes #1802
• example: Allow swc compilers (#2280) (cb64f4a)
• ip: Update documentation for previous breaking changes (#2278) (cff3cc9), closes #2277
• logger: Remove unused getTimeLabel function (#2140) (73d94d5)
• Regenerate Wasm with updated dependencies (#2168) (90b8350)
• Regenerate Wasm with updated dependencies (#2258) (b82284b)
• Update root readme with all packages and new urls (#2169) (32f0572)