add basic tests I ran into for the api schema

Author: justinmakaila

packages/api/schema/README.md

@@ -17,3 +17,9 @@ const result = IRacingGetCarResponseSchema.parse(apiResponse);
 ```
 
 Use the schemas directly for runtime validation or feed them into helpers like `@iracing-data/api-schema-to-openapi` for OpenAPI generation.
+
+## Development
+
+```bash
+pnpm --filter @iracing-data/api-schema test
+```

packages/api/schema/package.json

@@ -18,9 +18,10 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc --build tsconfig.build.json"
+    "build": "tsc --build tsconfig.build.json",
+    "test": "node --test -r ts-node/register src/schema/primitives.test.ts src/schema/parameters.test.ts"
   },
   "dependencies": {
     "zod": "^4.1.13"
   }
-}
+}

packages/api/schema/src/schema/parameters.test.ts

@@ -0,0 +1,32 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import { IRacingMemberGetParametersSchema } from "./parameters";
+
+describe("IRacingMemberGetParameters", () => {
+  it("coerces single integers", () => {
+    const integerValue = IRacingMemberGetParametersSchema.parse({
+      cust_ids: 1,
+    });
+    assert.deepStrictEqual(integerValue, {
+      cust_ids: "1",
+    });
+  });
+
+  it("preserves cust_ids as a string", () => {
+    const singleValue = IRacingMemberGetParametersSchema.parse({
+      cust_ids: "1",
+    });
+    const multipleValues = IRacingMemberGetParametersSchema.parse({
+      cust_ids: "1,2,3",
+      include_licenses: "true",
+    });
+
+    assert.deepStrictEqual(singleValue, {
+      cust_ids: "1",
+    });
+    assert.deepStrictEqual(multipleValues, {
+      cust_ids: "1,2,3",
+      include_licenses: true,
+    });
+  });
+});

packages/api/schema/src/schema/primitives.test.ts

@@ -0,0 +1,22 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import { CommaSeparatedNumberString } from "./primitives";
+
+describe("CommaSeparatedNumberString", () => {
+  it("coerces single integers", () => {
+    const integerValue = CommaSeparatedNumberString.parse(1);
+
+    assert.strictEqual(integerValue, "1");
+    assert.strictEqual(typeof integerValue, "string");
+  });
+
+  it("preserves comma-separated strings", () => {
+    const singleValue = CommaSeparatedNumberString.parse("1");
+    const multipleValues = CommaSeparatedNumberString.parse("1,2,3");
+
+    assert.strictEqual(singleValue, "1");
+    assert.strictEqual(typeof singleValue, "string");
+    assert.strictEqual(multipleValues, "1,2,3");
+    assert.strictEqual(typeof multipleValues, "string");
+  });
+});

packages/api/schema/src/schema/primitives.ts

@@ -54,9 +54,12 @@ export const IRacingCustomerIdSchema = z.coerce.number().meta({
   id: "customerId",
 });
 
-export const CommaSeparatedNumberString = z.string().regex(/^\d+(?:,\d+)*$/, {
-  message: "Parameter must be a comma-separated list of numbers, e.g. '2,3,4'",
-});
+export const CommaSeparatedNumberString = z.coerce
+  .string()
+  .regex(/^\d+(?:,\d+)*$/, {
+    message:
+      "Parameter must be a comma-separated list of numbers, e.g. '2,3,4'",
+  });
 
 export const IRacingEventTypePracticeSchema = z
   .literal(2)

packages/api/schema/tsconfig.build.json

@@ -7,5 +7,5 @@
     "module": "nodenext",
     "moduleResolution": "nodenext"
   },
-  "exclude": ["node_modules", "dist", "scripts"]
+  "exclude": ["node_modules", "dist", "scripts", "**/*.test.ts"]
 }