602772b · b804266
@@ -269,6 +269,18 @@
list cannot drift from the app.
   Print it, or save it as a PDF. "Rewrite all" writes every asset again in
   another tone (your edits are replaced, so it asks with a tooltip first).
**Showings.** After each showing, write it down on the listing page: the day
(today unless you change it; never a future one), the buyer's agent if you
know them, how interested they were (Not interested, Maybe, Interested, Offer
likely) and one line of what they said. It is a plain form, newest first, and
"Remove" takes one back out. When the seller asks "how is it showing?", the
log answers, and the home list shows "5 showings" beside the listing. The
feedback gets the same Fair Housing check as anything you type, with the
finding beside the line. Only you (or an admin) see the log: buyer's agents'
names stay off the property page, the email and the flyer, and go when the
listing does. Assistants can add one too (`POST /api/listings/:id/showings`,
or `log_showing` over MCP); a refused field is named in the 422.
Three sample listings are there from the start so the screen is
never empty; "Start a new one from this" copies any listing into the form.
@@ -332,6 +344,7 @@
decide nothing themselves. `AGENTS.md` says how to add to it.
| `src/fairhousing.ts`               | the Fair Housing rules: phrase, context, class, reason, rewrite |
| `src/photos.ts`                    | photos as files beside the database, known by their bytes      |
| `src/sample.ts`                    | the sample listing, planted once                               |
| `src/showings.ts`                  | the showings the agent logged: the boundary for a day, a buyer's agent, an interest and a line |
| `src/visitors.ts`                  | the open house sign-in sheet's visitors: the boundary for a name and an email |
| `contract.json`                    | who may do what: roles, and the least role each verb needs     |
| `src/contract.ts`, `src/can.ts`    | the table, read at boot; the forge's evaluator, verbatim       |
@@ -445,7 +458,7 @@
listing with `enter` to read every asset with its Fair Housing findings;
`j`/`k` move between assets, `e` edits the one under the cursor (type `\n`
for a line break, `enter` saves and checks it again), `t` rewrites them all
in the next tone, `s` sets the status (`sold 752000`, `under contract`, `coming soon`,
`withdrawn`, `expired`, `active`), `p` previews the email as the client reads it, `P` the open house follow-up with the sign-in visitors it would go to, `V` lists those visitors (`a` adds one as `Name, email`, `d` removes the one under the cursor; only the listing's agent or an admin, a guest sees none), `x` removes a listing of your own. `tab` switches to the notes. Launching a listing, with its photos, is the page's alone.
`withdrawn`, `expired`, `active`), `p` previews the email as the client reads it, `P` the open house follow-up with the sign-in visitors it would go to, `V` lists those visitors (`a` adds one as `Name, email`, `d` removes the one under the cursor; only the listing's agent or an admin, a guest sees none), `S` lists the showings you logged (`a` logs one as `date; buyer's agent; interest; what they said`, with the date empty for today and the interest as not interested, maybe, interested or offer likely; `d` removes the one under the cursor; only the listing's agent or an admin, a guest sees none), `x` removes a listing of your own. `tab` switches to the notes. Launching a listing, with its photos, is the page's alone.
No runtime dependencies: Bun's own `bun:sqlite`, `Bun.serve` and `node:`
modules. The typefaces are the system's (a Palatino/Iowan serif for
@@ -577,7 +577,7 @@
    },
    "/api/listings/{id}": {
      "get": {
        "summary": "One listing, with its assets and each one's Fair Housing check.",
        "summary": "One listing, with its assets and each one's Fair Housing check; for the listing's agent or an admin, also its logged showings, newest first.",
        "operationId": "getApiListingsId",
        "parameters": [
          {
@@ -591,7 +591,7 @@
        ],
        "responses": {
          "200": {
            "description": "One listing, with its assets and each one's Fair Housing check.",
            "description": "One listing, with its assets and each one's Fair Housing check; for the listing's agent or an admin, also its logged showings, newest first.",
            "content": {
              "application/json": {
                "schema": {
@@ -921,6 +921,157 @@
        }
      }
    },
    "/api/listings/{id}/showings": {
      "post": {
        "summary": "Log a showing: the day, the buyer's agent, how interested they were and one line of feedback. Only the listing's agent or an admin; a refused field is named in the 422.",
        "operationId": "postApiListingsIdShowings",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string",
                    "description": "YYYY-MM-DD, not in the future; today when left out."
                  },
                  "agent": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "The buyer's agent, optional."
                  },
                  "interest": {
                    "enum": [
                      "not_interested",
                      "maybe",
                      "interested",
                      "offer_likely"
                    ]
                  },
                  "feedback": {
                    "type": "string",
                    "maxLength": 280,
                    "description": "One line, plain text."
                  }
                },
                "required": [
                  "interest"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Log a showing: the day, the buyer's agent, how interested they were and one line of feedback. Only the listing's agent or an admin; a refused field is named in the 422.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "showing": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "showing"
                  ]
                }
              }
            }
          },
          "default": {
            "description": "{ error, message }: why not",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-contract": {
          "resource": "listing",
          "verb": "update",
          "least": "author"
        }
      }
    },
    "/api/listings/{id}/showings/{showing}": {
      "delete": {
        "summary": "Remove a showing the agent logged.",
        "operationId": "deleteApiListingsIdShowingsShowing",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "showing",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Remove a showing the agent logged.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              }
            }
          },
          "default": {
            "description": "{ error, message }: why not",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-contract": {
          "resource": "listing",
          "verb": "update",
          "least": "author"
        }
      }
    },
    "/api/audit": {
      "get": {
        "summary": "The audit trail, newest first; `before` pages back by id.",
@@ -1329,6 +1480,50 @@
            "type": "string",
            "format": "date-time"
          },
          "showings": {
            "type": "array",
            "description": "The logged showings, newest first; only for the listing's agent or an admin.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "date": {
                  "type": "string",
                  "description": "YYYY-MM-DD."
                },
                "agent": {
                  "type": "string",
                  "maxLength": 80
                },
                "interest": {
                  "enum": [
                    "not_interested",
                    "maybe",
                    "interested",
                    "offer_likely"
                  ]
                },
                "feedback": {
                  "type": "string",
                  "maxLength": 280
                },
                "check": {
                  "type": "object",
                  "description": "The Fair Housing check on the feedback."
                }
              },
              "required": [
                "id",
                "date",
                "agent",
                "interest",
                "feedback",
                "check"
              ]
            }
          },
          "assets": {
            "type": "array",
            "items": {
@@ -1677,6 +1872,10 @@
            "type": "integer",
            "description": "Phrases the Fair Housing check flags across every asset."
          },
          "showings": {
            "type": "integer",
            "description": "How many showings the agent logged; 0 for anyone who may not update the listing."
          },
          "approvals": {
            "type": "array",
            "description": "Each asset and whether somebody has signed off its words.",
@@ -1740,7 +1939,8 @@
          "created_at",
          "updated_at",
          "flags",
          "approvals"
          "approvals",
          "showings"
        ]
      },
      "AuditRow": {
@@ -50,6 +50,7 @@
import {
} from "./photos.ts";
import { headshotFrom } from "./agent.ts";
import { sellerUpdate } from "./update.ts";
import { validShowing, SHOWINGS_MAX, type Showing } from "./showings.ts";
import { validVisitor, VISITORS_MAX, type Visitor } from "./visitors.ts";
import type { Who } from "./who.ts";
@@ -72,12 +73,13 @@
export type Failure =
  | "duplicate_address";
export type Result<T> =
  | { ok: true; value: T }
  | { ok: false; error: Failure; message: string; existing?: Earlier };
  | { ok: false; error: Failure; message: string; existing?: Earlier; field?: string };
const ok = <T>(value: T): Result<T> => ({ ok: true, value });
const fail = <T>(error: Failure, message: string): Result<T> => ({
const fail = <T>(error: Failure, message: string, field?: string): Result<T> => ({
  ok: false,
  error,
  message,
  ...(field === undefined ? {} : { field }),
});
export const BODY_MAX = 500;
@@ -551,6 +553,8 @@
export function markStatus(
export type ListingSummary = Listing & {
  flags: number;
  approvals: { kind: string; approved: boolean }[];
  /** How many showings the agent logged; counted only for whoever may update the listing, else 0. */
  showings: number;
};
export function listListings(
@@ -583,6 +587,7 @@
export function listListings(
  const bodies = db.query<{ kind: string; body: string; approved_at: string | null }, [number]>(
    "SELECT kind, body, approved_at FROM asset WHERE listing_id = ?1 ORDER BY rowid",
  );
  const logged = db.query<{ n: number }, [number]>("SELECT count(*) AS n FROM showing WHERE listing_id = ?1");
  return ok(
    rows
      .filter((row) => matchesText(row, wanted.q))
@@ -590,6 +595,7 @@
export function listListings(
        const assets = bodies.all(row.id);
        return {
          ...fromRow(row),
          showings: permit(who, "listing", "update", row) === "yes" ? logged.get(row.id)!.n : 0,
          flags: assets.reduce((n, a) => n + check(a.body).findings.length, 0),
          approvals: assets.map((a) => ({ kind: a.kind, approved: a.approved_at !== null })),
        };
@@ -1354,6 +1360,67 @@
function dropVisitor(db: Database, who: Who, input: { id: number; visitor: numbe
  return ok({ id: found.value.id });
}
/*
 * Showings. After each one the agent writes down who came and what they said.
 * Third-party names: read and changed only through the listing's update door
 * (its author or an admin), never with the listing, and never on the public
 * property page, the email or the flyer.
 */
/** A logged showing with the Fair Housing check run on its feedback, as typed words are. */
export type LoggedShowing = Showing & { check: Check };
const showingsFor = (db: Database, who: Who, id: number, signIn: string): Result<Launched> =>
  listingFor(db, who, "update", id, { signIn, no: "Only the listing's agent or an admin can see the showings." });
export function listShowings(db: Database, who: Who, input: { id: number }): Result<LoggedShowing[]> {
  const found = showingsFor(db, who, input.id, "Sign in to see the showings.");
  if (!found.ok) return found;
  return ok(
    db
      .query<Showing, [number]>("SELECT id, date, agent, interest, feedback FROM showing WHERE listing_id = ?1 ORDER BY date DESC, id DESC")
      .all(found.value.id)
      .map((s) => ({ ...s, check: check(s.feedback) })),
  );
}
type ShowingInput = { id: number; date?: unknown; agent?: unknown; interest?: unknown; feedback?: unknown; now?: Date };
export const addShowing = (db: Database, who: Who, input: ShowingInput): Result<{ id: number; showing: number }> =>
  audited(db, who, "listing", "update", input.id, putShowing(db, who, input));
function putShowing(db: Database, who: Who, input: ShowingInput): Result<{ id: number; showing: number }> {
  const found = showingsFor(db, who, input.id, "Sign in to log a showing.");
  if (!found.ok) return found;
  const valid = validShowing(input, input.now);
  if (!valid.ok) return fail("invalid", valid.message, valid.field);
  const have = db.query<{ n: number }, [number]>("SELECT count(*) AS n FROM showing WHERE listing_id = ?1").get(found.value.id)!.n;
  if (have >= SHOWINGS_MAX) return fail("invalid", `At most ${SHOWINGS_MAX} showings on one listing.`);
  const v = valid.value;
  const row = db
    .query<{ id: number }, [number, string, string, string, string]>(
      "INSERT INTO showing (listing_id, date, agent, interest, feedback) VALUES (?1, ?2, ?3, ?4, ?5) RETURNING id",
    )
    .get(found.value.id, v.date, v.agent, v.interest, v.feedback)!;
  emit(db, "listing.changed", { id: found.value.id });
  return ok({ id: found.value.id, showing: row.id });
}
export const removeShowing = (db: Database, who: Who, input: { id: number; showing: number }): Result<{ id: number }> =>
  audited(db, who, "listing", "update", input.id, dropShowing(db, who, input));
function dropShowing(db: Database, who: Who, input: { id: number; showing: number }): Result<{ id: number }> {
  const found = showingsFor(db, who, input.id, "Sign in to remove a showing.");
  if (!found.ok) return found;
  const gone = db.query("DELETE FROM showing WHERE id = ?1 AND listing_id = ?2").run(
    Number.isInteger(input.showing) ? input.showing : -1,
    found.value.id,
  );
  if (gone.changes === 0) return fail("not_found", "No such showing.");
  emit(db, "listing.changed", { id: found.value.id });
  return ok({ id: found.value.id });
}
/** The Fair Housing check on any words: no row, no door, nothing kept. */
export const checkWords = (text: string): Check =>
  check(text.slice(0, ASSET_MAX));
@@ -20,6 +20,9 @@
import {
  getNote,
  insertListing,
  launchListing,
  addShowing,
  listShowings,
  removeShowing,
  listVersions,
  restoreAsset,
  updatePhotos,
@@ -312,3 +315,37 @@
test("restoring an earlier version answers as the listing's update cell says, at
  }
  expect(asked).toBeGreaterThan(0);
});
/** Showings are `listing:update`: the actions and the tool let through exactly whom the table's update cell does. */
test("logging, listing and removing a showing answers as the listing's update cell says, at the actions and the tool", () => {
  const root = { role: "admin" as const, id: "root", name: "root" };
  let asked = 0;
  for (const cell of table(contract)) {
    if (cell.resource !== "listing" || cell.verb !== "update") continue;
    const who = whoIs(cell.as);
    const { mine, theirs } = actingAs(contract, cell.as);
    const attempts = (authorId: string) => {
      const id = listingBy(authorId);
      const planted = addShowing(db, root, { id, interest: "maybe" });
      const showing = planted.ok ? planted.value.showing : -1;
      const tool = !JSON.stringify(
        rpc(db, who, { jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "log_showing", arguments: { id, interest: "maybe" } } }).body,
      ).includes('"isError":true');
      return [
        addShowing(db, who, { id, interest: "maybe" }).ok,
        tool,
        listShowings(db, who, { id }).ok,
        removeShowing(db, who, { id, showing }).ok,
      ];
    };
    const onMine = attempts(String(mine["author_id"]));
    const onTheirs = attempts(String(theirs["author_id"]));
    const said = `showings as ${cell.as}`;
    asked++;
    const all = (v: boolean) => [v, v, v, v];
    if (cell.answer === "yes") expect([said, onMine, onTheirs]).toEqual([said, all(true), all(true)]);
    else if (cell.answer === "no") expect([said, onMine, onTheirs]).toEqual([said, all(false), all(false)]);
    else expect([said, onMine, onTheirs]).toEqual([said, all(true), all(false)]);
  }
  expect(asked).toBeGreaterThan(0);
});
@@ -224,6 +224,18 @@
export const migrations: string[] = [
   DROP TABLE asset_version_old;
   DROP TABLE asset_old;
   DROP TABLE listing_old;`,
  // Each showing the agent logged: the day, the buyer's agent, how interested, one line of feedback. Third-party
  // names, read only through the listing's update door, never with the listing. They go with their listing.
  `CREATE TABLE IF NOT EXISTS showing (
    id INTEGER PRIMARY KEY,
    listing_id INTEGER NOT NULL REFERENCES listing (id) ON DELETE CASCADE,
    date TEXT NOT NULL CHECK (length(date) = 10),
    agent TEXT NOT NULL CHECK (length(agent) <= 80),
    interest TEXT NOT NULL CHECK (interest IN ('not_interested', 'maybe', 'interested', 'offer_likely')),
    feedback TEXT NOT NULL CHECK (length(feedback) <= 280),
    created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
  );
  CREATE INDEX IF NOT EXISTS showing_listing ON showing (listing_id, date, id)`,
];
export function openDb(dir = dataDir): Database {
@@ -9,6 +9,7 @@
import type { Database } from "bun:sqlite";
import { FILTERS, Q_MAX } from "./find.ts";
import {
  addShowing,
  addNote,
  approveAsset,
  checkWords,
@@ -29,6 +30,7 @@
import {
  updatePhotos,
  type Result,
} from "./actions.ts";
import { INTERESTS, SHOWING_AGENT_MAX, SHOWING_FEEDBACK_MAX } from "./showings.ts";
import { KINDS, STATUSES, TONES } from "./generate.ts";
import { title } from "./env.ts";
import { fields } from "./http.ts";
@@ -121,6 +123,24 @@
export const tools: readonly Tool[] = [
    },
    run: (db, who, args) => getListing(db, who, { id: Number(args.id) }),
  },
  {
    name: "log_showing",
    description:
      "Log a showing on a listing: the day (YYYY-MM-DD, not in the future; today when left out), the buyer's agent (optional, up to 80 characters), how interested the buyers were and one line of what they said (up to 280 characters, plain text, Fair Housing checked when read). Only the listing's agent or an admin can; showings never reach the property page, the email or the flyer.",
    inputSchema: {
      type: "object",
      properties: {
        id: { type: "integer" },
        date: { type: "string", description: "YYYY-MM-DD." },
        agent: { type: "string", maxLength: SHOWING_AGENT_MAX },
        interest: { enum: [...INTERESTS] },
        feedback: { type: "string", maxLength: SHOWING_FEEDBACK_MAX },
      },
      required: ["id", "interest"],
    },
    run: (db, who, args) =>
      addShowing(db, who, { id: Number(args.id), date: args.date, agent: args.agent, interest: args.interest, feedback: args.feedback }),
  },
  {
    name: "launch_kit",
    description:
@@ -236,7 +236,7 @@
function list(listings: readonly ListingSummary[], wanted: Find): string {
        <span class="card-body">
          <b>${escape(l.address)}</b>
          <span>${money(l.price)} · ${l.beds} bd · ${l.baths} ba · ${count(l.sqft)} sq ft</span>
          <span class="row card-meta">${approvalPill(l.approvals.filter((a) => a.approved).length, l.approvals.length)}${statusPill(l)}${status(l.flags)}<small class="muted">${escape(l.author_name)} · ${ago(l.updated_at)}</small></span>
          <span class="row card-meta">${approvalPill(l.approvals.filter((a) => a.approved).length, l.approvals.length)}${statusPill(l)}${status(l.flags)}${l.showings === 0 ? "" : `<span class="pill">${l.showings} ${l.showings === 1 ? "showing" : "showings"}</span>`}<small class="muted">${escape(l.author_name)} · ${ago(l.updated_at)}</small></span>
      
        sentinelcrew
        9d ago
        
      
      This pill (singular/plural, hidden at 0) has no test that renders it; add one that fails without this line.
    
        </span>
      </a>
    </li>`;
@@ -4,7 +4,7 @@
 * flyer, which is also a page of its own for printing (`flyerPage`).
 */
import type { Version } from "../actions.ts";
import type { LoggedShowing, Version } from "../actions.ts";
import type { Check, Finding } from "../fairhousing.ts";
import { classHref } from "./fairhousing.ts";
import {
@@ -24,7 +24,9 @@
import { altOf, approvalLabel, ASSET_MAX, propertyPath, type Asset, type Launche
import { isPost, lengthLine, meantForX, overXNote } from "../postlength.ts";
import { isSample } from "../photos.ts";
import type { Who } from "../who.ts";
import { dayOf } from "../showings.ts";
import { ago, layout, toast } from "./layout.ts";
import { showingsSection } from "./showings.ts";
/** Where a listing's photo is served: a sample from static/, an upload from its listing. */
export const photoUrl = (listing: Pick<Listing, "id">, name: string): string =>
@@ -211,6 +213,8 @@
export function listingPage(input: {
  versions?: Readonly<Record<string, readonly Version[]>>;
  tab?: string | null;
  notice?: string | undefined;
  /** The logged showings: given only to whoever may update the listing. */
  showings?: readonly LoggedShowing[];
}): string {
  const { who, listing: l, editable, notice } = input;
  const origin = input.origin ?? "";
@@ -274,6 +278,7 @@
export function listingPage(input: {
      </div>`,
      ).join("")}
    </div>
    ${input.showings === undefined ? "" : showingsSection(l.id, input.showings, dayOf(new Date()))}
    ${
      editable
        ? `<form class="danger-zone" method="post" action="/listings/${l.id}/delete">
@@ -0,0 +1,43 @@
/**
 * The Showings section of the agent's listing page: a form to log one and the
 * log, newest first, each line Fair Housing checked like typed words. Only the
 * listing's agent or an admin is ever handed these; the property page, the
 * email and the flyer never see them.
 */
import type { LoggedShowing } from "../actions.ts";
import { escape } from "../http.ts";
import { INTEREST_LABELS, INTERESTS, SHOWING_AGENT_MAX, SHOWING_FEEDBACK_MAX } from "../showings.ts";
const day = (date: string): string =>
  new Date(`${date}T00:00:00Z`).toLocaleDateString("en", { month: "short", day: "numeric", year: "numeric", timeZone: "UTC" });
function entry(listingId: number, s: LoggedShowing): string {
  const flagged = s.check.findings;
  return `<li class="showing">
      <p><b>${escape(day(s.date))}</b> · ${escape(INTEREST_LABELS[s.interest])}${s.agent === "" ? "" : ` · ${escape(s.agent)}`}</p>
      ${s.feedback === "" ? "" : `<p>${escape(s.feedback)}</p>`}
      ${flagged.length === 0 ? "" : `<ul class="fh-list" aria-label="Phrases to review">${flagged.map((f) => `<li><span class="fh-tag">${f.level === "note" ? "note" : escape(f.touches)}</span> ${escape(f.line)}</li>`).join("")}</ul>`}
      <form method="post" action="/listings/${listingId}/showings/${s.id}/delete">
        <button class="button button-quiet" aria-label="Remove the showing on ${escape(day(s.date))}">Remove</button>
      </form>
    </li>`;
}
export function showingsSection(listingId: number, showings: readonly LoggedShowing[], today: string): string {
  return `<section class="showings" id="showings" aria-labelledby="showings-title">
    <h3 id="showings-title">Showings <small class="muted">${showings.length === 0 ? "none yet" : `${showings.length} logged`} · only you see these</small></h3>
    <form class="row" method="post" action="/listings/${listingId}/showings">
      <label class="sr" for="showing-date">Date</label>
      <input class="input" id="showing-date" type="date" name="date" value="${escape(today)}" max="${escape(today)}" required>
      <label class="sr" for="showing-agent">Buyer's agent, optional</label>
      <input class="input" id="showing-agent" name="agent" maxlength="${SHOWING_AGENT_MAX}" placeholder="Buyer's agent (optional)" autocomplete="off">
      <label class="sr" for="showing-interest">Interest</label>
      <select class="input select" id="showing-interest" name="interest">${INTERESTS.map((i) => `<option value="${i}"${i === "maybe" ? " selected" : ""}>${INTEREST_LABELS[i]}</option>`).join("")}</select>
      <label class="sr" for="showing-feedback">What they said</label>
      <input class="input" id="showing-feedback" name="feedback" maxlength="${SHOWING_FEEDBACK_MAX}" placeholder="What they said, one line" autocomplete="off">
      <button class="button">Log showing</button>
    </form>
    ${showings.length === 0 ? "" : `<ul class="showing-list">${showings.map((s) => entry(listingId, s)).join("")}</ul>`}
  </section>`;
}
@@ -24,9 +24,12 @@
import {
  editAsset,
  getAudit,
  getHome,
  addShowing,
  addVisitor,
  getListing,
  listShowings,
  listVisitors,
  removeShowing,
  removeVisitor,
  getNote,
  launchListing,
@@ -72,6 +75,7 @@
import { draftOf, home, type Draft } from "./pages/home.ts";
import { layout } from "./pages/layout.ts";
import { fairHousingPage } from "./pages/fairhousing.ts";
import { factsPage } from "./pages/facts.ts";
import { INTERESTS, SHOWING_AGENT_MAX, SHOWING_FEEDBACK_MAX } from "./showings.ts";
import { emailPage } from "./pages/email.ts";
import { publicOrigin } from "./env.ts";
import { propertyPage } from "./pages/property.ts";
@@ -242,6 +246,10 @@
export const LISTING_SUMMARY: Schema = {
      type: "integer",
      description: "Phrases the Fair Housing check flags across every asset.",
    },
    showings: {
      type: "integer",
      description: "How many showings the agent logged; 0 for anyone who may not update the listing.",
    },
    approvals: {
      type: "array",
      description: "Each asset and whether somebody has signed off its words.",
@@ -252,12 +260,39 @@
export const LISTING_SUMMARY: Schema = {
      },
    },
  },
  required: [...LISTING_REQUIRED, "flags", "approvals"],
  required: [...LISTING_REQUIRED, "flags", "approvals", "showings"],
};
const SHOWING: Schema = {
  type: "object",
  properties: {
    id: { type: "integer" },
    date: { type: "string", description: "YYYY-MM-DD." },
    agent: { type: "string", maxLength: SHOWING_AGENT_MAX },
    interest: { enum: [...INTERESTS] },
    feedback: { type: "string", maxLength: SHOWING_FEEDBACK_MAX },
    check: { type: "object", description: "The Fair Housing check on the feedback." },
  },
  required: ["id", "date", "agent", "interest", "feedback", "check"],
};
const SHOWING_BODY: Schema = {
  type: "object",
  properties: {
    date: { type: "string", description: "YYYY-MM-DD, not in the future; today when left out." },
    agent: { type: "string", maxLength: SHOWING_AGENT_MAX, description: "The buyer's agent, optional." },
    interest: { enum: [...INTERESTS] },
    feedback: { type: "string", maxLength: SHOWING_FEEDBACK_MAX, description: "One line, plain text." },
  },
  required: ["interest"],
};
export const LISTING: Schema = {
  type: "object",
  properties: {
    ...LISTING_FIELDS,
    showings: {
      type: "array",
      description: "The logged showings, newest first; only for the listing's agent or an admin.",
      items: SHOWING,
    },
    assets: {
      type: "array",
      items: {
@@ -360,6 +395,7 @@
const answer = <T>(result: Result<T>, status = 200): Response =>
        {
          error: result.error,
          message: result.message,
          ...(result.field === undefined ? {} : { field: result.field }),
          ...(result.existing === undefined ? {} : { id: result.existing.id }),
        },
        STATUS[result.error],
@@ -505,8 +541,10 @@
export const routes: readonly Route[] = [
      if (!found.ok) return page(c.who, found, () => "");
      const earlier = listVersions(c.db, c.who, { id: Number(c.params.id) });
      const versions = earlier.ok ? earlier.value : {};
      const showings = listShowings(c.db, c.who, { id: Number(c.params.id) });
      return html(
        listingPage({
          ...(showings.ok ? { showings: showings.value } : {}),
          who: c.who,
          listing: found.value,
          origin: publicOrigin,
@@ -672,6 +710,32 @@
export const routes: readonly Route[] = [
      );
    },
  },
  {
    method: "POST",
    path: "/listings/:id/showings",
    handle: async (c) => {
      const form = await readForm(c.request);
      if (form === undefined) return text("too large", 413);
      const id = Number(c.params.id);
      const done = addShowing(c.db, c.who, {
        id,
        date: form.get("date"),
        agent: form.get("agent"),
        interest: form.get("interest"),
        feedback: form.get("feedback"),
      });
      return back(done.ok ? "Showing logged." : done.message, `/listings/${id}`);
    },
  },
  {
    method: "POST",
    path: "/listings/:id/showings/:showing/delete",
    handle: (c) => {
      const id = Number(c.params.id);
      const done = removeShowing(c.db, c.who, { id, showing: Number(c.params.showing) });
      return back(done.ok ? "Showing removed." : done.message, `/listings/${id}`);
    },
  },
  {
    method: "POST",
    path: "/listings/:id/visitors",
@@ -991,8 +1055,38 @@
export const routes: readonly Route[] = [
  {
    method: "GET",
    path: "/api/listings/:id",
    handle: (c) => answer(getListing(c.db, c.who, { id: Number(c.params.id) })),
    api: { summary: "One listing, with its assets and each one's Fair Housing check.", answer: LISTING },
    handle: (c) => {
      const id = Number(c.params.id);
      const found = getListing(c.db, c.who, { id });
      const showings = found.ok ? listShowings(c.db, c.who, { id }) : undefined;
      return answer(found.ok && showings?.ok ? { ok: true as const, value: { ...found.value, showings: showings.value } } : found);
    },
    api: { summary: "One listing, with its assets and each one's Fair Housing check; for the listing's agent or an admin, also its logged showings, newest first.", answer: LISTING },
  },
  {
    method: "POST",
    path: "/api/listings/:id/showings",
    handle: async (c) => {
      const raw = await readJson(c.request);
      if (raw === undefined) return json({ error: "too_large" }, 413);
      const body = fields(raw);
      return answer(
        addShowing(c.db, c.who, { id: Number(c.params.id), date: body.date, agent: body.agent, interest: body.interest, feedback: body.feedback }),
        201,
      );
    },
    api: {
      summary: "Log a showing: the day, the buyer's agent, how interested they were and one line of feedback. Only the listing's agent or an admin; a refused field is named in the 422.",
      body: SHOWING_BODY,
      answer: { type: "object", properties: { id: { type: "integer" }, showing: { type: "integer" } }, required: ["id", "showing"] },
      status: 201,
    },
  },
  {
    method: "DELETE",
    path: "/api/listings/:id/showings/:showing",
    handle: (c) => answer(removeShowing(c.db, c.who, { id: Number(c.params.id), showing: Number(c.params.showing) })),
    api: { summary: "Remove a showing the agent logged.", answer: { type: "object", properties: { id: { type: "integer" } }, required: ["id"] } },
  },
  {
    method: "PATCH",
@@ -8,6 +8,7 @@
import type { Database } from "bun:sqlite";
import { draftMissingUpdates, insertListing, markStatus, redraftUpdate } from "./actions.ts";
import type { ListingInput } from "./listing.ts";
import { dayOf, type Interest } from "./showings.ts";
export const SAMPLE: ListingInput = {
  address: "412 Alder Lane, Portland, OR 97214",
@@ -111,16 +112,29 @@
interface Sample {
  readonly alt: readonly string[];
  /** Where the sample stands; absent means active. */
  readonly sold_at?: number;
  /** The showings the agent logged: days ago, the buyer's agent, how interested, what they said. */
  readonly showings: readonly (readonly [number, string, Interest, string])[];
}
const SAMPLES: readonly Sample[] = [
  { name: "sample", listing: { ...SAMPLE, open_houses: [SAMPLE_OPEN_HOUSE] }, photos: SAMPLE_PHOTOS, headshot: SAMPLE_HEADSHOT, alt: ["Front of 412 Alder Lane with a covered porch", "Back garden with raised beds and a patio"] },
  { name: "sample", listing: { ...SAMPLE, open_houses: [SAMPLE_OPEN_HOUSE] }, photos: SAMPLE_PHOTOS, headshot: SAMPLE_HEADSHOT, alt: ["Front of 412 Alder Lane with a covered porch", "Back garden with raised beds and a patio"],
    showings: [
      [9, "Priya Nair, Larkspur Realty", "interested", "Loved the kitchen and the oak floors; wants a second look with her clients."],
      [5, "Tom Okafor, Eastside Homes", "maybe", "Garden is lovely; the one bathroom upstairs is tight for them."],
      [2, "Dana Whitcomb, Harbor & Pine", "offer_likely", "Second visit, measured the basement; expects to write an offer this week."],
    ],
  },
  {
    name: "sample-condo",
    listing: SAMPLE_CONDO,
    photos: ["sample-condo-front.svg", "sample-condo-living.svg"],
    headshot: "sample-agent-2.svg",
    alt: ["Building entrance with a glass lobby", "Living room with floor-to-ceiling windows"],
    showings: [
      [30, "Lena Brandt, Cascade Row", "interested", "Corner views won them over; asked about the HOA dues."],
      [21, "Marcus Hale, Puget Realty", "maybe", "Likes the rooftop; wants a second parking space."],
      [14, "", "offer_likely", "Walked it twice and asked for the disclosures."],
    ],
    // Sold, so the meeting sees the band, the pill and the "Just sold" post and email.
    sold_at: 752000,
  },
@@ -130,6 +144,10 @@
const SAMPLES: readonly Sample[] = [
    photos: ["sample-house-front.svg", "sample-house-yard.svg"],
    headshot: "sample-agent-3.svg",
    alt: ["Brick front with a two-car garage", "Fenced yard with a mature oak"],
    showings: [
      [6, "Ruth Castellano, Treasure Valley Homes", "maybe", "Big yard and the bonus room; concerned about the busy street."],
      [3, "Ian Moreau, Gem State Homes", "not_interested", "Wanted a smaller lot and a single-level plan."],
    ],
  },
];
@@ -169,6 +187,19 @@
export function seed(db: Database): void {
        .get(id)!;
      if (row.name !== null && row.open === 0) signOff(db, id, row.name);
    }
    // Each sample's showings are logged once, for samples planted before showings existed too.
    for (const s of SAMPLES) {
      const first = db.query("INSERT OR IGNORE INTO seeded (name) VALUES (?1)").run(`${s.name}-showings`);
      if (first.changes === 0) continue;
      const row = db
        .query<{ id: number }, [string]>("SELECT id FROM listing WHERE author_id = 'sample' AND address = ?1")
        .get(s.listing.address);
      if (row === null) continue;
      for (const [ago, agent, interest, feedback] of s.showings) {
        const date = dayOf(new Date(Date.now() - ago * 86_400_000));
        db.query("INSERT INTO showing (listing_id, date, agent, interest, feedback) VALUES (?1, ?2, ?3, ?4, ?5)").run(row.id, date, agent, interest, feedback);
      }
    }
    // A sample planted before statuses existed is marked sold once too; after that it is the owner's to change.
    for (const s of SAMPLES) {
      if (s.sold_at === undefined) continue;
@@ -60,7 +60,12 @@
test("a path is a resource's door by the contract's api, and nothing else is", (
    resource: "audit",
    verb: "list",
  });
  // What hangs off a row is changed as an update of that row; reading it is no door.
  expect(doorOf("POST", "/api/notes/7/x")).toEqual({ resource: "note", verb: "update" });
  expect(doorOf("DELETE", "/api/notes/7/x/3")).toEqual({ resource: "note", verb: "update" });
  for (const [method, path] of [
    ["POST", "/api/notes/7/"],
    ["POST", "/api/notes//x"],
    ["PUT", "/api/notes"],
    ["GET", "/api/notes/7/x"],
    ["GET", "/api/notesy"],
@@ -96,6 +96,9 @@
export function doorOf(
      const verb = ROW_VERB[method];
      return verb === undefined ? undefined : { resource, verb };
    }
    // Something that hangs off a row (its showings) is changed as an update of the row.
    if (rest?.includes("/") && !rest.startsWith("/") && !rest.endsWith("/") && (method === "POST" || method === "DELETE"))
      
        sentinelcrew
        9d ago
        
      
      New branch in doorOf: needs a test in contract/security tests, and the new doors need rows in src/contract.test.ts.
    
      return { resource, verb: "update" };
  }
  return undefined;
}
@@ -147,6 +147,7 @@
test("the MCP server lists the tools and calls them as the caller", async () =>
    "delete_note",
    "list_listings",
    "get_listing",
    "log_showing",
    "launch_kit",
    "launch_listing",
    "edit_asset",
@@ -0,0 +1,240 @@
/**
 * Showings: what the agent logged after each one. Validated at the boundary,
 * newest first, the listing's author alone, Fair Housing checked, and never on
 * the property page.
 */
import { expect, test } from "bun:test";
import { mkdtempSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { addShowing, approveAsset, deleteListing, getListing, launchListing, listListings, listShowings, removeShowing } from "./actions.ts";
import { openDb } from "./db.ts";
import { rpc } from "./mcp.ts";
import { home } from "./pages/home.ts";
import { listingPage } from "./pages/listing.ts";
import { propertyPage } from "./pages/property.ts";
import { SAMPLE, seed } from "./sample.ts";
import { dayOf } from "./showings.ts";
import type { Who } from "./who.ts";
const me: Who = { role: "user", id: "u1", name: "me" };
const other: Who = { role: "user", id: "u2", name: "other" };
const anon: Who = { role: "anon" };
const now = new Date("2027-03-10T12:00:00Z");
const launch = () => {
  const db = openDb(mkdtempSync(join(tmpdir(), "app-showings-")));
  const made = launchListing(db, me, { fields: SAMPLE });
  if (!made.ok) throw new Error(made.message);
  const id = made.value.id;
  for (const a of made.value.assets) approveAsset(db, me, { id, kind: a.kind, door: "page", seen: a.updated_at });
  return { db, id };
};
const shown = (db: ReturnType<typeof openDb>, id: number, who: Who = me) => {
  const r = listShowings(db, who, { id });
  if (!r.ok) throw new Error(r.message);
  return r.value;
};
test("add, newest first, remove", () => {
  const { db, id } = launch();
  const a = addShowing(db, me, { id, date: "2027-03-01", agent: "Pat", interest: "maybe", feedback: "Liked the yard.", now });
  addShowing(db, me, { id, date: "2027-03-05", interest: "offer_likely", feedback: "", now });
  addShowing(db, me, { id, date: "2027-03-05", agent: "Sam", interest: "interested", feedback: "Second look.", now });
  expect(shown(db, id).map((s) => [s.date, s.agent])).toEqual([["2027-03-05", "Sam"], ["2027-03-05", ""], ["2027-03-01", "Pat"]]);
  // A blank date is today.
  const today = addShowing(db, me, { id, interest: "maybe", feedback: "" });
  expect(today.ok).toBe(true);
  expect(shown(db, id).some((x) => x.date === dayOf(new Date()))).toBe(true);
  if (!a.ok) throw new Error(a.message);
  expect(removeShowing(db, me, { id, showing: a.value.showing }).ok).toBe(true);
  expect(shown(db, id).length).toBe(3);
  const again = removeShowing(db, me, { id, showing: a.value.showing });
  expect(!again.ok && again.error).toBe("not_found");
});
test("a future date, a long or hostile line, a bad interest are refused with the field named", () => {
  const { db, id } = launch();
  const base = { id, date: "2027-03-01", interest: "maybe", feedback: "ok", now };
  const refused: [Record<string, unknown>, string][] = [
    [{ date: "2027-03-11" }, "date"],
    [{ date: "2027-02-30" }, "date"],
    [{ date: "yesterday" }, "date"],
    [{ agent: "x".repeat(81) }, "agent"],
    [{ interest: "love it" }, "interest"],
    [{ interest: undefined }, "interest"],
    [{ feedback: "x".repeat(281) }, "feedback"],
    [{ feedback: "two\nlines" }, "feedback"],
    [{ feedback: "bell\u0007" }, "feedback"],
  ];
  for (const [change, field] of refused) {
    const r = addShowing(db, me, { ...base, ...change });
    expect(r.ok).toBe(false);
    expect(!r.ok && r.error).toBe("invalid");
    expect(!r.ok && r.field).toBe(field);
  }
  expect(shown(db, id)).toEqual([]);
  expect(addShowing(db, me, { ...base, feedback: "x".repeat(280), agent: "y".repeat(80) }).ok).toBe(true);
});
test("hostile text is stored as typed and shown escaped; Fair Housing findings sit beside it", () => {
  const { db, id } = launch();
  addShowing(db, me, { id, interest: "maybe", agent: "<img src=x onerror=alert(1)>", feedback: "<script>alert(1)</script> perfect for a young family" });
  const listing = getListing(db, me, { id });
  if (!listing.ok) throw new Error(listing.message);
  const logged = shown(db, id);
  expect(logged[0]!.check.findings.length).toBeGreaterThan(0);
  const html = listingPage({ who: me, listing: listing.value, editable: true, showings: logged });
  expect(html).toContain("&lt;script&gt;");
  expect(html).not.toContain("<script>alert(1)");
  expect(html).not.toContain("<img src=x");
  expect(html).toContain("fh-list");
  expect(html).toContain("Showings");
});
test("only the author (or an admin) logs, reads or removes; contract unchanged", () => {
  const { db, id } = launch();
  const mine = addShowing(db, me, { id, interest: "maybe", feedback: "" });
  if (!mine.ok) throw new Error(mine.message);
  for (const who of [anon, other]) {
    const add = addShowing(db, who, { id, interest: "maybe", feedback: "" });
    expect(add.ok).toBe(false);
    expect(!add.ok && ["signin_required", "forbidden", "not_found"].includes(add.error)).toBe(true);
    expect(listShowings(db, who, { id }).ok).toBe(false);
    expect(removeShowing(db, who, { id, showing: mine.value.showing }).ok).toBe(false);
  }
  expect(shown(db, id).length).toBe(1);
  expect(shown(db, id, { role: "admin", id: "a", name: "a" }).length).toBe(1);
});
test("not on the property page, and gone with the listing", () => {
  const { db, id } = launch();
  addShowing(db, me, { id, agent: "Hidden Agent", interest: "maybe", feedback: "secret feedback line" });
  const listing = getListing(db, anon, { id });
  if (!listing.ok) throw new Error(listing.message);
  const page = propertyPage({ who: anon, listing: listing.value });
  expect(page).not.toContain("Hidden Agent");
  expect(page).not.toContain("secret feedback");
  expect(page).not.toContain("Showings");
  expect(JSON.stringify(listing.value)).not.toContain("secret feedback");
  expect(deleteListing(db, me, { id }).ok).toBe(true);
  expect(db.query<{ n: number }, []>("SELECT count(*) AS n FROM showing").get()!.n).toBe(0);
});
test("the home list counts them for the author only", () => {
  const { db, id } = launch();
  for (let i = 0; i < 5; i++) addShowing(db, me, { id, interest: "maybe", feedback: "" });
  const count = (who: Who) => {
    const r = listListings(db, who, {});
    if (!r.ok) throw new Error(r.message);
    return r.value.find((l) => l.id === id)!.showings;
  };
  expect(count(me)).toBe(5);
  expect(count(other)).toBe(0);
  expect(count(anon)).toBe(0);
});
test("the MCP tool logs with the same validation", async () => {
  const { db, id } = launch();
  const call = async (args: Record<string, unknown>) =>
    JSON.stringify(await rpc(db, me, { jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "log_showing", arguments: args } }));
  expect(await call({ id, interest: "interested", feedback: "Loved it." })).not.toContain("isError\":true");
  expect(await call({ id, interest: "interested", date: "2999-01-01" })).toContain("future");
  expect(shown(db, id).length).toBe(1);
});
test("samples come with showings", () => {
  const db = openDb(mkdtempSync(join(tmpdir(), "app-showings-seed-")));
  seed(db);
  const per = db.query<{ n: number }, []>("SELECT count(*) AS n FROM showing GROUP BY listing_id").all();
  expect(per.length).toBe(3);
  for (const p of per) expect(p.n).toBeGreaterThanOrEqual(2);
  seed(db);
  expect(db.query<{ n: number }, []>("SELECT count(*) AS n FROM showing").get()!.n).toBe(per.reduce((a, p) => a + p.n, 0));
});
test("over HTTP: the form and the API log for the author, 422 names the field, strangers are refused", async () => {
  const { serve } = await import("./server.ts");
  const { sign } = await import("./who.ts");
  const KEY = "a-key-only-the-forge-holds";
  const server = serve({ port: 0, dataDir: mkdtempSync(join(tmpdir(), "app-showings-http-")), identityKey: KEY });
  try {
    const base = `http://${server.hostname}:${server.port}`;
    const as = (name: string) => {
      const identity = `${name}|${name}|user|${Date.now() + 600_000}`;
      return { "x-forge-identity": identity, "x-forge-signature": sign(identity, KEY), "content-type": "application/json" };
    };
    const made = (await (await fetch(`${base}/api/listings`, { method: "POST", headers: as("agent"), body: JSON.stringify(SAMPLE) })).json()) as { id: number };
    const url = `${base}/api/listings/${made.id}/showings`;
    const post = (who: Record<string, string>, body: unknown) => fetch(url, { method: "POST", headers: who, body: JSON.stringify(body) });
    const added = await post(as("agent"), { interest: "interested", feedback: "Loved it." });
    expect(added.status).toBe(201);
    const bad = await post(as("agent"), { interest: "interested", date: "2999-01-01" });
    expect(bad.status).toBe(422);
    expect(((await bad.json()) as { field: string }).field).toBe("date");
    expect((await post(as("intruder"), { interest: "maybe" })).status).toBeOneOf([403, 404]);
    expect((await post({ "content-type": "application/json" }, { interest: "maybe" })).status).toBeOneOf([401, 403]);
    const one = (await (await fetch(`${base}/api/listings/${made.id}`, { headers: as("agent") })).json()) as { showings: unknown[] };
    expect(one.showings.length).toBe(1);
    const theirs = (await (await fetch(`${base}/api/listings/${made.id}`, { headers: as("intruder") })).json()) as { showings?: unknown[] };
    expect(theirs.showings ?? []).toEqual([]);
    // The plain form post, no JavaScript.
    const { "content-type": _, ...bare } = as("agent");
    const form = await fetch(`${base}/listings/${made.id}/showings`, {
      method: "POST",
      headers: { ...bare, "content-type": "application/x-www-form-urlencoded" },
      body: "date=&agent=Pat&interest=maybe&feedback=Nice",
      redirect: "manual",
    });
    expect(form.status).toBe(303);
    expect(await (await fetch(`${base}/listings/${made.id}`, { headers: as("agent") })).text()).toContain("Nice");
  } finally {
    server.stop(true);
  }
});
test("the home page shows the pill: \"1 showing\", \"5 showings\", for the author alone", () => {
  const { db, id } = launch();
  const page = (who: Who) => {
    const r = listListings(db, who, {});
    if (!r.ok) throw new Error(r.message);
    return home({ who, listings: r.value, draft: {} as never });
  };
  expect(page(me)).not.toContain("showing</span>");
  addShowing(db, me, { id, interest: "maybe", feedback: "" });
  expect(page(me)).toContain(">1 showing</span>");
  for (let i = 0; i < 4; i++) addShowing(db, me, { id, interest: "maybe", feedback: "" });
  expect(page(me)).toContain(">5 showings</span>");
  expect(page(other)).not.toMatch(/\d showings?</);
  expect(page(anon)).not.toMatch(/\d showings?</);
});
test("over HTTP: another user's form delete and API delete are refused and remove nothing", async () => {
  const { serve } = await import("./server.ts");
  const { sign } = await import("./who.ts");
  const KEY = "a-key-only-the-forge-holds";
  const server = serve({ port: 0, dataDir: mkdtempSync(join(tmpdir(), "app-showings-del-")), identityKey: KEY });
  try {
    const base = `http://${server.hostname}:${server.port}`;
    const as = (name: string) => {
      const identity = `${name}|${name}|user|${Date.now() + 600_000}`;
      return { "x-forge-identity": identity, "x-forge-signature": sign(identity, KEY), "content-type": "application/json" };
    };
    const made = (await (await fetch(`${base}/api/listings`, { method: "POST", headers: as("agent"), body: JSON.stringify(SAMPLE) })).json()) as { id: number };
    const logged = (await (await fetch(`${base}/api/listings/${made.id}/showings`, { method: "POST", headers: as("agent"), body: JSON.stringify({ interest: "maybe" }) })).json()) as { showing: number };
    const apiUrl = `${base}/api/listings/${made.id}/showings/${logged.showing}`;
    const formUrl = `${base}/listings/${made.id}/showings/${logged.showing}/delete`;
    expect((await fetch(apiUrl, { method: "DELETE", headers: as("intruder") })).status).toBeOneOf([403, 404]);
    expect((await fetch(apiUrl, { method: "DELETE", headers: { "content-type": "application/json" } })).status).toBeOneOf([401, 403]);
    const formAs = (name: string) => ({ ...as(name), "content-type": "application/x-www-form-urlencoded" });
    const refused = await fetch(formUrl, { method: "POST", headers: formAs("intruder"), body: "", redirect: "manual" });
    const page = refused.status === 303 ? await (await fetch(`${base}/listings/${made.id}`, { headers: as("intruder") })).text() : "";
    expect([303, 403, 404]).toContain(refused.status);
    expect(page).not.toContain("Showing removed.");
    const still = (await (await fetch(`${base}/api/listings/${made.id}`, { headers: as("agent") })).json()) as { showings: unknown[] };
    expect(still.showings.length).toBe(1);
    expect((await fetch(apiUrl, { method: "DELETE", headers: as("agent") })).status).toBe(200);
  } finally {
    server.stop(true);
  }
});
@@ -0,0 +1,62 @@
/**
 * A showing the agent logged: the day, the buyer's agent, how interested the
 * buyers were and one line of what they said. Plain data in, plain data out;
 * the boundary is `validShowing`, the rows live in `showing` (src/db.ts).
 * They hold third-party names, so they belong to the agent's page alone.
 */
export const SHOWING_AGENT_MAX = 80;
export const SHOWING_FEEDBACK_MAX = 280;
export const SHOWINGS_MAX = 500;
export const INTERESTS = ["not_interested", "maybe", "interested", "offer_likely"] as const;
export type Interest = (typeof INTERESTS)[number];
export const INTEREST_LABELS: Readonly<Record<Interest, string>> = {
  not_interested: "Not interested",
  maybe: "Maybe",
  interested: "Interested",
  offer_likely: "Offer likely",
};
export interface Showing {
  readonly id: number;
  readonly date: string;
  readonly agent: string;
  readonly interest: Interest;
  readonly feedback: string;
}
type Checked = { ok: true; value: Omit<Showing, "id"> } | { ok: false; field: string; message: string };
const CONTROL = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
/** The day as YYYY-MM-DD, in UTC, the way the clock reads it. */
export const dayOf = (now: Date): string => now.toISOString().slice(0, 10);
const realDay = (s: string): boolean => {
  if (!/^\d{4}-\d{2}-\d{2}$/.test(s)) return false;
  const d = new Date(`${s}T00:00:00Z`);
  return !Number.isNaN(d.getTime()) && dayOf(d) === s;
};
export function validShowing(
  raw: { date?: unknown; agent?: unknown; interest?: unknown; feedback?: unknown },
  now: Date = new Date(),
): Checked {
  const text = (v: unknown): string => (typeof v === "string" ? v.trim() : v === undefined || v === null ? "" : String(v));
  const today = dayOf(now);
  const date = text(raw.date) === "" ? today : text(raw.date);
  if (!realDay(date)) return { ok: false, field: "date", message: "The date looks like 2027-03-07." };
  if (date > today) return { ok: false, field: "date", message: "A showing cannot be in the future." };
  const agent = text(raw.agent);
  if (CONTROL.test(agent) || agent.length > SHOWING_AGENT_MAX)
    return { ok: false, field: "agent", message: `The buyer's agent is up to ${SHOWING_AGENT_MAX} characters, plain text.` };
  const interest = text(raw.interest);
  if (!(INTERESTS as readonly string[]).includes(interest))
    return { ok: false, field: "interest", message: "Interest is not_interested, maybe, interested or offer_likely." };
  const feedback = text(raw.feedback);
  if (CONTROL.test(feedback) || feedback.length > SHOWING_FEEDBACK_MAX)
    return { ok: false, field: "feedback", message: `The feedback is one line of up to ${SHOWING_FEEDBACK_MAX} characters, plain text.` };
  return { ok: true, value: { date, agent, interest: interest as Interest, feedback } };
}
@@ -425,3 +425,43 @@
test("the seller update is the last asset: it reads as a draft, and a approves i
  tty.press("a");
  expect(plain(tty.screen())).toContain("Approval withdrawn.");
});
test("S lists, logs and removes showings, for the agent only, and the page hears it", async () => {
  const { launchListing, listShowings } = await import("./actions.ts");
  const db = openDb(mkdtempSync(join(tmpdir(), "app-tty-showings-")));
  const made = launchListing(db, me, { fields: SAMPLE });
  if (!made.ok) throw new Error(made.message);
  const id = made.value.id;
  const changes = (): number => db.query<{ n: number }, []>("SELECT count(*) AS n FROM event WHERE type = 'listing.changed'").get()!.n;
  const before = changes();
  const tty = session(db, me);
  tty.press("\r");
  tty.press("S");
  expect(plain(tty.screen())).toContain("None yet.");
  tty.press("a");
  for (const key of "; Pat Lee; offer likely; Loved the kitchen, perfect for a young family") tty.press(key);
  tty.press("\r");
  expect(plain(tty.screen())).toContain("Logged.");
  tty.press(" ");
  const shown = plain(tty.screen());
  expect(shown).toContain("Offer likely · Pat Lee");
  expect(shown).toContain("Loved the kitchen");
  expect(shown).toContain("!");
  tty.press("a");
  for (const key of "; ; maybe; "+"x".repeat(300)) tty.press(key);
  tty.press("\r");
  expect(plain(tty.screen())).toContain("plain text");
  tty.press(" ");
  tty.press("d");
  expect(plain(tty.screen())).toContain("Removed.");
  const left = listShowings(db, me, { id });
  expect(left.ok && left.value).toEqual([]);
  expect(changes() - before).toBe(2);
  for (const who of [other, { role: "anon" } as Who]) {
    const t = session(db, who);
    t.press("\r");
    t.press("S");
    t.press("a");
    expect(plain(t.screen())).not.toContain("Showing: date");
  }
});
@@ -15,7 +15,9 @@
 *   one as `Name, email`, d removes the one under the cursor, esc goes back; k shows
 *   the launch kit, the file the page offers to download; R shows the seller
 *   report, approved words only, as the page prints it; w shows the launch week,
 *   which asset goes out on which day, a draft marked and never as going out.
 *   which asset goes out on which day, a draft marked and never as going out; S lists
 *   the showings logged (the listing's agent or an admin; a guest sees none): a logs one as
 *   `date; buyer's agent; interest; what they said`, d removes the one under the cursor.
 * - notes: a adds, d removes.
 *
 * j/k move, q leaves. Launching, with its photos, is the page's. Plain ANSI,
@@ -24,9 +26,11 @@
 */
import type { Database } from "bun:sqlite";
import { INTEREST_LABELS } from "./showings.ts";
import { FILTERS, parseFind, type Find } from "./find.ts";
import {
  addNote,
  addShowing,
  addVisitor,
  approveAsset,
  canDelete,
@@ -38,8 +42,10 @@
import {
  getListing,
  listListings,
  listNotes,
  listShowings,
  listVisitors,
  listVersions,
  removeShowing,
  removeVisitor,
  restoreAsset,
  retoneListing,
@@ -105,7 +111,7 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
  /** The email blast or the open house follow-up, laid out as the page's preview is, instead of the assets. */
  let previewing: "email" | "email_followup" | "email_reminder" | undefined;
  /** The sign-in visitors of the open house, the cursor on one. */
  let visiting = false;
  let visiting: "visitors" | "showings" | false = false;
  let visitorCursor = 0;
  /** The launch kit, as the file would read. */
  let kitting = false;
@@ -117,7 +123,7 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
  let versioning: Kind | undefined;
  let cursor = 0;
  /** What the one-line input is for: a new note, or an asset's new words. */
  let typing: { for: "note" } | { for: "asset"; kind: Kind } | { for: "open" } | { for: "status" } | { for: "price" } | { for: "search" } | { for: "visitor" } | undefined;
  let typing: { for: "note" } | { for: "asset"; kind: Kind } | { for: "open" } | { for: "status" } | { for: "price" } | { for: "search" } | { for: "visitor" } | { for: "showing" } | undefined;
  let typed = "";
  /** The filter and the words the listings view is narrowed to. */
  let found: Find = { status: "all", q: "" };
@@ -159,6 +165,18 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
        ...(list.length === 0 ? [dim("None yet.")] : list.map((v, i) => `${i + 1}) ${dim(`${v.at.slice(0, 16).replace("T", " ")} · ${scrub(v.by_name)} · ${v.why}`)}  ${scrub(v.text.split("\n")[0] ?? "").slice(0, 60)}`)),
      ];
    }
    if (visiting === "showings") {
      const logged = listShowings(db, me, { id: l.id });
      if (!logged.ok) return [logged.message];
      return [
        bold(`Showings (${logged.value.length}): ${l.address}`), "",
        ...(logged.value.length === 0 ? [dim("None yet. Press a to log one.")] : logged.value.flatMap((x, i) => [
          `${i === visitorCursor ? "▸" : " "} ${i === visitorCursor ? bold(x.date) : x.date}  ${INTEREST_LABELS[x.interest]}${x.agent === "" ? "" : dim(` · ${scrub(x.agent)}`)}`,
          ...(x.feedback === "" ? [] : [`    ${scrub(x.feedback)}`]),
          ...x.check.findings.map((f) => amber(`    ! ${f.line}`)),
        ])),
      ];
    }
    if (visiting) {
      const sheet = visitors(l.id);
      if (!sheet.ok) return [sheet.message];
@@ -208,7 +226,8 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
    if (reading !== undefined) {
      lines.push(...readLines());
      const found = open();
      if (visiting) help = "j/k move · a add (Name, email) · d remove · esc back to the assets · q quit";
      if (visiting === "showings") help = "j/k move · a log one · d remove · esc back to the assets · q quit";
      else if (visiting) help = "j/k move · a add (Name, email) · d remove · esc back to the assets · q quit";
      else if (previewing || kitting || reporting || planning) help = "esc back to the assets · q quit";
      else if (versioning !== undefined) help = "1-5 put that version back · esc back to the assets · q quit";
      else help =
@@ -247,7 +266,7 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
    }
    lines.push("");
    if (typing !== undefined) {
      const label = typing.for === "note" ? "New note" : typing.for === "visitor" ? "Visitor: name, email (enter adds, esc drops)" : typing.for === "search" ? "Search by address (enter searches, empty clears, esc drops)" : typing.for === "price" ? "Price in whole dollars, like 849000; a lower price adds a price improvement post and email (enter saves, esc drops)" : typing.for === "status" ? "Status: coming soon, active, under contract, withdrawn, expired, or sold with an optional price, like sold 752000 (enter saves, esc drops)" : typing.for === "open" ? "Open house: date start-end, like 2027-03-09 13:00-15:00; separate two with ; (empty clears, enter saves, esc drops)" : `Edit (\\n breaks a line, enter saves, esc drops)`;
      const label = typing.for === "note" ? "New note" : typing.for === "showing" ? "Showing: date; buyer's agent; interest; what they said. Date may be empty for today; interest is not interested, maybe, interested or offer likely (enter logs, esc drops)" : typing.for === "visitor" ? "Visitor: name, email (enter adds, esc drops)" : typing.for === "search" ? "Search by address (enter searches, empty clears, esc drops)" : typing.for === "price" ? "Price in whole dollars, like 849000; a lower price adds a price improvement post and email (enter saves, esc drops)" : typing.for === "status" ? "Status: coming soon, active, under contract, withdrawn, expired, or sold with an optional price, like sold 752000 (enter saves, esc drops)" : typing.for === "open" ? "Open house: date start-end, like 2027-03-09 13:00-15:00; separate two with ; (empty clears, enter saves, esc drops)" : `Edit (\\n breaks a line, enter saves, esc drops)`;
      // The tail of what is typed, so the cursor stays on the screen.
      const room = Math.max(20, size.columns - 4);
      lines.push(dim(label), `${typed.length > room ? `…${typed.slice(-room + 1)}` : typed}${esc}7m ${esc}0m`);
@@ -267,6 +286,10 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
        const at = typed.lastIndexOf(",");
        const done = addVisitor(db, me, { id: reading!, name: at < 0 ? typed : typed.slice(0, at), email: at < 0 ? "" : typed.slice(at + 1) });
        said = done.ok ? "Added." : done.message;
      } else if (typing.for === "showing") {
        const [date, agent, interest, ...rest] = typed.split(";").map((x) => x.trim());
        const done = addShowing(db, me, { id: reading!, date, agent, interest: (interest ?? "").toLowerCase().replace(/\s+/g, "_"), feedback: rest.join(";").trim() });
        said = done.ok ? "Logged." : done.message;
      } else if (typing.for === "search") {
        found = parseFind(found.status, typed);
        cursor = 0;
@@ -325,10 +348,39 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
        return undefined;
      }
      if (key === "V" && idle && found?.ok === true) {
        visiting = true;
        visiting = "visitors";
        visitorCursor = 0;
        return undefined;
      }
      if (key === "S" && idle && found?.ok === true) {
        visiting = "showings";
        visitorCursor = 0;
        return undefined;
      }
      if (visiting === "showings" && found?.ok === true && key !== "\x1b") {
        const logged = listShowings(db, me, { id: found.value.id });
        const rows = logged.ok ? logged.value : [];
        if (down) visitorCursor = Math.min(visitorCursor + 1, Math.max(0, rows.length - 1));
        if (up) visitorCursor = Math.max(visitorCursor - 1, 0);
        if (key === "a") {
          if (!logged.ok) said = logged.message;
          else {
            typing = { for: "showing" };
            typed = "";
          }
        }
        if (key === "d") {
          const row = rows[visitorCursor];
          if (!logged.ok) said = logged.message;
          else if (row === undefined) said = "Nothing to remove.";
          else {
            const done = removeShowing(db, me, { id: found.value.id, showing: row.id });
            said = done.ok ? "Removed." : done.message;
            visitorCursor = Math.min(visitorCursor, Math.max(0, rows.length - 2));
          }
        }
        return undefined;
      }
      if (visiting && found?.ok === true && key !== "\x1b") {
        const sheet = visitors(found.value.id);
        const rows = sheet.ok ? sheet.value : [];
@@ -383,7 +435,8 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
      if (key === "\x1b") {
        if (previewing || kitting || reporting || planning || visiting) {
          previewing = undefined;
          kitting = reporting = planning = visiting = false;
          kitting = reporting = planning = false;
          visiting = false;
        } else {
          reading = undefined;
          cursor = 0;
		@@ -269,6 +269,18 @@ list cannot drift from the app.
269	269	Print it, or save it as a PDF. "Rewrite all" writes every asset again in
270	270	another tone (your edits are replaced, so it asks with a tooltip first).
271	271
	272	Showings. After each showing, write it down on the listing page: the day
	273	(today unless you change it; never a future one), the buyer's agent if you
	274	know them, how interested they were (Not interested, Maybe, Interested, Offer
	275	likely) and one line of what they said. It is a plain form, newest first, and
	276	"Remove" takes one back out. When the seller asks "how is it showing?", the
	277	log answers, and the home list shows "5 showings" beside the listing. The
	278	feedback gets the same Fair Housing check as anything you type, with the
	279	finding beside the line. Only you (or an admin) see the log: buyer's agents'
	280	names stay off the property page, the email and the flyer, and go when the
	281	listing does. Assistants can add one too (`POST /api/listings/:id/showings`,
	282	or `log_showing` over MCP); a refused field is named in the 422.
	283
272	284	Three sample listings are there from the start so the screen is
273	285	never empty; "Start a new one from this" copies any listing into the form.
274	286
		@@ -332,6 +344,7 @@ decide nothing themselves. `AGENTS.md` says how to add to it.
332	344	\| `src/fairhousing.ts` \| the Fair Housing rules: phrase, context, class, reason, rewrite \|
333	345	\| `src/photos.ts` \| photos as files beside the database, known by their bytes \|
334	346	\| `src/sample.ts` \| the sample listing, planted once \|
	347	\| `src/showings.ts` \| the showings the agent logged: the boundary for a day, a buyer's agent, an interest and a line \|
335	348	\| `src/visitors.ts` \| the open house sign-in sheet's visitors: the boundary for a name and an email \|
336	349	\| `contract.json` \| who may do what: roles, and the least role each verb needs \|
337	350	\| `src/contract.ts`, `src/can.ts` \| the table, read at boot; the forge's evaluator, verbatim \|
		@@ -445,7 +458,7 @@ listing with `enter` to read every asset with its Fair Housing findings;
445	458	`j`/`k` move between assets, `e` edits the one under the cursor (type `\n`
446	459	for a line break, `enter` saves and checks it again), `t` rewrites them all
447	460	in the next tone, `s` sets the status (`sold 752000`, `under contract`, `coming soon`,
448		`withdrawn`, `expired`, `active`), `p` previews the email as the client reads it, `P` the open house follow-up with the sign-in visitors it would go to, `V` lists those visitors (`a` adds one as `Name, email`, `d` removes the one under the cursor; only the listing's agent or an admin, a guest sees none), `x` removes a listing of your own. `tab` switches to the notes. Launching a listing, with its photos, is the page's alone.
	461	`withdrawn`, `expired`, `active`), `p` previews the email as the client reads it, `P` the open house follow-up with the sign-in visitors it would go to, `V` lists those visitors (`a` adds one as `Name, email`, `d` removes the one under the cursor; only the listing's agent or an admin, a guest sees none), `S` lists the showings you logged (`a` logs one as `date; buyer's agent; interest; what they said`, with the date empty for today and the interest as not interested, maybe, interested or offer likely; `d` removes the one under the cursor; only the listing's agent or an admin, a guest sees none), `x` removes a listing of your own. `tab` switches to the notes. Launching a listing, with its photos, is the page's alone.
449	462
450	463	No runtime dependencies: Bun's own `bun:sqlite`, `Bun.serve` and `node:`
451	464	modules. The typefaces are the system's (a Palatino/Iowan serif for
		@@ -577,7 +577,7 @@
577	577	},
578	578	"/api/listings/{id}": {
579	579	"get": {
580		"summary": "One listing, with its assets and each one's Fair Housing check.",
	580	"summary": "One listing, with its assets and each one's Fair Housing check; for the listing's agent or an admin, also its logged showings, newest first.",
581	581	"operationId": "getApiListingsId",
582	582	"parameters": [
583	583	{
		@@ -591,7 +591,7 @@
591	591	],
592	592	"responses": {
593	593	"200": {
594		"description": "One listing, with its assets and each one's Fair Housing check.",
	594	"description": "One listing, with its assets and each one's Fair Housing check; for the listing's agent or an admin, also its logged showings, newest first.",
595	595	"content": {
596	596	"application/json": {
597	597	"schema": {
		@@ -921,6 +921,157 @@
921	921	}
922	922	}
923	923	},
	924	"/api/listings/{id}/showings": {
	925	"post": {
	926	"summary": "Log a showing: the day, the buyer's agent, how interested they were and one line of feedback. Only the listing's agent or an admin; a refused field is named in the 422.",
	927	"operationId": "postApiListingsIdShowings",
	928	"parameters": [
	929	{
	930	"name": "id",
	931	"in": "path",
	932	"required": true,
	933	"schema": {
	934	"type": "integer"
	935	}
	936	}
	937	],
	938	"requestBody": {
	939	"required": true,
	940	"content": {
	941	"application/json": {
	942	"schema": {
	943	"type": "object",
	944	"properties": {
	945	"date": {
	946	"type": "string",
	947	"description": "YYYY-MM-DD, not in the future; today when left out."
	948	},
	949	"agent": {
	950	"type": "string",
	951	"maxLength": 80,
	952	"description": "The buyer's agent, optional."
	953	},
	954	"interest": {
	955	"enum": [
	956	"not_interested",
	957	"maybe",
	958	"interested",
	959	"offer_likely"
	960	]
	961	},
	962	"feedback": {
	963	"type": "string",
	964	"maxLength": 280,
	965	"description": "One line, plain text."
	966	}
	967	},
	968	"required": [
	969	"interest"
	970	]
	971	}
	972	}
	973	}
	974	},
	975	"responses": {
	976	"201": {
	977	"description": "Log a showing: the day, the buyer's agent, how interested they were and one line of feedback. Only the listing's agent or an admin; a refused field is named in the 422.",
	978	"content": {
	979	"application/json": {
	980	"schema": {
	981	"type": "object",
	982	"properties": {
	983	"id": {
	984	"type": "integer"
	985	},
	986	"showing": {
	987	"type": "integer"
	988	}
	989	},
	990	"required": [
	991	"id",
	992	"showing"
	993	]
	994	}
	995	}
	996	}
	997	},
	998	"default": {
	999	"description": "{ error, message }: why not",
	1000	"content": {
	1001	"application/json": {
	1002	"schema": {
	1003	"$ref": "#/components/schemas/Error"
	1004	}
	1005	}
	1006	}
	1007	}
	1008	},
	1009	"x-contract": {
	1010	"resource": "listing",
	1011	"verb": "update",
	1012	"least": "author"
	1013	}
	1014	}
	1015	},
	1016	"/api/listings/{id}/showings/{showing}": {
	1017	"delete": {
	1018	"summary": "Remove a showing the agent logged.",
	1019	"operationId": "deleteApiListingsIdShowingsShowing",
	1020	"parameters": [
	1021	{
	1022	"name": "id",
	1023	"in": "path",
	1024	"required": true,
	1025	"schema": {
	1026	"type": "integer"
	1027	}
	1028	},
	1029	{
	1030	"name": "showing",
	1031	"in": "path",
	1032	"required": true,
	1033	"schema": {
	1034	"type": "integer"
	1035	}
	1036	}
	1037	],
	1038	"responses": {
	1039	"200": {
	1040	"description": "Remove a showing the agent logged.",
	1041	"content": {
	1042	"application/json": {
	1043	"schema": {
	1044	"type": "object",
	1045	"properties": {
	1046	"id": {
	1047	"type": "integer"
	1048	}
	1049	},
	1050	"required": [
	1051	"id"
	1052	]
	1053	}
	1054	}
	1055	}
	1056	},
	1057	"default": {
	1058	"description": "{ error, message }: why not",
	1059	"content": {
	1060	"application/json": {
	1061	"schema": {
	1062	"$ref": "#/components/schemas/Error"
	1063	}
	1064	}
	1065	}
	1066	}
	1067	},
	1068	"x-contract": {
	1069	"resource": "listing",
	1070	"verb": "update",
	1071	"least": "author"
	1072	}
	1073	}
	1074	},
924	1075	"/api/audit": {
925	1076	"get": {
926	1077	"summary": "The audit trail, newest first; `before` pages back by id.",
		@@ -1329,6 +1480,50 @@
1329	1480	"type": "string",
1330	1481	"format": "date-time"
1331	1482	},
	1483	"showings": {
	1484	"type": "array",
	1485	"description": "The logged showings, newest first; only for the listing's agent or an admin.",
	1486	"items": {
	1487	"type": "object",
	1488	"properties": {
	1489	"id": {
	1490	"type": "integer"
	1491	},
	1492	"date": {
	1493	"type": "string",
	1494	"description": "YYYY-MM-DD."
	1495	},
	1496	"agent": {
	1497	"type": "string",
	1498	"maxLength": 80
	1499	},
	1500	"interest": {
	1501	"enum": [
	1502	"not_interested",
	1503	"maybe",
	1504	"interested",
	1505	"offer_likely"
	1506	]
	1507	},
	1508	"feedback": {
	1509	"type": "string",
	1510	"maxLength": 280
	1511	},
	1512	"check": {
	1513	"type": "object",
	1514	"description": "The Fair Housing check on the feedback."
	1515	}
	1516	},
	1517	"required": [
	1518	"id",
	1519	"date",
	1520	"agent",
	1521	"interest",
	1522	"feedback",
	1523	"check"
	1524	]
	1525	}
	1526	},
1332	1527	"assets": {
1333	1528	"type": "array",
1334	1529	"items": {
		@@ -1677,6 +1872,10 @@
1677	1872	"type": "integer",
1678	1873	"description": "Phrases the Fair Housing check flags across every asset."
1679	1874	},
	1875	"showings": {
	1876	"type": "integer",
	1877	"description": "How many showings the agent logged; 0 for anyone who may not update the listing."
	1878	},
1680	1879	"approvals": {
1681	1880	"type": "array",
1682	1881	"description": "Each asset and whether somebody has signed off its words.",
		@@ -1740,7 +1939,8 @@
1740	1939	"created_at",
1741	1940	"updated_at",
1742	1941	"flags",
1743		"approvals"
	1942	"approvals",
	1943	"showings"
1744	1944	]
1745	1945	},
1746	1946	"AuditRow": {
		@@ -50,6 +50,7 @@ import {
50	50	} from "./photos.ts";
51	51	import { headshotFrom } from "./agent.ts";
52	52	import { sellerUpdate } from "./update.ts";
	53	import { validShowing, SHOWINGS_MAX, type Showing } from "./showings.ts";
53	54	import { validVisitor, VISITORS_MAX, type Visitor } from "./visitors.ts";
54	55	import type { Who } from "./who.ts";
55	56
		@@ -72,12 +73,13 @@ export type Failure =
72	73	\| "duplicate_address";
73	74	export type Result<T> =
74	75	\| { ok: true; value: T }
75		\| { ok: false; error: Failure; message: string; existing?: Earlier };
	76	\| { ok: false; error: Failure; message: string; existing?: Earlier; field?: string };
76	77	const ok = <T>(value: T): Result<T> => ({ ok: true, value });
77		const fail = <T>(error: Failure, message: string): Result<T> => ({
	78	const fail = <T>(error: Failure, message: string, field?: string): Result<T> => ({
78	79	ok: false,
79	80	error,
80	81	message,
	82	...(field === undefined ? {} : { field }),
81	83	});
82	84
83	85	export const BODY_MAX = 500;
		@@ -551,6 +553,8 @@ export function markStatus(
551	553	export type ListingSummary = Listing & {
552	554	flags: number;
553	555	approvals: { kind: string; approved: boolean }[];
	556	/** How many showings the agent logged; counted only for whoever may update the listing, else 0. */
	557	showings: number;
554	558	};
555	559
556	560	export function listListings(
		@@ -583,6 +587,7 @@ export function listListings(
583	587	const bodies = db.query<{ kind: string; body: string; approved_at: string \| null }, [number]>(
584	588	"SELECT kind, body, approved_at FROM asset WHERE listing_id = ?1 ORDER BY rowid",
585	589	);
	590	const logged = db.query<{ n: number }, [number]>("SELECT count(*) AS n FROM showing WHERE listing_id = ?1");
586	591	return ok(
587	592	rows
588	593	.filter((row) => matchesText(row, wanted.q))
		@@ -590,6 +595,7 @@ export function listListings(
590	595	const assets = bodies.all(row.id);
591	596	return {
592	597	...fromRow(row),
	598	showings: permit(who, "listing", "update", row) === "yes" ? logged.get(row.id)!.n : 0,
593	599	flags: assets.reduce((n, a) => n + check(a.body).findings.length, 0),
594	600	approvals: assets.map((a) => ({ kind: a.kind, approved: a.approved_at !== null })),
595	601	};
		@@ -1354,6 +1360,67 @@ function dropVisitor(db: Database, who: Who, input: { id: number; visitor: numbe
1354	1360	return ok({ id: found.value.id });
1355	1361	}
1356	1362
	1363	/*
	1364	* Showings. After each one the agent writes down who came and what they said.
	1365	* Third-party names: read and changed only through the listing's update door
	1366	* (its author or an admin), never with the listing, and never on the public
	1367	* property page, the email or the flyer.
	1368	*/
	1369
	1370	/** A logged showing with the Fair Housing check run on its feedback, as typed words are. */
	1371	export type LoggedShowing = Showing & { check: Check };
	1372
	1373	const showingsFor = (db: Database, who: Who, id: number, signIn: string): Result<Launched> =>
	1374	listingFor(db, who, "update", id, { signIn, no: "Only the listing's agent or an admin can see the showings." });
	1375
	1376	export function listShowings(db: Database, who: Who, input: { id: number }): Result<LoggedShowing[]> {
	1377	const found = showingsFor(db, who, input.id, "Sign in to see the showings.");
	1378	if (!found.ok) return found;
	1379	return ok(
	1380	db
	1381	.query<Showing, [number]>("SELECT id, date, agent, interest, feedback FROM showing WHERE listing_id = ?1 ORDER BY date DESC, id DESC")
	1382	.all(found.value.id)
	1383	.map((s) => ({ ...s, check: check(s.feedback) })),
	1384	);
	1385	}
	1386
	1387	type ShowingInput = { id: number; date?: unknown; agent?: unknown; interest?: unknown; feedback?: unknown; now?: Date };
	1388
	1389	export const addShowing = (db: Database, who: Who, input: ShowingInput): Result<{ id: number; showing: number }> =>
	1390	audited(db, who, "listing", "update", input.id, putShowing(db, who, input));
	1391
	1392	function putShowing(db: Database, who: Who, input: ShowingInput): Result<{ id: number; showing: number }> {
	1393	const found = showingsFor(db, who, input.id, "Sign in to log a showing.");
	1394	if (!found.ok) return found;
	1395	const valid = validShowing(input, input.now);
	1396	if (!valid.ok) return fail("invalid", valid.message, valid.field);
	1397	const have = db.query<{ n: number }, [number]>("SELECT count(*) AS n FROM showing WHERE listing_id = ?1").get(found.value.id)!.n;
	1398	if (have >= SHOWINGS_MAX) return fail("invalid", `At most ${SHOWINGS_MAX} showings on one listing.`);
	1399	const v = valid.value;
	1400	const row = db
	1401	.query<{ id: number }, [number, string, string, string, string]>(
	1402	"INSERT INTO showing (listing_id, date, agent, interest, feedback) VALUES (?1, ?2, ?3, ?4, ?5) RETURNING id",
	1403	)
	1404	.get(found.value.id, v.date, v.agent, v.interest, v.feedback)!;
	1405	emit(db, "listing.changed", { id: found.value.id });
	1406	return ok({ id: found.value.id, showing: row.id });
	1407	}
	1408
	1409	export const removeShowing = (db: Database, who: Who, input: { id: number; showing: number }): Result<{ id: number }> =>
	1410	audited(db, who, "listing", "update", input.id, dropShowing(db, who, input));
	1411
	1412	function dropShowing(db: Database, who: Who, input: { id: number; showing: number }): Result<{ id: number }> {
	1413	const found = showingsFor(db, who, input.id, "Sign in to remove a showing.");
	1414	if (!found.ok) return found;
	1415	const gone = db.query("DELETE FROM showing WHERE id = ?1 AND listing_id = ?2").run(
	1416	Number.isInteger(input.showing) ? input.showing : -1,
	1417	found.value.id,
	1418	);
	1419	if (gone.changes === 0) return fail("not_found", "No such showing.");
	1420	emit(db, "listing.changed", { id: found.value.id });
	1421	return ok({ id: found.value.id });
	1422	}
	1423
1357	1424	/** The Fair Housing check on any words: no row, no door, nothing kept. */
1358	1425	export const checkWords = (text: string): Check =>
1359	1426	check(text.slice(0, ASSET_MAX));
		@@ -20,6 +20,9 @@ import {
20	20	getNote,
21	21	insertListing,
22	22	launchListing,
	23	addShowing,
	24	listShowings,
	25	removeShowing,
23	26	listVersions,
24	27	restoreAsset,
25	28	updatePhotos,
		@@ -312,3 +315,37 @@ test("restoring an earlier version answers as the listing's update cell says, at
312	315	}
313	316	expect(asked).toBeGreaterThan(0);
314	317	});
	318
	319	/** Showings are `listing:update`: the actions and the tool let through exactly whom the table's update cell does. */
	320	test("logging, listing and removing a showing answers as the listing's update cell says, at the actions and the tool", () => {
	321	const root = { role: "admin" as const, id: "root", name: "root" };
	322	let asked = 0;
	323	for (const cell of table(contract)) {
	324	if (cell.resource !== "listing" \|\| cell.verb !== "update") continue;
	325	const who = whoIs(cell.as);
	326	const { mine, theirs } = actingAs(contract, cell.as);
	327	const attempts = (authorId: string) => {
	328	const id = listingBy(authorId);
	329	const planted = addShowing(db, root, { id, interest: "maybe" });
	330	const showing = planted.ok ? planted.value.showing : -1;
	331	const tool = !JSON.stringify(
	332	rpc(db, who, { jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "log_showing", arguments: { id, interest: "maybe" } } }).body,
	333	).includes('"isError":true');
	334	return [
	335	addShowing(db, who, { id, interest: "maybe" }).ok,
	336	tool,
	337	listShowings(db, who, { id }).ok,
	338	removeShowing(db, who, { id, showing }).ok,
	339	];
	340	};
	341	const onMine = attempts(String(mine["author_id"]));
	342	const onTheirs = attempts(String(theirs["author_id"]));
	343	const said = `showings as ${cell.as}`;
	344	asked++;
	345	const all = (v: boolean) => [v, v, v, v];
	346	if (cell.answer === "yes") expect([said, onMine, onTheirs]).toEqual([said, all(true), all(true)]);
	347	else if (cell.answer === "no") expect([said, onMine, onTheirs]).toEqual([said, all(false), all(false)]);
	348	else expect([said, onMine, onTheirs]).toEqual([said, all(true), all(false)]);
	349	}
	350	expect(asked).toBeGreaterThan(0);
	351	});
		@@ -224,6 +224,18 @@ export const migrations: string[] = [
224	224	DROP TABLE asset_version_old;
225	225	DROP TABLE asset_old;
226	226	DROP TABLE listing_old;`,
	227	// Each showing the agent logged: the day, the buyer's agent, how interested, one line of feedback. Third-party
	228	// names, read only through the listing's update door, never with the listing. They go with their listing.
	229	`CREATE TABLE IF NOT EXISTS showing (
	230	id INTEGER PRIMARY KEY,
	231	listing_id INTEGER NOT NULL REFERENCES listing (id) ON DELETE CASCADE,
	232	date TEXT NOT NULL CHECK (length(date) = 10),
	233	agent TEXT NOT NULL CHECK (length(agent) <= 80),
	234	interest TEXT NOT NULL CHECK (interest IN ('not_interested', 'maybe', 'interested', 'offer_likely')),
	235	feedback TEXT NOT NULL CHECK (length(feedback) <= 280),
	236	created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
	237	);
	238	CREATE INDEX IF NOT EXISTS showing_listing ON showing (listing_id, date, id)`,
227	239	];
228	240
229	241	export function openDb(dir = dataDir): Database {
		@@ -9,6 +9,7 @@
9	9	import type { Database } from "bun:sqlite";
10	10	import { FILTERS, Q_MAX } from "./find.ts";
11	11	import {
	12	addShowing,
12	13	addNote,
13	14	approveAsset,
14	15	checkWords,
		@@ -29,6 +30,7 @@ import {
29	30	updatePhotos,
30	31	type Result,
31	32	} from "./actions.ts";
	33	import { INTERESTS, SHOWING_AGENT_MAX, SHOWING_FEEDBACK_MAX } from "./showings.ts";
32	34	import { KINDS, STATUSES, TONES } from "./generate.ts";
33	35	import { title } from "./env.ts";
34	36	import { fields } from "./http.ts";
		@@ -121,6 +123,24 @@ export const tools: readonly Tool[] = [
121	123	},
122	124	run: (db, who, args) => getListing(db, who, { id: Number(args.id) }),
123	125	},
	126	{
	127	name: "log_showing",
	128	description:
	129	"Log a showing on a listing: the day (YYYY-MM-DD, not in the future; today when left out), the buyer's agent (optional, up to 80 characters), how interested the buyers were and one line of what they said (up to 280 characters, plain text, Fair Housing checked when read). Only the listing's agent or an admin can; showings never reach the property page, the email or the flyer.",
	130	inputSchema: {
	131	type: "object",
	132	properties: {
	133	id: { type: "integer" },
	134	date: { type: "string", description: "YYYY-MM-DD." },
	135	agent: { type: "string", maxLength: SHOWING_AGENT_MAX },
	136	interest: { enum: [...INTERESTS] },
	137	feedback: { type: "string", maxLength: SHOWING_FEEDBACK_MAX },
	138	},
	139	required: ["id", "interest"],
	140	},
	141	run: (db, who, args) =>
	142	addShowing(db, who, { id: Number(args.id), date: args.date, agent: args.agent, interest: args.interest, feedback: args.feedback }),
	143	},
124	144	{
125	145	name: "launch_kit",
126	146	description:
		@@ -236,7 +236,7 @@ function list(listings: readonly ListingSummary[], wanted: Find): string {
236	236	<span class="card-body">
237	237	<b>${escape(l.address)}</b>
238	238	<span>${money(l.price)} · ${l.beds} bd · ${l.baths} ba · ${count(l.sqft)} sq ft</span>
239		<span class="row card-meta">${approvalPill(l.approvals.filter((a) => a.approved).length, l.approvals.length)}${statusPill(l)}${status(l.flags)}<small class="muted">${escape(l.author_name)} · ${ago(l.updated_at)}</small></span>
	239	<span class="row card-meta">${approvalPill(l.approvals.filter((a) => a.approved).length, l.approvals.length)}${statusPill(l)}${status(l.flags)}${l.showings === 0 ? "" : `<span class="pill">${l.showings} ${l.showings === 1 ? "showing" : "showings"}</span>`}<small class="muted">${escape(l.author_name)} · ${ago(l.updated_at)}</small></span>
		sentinelcrew 9d ago This pill (singular/plural, hidden at 0) has no test that renders it; add one that fails without this line.
240	240	</span>
241	241	</a>
242	242	</li>`;
		@@ -4,7 +4,7 @@
4	4	* flyer, which is also a page of its own for printing (`flyerPage`).
5	5	*/
6	6
7		import type { Version } from "../actions.ts";
	7	import type { LoggedShowing, Version } from "../actions.ts";
8	8	import type { Check, Finding } from "../fairhousing.ts";
9	9	import { classHref } from "./fairhousing.ts";
10	10	import {
		@@ -24,7 +24,9 @@ import { altOf, approvalLabel, ASSET_MAX, propertyPath, type Asset, type Launche
24	24	import { isPost, lengthLine, meantForX, overXNote } from "../postlength.ts";
25	25	import { isSample } from "../photos.ts";
26	26	import type { Who } from "../who.ts";
	27	import { dayOf } from "../showings.ts";
27	28	import { ago, layout, toast } from "./layout.ts";
	29	import { showingsSection } from "./showings.ts";
28	30
29	31	/** Where a listing's photo is served: a sample from static/, an upload from its listing. */
30	32	export const photoUrl = (listing: Pick<Listing, "id">, name: string): string =>
		@@ -211,6 +213,8 @@ export function listingPage(input: {
211	213	versions?: Readonly<Record<string, readonly Version[]>>;
212	214	tab?: string \| null;
213	215	notice?: string \| undefined;
	216	/** The logged showings: given only to whoever may update the listing. */
	217	showings?: readonly LoggedShowing[];
214	218	}): string {
215	219	const { who, listing: l, editable, notice } = input;
216	220	const origin = input.origin ?? "";
		@@ -274,6 +278,7 @@ export function listingPage(input: {
274	278	</div>`,
275	279	).join("")}
276	280	</div>
	281	${input.showings === undefined ? "" : showingsSection(l.id, input.showings, dayOf(new Date()))}
277	282	${
278	283	editable
279	284	? `<form class="danger-zone" method="post" action="/listings/${l.id}/delete">
		@@ -0,0 +1,43 @@
	1	/**
	2	* The Showings section of the agent's listing page: a form to log one and the
	3	* log, newest first, each line Fair Housing checked like typed words. Only the
	4	* listing's agent or an admin is ever handed these; the property page, the
	5	* email and the flyer never see them.
	6	*/
	7
	8	import type { LoggedShowing } from "../actions.ts";
	9	import { escape } from "../http.ts";
	10	import { INTEREST_LABELS, INTERESTS, SHOWING_AGENT_MAX, SHOWING_FEEDBACK_MAX } from "../showings.ts";
	11
	12	const day = (date: string): string =>
	13	new Date(`${date}T00:00:00Z`).toLocaleDateString("en", { month: "short", day: "numeric", year: "numeric", timeZone: "UTC" });
	14
	15	function entry(listingId: number, s: LoggedShowing): string {
	16	const flagged = s.check.findings;
	17	return `<li class="showing">
	18	<p><b>${escape(day(s.date))}</b> · ${escape(INTEREST_LABELS[s.interest])}${s.agent === "" ? "" : ` · ${escape(s.agent)}`}</p>
	19	${s.feedback === "" ? "" : `<p>${escape(s.feedback)}</p>`}
	20	${flagged.length === 0 ? "" : `<ul class="fh-list" aria-label="Phrases to review">${flagged.map((f) => `<li><span class="fh-tag">${f.level === "note" ? "note" : escape(f.touches)}</span> ${escape(f.line)}</li>`).join("")}</ul>`}
	21	<form method="post" action="/listings/${listingId}/showings/${s.id}/delete">
	22	<button class="button button-quiet" aria-label="Remove the showing on ${escape(day(s.date))}">Remove</button>
	23	</form>
	24	</li>`;
	25	}
	26
	27	export function showingsSection(listingId: number, showings: readonly LoggedShowing[], today: string): string {
	28	return `<section class="showings" id="showings" aria-labelledby="showings-title">
	29	<h3 id="showings-title">Showings <small class="muted">${showings.length === 0 ? "none yet" : `${showings.length} logged`} · only you see these</small></h3>
	30	<form class="row" method="post" action="/listings/${listingId}/showings">
	31	<label class="sr" for="showing-date">Date</label>
	32	<input class="input" id="showing-date" type="date" name="date" value="${escape(today)}" max="${escape(today)}" required>
	33	<label class="sr" for="showing-agent">Buyer's agent, optional</label>
	34	<input class="input" id="showing-agent" name="agent" maxlength="${SHOWING_AGENT_MAX}" placeholder="Buyer's agent (optional)" autocomplete="off">
	35	<label class="sr" for="showing-interest">Interest</label>
	36	<select class="input select" id="showing-interest" name="interest">${INTERESTS.map((i) => `<option value="${i}"${i === "maybe" ? " selected" : ""}>${INTEREST_LABELS[i]}</option>`).join("")}</select>
	37	<label class="sr" for="showing-feedback">What they said</label>
	38	<input class="input" id="showing-feedback" name="feedback" maxlength="${SHOWING_FEEDBACK_MAX}" placeholder="What they said, one line" autocomplete="off">
	39	<button class="button">Log showing</button>
	40	</form>
	41	${showings.length === 0 ? "" : `<ul class="showing-list">${showings.map((s) => entry(listingId, s)).join("")}</ul>`}
	42	</section>`;
	43	}
		@@ -24,9 +24,12 @@ import {
24	24	editAsset,
25	25	getAudit,
26	26	getHome,
	27	addShowing,
27	28	addVisitor,
28	29	getListing,
	30	listShowings,
29	31	listVisitors,
	32	removeShowing,
30	33	removeVisitor,
31	34	getNote,
32	35	launchListing,
		@@ -72,6 +75,7 @@ import { draftOf, home, type Draft } from "./pages/home.ts";
72	75	import { layout } from "./pages/layout.ts";
73	76	import { fairHousingPage } from "./pages/fairhousing.ts";
74	77	import { factsPage } from "./pages/facts.ts";
	78	import { INTERESTS, SHOWING_AGENT_MAX, SHOWING_FEEDBACK_MAX } from "./showings.ts";
75	79	import { emailPage } from "./pages/email.ts";
76	80	import { publicOrigin } from "./env.ts";
77	81	import { propertyPage } from "./pages/property.ts";
		@@ -242,6 +246,10 @@ export const LISTING_SUMMARY: Schema = {
242	246	type: "integer",
243	247	description: "Phrases the Fair Housing check flags across every asset.",
244	248	},
	249	showings: {
	250	type: "integer",
	251	description: "How many showings the agent logged; 0 for anyone who may not update the listing.",
	252	},
245	253	approvals: {
246	254	type: "array",
247	255	description: "Each asset and whether somebody has signed off its words.",
		@@ -252,12 +260,39 @@ export const LISTING_SUMMARY: Schema = {
252	260	},
253	261	},
254	262	},
255		required: [...LISTING_REQUIRED, "flags", "approvals"],
	263	required: [...LISTING_REQUIRED, "flags", "approvals", "showings"],
	264	};
	265	const SHOWING: Schema = {
	266	type: "object",
	267	properties: {
	268	id: { type: "integer" },
	269	date: { type: "string", description: "YYYY-MM-DD." },
	270	agent: { type: "string", maxLength: SHOWING_AGENT_MAX },
	271	interest: { enum: [...INTERESTS] },
	272	feedback: { type: "string", maxLength: SHOWING_FEEDBACK_MAX },
	273	check: { type: "object", description: "The Fair Housing check on the feedback." },
	274	},
	275	required: ["id", "date", "agent", "interest", "feedback", "check"],
	276	};
	277	const SHOWING_BODY: Schema = {
	278	type: "object",
	279	properties: {
	280	date: { type: "string", description: "YYYY-MM-DD, not in the future; today when left out." },
	281	agent: { type: "string", maxLength: SHOWING_AGENT_MAX, description: "The buyer's agent, optional." },
	282	interest: { enum: [...INTERESTS] },
	283	feedback: { type: "string", maxLength: SHOWING_FEEDBACK_MAX, description: "One line, plain text." },
	284	},
	285	required: ["interest"],
256	286	};
257	287	export const LISTING: Schema = {
258	288	type: "object",
259	289	properties: {
260	290	...LISTING_FIELDS,
	291	showings: {
	292	type: "array",
	293	description: "The logged showings, newest first; only for the listing's agent or an admin.",
	294	items: SHOWING,
	295	},
261	296	assets: {
262	297	type: "array",
263	298	items: {
		@@ -360,6 +395,7 @@ const answer = <T>(result: Result<T>, status = 200): Response =>
360	395	{
361	396	error: result.error,
362	397	message: result.message,
	398	...(result.field === undefined ? {} : { field: result.field }),
363	399	...(result.existing === undefined ? {} : { id: result.existing.id }),
364	400	},
365	401	STATUS[result.error],
		@@ -505,8 +541,10 @@ export const routes: readonly Route[] = [
505	541	if (!found.ok) return page(c.who, found, () => "");
506	542	const earlier = listVersions(c.db, c.who, { id: Number(c.params.id) });
507	543	const versions = earlier.ok ? earlier.value : {};
	544	const showings = listShowings(c.db, c.who, { id: Number(c.params.id) });
508	545	return html(
509	546	listingPage({
	547	...(showings.ok ? { showings: showings.value } : {}),
510	548	who: c.who,
511	549	listing: found.value,
512	550	origin: publicOrigin,
		@@ -672,6 +710,32 @@ export const routes: readonly Route[] = [
672	710	);
673	711	},
674	712	},
	713	{
	714	method: "POST",
	715	path: "/listings/:id/showings",
	716	handle: async (c) => {
	717	const form = await readForm(c.request);
	718	if (form === undefined) return text("too large", 413);
	719	const id = Number(c.params.id);
	720	const done = addShowing(c.db, c.who, {
	721	id,
	722	date: form.get("date"),
	723	agent: form.get("agent"),
	724	interest: form.get("interest"),
	725	feedback: form.get("feedback"),
	726	});
	727	return back(done.ok ? "Showing logged." : done.message, `/listings/${id}`);
	728	},
	729	},
	730	{
	731	method: "POST",
	732	path: "/listings/:id/showings/:showing/delete",
	733	handle: (c) => {
	734	const id = Number(c.params.id);
	735	const done = removeShowing(c.db, c.who, { id, showing: Number(c.params.showing) });
	736	return back(done.ok ? "Showing removed." : done.message, `/listings/${id}`);
	737	},
	738	},
675	739	{
676	740	method: "POST",
677	741	path: "/listings/:id/visitors",
		@@ -991,8 +1055,38 @@ export const routes: readonly Route[] = [
991	1055	{
992	1056	method: "GET",
993	1057	path: "/api/listings/:id",
994		handle: (c) => answer(getListing(c.db, c.who, { id: Number(c.params.id) })),
995		api: { summary: "One listing, with its assets and each one's Fair Housing check.", answer: LISTING },
	1058	handle: (c) => {
	1059	const id = Number(c.params.id);
	1060	const found = getListing(c.db, c.who, { id });
	1061	const showings = found.ok ? listShowings(c.db, c.who, { id }) : undefined;
	1062	return answer(found.ok && showings?.ok ? { ok: true as const, value: { ...found.value, showings: showings.value } } : found);
	1063	},
	1064	api: { summary: "One listing, with its assets and each one's Fair Housing check; for the listing's agent or an admin, also its logged showings, newest first.", answer: LISTING },
	1065	},
	1066	{
	1067	method: "POST",
	1068	path: "/api/listings/:id/showings",
	1069	handle: async (c) => {
	1070	const raw = await readJson(c.request);
	1071	if (raw === undefined) return json({ error: "too_large" }, 413);
	1072	const body = fields(raw);
	1073	return answer(
	1074	addShowing(c.db, c.who, { id: Number(c.params.id), date: body.date, agent: body.agent, interest: body.interest, feedback: body.feedback }),
	1075	201,
	1076	);
	1077	},
	1078	api: {
	1079	summary: "Log a showing: the day, the buyer's agent, how interested they were and one line of feedback. Only the listing's agent or an admin; a refused field is named in the 422.",
	1080	body: SHOWING_BODY,
	1081	answer: { type: "object", properties: { id: { type: "integer" }, showing: { type: "integer" } }, required: ["id", "showing"] },
	1082	status: 201,
	1083	},
	1084	},
	1085	{
	1086	method: "DELETE",
	1087	path: "/api/listings/:id/showings/:showing",
	1088	handle: (c) => answer(removeShowing(c.db, c.who, { id: Number(c.params.id), showing: Number(c.params.showing) })),
	1089	api: { summary: "Remove a showing the agent logged.", answer: { type: "object", properties: { id: { type: "integer" } }, required: ["id"] } },
996	1090	},
997	1091	{
998	1092	method: "PATCH",