@talkpilot/core-db 1.3.85 → 1.3.87

package/README.md

@@ -186,6 +186,9 @@ Refer to `DEVELOPMENT.md` for the full walkthrough, token instructions, and fact
 | 1.3.69  | Municipal `residents` collection: optional resident fields (`cityName`, `firstName`, `lastName`, `idNumber`, `phoneNumber`, `address`) with exact-match getters by phone, by idNumber, and by phone+idNumber (city-scoped). Schema + indexes exported; collection is created out of band. |
 | 1.3.71  | Who ended a call (CP-1873): optional `Call.endedBy` (`system` / `agent` / `user`), `CallEndedByValues`, and `setCallEndedBy` (first write wins). **Breaking** vs 1.3.69–1.3.70: the value `resident` was replaced by `user`. |
 | 1.3.74  | Added `human` to `CallEndedByValues` (CP-1873): a human agent ended the call, after a transfer or in a conference. |
+| 1.3.82  | Complaint tracking on `muniIssues` (CP-1888): optional `status` / `response` / `updatedAt`; an editable TalkPilot response with up to `MUNI_ISSUE_MAX_RESPONSE_IMAGES` (5) `response.imageUrls` and `response.updatedAt`; `updateMuniIssueStatus`, `setMuniIssueResponse`, `findMuniIssuesByClient`, `countMuniIssuesByClient`, `getMuniIssueByIdForClient`; index `clientId_1_createdAt_-1`. |
+| 1.3.85  | Single-note writes on `contextNotes` (CP-1998): append, update, or remove one entry without replacing the rest of the list. |
+
 
 ### 1.1.9
 
@@ -834,6 +837,23 @@ New `CallEndedByValues.Human` (`"human"`): a human agent ended the call, either
 
 No — purely additive. **TalkPilot Server** should upgrade to **1.3.74** to write it.
 
+### 1.3.85 — Single context-note writes (CP-1998)
+
+Append, update, or remove one note on a client/product document without replacing the rest of the `notes` array. `appendContextNoteEntry` creates the document when none exists yet. `setContextNoteEntries` still replaces the whole list.
+
+**Added**
+
+| Export | Purpose |
+| --- | --- |
+| `ContextNoteEntryWrite` | Fields the caller sets: `title`, `content`, `activeFrom`, `expiresAt`. The getter assigns `_id`, `createdAt`, and `updatedAt`. |
+| `appendContextNoteEntry(clientId, product, entry, now?)` | Pushes one note and upserts the document. Returns the stored entry. |
+| `updateContextNoteEntryFields(clientId, product, noteId, entry, now?)` | Replaces one note's writable fields and `updatedAt`. Leaves `createdAt` and the other notes alone. Returns `null` when the note is missing. |
+| `pullContextNoteEntry(clientId, product, noteId)` | Removes one note by id. Returns `false` when nothing changed. |
+
+**Do I need to update my app?**
+
+No — purely additive. Use these instead of `setContextNoteEntries` when only one note changes.
+
 ## 🛠 CI/CD & deployment
 
 - This package is consumed by Cloud Build-based services (TalkPilot Server, MIS, CIS) as a dependency when Docker images are built. Keep `dist/` in sync with your builds because the compiled artifact is what downstream services install.

package/dist/municipal/muniIssues/index.d.ts

@@ -1,7 +1,8 @@
 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 * 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, CreateMuniIssueInput, } from "./muniIssues.types";
+export type { MuniIssue, MuniIssueContent, MuniIssueJira, MuniIssueSyncStatus, MuniIssueStatus, MuniIssueResponse, CreateMuniIssueInput, SetMuniIssueResponseInput, FindMuniIssuesOptions, } from "./muniIssues.types";
 //# sourceMappingURL=index.d.ts.map

package/dist/municipal/muniIssues/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/municipal/muniIssues/index.js

@@ -14,12 +14,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.muniIssuesIndexes = exports.muniIssuesJsonSchema = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUES_COLLECTION = void 0;
+exports.muniIssuesIndexes = exports.muniIssuesJsonSchema = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUE_STATUSES = exports.MUNI_ISSUE_MAX_RESPONSE_IMAGES = exports.MUNI_ISSUES_COLLECTION = void 0;
 __exportStar(require("./muniIssues.getters"), exports);
 __exportStar(require("./muniIssues.setters"), exports);
 __exportStar(require("./muniIssues.setup"), exports);
+__exportStar(require("./muniIssues.utils"), exports);
 var muniIssues_constants_1 = require("./muniIssues.constants");
 Object.defineProperty(exports, "MUNI_ISSUES_COLLECTION", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUES_COLLECTION; } });
+Object.defineProperty(exports, "MUNI_ISSUE_MAX_RESPONSE_IMAGES", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_MAX_RESPONSE_IMAGES; } });
+Object.defineProperty(exports, "MUNI_ISSUE_STATUSES", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_STATUSES; } });
 Object.defineProperty(exports, "MUNI_ISSUE_SYNC_STATUSES", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_SYNC_STATUSES; } });
 Object.defineProperty(exports, "MUNI_ISSUE_TEXT_MAX_LENGTH", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_TEXT_MAX_LENGTH; } });
 Object.defineProperty(exports, "MUNI_ISSUE_NAME_MAX_LENGTH", { enumerable: true, get: function () { return muniIssues_constants_1.MUNI_ISSUE_NAME_MAX_LENGTH; } });

package/dist/municipal/muniIssues/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,qDAAmC;AACnC,+DAKgC;AAJ9B,8HAAA,sBAAsB,OAAA;AACtB,gIAAA,wBAAwB,OAAA;AACxB,kIAAA,0BAA0B,OAAA;AAC1B,kIAAA,0BAA0B,OAAA;AAE5B,yDAA8E;AAArE,yHAAA,oBAAoB,OAAA;AAAE,sHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,qDAAmC;AACnC,qDAAmC;AACnC,+DAOgC;AAN9B,8HAAA,sBAAsB,OAAA;AACtB,sIAAA,8BAA8B,OAAA;AAC9B,2HAAA,mBAAmB,OAAA;AACnB,gIAAA,wBAAwB,OAAA;AACxB,kIAAA,0BAA0B,OAAA;AAC1B,kIAAA,0BAA0B,OAAA;AAE5B,yDAA8E;AAArE,yHAAA,oBAAoB,OAAA;AAAE,sHAAA,iBAAiB,OAAA"}

package/dist/municipal/muniIssues/muniIssues.constants.d.ts

@@ -2,6 +2,8 @@
 export declare const MUNI_ISSUES_COLLECTION = "muniIssues";
 /** Sync state of the issue's Jira ticket at write time. */
 export declare const MUNI_ISSUE_SYNC_STATUSES: readonly ["created", "failed"];
+export declare const MUNI_ISSUE_STATUSES: readonly ["in_review", "in_progress", "resolved", "no_issue_found"];
+export declare const MUNI_ISSUE_MAX_RESPONSE_IMAGES = 5;
 /** Max length for the long free-text fields — well above the ~2000-char target. */
 export declare const MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
 /** Max length for the short identity fields (a person's name and role). */

package/dist/municipal/muniIssues/muniIssues.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.constants.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,gCAAiC,CAAC;AAEvE,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAClD,eAAO,MAAM,iBAAiB,EAAG,OAAgB,CAAC"}
+{"version":3,"file":"muniIssues.constants.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,gCAAiC,CAAC;AAEvE,eAAO,MAAM,mBAAmB,qEAKtB,CAAC;AAEX,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAClD,eAAO,MAAM,iBAAiB,EAAG,OAAgB,CAAC"}

package/dist/municipal/muniIssues/muniIssues.constants.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VALIDATION_ACTION = exports.VALIDATION_LEVEL = exports.NAMESPACE_EXISTS = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUES_COLLECTION = void 0;
+exports.VALIDATION_ACTION = exports.VALIDATION_LEVEL = exports.NAMESPACE_EXISTS = exports.MUNI_ISSUE_NAME_MAX_LENGTH = exports.MUNI_ISSUE_TEXT_MAX_LENGTH = exports.MUNI_ISSUE_MAX_RESPONSE_IMAGES = exports.MUNI_ISSUE_STATUSES = exports.MUNI_ISSUE_SYNC_STATUSES = exports.MUNI_ISSUES_COLLECTION = void 0;
 /** Mongo collection name for reported municipal issues. */
 exports.MUNI_ISSUES_COLLECTION = "muniIssues";
 /** Sync state of the issue's Jira ticket at write time. */
 exports.MUNI_ISSUE_SYNC_STATUSES = ["created", "failed"];
+exports.MUNI_ISSUE_STATUSES = [
+    "in_review",
+    "in_progress",
+    "resolved",
+    "no_issue_found",
+];
+exports.MUNI_ISSUE_MAX_RESPONSE_IMAGES = 5;
 /** Max length for the long free-text fields — well above the ~2000-char target. */
 exports.MUNI_ISSUE_TEXT_MAX_LENGTH = 5000;
 /** Max length for the short identity fields (a person's name and role). */

package/dist/municipal/muniIssues/muniIssues.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.constants.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":";;;AAAA,2DAA2D;AAC9C,QAAA,sBAAsB,GAAG,YAAY,CAAC;AAEnD,2DAA2D;AAC9C,QAAA,wBAAwB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEvE,mFAAmF;AACtE,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAE/C,2EAA2E;AAC9D,QAAA,0BAA0B,GAAG,GAAG,CAAC;AAE9C,uGAAuG;AAC1F,QAAA,gBAAgB,GAAG,EAAE,CAAC;AAEnC,yEAAyE;AAC5D,QAAA,gBAAgB,GAAG,QAAiB,CAAC;AACrC,QAAA,iBAAiB,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"muniIssues.constants.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.constants.ts"],"names":[],"mappings":";;;AAAA,2DAA2D;AAC9C,QAAA,sBAAsB,GAAG,YAAY,CAAC;AAEnD,2DAA2D;AAC9C,QAAA,wBAAwB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAE1D,QAAA,mBAAmB,GAAG;IACjC,WAAW;IACX,aAAa;IACb,UAAU;IACV,gBAAgB;CACR,CAAC;AAEE,QAAA,8BAA8B,GAAG,CAAC,CAAC;AAEhD,mFAAmF;AACtE,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAE/C,2EAA2E;AAC9D,QAAA,0BAA0B,GAAG,GAAG,CAAC;AAE9C,uGAAuG;AAC1F,QAAA,gBAAgB,GAAG,EAAE,CAAC;AAEnC,yEAAyE;AAC5D,QAAA,gBAAgB,GAAG,QAAiB,CAAC;AACrC,QAAA,iBAAiB,GAAG,OAAgB,CAAC"}

package/dist/municipal/muniIssues/muniIssues.getters.d.ts

@@ -1,7 +1,10 @@
 import { Collection, ObjectId } from "mongodb";
-import { MuniIssue } from "./muniIssues.types";
+import { FindMuniIssuesOptions, MuniIssue } from "./muniIssues.types";
 export declare const getMuniIssuesCollection: () => Collection<MuniIssue>;
 export declare const generateMuniIssueId: () => ObjectId;
 export declare const getMuniIssueById: (id: string) => Promise<MuniIssue | null>;
 export declare const getMuniIssueByJiraKey: (jiraKey: string) => Promise<MuniIssue | null>;
+export declare const findMuniIssuesByClient: (clientId: string, { answered, skip, limit }?: FindMuniIssuesOptions) => Promise<MuniIssue[]>;
+export declare const countMuniIssuesByClient: (clientId: string, { answered }?: Pick<FindMuniIssuesOptions, "answered">) => Promise<number>;
+export declare const getMuniIssueByIdForClient: (id: string, clientId: string) => Promise<MuniIssue | null>;
 //# sourceMappingURL=muniIssues.getters.d.ts.map

package/dist/municipal/muniIssues/muniIssues.getters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,eAAO,MAAM,uBAAuB,QAAO,UAAU,CAAC,SAAS,CAE9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,QAA0B,CAAC;AAElE,eAAO,MAAM,gBAAgB,GAC3B,IAAI,MAAM,KACT,OAAO,CAAC,SAAS,GAAG,IAAI,CAI1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,KACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAE1B,CAAC"}
+{"version":3,"file":"muniIssues.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAU,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGtE,eAAO,MAAM,uBAAuB,QAAO,UAAU,CAAC,SAAS,CAE9D,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,QAA0B,CAAC;AAElE,eAAO,MAAM,gBAAgB,GAC3B,IAAI,MAAM,KACT,OAAO,CAAC,SAAS,GAAG,IAAI,CAI1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,KACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAE1B,CAAC;AAmBF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,4BAAmC,qBAA0B,KAC5D,OAAO,CAAC,SAAS,EAAE,CAOrB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,eAAc,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAM,KACzD,OAAO,CAAC,MAAM,CAIhB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,IAAI,MAAM,EACV,UAAU,MAAM,KACf,OAAO,CAAC,SAAS,GAAG,IAAI,CAM1B,CAAC"}

package/dist/municipal/muniIssues/muniIssues.getters.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMuniIssueByJiraKey = exports.getMuniIssueById = exports.generateMuniIssueId = exports.getMuniIssuesCollection = void 0;
+exports.getMuniIssueByIdForClient = exports.countMuniIssuesByClient = exports.findMuniIssuesByClient = exports.getMuniIssueByJiraKey = exports.getMuniIssueById = exports.generateMuniIssueId = exports.getMuniIssuesCollection = void 0;
 const mongodb_1 = require("mongodb");
 const index_1 = require("../index");
 const muniIssues_constants_1 = require("./muniIssues.constants");
@@ -21,4 +21,38 @@ const getMuniIssueByJiraKey = async (jiraKey) => {
     return (0, exports.getMuniIssuesCollection)().findOne({ "jira.key": jiraKey });
 };
 exports.getMuniIssueByJiraKey = getMuniIssueByJiraKey;
+// Answered = the response has text or at least one image; a cleared response object stays in the document.
+const responseHasContent = [
+    { "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, answered) => ({
+    clientId,
+    status: { $exists: true },
+    ...(answered === true && { $or: responseHasContent }),
+    ...(answered === false && { $nor: responseHasContent }),
+});
+const findMuniIssuesByClient = async (clientId, { answered, skip = 0, limit = 0 } = {}) => {
+    return (0, exports.getMuniIssuesCollection)()
+        .find(clientIssuesFilter(clientId, answered))
+        .sort({ createdAt: -1 })
+        .skip(skip)
+        .limit(limit)
+        .toArray();
+};
+exports.findMuniIssuesByClient = findMuniIssuesByClient;
+const countMuniIssuesByClient = async (clientId, { answered } = {}) => {
+    return (0, exports.getMuniIssuesCollection)().countDocuments(clientIssuesFilter(clientId, answered));
+};
+exports.countMuniIssuesByClient = countMuniIssuesByClient;
+const getMuniIssueByIdForClient = async (id, clientId) => {
+    if (!mongodb_1.ObjectId.isValid(id))
+        return null;
+    return (0, exports.getMuniIssuesCollection)().findOne({
+        ...clientIssuesFilter(clientId),
+        _id: new mongodb_1.ObjectId(id),
+    });
+};
+exports.getMuniIssueByIdForClient = getMuniIssueByIdForClient;
 //# sourceMappingURL=muniIssues.getters.js.map

package/dist/municipal/muniIssues/muniIssues.getters.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.getters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":";;;AAAA,qCAA+C;AAC/C,oCAAiC;AAEjC,iEAAgE;AAEzD,MAAM,uBAAuB,GAAG,GAA0B,EAAE;IACjE,OAAO,IAAA,aAAK,GAAE,CAAC,UAAU,CAAY,6CAAsB,CAAC,CAAC;AAC/D,CAAC,CAAC;AAFW,QAAA,uBAAuB,2BAElC;AAEK,MAAM,mBAAmB,GAAG,GAAa,EAAE,CAAC,IAAI,kBAAQ,EAAE,CAAC;AAArD,QAAA,mBAAmB,uBAAkC;AAE3D,MAAM,gBAAgB,GAAG,KAAK,EACnC,EAAU,EACiB,EAAE;IAC7B,iFAAiF;IACjF,IAAI,CAAC,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAA,+BAAuB,GAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,kBAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B;AAEK,MAAM,qBAAqB,GAAG,KAAK,EACxC,OAAe,EACY,EAAE;IAC7B,OAAO,IAAA,+BAAuB,GAAE,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAJW,QAAA,qBAAqB,yBAIhC"}
+{"version":3,"file":"muniIssues.getters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.getters.ts"],"names":[],"mappings":"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"}

package/dist/municipal/muniIssues/muniIssues.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.schema.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAO1D,eAAO,MAAM,oBAAoB,EAAE,QAmDlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAK/C,CAAC"}
+{"version":3,"file":"muniIssues.schema.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAS1D,eAAO,MAAM,oBAAoB,EAAE,QAmElC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAM/C,CAAC"}

package/dist/municipal/muniIssues/muniIssues.schema.js

@@ -52,11 +52,28 @@ exports.muniIssuesJsonSchema = {
             },
         },
         createdAt: { bsonType: "date" },
+        status: { enum: [...muniIssues_constants_1.MUNI_ISSUE_STATUSES] },
+        response: {
+            bsonType: "object",
+            required: ["text", "createdAt"],
+            properties: {
+                text: { bsonType: "string", maxLength: muniIssues_constants_1.MUNI_ISSUE_TEXT_MAX_LENGTH },
+                imageUrls: {
+                    bsonType: "array",
+                    maxItems: muniIssues_constants_1.MUNI_ISSUE_MAX_RESPONSE_IMAGES,
+                    items: { bsonType: "string" },
+                },
+                createdAt: { bsonType: "date" },
+                updatedAt: { bsonType: "date" },
+            },
+        },
+        updatedAt: { bsonType: "date" },
     },
 };
 exports.muniIssuesIndexes = [
     { 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/dist/municipal/muniIssues/muniIssues.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.schema.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":";;;AACA,iEAIgC;AAEnB,QAAA,oBAAoB,GAAa;IAC5C,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE;QACR,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;QACd,MAAM;QACN,WAAW;KACZ;IACD,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC/B,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,YAAY,EAAE;YACZ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE;gBACR,YAAY;gBACZ,YAAY;gBACZ,kBAAkB;gBAClB,iBAAiB;aAClB;YACD,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,gBAAgB,EAAE;oBAChB,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,eAAe,EAAE;oBACf,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;aACF;SACF;QACD,IAAI,EAAE;YACJ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;YAC/B,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,+CAAwB,CAAC,EAAE;aACpD;SACF;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;KAChC;CACF,CAAC;AAEW,QAAA,iBAAiB,GAAuB;IACnD,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;IAC1C,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;IAChD,kFAAkF;IAClF,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE;CAClE,CAAC"}
+{"version":3,"file":"muniIssues.schema.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.schema.ts"],"names":[],"mappings":";;;AACA,iEAMgC;AAEnB,QAAA,oBAAoB,GAAa;IAC5C,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE;QACR,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;QACd,MAAM;QACN,WAAW;KACZ;IACD,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC/B,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAChC,YAAY,EAAE;YACZ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE;gBACR,YAAY;gBACZ,YAAY;gBACZ,kBAAkB;gBAClB,iBAAiB;aAClB;YACD,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,UAAU,EAAE;oBACV,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,gBAAgB,EAAE;oBAChB,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;gBACD,eAAe,EAAE;oBACf,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,iDAA0B;iBACtC;aACF;SACF;QACD,IAAI,EAAE;YACJ,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;YAC/B,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,+CAAwB,CAAC,EAAE;aACpD;SACF;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;QAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,0CAAmB,CAAC,EAAE;QAC1C,QAAQ,EAAE;YACR,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;YAC/B,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,iDAA0B,EAAE;gBACnE,SAAS,EAAE;oBACT,QAAQ,EAAE,OAAO;oBACjB,QAAQ,EAAE,qDAA8B;oBACxC,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;iBAC9B;gBACD,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;gBAC/B,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;aAChC;SACF;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;KAChC;CACF,CAAC;AAEW,QAAA,iBAAiB,GAAuB;IACnD,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;IAC1C,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;IAChD,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACxE,kFAAkF;IAClF,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE;CAClE,CAAC"}

package/dist/municipal/muniIssues/muniIssues.setters.d.ts

@@ -1,4 +1,6 @@
 import { ObjectId } from "mongodb";
-import { CreateMuniIssueInput } from "./muniIssues.types";
+import { CreateMuniIssueInput, MuniIssueStatus, SetMuniIssueResponseInput } from "./muniIssues.types";
 export declare const createMuniIssue: (issueData: CreateMuniIssueInput, id: ObjectId) => Promise<ObjectId>;
+export declare const updateMuniIssueStatus: (id: string, clientId: string, status: MuniIssueStatus) => Promise<boolean>;
+export declare const setMuniIssueResponse: (id: string, clientId: string, { status, text, imageUrls }: SetMuniIssueResponseInput) => Promise<boolean>;
 //# sourceMappingURL=muniIssues.setters.d.ts.map

package/dist/municipal/muniIssues/muniIssues.setters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.setters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAa,MAAM,oBAAoB,CAAC;AAKrE,eAAO,MAAM,eAAe,GAC1B,WAAW,oBAAoB,EAC/B,IAAI,QAAQ,KACX,OAAO,CAAC,QAAQ,CAclB,CAAC"}
+{"version":3,"file":"muniIssues.setters.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EACL,oBAAoB,EAEpB,eAAe,EACf,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAK5B,eAAO,MAAM,eAAe,GAC1B,WAAW,oBAAoB,EAC/B,IAAI,QAAQ,KACX,OAAO,CAAC,QAAQ,CAiBlB,CAAC;AASF,eAAO,MAAM,qBAAqB,GAChC,IAAI,MAAM,EACV,UAAU,MAAM,EAChB,QAAQ,eAAe,KACtB,OAAO,CAAC,OAAO,CASjB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,IAAI,MAAM,EACV,UAAU,MAAM,EAChB,6BAA6B,yBAAyB,KACrD,OAAO,CAAC,OAAO,CA2BjB,CAAC"}

package/dist/municipal/muniIssues/muniIssues.setters.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMuniIssue = void 0;
+exports.setMuniIssueResponse = exports.updateMuniIssueStatus = exports.createMuniIssue = void 0;
+const mongodb_1 = require("mongodb");
 const muniIssues_getters_1 = require("./muniIssues.getters");
 const muniIssues_setup_1 = require("./muniIssues.setup");
 // Required `id`: MIS pre-generates it (generateMuniIssueId) and embeds it in the Jira ticket — the two-way link.
 const createMuniIssue = async (issueData, id) => {
     await (0, muniIssues_setup_1.ensureMuniIssuesCollectionOnce)();
+    const now = new Date();
     const issue = {
         _id: id,
         ...issueData,
@@ -13,10 +15,52 @@ const createMuniIssue = async (issueData, id) => {
             ...issueData.jira,
             syncStatus: issueData.jira.syncStatus ?? "created",
         },
-        createdAt: new Date(),
+        status: "in_review",
+        createdAt: now,
+        updatedAt: now,
     };
     const { insertedId } = await (0, muniIssues_getters_1.getMuniIssuesCollection)().insertOne(issue);
     return insertedId;
 };
 exports.createMuniIssue = createMuniIssue;
+// An issue of this client that is tracked (has a status); answered issues stay editable.
+const trackedIssueFilter = (id, clientId) => ({
+    _id: new mongodb_1.ObjectId(id),
+    clientId,
+    status: { $exists: true },
+});
+const updateMuniIssueStatus = async (id, clientId, status) => {
+    if (!mongodb_1.ObjectId.isValid(id))
+        return false;
+    await (0, muniIssues_setup_1.ensureMuniIssuesCollectionOnce)();
+    const { matchedCount } = await (0, muniIssues_getters_1.getMuniIssuesCollection)().updateOne(trackedIssueFilter(id, clientId), { $set: { status, updatedAt: new Date() } });
+    return matchedCount > 0;
+};
+exports.updateMuniIssueStatus = updateMuniIssueStatus;
+const setMuniIssueResponse = async (id, clientId, { status, text, imageUrls }) => {
+    if (!mongodb_1.ObjectId.isValid(id))
+        return false;
+    await (0, muniIssues_setup_1.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 (0, muniIssues_getters_1.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;
+};
+exports.setMuniIssueResponse = setMuniIssueResponse;
 //# sourceMappingURL=muniIssues.setters.js.map

package/dist/municipal/muniIssues/muniIssues.setters.js.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.setters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":";;;AAEA,6DAA+D;AAC/D,yDAAoE;AAEpE,iHAAiH;AAC1G,MAAM,eAAe,GAAG,KAAK,EAClC,SAA+B,EAC/B,EAAY,EACO,EAAE;IACrB,MAAM,IAAA,iDAA8B,GAAE,CAAC;IAEvC,MAAM,KAAK,GAAc;QACvB,GAAG,EAAE,EAAE;QACP,GAAG,SAAS;QACZ,IAAI,EAAE;YACJ,GAAG,SAAS,CAAC,IAAI;YACjB,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,SAAS;SACnD;QACD,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,4CAAuB,GAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAjBW,QAAA,eAAe,mBAiB1B"}
+{"version":3,"file":"muniIssues.setters.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.setters.ts"],"names":[],"mappings":"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"}

package/dist/municipal/muniIssues/muniIssues.types.d.ts

@@ -1,7 +1,14 @@
 import { ObjectId } from "mongodb";
 import { CityName } from "../utils/types";
-import { MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
+import { MUNI_ISSUE_STATUSES, MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
 export type MuniIssueSyncStatus = (typeof MUNI_ISSUE_SYNC_STATUSES)[number];
+export type MuniIssueStatus = (typeof MUNI_ISSUE_STATUSES)[number];
+export type MuniIssueResponse = {
+    text: string;
+    imageUrls?: string[];
+    createdAt: Date;
+    updatedAt?: Date;
+};
 export type MuniIssueContent = {
     issuerName: string;
     issuerRole: string;
@@ -20,11 +27,24 @@ export type MuniIssue = {
     issueContent: MuniIssueContent;
     jira: MuniIssueJira;
     createdAt: Date;
+    status?: MuniIssueStatus;
+    response?: MuniIssueResponse;
+    updatedAt?: Date;
 };
-export type CreateMuniIssueInput = Omit<MuniIssue, "_id" | "createdAt" | "jira"> & {
+export type CreateMuniIssueInput = Omit<MuniIssue, "_id" | "createdAt" | "jira" | "status" | "response" | "updatedAt"> & {
     jira: {
         key: string;
         syncStatus?: MuniIssueSyncStatus;
     };
 };
+export type SetMuniIssueResponseInput = {
+    status: MuniIssueStatus;
+    text: string;
+    imageUrls?: string[];
+};
+export type FindMuniIssuesOptions = {
+    answered?: boolean;
+    skip?: number;
+    limit?: number;
+};
 //# sourceMappingURL=muniIssues.types.d.ts.map

package/dist/municipal/muniIssues/muniIssues.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"muniIssues.types.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAIF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,SAAS,EACT,KAAK,GAAG,WAAW,GAAG,MAAM,CAC7B,GAAG;IACF,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;CACzD,CAAC"}
+{"version":3,"file":"muniIssues.types.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAGhB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,CAAC;AAKF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,SAAS,EACT,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CACnE,GAAG;IACF,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/municipal/muniIssues/muniIssues.utils.d.ts

@@ -0,0 +1,3 @@
+import { MuniIssueResponse } from "./muniIssues.types";
+export declare const hasMuniIssueResponseContent: (response?: MuniIssueResponse) => boolean;
+//# sourceMappingURL=muniIssues.utils.d.ts.map

package/dist/municipal/muniIssues/muniIssues.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"muniIssues.utils.d.ts","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,2BAA2B,GACtC,WAAW,iBAAiB,KAC3B,OACgE,CAAC"}

package/dist/municipal/muniIssues/muniIssues.utils.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasMuniIssueResponseContent = void 0;
+const hasMuniIssueResponseContent = (response) => Boolean(response?.text) || (response?.imageUrls?.length ?? 0) > 0;
+exports.hasMuniIssueResponseContent = hasMuniIssueResponseContent;
+//# sourceMappingURL=muniIssues.utils.js.map

package/dist/municipal/muniIssues/muniIssues.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muniIssues.utils.js","sourceRoot":"","sources":["../../../src/municipal/muniIssues/muniIssues.utils.ts"],"names":[],"mappings":";;;AAEO,MAAM,2BAA2B,GAAG,CACzC,QAA4B,EACnB,EAAE,CACX,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAHvD,QAAA,2BAA2B,+BAG4B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talkpilot/core-db",
-  "version": "1.3.85",
+  "version": "1.3.87",
   "description": "Core database package for centralized connections and ORM integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -0,0 +1,87 @@
+import { ObjectId } from "mongodb";
+import { createMuniIssue, setMuniIssueResponse } from "../muniIssues.setters";
+import {
+  countMuniIssuesByClient,
+  findMuniIssuesByClient,
+  generateMuniIssueId,
+  getMuniIssueByIdForClient,
+  getMuniIssuesCollection,
+} from "../muniIssues.getters";
+import { createMuniIssueInput } from "../../../test-utils/factories";
+
+const CLIENT = "client-a";
+
+const createIssue = async (clientId = CLIENT) =>
+  (await createMuniIssue(createMuniIssueInput({ clientId }), generateMuniIssueId())).toString();
+
+describe("muniIssues getters (complaint tracking)", () => {
+  describe("findMuniIssuesByClient / countMuniIssuesByClient", () => {
+    it("should return only the client's tracked issues, newest first", async () => {
+      const older = await createIssue();
+      const newer = await createIssue();
+      // Both can land in the same millisecond; make the order explicit.
+      await getMuniIssuesCollection().updateOne(
+        { _id: new ObjectId(older) },
+        { $set: { createdAt: new Date(Date.now() - 60_000) } },
+      );
+      await createIssue("client-b");
+      // An issue created before complaint tracking has no status.
+      await getMuniIssuesCollection().insertOne({
+        ...createMuniIssueInput({ clientId: CLIENT }),
+        _id: generateMuniIssueId(),
+        jira: { key: "CP-legacy", syncStatus: "created" },
+        createdAt: new Date(),
+      });
+
+      const issues = await findMuniIssuesByClient(CLIENT);
+
+      expect(issues.map((i) => i._id.toString())).toEqual([newer, older]);
+      expect(await countMuniIssuesByClient(CLIENT)).toBe(2);
+    });
+
+    it("should filter by answered and apply skip/limit", async () => {
+      const answered = await createIssue();
+      await createIssue();
+      await createIssue();
+      await setMuniIssueResponse(answered, CLIENT, { status: "resolved", text: "Done" });
+
+      expect(await countMuniIssuesByClient(CLIENT, { answered: true })).toBe(1);
+      expect(await countMuniIssuesByClient(CLIENT, { answered: false })).toBe(2);
+      expect(
+        (await findMuniIssuesByClient(CLIENT, { answered: true }))[0]._id.toString(),
+      ).toBe(answered);
+      expect(await findMuniIssuesByClient(CLIENT, { skip: 1, limit: 1 })).toHaveLength(1);
+    });
+
+    it("should treat a response with only images as answered and a cleared response as waiting", async () => {
+      const imagesOnly = await createIssue();
+      const cleared = await createIssue();
+      const textOnly = await createIssue();
+      await setMuniIssueResponse(imagesOnly, CLIENT, {
+        status: "resolved",
+        text: "",
+        imageUrls: ["https://example.com/a.png"],
+      });
+      await setMuniIssueResponse(cleared, CLIENT, { status: "resolved", text: "Done" });
+      await setMuniIssueResponse(cleared, CLIENT, { status: "resolved", text: "", imageUrls: [] });
+      await setMuniIssueResponse(textOnly, CLIENT, { status: "resolved", text: "Done" });
+
+      const answered = await findMuniIssuesByClient(CLIENT, { answered: true });
+      const waiting = await findMuniIssuesByClient(CLIENT, { answered: false });
+
+      expect(answered.map((i) => i._id.toString()).sort()).toEqual([imagesOnly, textOnly].sort());
+      expect(waiting.map((i) => i._id.toString())).toEqual([cleared]);
+      expect(await countMuniIssuesByClient(CLIENT, { answered: false })).toBe(1);
+    });
+  });
+
+  describe("getMuniIssueByIdForClient", () => {
+    it("should return the issue only for its own client", async () => {
+      const id = await createIssue();
+
+      expect((await getMuniIssueByIdForClient(id, CLIENT))?._id.toString()).toBe(id);
+      expect(await getMuniIssueByIdForClient(id, "client-b")).toBeNull();
+      expect(await getMuniIssueByIdForClient("not-a-valid-id", CLIENT)).toBeNull();
+    });
+  });
+});

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

@@ -1,4 +1,8 @@
-import { createMuniIssue } from "../muniIssues.setters";
+import {
+  createMuniIssue,
+  setMuniIssueResponse,
+  updateMuniIssueStatus,
+} from "../muniIssues.setters";
 import {
   generateMuniIssueId,
   getMuniIssueById,
@@ -25,6 +29,18 @@ describe("muniIssues setters", () => {
       expect(saved?.createdAt).toBeInstanceOf(Date);
     });
 
+    it("should start the issue as in_review with updatedAt and no response", async () => {
+      const insertedId = await createMuniIssue(
+        createMuniIssueInput(),
+        generateMuniIssueId(),
+      );
+
+      const saved = await getMuniIssueById(insertedId.toString());
+      expect(saved?.status).toBe("in_review");
+      expect(saved?.updatedAt).toBeInstanceOf(Date);
+      expect(saved?.response).toBeUndefined();
+    });
+
     it("should default jira.syncStatus to created when not provided", async () => {
       const id = generateMuniIssueId();
 
@@ -91,4 +107,113 @@ describe("muniIssues setters", () => {
       expect(await getMuniIssueByJiraKey("CP-nope")).toBeNull();
     });
   });
+
+  describe("updateMuniIssueStatus", () => {
+    it("should change the status of an unanswered issue", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      expect(await updateMuniIssueStatus(id, input.clientId, "in_progress")).toBe(true);
+      expect((await getMuniIssueById(id))?.status).toBe("in_progress");
+    });
+
+    it("should not touch another client's issue or a malformed id", async () => {
+      const id = (
+        await createMuniIssue(createMuniIssueInput(), generateMuniIssueId())
+      ).toString();
+
+      expect(await updateMuniIssueStatus(id, "other-client", "resolved")).toBe(false);
+      expect(await updateMuniIssueStatus("not-a-valid-id", "any", "resolved")).toBe(false);
+      expect((await getMuniIssueById(id))?.status).toBe("in_review");
+    });
+  });
+
+  describe("setMuniIssueResponse", () => {
+    it("should save the response and status", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      const saved = await setMuniIssueResponse(id, input.clientId, {
+        status: "resolved",
+        text: "Fixed",
+        imageUrls: ["https://example.com/a.png", "https://example.com/b.png"],
+      });
+
+      expect(saved).toBe(true);
+      const issue = await getMuniIssueById(id);
+      expect(issue?.status).toBe("resolved");
+      expect(issue?.response).toMatchObject({
+        text: "Fixed",
+        imageUrls: ["https://example.com/a.png", "https://example.com/b.png"],
+      });
+      expect(issue?.response?.createdAt).toBeInstanceOf(Date);
+      expect(issue?.response?.updatedAt).toBeUndefined();
+    });
+
+    it("should let an answered issue be edited, keeping the first-sent date", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+      await setMuniIssueResponse(id, input.clientId, {
+        status: "in_review",
+        text: "First",
+        imageUrls: ["https://example.com/a.png"],
+      });
+      const firstSentAt = (await getMuniIssueById(id))?.response?.createdAt;
+
+      expect(
+        await setMuniIssueResponse(id, input.clientId, { status: "resolved", text: "Second" }),
+      ).toBe(true);
+      expect(await updateMuniIssueStatus(id, input.clientId, "no_issue_found")).toBe(true);
+
+      const issue = await getMuniIssueById(id);
+      expect(issue?.status).toBe("no_issue_found");
+      expect(issue?.response?.text).toBe("Second");
+      expect(issue?.response?.imageUrls).toEqual([]);
+      expect(issue?.response?.createdAt).toEqual(firstSentAt);
+      expect(issue?.response?.updatedAt).toBeInstanceOf(Date);
+    });
+
+    it("should save images without text, and keep a cleared response with its first-sent date", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      await setMuniIssueResponse(id, input.clientId, {
+        status: "resolved",
+        text: "",
+        imageUrls: ["https://example.com/a.png"],
+      });
+      const issueWithImage = await getMuniIssueById(id);
+      await setMuniIssueResponse(id, input.clientId, { status: "resolved", text: "", imageUrls: [] });
+
+      const response = (await getMuniIssueById(id))?.response;
+      expect(issueWithImage?.response?.imageUrls).toEqual(["https://example.com/a.png"]);
+      expect(response?.text).toBe("");
+      expect(response?.imageUrls).toEqual([]);
+      expect(response?.createdAt).toEqual(issueWithImage?.response?.createdAt);
+      expect(response?.updatedAt).toBeInstanceOf(Date);
+    });
+
+    it("should store text starting with $ as plain text", async () => {
+      const input = createMuniIssueInput();
+      const id = (await createMuniIssue(input, generateMuniIssueId())).toString();
+
+      await setMuniIssueResponse(id, input.clientId, { status: "resolved", text: "$status" });
+
+      expect((await getMuniIssueById(id))?.response?.text).toBe("$status");
+    });
+
+    it("should not touch another client's issue or a malformed id", async () => {
+      const id = (
+        await createMuniIssue(createMuniIssueInput(), generateMuniIssueId())
+      ).toString();
+
+      expect(
+        await setMuniIssueResponse(id, "other-client", { status: "resolved", text: "X" }),
+      ).toBe(false);
+      expect(
+        await setMuniIssueResponse("not-a-valid-id", "any", { status: "resolved", text: "X" }),
+      ).toBe(false);
+      expect((await getMuniIssueById(id))?.response).toBeUndefined();
+    });
+  });
 });

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

@@ -28,6 +28,7 @@ describe("muniIssues setup", () => {
         expect.arrayContaining([
           "callSid_1",
           "createdAt_-1",
+          "clientId_1_createdAt_-1",
           "jira_key_unique",
         ]),
       );

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

@@ -0,0 +1,17 @@
+import { hasMuniIssueResponseContent } from "../muniIssues.utils";
+
+describe("hasMuniIssueResponseContent", () => {
+  const base = { createdAt: new Date() };
+
+  it("should be true for text, images, or both", () => {
+    expect(hasMuniIssueResponseContent({ ...base, text: "Done" })).toBe(true);
+    expect(hasMuniIssueResponseContent({ ...base, text: "", imageUrls: ["a"] })).toBe(true);
+    expect(hasMuniIssueResponseContent({ ...base, text: "Done", imageUrls: ["a"] })).toBe(true);
+  });
+
+  it("should be false for no response or an empty one", () => {
+    expect(hasMuniIssueResponseContent(undefined)).toBe(false);
+    expect(hasMuniIssueResponseContent({ ...base, text: "" })).toBe(false);
+    expect(hasMuniIssueResponseContent({ ...base, text: "", imageUrls: [] })).toBe(false);
+  });
+});

package/src/municipal/muniIssues/index.ts

@@ -1,8 +1,11 @@
 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,
@@ -13,5 +16,9 @@ export type {
   MuniIssueContent,
   MuniIssueJira,
   MuniIssueSyncStatus,
+  MuniIssueStatus,
+  MuniIssueResponse,
   CreateMuniIssueInput,
+  SetMuniIssueResponseInput,
+  FindMuniIssuesOptions,
 } from "./muniIssues.types";

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

@@ -4,6 +4,15 @@ 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;
 

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

@@ -1,6 +1,6 @@
-import { Collection, ObjectId } from "mongodb";
+import { Collection, Filter, ObjectId } from "mongodb";
 import { getDb } from "../index";
-import { MuniIssue } from "./muniIssues.types";
+import { FindMuniIssuesOptions, MuniIssue } from "./muniIssues.types";
 import { MUNI_ISSUES_COLLECTION } from "./muniIssues.constants";
 
 export const getMuniIssuesCollection = (): Collection<MuniIssue> => {
@@ -22,3 +22,52 @@ export const getMuniIssueByJiraKey = async (
 ): 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,5 +1,7 @@
 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,
@@ -55,12 +57,29 @@ export const muniIssuesJsonSchema: Document = {
       },
     },
     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,5 +1,10 @@
-import { ObjectId } from "mongodb";
-import { CreateMuniIssueInput, MuniIssue } from "./muniIssues.types";
+import { Filter, ObjectId } from "mongodb";
+import {
+  CreateMuniIssueInput,
+  MuniIssue,
+  MuniIssueStatus,
+  SetMuniIssueResponseInput,
+} from "./muniIssues.types";
 import { getMuniIssuesCollection } from "./muniIssues.getters";
 import { ensureMuniIssuesCollectionOnce } from "./muniIssues.setup";
 
@@ -10,6 +15,7 @@ export const createMuniIssue = async (
 ): Promise<ObjectId> => {
   await ensureMuniIssuesCollectionOnce();
 
+  const now = new Date();
   const issue: MuniIssue = {
     _id: id,
     ...issueData,
@@ -17,8 +23,65 @@ export const createMuniIssue = async (
       ...issueData.jira,
       syncStatus: issueData.jira.syncStatus ?? "created",
     },
-    createdAt: new Date(),
+    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;
+};

package/src/municipal/muniIssues/muniIssues.types.ts

@@ -1,10 +1,22 @@
 import { ObjectId } from "mongodb";
 
 import { CityName } from "../utils/types";
-import { MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
+import {
+  MUNI_ISSUE_STATUSES,
+  MUNI_ISSUE_SYNC_STATUSES,
+} from "./muniIssues.constants";
 
 export type MuniIssueSyncStatus = (typeof MUNI_ISSUE_SYNC_STATUSES)[number];
 
+export type MuniIssueStatus = (typeof MUNI_ISSUE_STATUSES)[number];
+
+export type MuniIssueResponse = {
+  text: string;
+  imageUrls?: string[];
+  createdAt: Date;
+  updatedAt?: Date;
+};
+
 export type MuniIssueContent = {
   issuerName: string;
   issuerRole: string;
@@ -25,13 +37,31 @@ export type MuniIssue = {
   issueContent: MuniIssueContent;
   jira: MuniIssueJira;
   createdAt: Date;
+  // Complaint tracking (CP-1888). Optional: issues created before it have none
+  // of these, which is how they are kept out of tracking.
+  status?: MuniIssueStatus;
+  response?: MuniIssueResponse;
+  updatedAt?: Date;
 };
 
-// _id/createdAt are set on insert; jira.syncStatus defaults to "created"
-// because the issue is only stored after its Jira ticket exists (CP-1115).
+// _id/createdAt/status/updatedAt are set on insert, response only later (setMuniIssueResponse);
+// jira.syncStatus defaults to "created" because the issue is only stored after its Jira
+// ticket exists (CP-1115).
 export type CreateMuniIssueInput = Omit<
   MuniIssue,
-  "_id" | "createdAt" | "jira"
+  "_id" | "createdAt" | "jira" | "status" | "response" | "updatedAt"
 > & {
   jira: { key: string; syncStatus?: MuniIssueSyncStatus };
 };
+
+export type SetMuniIssueResponseInput = {
+  status: MuniIssueStatus;
+  text: string;
+  imageUrls?: string[];
+};
+
+export type FindMuniIssuesOptions = {
+  answered?: boolean;
+  skip?: number;
+  limit?: number;
+};

package/src/municipal/muniIssues/muniIssues.utils.ts

@@ -0,0 +1,6 @@
+import { MuniIssueResponse } from "./muniIssues.types";
+
+export const hasMuniIssueResponseContent = (
+  response?: MuniIssueResponse,
+): boolean =>
+  Boolean(response?.text) || (response?.imageUrls?.length ?? 0) > 0;