@raybase/core 0.0.2 → 0.3.4

package/dist/notification-client.d.ts

@@ -0,0 +1,94 @@
+import type { RaybaseNotificationFeedItem } from "./notifications.js";
+import type { RealtimeStatus } from "./realtime.js";
+export type NotificationClientOptions = {
+    endpoint?: string;
+    realtimeEndpoint?: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    WebSocket?: new (url: string) => WebSocket;
+};
+export type NotificationSubscriptionHandlers = {
+    onNotification?: (event: {
+        event: "created" | "read" | "archived" | "deleted";
+        item: RaybaseNotificationFeedItem;
+        seq: number;
+    }) => void;
+    onCount?: (event: {
+        unread: number;
+        seq: number;
+    }) => void;
+    onResync?: (event: {
+        reason: "gap" | "retention-expired" | "auth-stale";
+        latestSeq?: number;
+    }) => void;
+    onStatus?: (status: RealtimeStatus) => void;
+    onError?: (error: Error) => void;
+};
+export type NotificationPushSubscriptionJson = {
+    endpoint: string;
+    expirationTime?: number | null;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+};
+export type NotificationPushSubscriptionSummary = {
+    id: string;
+    endpointOrigin: string;
+    endpointHashPrefix: string;
+    label: string | null;
+    status: "active" | "expired" | "revoked";
+    failureCount: number;
+    lastSeenAt: string;
+    lastUsedAt: string | null;
+};
+export declare function createNotificationClient(options?: NotificationClientOptions): {
+    list(input?: {
+        status?: "unread" | "read" | "archived" | "all";
+        limit?: number;
+        cursor?: number;
+        since?: number;
+    }): Promise<{
+        items: RaybaseNotificationFeedItem[];
+        nextCursor: number | null;
+    }>;
+    unreadCount(): Promise<{
+        unread: number;
+        seq: number;
+    }>;
+    markRead(feedItemId: string): Promise<{
+        item: RaybaseNotificationFeedItem;
+    }>;
+    readAll(): Promise<{
+        updated: number;
+        unread: number;
+        seq: number;
+    }>;
+    archive(feedItemId: string): Promise<{
+        item: RaybaseNotificationFeedItem;
+    }>;
+    push: {
+        publicKey(): Promise<{
+            enabled: boolean;
+            publicKey: string | null;
+        }>;
+        list(): Promise<{
+            subscriptions: NotificationPushSubscriptionSummary[];
+        }>;
+        subscribe(subscription: NotificationPushSubscriptionJson, input?: {
+            label?: string;
+        }): Promise<{
+            subscription: NotificationPushSubscriptionSummary;
+            evicted: NotificationPushSubscriptionSummary[];
+        }>;
+        unsubscribe(pushEndpoint: string): Promise<{
+            removed: boolean;
+        }>;
+    };
+    subscribe(handlers?: NotificationSubscriptionHandlers, input?: {
+        lastSeq?: number;
+    }): {
+        unsubscribe(): void;
+    };
+};
+//# sourceMappingURL=notification-client.d.ts.map

package/dist/notification-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-client.d.ts","sourceRoot":"","sources":["../src/notification-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QACvB,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;QACnD,IAAI,EAAE,2BAA2B,CAAC;QAClC,GAAG,EAAE,MAAM,CAAC;KACb,KAAK,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,KAAK,GAAG,mBAAmB,GAAG,YAAY,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAkCF,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,yBAA8B;iBAO1D;QAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;eAK1F,2BAA2B,EAAE;oBAAc,MAAM,GAAG,IAAI;;;gBAKvD,MAAM;aAAO,MAAM;;yBAIrB,MAAM;cACN,2BAA2B;;;iBAQxB,MAAM;gBAAU,MAAM;aAAO,MAAM;;wBAOvC,MAAM;cACL,2BAA2B;;;;qBAStB,OAAO;uBAAa,MAAM,GAAG,IAAI;;;2BAK3B,mCAAmC,EAAE;;gCAI3C,gCAAgC,UAAS;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE;0BACtD,mCAAmC;qBAAW,mCAAmC,EAAE;;kCAStF,MAAM;qBACR,OAAO;;;yBAUnB,gCAAgC,UAAc;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;;;EA+BzF"}

package/dist/notification-client.js

@@ -0,0 +1,127 @@
+function defaultFetch() {
+    if (typeof fetch === "undefined")
+        throw new Error("fetch is not available");
+    return fetch.bind(globalThis);
+}
+function defaultWebSocket() {
+    const ctor = globalThis.WebSocket;
+    if (!ctor)
+        throw new Error("WebSocket is not available");
+    return ctor;
+}
+function absoluteUrl(baseUrl, path) {
+    const base = baseUrl ?? (typeof location !== "undefined" ? `${location.protocol}//${location.host}` : "http://localhost");
+    return new URL(path, base).toString();
+}
+function websocketUrl(baseUrl, path) {
+    const url = new URL(absoluteUrl(baseUrl, path));
+    url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+    return url.toString();
+}
+async function parseJson(response) {
+    const json = (await response.json().catch(() => ({})));
+    if (!response.ok)
+        throw new Error(json.error || `Notification request failed with ${response.status}`);
+    return json;
+}
+function refId(prefix) {
+    return `${prefix}_${Math.random().toString(36).slice(2)}_${Date.now().toString(36)}`;
+}
+export function createNotificationClient(options = {}) {
+    const endpoint = options.endpoint ?? "/api/notifications";
+    const realtimeEndpoint = options.realtimeEndpoint ?? "/api/realtime";
+    const fetchImpl = options.fetch ?? defaultFetch();
+    const WebSocketCtor = options.WebSocket ?? defaultWebSocket();
+    return {
+        async list(input = {}) {
+            const url = new URL(absoluteUrl(options.baseUrl, endpoint));
+            for (const [key, value] of Object.entries(input)) {
+                if (value !== undefined)
+                    url.searchParams.set(key, String(value));
+            }
+            return parseJson(await fetchImpl(url.toString(), { credentials: "same-origin" }));
+        },
+        async unreadCount() {
+            return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/unread-count`), { credentials: "same-origin" }));
+        },
+        async markRead(feedItemId) {
+            return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/${encodeURIComponent(feedItemId)}/read`), {
+                method: "POST",
+                credentials: "same-origin"
+            }));
+        },
+        async readAll() {
+            return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/read-all`), {
+                method: "POST",
+                credentials: "same-origin"
+            }));
+        },
+        async archive(feedItemId) {
+            return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/${encodeURIComponent(feedItemId)}/archive`), {
+                method: "POST",
+                credentials: "same-origin"
+            }));
+        },
+        push: {
+            async publicKey() {
+                return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/push/public-key`), { credentials: "same-origin" }));
+            },
+            async list() {
+                return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/push/subscriptions`), { credentials: "same-origin" }));
+            },
+            async subscribe(subscription, input = {}) {
+                return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/push/subscriptions`), {
+                    method: "PUT",
+                    credentials: "same-origin",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({ ...subscription, label: input.label })
+                }));
+            },
+            async unsubscribe(pushEndpoint) {
+                return parseJson(await fetchImpl(absoluteUrl(options.baseUrl, `${endpoint}/push/subscriptions`), {
+                    method: "DELETE",
+                    credentials: "same-origin",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({ endpoint: pushEndpoint })
+                }));
+            }
+        },
+        subscribe(handlers = {}, input = {}) {
+            const socket = new WebSocketCtor(websocketUrl(options.baseUrl, realtimeEndpoint));
+            socket.addEventListener("open", () => {
+                handlers.onStatus?.("connecting");
+                socket.send(JSON.stringify({ v: 1, ref: refId("notif"), type: "notifications.subscribe", lastSeq: input.lastSeq }));
+            });
+            socket.addEventListener("message", (event) => {
+                let message;
+                try {
+                    message = JSON.parse(String(event.data));
+                }
+                catch {
+                    return;
+                }
+                if (message.type === "status")
+                    handlers.onStatus?.(message.status);
+                if (message.type === "notification")
+                    handlers.onNotification?.({ event: message.event, item: message.item, seq: message.seq });
+                if (message.type === "notifications.count")
+                    handlers.onCount?.({ unread: message.unread, seq: message.seq });
+                if (message.type === "notifications.resync")
+                    handlers.onResync?.({ reason: message.reason, latestSeq: message.latestSeq });
+                if (message.type === "error")
+                    handlers.onError?.(new Error(message.message));
+            });
+            socket.addEventListener("close", () => handlers.onStatus?.("closed"));
+            socket.addEventListener("error", () => handlers.onStatus?.("error"));
+            return {
+                unsubscribe() {
+                    if (socket.readyState === WebSocket.OPEN) {
+                        socket.send(JSON.stringify({ v: 1, ref: refId("notif_unsub"), type: "notifications.unsubscribe" }));
+                    }
+                    socket.close();
+                }
+            };
+        }
+    };
+}
+//# sourceMappingURL=notification-client.js.map

package/dist/notification-client.js.map

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

package/dist/notifications.d.ts

@@ -0,0 +1,447 @@
+import type { RaybaseConfig, RaybaseSystemTable } from "./schema.js";
+import type { SqlExecutor } from "./db.js";
+import type { RaybaseJobPrincipal } from "./jobs.js";
+import type { OperatorEvidenceProvider, ProviderHealth } from "./operator-mcp.js";
+import type { RaybaseUser } from "./policies.js";
+export declare const raybaseNotificationDeliveryJobName = "raybase.notifications.deliver";
+export declare const raybaseNotificationServicePrincipal = "raybase-notifications";
+export declare const raybaseNotificationJobPrefix = "raybase.notifications.";
+export declare const raybaseNotificationsTableName = "_notifications";
+export declare const raybaseNotificationRecipientsTableName = "_notification_recipients";
+export declare const raybaseNotificationSubscriptionsTableName = "_notification_subscriptions";
+export declare const raybaseNotificationDeliveriesTableName = "_notification_deliveries";
+export declare const raybaseNotificationAttemptsTableName = "_notification_attempts";
+export declare const raybaseNotificationThrottleWindowsTableName = "_notification_throttle_windows";
+export declare const raybaseInboundEventsTableName = "_inbound_events";
+export declare const defaultNotificationSubscriptionOrganizationId = "default";
+export type RaybaseNotificationSeverity = "info" | "success" | "warning" | "error";
+export type RaybaseNotificationRecipient = {
+    kind: "user";
+    userId: string;
+} | {
+    kind: "role";
+    role: string;
+} | {
+    kind: "operator";
+    role?: "owner" | "admin";
+} | {
+    kind: "current-user";
+};
+export type RaybaseNotificationTarget = {
+    href?: string;
+    entity?: {
+        type: string;
+        id: string;
+    };
+};
+export type RaybaseNotificationChannelTargets = Record<string, unknown>;
+export type SendNotificationInput = {
+    to?: RaybaseNotificationRecipient[];
+    title: string;
+    body?: string;
+    kind?: string;
+    severity?: RaybaseNotificationSeverity;
+    target?: RaybaseNotificationTarget;
+    channels?: string[];
+    channelTargets?: RaybaseNotificationChannelTargets;
+    dedupeKey?: string;
+    throttle?: {
+        key: string;
+        minInterval: string | number;
+    };
+    metadata?: unknown;
+    expiresAt?: string;
+};
+export type SendNotificationResult = {
+    notificationId?: string;
+    deduped: boolean;
+    recipients: Array<{
+        recipientSubjectId: string;
+        recipientKind: string;
+        feedItemId?: string;
+    }>;
+    deliveries: Array<{
+        deliveryId: string;
+        channel: string;
+        adapter: string;
+        recipientSubjectId?: string;
+        recipientEmail?: string;
+    }>;
+    throttled: Array<{
+        recipientSubjectId: string;
+        until: string;
+    }>;
+    skipped: Array<{
+        recipientSubjectId: string;
+        channel: string;
+        reason: "no-subscriptions";
+    }>;
+};
+export type RaybaseNotificationFeedItem = {
+    id: string;
+    notificationId: string;
+    kind?: string | null;
+    severity: RaybaseNotificationSeverity;
+    title: string;
+    body?: string | null;
+    target?: RaybaseNotificationTarget;
+    metadata?: unknown;
+    feedStatus: "unread" | "read" | "archived";
+    readAt?: string | null;
+    archivedAt?: string | null;
+    recipientSeq: number;
+    createdAt: string;
+    expiresAt?: string | null;
+};
+export type RaybaseNotificationDeliveryStatus = "pending" | "leased" | "delivered" | "failed" | "permanent_failure" | "cancelled" | "skipped_local";
+export type RaybaseNotificationDelivery = {
+    id: string;
+    notificationId: string;
+    recipientId: string | null;
+    recipientSubjectId: string | null;
+    recipientEmail: string | null;
+    recipientName: string | null;
+    channel: string;
+    adapter: string;
+    status: RaybaseNotificationDeliveryStatus;
+    attempt: number;
+    maxAttempts: number;
+    idempotencyKey: string | null;
+    availableAt: string;
+    lastAttemptAt: string | null;
+    deliveredAt: string | null;
+    failedAt: string | null;
+    providerMessageId: string | null;
+    lastErrorJson: string | null;
+    createdAt: string;
+    updatedAt: string;
+    notification: {
+        id: string;
+        kind: string | null;
+        severity: RaybaseNotificationSeverity;
+        title: string;
+        body: string | null;
+        targetHref: string | null;
+        targetEntityType: string | null;
+        targetEntityId: string | null;
+        metadata: unknown;
+        actorKind: string;
+        actorId: string | null;
+        createdAt: string;
+    };
+};
+export type RaybaseNotificationSendResult = {
+    status: "delivered" | "skipped";
+    providerMessageId?: string;
+    requestSummary?: unknown;
+    responseSummary?: unknown;
+};
+export type RaybaseNotificationAdapterContext<Env = unknown> = {
+    env: Env;
+    isLocal: boolean;
+    now: string;
+};
+export type RaybaseNotificationDoctorContext<Env = unknown> = RaybaseNotificationAdapterContext<Env>;
+export type RaybaseDoctorFinding = {
+    severity: "info" | "warning" | "error";
+    message: string;
+    details?: Record<string, unknown>;
+};
+export type RaybaseNotificationAdapter<Env = unknown> = {
+    name: string;
+    channel: string;
+    description?: string;
+    allowLocalSend?: boolean;
+    send: (delivery: RaybaseNotificationDelivery, ctx: RaybaseNotificationAdapterContext<Env>) => Promise<RaybaseNotificationSendResult>;
+    classifyError?: (error: unknown) => "retry" | "permanent";
+    health?: (ctx: RaybaseNotificationAdapterContext<Env>) => Promise<ProviderHealth>;
+    doctor?: (ctx: RaybaseNotificationDoctorContext<Env>) => Promise<RaybaseDoctorFinding[]>;
+};
+export type RaybaseInboundEventInput = {
+    idempotencyKey?: string;
+    providerEventId?: string;
+    payload?: unknown;
+    actorKind?: string;
+    actorId?: string;
+};
+export type RaybaseInboundEvent = {
+    id: string;
+    adapter: string;
+    path: string;
+    status: string;
+    verified: boolean;
+    idempotencyKey: string | null;
+    providerEventId: string | null;
+    actorKind: string;
+    actorId: string | null;
+    payload: unknown;
+    receivedAt: string;
+    processedAt: string | null;
+};
+export type RaybaseInboundAdapterContext<Env = unknown> = {
+    env: Env;
+    request: Request;
+};
+export type RaybaseInboundHandlerContext<Env = unknown> = {
+    env: Env;
+    request: Request;
+    event: RaybaseInboundEvent;
+    notifications: RaybaseNotificationsRuntime<Env>;
+    jobs: {
+        enqueue: (jobName: string, input: unknown, options?: {
+            idempotencyKey?: string;
+            delay?: string | number;
+        }) => Promise<unknown>;
+    };
+    audit: (action: string, targetType: string, targetId?: string, metadata?: unknown) => Promise<void>;
+};
+export type RaybaseInboundAdapter<Env = unknown> = {
+    name: string;
+    path: string;
+    verify: (request: Request, rawBody: Uint8Array, ctx: RaybaseInboundAdapterContext<Env>) => Promise<true>;
+    parse: (request: Request, rawBody: Uint8Array, ctx: RaybaseInboundAdapterContext<Env>) => Promise<RaybaseInboundEventInput>;
+    handle: (event: RaybaseInboundEvent, ctx: RaybaseInboundHandlerContext<Env>) => Promise<unknown>;
+};
+export type RaybaseNotifications<Env = unknown> = {
+    feed?: {
+        enabled?: boolean;
+    };
+    channels?: Record<string, RaybaseNotificationAdapter<Env>>;
+    inbound?: Record<string, RaybaseInboundAdapter<Env>>;
+};
+export type NotificationListOptions = {
+    status?: "unread" | "read" | "archived" | "all";
+    limit?: number;
+    cursor?: number;
+    since?: number;
+};
+export type RaybaseNotificationsRuntime<Env = unknown> = {
+    enabled: boolean;
+    feedEnabled: boolean;
+    send(input: SendNotificationInput): Promise<SendNotificationResult>;
+    list(options?: NotificationListOptions): Promise<{
+        items: RaybaseNotificationFeedItem[];
+        nextCursor: number | null;
+    }>;
+    unreadCount(): Promise<{
+        unread: number;
+        seq: number;
+    }>;
+    markRead(feedItemId: string): Promise<RaybaseNotificationFeedItem>;
+    markAllRead(): Promise<{
+        updated: number;
+        unread: number;
+        seq: number;
+    }>;
+    archive(feedItemId: string): Promise<RaybaseNotificationFeedItem>;
+};
+export type RaybaseNotificationSubscription = {
+    id: string;
+    organizationId: string;
+    userId: string;
+    kind: string;
+    enabled: boolean;
+    channels: string[];
+    createdAt: string;
+    updatedAt: string;
+};
+export type RaybaseNotificationThrottleWindow = {
+    id: string;
+    throttleKey: string;
+    recipientSubjectId: string;
+    maskedRecipientSubjectId: string;
+    lastSentAt: string;
+    windowExpiresAt: string;
+    suppressedCount: number;
+    firstSuppressedAt?: string | null;
+    lastSuppressed?: unknown;
+    updatedAt: string;
+};
+export declare class NotificationError extends Error {
+    readonly code: "disabled" | "invalid-input" | "invalid-channel" | "recipient-unavailable" | "payload-too-large" | "auth-required" | "not-found";
+    constructor(message: string, code: "disabled" | "invalid-input" | "invalid-channel" | "recipient-unavailable" | "payload-too-large" | "auth-required" | "not-found");
+}
+export type NotificationConfigInput = NonNullable<RaybaseConfig["notifications"]>;
+export type ResolvedNotificationConfig = {
+    enabled: boolean;
+    maxRecipientsPerSend: number;
+    maxBodyBytes: number;
+    maxMetadataBytes: number;
+    maxChannelTargetsBytes: number;
+    maxInboundBodyBytes: number;
+    feed: {
+        enabled: boolean;
+        endpoint: string;
+    };
+    delivery: {
+        maxAttempts: number;
+        timeoutMs: number;
+    };
+};
+export type NotificationRuntimeOptions<Env> = {
+    env: Env;
+    config: RaybaseConfig;
+    notifications?: RaybaseNotifications<Env>;
+    db: SqlExecutor;
+    currentUser?: RaybaseUser | null;
+    actor?: {
+        kind: string;
+        id?: string | null;
+    };
+    source?: {
+        type?: string;
+        id?: string | null;
+    };
+    isLocal?: boolean;
+    enqueueDelivery?: () => Promise<void>;
+    activeWebPushSubjectIds?: (subjectIds: string[]) => Promise<Set<string>>;
+    audit?: (action: string, targetType: string, targetId?: string, metadata?: unknown) => Promise<void>;
+    notifyFeed?: (message: {
+        subjectId: string;
+        event: "created" | "read" | "archived" | "deleted";
+        item: RaybaseNotificationFeedItem;
+        unread: number;
+        seq: number;
+    }) => Promise<void>;
+};
+export type InboundRuntimeOptions<Env> = NotificationRuntimeOptions<Env> & {
+    adapter: RaybaseInboundAdapter<Env>;
+    request: Request;
+    enqueueJob?: (jobName: string, input: unknown, options?: {
+        idempotencyKey?: string;
+        delay?: string | number;
+    }) => Promise<unknown>;
+    audit?: (action: string, targetType: string, targetId?: string, metadata?: unknown) => Promise<void>;
+};
+export declare function defineNotifications<Env = unknown>(notifications: RaybaseNotifications<Env>): RaybaseNotifications<Env>;
+export declare function mergeRaybaseNotifications<Env>(base: RaybaseNotifications<Env> | undefined, contribution: RaybaseNotifications<Env> | undefined, options?: {
+    duplicateLabel?: string;
+    validate?: boolean;
+}): RaybaseNotifications<Env> | undefined;
+export declare const notificationRecipient: {
+    user(userId: string): RaybaseNotificationRecipient;
+    role(role: string): RaybaseNotificationRecipient;
+    operator(role?: "owner" | "admin"): RaybaseNotificationRecipient;
+    currentUser(): RaybaseNotificationRecipient;
+};
+export declare const notificationDefaults: {
+    maxRecipientsPerSend: number;
+    maxRecipientsHardLimit: number;
+    maxBodyBytes: number;
+    maxMetadataBytes: number;
+    maxChannelTargetsBytes: number;
+    maxInboundBodyBytes: number;
+    maxAttemptSummaryBytes: number;
+    deliveryMaxAttempts: number;
+    deliveryTimeoutMs: number;
+    throttleKeyMaxLength: number;
+    throttleMinIntervalMs: number;
+    throttleMaxIntervalMs: number;
+};
+export declare function resolveNotificationConfig(config: RaybaseConfig, notifications?: RaybaseNotifications<any>): ResolvedNotificationConfig;
+export declare function validateNotifications<Env>(notifications: RaybaseNotifications<Env>): void;
+export declare function reservedInboundPath(path: string): boolean;
+export declare const raybaseNotificationSystemTables: RaybaseSystemTable[];
+export declare function createDisabledNotificationsRuntime<Env = unknown>(): RaybaseNotificationsRuntime<Env>;
+export declare function getNotificationSubscription(db: SqlExecutor, input: {
+    organizationId?: string | null;
+    userId: string;
+    kind: string;
+}): Promise<RaybaseNotificationSubscription | null>;
+export declare function setNotificationSubscription(db: SqlExecutor, input: {
+    organizationId?: string | null;
+    userId: string;
+    kind: string;
+    enabled: boolean;
+    channels?: string[];
+}): Promise<RaybaseNotificationSubscription>;
+export declare function listNotificationSubscribers(db: SqlExecutor, kind: string, input?: {
+    organizationId?: string | null;
+}): Promise<Array<{
+    userId: string;
+    channels: string[];
+}>>;
+export declare function createNotificationsRuntime<Env>(options: NotificationRuntimeOptions<Env>): RaybaseNotificationsRuntime<Env>;
+export declare function claimAndRunNotificationDeliveries<Env>(options: NotificationRuntimeOptions<Env>): Promise<{
+    processed: number;
+}>;
+export type NotificationAdminSummary = {
+    deliveryCounts: Array<{
+        status: string;
+        channel: string;
+        adapter: string;
+        count: number;
+    }>;
+    inboundCounts: Array<{
+        status: string;
+        adapter: string;
+        count: number;
+    }>;
+    adapters: Array<{
+        channel: string;
+        adapter: string;
+        description?: string;
+    }>;
+};
+export declare function notificationAdminSummary<Env>(db: SqlExecutor, notifications?: RaybaseNotifications<Env>): Promise<NotificationAdminSummary>;
+export declare function notificationThrottleWindowsQuery(db: SqlExecutor, options?: {
+    activeOnly?: boolean;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    throttles: RaybaseNotificationThrottleWindow[];
+}>;
+export declare function resetNotificationThrottleWindow(db: SqlExecutor, id: string): Promise<{
+    ok: true;
+    throttle?: RaybaseNotificationThrottleWindow;
+}>;
+export declare function compactNotificationThrottleWindows(db: SqlExecutor, now?: string): Promise<{
+    deleted: number;
+}>;
+export declare function notificationDeliveriesQuery(db: SqlExecutor, options?: {
+    status?: string;
+    channel?: string;
+    adapter?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    deliveries: Record<string, unknown>[];
+}>;
+export declare function notificationDeliveryDetail(db: SqlExecutor, deliveryId: string): Promise<Record<string, unknown> | null>;
+export declare function retryNotificationDelivery(db: SqlExecutor, deliveryId: string): Promise<{
+    ok: true;
+    previousStatus: string;
+}>;
+export declare function notificationInboundEventsQuery(db: SqlExecutor, options?: {
+    status?: string;
+    adapter?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    events: Record<string, unknown>[];
+}>;
+export declare function notificationInboundEventDetail(db: SqlExecutor, eventId: string): Promise<Record<string, unknown> | null>;
+export declare function createNotificationsOperatorEvidenceProvider<Env>(dbForContext: (ctx: {
+    env: Env;
+}) => SqlExecutor, notifications?: RaybaseNotifications<Env>): OperatorEvidenceProvider<Env>;
+export declare function handleInboundNotification<Env>(options: InboundRuntimeOptions<Env>): Promise<Response>;
+export type WebhookOutboundOptions<Env> = {
+    name: string;
+    url: (env: Env) => string | undefined | null;
+    signingSecret: (env: Env) => string | undefined | null;
+    headers?: (delivery: RaybaseNotificationDelivery, ctx: RaybaseNotificationAdapterContext<Env>) => Record<string, string>;
+    allowLocalSend?: boolean;
+    timeoutMs?: number;
+};
+export declare function webhookOutboundAdapter<Env = unknown>(options: WebhookOutboundOptions<Env>): RaybaseNotificationAdapter<Env>;
+export type WebhookInboundOptions<Env> = {
+    name: string;
+    path: string;
+    signingSecret: (env: Env) => string | undefined | null;
+    replayWindowSeconds?: number;
+    parse?: (request: Request) => Promise<RaybaseInboundEventInput>;
+    handle: (event: RaybaseInboundEvent, ctx: RaybaseInboundHandlerContext<Env>) => Promise<unknown>;
+};
+export declare function webhookInboundAdapter<Env = unknown>(options: WebhookInboundOptions<Env>): RaybaseInboundAdapter<Env>;
+export declare function notificationJobPrincipal(): RaybaseJobPrincipal;
+//# sourceMappingURL=notifications.d.ts.map