@talkpilot/core-db 1.3.84 → 1.3.86

package/src/municipal/muniIssues/index.ts

@@ -1,24 +1,24 @@
-export * from "./muniIssues.getters";
-export * from "./muniIssues.setters";
-export * from "./muniIssues.setup";
-export * from "./muniIssues.utils";
-export {
-  MUNI_ISSUES_COLLECTION,
-  MUNI_ISSUE_MAX_RESPONSE_IMAGES,
-  MUNI_ISSUE_STATUSES,
-  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,
-  MuniIssueStatus,
-  MuniIssueResponse,
-  CreateMuniIssueInput,
-  SetMuniIssueResponseInput,
-  FindMuniIssuesOptions,
-} from "./muniIssues.types";
+export * from "./muniIssues.getters";
+export * from "./muniIssues.setters";
+export * from "./muniIssues.setup";
+export * from "./muniIssues.utils";
+export {
+  MUNI_ISSUES_COLLECTION,
+  MUNI_ISSUE_MAX_RESPONSE_IMAGES,
+  MUNI_ISSUE_STATUSES,
+  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,
+  MuniIssueStatus,
+  MuniIssueResponse,
+  CreateMuniIssueInput,
+  SetMuniIssueResponseInput,
+  FindMuniIssuesOptions,
+} from "./muniIssues.types";

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

@@ -1,27 +1,27 @@
-/** 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;
-
-export const MUNI_ISSUE_STATUSES = [
-  "in_review",
-  "in_progress",
-  "resolved",
-  "no_issue_found",
-] as const;
-
-export const MUNI_ISSUE_MAX_RESPONSE_IMAGES = 5;
-
-/** 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;
+
+export const MUNI_ISSUE_STATUSES = [
+  "in_review",
+  "in_progress",
+  "resolved",
+  "no_issue_found",
+] as const;
+
+export const MUNI_ISSUE_MAX_RESPONSE_IMAGES = 5;
+
+/** 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,73 +1,73 @@
-import { Collection, Filter, ObjectId } from "mongodb";
-import { getDb } from "../index";
-import { FindMuniIssuesOptions, 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 });
-};
-
-// Answered = the response has text or at least one image; a cleared response object stays in the document.
-const responseHasContent: Filter<MuniIssue>[] = [
-  { "response.text": { $nin: ["", null] } },
-  { "response.imageUrls.0": { $exists: true } },
-];
-
-// Tracked issues of one client. Issues without a status predate complaint tracking and are excluded.
-const clientIssuesFilter = (
-  clientId: string,
-  answered?: boolean,
-): Filter<MuniIssue> => ({
-  clientId,
-  status: { $exists: true },
-  ...(answered === true && { $or: responseHasContent }),
-  ...(answered === false && { $nor: responseHasContent }),
-});
-
-export const findMuniIssuesByClient = async (
-  clientId: string,
-  { answered, skip = 0, limit = 0 }: FindMuniIssuesOptions = {},
-): Promise<MuniIssue[]> => {
-  return getMuniIssuesCollection()
-    .find(clientIssuesFilter(clientId, answered))
-    .sort({ createdAt: -1 })
-    .skip(skip)
-    .limit(limit)
-    .toArray();
-};
-
-export const countMuniIssuesByClient = async (
-  clientId: string,
-  { answered }: Pick<FindMuniIssuesOptions, "answered"> = {},
-): Promise<number> => {
-  return getMuniIssuesCollection().countDocuments(
-    clientIssuesFilter(clientId, answered),
-  );
-};
-
-export const getMuniIssueByIdForClient = async (
-  id: string,
-  clientId: string,
-): Promise<MuniIssue | null> => {
-  if (!ObjectId.isValid(id)) return null;
-  return getMuniIssuesCollection().findOne({
-    ...clientIssuesFilter(clientId),
-    _id: new ObjectId(id),
-  });
-};
+import { Collection, Filter, ObjectId } from "mongodb";
+import { getDb } from "../index";
+import { FindMuniIssuesOptions, 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 });
+};
+
+// Answered = the response has text or at least one image; a cleared response object stays in the document.
+const responseHasContent: Filter<MuniIssue>[] = [
+  { "response.text": { $nin: ["", null] } },
+  { "response.imageUrls.0": { $exists: true } },
+];
+
+// Tracked issues of one client. Issues without a status predate complaint tracking and are excluded.
+const clientIssuesFilter = (
+  clientId: string,
+  answered?: boolean,
+): Filter<MuniIssue> => ({
+  clientId,
+  status: { $exists: true },
+  ...(answered === true && { $or: responseHasContent }),
+  ...(answered === false && { $nor: responseHasContent }),
+});
+
+export const findMuniIssuesByClient = async (
+  clientId: string,
+  { answered, skip = 0, limit = 0 }: FindMuniIssuesOptions = {},
+): Promise<MuniIssue[]> => {
+  return getMuniIssuesCollection()
+    .find(clientIssuesFilter(clientId, answered))
+    .sort({ createdAt: -1 })
+    .skip(skip)
+    .limit(limit)
+    .toArray();
+};
+
+export const countMuniIssuesByClient = async (
+  clientId: string,
+  { answered }: Pick<FindMuniIssuesOptions, "answered"> = {},
+): Promise<number> => {
+  return getMuniIssuesCollection().countDocuments(
+    clientIssuesFilter(clientId, answered),
+  );
+};
+
+export const getMuniIssueByIdForClient = async (
+  id: string,
+  clientId: string,
+): Promise<MuniIssue | null> => {
+  if (!ObjectId.isValid(id)) return null;
+  return getMuniIssuesCollection().findOne({
+    ...clientIssuesFilter(clientId),
+    _id: new ObjectId(id),
+  });
+};

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

@@ -1,85 +1,85 @@
-import type { Document, IndexDescription } from "mongodb";
-import {
-  MUNI_ISSUE_MAX_RESPONSE_IMAGES,
-  MUNI_ISSUE_STATUSES,
-  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" },
-    status: { enum: [...MUNI_ISSUE_STATUSES] },
-    response: {
-      bsonType: "object",
-      required: ["text", "createdAt"],
-      properties: {
-        text: { bsonType: "string", maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH },
-        imageUrls: {
-          bsonType: "array",
-          maxItems: MUNI_ISSUE_MAX_RESPONSE_IMAGES,
-          items: { bsonType: "string" },
-        },
-        createdAt: { bsonType: "date" },
-        updatedAt: { bsonType: "date" },
-      },
-    },
-    updatedAt: { bsonType: "date" },
-  },
-};
-
-export const muniIssuesIndexes: IndexDescription[] = [
-  { key: { callSid: 1 }, name: "callSid_1" },
-  { key: { createdAt: -1 }, name: "createdAt_-1" },
-  { key: { clientId: 1, createdAt: -1 }, name: "clientId_1_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_MAX_RESPONSE_IMAGES,
+  MUNI_ISSUE_STATUSES,
+  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" },
+    status: { enum: [...MUNI_ISSUE_STATUSES] },
+    response: {
+      bsonType: "object",
+      required: ["text", "createdAt"],
+      properties: {
+        text: { bsonType: "string", maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH },
+        imageUrls: {
+          bsonType: "array",
+          maxItems: MUNI_ISSUE_MAX_RESPONSE_IMAGES,
+          items: { bsonType: "string" },
+        },
+        createdAt: { bsonType: "date" },
+        updatedAt: { bsonType: "date" },
+      },
+    },
+    updatedAt: { bsonType: "date" },
+  },
+};
+
+export const muniIssuesIndexes: IndexDescription[] = [
+  { key: { callSid: 1 }, name: "callSid_1" },
+  { key: { createdAt: -1 }, name: "createdAt_-1" },
+  { key: { clientId: 1, createdAt: -1 }, name: "clientId_1_createdAt_-1" },
+  // Unique: one stored document per Jira ticket, guarding against duplicate writes.
+  { key: { "jira.key": 1 }, name: "jira_key_unique", unique: true },
+];

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

@@ -1,87 +1,87 @@
-import { Filter, ObjectId } from "mongodb";
-import {
-  CreateMuniIssueInput,
-  MuniIssue,
-  MuniIssueStatus,
-  SetMuniIssueResponseInput,
-} from "./muniIssues.types";
-import { getMuniIssuesCollection } from "./muniIssues.getters";
-import { ensureMuniIssuesCollectionOnce } from "./muniIssues.setup";
-
-// Required `id`: MIS pre-generates it (generateMuniIssueId) and embeds it in the Jira ticket — the two-way link.
-export const createMuniIssue = async (
-  issueData: CreateMuniIssueInput,
-  id: ObjectId,
-): Promise<ObjectId> => {
-  await ensureMuniIssuesCollectionOnce();
-
-  const now = new Date();
-  const issue: MuniIssue = {
-    _id: id,
-    ...issueData,
-    jira: {
-      ...issueData.jira,
-      syncStatus: issueData.jira.syncStatus ?? "created",
-    },
-    status: "in_review",
-    createdAt: now,
-    updatedAt: now,
-  };
-  const { insertedId } = await getMuniIssuesCollection().insertOne(issue);
-  return insertedId;
-};
-
-// An issue of this client that is tracked (has a status); answered issues stay editable.
-const trackedIssueFilter = (id: string, clientId: string): Filter<MuniIssue> => ({
-  _id: new ObjectId(id),
-  clientId,
-  status: { $exists: true },
-});
-
-export const updateMuniIssueStatus = async (
-  id: string,
-  clientId: string,
-  status: MuniIssueStatus,
-): Promise<boolean> => {
-  if (!ObjectId.isValid(id)) return false;
-  await ensureMuniIssuesCollectionOnce();
-
-  const { matchedCount } = await getMuniIssuesCollection().updateOne(
-    trackedIssueFilter(id, clientId),
-    { $set: { status, updatedAt: new Date() } },
-  );
-  return matchedCount > 0;
-};
-
-export const setMuniIssueResponse = async (
-  id: string,
-  clientId: string,
-  { status, text, imageUrls }: SetMuniIssueResponseInput,
-): Promise<boolean> => {
-  if (!ObjectId.isValid(id)) return false;
-  await ensureMuniIssuesCollectionOnce();
-
-  const now = new Date();
-  // Pipeline update, so the first-sent date can be read from the stored response.
-  // $literal: user text starting with "$" must not be read as a field path.
-  const { matchedCount } = await getMuniIssuesCollection().updateOne(
-    trackedIssueFilter(id, clientId),
-    [
-      {
-        $set: {
-          status: { $literal: status },
-          updatedAt: now,
-          response: {
-            text: { $literal: text },
-            imageUrls: { $literal: imageUrls ?? [] },
-            createdAt: { $ifNull: ["$response.createdAt", now] },
-            updatedAt: {
-              $cond: [{ $ifNull: ["$response.createdAt", false] }, now, "$$REMOVE"],
-            },
-          },
-        },
-      },
-    ],
-  );
-  return matchedCount > 0;
-};
+import { Filter, ObjectId } from "mongodb";
+import {
+  CreateMuniIssueInput,
+  MuniIssue,
+  MuniIssueStatus,
+  SetMuniIssueResponseInput,
+} from "./muniIssues.types";
+import { getMuniIssuesCollection } from "./muniIssues.getters";
+import { ensureMuniIssuesCollectionOnce } from "./muniIssues.setup";
+
+// Required `id`: MIS pre-generates it (generateMuniIssueId) and embeds it in the Jira ticket — the two-way link.
+export const createMuniIssue = async (
+  issueData: CreateMuniIssueInput,
+  id: ObjectId,
+): Promise<ObjectId> => {
+  await ensureMuniIssuesCollectionOnce();
+
+  const now = new Date();
+  const issue: MuniIssue = {
+    _id: id,
+    ...issueData,
+    jira: {
+      ...issueData.jira,
+      syncStatus: issueData.jira.syncStatus ?? "created",
+    },
+    status: "in_review",
+    createdAt: now,
+    updatedAt: now,
+  };
+  const { insertedId } = await getMuniIssuesCollection().insertOne(issue);
+  return insertedId;
+};
+
+// An issue of this client that is tracked (has a status); answered issues stay editable.
+const trackedIssueFilter = (id: string, clientId: string): Filter<MuniIssue> => ({
+  _id: new ObjectId(id),
+  clientId,
+  status: { $exists: true },
+});
+
+export const updateMuniIssueStatus = async (
+  id: string,
+  clientId: string,
+  status: MuniIssueStatus,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    trackedIssueFilter(id, clientId),
+    { $set: { status, updatedAt: new Date() } },
+  );
+  return matchedCount > 0;
+};
+
+export const setMuniIssueResponse = async (
+  id: string,
+  clientId: string,
+  { status, text, imageUrls }: SetMuniIssueResponseInput,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const now = new Date();
+  // Pipeline update, so the first-sent date can be read from the stored response.
+  // $literal: user text starting with "$" must not be read as a field path.
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    trackedIssueFilter(id, clientId),
+    [
+      {
+        $set: {
+          status: { $literal: status },
+          updatedAt: now,
+          response: {
+            text: { $literal: text },
+            imageUrls: { $literal: imageUrls ?? [] },
+            createdAt: { $ifNull: ["$response.createdAt", now] },
+            updatedAt: {
+              $cond: [{ $ifNull: ["$response.createdAt", false] }, now, "$$REMOVE"],
+            },
+          },
+        },
+      },
+    ],
+  );
+  return matchedCount > 0;
+};