@jamesaphoenix/tx-api-server 0.1.2 → 0.5.0

package/dist/__tests__/server-lib.test.js

@@ -0,0 +1,145 @@
+/**
+ * Server Library Tests
+ *
+ * Tests for server configuration and module exports.
+ * Note: makeServerLive and route layers require bun:sqlite (via tx-core)
+ * and can only be tested with `bun test`. These tests cover the parts
+ * that work in Node.js vitest.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { isAuthEnabled } from "../middleware/auth.js";
+import { getCorsConfig } from "../middleware/cors.js";
+// =============================================================================
+// Auth Configuration Tests
+// =============================================================================
+describe("Server auth configuration", () => {
+    let savedEnv;
+    beforeEach(() => {
+        savedEnv = {
+            TX_API_PORT: process.env.TX_API_PORT,
+            TX_API_HOST: process.env.TX_API_HOST,
+            TX_DB_PATH: process.env.TX_DB_PATH,
+            TX_API_KEY: process.env.TX_API_KEY,
+            TX_API_CORS_ORIGIN: process.env.TX_API_CORS_ORIGIN,
+            TX_API_CORS_CREDENTIALS: process.env.TX_API_CORS_CREDENTIALS,
+        };
+    });
+    afterEach(() => {
+        for (const [key, value] of Object.entries(savedEnv)) {
+            if (value === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = value;
+            }
+        }
+    });
+    it("should detect auth enabled via TX_API_KEY", () => {
+        process.env.TX_API_KEY = "my-secret-key";
+        expect(isAuthEnabled()).toBe(true);
+    });
+    it("should detect auth disabled when TX_API_KEY not set", () => {
+        delete process.env.TX_API_KEY;
+        expect(isAuthEnabled()).toBe(false);
+    });
+    it("should detect auth disabled for empty TX_API_KEY", () => {
+        process.env.TX_API_KEY = "";
+        expect(isAuthEnabled()).toBe(false);
+    });
+});
+// =============================================================================
+// CORS Configuration Tests
+// =============================================================================
+describe("CORS configuration", () => {
+    let savedEnv;
+    beforeEach(() => {
+        savedEnv = {
+            TX_API_CORS_ORIGIN: process.env.TX_API_CORS_ORIGIN,
+            TX_API_CORS_CREDENTIALS: process.env.TX_API_CORS_CREDENTIALS,
+        };
+    });
+    afterEach(() => {
+        for (const [key, value] of Object.entries(savedEnv)) {
+            if (value === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = value;
+            }
+        }
+    });
+    it("should default to localhost origins when TX_API_CORS_ORIGIN is not set", () => {
+        delete process.env.TX_API_CORS_ORIGIN;
+        const config = getCorsConfig();
+        expect(config.allowedOrigins).toEqual([
+            "http://localhost:3000",
+            "http://localhost:3001",
+            "http://localhost:5173",
+            "http://127.0.0.1:3000",
+            "http://127.0.0.1:3001",
+            "http://127.0.0.1:5173",
+        ]);
+        // Must NOT include wildcard by default
+        expect(config.allowedOrigins).not.toContain("*");
+    });
+    it("should allow wildcard only when explicitly set to *", () => {
+        process.env.TX_API_CORS_ORIGIN = "*";
+        const config = getCorsConfig();
+        expect(config.allowedOrigins).toEqual(["*"]);
+    });
+    it("should parse comma-separated origins", () => {
+        process.env.TX_API_CORS_ORIGIN = "https://app.example.com, https://admin.example.com";
+        const config = getCorsConfig();
+        expect(config.allowedOrigins).toEqual([
+            "https://app.example.com",
+            "https://admin.example.com",
+        ]);
+    });
+    it("should handle single custom origin", () => {
+        process.env.TX_API_CORS_ORIGIN = "https://myapp.com";
+        const config = getCorsConfig();
+        expect(config.allowedOrigins).toEqual(["https://myapp.com"]);
+    });
+    it("should enable credentials when TX_API_CORS_CREDENTIALS is true", () => {
+        process.env.TX_API_CORS_CREDENTIALS = "true";
+        const config = getCorsConfig();
+        expect(config.credentials).toBe(true);
+    });
+    it("should disable credentials by default", () => {
+        delete process.env.TX_API_CORS_CREDENTIALS;
+        const config = getCorsConfig();
+        expect(config.credentials).toBe(false);
+    });
+});
+// =============================================================================
+// API Definition Exports Tests (no bun:sqlite dependency)
+// =============================================================================
+describe("API definition exports", () => {
+    it("should export TxApi class from api.ts", async () => {
+        const { TxApi } = await import("../api.js");
+        expect(TxApi).toBeDefined();
+    });
+    it("should export all error types from api.ts", async () => {
+        const { NotFound, BadRequest, InternalError, Unauthorized, Forbidden, ServiceUnavailable } = await import("../api.js");
+        expect(NotFound).toBeDefined();
+        expect(BadRequest).toBeDefined();
+        expect(InternalError).toBeDefined();
+        expect(Unauthorized).toBeDefined();
+        expect(Forbidden).toBeDefined();
+        expect(ServiceUnavailable).toBeDefined();
+    });
+    it("should export mapCoreError from api.ts", async () => {
+        const { mapCoreError } = await import("../api.js");
+        expect(mapCoreError).toBeDefined();
+        expect(typeof mapCoreError).toBe("function");
+    });
+    it("should export all API groups from api.ts", async () => {
+        const { HealthGroup, TasksGroup, LearningsGroup, RunsGroup, SyncGroup } = await import("../api.js");
+        expect(HealthGroup).toBeDefined();
+        expect(TasksGroup).toBeDefined();
+        expect(LearningsGroup).toBeDefined();
+        expect(RunsGroup).toBeDefined();
+        expect(SyncGroup).toBeDefined();
+    });
+});
+//# sourceMappingURL=server-lib.test.js.map

package/dist/__tests__/server-lib.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-lib.test.js","sourceRoot":"","sources":["../../src/__tests__/server-lib.test.ts"],"names":[],"mappings":"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"}