@adminiumjs/meta 0.1.0-rc.1

package/dist/repos/llm-overrides.js.map

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

package/dist/repos/llm-runs.d.ts

@@ -0,0 +1,114 @@
+/**
+ * llmRunsRepo — adminium_llm_runs (07-meta-store.md §3.19, 06-llm-assist.md §7.4).
+ *
+ * One row = one enrichment attempt (provider API or BYO paste). This repo is the
+ * thin persistence layer: it round-trips rows and validates the json payloads it
+ * writes. The §7.4 run-lifecycle transition rules and run immutability live one
+ * layer up in the server run-service — the repo's `updateStatus` accepts an
+ * optional `expected` current-status guard so the service can transition
+ * atomically, but it does not itself know the legal transition graph.
+ *
+ * §9 telemetry-free guarantee: for BYO runs `provider`/`model` stay NULL. The
+ * repo never fills them; enforcing "BYO ⇒ null" is the run-service's job.
+ */
+import type { MetaDb } from '../connect.js';
+import { type LlmRunReview, type LlmRunStatus } from '../schema/json-payloads.js';
+export type LlmRunMode = 'provider' | 'byo';
+export type LlmValidationStatus = 'pending' | 'valid' | 'partial' | 'invalid';
+export type { LlmRunStatus, LlmRunReview };
+export interface LlmRun {
+    id: string;
+    connectionId: string;
+    snapshotId: string;
+    mode: LlmRunMode;
+    provider: string | null;
+    model: string | null;
+    promptVersion: string;
+    promptHash: string;
+    promptText: string | null;
+    sections: string[] | null;
+    locales: string[] | null;
+    sampling: {
+        maxValuesPerColumn: number;
+    } | null;
+    chunksTotal: number;
+    chunksReceived: number;
+    responseRaw: string | null;
+    responseJson: unknown | null;
+    status: LlmRunStatus;
+    validationStatus: LlmValidationStatus;
+    validationErrors: unknown | null;
+    review: LlmRunReview | null;
+    tokensIn: number | null;
+    tokensOut: number | null;
+    durationMs: number | null;
+    appliedBy: string | null;
+    appliedAt: number | null;
+    createdBy: string | null;
+    createdAt: number;
+}
+export interface CreateLlmRunInput {
+    /** Defaults to `newId('run')`. The run id equals the runId embedded in the prompt (§7.4). */
+    id?: string;
+    connectionId: string;
+    snapshotId: string;
+    mode: LlmRunMode;
+    provider?: string | null;
+    model?: string | null;
+    promptVersion: string;
+    promptHash: string;
+    promptText?: string | null;
+    sections?: readonly string[] | null;
+    locales?: readonly string[] | null;
+    sampling?: {
+        maxValuesPerColumn: number;
+    } | null;
+    chunksTotal?: number;
+    chunksReceived?: number;
+    status?: LlmRunStatus;
+    validationStatus?: LlmValidationStatus;
+    createdBy?: string | null;
+}
+/** Fields recordResponse persists after validating a received chunk/response. */
+export interface RecordResponsePatch {
+    status: LlmRunStatus;
+    validationStatus: LlmValidationStatus;
+    responseRaw?: string | null;
+    responseJson?: unknown | null;
+    validationErrors?: unknown | null;
+    chunksReceived?: number;
+    tokensIn?: number | null;
+    tokensOut?: number | null;
+    durationMs?: number | null;
+}
+export interface MarkAppliedInput {
+    appliedBy?: string | null;
+    /** Terminal status — `applied` or `partially_applied`. */
+    status: Extract<LlmRunStatus, 'applied' | 'partially_applied'>;
+    review?: LlmRunReview;
+}
+export declare function llmRunsRepo(meta: MetaDb): {
+    findById: (id: string) => Promise<LlmRun | null>;
+    /** Persist a new run (typically a `draft`). Validates every json payload before writing. */
+    create(input: CreateLlmRunInput, at?: number): Promise<LlmRun>;
+    /** Run history for a connection, newest first. */
+    listForConnection(connectionId: string): Promise<LlmRun[]>;
+    /**
+     * Set the lifecycle status. When `expected` is given the update only lands if
+     * the row is still in that status (optimistic transition) — the server
+     * run-service uses this to make transitions atomic. Returns whether a row
+     * changed.
+     */
+    updateStatus(id: string, status: LlmRunStatus, opts?: {
+        expected?: LlmRunStatus;
+        at?: number;
+    }): Promise<boolean>;
+    /** Persist a validated (or fatally-rejected) response and advance the run. */
+    recordResponse(id: string, patch: RecordResponsePatch): Promise<boolean>;
+    /** Persist the accepted/rejected suggestion-id lists (§8.3). */
+    recordReview(id: string, review: LlmRunReview): Promise<boolean>;
+    /** Terminal apply: stamp applied_at/applied_by, set the terminal status, persist the review. */
+    markApplied(id: string, input: MarkAppliedInput, at?: number): Promise<boolean>;
+};
+export type LlmRunsRepo = ReturnType<typeof llmRunsRepo>;
+//# sourceMappingURL=llm-runs.d.ts.map

package/dist/repos/llm-runs.d.ts.map

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

package/dist/repos/llm-runs.js

@@ -0,0 +1,214 @@
+/**
+ * llmRunsRepo — adminium_llm_runs (07-meta-store.md §3.19, 06-llm-assist.md §7.4).
+ *
+ * One row = one enrichment attempt (provider API or BYO paste). This repo is the
+ * thin persistence layer: it round-trips rows and validates the json payloads it
+ * writes. The §7.4 run-lifecycle transition rules and run immutability live one
+ * layer up in the server run-service — the repo's `updateStatus` accepts an
+ * optional `expected` current-status guard so the service can transition
+ * atomically, but it does not itself know the legal transition graph.
+ *
+ * §9 telemetry-free guarantee: for BYO runs `provider`/`model` stay NULL. The
+ * repo never fills them; enforcing "BYO ⇒ null" is the run-service's job.
+ */
+import { newId } from '../ids.js';
+import { llmRunLocalesSchema, llmRunModeSchema, llmRunReviewSchema, llmRunSamplingSchema, llmRunSectionsSchema, llmRunStatusSchema, llmValidationStatusSchema, } from '../schema/json-payloads.js';
+import { MetaValidationError, packJson, readJsonOrNull } from './util.js';
+function decode(row) {
+    return {
+        id: row.id,
+        connectionId: row.connectionId,
+        snapshotId: row.snapshotId,
+        mode: row.mode,
+        provider: row.provider,
+        model: row.model,
+        promptVersion: row.promptVersion,
+        promptHash: row.promptHash,
+        promptText: row.promptText,
+        sections: readJsonOrNull(row.sections),
+        locales: readJsonOrNull(row.locales),
+        sampling: readJsonOrNull(row.sampling),
+        chunksTotal: row.chunksTotal,
+        chunksReceived: row.chunksReceived,
+        responseRaw: row.responseRaw,
+        responseJson: readJsonOrNull(row.responseJson),
+        status: row.status,
+        validationStatus: row.validationStatus,
+        validationErrors: readJsonOrNull(row.validationErrors),
+        review: readJsonOrNull(row.review),
+        tokensIn: row.tokensIn,
+        tokensOut: row.tokensOut,
+        durationMs: row.durationMs,
+        appliedBy: row.appliedBy,
+        appliedAt: row.appliedAt,
+        createdBy: row.createdBy,
+        createdAt: row.createdAt,
+    };
+}
+export function llmRunsRepo(meta) {
+    const { db } = meta;
+    async function findById(id) {
+        const row = await db.selectFrom('adminium_llm_runs').selectAll().where('id', '=', id).executeTakeFirst();
+        return row === undefined ? null : decode(row);
+    }
+    return {
+        findById,
+        /** Persist a new run (typically a `draft`). Validates every json payload before writing. */
+        async create(input, at = Date.now()) {
+            const mode = llmRunModeSchema.safeParse(input.mode);
+            if (!mode.success)
+                throw new MetaValidationError('invalid llm run mode', mode.error.issues);
+            const status = llmRunStatusSchema.safeParse(input.status ?? 'draft');
+            if (!status.success)
+                throw new MetaValidationError('invalid llm run status', status.error.issues);
+            const validationStatus = llmValidationStatusSchema.safeParse(input.validationStatus ?? 'pending');
+            if (!validationStatus.success) {
+                throw new MetaValidationError('invalid llm validation status', validationStatus.error.issues);
+            }
+            let sections = null;
+            if (input.sections !== null && input.sections !== undefined) {
+                const parsed = llmRunSectionsSchema.safeParse(input.sections);
+                if (!parsed.success)
+                    throw new MetaValidationError('invalid llm run sections', parsed.error.issues);
+                sections = packJson(parsed.data);
+            }
+            let locales = null;
+            if (input.locales !== null && input.locales !== undefined) {
+                const parsed = llmRunLocalesSchema.safeParse(input.locales);
+                if (!parsed.success)
+                    throw new MetaValidationError('invalid llm run locales', parsed.error.issues);
+                locales = packJson(parsed.data);
+            }
+            let sampling = null;
+            if (input.sampling !== undefined) {
+                const parsed = llmRunSamplingSchema.safeParse(input.sampling);
+                if (!parsed.success)
+                    throw new MetaValidationError('invalid llm run sampling', parsed.error.issues);
+                sampling = packJson(parsed.data);
+            }
+            const row = {
+                id: input.id ?? newId('run'),
+                connectionId: input.connectionId,
+                snapshotId: input.snapshotId,
+                mode: mode.data,
+                provider: input.provider ?? null,
+                model: input.model ?? null,
+                promptVersion: input.promptVersion,
+                promptHash: input.promptHash,
+                promptText: input.promptText ?? null,
+                sections,
+                locales,
+                sampling,
+                chunksTotal: input.chunksTotal ?? 1,
+                chunksReceived: input.chunksReceived ?? 0,
+                responseRaw: null,
+                responseJson: null,
+                status: status.data,
+                validationStatus: validationStatus.data,
+                validationErrors: null,
+                review: null,
+                tokensIn: null,
+                tokensOut: null,
+                durationMs: null,
+                appliedAt: null,
+                appliedBy: null,
+                createdBy: input.createdBy ?? null,
+                createdAt: at,
+            };
+            await db.insertInto('adminium_llm_runs').values(row).execute();
+            return decode(row);
+        },
+        /** Run history for a connection, newest first. */
+        async listForConnection(connectionId) {
+            const rows = await db
+                .selectFrom('adminium_llm_runs')
+                .selectAll()
+                .where('connectionId', '=', connectionId)
+                .orderBy('createdAt', 'desc')
+                .orderBy('id', 'desc')
+                .execute();
+            return rows.map(decode);
+        },
+        /**
+         * Set the lifecycle status. When `expected` is given the update only lands if
+         * the row is still in that status (optimistic transition) — the server
+         * run-service uses this to make transitions atomic. Returns whether a row
+         * changed.
+         */
+        async updateStatus(id, status, opts = {}) {
+            const valid = llmRunStatusSchema.safeParse(status);
+            if (!valid.success)
+                throw new MetaValidationError('invalid llm run status', valid.error.issues);
+            let query = db.updateTable('adminium_llm_runs').set({ status: valid.data }).where('id', '=', id);
+            if (opts.expected !== undefined)
+                query = query.where('status', '=', opts.expected);
+            const res = await query.executeTakeFirst();
+            return Number(res.numUpdatedRows) === 1;
+        },
+        /** Persist a validated (or fatally-rejected) response and advance the run. */
+        async recordResponse(id, patch) {
+            const status = llmRunStatusSchema.safeParse(patch.status);
+            if (!status.success)
+                throw new MetaValidationError('invalid llm run status', status.error.issues);
+            const validationStatus = llmValidationStatusSchema.safeParse(patch.validationStatus);
+            if (!validationStatus.success) {
+                throw new MetaValidationError('invalid llm validation status', validationStatus.error.issues);
+            }
+            const set = {
+                status: status.data,
+                validationStatus: validationStatus.data,
+            };
+            if (patch.responseRaw !== undefined)
+                set.responseRaw = patch.responseRaw;
+            if (patch.responseJson !== undefined) {
+                set.responseJson = patch.responseJson === null ? null : packJson(patch.responseJson);
+            }
+            if (patch.validationErrors !== undefined) {
+                set.validationErrors = patch.validationErrors === null ? null : packJson(patch.validationErrors);
+            }
+            if (patch.chunksReceived !== undefined)
+                set.chunksReceived = patch.chunksReceived;
+            if (patch.tokensIn !== undefined)
+                set.tokensIn = patch.tokensIn;
+            if (patch.tokensOut !== undefined)
+                set.tokensOut = patch.tokensOut;
+            if (patch.durationMs !== undefined)
+                set.durationMs = patch.durationMs;
+            const res = await db.updateTable('adminium_llm_runs').set(set).where('id', '=', id).executeTakeFirst();
+            return Number(res.numUpdatedRows) === 1;
+        },
+        /** Persist the accepted/rejected suggestion-id lists (§8.3). */
+        async recordReview(id, review) {
+            const valid = llmRunReviewSchema.safeParse(review);
+            if (!valid.success)
+                throw new MetaValidationError('invalid llm run review', valid.error.issues);
+            const res = await db
+                .updateTable('adminium_llm_runs')
+                .set({ review: packJson(valid.data) })
+                .where('id', '=', id)
+                .executeTakeFirst();
+            return Number(res.numUpdatedRows) === 1;
+        },
+        /** Terminal apply: stamp applied_at/applied_by, set the terminal status, persist the review. */
+        async markApplied(id, input, at = Date.now()) {
+            const status = llmRunStatusSchema.safeParse(input.status);
+            if (!status.success || (status.data !== 'applied' && status.data !== 'partially_applied')) {
+                throw new MetaValidationError('markApplied status must be applied | partially_applied');
+            }
+            const set = {
+                status: status.data,
+                appliedBy: input.appliedBy ?? null,
+                appliedAt: at,
+            };
+            if (input.review !== undefined) {
+                const review = llmRunReviewSchema.safeParse(input.review);
+                if (!review.success)
+                    throw new MetaValidationError('invalid llm run review', review.error.issues);
+                set.review = packJson(review.data);
+            }
+            const res = await db.updateTable('adminium_llm_runs').set(set).where('id', '=', id).executeTakeFirst();
+            return Number(res.numUpdatedRows) === 1;
+        },
+    };
+}
+//# sourceMappingURL=llm-runs.js.map

package/dist/repos/llm-runs.js.map

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

package/dist/repos/notification-prefs.d.ts

@@ -0,0 +1,34 @@
+/**
+ * notificationPrefsRepo — adminium_notification_prefs (07-meta-store.md §3.21):
+ * composite-PK `(user_id, event_key)` matrix of per-event delivery channels
+ * (`notificationChannelsSchema` — inApp / email / push).
+ *
+ * A missing row means "defaults" ({@link DEFAULT_NOTIFICATION_CHANNELS}), so
+ * the table only stores deviations — reads merge, writes upsert. Channel
+ * AVAILABILITY (no SMTP ⇒ email undeliverable) is a server concern layered on
+ * top; the repo stores the user's intent verbatim so it survives the day a
+ * transport appears (§8.2 never-hide-always-explain).
+ */
+import type { MetaDb } from '../connect.js';
+import { type NotificationChannels } from '../schema/json-payloads.js';
+/** Default per-event channels when no row exists (comp: push opt-in). */
+export declare const DEFAULT_NOTIFICATION_CHANNELS: NotificationChannels;
+export interface NotificationPref {
+    userId: string;
+    eventKey: string;
+    channels: NotificationChannels;
+    updatedAt: number;
+}
+export declare function notificationPrefsRepo(meta: MetaDb): {
+    get: (userId: string, eventKey: string) => Promise<NotificationPref | null>;
+    /** Stored channels for one event, defaults when no row exists. */
+    channelsFor(userId: string, eventKey: string): Promise<NotificationChannels>;
+    listForUser(userId: string): Promise<NotificationPref[]>;
+    /**
+     * Composite-PK upsert, portably: UPDATE first, INSERT on zero affected
+     * rows (the meta store has no cross-dialect ON CONFLICT — repos/util.ts).
+     */
+    upsert(userId: string, eventKey: string, channels: NotificationChannels, at?: number): Promise<NotificationPref>;
+};
+export type NotificationPrefsRepo = ReturnType<typeof notificationPrefsRepo>;
+//# sourceMappingURL=notification-prefs.d.ts.map

package/dist/repos/notification-prefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-prefs.d.ts","sourceRoot":"","sources":["../../src/repos/notification-prefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGnG,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,EAAE,oBAI3C,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM;kBAGrB,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAmBpF,kEAAkE;wBACxC,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;wBAIxD,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAe9D;;;OAGG;mBAEO,MAAM,YACJ,MAAM,YACN,oBAAoB,OAC1B,MAAM,GACT,OAAO,CAAC,gBAAgB,CAAC;EAiB/B;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/repos/notification-prefs.js

@@ -0,0 +1,80 @@
+/**
+ * notificationPrefsRepo — adminium_notification_prefs (07-meta-store.md §3.21):
+ * composite-PK `(user_id, event_key)` matrix of per-event delivery channels
+ * (`notificationChannelsSchema` — inApp / email / push).
+ *
+ * A missing row means "defaults" ({@link DEFAULT_NOTIFICATION_CHANNELS}), so
+ * the table only stores deviations — reads merge, writes upsert. Channel
+ * AVAILABILITY (no SMTP ⇒ email undeliverable) is a server concern layered on
+ * top; the repo stores the user's intent verbatim so it survives the day a
+ * transport appears (§8.2 never-hide-always-explain).
+ */
+import { notificationChannelsSchema } from '../schema/json-payloads.js';
+import { affected, packJson, readJson } from './util.js';
+/** Default per-event channels when no row exists (comp: push opt-in). */
+export const DEFAULT_NOTIFICATION_CHANNELS = {
+    inApp: true,
+    email: true,
+    push: false,
+};
+export function notificationPrefsRepo(meta) {
+    const { db } = meta;
+    async function get(userId, eventKey) {
+        const row = await db
+            .selectFrom('adminium_notification_prefs')
+            .selectAll()
+            .where('userId', '=', userId)
+            .where('eventKey', '=', eventKey)
+            .executeTakeFirst();
+        if (row === undefined)
+            return null;
+        return {
+            userId: row.userId,
+            eventKey: row.eventKey,
+            channels: notificationChannelsSchema.parse(readJson(row.channels)),
+            updatedAt: row.updatedAt,
+        };
+    }
+    return {
+        get,
+        /** Stored channels for one event, defaults when no row exists. */
+        async channelsFor(userId, eventKey) {
+            return (await get(userId, eventKey))?.channels ?? { ...DEFAULT_NOTIFICATION_CHANNELS };
+        },
+        async listForUser(userId) {
+            const rows = await db
+                .selectFrom('adminium_notification_prefs')
+                .selectAll()
+                .where('userId', '=', userId)
+                .orderBy('eventKey', 'asc')
+                .execute();
+            return rows.map((row) => ({
+                userId: row.userId,
+                eventKey: row.eventKey,
+                channels: notificationChannelsSchema.parse(readJson(row.channels)),
+                updatedAt: row.updatedAt,
+            }));
+        },
+        /**
+         * Composite-PK upsert, portably: UPDATE first, INSERT on zero affected
+         * rows (the meta store has no cross-dialect ON CONFLICT — repos/util.ts).
+         */
+        async upsert(userId, eventKey, channels, at = Date.now()) {
+            const packed = packJson(notificationChannelsSchema.parse(channels));
+            const res = await db
+                .updateTable('adminium_notification_prefs')
+                .set({ channels: packed, updatedAt: at })
+                .where('userId', '=', userId)
+                .where('eventKey', '=', eventKey)
+                .executeTakeFirst();
+            if (affected(res.numUpdatedRows) === 0) {
+                await db
+                    .insertInto('adminium_notification_prefs')
+                    .values({ userId, eventKey, channels: packed, updatedAt: at })
+                    .execute();
+            }
+            return { userId, eventKey, channels, updatedAt: at };
+        },
+    };
+}
+//# sourceMappingURL=notification-prefs.js.map

package/dist/repos/notification-prefs.js.map

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

package/dist/repos/notifications.d.ts

@@ -0,0 +1,60 @@
+/**
+ * notificationsRepo — adminium_notifications (07-meta-store.md §3.20): one row
+ * per in-app notification. Write-once rows read later, so `kind` is the
+ * stable, translatable key and `title`/`body` are the en-US fallback for a
+ * client that does not know the kind (the backup/notify.ts convention — the
+ * first producer — now shared by every producer through this repo).
+ *
+ * Keyset pagination: `(created_at DESC, id DESC)` — ids are monotonic ULIDs,
+ * so the pair is a stable total order (08-server-api.md §1.5).
+ */
+import type { MetaDb } from '../connect.js';
+export interface Notification {
+    id: string;
+    userId: string;
+    /** Stable localization key, e.g. `report.ready`, `desktop.backup.completed`. */
+    kind: string;
+    actorLabel: string;
+    title: string;
+    body: string | null;
+    /** Kind-specific substitutions the client localizes at RENDER time. */
+    entity: Record<string, unknown> | null;
+    actionUrl: string | null;
+    readAt: number | null;
+    createdAt: number;
+}
+export interface CreateNotificationInput {
+    userId: string;
+    kind: string;
+    /** Defaults to the system actor label (ia-mapping keeper). */
+    actorLabel?: string | undefined;
+    title: string;
+    body?: string | null | undefined;
+    entity?: Record<string, unknown> | null | undefined;
+    actionUrl?: string | null | undefined;
+}
+/** Keyset cursor — the last row of the previous page. */
+export interface NotificationCursor {
+    createdAt: number;
+    id: string;
+}
+export interface ListNotificationsOptions {
+    unreadOnly?: boolean | undefined;
+    limit?: number | undefined;
+    before?: NotificationCursor | undefined;
+}
+/** System-actor events render actor "Adminium" (09-generated-app.md §5.4). */
+export declare const SYSTEM_ACTOR_LABEL = "Adminium";
+export declare function notificationsRepo(meta: MetaDb): {
+    create(input: CreateNotificationInput, at?: number): Promise<Notification>;
+    findById(id: string): Promise<Notification | null>;
+    /** Newest first; keyset `before` = the previous page's last row. */
+    listForUser(userId: string, opts?: ListNotificationsOptions): Promise<Notification[]>;
+    /** The nav-badge / bell number (09 §5.4 `unread-count`). */
+    unreadCount(userId: string): Promise<number>;
+    /** Scoped to the owner — a foreign id is a silent no-op, never a leak. */
+    markRead(id: string, userId: string, at?: number): Promise<boolean>;
+    markAllRead(userId: string, at?: number): Promise<number>;
+};
+export type NotificationsRepo = ReturnType<typeof notificationsRepo>;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/repos/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/repos/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAK5C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACzC;AAED,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAiB7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM;kBAItB,uBAAuB,OAAM,MAAM,GAAgB,OAAO,CAAC,YAAY,CAAC;iBAiBzE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IASxD,oEAAoE;wBAC1C,MAAM,SAAQ,wBAAwB,GAAQ,OAAO,CAAC,YAAY,EAAE,CAAC;IAoB/F,4DAA4D;wBAClC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlD,0EAA0E;iBACvD,MAAM,UAAU,MAAM,OAAM,MAAM,GAAgB,OAAO,CAAC,OAAO,CAAC;wBAW3D,MAAM,OAAM,MAAM,GAAgB,OAAO,CAAC,MAAM,CAAC;EAU9E;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}