@crazygiscool/cap 1.1.8 → 1.1.10

package/dist/__tests__/dynamic-schema.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/dynamic-schema.test.js

@@ -0,0 +1,114 @@
+import { describe, it, expect } from "vitest";
+import { generateDynamicSchema, } from "../index.js";
+const baseFields = {
+    name: "Optimus Prime",
+    description: "Leader of the Autobots",
+    continuityId: "g1",
+    factions: ["Autobots"],
+};
+describe("generateDynamicSchema", () => {
+    it("returns base schema when customFields is empty", () => {
+        const schema = generateDynamicSchema([]);
+        const result = schema.safeParse(baseFields);
+        expect(result.success).toBe(true);
+    });
+    it("adds a string field", () => {
+        const fields = [
+            { key: "sparkId", type: "string", label: "Spark Signature" },
+        ];
+        const schema = generateDynamicSchema(fields);
+        const result = schema.safeParse({
+            ...baseFields,
+            sparkId: "SP-2187",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("rejects a number for a string field", () => {
+        const fields = [
+            { key: "sparkId", type: "string", label: "Spark Signature" },
+        ];
+        const schema = generateDynamicSchema(fields);
+        const result = schema.safeParse({
+            ...baseFields,
+            sparkId: 42,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("adds a number field", () => {
+        const fields = [
+            { key: "firepower", type: "number", label: "Firepower Rating" },
+        ];
+        const schema = generateDynamicSchema(fields);
+        const ok = schema.safeParse({
+            ...baseFields,
+            firepower: 9000,
+        });
+        expect(ok.success).toBe(true);
+        const fail = schema.safeParse({
+            ...baseFields,
+            firepower: "over 9000",
+        });
+        expect(fail.success).toBe(false);
+    });
+    it("adds a boolean field", () => {
+        const fields = [
+            { key: "isOnline", type: "boolean", label: "Online Status" },
+        ];
+        const schema = generateDynamicSchema(fields);
+        const ok = schema.safeParse({
+            ...baseFields,
+            isOnline: true,
+        });
+        expect(ok.success).toBe(true);
+        const fail = schema.safeParse({
+            ...baseFields,
+            isOnline: "yes",
+        });
+        expect(fail.success).toBe(false);
+    });
+    it("adds a date field (ISO datetime string)", () => {
+        const fields = [
+            { key: "activated", type: "date", label: "Activation Date" },
+        ];
+        const schema = generateDynamicSchema(fields);
+        const ok = schema.safeParse({
+            ...baseFields,
+            activated: "2024-01-15T08:00:00.000Z",
+        });
+        expect(ok.success).toBe(true);
+        const fail = schema.safeParse({
+            ...baseFields,
+            activated: "not-a-date",
+        });
+        expect(fail.success).toBe(false);
+    });
+    it("handles multiple custom fields of different types", () => {
+        const fields = [
+            { key: "sparkId", type: "string", label: "Spark Signature" },
+            { key: "firepower", type: "number", label: "Firepower Rating" },
+            { key: "isOnline", type: "boolean", label: "Online Status" },
+        ];
+        const schema = generateDynamicSchema(fields);
+        const result = schema.safeParse({
+            ...baseFields,
+            sparkId: "SP-2187",
+            firepower: 9000,
+            isOnline: true,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("rejects missing custom fields", () => {
+        const fields = [
+            { key: "sparkId", type: "string", label: "Spark Signature" },
+        ];
+        const schema = generateDynamicSchema(fields);
+        const result = schema.safeParse(baseFields);
+        expect(result.success).toBe(false);
+    });
+    it("still enforces base schema requirements", () => {
+        const schema = generateDynamicSchema([]);
+        const result = schema.safeParse({ name: "Megatron" });
+        expect(result.success).toBe(false);
+    });
+});
+//# sourceMappingURL=dynamic-schema.test.js.map

package/dist/__tests__/dynamic-schema.test.js.map

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

package/dist/__tests__/repository.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/repository.test.js

@@ -0,0 +1,160 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { CAPRepository } from "../index.js";
+class TestRepository extends CAPRepository {
+    constructor(db) {
+        super(db, "test_entries");
+    }
+}
+function mockDb() {
+    const mockCollection = {
+        insertOne: vi.fn(),
+        findOne: vi.fn(),
+        find: vi.fn(() => ({
+            toArray: vi.fn(),
+        })),
+        findOneAndUpdate: vi.fn(),
+        deleteOne: vi.fn(),
+    };
+    const db = {
+        collection: vi.fn(() => mockCollection),
+    };
+    return { db, collection: mockCollection };
+}
+describe("CAPRepository", () => {
+    let repo;
+    let collection;
+    beforeEach(() => {
+        const { db, collection: c } = mockDb();
+        repo = new TestRepository(db);
+        collection = c;
+    });
+    describe("create", () => {
+        it("inserts a document with generated id and timestamps", async () => {
+            collection.insertOne.mockResolvedValue({ acknowledged: true });
+            const result = await repo.create({
+                name: "Optimus Prime",
+                description: "Leader of the Autobots",
+                continuityId: "g1",
+                factions: ["Autobots"],
+                sparkId: "SP-2187",
+            });
+            expect(result.id).toBeDefined();
+            expect(typeof result.id).toBe("string");
+            expect(result.createdAt).toBeInstanceOf(Date);
+            expect(result.updatedAt).toBeInstanceOf(Date);
+            expect(result.name).toBe("Optimus Prime");
+            expect(result.sparkId).toBe("SP-2187");
+            expect(collection.insertOne).toHaveBeenCalledOnce();
+            const inserted = collection.insertOne.mock.calls[0][0];
+            expect(inserted.id).toBe(result.id);
+            expect(inserted.createdAt).toBeInstanceOf(Date);
+            expect(inserted.updatedAt).toBeInstanceOf(Date);
+        });
+    });
+    describe("findById", () => {
+        it("returns a document by id", async () => {
+            const doc = {
+                _id: "abc",
+                id: "uuid-123",
+                name: "Bumblebee",
+                description: "Scout",
+                continuityId: "g1",
+                factions: ["Autobots"],
+                sparkId: "SP-0001",
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            };
+            collection.findOne.mockResolvedValue(doc);
+            const result = await repo.findById("uuid-123");
+            expect(result).toEqual(doc);
+            expect(collection.findOne).toHaveBeenCalledWith({ id: "uuid-123" });
+        });
+        it("returns null when not found", async () => {
+            collection.findOne.mockResolvedValue(null);
+            const result = await repo.findById("nonexistent");
+            expect(result).toBeNull();
+        });
+    });
+    describe("findByName", () => {
+        it("returns a document by name (case-insensitive)", async () => {
+            const doc = {
+                _id: "abc",
+                id: "uuid-1",
+                name: "Megatron",
+                description: "Decepticon leader",
+                continuityId: "g1",
+                factions: ["Decepticons"],
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            };
+            collection.findOne.mockResolvedValue(doc);
+            const result = await repo.findByName("megatron");
+            expect(result).toEqual(doc);
+        });
+        it("returns null when not found", async () => {
+            collection.findOne.mockResolvedValue(null);
+            const result = await repo.findByName("Starscream");
+            expect(result).toBeNull();
+        });
+    });
+    describe("listAll", () => {
+        it("returns all documents", async () => {
+            const docs = [
+                { id: "1", name: "A", description: "", continuityId: "g1", factions: [], createdAt: new Date(), updatedAt: new Date() },
+                { id: "2", name: "B", description: "", continuityId: "g1", factions: [], createdAt: new Date(), updatedAt: new Date() },
+            ];
+            collection.find.mockReturnValue({ toArray: vi.fn().mockResolvedValue(docs) });
+            const result = await repo.listAll();
+            expect(result).toEqual(docs);
+            expect(result).toHaveLength(2);
+        });
+    });
+    describe("update", () => {
+        it("updates fields and bumps updatedAt", async () => {
+            const original = {
+                id: "uuid-1",
+                name: "Optimus Prime",
+                description: "Old description",
+                continuityId: "g1",
+                factions: ["Autobots"],
+                createdAt: new Date("2020-01-01"),
+                updatedAt: new Date("2020-01-01"),
+            };
+            const updated = {
+                ...original,
+                description: "New description",
+                updatedAt: new Date(),
+            };
+            collection.findOneAndUpdate.mockResolvedValue(updated);
+            const result = await repo.update("uuid-1", {
+                description: "New description",
+            });
+            expect(result).toEqual(updated);
+            expect(collection.findOneAndUpdate).toHaveBeenCalled();
+            const [, updateDoc] = collection.findOneAndUpdate.mock.calls[0];
+            expect(updateDoc.$set.description).toBe("New description");
+            expect(updateDoc.$set.updatedAt).toBeInstanceOf(Date);
+        });
+        it("returns null when document does not exist", async () => {
+            collection.findOneAndUpdate.mockResolvedValue(null);
+            const result = await repo.update("nonexistent", {
+                description: "Nope",
+            });
+            expect(result).toBeNull();
+        });
+    });
+    describe("delete", () => {
+        it("returns true when a document is deleted", async () => {
+            collection.deleteOne.mockResolvedValue({ deletedCount: 1 });
+            const result = await repo.delete("uuid-1");
+            expect(result).toBe(true);
+            expect(collection.deleteOne).toHaveBeenCalledWith({ id: "uuid-1" });
+        });
+        it("returns false when no document matched", async () => {
+            collection.deleteOne.mockResolvedValue({ deletedCount: 0 });
+            const result = await repo.delete("nonexistent");
+            expect(result).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=repository.test.js.map

package/dist/__tests__/repository.test.js.map

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

package/dist/__tests__/settings-loader.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/settings-loader.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect } from "vitest";
+import { mkdtempSync, writeFileSync, unlinkSync, rmdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadSettings } from "../index.js";
+function withTempFile(name, content, fn) {
+    const dir = mkdtempSync(join(tmpdir(), "cap-test-"));
+    const filePath = join(dir, name);
+    writeFileSync(filePath, content, "utf-8");
+    try {
+        fn(filePath);
+    }
+    finally {
+        try {
+            unlinkSync(filePath);
+        }
+        catch { }
+        try {
+            rmdirSync(dir);
+        }
+        catch { }
+    }
+}
+const validSettings = JSON.stringify({
+    databaseName: "Nova Cronum",
+    entryFormat: {
+        requiredFields: ["name", "description", "continuityId", "factions"],
+        customFields: [
+            { key: "sparkId", type: "string", label: "Spark Signature" },
+            { key: "firepower", type: "number", label: "Firepower Rating" },
+        ],
+    },
+});
+describe("loadSettings", () => {
+    it("parses a valid settings file", () => {
+        withTempFile("settings.json", validSettings, (path) => {
+            const config = loadSettings(path);
+            expect(config.databaseName).toBe("Nova Cronum");
+            expect(config.entryFormat.customFields).toHaveLength(2);
+            expect(config.entryFormat.customFields[0].key).toBe("sparkId");
+        });
+    });
+    it("accepts settings without customFields", () => {
+        const minimal = JSON.stringify({
+            databaseName: "Test Universe",
+            entryFormat: {},
+        });
+        withTempFile("settings.json", minimal, (path) => {
+            const config = loadSettings(path);
+            expect(config.databaseName).toBe("Test Universe");
+            expect(config.entryFormat.customFields).toBeUndefined();
+        });
+    });
+    it("throws on missing file", () => {
+        expect(() => loadSettings("/nonexistent/path.json")).toThrow();
+    });
+    it("throws on invalid JSON", () => {
+        withTempFile("settings.json", "{bad json}", (path) => {
+            expect(() => loadSettings(path)).toThrow();
+        });
+    });
+    it("throws on invalid field type", () => {
+        const bad = JSON.stringify({
+            databaseName: "Test",
+            entryFormat: {
+                customFields: [{ key: "x", type: "binary", label: "X" }],
+            },
+        });
+        withTempFile("settings.json", bad, (path) => {
+            expect(() => loadSettings(path)).toThrow();
+        });
+    });
+    it("throws when databaseName is missing", () => {
+        const bad = JSON.stringify({
+            entryFormat: {},
+        });
+        withTempFile("settings.json", bad, (path) => {
+            expect(() => loadSettings(path)).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=settings-loader.test.js.map

package/dist/__tests__/settings-loader.test.js.map

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

package/dist/__tests__/smoke.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/smoke.test.js

@@ -0,0 +1,25 @@
+import { describe, it, expect } from "vitest";
+import { CAPBaseSchema, CAPRepository } from "../index.js";
+describe("CAPBaseSchema", () => {
+    it("validates a correct lore entry", () => {
+        const result = CAPBaseSchema.safeParse({
+            name: "Optimus Prime",
+            description: "Leader of the Autobots",
+            continuityId: "g1",
+            factions: ["Autobots"],
+        });
+        expect(result.success).toBe(true);
+    });
+    it("rejects an entry missing required fields", () => {
+        const result = CAPBaseSchema.safeParse({
+            name: "Megatron",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe("CAPRepository", () => {
+    it("is an abstract class that cannot be instantiated directly", () => {
+        expect(CAPRepository).toBeDefined();
+    });
+});
+//# sourceMappingURL=smoke.test.js.map

package/dist/__tests__/smoke.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.test.js","sourceRoot":"","sources":["../../src/__tests__/smoke.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC;YACrC,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,wBAAwB;YACrC,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC;YACrC,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { Collection, Db } from "mongodb";
+export interface ICAPBaseDocument {
+    id: string;
+    name: string;
+    description: string;
+    continuityId: string;
+    factions: string[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface ILoreVariant<T> {
+    variantName: string;
+    appearanceMediaId: string;
+    specifications: T;
+}
+export declare const CAPBaseSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    continuityId: z.ZodString;
+    factions: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    continuityId: string;
+    factions: string[];
+}, {
+    name: string;
+    description: string;
+    continuityId: string;
+    factions: string[];
+}>;
+export declare abstract class CAPRepository<T extends ICAPBaseDocument> {
+    protected collection: Collection<T>;
+    constructor(db: Db, collectionName: string);
+    create(data: Omit<T, "id" | "createdAt" | "updatedAt">): Promise<T & {
+        id: string;
+    }>;
+    findById(id: string): Promise<T | null>;
+    findByName(name: string): Promise<T | null>;
+    listAll(): Promise<T[]>;
+    update(id: string, data: Partial<Omit<T, "id" | "createdAt" | "updatedAt">>): Promise<T | null>;
+    delete(id: string): Promise<boolean>;
+}
+export type FieldType = "string" | "number" | "boolean" | "date";
+export interface CustomFieldConfig {
+    key: string;
+    type: FieldType;
+    label: string;
+}
+export interface EntryFormatConfig {
+    requiredFields?: string[];
+    customFields?: CustomFieldConfig[];
+}
+export interface SettingsConfig {
+    databaseName: string;
+    entryFormat: EntryFormatConfig;
+}
+export declare const CAPSettingsSchema: z.ZodObject<{
+    databaseName: z.ZodString;
+    entryFormat: z.ZodObject<{
+        requiredFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        customFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "string" | "number" | "boolean" | "date";
+            key: string;
+            label: string;
+        }, {
+            type: "string" | "number" | "boolean" | "date";
+            key: string;
+            label: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requiredFields?: string[] | undefined;
+        customFields?: {
+            type: "string" | "number" | "boolean" | "date";
+            key: string;
+            label: string;
+        }[] | undefined;
+    }, {
+        requiredFields?: string[] | undefined;
+        customFields?: {
+            type: "string" | "number" | "boolean" | "date";
+            key: string;
+            label: string;
+        }[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    databaseName: string;
+    entryFormat: {
+        requiredFields?: string[] | undefined;
+        customFields?: {
+            type: "string" | "number" | "boolean" | "date";
+            key: string;
+            label: string;
+        }[] | undefined;
+    };
+}, {
+    databaseName: string;
+    entryFormat: {
+        requiredFields?: string[] | undefined;
+        customFields?: {
+            type: "string" | "number" | "boolean" | "date";
+            key: string;
+            label: string;
+        }[] | undefined;
+    };
+}>;
+export declare function generateDynamicSchema(customFields: CustomFieldConfig[]): z.ZodObject<z.ZodRawShape>;
+export declare function loadSettings(path: string): SettingsConfig;

package/dist/index.js.map

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

package/package.json

@@ -1,9 +1,21 @@
 {
   "name": "@crazygiscool/cap",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "The Central Archive Protocol core library for lore documentation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "docs/PLAN.md",
+    "docs/QUICKSTART.md"
+  ],
   "type": "module",
   "scripts": {
     "build": "tsc",

package/.github/workflows/publish.yml

@@ -1,53 +0,0 @@
-name: Publish
-
-on:
-  push:
-    tags:
-      - "v*"
-  release:
-    types: [published]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm ci
-      - run: npm run build
-      - run: npm test
-
-  publish-npm:
-    needs: test
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: "https://registry.npmjs.org"
-      - run: npm ci
-      - run: npm run build
-      - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-  publish-github:
-    needs: test
-    runs-on: ubuntu-latest
-    permissions:
-      packages: write
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: "https://npm.pkg.github.com"
-          scope: "@crazygiscool"
-      - run: npm ci
-      - run: npm run build
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/src/__tests__/dynamic-schema.test.ts

@@ -1,130 +0,0 @@
-import { describe, it, expect } from "vitest";
-import {
-  CAPBaseSchema,
-  generateDynamicSchema,
-  type CustomFieldConfig,
-} from "../index.js";
-
-const baseFields = {
-  name: "Optimus Prime",
-  description: "Leader of the Autobots",
-  continuityId: "g1",
-  factions: ["Autobots"],
-};
-
-describe("generateDynamicSchema", () => {
-  it("returns base schema when customFields is empty", () => {
-    const schema = generateDynamicSchema([]);
-    const result = schema.safeParse(baseFields);
-    expect(result.success).toBe(true);
-  });
-
-  it("adds a string field", () => {
-    const fields: CustomFieldConfig[] = [
-      { key: "sparkId", type: "string", label: "Spark Signature" },
-    ];
-    const schema = generateDynamicSchema(fields);
-    const result = schema.safeParse({
-      ...baseFields,
-      sparkId: "SP-2187",
-    });
-    expect(result.success).toBe(true);
-  });
-
-  it("rejects a number for a string field", () => {
-    const fields: CustomFieldConfig[] = [
-      { key: "sparkId", type: "string", label: "Spark Signature" },
-    ];
-    const schema = generateDynamicSchema(fields);
-    const result = schema.safeParse({
-      ...baseFields,
-      sparkId: 42,
-    });
-    expect(result.success).toBe(false);
-  });
-
-  it("adds a number field", () => {
-    const fields: CustomFieldConfig[] = [
-      { key: "firepower", type: "number", label: "Firepower Rating" },
-    ];
-    const schema = generateDynamicSchema(fields);
-    const ok = schema.safeParse({
-      ...baseFields,
-      firepower: 9000,
-    });
-    expect(ok.success).toBe(true);
-
-    const fail = schema.safeParse({
-      ...baseFields,
-      firepower: "over 9000",
-    });
-    expect(fail.success).toBe(false);
-  });
-
-  it("adds a boolean field", () => {
-    const fields: CustomFieldConfig[] = [
-      { key: "isOnline", type: "boolean", label: "Online Status" },
-    ];
-    const schema = generateDynamicSchema(fields);
-    const ok = schema.safeParse({
-      ...baseFields,
-      isOnline: true,
-    });
-    expect(ok.success).toBe(true);
-
-    const fail = schema.safeParse({
-      ...baseFields,
-      isOnline: "yes",
-    });
-    expect(fail.success).toBe(false);
-  });
-
-  it("adds a date field (ISO datetime string)", () => {
-    const fields: CustomFieldConfig[] = [
-      { key: "activated", type: "date", label: "Activation Date" },
-    ];
-    const schema = generateDynamicSchema(fields);
-    const ok = schema.safeParse({
-      ...baseFields,
-      activated: "2024-01-15T08:00:00.000Z",
-    });
-    expect(ok.success).toBe(true);
-
-    const fail = schema.safeParse({
-      ...baseFields,
-      activated: "not-a-date",
-    });
-    expect(fail.success).toBe(false);
-  });
-
-  it("handles multiple custom fields of different types", () => {
-    const fields: CustomFieldConfig[] = [
-      { key: "sparkId", type: "string", label: "Spark Signature" },
-      { key: "firepower", type: "number", label: "Firepower Rating" },
-      { key: "isOnline", type: "boolean", label: "Online Status" },
-    ];
-    const schema = generateDynamicSchema(fields);
-    const result = schema.safeParse({
-      ...baseFields,
-      sparkId: "SP-2187",
-      firepower: 9000,
-      isOnline: true,
-    });
-    expect(result.success).toBe(true);
-  });
-
-  it("rejects missing custom fields", () => {
-    const fields: CustomFieldConfig[] = [
-      { key: "sparkId", type: "string", label: "Spark Signature" },
-    ];
-    const schema = generateDynamicSchema(fields);
-    const result = schema.safeParse(baseFields);
-    expect(result.success).toBe(false);
-  });
-
-  it("still enforces base schema requirements", () => {
-    const schema = generateDynamicSchema([]);
-    const result = schema.safeParse({ name: "Megatron" });
-    expect(result.success).toBe(false);
-  });
-});

package/src/__tests__/repository.test.ts

@@ -1,195 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { CAPRepository, type ICAPBaseDocument } from "../index.js";
-
-interface TestEntry extends ICAPBaseDocument {
-  sparkId: string;
-}
-
-class TestRepository extends CAPRepository<TestEntry> {
-  constructor(db: any) {
-    super(db, "test_entries");
-  }
-}
-
-function mockDb() {
-  const mockCollection = {
-    insertOne: vi.fn(),
-    findOne: vi.fn(),
-    find: vi.fn(() => ({
-      toArray: vi.fn(),
-    })),
-    findOneAndUpdate: vi.fn(),
-    deleteOne: vi.fn(),
-  };
-
-  const db = {
-    collection: vi.fn(() => mockCollection),
-  } as any;
-
-  return { db, collection: mockCollection };
-}
-
-describe("CAPRepository", () => {
-  let repo: TestRepository;
-  let collection: ReturnType<typeof mockDb>["collection"];
-
-  beforeEach(() => {
-    const { db, collection: c } = mockDb();
-    repo = new TestRepository(db);
-    collection = c;
-  });
-
-  describe("create", () => {
-    it("inserts a document with generated id and timestamps", async () => {
-      collection.insertOne.mockResolvedValue({ acknowledged: true });
-
-      const result = await repo.create({
-        name: "Optimus Prime",
-        description: "Leader of the Autobots",
-        continuityId: "g1",
-        factions: ["Autobots"],
-        sparkId: "SP-2187",
-      });
-
-      expect(result.id).toBeDefined();
-      expect(typeof result.id).toBe("string");
-      expect(result.createdAt).toBeInstanceOf(Date);
-      expect(result.updatedAt).toBeInstanceOf(Date);
-      expect(result.name).toBe("Optimus Prime");
-      expect(result.sparkId).toBe("SP-2187");
-
-      expect(collection.insertOne).toHaveBeenCalledOnce();
-      const inserted = collection.insertOne.mock.calls[0][0];
-      expect(inserted.id).toBe(result.id);
-      expect(inserted.createdAt).toBeInstanceOf(Date);
-      expect(inserted.updatedAt).toBeInstanceOf(Date);
-    });
-  });
-
-  describe("findById", () => {
-    it("returns a document by id", async () => {
-      const doc = {
-        _id: "abc",
-        id: "uuid-123",
-        name: "Bumblebee",
-        description: "Scout",
-        continuityId: "g1",
-        factions: ["Autobots"],
-        sparkId: "SP-0001",
-        createdAt: new Date(),
-        updatedAt: new Date(),
-      };
-      collection.findOne.mockResolvedValue(doc);
-
-      const result = await repo.findById("uuid-123");
-      expect(result).toEqual(doc);
-      expect(collection.findOne).toHaveBeenCalledWith({ id: "uuid-123" });
-    });
-
-    it("returns null when not found", async () => {
-      collection.findOne.mockResolvedValue(null);
-
-      const result = await repo.findById("nonexistent");
-      expect(result).toBeNull();
-    });
-  });
-
-  describe("findByName", () => {
-    it("returns a document by name (case-insensitive)", async () => {
-      const doc = {
-        _id: "abc",
-        id: "uuid-1",
-        name: "Megatron",
-        description: "Decepticon leader",
-        continuityId: "g1",
-        factions: ["Decepticons"],
-        createdAt: new Date(),
-        updatedAt: new Date(),
-      };
-      collection.findOne.mockResolvedValue(doc);
-
-      const result = await repo.findByName("megatron");
-      expect(result).toEqual(doc);
-    });
-
-    it("returns null when not found", async () => {
-      collection.findOne.mockResolvedValue(null);
-
-      const result = await repo.findByName("Starscream");
-      expect(result).toBeNull();
-    });
-  });
-
-  describe("listAll", () => {
-    it("returns all documents", async () => {
-      const docs = [
-        { id: "1", name: "A", description: "", continuityId: "g1", factions: [], createdAt: new Date(), updatedAt: new Date() },
-        { id: "2", name: "B", description: "", continuityId: "g1", factions: [], createdAt: new Date(), updatedAt: new Date() },
-      ];
-      collection.find.mockReturnValue({ toArray: vi.fn().mockResolvedValue(docs) });
-
-      const result = await repo.listAll();
-      expect(result).toEqual(docs);
-      expect(result).toHaveLength(2);
-    });
-  });
-
-  describe("update", () => {
-    it("updates fields and bumps updatedAt", async () => {
-      const original = {
-        id: "uuid-1",
-        name: "Optimus Prime",
-        description: "Old description",
-        continuityId: "g1",
-        factions: ["Autobots"],
-        createdAt: new Date("2020-01-01"),
-        updatedAt: new Date("2020-01-01"),
-      };
-
-      const updated = {
-        ...original,
-        description: "New description",
-        updatedAt: new Date(),
-      };
-
-      collection.findOneAndUpdate.mockResolvedValue(updated);
-
-      const result = await repo.update("uuid-1", {
-        description: "New description",
-      });
-
-      expect(result).toEqual(updated);
-      expect(collection.findOneAndUpdate).toHaveBeenCalled();
-
-      const [, updateDoc] = collection.findOneAndUpdate.mock.calls[0];
-      expect(updateDoc.$set.description).toBe("New description");
-      expect(updateDoc.$set.updatedAt).toBeInstanceOf(Date);
-    });
-
-    it("returns null when document does not exist", async () => {
-      collection.findOneAndUpdate.mockResolvedValue(null);
-
-      const result = await repo.update("nonexistent", {
-        description: "Nope",
-      });
-      expect(result).toBeNull();
-    });
-  });
-
-  describe("delete", () => {
-    it("returns true when a document is deleted", async () => {
-      collection.deleteOne.mockResolvedValue({ deletedCount: 1 });
-
-      const result = await repo.delete("uuid-1");
-      expect(result).toBe(true);
-      expect(collection.deleteOne).toHaveBeenCalledWith({ id: "uuid-1" });
-    });
-
-    it("returns false when no document matched", async () => {
-      collection.deleteOne.mockResolvedValue({ deletedCount: 0 });
-
-      const result = await repo.delete("nonexistent");
-      expect(result).toBe(false);
-    });
-  });
-});

package/src/__tests__/settings-loader.test.ts

@@ -1,90 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { mkdtempSync, writeFileSync, unlinkSync, rmdirSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { loadSettings } from "../index.js";
-
-function withTempFile(
-  name: string,
-  content: string,
-  fn: (path: string) => void,
-) {
-  const dir = mkdtempSync(join(tmpdir(), "cap-test-"));
-  const filePath = join(dir, name);
-  writeFileSync(filePath, content, "utf-8");
-  try {
-    fn(filePath);
-  } finally {
-    try {
-      unlinkSync(filePath);
-    } catch {}
-    try {
-      rmdirSync(dir);
-    } catch {}
-  }
-}
-
-const validSettings = JSON.stringify({
-  databaseName: "Nova Cronum",
-  entryFormat: {
-    requiredFields: ["name", "description", "continuityId", "factions"],
-    customFields: [
-      { key: "sparkId", type: "string", label: "Spark Signature" },
-      { key: "firepower", type: "number", label: "Firepower Rating" },
-    ],
-  },
-});
-
-describe("loadSettings", () => {
-  it("parses a valid settings file", () => {
-    withTempFile("settings.json", validSettings, (path) => {
-      const config = loadSettings(path);
-      expect(config.databaseName).toBe("Nova Cronum");
-      expect(config.entryFormat.customFields).toHaveLength(2);
-      expect(config.entryFormat.customFields![0].key).toBe("sparkId");
-    });
-  });
-
-  it("accepts settings without customFields", () => {
-    const minimal = JSON.stringify({
-      databaseName: "Test Universe",
-      entryFormat: {},
-    });
-    withTempFile("settings.json", minimal, (path) => {
-      const config = loadSettings(path);
-      expect(config.databaseName).toBe("Test Universe");
-      expect(config.entryFormat.customFields).toBeUndefined();
-    });
-  });
-
-  it("throws on missing file", () => {
-    expect(() => loadSettings("/nonexistent/path.json")).toThrow();
-  });
-
-  it("throws on invalid JSON", () => {
-    withTempFile("settings.json", "{bad json}", (path) => {
-      expect(() => loadSettings(path)).toThrow();
-    });
-  });
-
-  it("throws on invalid field type", () => {
-    const bad = JSON.stringify({
-      databaseName: "Test",
-      entryFormat: {
-        customFields: [{ key: "x", type: "binary", label: "X" }],
-      },
-    });
-    withTempFile("settings.json", bad, (path) => {
-      expect(() => loadSettings(path)).toThrow();
-    });
-  });
-
-  it("throws when databaseName is missing", () => {
-    const bad = JSON.stringify({
-      entryFormat: {},
-    });
-    withTempFile("settings.json", bad, (path) => {
-      expect(() => loadSettings(path)).toThrow();
-    });
-  });
-});

package/src/__tests__/smoke.test.ts

@@ -1,27 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { CAPBaseSchema, CAPRepository } from "../index.js";
-
-describe("CAPBaseSchema", () => {
-  it("validates a correct lore entry", () => {
-    const result = CAPBaseSchema.safeParse({
-      name: "Optimus Prime",
-      description: "Leader of the Autobots",
-      continuityId: "g1",
-      factions: ["Autobots"],
-    });
-    expect(result.success).toBe(true);
-  });
-
-  it("rejects an entry missing required fields", () => {
-    const result = CAPBaseSchema.safeParse({
-      name: "Megatron",
-    });
-    expect(result.success).toBe(false);
-  });
-});
-
-describe("CAPRepository", () => {
-  it("is an abstract class that cannot be instantiated directly", () => {
-    expect(CAPRepository).toBeDefined();
-  });
-});

package/src/index.ts

@@ -1,149 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { readFileSync } from "node:fs";
-import { z } from "zod";
-import { Collection, Db } from "mongodb";
-
-// Universal Document Rules
-export interface ICAPBaseDocument {
-  id: string;
-  name: string;
-  description: string;
-  continuityId: string;
-  factions: string[];
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-// Flexible variant template (Alt-modes, Multiverse variants, Eras)
-export interface ILoreVariant<T> {
-  variantName: string;
-  appearanceMediaId: string;
-  specifications: T;
-}
-
-// Runtime validation baseline
-export const CAPBaseSchema = z.object({
-  name: z.string().min(1),
-  description: z.string(),
-  continuityId: z.string(),
-  factions: z.array(z.string()),
-});
-
-// Standardized MongoDB Data Layer
-export abstract class CAPRepository<T extends ICAPBaseDocument> {
-  protected collection: Collection<T>;
-
-  constructor(db: Db, collectionName: string) {
-    this.collection = db.collection<T>(collectionName);
-  }
-
-  async create(
-    data: Omit<T, "id" | "createdAt" | "updatedAt">,
-  ): Promise<T & { id: string }> {
-    const doc = {
-      ...data,
-      id: randomUUID(),
-      createdAt: new Date(),
-      updatedAt: new Date(),
-    } as any;
-    await this.collection.insertOne(doc);
-    return doc as T & { id: string };
-  }
-
-  async findById(id: string): Promise<T | null> {
-    return this.collection.findOne({ id } as any) as Promise<T | null>;
-  }
-
-  async findByName(name: string): Promise<T | null> {
-    return this.collection.findOne({
-      name: { $regex: name, $options: "i" },
-    } as any) as Promise<T | null>;
-  }
-
-  async listAll(): Promise<T[]> {
-    return this.collection.find({}).toArray() as Promise<T[]>;
-  }
-
-  async update(
-    id: string,
-    data: Partial<Omit<T, "id" | "createdAt" | "updatedAt">>,
-  ): Promise<T | null> {
-    return this.collection.findOneAndUpdate(
-      { id } as any,
-      { $set: { ...data, updatedAt: new Date() } } as any,
-      { returnDocument: "after" },
-    ) as Promise<T | null>;
-  }
-
-  async delete(id: string): Promise<boolean> {
-    const result = await this.collection.deleteOne({ id } as any);
-    return result.deletedCount > 0;
-  }
-}
-
-// --- Dynamic Schema Generator ---
-
-export type FieldType = "string" | "number" | "boolean" | "date";
-
-export interface CustomFieldConfig {
-  key: string;
-  type: FieldType;
-  label: string;
-}
-
-export interface EntryFormatConfig {
-  requiredFields?: string[];
-  customFields?: CustomFieldConfig[];
-}
-
-export interface SettingsConfig {
-  databaseName: string;
-  entryFormat: EntryFormatConfig;
-}
-
-const CustomFieldSchema = z.object({
-  key: z.string().min(1),
-  type: z.enum(["string", "number", "boolean", "date"]),
-  label: z.string().min(1),
-});
-
-export const CAPSettingsSchema = z.object({
-  databaseName: z.string().min(1),
-  entryFormat: z.object({
-    requiredFields: z.array(z.string()).optional(),
-    customFields: z.array(CustomFieldSchema).optional(),
-  }),
-});
-
-function zodTypeForFieldType(fieldType: FieldType): z.ZodType {
-  switch (fieldType) {
-    case "string":
-      return z.string();
-    case "number":
-      return z.number();
-    case "boolean":
-      return z.boolean();
-    case "date":
-      return z.string().datetime();
-    default:
-      throw new Error(`Unknown field type: ${fieldType}`);
-  }
-}
-
-export function generateDynamicSchema(
-  customFields: CustomFieldConfig[],
-): z.ZodObject<z.ZodRawShape> {
-  const shape: Record<string, z.ZodType> = {};
-
-  for (const field of customFields) {
-    shape[field.key] = zodTypeForFieldType(field.type);
-  }
-
-  return CAPBaseSchema.extend(shape);
-}
-
-export function loadSettings(path: string): SettingsConfig {
-  const raw = readFileSync(path, "utf-8");
-  const parsed = JSON.parse(raw);
-  return CAPSettingsSchema.parse(parsed) as SettingsConfig;
-}

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "declaration": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-  },
-  "include": ["src/**/*"],
-}

package/vitest.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: "node",
-    include: ["src/**/*.test.ts"],
-  },
-});