@kelpie/server 0.1.0

package/dist/modules/notes/index.js

@@ -0,0 +1,37 @@
+import { createActivityRecorder } from '../activities/index.js';
+import { mountNotesRoutes } from './routes.js';
+import * as schema from './schema.js';
+import { createNotesService } from './service.js';
+import { registerNotesTools } from './tools.js';
+/**
+ * Notes: what a person wrote down about a record.
+ *
+ * Requires `activities`, because writing a note writes the timeline entry
+ * announcing it, in the same transaction.
+ */
+export function createNotesModule(migrationsDirectory) {
+    return {
+        id: 'notes',
+        requires: ['workspace', 'activities'],
+        structural: true,
+        register(context) {
+            const service = createNotesService({
+                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) => {
+                mountNotesRoutes(router, { db: context.db, now: context.now, service });
+            });
+            registerNotesTools(context.mcp, service);
+            return Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/notes/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;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,mBAA2B;IAC3D,OAAO;QACL,EAAE,EAAE,OAAO;QACX,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;QACrC,UAAU,EAAE,IAAI;QAEhB,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/notes/repository.d.ts

@@ -0,0 +1,34 @@
+import type { ListWindow, SortableFields } from '../../lib/pagination.ts';
+import type { Queryable } from '../../runtime/transaction.ts';
+import type { RecordTargetType } from '../recordTargets.ts';
+import { notes } from './schema.ts';
+export type NoteRecord = typeof notes.$inferSelect;
+/** The writable column shape. Services build one of these; nothing else knows the column names. */
+export type NoteColumns = typeof notes.$inferInsert;
+export declare const NOTE_SORTS: SortableFields<NoteRecord>;
+export declare const DEFAULT_NOTE_SORT = "-created_at";
+export interface NoteFilters {
+    readonly targetType: RecordTargetType;
+    /**
+     * `?target_id=`, repeatable per `api.md`. Never empty: a note list always
+     * names the records it is for, and an omitted filter is a 422 at the route.
+     */
+    readonly targetIds: readonly string[];
+    /** `?pinned=`. Absent returns both. Pinned notes are what agents read first. */
+    readonly pinned?: boolean | 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 listNotes(db: Queryable, workspaceId: string, filters: NoteFilters, window: ListWindow<NoteRecord>): Promise<NoteRecord[]>;
+export declare function findNote(db: Queryable, workspaceId: string, id: string): Promise<NoteRecord | undefined>;
+export declare function insertNote(db: Queryable, values: NoteColumns): Promise<NoteRecord>;
+export declare function updateNote(db: Queryable, workspaceId: string, id: string, changes: Partial<NoteColumns>): Promise<NoteRecord | undefined>;
+export declare function deleteNote(db: Queryable, workspaceId: string, id: string): Promise<number>;
+/**
+ * Removes every note attached to a target.
+ *
+ * The target is polymorphic and carries no foreign key, so nothing in the
+ * database deletes these. The service that deletes the target calls this inside
+ * the same transaction (`schema.md`).
+ */
+export declare function deleteForTarget(db: Queryable, workspaceId: string, targetType: string, targetId: string): Promise<number>;
+//# sourceMappingURL=repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/modules/notes/repository.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC,MAAM,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,YAAY,CAAA;AAElD,mGAAmG;AACnG,MAAM,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,YAAY,CAAA;AAEnD,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,UAAU,CAGjD,CAAA;AAED,eAAO,MAAM,iBAAiB,gBAAgB,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACtC;AAWD,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;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/modules/notes/repository.js

@@ -0,0 +1,70 @@
+import { and, eq, inArray } from 'drizzle-orm';
+import { keysetCondition, orderByWindow, timestampSort } from '../../lib/pagination.js';
+import { notes } from './schema.js';
+export const NOTE_SORTS = {
+    created_at: timestampSort(notes.createdAt, (note) => note.createdAt),
+    updated_at: timestampSort(notes.updatedAt, (note) => note.updatedAt),
+};
+export const DEFAULT_NOTE_SORT = '-created_at';
+function conditionsFor(workspaceId, filters) {
+    return [
+        eq(notes.workspaceId, workspaceId),
+        eq(notes.targetType, filters.targetType),
+        inArray(notes.targetId, [...filters.targetIds]),
+        filters.pinned === undefined ? undefined : eq(notes.pinned, filters.pinned),
+    ];
+}
+/** @returns Up to `window.fetchLimit` rows: one more than the page, so the caller can tell there is a next one. */
+export function listNotes(db, workspaceId, filters, window) {
+    return db
+        .select()
+        .from(notes)
+        .where(and(...conditionsFor(workspaceId, filters), keysetCondition(window, notes.id)))
+        .orderBy(...orderByWindow(window, notes.id))
+        .limit(window.fetchLimit);
+}
+export async function findNote(db, workspaceId, id) {
+    const [found] = await db
+        .select()
+        .from(notes)
+        .where(and(eq(notes.workspaceId, workspaceId), eq(notes.id, id)))
+        .limit(1);
+    return found;
+}
+export async function insertNote(db, values) {
+    const [created] = await db.insert(notes).values(values).returning();
+    if (created === undefined) {
+        throw new Error(`Inserting note ${values.id} returned no row`);
+    }
+    return created;
+}
+export async function updateNote(db, workspaceId, id, changes) {
+    const [updated] = await db
+        .update(notes)
+        .set(changes)
+        .where(and(eq(notes.workspaceId, workspaceId), eq(notes.id, id)))
+        .returning();
+    return updated;
+}
+export async function deleteNote(db, workspaceId, id) {
+    const deleted = await db
+        .delete(notes)
+        .where(and(eq(notes.workspaceId, workspaceId), eq(notes.id, id)))
+        .returning({ id: notes.id });
+    return deleted.length;
+}
+/**
+ * Removes every note attached to a target.
+ *
+ * The target is polymorphic and carries no foreign key, so nothing in the
+ * database deletes these. The service that deletes the target calls this inside
+ * the same transaction (`schema.md`).
+ */
+export async function deleteForTarget(db, workspaceId, targetType, targetId) {
+    const deleted = await db
+        .delete(notes)
+        .where(and(eq(notes.workspaceId, workspaceId), eq(notes.targetType, targetType), eq(notes.targetId, targetId)))
+        .returning({ id: notes.id });
+    return deleted.length;
+}
+//# sourceMappingURL=repository.js.map

package/dist/modules/notes/repository.js.map

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

package/dist/modules/notes/routes.d.ts

@@ -0,0 +1,37 @@
+import type { Hono } from 'hono';
+import { z } from 'zod';
+import type { CredentialDependencies } from '../auth/credentials.ts';
+import type { CreateNoteInput, NoteView, NotesService, UpdateNoteInput } from './service.ts';
+/**
+ * Wire shapes for `/v1/notes`.
+ *
+ * Bodies are strict: `api.md` makes an unknown field a 422 rather than something
+ * dropped in silence.
+ */
+export declare const createBody: z.ZodObject<{
+    target_type: z.ZodEnum<{
+        candidate: "candidate";
+        company: "company";
+        deal: "deal";
+        opportunity: "opportunity";
+        partnership: "partnership";
+        person: "person";
+        raise: "raise";
+    }>;
+    target_id: z.ZodString;
+    body: z.ZodString;
+    pinned: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+/** The target never moves. Re-filing a note under another record is a delete and a create. */
+export declare const updateBody: z.ZodObject<{
+    body: z.ZodOptional<z.ZodString>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export interface NotesRoutesDependencies extends CredentialDependencies {
+    readonly service: NotesService;
+}
+export declare function toCreateInput(body: z.infer<typeof createBody>): CreateNoteInput;
+export declare function toUpdateInput(body: z.infer<typeof updateBody>): UpdateNoteInput;
+export declare function noteResponse(note: NoteView): Record<string, unknown>;
+export declare function mountNotesRoutes(router: Hono, dependencies: NotesRoutesDependencies): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/modules/notes/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/modules/notes/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAA;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAIpE,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE5F;;;;;GAKG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;kBAKrB,CAAA;AAEF,8FAA8F;AAC9F,eAAO,MAAM,UAAU;;;kBAKX,CAAA;AAEZ,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAC/B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,GAAG,eAAe,CAO/E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,GAAG,eAAe,CAK/E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWpE;AA6DD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,uBAAuB,GAAG,IAAI,CA0C1F"}

package/dist/modules/notes/routes.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { AppError } from '../../lib/errors.js';
+import { pageBody, readIdFilter, readJsonBody, readListParameters } from '../../lib/http.js';
+import { resolveActorFrom } from '../auth/credentials.js';
+import { isRecordTargetType } from '../recordTargets.js';
+import { RECORD_TARGET_TYPES } from './schema.js';
+/**
+ * Wire shapes for `/v1/notes`.
+ *
+ * Bodies are strict: `api.md` makes an unknown field a 422 rather than something
+ * dropped in silence.
+ */
+export const createBody = z.strictObject({
+    target_type: z.enum(RECORD_TARGET_TYPES),
+    target_id: z.string().min(1),
+    body: z.string().min(1),
+    pinned: z.boolean().default(false),
+});
+/** The target never moves. Re-filing a note under another record is a delete and a create. */
+export const updateBody = z
+    .strictObject({
+    body: z.string().min(1),
+    pinned: z.boolean(),
+})
+    .partial();
+export function toCreateInput(body) {
+    return {
+        targetType: body.target_type,
+        targetId: body.target_id,
+        body: body.body,
+        pinned: body.pinned,
+    };
+}
+export function toUpdateInput(body) {
+    return {
+        ...(body.body === undefined ? {} : { body: body.body }),
+        ...(body.pinned === undefined ? {} : { pinned: body.pinned }),
+    };
+}
+export function noteResponse(note) {
+    return {
+        id: note.id,
+        target_type: note.targetType,
+        target_id: note.targetId,
+        body: note.body,
+        author_id: note.authorId,
+        pinned: note.pinned,
+        created_at: note.createdAt.toISOString(),
+        updated_at: note.updatedAt.toISOString(),
+    };
+}
+/**
+ * A note list always names the records it belongs to. There is no workspace-wide
+ * note list in the mockup, and answering one by accident through an omitted
+ * filter would page a workspace's entire note history to render one panel.
+ *
+ * `?target_id=` repeats to name a set, per `api.md`, so a page rendering a note
+ * per row resolves them in one request instead of one per row. `?target_type=`
+ * stays single: the ids in one set are all the same kind of record, and a
+ * request mixing them would need the type paired with each id rather than
+ * alongside them.
+ *
+ * @throws AppError 422 when either half is missing, the type is unknown, an id
+ *   is blank or there are more than `MAX_FILTER_IDS`, or `?pinned=` is a word
+ *   that is not true or false.
+ */
+function readFilters(context) {
+    const targetType = context.req.query('target_type');
+    const targetIds = readIdFilter(context, 'target_id');
+    if (targetType === undefined || targetIds === undefined) {
+        throw AppError.validationFailed('A note list always names the records it is for', [
+            { field: 'target_type', message: 'Required' },
+            { field: 'target_id', message: 'Required' },
+        ]);
+    }
+    if (!isRecordTargetType(targetType)) {
+        throw AppError.validationFailed('That is not a record type a note attaches to', [
+            { field: 'target_type', message: `Unknown target type "${targetType}"` },
+        ]);
+    }
+    return { targetType, targetIds, pinned: readPinned(context.req.query('pinned')) };
+}
+function readPinned(raw) {
+    if (raw === undefined) {
+        return undefined;
+    }
+    if (raw === 'true') {
+        return true;
+    }
+    if (raw === 'false') {
+        return false;
+    }
+    // Not defaulted to false: `?pinned=yes` asked a question, and answering the
+    // unpinned one instead is worse than saying the question was malformed.
+    throw AppError.validationFailed('"pinned" filters on true or false', [
+        { field: 'pinned', message: `Expected true or false, got "${raw}"` },
+    ]);
+}
+export function mountNotesRoutes(router, dependencies) {
+    const requireActor = (context) => resolveActorFrom(dependencies, context);
+    router.get('/notes', async (context) => {
+        const page = await dependencies.service.list(await requireActor(context), readFilters(context), readListParameters(context));
+        return context.json(pageBody(page, noteResponse));
+    });
+    router.post('/notes', async (context) => {
+        const body = await readJsonBody(context, createBody);
+        const note = await dependencies.service.create(await requireActor(context), toCreateInput(body));
+        return context.json(noteResponse(note), 201);
+    });
+    router.get('/notes/:id', async (context) => {
+        const note = await dependencies.service.get(await requireActor(context), context.req.param('id'));
+        return context.json(noteResponse(note));
+    });
+    router.patch('/notes/:id', async (context) => {
+        const body = await readJsonBody(context, updateBody);
+        const note = await dependencies.service.update(await requireActor(context), context.req.param('id'), toUpdateInput(body));
+        return context.json(noteResponse(note));
+    });
+    router.delete('/notes/:id', async (context) => {
+        await dependencies.service.remove(await requireActor(context), context.req.param('id'));
+        return context.body(null, 204);
+    });
+}
+//# sourceMappingURL=routes.js.map

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

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

package/dist/modules/notes/schema.d.ts

@@ -0,0 +1,176 @@
+/**
+ * The target types come from `@kelpie/schemas`, so this check constraint, the
+ * route's Zod enum, and the browser's decoder are one list rather than three
+ * copies. Re-exported because `routes.ts` and `service.ts` read them from here,
+ * and the table they constrain is the reason they matter.
+ */
+export { RECORD_TARGET_TYPES } from '@kelpie/schemas';
+export type { RecordTargetType } from '@kelpie/schemas';
+/**
+ * Notes attach to any CRM object. The target is polymorphic with no database
+ * foreign key, so the owning service deletes dependents in the same transaction
+ * as the parent.
+ *
+ * Pinned notes are what agents read first.
+ */
+export declare const notes: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "notes";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "notes";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "notes";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        targetType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "target_type";
+            tableName: "notes";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        targetId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "target_id";
+            tableName: "notes";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        body: import("drizzle-orm/pg-core").PgColumn<{
+            name: "body";
+            tableName: "notes";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        authorId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "author_id";
+            tableName: "notes";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        pinned: import("drizzle-orm/pg-core").PgColumn<{
+            name: "pinned";
+            tableName: "notes";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "notes";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "notes";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/modules/notes/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/notes/schema.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBjB,CAAA"}

package/dist/modules/notes/schema.js

@@ -0,0 +1,35 @@
+import { RECORD_TARGET_TYPES } from '@kelpie/schemas';
+import { boolean, index, pgTable, text } from 'drizzle-orm/pg-core';
+import { checkOneOf, createdAt, primaryId, updatedAt } from '../../lib/columns.js';
+import { workspaceMembers, workspaces } from '../workspace/schema.js';
+/**
+ * The target types come from `@kelpie/schemas`, so this check constraint, the
+ * route's Zod enum, and the browser's decoder are one list rather than three
+ * copies. Re-exported because `routes.ts` and `service.ts` read them from here,
+ * and the table they constrain is the reason they matter.
+ */
+export { RECORD_TARGET_TYPES } from '@kelpie/schemas';
+/**
+ * Notes attach to any CRM object. The target is polymorphic with no database
+ * foreign key, so the owning service deletes dependents in the same transaction
+ * as the parent.
+ *
+ * Pinned notes are what agents read first.
+ */
+export const notes = pgTable('notes', {
+    id: primaryId(),
+    workspaceId: text('workspace_id')
+        .notNull()
+        .references(() => workspaces.id, { onDelete: 'cascade' }),
+    targetType: text('target_type').notNull(),
+    targetId: text('target_id').notNull(),
+    body: text('body').notNull(),
+    authorId: text('author_id').references(() => workspaceMembers.id, { onDelete: 'restrict' }),
+    pinned: boolean('pinned').notNull().default(false),
+    createdAt: createdAt(),
+    updatedAt: updatedAt(),
+}, (table) => [
+    index('notes_target_idx').on(table.workspaceId, table.targetType, table.targetId),
+    checkOneOf('notes_target_type_check', table.targetType, RECORD_TARGET_TYPES),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/modules/notes/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/modules/notes/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAEnE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAErE;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAGrD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAC1B,OAAO,EACP;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACrC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC3F,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClD,SAAS,EAAE,SAAS,EAAE;IACtB,SAAS,EAAE,SAAS,EAAE;CACvB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;IACjF,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC7E,CACF,CAAA"}

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

@@ -0,0 +1,49 @@
+import type { Database } from '../../lib/database.ts';
+import type { IdFactory } from '../../lib/ids.ts';
+import type { ListQueryParameters, Page } from '../../lib/pagination.ts';
+import type { TransactionScope } from '../../runtime/transaction.ts';
+import type { ActivityRecorder } from '../activities/recorder.ts';
+import type { Actor } from '../auth/actor.ts';
+import type { RecordTargetType } from '../recordTargets.ts';
+import type { NoteFilters, NoteRecord } from './repository.ts';
+/**
+ * Notes: what a person wrote down about a record.
+ *
+ * The target is polymorphic and has no foreign key, so this service is what
+ * refuses a note attached to an id that does not exist or belongs to another
+ * workspace. Nothing in the database would.
+ *
+ * Writing a note is history: it records a `note_added` activity in the same
+ * transaction, so a note that commits always has the timeline entry announcing
+ * it. Editing one does not. A note's body changing is not an event anyone needs
+ * on a timeline, and a row per typo fix would bury the entries that matter.
+ */
+export interface NotesDependencies {
+    readonly db: Database;
+    readonly transaction: TransactionScope;
+    readonly createId: IdFactory;
+    readonly now: () => Date;
+    readonly recordActivity: ActivityRecorder;
+}
+/** A note as the API returns one: the stored row minus the tenancy column. */
+export type NoteView = Omit<NoteRecord, 'workspaceId'>;
+export interface CreateNoteInput {
+    readonly targetType: RecordTargetType;
+    readonly targetId: string;
+    readonly body: string;
+    readonly pinned: boolean;
+}
+/** PATCH semantics: an absent field is left alone. The target never moves. */
+export interface UpdateNoteInput {
+    readonly body?: string | undefined;
+    readonly pinned?: boolean | undefined;
+}
+export interface NotesService {
+    list(actor: Actor, filters: NoteFilters, query: ListQueryParameters): Promise<Page<NoteView>>;
+    get(actor: Actor, id: string): Promise<NoteView>;
+    create(actor: Actor, input: CreateNoteInput): Promise<NoteView>;
+    update(actor: Actor, id: string, changes: UpdateNoteInput): Promise<NoteView>;
+    remove(actor: Actor, id: string): Promise<void>;
+}
+export declare function createNotesService(dependencies: NotesDependencies): NotesService;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/notes/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAG3D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE9D;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAA;IACxB,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAA;CAC1C;AAED,8EAA8E;AAC9E,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;AAEtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC7F,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/D,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7E,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAQD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,GAAG,YAAY,CAuIhF"}