@ty-ras-extras/config-zod

Typesafe REST API Specification Extras - Configuration Utilities

This folder contains library which exposes few utility functions which can be used by both backend and frontend applications to read configurations from strings (e.g. environment variables). The strings are parsed as necessary and then validated at runtime using zod library.

Using in Frontend

import * as t from "zod";
import { configuration } from "@ty-ras-extras/frontend-zod";
// Or, if not using bundled libraries: import * as configuration from "@ty-ras-extras/config-zod/string";

// Define runtime validation of configuration
const validation = t.object({
  someStringProperty: t.string,
});
// Acquire configuration
export const config = configuration.validateFromStringifiedJSONOrThrow(
  validation,
  import.meta.env["MY_FE_CONFIG"], // Or, if webpack: process.env["MY_FE_CONFIG"]),
);
// The compile-time type of 'config' is now:
// {
//   someStringProperty: string
// }

Using in Backend

For situations where environment variable is always serialized JSON:

import * as t from "zod";
import { configuration } from "@ty-ras-extras/backend-zod";
// Or, if not using bundled libraries: import * as configuration from "@ty-ras-extras/config-zod";

// Define runtime validation of configuration
const validation = t.object({
  someStringProperty: t.string,
});
// Acquire configuration
export const config = configuration.validateFromStringifiedJSONOrThrow(
  validation,
  process.env["MY_BE_CONFIG"],
);
// The compile-time type of 'config' is now:
// {
//   someStringProperty: string
// }

For situations where environment variable is either serialized JSON or a path to file containing serialized JSON:

import * as t from "zod";
import { configuration } from "@ty-ras-extras/backend-zod";
// Or, if not using bundled libraries: import * as configuration from "@ty-ras-extras/config-zod";

// Define runtime validation of configuration
const validation = t.object({
  someStringProperty: t.string,
});
// Acquire configuration
export const acquireConfiguration = async () => configuration.validateFromStringifiedJSONOrThrow(
  validation,
  await configuration.getJSONStringValueFromStringWhichIsJSONOrFilename(
    process.env["MY_BE_CONFIG"]
  )
);
// The compile-time type of 'acquireConfiguration' is now:
// () => Promise<{
//   someStringProperty: string
// }>