@kelpie/server 0.1.0

package/dist/modules/dashboard/routes.js.map

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

package/dist/modules/dashboard/service.d.ts

@@ -0,0 +1,122 @@
+import type { PipelineKind } from '@kelpie/schemas';
+import type { Database } from '../../lib/database.ts';
+import type { Actor } from '../auth/actor.ts';
+/**
+ * The workspace home, assembled in one request.
+ *
+ * Read-only and composed rather than stored: every number is a live query, so
+ * nothing goes stale between a write and the next visit. It is one endpoint
+ * rather than seven filtered list calls because two of its signals — a contact
+ * going cold, a partnership touchpoint at hand — are questions no resource list
+ * answers, and because the page and the `workspace.*` agent tasks both want the
+ * whole picture rather than a page of one part of it.
+ *
+ * Each signal carries an exact `total` beside a capped `items`. The page renders
+ * four rows; a brief that said "4 overdue" because four is what it was handed
+ * would be wrong every time there are more.
+ *
+ * `targetType` stays a string here, as it does in every module that owns a
+ * polymorphic column. The check constraint is what keeps it to the known set,
+ * and the browser's decoder is where it narrows.
+ */
+/** A signal: how many there are, and the first few of them. */
+export interface SignalList<Item> {
+    readonly total: number;
+    readonly items: readonly Item[];
+}
+export interface PipelineSnapshot {
+    readonly kind: PipelineKind;
+    /** Records sitting in a stage the workspace has marked open. */
+    readonly open: number;
+}
+/**
+ * A row that names a record it is not itself.
+ *
+ * `targetName` is null when the target resolved to nothing, which a column with
+ * no foreign key permits. A reader shows the type alone rather than an id.
+ */
+export interface TargetRef {
+    readonly targetType: string;
+    readonly targetId: string;
+    readonly targetName: string | null;
+}
+export interface PlanItemSignal extends TargetRef {
+    readonly id: string;
+    readonly date: string;
+    readonly title: string;
+    readonly ownerId: string | null;
+    readonly status: string;
+}
+export interface TouchpointSignal {
+    readonly id: string;
+    readonly name: string;
+    readonly companyId: string;
+    readonly nextTouchpoint: string;
+    /** Whether the date has already passed. The list holds both, oldest first. */
+    readonly overdue: boolean;
+    readonly ownerId: string | null;
+    readonly summary: string;
+}
+export interface StaleContactSignal {
+    readonly id: string;
+    readonly name: string;
+    readonly email: string | null;
+    readonly lastContactedAt: Date;
+    /** Whole days from the last contact to today, both read in the workspace's zone. */
+    readonly daysSinceContact: number;
+    readonly summary: string;
+}
+export interface ActivitySignal extends TargetRef {
+    readonly id: string;
+    readonly kind: string;
+    readonly actorMemberId: string | null;
+    readonly actorLabel: string | null;
+    readonly action: string;
+    readonly detail: string | null;
+    readonly createdAt: Date;
+}
+export interface NoteSignal extends TargetRef {
+    readonly id: string;
+    readonly body: string;
+    readonly authorId: string | null;
+    readonly pinned: boolean;
+    readonly createdAt: Date;
+}
+export interface DecisionSignal extends TargetRef {
+    readonly id: string;
+    readonly body: string;
+    readonly rationale: string | null;
+    readonly decidedAt: Date;
+    readonly ownerId: string | null;
+    readonly dueAt: Date | null;
+}
+export interface DashboardSnapshot {
+    readonly generatedAt: Date;
+    /** The day everything below was computed against, `YYYY-MM-DD`. */
+    readonly today: string;
+    /** The workspace's IANA zone, which is what fixed `today`. */
+    readonly timezone: string;
+    readonly staleContactDays: number;
+    readonly upcomingDays: number;
+    readonly pipelines: readonly PipelineSnapshot[];
+    readonly overduePlanItems: SignalList<PlanItemSignal>;
+    readonly dueSoonPlanItems: SignalList<PlanItemSignal>;
+    readonly partnershipTouchpoints: SignalList<TouchpointSignal>;
+    readonly staleContacts: SignalList<StaleContactSignal>;
+    readonly recentActivity: readonly ActivitySignal[];
+    readonly recentNotes: readonly NoteSignal[];
+    readonly recentDecisions: readonly DecisionSignal[];
+}
+export interface DashboardDependencies {
+    readonly db: Database;
+    readonly now: () => Date;
+}
+export interface DashboardService {
+    /**
+     * @param limit How many rows each embedded list carries. The totals beside
+     *   them are exact and ignore it.
+     */
+    snapshot(actor: Actor, limit?: number): Promise<DashboardSnapshot>;
+}
+export declare function createDashboardService(dependencies: DashboardDependencies): DashboardService;
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/dashboard/service.d.ts.map

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

package/dist/modules/dashboard/service.js

@@ -0,0 +1,215 @@
+import { PIPELINE_KINDS } from '@kelpie/schemas';
+import { AppError } from '../../lib/errors.js';
+import { dayIn } from '../../lib/timezones.js';
+import { requireWorkspaceId } from '../auth/actor.js';
+import { isRecordTargetType, resolveTargetNames, targetKey } from '../recordTargets.js';
+import { DEFAULT_SIGNAL_LIMIT, STALE_CONTACT_DAYS, UPCOMING_DAYS, daysBetween, staleContactCutoff, upcomingEnd, } from './attention.js';
+import * as repository from './repository.js';
+/**
+ * The count and the list of one signal, run one after the other.
+ *
+ * Sequential inside a group and concurrent across them, so a request holds at
+ * most one connection per group. The eight groups below fit under postgres.js's
+ * default pool of ten; pairing them up as well would put thirteen queries in
+ * flight and let one dashboard request queue everybody else's.
+ */
+async function readPlanItems(db, workspaceId, window, limit) {
+    return {
+        total: await repository.countOpenPlanItems(db, workspaceId, window),
+        items: await repository.listOpenPlanItems(db, workspaceId, window, limit),
+    };
+}
+async function readTouchpoints(db, workspaceId, through, limit) {
+    return {
+        total: await repository.countPartnershipTouchpoints(db, workspaceId, through),
+        items: await repository.listPartnershipTouchpoints(db, workspaceId, through, limit),
+    };
+}
+async function readStaleContacts(db, workspaceId, timezone, cutoff, limit) {
+    return {
+        total: await repository.countStaleContacts(db, workspaceId, timezone, cutoff),
+        items: await repository.listStaleContacts(db, workspaceId, timezone, cutoff, limit),
+    };
+}
+/**
+ * Every query the snapshot needs, and nothing that shapes the result.
+ *
+ * Eight groups in parallel: the page is one screen and thirteen round trips in
+ * a row would be felt. None of them is inside a transaction, so nothing here
+ * holds a connection while waiting on another.
+ *
+ * Overdue and due-soon are two windows rather than one list split afterwards, so
+ * each total counts the rows in its own bucket instead of the rows in the pair.
+ */
+async function readSignals(db, workspaceId, timezone, days, limit) {
+    const [openByPipeline, overduePlanItems, dueSoonPlanItems, partnershipTouchpoints, staleContacts, recentActivity, recentNotes, recentDecisions,] = await Promise.all([
+        repository.countOpenByPipeline(db, workspaceId),
+        readPlanItems(db, workspaceId, { before: days.today }, limit),
+        readPlanItems(db, workspaceId, { from: days.today, to: days.through }, limit),
+        readTouchpoints(db, workspaceId, days.through, limit),
+        readStaleContacts(db, workspaceId, timezone, days.staleCutoff, limit),
+        repository.listRecentActivity(db, workspaceId, limit),
+        repository.listRecentNotes(db, workspaceId, limit),
+        repository.listRecentDecisions(db, workspaceId, limit),
+    ]);
+    return {
+        openByPipeline,
+        overduePlanItems,
+        dueSoonPlanItems,
+        partnershipTouchpoints,
+        staleContacts,
+        recentActivity,
+        recentNotes,
+        recentDecisions,
+    };
+}
+/**
+ * @returns The target of a polymorphic row, or undefined when its `target_type`
+ *   is not one records are attached under. A check constraint rules that out, so
+ *   the undefined branch only fires on a value written around the API.
+ */
+function targetOf(row) {
+    return isRecordTargetType(row.targetType)
+        ? { targetType: row.targetType, targetId: row.targetId }
+        : undefined;
+}
+/** Every cross-record row on the page, so one pass resolves all of their names. */
+function targetsIn(rows) {
+    return [
+        ...rows.overduePlanItems.items,
+        ...rows.dueSoonPlanItems.items,
+        ...rows.recentActivity,
+        ...rows.recentNotes,
+        ...rows.recentDecisions,
+    ].flatMap((row) => {
+        const target = targetOf(row);
+        return target === undefined ? [] : [target];
+    });
+}
+function nameReader(names) {
+    return (row) => {
+        const target = targetOf(row);
+        return target === undefined ? null : (names.get(targetKey(target)) ?? null);
+    };
+}
+function toPlanItemSignal(list, nameOf) {
+    return {
+        total: list.total,
+        items: list.items.map((row) => ({
+            id: row.id,
+            targetType: row.targetType,
+            targetId: row.targetId,
+            targetName: nameOf(row),
+            date: row.date,
+            title: row.title,
+            ownerId: row.ownerId,
+            status: row.status,
+        })),
+    };
+}
+function toTouchpointSignal(list, today) {
+    return {
+        total: list.total,
+        items: list.items.map((row) => ({
+            id: row.id,
+            name: row.name,
+            companyId: row.companyId,
+            nextTouchpoint: row.nextTouchpoint,
+            overdue: row.nextTouchpoint < today,
+            ownerId: row.ownerId,
+            summary: row.summary,
+        })),
+    };
+}
+function toStaleContactSignal(list, today) {
+    return {
+        total: list.total,
+        items: list.items.map((row) => ({
+            id: row.id,
+            name: row.name,
+            email: row.email,
+            lastContactedAt: row.lastContactedAt,
+            daysSinceContact: daysBetween(row.lastContactedDay, today),
+            summary: row.summary,
+        })),
+    };
+}
+/** Shapes the rows into the answer. Pure: no clock, no database, no ambient state. */
+function toSnapshot(rows, names, generatedAt, timezone, days) {
+    const nameOf = nameReader(names);
+    return {
+        generatedAt,
+        today: days.today,
+        timezone,
+        staleContactDays: STALE_CONTACT_DAYS,
+        upcomingDays: UPCOMING_DAYS,
+        pipelines: PIPELINE_KINDS.map((kind) => ({ kind, open: rows.openByPipeline[kind] })),
+        overduePlanItems: toPlanItemSignal(rows.overduePlanItems, nameOf),
+        dueSoonPlanItems: toPlanItemSignal(rows.dueSoonPlanItems, nameOf),
+        partnershipTouchpoints: toTouchpointSignal(rows.partnershipTouchpoints, days.today),
+        staleContacts: toStaleContactSignal(rows.staleContacts, days.today),
+        recentActivity: rows.recentActivity.map((row) => ({
+            id: row.id,
+            targetType: row.targetType,
+            targetId: row.targetId,
+            targetName: nameOf(row),
+            kind: row.kind,
+            actorMemberId: row.actorMemberId,
+            actorLabel: row.actorLabel,
+            action: row.action,
+            detail: row.detail,
+            createdAt: row.createdAt,
+        })),
+        recentNotes: rows.recentNotes.map((row) => ({
+            id: row.id,
+            targetType: row.targetType,
+            targetId: row.targetId,
+            targetName: nameOf(row),
+            body: row.body,
+            authorId: row.authorId,
+            pinned: row.pinned,
+            createdAt: row.createdAt,
+        })),
+        recentDecisions: rows.recentDecisions.map((row) => ({
+            id: row.id,
+            targetType: row.targetType,
+            targetId: row.targetId,
+            targetName: nameOf(row),
+            body: row.body,
+            rationale: row.rationale,
+            decidedAt: row.decidedAt,
+            ownerId: row.ownerId,
+            dueAt: row.dueAt,
+        })),
+    };
+}
+export function createDashboardService(dependencies) {
+    async function requireTimezone(workspaceId) {
+        const timezone = await repository.findWorkspaceTimezone(dependencies.db, workspaceId);
+        // The actor is already bound to this workspace, so a miss means it was
+        // deleted between resolving the credential and reading it.
+        if (timezone === undefined) {
+            throw AppError.notFound('Workspace not found');
+        }
+        return timezone;
+    }
+    return {
+        async snapshot(actor, limit = DEFAULT_SIGNAL_LIMIT) {
+            const workspaceId = requireWorkspaceId(actor);
+            const generatedAt = dependencies.now();
+            const timezone = await requireTimezone(workspaceId);
+            const today = dayIn(timezone, generatedAt);
+            const days = {
+                today,
+                through: upcomingEnd(today),
+                staleCutoff: staleContactCutoff(today),
+            };
+            const rows = await readSignals(dependencies.db, workspaceId, timezone, days, limit);
+            // After the rows, not alongside them: which records need naming is not
+            // known until every list has come back.
+            const names = await resolveTargetNames(dependencies.db, workspaceId, targetsIn(rows));
+            return toSnapshot(rows, names, generatedAt, timezone, days);
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/modules/dashboard/service.js.map

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

package/dist/modules/dashboard/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolRegistry } from '../../runtime/module.ts';
+import type { DashboardService } from './service.ts';
+export declare function registerDashboardTools(mcp: McpToolRegistry, service: DashboardService): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/modules/dashboard/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/modules/dashboard/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAqBpD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAY5F"}

package/dist/modules/dashboard/tools.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { MAX_PAGE_SIZE } from '../../lib/pagination.js';
+import { dashboardResponse } from './routes.js';
+/**
+ * `dashboard_get`, and nothing else. The resource is read-only, so there is no
+ * tool that writes one.
+ *
+ * This is the tool the `workspace.*` tasks in `agent-tasks.md` read from: a
+ * daily brief, a stale-relationship triage and a pipeline review all start from
+ * the same snapshot, and each of them would otherwise open with several list
+ * calls and a client-side join to name the records.
+ */
+const getArgs = z.strictObject({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_PAGE_SIZE)
+        .optional()
+        .describe('How many rows each embedded list carries. The totals beside them are exact.'),
+});
+export function registerDashboardTools(mcp, service) {
+    mcp.tool({
+        name: 'dashboard_get',
+        description: 'Read the workspace snapshot: open counts per pipeline, overdue and due-soon plan items, ' +
+            'partnership touchpoints at hand, contacts going cold, and the latest activity, notes and ' +
+            'decisions. Each attention signal carries an exact total beside a capped list, and every ' +
+            'cross-record row names the record it is about. Mirrors GET /v1/dashboard.',
+        inputSchema: getArgs,
+        invoke: async (args, actor) => dashboardResponse(await service.snapshot(actor, args.limit)),
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/modules/dashboard/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/modules/dashboard/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAG/C;;;;;;;;GAQG;AACH,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC;IAC7B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,aAAa,CAAC;SAClB,QAAQ,EAAE;SACV,QAAQ,CAAC,6EAA6E,CAAC;CAC3F,CAAC,CAAA;AAEF,MAAM,UAAU,sBAAsB,CAAC,GAAoB,EAAE,OAAyB;IACpF,GAAG,CAAC,IAAI,CAAC;QACP,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0FAA0F;YAC1F,2FAA2F;YAC3F,0FAA0F;YAC1F,2EAA2E;QAC7E,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAC5B,iBAAiB,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;KAC/D,CAAC,CAAA;AACJ,CAAC"}

package/dist/modules/deals/index.d.ts

@@ -0,0 +1,11 @@
+import type { KelpieModule } from '../../runtime/module.ts';
+/**
+ * Deals: the sales pipeline.
+ *
+ * Requires its relations because creating one checks that the company, stage,
+ * owner, and people are all in the caller's workspace before linking them, and
+ * `activities` because every write leaves its timeline entry in the same
+ * transaction.
+ */
+export declare function createDealsModule(migrationsDirectory: string): KelpieModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/deals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/deals/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAO3D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,mBAAmB,EAAE,MAAM,GAAG,YAAY,CA4B3E"}

package/dist/modules/deals/index.js

@@ -0,0 +1,38 @@
+import { createActivityRecorder } from '../activities/index.js';
+import { mountDealsRoutes } from './routes.js';
+import * as schema from './schema.js';
+import { createDealsService } from './service.js';
+import { registerDealsTools } from './tools.js';
+/**
+ * Deals: the sales pipeline.
+ *
+ * Requires its relations because creating one checks that the company, stage,
+ * owner, and people are all in the caller's workspace before linking them, and
+ * `activities` because every write leaves its timeline entry in the same
+ * transaction.
+ */
+export function createDealsModule(migrationsDirectory) {
+    return {
+        id: 'deals',
+        requires: ['companies', 'people', 'pipelines', 'activities'],
+        register(context) {
+            const service = createDealsService({
+                db: context.db,
+                transaction: context.transaction,
+                createId: context.createId,
+                now: context.now,
+                recordActivity: createActivityRecorder({
+                    createId: context.createId,
+                    now: context.now,
+                }),
+            });
+            context.schema(schema, migrationsDirectory);
+            context.routes((router) => {
+                mountDealsRoutes(router, { db: context.db, now: context.now, service });
+            });
+            registerDealsTools(context.mcp, service);
+            return Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/deals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/deals/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,mBAA2B;IAC3D,OAAO;QACL,EAAE,EAAE,OAAO;QACX,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC;QAE5D,QAAQ,CAAC,OAAO;YACd,MAAM,OAAO,GAAG,kBAAkB,CAAC;gBACjC,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,cAAc,EAAE,sBAAsB,CAAC;oBACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;iBACjB,CAAC;aACH,CAAC,CAAA;YAEF,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;YAE3C,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;gBACxB,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;YACzE,CAAC,CAAC,CAAA;YAEF,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAExC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/modules/deals/repository.d.ts

@@ -0,0 +1,44 @@
+import type { ListWindow, SortableFields } from '../../lib/pagination.ts';
+import type { Queryable } from '../../runtime/transaction.ts';
+import { deals } from './schema.ts';
+export type DealRecord = typeof deals.$inferSelect;
+/** The writable column shape. Services build one of these; nothing else knows the column names. */
+export type DealColumns = typeof deals.$inferInsert;
+/** The sort fields `?sort=` documents for deals. Nullable columns (value, close date) stay out: a keyset cannot seek past a null. */
+export declare const DEAL_SORTS: SortableFields<DealRecord>;
+export declare const DEFAULT_DEAL_SORT = "-created_at";
+export interface DealFilters {
+    /** `?q=`: deal name, summary, tags, competitors, or the company's name. */
+    readonly term?: string | undefined;
+    /** `?company_id=`, repeatable. */
+    readonly companyIds?: readonly string[] | undefined;
+    /** `?stage_id=`, repeatable: the board fetches one column with one of these. */
+    readonly stageIds?: readonly string[] | undefined;
+    /** `?person_id=`, repeatable: deals any of these people are on. */
+    readonly personIds?: readonly string[] | undefined;
+}
+/** @returns Up to `window.fetchLimit` rows: one more than the page, so the caller can tell there is a next one. */
+export declare function listDeals(db: Queryable, workspaceId: string, filters: DealFilters, window: ListWindow<DealRecord>): Promise<DealRecord[]>;
+export declare function findDeal(db: Queryable, workspaceId: string, id: string): Promise<DealRecord | undefined>;
+export declare function insertDeal(db: Queryable, values: DealColumns): Promise<DealRecord>;
+export declare function updateDeal(db: Queryable, workspaceId: string, id: string, changes: Partial<DealColumns>): Promise<DealRecord | undefined>;
+export declare function deleteDeal(db: Queryable, workspaceId: string, id: string): Promise<number>;
+/** The people on one deal. Ordered by id so a response is stable across reads. */
+export declare function listPersonIds(db: Queryable, dealId: string): Promise<string[]>;
+/**
+ * The people on each of a page of deals, in one query rather than one per row.
+ *
+ * @returns Ids missing from the map have no people.
+ */
+export declare function listPersonIdsFor(db: Queryable, dealIds: readonly string[]): Promise<ReadonlyMap<string, readonly string[]>>;
+export declare function insertDealPeople(db: Queryable, dealId: string, personIds: readonly string[]): Promise<void>;
+export declare function deleteDealPeople(db: Queryable, dealId: string, personIds: readonly string[]): Promise<void>;
+/**
+ * The names of these people in this workspace, keyed by id. An id missing from
+ * the map does not exist here, which is how `person_ids` is validated. Reads the
+ * `people` *table*, per the cross-relation rule in `architecture.md`.
+ */
+export declare function findPeopleNamed(db: Queryable, workspaceId: string, personIds: readonly string[]): Promise<ReadonlyMap<string, string>>;
+/** Whether a member belongs to this workspace, for validating `owner_id`. */
+export declare function memberExists(db: Queryable, workspaceId: string, memberId: string): Promise<boolean>;
+//# sourceMappingURL=repository.d.ts.map

package/dist/modules/deals/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/modules/deals/repository.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAI7D,OAAO,EAAc,KAAK,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,YAAY,CAAA;AAElD,mGAAmG;AACnG,MAAM,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,YAAY,CAAA;AAEnD,qIAAqI;AACrI,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,UAAU,CAIjD,CAAA;AAED,eAAO,MAAM,iBAAiB,gBAAgB,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,kCAAkC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACnD,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACjD,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACnD;AA8CD,mHAAmH;AACnH,wBAAgB,SAAS,CACvB,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,GAC7B,OAAO,CAAC,UAAU,EAAE,CAAC,CAOvB;AAED,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAQjC;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAQxF;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAQjC;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhG;AAED,kFAAkF;AAClF,wBAAsB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQpF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAwBjD;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAWtC;AAED,6EAA6E;AAC7E,wBAAsB,YAAY,CAChC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAQlB"}