mtlx-sdk 0.0.0-bootstrap.0 → 0.10.0

package/dist/routes/serverEvents.d.ts

@@ -0,0 +1,521 @@
+import * as z from 'zod';
+import type { ApiClient } from '../client.js';
+export declare const serverEventNotificationNewDataSchema: z.ZodOptional<z.ZodObject<{
+    count: z.ZodOptional<z.ZodNumber>;
+    topic: z.ZodOptional<z.ZodEnum<{
+        ASSET_LIKED: "ASSET_LIKED";
+        ASSET_MODERATED: "ASSET_MODERATED";
+        COMMENT_LIKED: "COMMENT_LIKED";
+        COMMENT_MENTIONED: "COMMENT_MENTIONED";
+        COMMENT_MODERATED: "COMMENT_MODERATED";
+        EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+        NEW_ASSET: "NEW_ASSET";
+        NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+        NEW_COMMENT: "NEW_COMMENT";
+    }>>;
+}, z.core.$strip>>;
+export declare const serverEventNotificationTopicDataSchema: z.ZodObject<{
+    topic: z.ZodEnum<{
+        ASSET_LIKED: "ASSET_LIKED";
+        ASSET_MODERATED: "ASSET_MODERATED";
+        COMMENT_LIKED: "COMMENT_LIKED";
+        COMMENT_MENTIONED: "COMMENT_MENTIONED";
+        COMMENT_MODERATED: "COMMENT_MODERATED";
+        EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+        NEW_ASSET: "NEW_ASSET";
+        NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+        NEW_COMMENT: "NEW_COMMENT";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const serverEventAssetModeratedDataSchema: z.ZodObject<{
+    topic: z.ZodEnum<{
+        ASSET_LIKED: "ASSET_LIKED";
+        ASSET_MODERATED: "ASSET_MODERATED";
+        COMMENT_LIKED: "COMMENT_LIKED";
+        COMMENT_MENTIONED: "COMMENT_MENTIONED";
+        COMMENT_MODERATED: "COMMENT_MODERATED";
+        EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+        NEW_ASSET: "NEW_ASSET";
+        NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+        NEW_COMMENT: "NEW_COMMENT";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    userName: z.ZodString;
+    assetName: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const serverEventCommentModeratedDataSchema: z.ZodObject<{
+    topic: z.ZodEnum<{
+        ASSET_LIKED: "ASSET_LIKED";
+        ASSET_MODERATED: "ASSET_MODERATED";
+        COMMENT_LIKED: "COMMENT_LIKED";
+        COMMENT_MENTIONED: "COMMENT_MENTIONED";
+        COMMENT_MODERATED: "COMMENT_MODERATED";
+        EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+        NEW_ASSET: "NEW_ASSET";
+        NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+        NEW_COMMENT: "NEW_COMMENT";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    userName: z.ZodString;
+    assetName: z.ZodString;
+    commentId: z.ZodNumber;
+    commentText: z.ZodString;
+    reason: z.ZodString;
+    targetUserId: z.ZodNumber;
+}, z.core.$strip>;
+export declare const serverEventAssetLikedDataSchema: z.ZodObject<{
+    topic: z.ZodEnum<{
+        ASSET_LIKED: "ASSET_LIKED";
+        ASSET_MODERATED: "ASSET_MODERATED";
+        COMMENT_LIKED: "COMMENT_LIKED";
+        COMMENT_MENTIONED: "COMMENT_MENTIONED";
+        COMMENT_MODERATED: "COMMENT_MODERATED";
+        EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+        NEW_ASSET: "NEW_ASSET";
+        NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+        NEW_COMMENT: "NEW_COMMENT";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    userName: z.ZodString;
+    assetName: z.ZodString;
+    actorName: z.ZodString;
+}, z.core.$strip>;
+export declare const serverEventCommentLikedDataSchema: z.ZodObject<{
+    topic: z.ZodEnum<{
+        ASSET_LIKED: "ASSET_LIKED";
+        ASSET_MODERATED: "ASSET_MODERATED";
+        COMMENT_LIKED: "COMMENT_LIKED";
+        COMMENT_MENTIONED: "COMMENT_MENTIONED";
+        COMMENT_MODERATED: "COMMENT_MODERATED";
+        EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+        NEW_ASSET: "NEW_ASSET";
+        NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+        NEW_COMMENT: "NEW_COMMENT";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    userName: z.ZodString;
+    assetName: z.ZodString;
+    commentId: z.ZodNumber;
+    commentText: z.ZodString;
+    actorName: z.ZodString;
+    targetUserId: z.ZodNumber;
+}, z.core.$strip>;
+export declare const serverEventAssetCreatedUpdatedDataSchema: z.ZodObject<{
+    asset: z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            MATERIAL: "MATERIAL";
+        }>;
+        visibility: z.ZodEnum<{
+            PRIVATE: "PRIVATE";
+            PUBLIC: "PUBLIC";
+            UNLISTED: "UNLISTED";
+        }>;
+        userId: z.ZodNumber;
+        userName: z.ZodString;
+        description: z.ZodString;
+        keywords: z.ZodString;
+        shareLicense: z.ZodEnum<{
+            CC_0: "CC_0";
+            CC_BY: "CC_BY";
+            CC_BY_NC: "CC_BY_NC";
+            CC_BY_NC_ND: "CC_BY_NC_ND";
+            CC_BY_NC_SA: "CC_BY_NC_SA";
+            CC_BY_ND: "CC_BY_ND";
+            CC_BY_SA: "CC_BY_SA";
+            NONE: "NONE";
+        }>;
+        aiUsage: z.ZodEnum<{
+            AI_FREE: "AI_FREE";
+            AI_USED: "AI_USED";
+            UNDISCLOSED: "UNDISCLOSED";
+        }>;
+        commentMode: z.ZodEnum<{
+            ENABLED: "ENABLED";
+            MEMBERS_ONLY: "MEMBERS_ONLY";
+            NONE: "NONE";
+        }>;
+        reported: z.ZodBoolean;
+        likeCount: z.ZodInt;
+        shareCount: z.ZodInt;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        archived: z.ZodBoolean;
+        metadata: z.ZodString;
+        versionOriginalSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        depth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        fileOid: z.ZodString;
+        thumbnailOid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        materialInfo: z.ZodOptional<z.ZodObject<{
+            version: z.ZodOptional<z.ZodString>;
+            colorspace: z.ZodOptional<z.ZodString>;
+            materials: z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                category: z.ZodString;
+            }, z.core.$strip>>;
+            nodeGraphCount: z.ZodNumber;
+            topLevelNodeCount: z.ZodNumber;
+            referencedTextures: z.ZodArray<z.ZodString>;
+            warnings: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    actorName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const serverEventAssetDeletedDataSchema: z.ZodObject<{
+    assetId: z.ZodNumber;
+    userName: z.ZodString;
+    assetName: z.ZodString;
+}, z.core.$strip>;
+export declare const serverEventCommentDataSchema: z.ZodObject<{
+    comment: z.ZodObject<{
+        id: z.ZodNumber;
+        text: z.ZodString;
+        likeCount: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+        moderatedAt: z.ZodNullable<z.ZodISODateTime>;
+        moderationReason: z.ZodNullable<z.ZodString>;
+        createdByUserId: z.ZodNumber;
+        createdByName: z.ZodString;
+        likeId: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    assetId: z.ZodNumber;
+    userName: z.ZodString;
+    assetName: z.ZodString;
+    mentionedUserIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const serverEventDataSchemas: {
+    readonly 'asset.created': z.ZodObject<{
+        asset: z.ZodObject<{
+            id: z.ZodNumber;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                MATERIAL: "MATERIAL";
+            }>;
+            visibility: z.ZodEnum<{
+                PRIVATE: "PRIVATE";
+                PUBLIC: "PUBLIC";
+                UNLISTED: "UNLISTED";
+            }>;
+            userId: z.ZodNumber;
+            userName: z.ZodString;
+            description: z.ZodString;
+            keywords: z.ZodString;
+            shareLicense: z.ZodEnum<{
+                CC_0: "CC_0";
+                CC_BY: "CC_BY";
+                CC_BY_NC: "CC_BY_NC";
+                CC_BY_NC_ND: "CC_BY_NC_ND";
+                CC_BY_NC_SA: "CC_BY_NC_SA";
+                CC_BY_ND: "CC_BY_ND";
+                CC_BY_SA: "CC_BY_SA";
+                NONE: "NONE";
+            }>;
+            aiUsage: z.ZodEnum<{
+                AI_FREE: "AI_FREE";
+                AI_USED: "AI_USED";
+                UNDISCLOSED: "UNDISCLOSED";
+            }>;
+            commentMode: z.ZodEnum<{
+                ENABLED: "ENABLED";
+                MEMBERS_ONLY: "MEMBERS_ONLY";
+                NONE: "NONE";
+            }>;
+            reported: z.ZodBoolean;
+            likeCount: z.ZodInt;
+            shareCount: z.ZodInt;
+            createdAt: z.ZodISODateTime;
+            updatedAt: z.ZodISODateTime;
+            archived: z.ZodBoolean;
+            metadata: z.ZodString;
+            versionOriginalSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            depth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            fileOid: z.ZodString;
+            thumbnailOid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            materialInfo: z.ZodOptional<z.ZodObject<{
+                version: z.ZodOptional<z.ZodString>;
+                colorspace: z.ZodOptional<z.ZodString>;
+                materials: z.ZodArray<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    category: z.ZodString;
+                }, z.core.$strip>>;
+                nodeGraphCount: z.ZodNumber;
+                topLevelNodeCount: z.ZodNumber;
+                referencedTextures: z.ZodArray<z.ZodString>;
+                warnings: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        actorName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'asset.deleted': z.ZodObject<{
+        assetId: z.ZodNumber;
+        userName: z.ZodString;
+        assetName: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'asset.liked': z.ZodObject<{
+        topic: z.ZodEnum<{
+            ASSET_LIKED: "ASSET_LIKED";
+            ASSET_MODERATED: "ASSET_MODERATED";
+            COMMENT_LIKED: "COMMENT_LIKED";
+            COMMENT_MENTIONED: "COMMENT_MENTIONED";
+            COMMENT_MODERATED: "COMMENT_MODERATED";
+            EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+            NEW_ASSET: "NEW_ASSET";
+            NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+            NEW_COMMENT: "NEW_COMMENT";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        userName: z.ZodString;
+        assetName: z.ZodString;
+        actorName: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'asset.moderated': z.ZodObject<{
+        topic: z.ZodEnum<{
+            ASSET_LIKED: "ASSET_LIKED";
+            ASSET_MODERATED: "ASSET_MODERATED";
+            COMMENT_LIKED: "COMMENT_LIKED";
+            COMMENT_MENTIONED: "COMMENT_MENTIONED";
+            COMMENT_MODERATED: "COMMENT_MODERATED";
+            EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+            NEW_ASSET: "NEW_ASSET";
+            NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+            NEW_COMMENT: "NEW_COMMENT";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        userName: z.ZodString;
+        assetName: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'asset.updated': z.ZodObject<{
+        asset: z.ZodObject<{
+            id: z.ZodNumber;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                MATERIAL: "MATERIAL";
+            }>;
+            visibility: z.ZodEnum<{
+                PRIVATE: "PRIVATE";
+                PUBLIC: "PUBLIC";
+                UNLISTED: "UNLISTED";
+            }>;
+            userId: z.ZodNumber;
+            userName: z.ZodString;
+            description: z.ZodString;
+            keywords: z.ZodString;
+            shareLicense: z.ZodEnum<{
+                CC_0: "CC_0";
+                CC_BY: "CC_BY";
+                CC_BY_NC: "CC_BY_NC";
+                CC_BY_NC_ND: "CC_BY_NC_ND";
+                CC_BY_NC_SA: "CC_BY_NC_SA";
+                CC_BY_ND: "CC_BY_ND";
+                CC_BY_SA: "CC_BY_SA";
+                NONE: "NONE";
+            }>;
+            aiUsage: z.ZodEnum<{
+                AI_FREE: "AI_FREE";
+                AI_USED: "AI_USED";
+                UNDISCLOSED: "UNDISCLOSED";
+            }>;
+            commentMode: z.ZodEnum<{
+                ENABLED: "ENABLED";
+                MEMBERS_ONLY: "MEMBERS_ONLY";
+                NONE: "NONE";
+            }>;
+            reported: z.ZodBoolean;
+            likeCount: z.ZodInt;
+            shareCount: z.ZodInt;
+            createdAt: z.ZodISODateTime;
+            updatedAt: z.ZodISODateTime;
+            archived: z.ZodBoolean;
+            metadata: z.ZodString;
+            versionOriginalSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            depth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            fileOid: z.ZodString;
+            thumbnailOid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            materialInfo: z.ZodOptional<z.ZodObject<{
+                version: z.ZodOptional<z.ZodString>;
+                colorspace: z.ZodOptional<z.ZodString>;
+                materials: z.ZodArray<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    category: z.ZodString;
+                }, z.core.$strip>>;
+                nodeGraphCount: z.ZodNumber;
+                topLevelNodeCount: z.ZodNumber;
+                referencedTextures: z.ZodArray<z.ZodString>;
+                warnings: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        actorName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'comment.liked': z.ZodObject<{
+        topic: z.ZodEnum<{
+            ASSET_LIKED: "ASSET_LIKED";
+            ASSET_MODERATED: "ASSET_MODERATED";
+            COMMENT_LIKED: "COMMENT_LIKED";
+            COMMENT_MENTIONED: "COMMENT_MENTIONED";
+            COMMENT_MODERATED: "COMMENT_MODERATED";
+            EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+            NEW_ASSET: "NEW_ASSET";
+            NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+            NEW_COMMENT: "NEW_COMMENT";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        userName: z.ZodString;
+        assetName: z.ZodString;
+        commentId: z.ZodNumber;
+        commentText: z.ZodString;
+        actorName: z.ZodString;
+        targetUserId: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly 'comment.moderated': z.ZodObject<{
+        topic: z.ZodEnum<{
+            ASSET_LIKED: "ASSET_LIKED";
+            ASSET_MODERATED: "ASSET_MODERATED";
+            COMMENT_LIKED: "COMMENT_LIKED";
+            COMMENT_MENTIONED: "COMMENT_MENTIONED";
+            COMMENT_MODERATED: "COMMENT_MODERATED";
+            EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+            NEW_ASSET: "NEW_ASSET";
+            NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+            NEW_COMMENT: "NEW_COMMENT";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+        userName: z.ZodString;
+        assetName: z.ZodString;
+        commentId: z.ZodNumber;
+        commentText: z.ZodString;
+        reason: z.ZodString;
+        targetUserId: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly 'comment.new': z.ZodObject<{
+        comment: z.ZodObject<{
+            id: z.ZodNumber;
+            text: z.ZodString;
+            likeCount: z.ZodNumber;
+            createdAt: z.ZodISODateTime;
+            moderatedAt: z.ZodNullable<z.ZodISODateTime>;
+            moderationReason: z.ZodNullable<z.ZodString>;
+            createdByUserId: z.ZodNumber;
+            createdByName: z.ZodString;
+            likeId: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        assetId: z.ZodNumber;
+        userName: z.ZodString;
+        assetName: z.ZodString;
+        mentionedUserIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>;
+    readonly 'comment.updated': z.ZodObject<{
+        comment: z.ZodObject<{
+            id: z.ZodNumber;
+            text: z.ZodString;
+            likeCount: z.ZodNumber;
+            createdAt: z.ZodISODateTime;
+            moderatedAt: z.ZodNullable<z.ZodISODateTime>;
+            moderationReason: z.ZodNullable<z.ZodString>;
+            createdByUserId: z.ZodNumber;
+            createdByName: z.ZodString;
+            likeId: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        assetId: z.ZodNumber;
+        userName: z.ZodString;
+        assetName: z.ZodString;
+        mentionedUserIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>;
+    readonly 'external-auth.approved': z.ZodObject<{
+        topic: z.ZodEnum<{
+            ASSET_LIKED: "ASSET_LIKED";
+            ASSET_MODERATED: "ASSET_MODERATED";
+            COMMENT_LIKED: "COMMENT_LIKED";
+            COMMENT_MENTIONED: "COMMENT_MENTIONED";
+            COMMENT_MODERATED: "COMMENT_MODERATED";
+            EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+            NEW_ASSET: "NEW_ASSET";
+            NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+            NEW_COMMENT: "NEW_COMMENT";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        link: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'notification.new': z.ZodOptional<z.ZodObject<{
+        count: z.ZodOptional<z.ZodNumber>;
+        topic: z.ZodOptional<z.ZodEnum<{
+            ASSET_LIKED: "ASSET_LIKED";
+            ASSET_MODERATED: "ASSET_MODERATED";
+            COMMENT_LIKED: "COMMENT_LIKED";
+            COMMENT_MENTIONED: "COMMENT_MENTIONED";
+            COMMENT_MODERATED: "COMMENT_MODERATED";
+            EXTERNAL_AUTH_APPROVED: "EXTERNAL_AUTH_APPROVED";
+            NEW_ASSET: "NEW_ASSET";
+            NEW_ASSET_VERSION: "NEW_ASSET_VERSION";
+            NEW_COMMENT: "NEW_COMMENT";
+        }>>;
+    }, z.core.$strip>>;
+};
+export type ServerEventType = keyof typeof serverEventDataSchemas;
+export declare const SERVER_EVENT_TYPES: [ServerEventType, ...ServerEventType[]];
+export declare const serverEventTypeSchema: z.ZodEnum<{
+    "asset.created": "asset.created";
+    "asset.deleted": "asset.deleted";
+    "asset.liked": "asset.liked";
+    "asset.moderated": "asset.moderated";
+    "asset.updated": "asset.updated";
+    "comment.liked": "comment.liked";
+    "comment.moderated": "comment.moderated";
+    "comment.new": "comment.new";
+    "comment.updated": "comment.updated";
+    "external-auth.approved": "external-auth.approved";
+    "notification.new": "notification.new";
+}>;
+export type ServerEvent = {
+    [K in ServerEventType]: {
+        type: K;
+        userId: number;
+        data: z.infer<(typeof serverEventDataSchemas)[K]>;
+    };
+}[ServerEventType];
+export declare const serverEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>, ...z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>[]], "type">;
+export type SubscribeToServerEventsOptions = {
+    path?: string;
+};
+export type ServerEventsSubscription = {
+    addEventListener<K extends ServerEventType>(type: K, handler: (data: Extract<ServerEvent, {
+        type: K;
+    }>['data']) => void): void;
+    close(): void;
+};
+/**
+ * Subscribe to the API server's SSE events stream.
+ * Uses the ApiClient for authentication — JWT, session tokens, and API keys are all
+ * handled automatically via the client's axios interceptors.
+ * Returns an object with addEventListener(type, handler) for typed event handling and close().
+ *
+ * @example
+ * const sub = subscribeToServerEvents(client);
+ * sub.addEventListener('notification.new', (data) => { ... });
+ * sub.addEventListener('asset.updated', (data) => { ... });
+ * // on unmount: sub.close();
+ */
+export declare function subscribeToServerEvents(client: ApiClient, options?: SubscribeToServerEventsOptions): ServerEventsSubscription;
+//# sourceMappingURL=serverEvents.d.ts.map

package/dist/routes/serverEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverEvents.d.ts","sources":["../../src/routes/serverEvents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU9C,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;kBAKpC,CAAC;AAGd,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;iBAIjD,CAAC;AAGH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;iBAI9C,CAAC;AAEH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;iBAOhD,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;iBAI1C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;iBAO5C,CAAC;AAGH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGnD,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;iBAI5C,CAAC;AAGH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;iBAMvC,CAAC;AAMH,eAAO,MAAM,sBAAsB;aACjC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aACf,eAAe;;;;;aACf,aAAa;;;;;;;;;;;;;;;;;;aACb,iBAAiB;;;;;;;;;;;;;;;;;;aACjB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aACf,eAAe;;;;;;;;;;;;;;;;;;;;;aACf,mBAAmB;;;;;;;;;;;;;;;;;;;;;aACnB,aAAa;;;;;;;;;;;;;;;;;aACb,iBAAiB;;;;;;;;;;;;;;;;;aACjB,wBAAwB;;;;;;;;;;;;;;;aACxB,kBAAkB;;;;;;;;;;;;;;CACV,CAAC;AAKX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAElE,eAAO,MAAM,kBAAkB,EAA0C,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAAC,CAAC;AAEjH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAA6B,CAAC;AAIhE,MAAM,MAAM,WAAW,GAAG;KACvB,CAAC,IAAI,eAAe,GAAG;QACtB,IAAI,EAAE,CAAC,CAAC;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACnD;CACF,CAAC,eAAe,CAAC,CAAC;AAKnB,eAAO,MAAM,iBAAiB;;;;8BAS7B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,gBAAgB,CAAC,CAAC,SAAS,eAAe,EACxC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,GACjE,IAAI,CAAC;IACR,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,8BAA8B,GACvC,wBAAwB,CAmC1B"}

package/dist/routes/serverEvents.js

@@ -0,0 +1,136 @@
+import { axiosEventSource } from 'axios-eventsource';
+import * as z from 'zod';
+import { Enums } from '../lib/enums.js';
+import { assetSchema } from './assets.js';
+import { commentSchema } from './comments.js';
+// ---------------------------------------------------------------------------
+// Payload schemas per event type (sent as the SSE body)
+// ---------------------------------------------------------------------------
+// notification.new — lightweight signal; full data fetched via query invalidation
+export const serverEventNotificationNewDataSchema = z
+    .object({
+    count: z.number().int().optional(),
+    topic: z.enum(Enums.NotificationTopic).optional(),
+})
+    .optional();
+// notification-topic events — typed signals for specific notification kinds
+export const serverEventNotificationTopicDataSchema = z.object({
+    topic: z.enum(Enums.NotificationTopic),
+    title: z.string().optional(),
+    link: z.string().optional(),
+});
+// Extended schemas for events that produce notifications (centralized copy generation)
+export const serverEventAssetModeratedDataSchema = serverEventNotificationTopicDataSchema.extend({
+    userName: z.string(),
+    assetName: z.string(),
+    reason: z.string(),
+});
+export const serverEventCommentModeratedDataSchema = serverEventNotificationTopicDataSchema.extend({
+    userName: z.string(),
+    assetName: z.string(),
+    commentId: z.number().int(),
+    commentText: z.string(),
+    reason: z.string(),
+    targetUserId: z.number().int(),
+});
+export const serverEventAssetLikedDataSchema = serverEventNotificationTopicDataSchema.extend({
+    userName: z.string(),
+    assetName: z.string(),
+    actorName: z.string(),
+});
+export const serverEventCommentLikedDataSchema = serverEventNotificationTopicDataSchema.extend({
+    userName: z.string(),
+    assetName: z.string(),
+    commentId: z.number().int(),
+    commentText: z.string(),
+    actorName: z.string(),
+    targetUserId: z.number().int(),
+});
+// asset events — carry the full entity for created/updated; just identifiers for deleted
+export const serverEventAssetCreatedUpdatedDataSchema = z.object({
+    asset: assetSchema,
+    actorName: z.string().optional(), // For notification body when event produces notification
+});
+export const serverEventAssetDeletedDataSchema = z.object({
+    assetId: z.number().int(),
+    userName: z.string(),
+    assetName: z.string(),
+});
+// comment events — carry the full entity plus location context
+export const serverEventCommentDataSchema = z.object({
+    comment: commentSchema,
+    assetId: z.number().int(),
+    userName: z.string(),
+    assetName: z.string(),
+    mentionedUserIds: z.array(z.number().int()).optional(),
+});
+// ---------------------------------------------------------------------------
+// Canonical event registry — single source of truth for all event types.
+// To add a new event: add one entry here; everything else is derived.
+// ---------------------------------------------------------------------------
+export const serverEventDataSchemas = {
+    'asset.created': serverEventAssetCreatedUpdatedDataSchema,
+    'asset.deleted': serverEventAssetDeletedDataSchema,
+    'asset.liked': serverEventAssetLikedDataSchema,
+    'asset.moderated': serverEventAssetModeratedDataSchema,
+    'asset.updated': serverEventAssetCreatedUpdatedDataSchema,
+    'comment.liked': serverEventCommentLikedDataSchema,
+    'comment.moderated': serverEventCommentModeratedDataSchema,
+    'comment.new': serverEventCommentDataSchema,
+    'comment.updated': serverEventCommentDataSchema,
+    'external-auth.approved': serverEventNotificationTopicDataSchema,
+    'notification.new': serverEventNotificationNewDataSchema,
+};
+export const SERVER_EVENT_TYPES = Object.keys(serverEventDataSchemas);
+export const serverEventTypeSchema = z.enum(SERVER_EVENT_TYPES);
+// ---------------------------------------------------------------------------
+// Zod schema for parsing full ServerEvent objects (generic, includes userId)
+// ---------------------------------------------------------------------------
+export const serverEventSchema = z.discriminatedUnion('type', Object.keys(serverEventDataSchemas).map((type) => z.object({
+    type: z.literal(type),
+    userId: z.number().int(),
+    data: serverEventDataSchemas[type],
+})));
+const SSE_DEFAULT_PATH = '/server-events';
+/**
+ * Subscribe to the API server's SSE events stream.
+ * Uses the ApiClient for authentication — JWT, session tokens, and API keys are all
+ * handled automatically via the client's axios interceptors.
+ * Returns an object with addEventListener(type, handler) for typed event handling and close().
+ *
+ * @example
+ * const sub = subscribeToServerEvents(client);
+ * sub.addEventListener('notification.new', (data) => { ... });
+ * sub.addEventListener('asset.updated', (data) => { ... });
+ * // on unmount: sub.close();
+ */
+export function subscribeToServerEvents(client, options) {
+    const path = options?.path ?? SSE_DEFAULT_PATH;
+    const handlers = {};
+    const stream = axiosEventSource(client.axios, path, {
+        reconnect: { initialDelayMs: 1000, maxDelayMs: 30_000 },
+    });
+    for (const type of Object.keys(serverEventDataSchemas)) {
+        // Cast via unknown: axios-eventsource bundles its own Zod copy, so the ZodType
+        // module paths differ from the host project's Zod, causing a structural mismatch.
+        // The schema is compatible at runtime; the cast is purely a type-system workaround.
+        const listenerOptions = {
+            schema: serverEventDataSchemas[type],
+        };
+        stream.addEventListener(type, (event) => {
+            const handler = handlers[type];
+            if (handler) {
+                handler(event.data);
+            }
+        }, listenerOptions);
+    }
+    return {
+        addEventListener(type, handler) {
+            handlers[type] = handler;
+        },
+        close() {
+            stream.close();
+        },
+    };
+}
+//# sourceMappingURL=serverEvents.js.map

package/dist/routes/serverEvents.js.map

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