@talkpilot/core-db 1.3.6 → 1.3.8

package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts

@@ -1,92 +1,92 @@
-import { createMuniIssue } from "../muniIssues.setters";
-import {
-  generateMuniIssueId,
-  getMuniIssueById,
-  getMuniIssueByJiraKey,
-} from "../muniIssues.getters";
-import { createMuniIssueInput } from "../../../test-utils/factories";
-
-describe("muniIssues setters", () => {
-  describe("createMuniIssue", () => {
-    it("should insert a well-formed document with createdAt and nested content/jira", async () => {
-      const input = createMuniIssueInput();
-      const id = generateMuniIssueId();
-
-      const insertedId = await createMuniIssue(input, id);
-
-      const saved = await getMuniIssueById(insertedId.toString());
-      expect(saved).toMatchObject({
-        callSid: input.callSid,
-        clientId: input.clientId,
-        cityName: input.cityName,
-        issueContent: input.issueContent,
-        jira: input.jira,
-      });
-      expect(saved?.createdAt).toBeInstanceOf(Date);
-    });
-
-    it("should default jira.syncStatus to created when not provided", async () => {
-      const id = generateMuniIssueId();
-
-      const insertedId = await createMuniIssue(
-        createMuniIssueInput({ jira: { key: "CP-9" } }),
-        id,
-      );
-
-      const saved = await getMuniIssueById(insertedId.toString());
-      expect(saved?.jira.syncStatus).toBe("created");
-    });
-
-    it("should store long issueDescription and desiredBehavior in full", async () => {
-      const issueDescription = "a".repeat(2000);
-      const desiredBehavior = "b".repeat(2000);
-      const id = generateMuniIssueId();
-
-      const insertedId = await createMuniIssue(
-        createMuniIssueInput({
-          issueContent: {
-            issuerName: "Dana",
-            issuerRole: "Agent",
-            issueDescription,
-            desiredBehavior,
-          },
-        }),
-        id,
-      );
-
-      const saved = await getMuniIssueById(insertedId.toString());
-      expect(saved?.issueContent.issueDescription).toHaveLength(2000);
-      expect(saved?.issueContent.desiredBehavior).toBe(desiredBehavior);
-    });
-
-    it("should persist the caller-supplied _id so the Jira ticket can link back", async () => {
-      const id = generateMuniIssueId();
-
-      const insertedId = await createMuniIssue(createMuniIssueInput(), id);
-
-      expect(insertedId.toString()).toBe(id.toString());
-      expect(await getMuniIssueById(id.toString())).not.toBeNull();
-    });
-  });
-
-  describe("getMuniIssueById", () => {
-    it("should return null for an unknown or malformed id instead of throwing", async () => {
-      expect(await getMuniIssueById(generateMuniIssueId().toString())).toBeNull();
-      expect(await getMuniIssueById("not-a-valid-id")).toBeNull();
-    });
-  });
-
-  describe("getMuniIssueByJiraKey", () => {
-    it("should find the issue with the given Jira key", async () => {
-      await createMuniIssue(
-        createMuniIssueInput({ jira: { key: "CP-555" } }),
-        generateMuniIssueId(),
-      );
-
-      const found = await getMuniIssueByJiraKey("CP-555");
-
-      expect(found?.jira.key).toBe("CP-555");
-      expect(await getMuniIssueByJiraKey("CP-nope")).toBeNull();
-    });
-  });
-});
+import { createMuniIssue } from "../muniIssues.setters";
+import {
+  generateMuniIssueId,
+  getMuniIssueById,
+  getMuniIssueByJiraKey,
+} from "../muniIssues.getters";
+import { createMuniIssueInput } from "../../../test-utils/factories";
+
+describe("muniIssues setters", () => {
+  describe("createMuniIssue", () => {
+    it("should insert a well-formed document with createdAt and nested content/jira", async () => {
+      const input = createMuniIssueInput();
+      const id = generateMuniIssueId();
+
+      const insertedId = await createMuniIssue(input, id);
+
+      const saved = await getMuniIssueById(insertedId.toString());
+      expect(saved).toMatchObject({
+        callSid: input.callSid,
+        clientId: input.clientId,
+        cityName: input.cityName,
+        issueContent: input.issueContent,
+        jira: input.jira,
+      });
+      expect(saved?.createdAt).toBeInstanceOf(Date);
+    });
+
+    it("should default jira.syncStatus to created when not provided", async () => {
+      const id = generateMuniIssueId();
+
+      const insertedId = await createMuniIssue(
+        createMuniIssueInput({ jira: { key: "CP-9" } }),
+        id,
+      );
+
+      const saved = await getMuniIssueById(insertedId.toString());
+      expect(saved?.jira.syncStatus).toBe("created");
+    });
+
+    it("should store long issueDescription and desiredBehavior in full", async () => {
+      const issueDescription = "a".repeat(2000);
+      const desiredBehavior = "b".repeat(2000);
+      const id = generateMuniIssueId();
+
+      const insertedId = await createMuniIssue(
+        createMuniIssueInput({
+          issueContent: {
+            issuerName: "Dana",
+            issuerRole: "Agent",
+            issueDescription,
+            desiredBehavior,
+          },
+        }),
+        id,
+      );
+
+      const saved = await getMuniIssueById(insertedId.toString());
+      expect(saved?.issueContent.issueDescription).toHaveLength(2000);
+      expect(saved?.issueContent.desiredBehavior).toBe(desiredBehavior);
+    });
+
+    it("should persist the caller-supplied _id so the Jira ticket can link back", async () => {
+      const id = generateMuniIssueId();
+
+      const insertedId = await createMuniIssue(createMuniIssueInput(), id);
+
+      expect(insertedId.toString()).toBe(id.toString());
+      expect(await getMuniIssueById(id.toString())).not.toBeNull();
+    });
+  });
+
+  describe("getMuniIssueById", () => {
+    it("should return null for an unknown or malformed id instead of throwing", async () => {
+      expect(await getMuniIssueById(generateMuniIssueId().toString())).toBeNull();
+      expect(await getMuniIssueById("not-a-valid-id")).toBeNull();
+    });
+  });
+
+  describe("getMuniIssueByJiraKey", () => {
+    it("should find the issue with the given Jira key", async () => {
+      await createMuniIssue(
+        createMuniIssueInput({ jira: { key: "CP-555" } }),
+        generateMuniIssueId(),
+      );
+
+      const found = await getMuniIssueByJiraKey("CP-555");
+
+      expect(found?.jira.key).toBe("CP-555");
+      expect(await getMuniIssueByJiraKey("CP-nope")).toBeNull();
+    });
+  });
+});

package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts

@@ -1,92 +1,92 @@
-import {
-  ensureMuniIssuesCollection,
-  ensureMuniIssuesCollectionOnce,
-} from "../muniIssues.setup";
-import {
-  generateMuniIssueId,
-  getMuniIssuesCollection,
-} from "../muniIssues.getters";
-import { createMuniIssue } from "../muniIssues.setters";
-import { getDb } from "../../index";
-import { MUNI_ISSUES_COLLECTION } from "../muniIssues.constants";
-import { createMuniIssueInput } from "../../../test-utils/factories";
-
-describe("muniIssues setup", () => {
-  describe("ensureMuniIssuesCollection", () => {
-    it("should create the collection with a validator and the declared indexes", async () => {
-      await ensureMuniIssuesCollection();
-
-      const [collection] = (await getDb()
-        .listCollections({ name: MUNI_ISSUES_COLLECTION })
-        .toArray()) as { options?: { validator?: unknown } }[];
-      expect(collection?.options?.validator).toHaveProperty("$jsonSchema");
-
-      const indexNames = (await getMuniIssuesCollection().indexes()).map(
-        (i) => i.name,
-      );
-      expect(indexNames).toEqual(
-        expect.arrayContaining([
-          "callSid_1",
-          "createdAt_-1",
-          "jira_key_unique",
-        ]),
-      );
-    });
-
-    it("should accept a valid document and reject ones that violate the schema", async () => {
-      await ensureMuniIssuesCollection();
-
-      await expect(
-        createMuniIssue(createMuniIssueInput(), generateMuniIssueId()),
-      ).resolves.toBeDefined();
-
-      // Missing required issueContent fields → DB validation rejects it.
-      await expect(
-        getMuniIssuesCollection().insertOne({
-          callSid: "CA-bad",
-          createdAt: new Date(),
-        } as never),
-      ).rejects.toThrow();
-
-      // jira.syncStatus outside the enum → DB validation rejects it.
-      await expect(
-        createMuniIssue(
-          createMuniIssueInput({
-            jira: { key: "CP-99", syncStatus: "weird" as never },
-          }),
-          generateMuniIssueId(),
-        ),
-      ).rejects.toThrow();
-    });
-
-    it("should enforce the unique jira.key index", async () => {
-      await ensureMuniIssuesCollection();
-      const input = createMuniIssueInput();
-      await createMuniIssue(input, generateMuniIssueId());
-
-      // Same jira.key on a second insert violates the unique index.
-      await expect(
-        createMuniIssue(input, generateMuniIssueId()),
-      ).rejects.toThrow();
-    });
-
-    it("should be idempotent when run twice", async () => {
-      await ensureMuniIssuesCollection();
-      await expect(ensureMuniIssuesCollection()).resolves.toBeUndefined();
-    });
-  });
-
-  describe("ensureMuniIssuesCollectionOnce", () => {
-    it("should run the provisioning work at most once per process", async () => {
-      const createSpy = jest.spyOn(getDb(), "createCollection");
-
-      await Promise.all([
-        ensureMuniIssuesCollectionOnce(),
-        ensureMuniIssuesCollectionOnce(),
-      ]);
-      await ensureMuniIssuesCollectionOnce();
-
-      expect(createSpy).toHaveBeenCalledTimes(1);
-    });
-  });
-});
+import {
+  ensureMuniIssuesCollection,
+  ensureMuniIssuesCollectionOnce,
+} from "../muniIssues.setup";
+import {
+  generateMuniIssueId,
+  getMuniIssuesCollection,
+} from "../muniIssues.getters";
+import { createMuniIssue } from "../muniIssues.setters";
+import { getDb } from "../../index";
+import { MUNI_ISSUES_COLLECTION } from "../muniIssues.constants";
+import { createMuniIssueInput } from "../../../test-utils/factories";
+
+describe("muniIssues setup", () => {
+  describe("ensureMuniIssuesCollection", () => {
+    it("should create the collection with a validator and the declared indexes", async () => {
+      await ensureMuniIssuesCollection();
+
+      const [collection] = (await getDb()
+        .listCollections({ name: MUNI_ISSUES_COLLECTION })
+        .toArray()) as { options?: { validator?: unknown } }[];
+      expect(collection?.options?.validator).toHaveProperty("$jsonSchema");
+
+      const indexNames = (await getMuniIssuesCollection().indexes()).map(
+        (i) => i.name,
+      );
+      expect(indexNames).toEqual(
+        expect.arrayContaining([
+          "callSid_1",
+          "createdAt_-1",
+          "jira_key_unique",
+        ]),
+      );
+    });
+
+    it("should accept a valid document and reject ones that violate the schema", async () => {
+      await ensureMuniIssuesCollection();
+
+      await expect(
+        createMuniIssue(createMuniIssueInput(), generateMuniIssueId()),
+      ).resolves.toBeDefined();
+
+      // Missing required issueContent fields → DB validation rejects it.
+      await expect(
+        getMuniIssuesCollection().insertOne({
+          callSid: "CA-bad",
+          createdAt: new Date(),
+        } as never),
+      ).rejects.toThrow();
+
+      // jira.syncStatus outside the enum → DB validation rejects it.
+      await expect(
+        createMuniIssue(
+          createMuniIssueInput({
+            jira: { key: "CP-99", syncStatus: "weird" as never },
+          }),
+          generateMuniIssueId(),
+        ),
+      ).rejects.toThrow();
+    });
+
+    it("should enforce the unique jira.key index", async () => {
+      await ensureMuniIssuesCollection();
+      const input = createMuniIssueInput();
+      await createMuniIssue(input, generateMuniIssueId());
+
+      // Same jira.key on a second insert violates the unique index.
+      await expect(
+        createMuniIssue(input, generateMuniIssueId()),
+      ).rejects.toThrow();
+    });
+
+    it("should be idempotent when run twice", async () => {
+      await ensureMuniIssuesCollection();
+      await expect(ensureMuniIssuesCollection()).resolves.toBeUndefined();
+    });
+  });
+
+  describe("ensureMuniIssuesCollectionOnce", () => {
+    it("should run the provisioning work at most once per process", async () => {
+      const createSpy = jest.spyOn(getDb(), "createCollection");
+
+      await Promise.all([
+        ensureMuniIssuesCollectionOnce(),
+        ensureMuniIssuesCollectionOnce(),
+      ]);
+      await ensureMuniIssuesCollectionOnce();
+
+      expect(createSpy).toHaveBeenCalledTimes(1);
+    });
+  });
+});

package/src/municipal/muniIssues/index.ts

@@ -1,17 +1,17 @@
-export * from "./muniIssues.getters";
-export * from "./muniIssues.setters";
-export * from "./muniIssues.setup";
-export {
-  MUNI_ISSUES_COLLECTION,
-  MUNI_ISSUE_SYNC_STATUSES,
-  MUNI_ISSUE_TEXT_MAX_LENGTH,
-  MUNI_ISSUE_NAME_MAX_LENGTH,
-} from "./muniIssues.constants";
-export { muniIssuesJsonSchema, muniIssuesIndexes } from "./muniIssues.schema";
-export type {
-  MuniIssue,
-  MuniIssueContent,
-  MuniIssueJira,
-  MuniIssueSyncStatus,
-  CreateMuniIssueInput,
-} from "./muniIssues.types";
+export * from "./muniIssues.getters";
+export * from "./muniIssues.setters";
+export * from "./muniIssues.setup";
+export {
+  MUNI_ISSUES_COLLECTION,
+  MUNI_ISSUE_SYNC_STATUSES,
+  MUNI_ISSUE_TEXT_MAX_LENGTH,
+  MUNI_ISSUE_NAME_MAX_LENGTH,
+} from "./muniIssues.constants";
+export { muniIssuesJsonSchema, muniIssuesIndexes } from "./muniIssues.schema";
+export type {
+  MuniIssue,
+  MuniIssueContent,
+  MuniIssueJira,
+  MuniIssueSyncStatus,
+  CreateMuniIssueInput,
+} from "./muniIssues.types";

package/src/municipal/muniIssues/muniIssues.constants.ts

@@ -1,18 +1,18 @@
-/** Mongo collection name for reported municipal issues. */
-export const MUNI_ISSUES_COLLECTION = "muniIssues";
-
-/** Sync state of the issue's Jira ticket at write time. */
-export const MUNI_ISSUE_SYNC_STATUSES = ["created", "failed"] as const;
-
-/** Max length for the long free-text fields — well above the ~2000-char target. */
-export const MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
-
-/** Max length for the short identity fields (a person's name and role). */
-export const MUNI_ISSUE_NAME_MAX_LENGTH = 200;
-
-/** MongoDB error 48 (NamespaceExists): collection already exists, e.g. concurrent createCollection. */
-export const NAMESPACE_EXISTS = 48;
-
-/** Reject (not just flag) writes that fail the $jsonSchema validator. */
-export const VALIDATION_LEVEL = "strict" as const;
-export const VALIDATION_ACTION = "error" as const;
+/** Mongo collection name for reported municipal issues. */
+export const MUNI_ISSUES_COLLECTION = "muniIssues";
+
+/** Sync state of the issue's Jira ticket at write time. */
+export const MUNI_ISSUE_SYNC_STATUSES = ["created", "failed"] as const;
+
+/** Max length for the long free-text fields — well above the ~2000-char target. */
+export const MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
+
+/** Max length for the short identity fields (a person's name and role). */
+export const MUNI_ISSUE_NAME_MAX_LENGTH = 200;
+
+/** MongoDB error 48 (NamespaceExists): collection already exists, e.g. concurrent createCollection. */
+export const NAMESPACE_EXISTS = 48;
+
+/** Reject (not just flag) writes that fail the $jsonSchema validator. */
+export const VALIDATION_LEVEL = "strict" as const;
+export const VALIDATION_ACTION = "error" as const;

package/src/municipal/muniIssues/muniIssues.getters.ts

@@ -1,24 +1,24 @@
-import { Collection, ObjectId } from "mongodb";
-import { getDb } from "../index";
-import { MuniIssue } from "./muniIssues.types";
-import { MUNI_ISSUES_COLLECTION } from "./muniIssues.constants";
-
-export const getMuniIssuesCollection = (): Collection<MuniIssue> => {
-  return getDb().collection<MuniIssue>(MUNI_ISSUES_COLLECTION);
-};
-
-export const generateMuniIssueId = (): ObjectId => new ObjectId();
-
-export const getMuniIssueById = async (
-  id: string,
-): Promise<MuniIssue | null> => {
-  // A malformed id is treated as not-found rather than throwing on `new ObjectId`.
-  if (!ObjectId.isValid(id)) return null;
-  return getMuniIssuesCollection().findOne({ _id: new ObjectId(id) });
-};
-
-export const getMuniIssueByJiraKey = async (
-  jiraKey: string,
-): Promise<MuniIssue | null> => {
-  return getMuniIssuesCollection().findOne({ "jira.key": jiraKey });
-};
+import { Collection, ObjectId } from "mongodb";
+import { getDb } from "../index";
+import { MuniIssue } from "./muniIssues.types";
+import { MUNI_ISSUES_COLLECTION } from "./muniIssues.constants";
+
+export const getMuniIssuesCollection = (): Collection<MuniIssue> => {
+  return getDb().collection<MuniIssue>(MUNI_ISSUES_COLLECTION);
+};
+
+export const generateMuniIssueId = (): ObjectId => new ObjectId();
+
+export const getMuniIssueById = async (
+  id: string,
+): Promise<MuniIssue | null> => {
+  // A malformed id is treated as not-found rather than throwing on `new ObjectId`.
+  if (!ObjectId.isValid(id)) return null;
+  return getMuniIssuesCollection().findOne({ _id: new ObjectId(id) });
+};
+
+export const getMuniIssueByJiraKey = async (
+  jiraKey: string,
+): Promise<MuniIssue | null> => {
+  return getMuniIssuesCollection().findOne({ "jira.key": jiraKey });
+};

package/src/municipal/muniIssues/muniIssues.schema.ts

@@ -1,66 +1,66 @@
-import type { Document, IndexDescription } from "mongodb";
-import {
-  MUNI_ISSUE_SYNC_STATUSES,
-  MUNI_ISSUE_TEXT_MAX_LENGTH,
-  MUNI_ISSUE_NAME_MAX_LENGTH,
-} from "./muniIssues.constants";
-
-export const muniIssuesJsonSchema: Document = {
-  bsonType: "object",
-  required: [
-    "callSid",
-    "clientId",
-    "cityName",
-    "issueContent",
-    "jira",
-    "createdAt",
-  ],
-  properties: {
-    callSid: { bsonType: "string" },
-    clientId: { bsonType: "string" },
-    cityName: { bsonType: "string" },
-    issueContent: {
-      bsonType: "object",
-      required: [
-        "issuerName",
-        "issuerRole",
-        "issueDescription",
-        "desiredBehavior",
-      ],
-      properties: {
-        issuerName: {
-          bsonType: "string",
-          maxLength: MUNI_ISSUE_NAME_MAX_LENGTH,
-        },
-        issuerRole: {
-          bsonType: "string",
-          maxLength: MUNI_ISSUE_NAME_MAX_LENGTH,
-        },
-        issueDescription: {
-          bsonType: "string",
-          maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH,
-        },
-        desiredBehavior: {
-          bsonType: "string",
-          maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH,
-        },
-      },
-    },
-    jira: {
-      bsonType: "object",
-      required: ["key", "syncStatus"],
-      properties: {
-        key: { bsonType: "string" },
-        syncStatus: { enum: [...MUNI_ISSUE_SYNC_STATUSES] },
-      },
-    },
-    createdAt: { bsonType: "date" },
-  },
-};
-
-export const muniIssuesIndexes: IndexDescription[] = [
-  { key: { callSid: 1 }, name: "callSid_1" },
-  { key: { createdAt: -1 }, name: "createdAt_-1" },
-  // Unique: one stored document per Jira ticket, guarding against duplicate writes.
-  { key: { "jira.key": 1 }, name: "jira_key_unique", unique: true },
-];
+import type { Document, IndexDescription } from "mongodb";
+import {
+  MUNI_ISSUE_SYNC_STATUSES,
+  MUNI_ISSUE_TEXT_MAX_LENGTH,
+  MUNI_ISSUE_NAME_MAX_LENGTH,
+} from "./muniIssues.constants";
+
+export const muniIssuesJsonSchema: Document = {
+  bsonType: "object",
+  required: [
+    "callSid",
+    "clientId",
+    "cityName",
+    "issueContent",
+    "jira",
+    "createdAt",
+  ],
+  properties: {
+    callSid: { bsonType: "string" },
+    clientId: { bsonType: "string" },
+    cityName: { bsonType: "string" },
+    issueContent: {
+      bsonType: "object",
+      required: [
+        "issuerName",
+        "issuerRole",
+        "issueDescription",
+        "desiredBehavior",
+      ],
+      properties: {
+        issuerName: {
+          bsonType: "string",
+          maxLength: MUNI_ISSUE_NAME_MAX_LENGTH,
+        },
+        issuerRole: {
+          bsonType: "string",
+          maxLength: MUNI_ISSUE_NAME_MAX_LENGTH,
+        },
+        issueDescription: {
+          bsonType: "string",
+          maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH,
+        },
+        desiredBehavior: {
+          bsonType: "string",
+          maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH,
+        },
+      },
+    },
+    jira: {
+      bsonType: "object",
+      required: ["key", "syncStatus"],
+      properties: {
+        key: { bsonType: "string" },
+        syncStatus: { enum: [...MUNI_ISSUE_SYNC_STATUSES] },
+      },
+    },
+    createdAt: { bsonType: "date" },
+  },
+};
+
+export const muniIssuesIndexes: IndexDescription[] = [
+  { key: { callSid: 1 }, name: "callSid_1" },
+  { key: { createdAt: -1 }, name: "createdAt_-1" },
+  // Unique: one stored document per Jira ticket, guarding against duplicate writes.
+  { key: { "jira.key": 1 }, name: "jira_key_unique", unique: true },
+];