@sylphx/contract 0.2.0

package/dist/endpoints/notifications-admin.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Notifications Admin endpoints — Console-plane admin / broadcast /
+ * subscription management for web push, mobile push, and in-app messages.
+ * Distinct from BaaS `notificationsEndpoints` (register/unregister/send/
+ * preferences) served by the runtime.
+ *
+ * Production mount: `/notifications/*` (see
+ * `apps/api/src/server/platform/app.ts`). All operations are
+ * `plane: 'management'` — they require an authenticated Console user with
+ * project access or (for the cross-project push admin paths) super-admin
+ * role; the BaaS plane's per-user push registration lives under a different
+ * endpoint group.
+ */
+export declare const notificationsAdminEndpoints: {
+    readonly pushConfig: import("../endpoint.js").Endpoint<"GET", "/notifications/push/config", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        configured: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly sendPush: import("../endpoint.js").Endpoint<"POST", "/notifications/push/send", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        userId: typeof import("effect/Schema").String;
+        title: typeof import("effect/Schema").String;
+        body: typeof import("effect/Schema").String;
+        icon: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        url: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        sentTo: typeof import("effect/Schema").Number;
+        expired: typeof import("effect/Schema").Number;
+    }>>;
+    readonly broadcastPush: import("../endpoint.js").Endpoint<"POST", "/notifications/push/broadcast", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        title: typeof import("effect/Schema").String;
+        body: typeof import("effect/Schema").String;
+        icon: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        url: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        sentTo: typeof import("effect/Schema").Number;
+        expired: typeof import("effect/Schema").Number;
+        totalUsers: typeof import("effect/Schema").Number;
+    }>>;
+    readonly pushStats: import("../endpoint.js").Endpoint<"GET", "/notifications/push/stats", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        days: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        subscriptions: import("effect/Schema").Struct<{
+            total: typeof import("effect/Schema").Number;
+            activeUsers: typeof import("effect/Schema").Number;
+            activeApps: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            avgPerUser: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        }>;
+        delivery: import("effect/Schema").Struct<{
+            total: typeof import("effect/Schema").Number;
+            successful: typeof import("effect/Schema").Number;
+            failed: typeof import("effect/Schema").Number;
+            successRate: typeof import("effect/Schema").Number;
+        }>;
+        growth: import("effect/Schema").optional<import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            date: typeof import("effect/Schema").String;
+            count: typeof import("effect/Schema").Number;
+        }>>>;
+        period: import("effect/Schema").Struct<{
+            days: typeof import("effect/Schema").Number;
+            since: typeof import("effect/Schema").String;
+        }>;
+    }>>;
+    readonly listSubscriptions: import("../endpoint.js").Endpoint<"GET", "/notifications/push/subscriptions", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        userId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        subscriptions: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            projectId: typeof import("effect/Schema").String;
+            app: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+                id: typeof import("effect/Schema").String;
+                name: typeof import("effect/Schema").String;
+                slug: typeof import("effect/Schema").String;
+            }>>>;
+            userId: typeof import("effect/Schema").String;
+            endpoint: typeof import("effect/Schema").String;
+            createdAt: typeof import("effect/Schema").String;
+        }>>;
+        total: typeof import("effect/Schema").Number;
+        limit: typeof import("effect/Schema").Number;
+        offset: typeof import("effect/Schema").Number;
+    }>>;
+    readonly removeSubscriptions: import("../endpoint.js").Endpoint<"POST", "/notifications/push/subscriptions/remove", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        userId: typeof import("effect/Schema").String;
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        removedCount: typeof import("effect/Schema").Number;
+    }>>;
+    readonly mobileConfig: import("../endpoint.js").Endpoint<"GET", "/notifications/mobile/config", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        ios: typeof import("effect/Schema").Boolean;
+        android: typeof import("effect/Schema").Boolean;
+        anyConfigured: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly sendMobilePush: import("../endpoint.js").Endpoint<"POST", "/notifications/mobile/send", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        userId: typeof import("effect/Schema").String;
+        title: typeof import("effect/Schema").String;
+        body: typeof import("effect/Schema").String;
+        badge: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        sound: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        data: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        platforms: import("effect/Schema").optional<import("effect/Schema").Array$<import("effect/Schema").Literal<["ios", "android"]>>>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        sentTo: typeof import("effect/Schema").Number;
+        failed: typeof import("effect/Schema").Number;
+        invalidTokens: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        usersWithDevices: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        totalUsers: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>>;
+    readonly broadcastMobilePush: import("../endpoint.js").Endpoint<"POST", "/notifications/mobile/broadcast", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        title: typeof import("effect/Schema").String;
+        body: typeof import("effect/Schema").String;
+        badge: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        sound: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        data: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        platforms: import("effect/Schema").optional<import("effect/Schema").Array$<import("effect/Schema").Literal<["ios", "android"]>>>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        sentTo: typeof import("effect/Schema").Number;
+        failed: typeof import("effect/Schema").Number;
+        invalidTokens: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        usersWithDevices: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        totalUsers: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>>;
+    readonly mobileStats: import("../endpoint.js").Endpoint<"GET", "/notifications/mobile/stats", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        days: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        devices: import("effect/Schema").Struct<{
+            total: typeof import("effect/Schema").Number;
+            active: typeof import("effect/Schema").Number;
+            inactive: typeof import("effect/Schema").Number;
+            ios: typeof import("effect/Schema").Number;
+            android: typeof import("effect/Schema").Number;
+            uniqueUsers: typeof import("effect/Schema").Number;
+        }>;
+        period: import("effect/Schema").Struct<{
+            days: typeof import("effect/Schema").Number;
+            since: typeof import("effect/Schema").String;
+        }>;
+    }>>;
+    readonly mobilePreferences: import("../endpoint.js").Endpoint<"GET", "/notifications/mobile/preferences", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        userId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        enabled: typeof import("effect/Schema").Boolean;
+        devices: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            platform: import("effect/Schema").Literal<["ios", "android"]>;
+            name: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            registeredAt: typeof import("effect/Schema").String;
+            lastUsedAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        }>>;
+    }>>;
+    readonly sendInApp: import("../endpoint.js").Endpoint<"POST", "/notifications/in-app/send", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        type: import("effect/Schema").optional<import("effect/Schema").Literal<["info", "success", "warning", "error", "promotion"]>>;
+        priority: import("effect/Schema").optional<import("effect/Schema").Literal<["low", "medium", "high", "urgent"]>>;
+        title: typeof import("effect/Schema").String;
+        body: typeof import("effect/Schema").String;
+        icon: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        imageUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        actionText: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        actionUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        secondaryActionText: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        secondaryActionUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        topic: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        metadata: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        expiresAt: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        projectId: typeof import("effect/Schema").String;
+        userId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        messageId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        sentCount: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>>;
+    readonly sendInAppBatch: import("../endpoint.js").Endpoint<"POST", "/notifications/in-app/send-batch", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        type: import("effect/Schema").optional<import("effect/Schema").Literal<["info", "success", "warning", "error", "promotion"]>>;
+        priority: import("effect/Schema").optional<import("effect/Schema").Literal<["low", "medium", "high", "urgent"]>>;
+        title: typeof import("effect/Schema").String;
+        body: typeof import("effect/Schema").String;
+        icon: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        imageUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        actionText: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        actionUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        secondaryActionText: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        secondaryActionUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        topic: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        metadata: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        expiresAt: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        projectId: typeof import("effect/Schema").String;
+        userIds: import("effect/Schema").Array$<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        messageId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        sentCount: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>>;
+    readonly broadcastInApp: import("../endpoint.js").Endpoint<"POST", "/notifications/in-app/broadcast", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        type: import("effect/Schema").optional<import("effect/Schema").Literal<["info", "success", "warning", "error", "promotion"]>>;
+        priority: import("effect/Schema").optional<import("effect/Schema").Literal<["low", "medium", "high", "urgent"]>>;
+        title: typeof import("effect/Schema").String;
+        body: typeof import("effect/Schema").String;
+        icon: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        imageUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        actionText: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        actionUrl: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        topic: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        expiresAt: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        messageId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        sentCount: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>>;
+    readonly listInAppMessages: import("../endpoint.js").Endpoint<"GET", "/notifications/in-app/messages", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        userId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        type: import("effect/Schema").optional<import("effect/Schema").Literal<["info", "success", "warning", "error", "promotion"]>>;
+        unreadOnly: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        messages: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            type: import("effect/Schema").Literal<["info", "success", "warning", "error", "promotion"]>;
+            priority: import("effect/Schema").Literal<["low", "medium", "high", "urgent"]>;
+            title: typeof import("effect/Schema").String;
+            body: typeof import("effect/Schema").String;
+            icon: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            imageUrl: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            actionText: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            actionUrl: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            secondaryActionText: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            secondaryActionUrl: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            metadata: import("effect/Schema").NullOr<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+            topic: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            isRead: typeof import("effect/Schema").Boolean;
+            isDismissed: typeof import("effect/Schema").Boolean;
+            readAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            createdAt: typeof import("effect/Schema").String;
+        }>>;
+        total: typeof import("effect/Schema").Number;
+    }>>;
+    readonly inAppStats: import("../endpoint.js").Endpoint<"GET", "/notifications/in-app/stats", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        total: typeof import("effect/Schema").Number;
+        unread: typeof import("effect/Schema").Number;
+        byType: import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Number>;
+        byPriority: import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Number>;
+    }>>;
+    readonly archiveInApp: import("../endpoint.js").Endpoint<"POST", "/notifications/in-app/archive", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        messageId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+};
+//# sourceMappingURL=notifications-admin.d.ts.map

package/dist/endpoints/notifications-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-admin.d.ts","sourceRoot":"","sources":["../../src/endpoints/notifications-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmCH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8J9B,CAAA"}

package/dist/endpoints/notifications-admin.js

@@ -0,0 +1,172 @@
+/**
+ * Notifications Admin endpoints — Console-plane admin / broadcast /
+ * subscription management for web push, mobile push, and in-app messages.
+ * Distinct from BaaS `notificationsEndpoints` (register/unregister/send/
+ * preferences) served by the runtime.
+ *
+ * Production mount: `/notifications/*` (see
+ * `apps/api/src/server/platform/app.ts`). All operations are
+ * `plane: 'management'` — they require an authenticated Console user with
+ * project access or (for the cross-project push admin paths) super-admin
+ * role; the BaaS plane's per-user push registration lives under a different
+ * endpoint group.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { ArchiveMessageInput, ArchiveMessageResult, BroadcastInAppInput, BroadcastMobilePushInput, BroadcastPushInput, BroadcastPushResult, InAppStatsQuery, InAppStatsResult, ListInAppMessagesQuery, ListInAppMessagesResult, ListSubscriptionsQuery, ListSubscriptionsResult, MobileConfigQuery, MobileConfigResult, MobilePreferencesQuery, MobilePreferencesResult, MobileStatsResult, PushConfigResult, PushStatsQuery, PushStatsResult, RemoveSubscriptionsResult, RemoveUserSubscriptionsInput, SendInAppResult, SendInAppToUserInput, SendInAppToUsersInput, SendMobilePushInput, SendMobilePushResult, SendPushResult, SendPushToUserInput, } from '../schemas/notifications-admin.js';
+export const notificationsAdminEndpoints = {
+    // ── Web push ───────────────────────────────────────────────────────────
+    pushConfig: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/push/config',
+        response: PushConfigResult,
+        plane: 'management',
+        summary: 'Check VAPID web push configuration',
+        tags: ['notifications-admin'],
+    }),
+    sendPush: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/push/send',
+        body: SendPushToUserInput,
+        response: SendPushResult,
+        plane: 'admin',
+        summary: 'Admin send web push to a user (super-admin only)',
+        tags: ['notifications-admin'],
+    }),
+    broadcastPush: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/push/broadcast',
+        body: BroadcastPushInput,
+        response: BroadcastPushResult,
+        plane: 'admin',
+        summary: 'Admin broadcast web push notification (super-admin only)',
+        tags: ['notifications-admin'],
+    }),
+    pushStats: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/push/stats',
+        query: PushStatsQuery,
+        response: PushStatsResult,
+        plane: 'admin',
+        summary: 'Admin: per-project web push statistics (super-admin only)',
+        tags: ['notifications-admin'],
+    }),
+    listSubscriptions: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/push/subscriptions',
+        query: ListSubscriptionsQuery,
+        response: ListSubscriptionsResult,
+        plane: 'admin',
+        summary: 'Admin: list push subscriptions (super-admin only)',
+        tags: ['notifications-admin'],
+    }),
+    removeSubscriptions: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/push/subscriptions/remove',
+        body: RemoveUserSubscriptionsInput,
+        response: RemoveSubscriptionsResult,
+        plane: 'admin',
+        summary: 'Admin: remove user push subscriptions (super-admin only)',
+        tags: ['notifications-admin'],
+    }),
+    // ── Mobile push ────────────────────────────────────────────────────────
+    mobileConfig: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/mobile/config',
+        query: MobileConfigQuery,
+        response: MobileConfigResult,
+        plane: 'management',
+        summary: 'Check APNs/FCM mobile push configuration',
+        tags: ['notifications-admin'],
+    }),
+    sendMobilePush: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/mobile/send',
+        body: SendMobilePushInput,
+        response: SendMobilePushResult,
+        plane: 'management',
+        summary: 'Send mobile push to a user via APNs/FCM',
+        tags: ['notifications-admin'],
+    }),
+    broadcastMobilePush: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/mobile/broadcast',
+        body: BroadcastMobilePushInput,
+        response: SendMobilePushResult,
+        plane: 'management',
+        summary: 'Broadcast mobile push to all users of a project',
+        tags: ['notifications-admin'],
+    }),
+    mobileStats: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/mobile/stats',
+        query: PushStatsQuery,
+        response: MobileStatsResult,
+        plane: 'management',
+        summary: 'Mobile device token statistics for a project',
+        tags: ['notifications-admin'],
+    }),
+    mobilePreferences: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/mobile/preferences',
+        query: MobilePreferencesQuery,
+        response: MobilePreferencesResult,
+        plane: 'management',
+        summary: 'Get mobile push preferences + devices for a user',
+        tags: ['notifications-admin'],
+    }),
+    // ── In-app messages ────────────────────────────────────────────────────
+    sendInApp: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/in-app/send',
+        body: SendInAppToUserInput,
+        response: SendInAppResult,
+        plane: 'management',
+        summary: 'Send in-app message to a user',
+        tags: ['notifications-admin'],
+    }),
+    sendInAppBatch: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/in-app/send-batch',
+        body: SendInAppToUsersInput,
+        response: SendInAppResult,
+        plane: 'management',
+        summary: 'Send in-app message to multiple users (max 1000)',
+        tags: ['notifications-admin'],
+    }),
+    broadcastInApp: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/in-app/broadcast',
+        body: BroadcastInAppInput,
+        response: SendInAppResult,
+        plane: 'management',
+        summary: 'Broadcast in-app message to all users of a project',
+        tags: ['notifications-admin'],
+    }),
+    listInAppMessages: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/in-app/messages',
+        query: ListInAppMessagesQuery,
+        response: ListInAppMessagesResult,
+        plane: 'management',
+        summary: 'List in-app messages for a project',
+        tags: ['notifications-admin'],
+    }),
+    inAppStats: defineEndpoint({
+        method: 'GET',
+        path: '/notifications/in-app/stats',
+        query: InAppStatsQuery,
+        response: InAppStatsResult,
+        plane: 'management',
+        summary: 'Statistics for in-app messages in a project',
+        tags: ['notifications-admin'],
+    }),
+    archiveInApp: defineEndpoint({
+        method: 'POST',
+        path: '/notifications/in-app/archive',
+        body: ArchiveMessageInput,
+        response: ArchiveMessageResult,
+        plane: 'management',
+        summary: 'Archive (soft delete) an in-app message',
+        tags: ['notifications-admin'],
+    }),
+};