@drmxrcy/tcg-core 0.0.0-202602060542

package/src/zones/zone-factory.test.ts

@@ -0,0 +1,183 @@
+import { describe, expect, it } from "bun:test";
+import { createCardId, createPlayerId, createZoneId } from "../types";
+import type { CardZoneConfig } from "./zone";
+import { createZone } from "./zone-factory";
+
+describe("Zone Factory", () => {
+  describe("createZone", () => {
+    it("should create a zone with valid configuration", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("deck"),
+        name: "Deck",
+        visibility: "secret",
+        ordered: true,
+        faceDown: true,
+      };
+
+      const zone = createZone(config);
+
+      expect(zone.config).toEqual(config);
+      expect(zone.cards).toBeInstanceOf(Array);
+      expect(zone.cards).toHaveLength(0);
+    });
+
+    it("should create a zone with initial cards", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("hand"),
+        name: "Hand",
+        visibility: "private",
+        ordered: false,
+      };
+
+      const initialCards = [createCardId("card-1"), createCardId("card-2")];
+      const zone = createZone(config, initialCards);
+
+      expect(zone.cards).toEqual(initialCards);
+      expect(zone.cards).toHaveLength(2);
+    });
+
+    it("should create zone with minimal configuration", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("play"),
+        name: "Play Area",
+        visibility: "public",
+        ordered: false,
+      };
+
+      const zone = createZone(config);
+
+      expect(zone.config.id).toBe(config.id);
+      expect(zone.config.name).toBe(config.name);
+      expect(zone.config.visibility).toBe("public");
+      expect(zone.config.owner).toBeUndefined();
+      expect(zone.config.maxSize).toBeUndefined();
+      expect(zone.cards).toHaveLength(0);
+    });
+
+    it("should validate maxSize when provided", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("hand"),
+        name: "Hand",
+        visibility: "private",
+        ordered: false,
+        maxSize: 7,
+      };
+
+      const zone = createZone(config);
+      expect(zone.config.maxSize).toBe(7);
+    });
+
+    it("should throw error if initial cards exceed maxSize", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("hand"),
+        name: "Hand",
+        visibility: "private",
+        ordered: false,
+        maxSize: 2,
+      };
+
+      const tooManyCards = [
+        createCardId("card-1"),
+        createCardId("card-2"),
+        createCardId("card-3"),
+      ];
+
+      expect(() => createZone(config, tooManyCards)).toThrow(
+        "Cannot create zone: initial cards (3) exceed maxSize (2)",
+      );
+    });
+
+    it("should create ordered zone (deck)", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("deck"),
+        name: "Deck",
+        visibility: "secret",
+        ordered: true,
+        faceDown: true,
+      };
+
+      const zone = createZone(config);
+
+      expect(zone.config.ordered).toBe(true);
+      expect(zone.config.faceDown).toBe(true);
+    });
+
+    it("should create unordered zone (play area)", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("play"),
+        name: "Play Area",
+        visibility: "public",
+        ordered: false,
+      };
+
+      const zone = createZone(config);
+
+      expect(zone.config.ordered).toBe(false);
+    });
+
+    it("should create zone with owner", () => {
+      const playerId = createPlayerId("player-1");
+      const config: CardZoneConfig = {
+        id: createZoneId("hand"),
+        name: "Hand",
+        visibility: "private",
+        ordered: false,
+        owner: playerId,
+      };
+
+      const zone = createZone(config);
+
+      expect(zone.config.owner).toBe(playerId);
+    });
+
+    it("should create shared zone without owner", () => {
+      const config: CardZoneConfig = {
+        id: createZoneId("graveyard"),
+        name: "Graveyard",
+        visibility: "public",
+        ordered: true,
+      };
+
+      const zone = createZone(config);
+
+      expect(zone.config.owner).toBeUndefined();
+    });
+
+    it("should validate zone id is provided", () => {
+      const invalidConfig = {
+        name: "Test Zone",
+        visibility: "public",
+        ordered: false,
+      } as CardZoneConfig;
+
+      expect(() => createZone(invalidConfig)).toThrow(
+        "Zone configuration must include an id",
+      );
+    });
+
+    it("should validate zone name is provided", () => {
+      const invalidConfig = {
+        id: createZoneId("test"),
+        visibility: "public",
+        ordered: false,
+      } as CardZoneConfig;
+
+      expect(() => createZone(invalidConfig)).toThrow(
+        "Zone configuration must include a name",
+      );
+    });
+
+    it("should validate visibility is valid", () => {
+      const invalidConfig = {
+        id: createZoneId("test"),
+        name: "Test Zone",
+        visibility: "invalid",
+        ordered: false,
+      } as unknown as CardZoneConfig;
+
+      expect(() => createZone(invalidConfig)).toThrow(
+        'Invalid visibility: must be "public", "private", or "secret"',
+      );
+    });
+  });
+});

package/src/zones/zone-factory.ts

@@ -0,0 +1,44 @@
+import type { CardId } from "../types";
+import type { CardZoneConfig, Zone, ZoneVisibility } from "./zone";
+
+const VALID_VISIBILITIES: ZoneVisibility[] = ["public", "private", "secret"];
+
+/**
+ * Creates a new zone with the given configuration
+ * @param config - Zone configuration
+ * @param initialCards - Optional initial cards for the zone
+ * @returns A new Zone instance
+ * @throws Error if configuration is invalid or initial cards exceed maxSize
+ */
+export function createZone(
+  config: CardZoneConfig,
+  initialCards: CardId[] = [],
+): Zone {
+  // Validate required fields
+  if (!config.id) {
+    throw new Error("Zone configuration must include an id");
+  }
+
+  if (!config.name) {
+    throw new Error("Zone configuration must include a name");
+  }
+
+  // Validate visibility
+  if (!VALID_VISIBILITIES.includes(config.visibility)) {
+    throw new Error(
+      'Invalid visibility: must be "public", "private", or "secret"',
+    );
+  }
+
+  // Validate maxSize constraint
+  if (config.maxSize !== undefined && initialCards.length > config.maxSize) {
+    throw new Error(
+      `Cannot create zone: initial cards (${initialCards.length}) exceed maxSize (${config.maxSize})`,
+    );
+  }
+
+  return {
+    config,
+    cards: [...initialCards],
+  };
+}