@schafevormfenster/rest-commons 0.1.9 → 0.1.11

package/dist/index.js

@@ -1,38 +1,38 @@
 // Schemas
-export * from "./api-schemas/error.schema";
-export * from "./api-schemas/health.schema";
-export * from "./api-schemas/okay.schema";
-export * from "./api-schemas/result.schema";
-export * from "./api-schemas/results.schema";
+export * from "./api-schemas/error.schema.js";
+export * from "./api-schemas/health.schema.js";
+export * from "./api-schemas/okay.schema.js";
+export * from "./api-schemas/result.schema.js";
+export * from "./api-schemas/results.schema.js";
 // Primitive schemas
-export * from "./primitives/location.schema";
-export * from "./primitives/slug.schema";
-export * from "./primitives/numeric-id.schema";
-export * from "./primitives/uuid.schema";
-export * from "./primitives/geoname-id.schema";
-export * from "./primitives/wikidata-id.schema";
-export * from "./primitives/international-zip.schema";
+export * from "./primitives/location.schema.js";
+export * from "./primitives/slug.schema.js";
+export * from "./primitives/numeric-id.schema.js";
+export * from "./primitives/uuid.schema.js";
+export * from "./primitives/geoname-id.schema.js";
+export * from "./primitives/wikidata-id.schema.js";
+export * from "./primitives/international-zip.schema.js";
 // Time utilities
-export * from "./time/timezone.types";
-export * from "./time/iso8601.schema"; // ISO8601 schemas
-export * from "./time/relative-time.schema"; // Relative time schemas
-export * from "./time/flexible-time.schema"; // Flexible time schemas
-export * from "./time/bounded-time.schema"; // Bounded time schemas
-export * from "./time/time-helpers"; // Helper functions
-export * from "./time/is-relative-time";
-export { parseFlexibleTime as parseFlexibleTimeAdvanced } from "./time/flexible-time-parser";
-export * from "./time/boundary-enforcement";
+export * from "./time/timezone.types.js";
+export * from "./time/iso8601.schema.js"; // ISO8601 schemas
+export * from "./time/relative-time.schema.js"; // Relative time schemas
+export * from "./time/flexible-time.schema.js"; // Flexible time schemas
+export * from "./time/bounded-time.schema.js"; // Bounded time schemas
+export * from "./time/time-helpers.js"; // Helper functions
+export * from "./time/is-relative-time.js";
+export { parseFlexibleTime as parseFlexibleTimeAdvanced } from "./time/flexible-time-parser.js";
+export * from "./time/boundary-enforcement.js";
 // Helpers
-export * from "./helpers/correlation/get-correlation-id";
-export * from "./helpers/correlation/get-header";
-export * from "./helpers/detect-mime-type";
-export * from "./helpers/detect-suspicious-patterns";
-export * from "./helpers/hash-binary";
-export * from "./helpers/parameter-validation";
-export * from "./helpers/slugify";
-export * from "./helpers/response-headers/build-api-unauthorized-headers";
-export * from "./helpers/response-headers/environment.types";
-export * from "./helpers/response-headers/resolve-environment";
+export * from "./helpers/correlation/get-correlation-id.js";
+export * from "./helpers/correlation/get-header.js";
+export * from "./helpers/detect-mime-type.js";
+export * from "./helpers/detect-suspicious-patterns.js";
+export * from "./helpers/hash-binary.js";
+export * from "./helpers/parameter-validation.js";
+export * from "./helpers/slugify.js";
+export * from "./helpers/response-headers/build-api-unauthorized-headers.js";
+export * from "./helpers/response-headers/environment.types.js";
+export * from "./helpers/response-headers/resolve-environment.js";
 // Utilities
-export * from "./normalization/normalize-list";
-export * from "./normalization/normalize-location";
+export * from "./normalization/normalize-list.js";
+export * from "./normalization/normalize-location.js";

package/dist/primitives/geo-point.schema.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { LatitudeSchema } from "./latitude.schema";
-import { LongitudeSchema } from "./longitude.schema";
+import { LatitudeSchema } from "./latitude.schema.js";
+import { LongitudeSchema } from "./longitude.schema.js";
 /**
  * Zod schema for validating geographic coordinates as a tuple.
  * Geographic coordinates as [latitude, longitude].

package/dist/primitives/latitude.schema.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { hasValidDecimalPrecision } from "./coordinate-precision";
+import { hasValidDecimalPrecision } from "./coordinate-precision.js";
 /**
  * Zod schema for validating latitude coordinates.
  * Latitude must be a number between -90 and 90 degrees inclusive.

package/dist/primitives/location.schema.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { validateNoSuspiciousPatterns } from "../helpers/parameter-validation";
+import { validateNoSuspiciousPatterns } from "../helpers/parameter-validation.js";
 /**
  * Zod schema for validating location parameter in findbyaddress endpoint.
  * Checks for minimum length and suspicious patterns.

package/dist/primitives/longitude.schema.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { hasValidDecimalPrecision } from "./coordinate-precision";
+import { hasValidDecimalPrecision } from "./coordinate-precision.js";
 /**
  * Zod schema for validating longitude coordinates.
  * Longitude must be a number between -180 and 180 degrees inclusive.

package/dist/primitives/slug.schema.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { validateNoSuspiciousPatterns } from "../helpers/parameter-validation";
-import { slugify } from "../helpers/slugify";
+import { validateNoSuspiciousPatterns } from "../helpers/parameter-validation.js";
+import { slugify } from "../helpers/slugify.js";
 /**
  * Zod schema for validating slug parameter in community slug endpoint.
  * Checks for length between 2-150 characters and suspicious patterns.

package/dist/time/bounded-time.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounded-time.schema.d.ts","sourceRoot":"","sources":["../../src/time/bounded-time.schema.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,eAAoB,OAsC5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,eAAoB,OAqC5E"}
+{"version":3,"file":"bounded-time.schema.d.ts","sourceRoot":"","sources":["../../src/time/bounded-time.schema.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,eAAoB,OAwC5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,eAAoB,OAuC5E"}

package/dist/time/bounded-time.schema.js

@@ -1,6 +1,6 @@
-import { FlexibleTimePastSchema } from "./flexible-time.schema";
-import { RelativeTimePastSchema } from "./relative-time.schema";
-import { parseRelativeTime } from "./time-helpers";
+import { FlexibleTimePastSchema } from "./flexible-time.schema.js";
+import { RelativeTimePastSchema } from "./relative-time.schema.js";
+import { parseRelativeTime } from "./time-helpers.js";
 /**
  * Creates a flexible time schema with min/max boundaries
  * @param options - Boundary configuration
@@ -16,24 +16,26 @@ export function createBoundedFlexibleTimeSchema(options = {}) {
     if (options.min) {
         // Min is the oldest allowed time (furthest in the past)
         // For relative times going backwards, larger values are older
-        const minTime = parseRelativeTime(options.min, new Date(), "past");
-        const minMs = new Date(minTime).getTime();
+        const minBoundary = options.min;
         schema = schema.refine((value) => {
+            const minTime = parseRelativeTime(minBoundary, new Date(), "past");
+            const minMs = new Date(minTime).getTime();
             const valueMs = new Date(value).getTime();
             return valueMs >= minMs;
         }, {
-            message: `Time must be more recent than ${options.min} ago (minimum: ${minTime})`,
+            message: `Time must be more recent than ${options.min} ago`,
         });
     }
     if (options.max) {
         // Max is the newest allowed time (can be in future for flexible time)
-        const maxTime = parseRelativeTime(options.max, new Date(), "future");
-        const maxMs = new Date(maxTime).getTime();
+        const maxBoundary = options.max;
         schema = schema.refine((value) => {
+            const maxTime = parseRelativeTime(maxBoundary, new Date(), "future");
+            const maxMs = new Date(maxTime).getTime();
             const valueMs = new Date(value).getTime();
             return valueMs <= maxMs;
         }, {
-            message: `Time must be before ${options.max} in the future (maximum: ${maxTime})`,
+            message: `Time must be before ${options.max} in the future`,
         });
     }
     return schema;
@@ -53,24 +55,26 @@ export function createBoundedRelativeTimeSchema(options = {}) {
     let schema = RelativeTimePastSchema;
     if (options.min) {
         // Min is the most recent allowed (closest to now)
-        const minTime = parseRelativeTime(options.min, new Date(), "past");
-        const minMs = new Date(minTime).getTime();
+        const minBoundary = options.min;
         schema = schema.refine((value) => {
+            const minTime = parseRelativeTime(minBoundary, new Date(), "past");
+            const minMs = new Date(minTime).getTime();
             const valueMs = new Date(value).getTime();
             return valueMs <= minMs; // Value must be older (earlier) than min
         }, {
-            message: `Time must be at least ${options.min} ago (more recent than ${minTime})`,
+            message: `Time must be at least ${options.min} ago`,
         });
     }
     if (options.max) {
         // Max is the oldest allowed (furthest from now)
-        const maxTime = parseRelativeTime(options.max, new Date(), "past");
-        const maxMs = new Date(maxTime).getTime();
+        const maxBoundary = options.max;
         schema = schema.refine((value) => {
+            const maxTime = parseRelativeTime(maxBoundary, new Date(), "past");
+            const maxMs = new Date(maxTime).getTime();
             const valueMs = new Date(value).getTime();
             return valueMs >= maxMs; // Value must be newer (later) than max
         }, {
-            message: `Time cannot be more than ${options.max} ago (older than ${maxTime})`,
+            message: `Time cannot be more than ${options.max} ago`,
         });
     }
     return schema;

package/dist/time/flexible-time-parser.d.ts

@@ -1,4 +1,4 @@
-import { FlexibleTime } from "./time-schemas";
+import { FlexibleTime } from "./time-schemas.js";
 /**
  * Parse a flexible time input (ISO 8601 or relative format) to ISO 8601 string
  * Uses Zod schemas for validation instead of manual parsing

package/dist/time/flexible-time-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flexible-time-parser.d.ts","sourceRoot":"","sources":["../../src/time/flexible-time-parser.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,YAAY,EACb,MAAM,gBAAgB,CAAC;AAKxB;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,QAAQ,GAAE,IAAiB,GAC1B,MAAM,CA2FR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,IAAI,IAC7C,OAAO,YAAY,YAC5B"}
+{"version":3,"file":"flexible-time-parser.d.ts","sourceRoot":"","sources":["../../src/time/flexible-time-parser.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,YAAY,EACb,MAAM,mBAAmB,CAAC;AAK3B;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,QAAQ,GAAE,IAAiB,GAC1B,MAAM,CA2FR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,IAAI,IAC7C,OAAO,YAAY,YAC5B"}

package/dist/time/flexible-time-parser.js

@@ -1,8 +1,8 @@
 import dayjs from "dayjs";
 import isoWeek from "dayjs/plugin/isoWeek.js";
 import utc from "dayjs/plugin/utc.js";
-import { ISO8601Schema } from "./iso8601.types";
-import { RelativeTimeSchema, FlexibleTimeSchema, } from "./time-schemas";
+import { ISO8601Schema } from "./iso8601.types.js";
+import { RelativeTimeSchema, FlexibleTimeSchema, } from "./time-schemas.js";
 dayjs.extend(isoWeek);
 dayjs.extend(utc);
 /**

package/dist/time/flexible-time.schema.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
-import { ISO8601Schema } from "./iso8601.schema";
-import { RelativeTimeSchema } from "./relative-time.schema";
-import { parseFlexibleTime } from "./time-helpers";
+import { ISO8601Schema } from "./iso8601.schema.js";
+import { RelativeTimeSchema } from "./relative-time.schema.js";
+import { parseFlexibleTime } from "./time-helpers.js";
 /**
  * Core validation schema for flexible time input
  * Accepts either ISO8601 datetime or relative time expression

package/dist/time/relative-time.schema.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { parseRelativeTime } from "./time-helpers";
+import { parseRelativeTime } from "./time-helpers.js";
 /**
  * Core validation schema for relative time expressions
  * Supports: "1m" (minute), "2h" (hour), "3d" (day), "1w" (week), "2M" (month)

package/dist/time/time-helpers.js

@@ -1,7 +1,7 @@
 import dayjs from "dayjs";
 import utc from "dayjs/plugin/utc.js";
-import { ISO8601Schema } from "./iso8601.schema";
-import { RelativeTimeSchema } from "./relative-time.schema";
+import { ISO8601Schema } from "./iso8601.schema.js";
+import { RelativeTimeSchema } from "./relative-time.schema.js";
 dayjs.extend(utc);
 /**
  * Helper function to parse relative time and calculate the datetime

package/dist/time/time-schemas.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { ISO8601Schema } from "./iso8601.types";
+import { ISO8601Schema } from "./iso8601.types.js";
 export const RelativeTimeSchema = z.union([
     z.literal("now"),
     z.literal("today"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schafevormfenster/rest-commons",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Centralized authority for REST standards and schemas - XSD schemas, parsing functions, and coding instructions",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,20 +20,20 @@
     "node": ">=24"
   },
   "devDependencies": {
-    "@types/node": "^22.19.3",
-    "@typescript-eslint/eslint-plugin": "^8.51.0",
-    "@typescript-eslint/parser": "^8.51.0",
+    "@types/node": "^22.19.10",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
     "eslint": "^9.39.2",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.16",
-    "@schafevormfenster/eslint-config": "0.0.9"
+    "vitest": "^4.0.18",
+    "@schafevormfenster/eslint-config": "0.0.24"
   },
   "dependencies": {
     "dayjs": "^1.11.19",
     "slugify": "^1.6.6",
     "zod": "^3.25.76",
-    "@schafevormfenster/logging": "0.1.7",
-    "@schafevormfenster/security": "0.1.4"
+    "@schafevormfenster/logging": "0.1.8",
+    "@schafevormfenster/security": "0.1.5"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/src/api-schemas/error.schema.test.ts

@@ -3,25 +3,31 @@ import { describe, it, expect } from "vitest";
 import { ApiErrorSchema, ApiErrorConstructor } from "./error.schema";
 
 describe("ApiErrorSchema", () => {
-  it("validates error shape for 4xx/5xx", () => {
-    const parsed = ApiErrorSchema.parse({ status: 404, error: "Not Found" });
-    expect(parsed.status).toBe(404);
-    expect(parsed.error).toMatch(/not found/i);
+  describe("Happy Path", () => {
+    it("validates error shape for 4xx/5xx", () => {
+      const parsed = ApiErrorSchema.parse({ status: 404, error: "Not Found" });
+      expect(parsed.status).toBe(404);
+      expect(parsed.error).toMatch(/not found/i);
+    });
   });
 
-  it("rejects non-error status codes", () => {
-    expect(() => ApiErrorSchema.parse({ status: 200, error: "ok" })).toThrow();
-    expect(() =>
-      ApiErrorSchema.parse({ status: 600, error: "invalid" })
-    ).toThrow();
+  describe("Error Handling", () => {
+    it("rejects non-error status codes", () => {
+      expect(() => ApiErrorSchema.parse({ status: 200, error: "ok" })).toThrow();
+      expect(() =>
+        ApiErrorSchema.parse({ status: 600, error: "invalid" })
+      ).toThrow();
+    });
   });
 });
 
 describe("ApiError class", () => {
-  it("sets status and name", () => {
-    const error = new ApiErrorConstructor(418, "I'm a teapot");
-    expect(error.status).toBe(418);
-    expect(error.message).toMatch(/i'm a teapot/i);
-    expect(error.name).toBe("ApiError");
+  describe("Happy Path", () => {
+    it("sets status and name", () => {
+      const error = new ApiErrorConstructor(418, "I'm a teapot");
+      expect(error.status).toBe(418);
+      expect(error.message).toMatch(/i'm a teapot/i);
+      expect(error.name).toBe("ApiError");
+    });
   });
 });

package/src/api-schemas/health.schema.test.ts

@@ -13,136 +13,140 @@ import {
 } from "./health.schema";
 
 describe("health.schema", () => {
-  it("parses healthy service info", () => {
-    const service = HealthyServiceInfoSchema.parse({
-      name: "Example",
-      status: 200,
-      message: "healthy",
-      version: "1.0.0",
+  describe("Happy Path", () => {
+    it("parses healthy service info", () => {
+      const service = HealthyServiceInfoSchema.parse({
+        name: "Example",
+        status: 200,
+        message: "healthy",
+        version: "1.0.0",
+      });
+      expect(service.name).toBe("Example");
+      expect(service.status).toBe(200);
+      expect(service.message).toMatch(/healthy/i);
     });
-    expect(service.name).toBe("Example");
-    expect(service.status).toBe(200);
-    expect(service.message).toMatch(/healthy/i);
-  });
 
-  it("parses unhealthy service info", () => {
-    const service = UnhealthyServiceInfoSchema.parse({
-      name: "Example",
-      status: 503,
-      error: "Service unavailable",
-      version: "1.0.0",
+    it("parses unhealthy service info", () => {
+      const service = UnhealthyServiceInfoSchema.parse({
+        name: "Example",
+        status: 503,
+        error: "Service unavailable",
+        version: "1.0.0",
+      });
+      expect(service.status).toBe(503);
+      expect(service.error).toMatch(/service unavailable/i);
     });
-    expect(service.status).toBe(503);
-    expect(service.error).toMatch(/service unavailable/i);
-  });
 
-  it("parses degraded service info", () => {
-    const service = DegradedServiceInfoSchema.parse({
-      name: "Example",
-      status: 202,
-      message: "degraded",
-      version: "1.0.0",
+    it("parses degraded service info", () => {
+      const service = DegradedServiceInfoSchema.parse({
+        name: "Example",
+        status: 202,
+        message: "degraded",
+        version: "1.0.0",
+      });
+      expect(service.name).toBe("Example");
+      expect(service.status).toBe(202);
+      expect(service.message).toMatch(/degraded/i);
     });
-    expect(service.name).toBe("Example");
-    expect(service.status).toBe(202);
-    expect(service.message).toMatch(/degraded/i);
-  });
 
-  it("parses healthy API status", () => {
-    const status = HealthyApiStatusSchema.parse({
-      status: 200,
-      name: "api",
-      version: "1.0.0",
-      description: "ok",
-      services: [
-        { name: "svc", status: 200, message: "healthy" },
-        { name: "svc2", status: 500, error: "fail" },
-      ],
+    it("parses healthy API status", () => {
+      const status = HealthyApiStatusSchema.parse({
+        status: 200,
+        name: "api",
+        version: "1.0.0",
+        description: "ok",
+        services: [
+          { name: "svc", status: 200, message: "healthy" },
+          { name: "svc2", status: 500, error: "fail" },
+        ],
+      });
+      expect(status.status).toBe(200);
+      expect(status.services).toHaveLength(2);
     });
-    expect(status.status).toBe(200);
-    expect(status.services).toHaveLength(2);
-  });
 
-  it("parses unhealthy API status", () => {
-    const status = UnhealthyApiStatusSchema.parse({
-      status: 500,
-      error: "bad",
-      name: "api",
-      version: "1.0.0",
-      services: [{ name: "svc", status: 500, error: "boom" }],
+    it("parses unhealthy API status", () => {
+      const status = UnhealthyApiStatusSchema.parse({
+        status: 500,
+        error: "bad",
+        name: "api",
+        version: "1.0.0",
+        services: [{ name: "svc", status: 500, error: "boom" }],
+      });
+      expect(status.error).toMatch(/bad/i);
     });
-    expect(status.error).toMatch(/bad/i);
-  });
 
-  it("parses degraded API status", () => {
-    const status = DegradedApiStatusSchema.parse({
-      status: 202,
-      name: "api",
-      version: "1.0.0",
-      description: "partially operational",
-      services: [
-        { name: "svc1", status: 200, message: "healthy" },
-        { name: "svc2", status: 202, message: "degraded" },
-      ],
+    it("parses degraded API status", () => {
+      const status = DegradedApiStatusSchema.parse({
+        status: 202,
+        name: "api",
+        version: "1.0.0",
+        description: "partially operational",
+        services: [
+          { name: "svc1", status: 200, message: "healthy" },
+          { name: "svc2", status: 202, message: "degraded" },
+        ],
+      });
+      expect(status.status).toBe(202);
+      expect(status.services).toHaveLength(2);
     });
-    expect(status.status).toBe(202);
-    expect(status.services).toHaveLength(2);
-  });
 
-  it("ApiInfoSchema validates basic api info", () => {
-    const info = ApiInfoSchema.parse({
-      name: "api",
-      version: "1.2.3",
-      description: "desc",
-      services: [{ name: "svc", status: 200, message: "healthy" }],
+    it("ApiInfoSchema validates basic api info", () => {
+      const info = ApiInfoSchema.parse({
+        name: "api",
+        version: "1.2.3",
+        description: "desc",
+        services: [{ name: "svc", status: 200, message: "healthy" }],
+      });
+      expect(info.name).toBe("api");
     });
-    expect(info.name).toBe("api");
   });
 
-  it("ApiStatusSchema accepts healthy, degraded, and unhealthy variants", () => {
-    const healthy = ApiStatusSchema.parse({
-      status: 200,
-      name: "api",
-      version: "1.0.0",
-      services: [{ name: "svc", status: 200, message: "healthy" }],
-    });
-    expect(healthy.status).toBe(200);
+  describe("Edge Cases", () => {
+    it("ApiStatusSchema accepts healthy, degraded, and unhealthy variants", () => {
+      const healthy = ApiStatusSchema.parse({
+        status: 200,
+        name: "api",
+        version: "1.0.0",
+        services: [{ name: "svc", status: 200, message: "healthy" }],
+      });
+      expect(healthy.status).toBe(200);
 
-    const degraded = ApiStatusSchema.parse({
-      status: 202,
-      name: "api",
-      version: "1.0.0",
-      services: [{ name: "svc", status: 202, message: "degraded" }],
-    });
-    expect(degraded.status).toBe(202);
+      const degraded = ApiStatusSchema.parse({
+        status: 202,
+        name: "api",
+        version: "1.0.0",
+        services: [{ name: "svc", status: 202, message: "degraded" }],
+      });
+      expect(degraded.status).toBe(202);
 
-    const unhealthy = ApiStatusSchema.parse({
-      status: 503,
-      error: "down",
-      name: "api",
-      version: "1.0.0",
-      services: [{ name: "svc", status: 503, error: "down" }],
+      const unhealthy = ApiStatusSchema.parse({
+        status: 503,
+        error: "down",
+        name: "api",
+        version: "1.0.0",
+        services: [{ name: "svc", status: 503, error: "down" }],
+      });
+      expect(unhealthy.status).toBe(503);
     });
-    expect(unhealthy.status).toBe(503);
-  });
 
-  it("ServiceStatusSchema union validates all three variants", () => {
-    expect(
-      ServiceStatusSchema.parse({
-        name: "svc",
-        status: 200,
-        message: "healthy",
-      })
-    ).toBeTruthy();
-    expect(
-      ServiceStatusSchema.parse({
-        name: "svc",
-        status: 202,
-        message: "degraded",
-      })
-    ).toBeTruthy();
-    expect(
-      ServiceStatusSchema.parse({ name: "svc", status: 500, error: "err" })
-    ).toBeTruthy();
+    it("ServiceStatusSchema union validates all three variants", () => {
+      expect(
+        ServiceStatusSchema.parse({
+          name: "svc",
+          status: 200,
+          message: "healthy",
+        })
+      ).toBeTruthy();
+      expect(
+        ServiceStatusSchema.parse({
+          name: "svc",
+          status: 202,
+          message: "degraded",
+        })
+      ).toBeTruthy();
+      expect(
+        ServiceStatusSchema.parse({ name: "svc", status: 500, error: "err" })
+      ).toBeTruthy();
+    });
   });
 });

package/src/api-schemas/health.schema.ts

@@ -1,8 +1,8 @@
 
 import { z } from "zod";
 
-import { ApiErrorSchema } from "./error.schema";
-import { OkaySchema } from "./okay.schema";
+import { ApiErrorSchema } from "./error.schema.js";
+import { OkaySchema } from "./okay.schema.js";
 
 /**
  * Services

package/src/api-schemas/okay.schema.test.ts

@@ -3,13 +3,17 @@ import { describe, it, expect } from "vitest";
 import { OkaySchema } from "./okay.schema";
 
 describe("OkaySchema", () => {
-  it("accepts 2xx status codes", () => {
-    expect(OkaySchema.parse({ status: 200 })).toEqual({ status: 200 });
-    expect(OkaySchema.parse({ status: 299 })).toEqual({ status: 299 });
+  describe("Happy Path", () => {
+    it("accepts 2xx status codes", () => {
+      expect(OkaySchema.parse({ status: 200 })).toEqual({ status: 200 });
+      expect(OkaySchema.parse({ status: 299 })).toEqual({ status: 299 });
+    });
   });
 
-  it("rejects non-2xx status codes", () => {
-    expect(() => OkaySchema.parse({ status: 199 })).toThrow();
-    expect(() => OkaySchema.parse({ status: 300 })).toThrow();
+  describe("Error Handling", () => {
+    it("rejects invalid input with non-2xx status codes", () => {
+      expect(() => OkaySchema.parse({ status: 199 })).toThrow();
+      expect(() => OkaySchema.parse({ status: 300 })).toThrow();
+    });
   });
 });