sandstream-kit 1.0.0

package/dist/author-notifications.d.ts

@@ -0,0 +1,130 @@
+export type NotificationType = "new_review" | "new_rating" | "download_milestone" | "update_reminder" | "security_alert" | "dependency_update" | "plugin_published" | "rating_threshold" | "community_digest" | "comment_reply";
+export type NotificationChannel = "in_app" | "email" | "digest";
+export type DigestFrequency = "daily" | "weekly" | "monthly" | "off";
+export interface Notification {
+    id: string;
+    authorId: string;
+    type: NotificationType;
+    pluginId?: string;
+    title: string;
+    message: string;
+    metadata: Record<string, unknown>;
+    read: boolean;
+    channels: NotificationChannel[];
+    createdAt: string;
+    readAt?: string;
+}
+export interface NotificationPreference {
+    authorId: string;
+    notificationType: NotificationType;
+    channels: NotificationChannel[];
+    enabled: boolean;
+    updatedAt: string;
+}
+export interface DigestSettings {
+    authorId: string;
+    frequency: DigestFrequency;
+    preferredDay?: number;
+    preferredTime?: string;
+    includeTypes: NotificationType[];
+    updatedAt: string;
+}
+export interface DigestEntry {
+    id: string;
+    title: string;
+    message: string;
+    type: NotificationType;
+    createdAt: string;
+}
+export interface CompiledDigest {
+    authorId: string;
+    frequency: DigestFrequency;
+    period: string;
+    entries: DigestEntry[];
+    totalCount: number;
+    unreadCount: number;
+    compiledAt: string;
+}
+export interface NotificationStats {
+    totalNotifications: number;
+    unreadCount: number;
+    byType: Record<NotificationType, number>;
+    byStatus: {
+        read: number;
+        unread: number;
+    };
+}
+export interface DownloadMilestoneEvent {
+    pluginId: string;
+    authorId: string;
+    milestone: number;
+    currentDownloads: number;
+    achievedAt: string;
+}
+export declare class AuthorNotificationEngine {
+    private notifications;
+    private preferences;
+    private digestSettings;
+    private digestQueue;
+    private lastDigestSent;
+    /**
+     * Create and send a notification to an author.
+     */
+    createNotification(authorId: string, type: NotificationType, title: string, message: string, metadata?: Record<string, unknown>, pluginId?: string): Notification;
+    private getDefaultPreference;
+    getNotification(notificationId: string): Notification | null;
+    getAuthorNotifications(authorId: string, unreadOnly?: boolean, limit?: number): Notification[];
+    markAsRead(notificationId: string): Notification | null;
+    markMultipleAsRead(authorId: string): number;
+    deleteNotification(notificationId: string): boolean;
+    /**
+     * Set notification preferences for an author and notification type.
+     */
+    setPreference(authorId: string, type: NotificationType, channels: NotificationChannel[], enabled: boolean): NotificationPreference;
+    getPreference(authorId: string, type: NotificationType): NotificationPreference | null;
+    getAuthorPreferences(authorId: string): NotificationPreference[];
+    disableNotificationType(authorId: string, type: NotificationType): NotificationPreference;
+    enableNotificationType(authorId: string, type: NotificationType, channels?: NotificationChannel[]): NotificationPreference;
+    /**
+     * Configure digest settings for an author.
+     */
+    setDigestSettings(authorId: string, frequency: DigestFrequency, types: NotificationType[], preferredDay?: number, preferredTime?: string): DigestSettings;
+    getDigestSettings(authorId: string): DigestSettings | null;
+    /**
+     * Compile a digest from queued entries.
+     */
+    compileDigest(authorId: string, frequency: DigestFrequency): CompiledDigest | null;
+    getLastDigestTime(authorId: string): Date | null;
+    getPendingDigestEntries(authorId: string): DigestEntry[];
+    /**
+     * Send notification when a plugin receives a new review.
+     */
+    notifyNewReview(authorId: string, pluginId: string, reviewerId: string, rating: number, comment: string): Notification;
+    /**
+     * Send notification on download milestones (100, 500, 1000, etc.).
+     */
+    notifyDownloadMilestone(authorId: string, pluginId: string, currentDownloads: number): Notification | null;
+    /**
+     * Send security alert for vulnerabilities.
+     */
+    notifySecurityAlert(authorId: string, pluginId: string, vulnerability: string, severity: "low" | "medium" | "high" | "critical"): Notification;
+    /**
+     * Send notification when rating drops below threshold.
+     */
+    notifyRatingThreshold(authorId: string, pluginId: string, currentRating: number, threshold: number): Notification | null;
+    /**
+     * Send notification for dependency updates available.
+     */
+    notifyDependencyUpdate(authorId: string, pluginId: string, dependency: string, newVersion: string): Notification;
+    /**
+     * Send digest compilation notification.
+     */
+    notifyCommunityDigest(authorId: string, digest: CompiledDigest): Notification;
+    /**
+     * Get notification statistics for an author.
+     */
+    getNotificationStats(authorId: string): NotificationStats;
+    getNotificationsCache(): Map<string, Notification>;
+    getPreferencesCache(): Map<string, NotificationPreference>;
+    getDigestSettingsCache(): Map<string, DigestSettings>;
+}

package/dist/author-notifications.js

@@ -0,0 +1,261 @@
+import { IdGenerators } from "./id-generator.js";
+// ─── AuthorNotificationEngine ─────────────────────────────────────────────────
+export class AuthorNotificationEngine {
+    notifications = new Map();
+    preferences = new Map();
+    digestSettings = new Map();
+    digestQueue = new Map(); // authorId → entries
+    lastDigestSent = new Map(); // authorId → ISO date
+    // ─── Notification creation & management ────────────────────────────────────
+    /**
+     * Create and send a notification to an author.
+     */
+    createNotification(authorId, type, title, message, metadata = {}, pluginId) {
+        const id = IdGenerators.notification();
+        // Get author's notification preference for this type
+        const prefKey = `${authorId}:${type}`;
+        const pref = this.preferences.get(prefKey) || this.getDefaultPreference(authorId, type);
+        const notification = {
+            id,
+            authorId,
+            type,
+            pluginId,
+            title,
+            message,
+            metadata,
+            read: false,
+            channels: pref.channels,
+            createdAt: new Date().toISOString(),
+        };
+        this.notifications.set(id, notification);
+        // Add to digest queue if digest is enabled
+        const digestSettings = this.digestSettings.get(authorId);
+        if (digestSettings && digestSettings.includeTypes.includes(type)) {
+            const queue = this.digestQueue.get(authorId) || [];
+            queue.push({
+                id: notification.id,
+                title,
+                message,
+                type,
+                createdAt: notification.createdAt,
+            });
+            this.digestQueue.set(authorId, queue);
+        }
+        return notification;
+    }
+    getDefaultPreference(authorId, type) {
+        // Default preferences: send critical alerts to in_app, others to digest
+        const criticalTypes = ["security_alert", "rating_threshold"];
+        const channels = criticalTypes.includes(type)
+            ? ["in_app", "email"]
+            : ["in_app", "digest"];
+        return {
+            authorId,
+            notificationType: type,
+            channels,
+            enabled: true,
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    getNotification(notificationId) {
+        return this.notifications.get(notificationId) || null;
+    }
+    getAuthorNotifications(authorId, unreadOnly = false, limit = 50) {
+        return [...this.notifications.values()]
+            .filter((n) => n.authorId === authorId && (!unreadOnly || !n.read))
+            .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())
+            .slice(0, limit);
+    }
+    markAsRead(notificationId) {
+        const notif = this.notifications.get(notificationId);
+        if (!notif)
+            return null;
+        notif.read = true;
+        notif.readAt = new Date().toISOString();
+        return notif;
+    }
+    markMultipleAsRead(authorId) {
+        const authorsNotifs = this.getAuthorNotifications(authorId, true);
+        let count = 0;
+        for (const notif of authorsNotifs) {
+            notif.read = true;
+            notif.readAt = new Date().toISOString();
+            count++;
+        }
+        return count;
+    }
+    deleteNotification(notificationId) {
+        return this.notifications.delete(notificationId);
+    }
+    // ─── Notification preferences ─────────────────────────────────────────────
+    /**
+     * Set notification preferences for an author and notification type.
+     */
+    setPreference(authorId, type, channels, enabled) {
+        const key = `${authorId}:${type}`;
+        const pref = {
+            authorId,
+            notificationType: type,
+            channels: enabled ? channels : [],
+            enabled,
+            updatedAt: new Date().toISOString(),
+        };
+        this.preferences.set(key, pref);
+        return pref;
+    }
+    getPreference(authorId, type) {
+        const key = `${authorId}:${type}`;
+        return this.preferences.get(key) || null;
+    }
+    getAuthorPreferences(authorId) {
+        return [...this.preferences.values()].filter((p) => p.authorId === authorId);
+    }
+    disableNotificationType(authorId, type) {
+        return this.setPreference(authorId, type, [], false);
+    }
+    enableNotificationType(authorId, type, channels = ["in_app", "email"]) {
+        return this.setPreference(authorId, type, channels, true);
+    }
+    // ─── Digest management ─────────────────────────────────────────────────────
+    /**
+     * Configure digest settings for an author.
+     */
+    setDigestSettings(authorId, frequency, types, preferredDay, preferredTime) {
+        const settings = {
+            authorId,
+            frequency,
+            preferredDay,
+            preferredTime: preferredTime || "09:00",
+            includeTypes: types,
+            updatedAt: new Date().toISOString(),
+        };
+        this.digestSettings.set(authorId, settings);
+        return settings;
+    }
+    getDigestSettings(authorId) {
+        return this.digestSettings.get(authorId) || null;
+    }
+    /**
+     * Compile a digest from queued entries.
+     */
+    compileDigest(authorId, frequency) {
+        const settings = this.digestSettings.get(authorId);
+        if (!settings || settings.frequency !== frequency)
+            return null;
+        const entries = this.digestQueue.get(authorId) || [];
+        if (entries.length === 0)
+            return null;
+        const unreadNotifs = this.getAuthorNotifications(authorId, true);
+        const unreadCount = unreadNotifs.length;
+        // Determine period based on frequency
+        const now = new Date();
+        let period = "";
+        if (frequency === "daily") {
+            period = now.toISOString().split("T")[0];
+        }
+        else if (frequency === "weekly") {
+            const weekStart = new Date(now);
+            weekStart.setDate(now.getDate() - now.getDay());
+            const weekEnd = new Date(weekStart);
+            weekEnd.setDate(weekStart.getDate() + 6);
+            period = `${weekStart.toISOString().split("T")[0]} to ${weekEnd.toISOString().split("T")[0]}`;
+        }
+        else if (frequency === "monthly") {
+            period = now.toISOString().slice(0, 7);
+        }
+        const digest = {
+            authorId,
+            frequency,
+            period,
+            entries: entries.slice(0, 100), // limit to 100 entries per digest
+            totalCount: entries.length,
+            unreadCount,
+            compiledAt: new Date().toISOString(),
+        };
+        this.lastDigestSent.set(authorId, new Date().toISOString());
+        // Clear queue after compiling
+        this.digestQueue.set(authorId, []);
+        return digest;
+    }
+    getLastDigestTime(authorId) {
+        const time = this.lastDigestSent.get(authorId);
+        return time ? new Date(time) : null;
+    }
+    getPendingDigestEntries(authorId) {
+        return this.digestQueue.get(authorId) || [];
+    }
+    // ─── Event-based notifications ─────────────────────────────────────────────
+    /**
+     * Send notification when a plugin receives a new review.
+     */
+    notifyNewReview(authorId, pluginId, reviewerId, rating, comment) {
+        return this.createNotification(authorId, "new_review", `New review for your plugin`, `${reviewerId} left a ${rating}★ review: "${comment.slice(0, 100)}..."`, { reviewerId, rating, comment }, pluginId);
+    }
+    /**
+     * Send notification on download milestones (100, 500, 1000, etc.).
+     */
+    notifyDownloadMilestone(authorId, pluginId, currentDownloads) {
+        const milestones = [100, 500, 1000, 5000, 10000, 50000, 100000];
+        const milestone = milestones.find((m) => m === currentDownloads);
+        if (!milestone)
+            return null;
+        return this.createNotification(authorId, "download_milestone", `🎉 Milestone reached!`, `Your plugin has reached ${milestone} downloads!`, { milestone, currentDownloads }, pluginId);
+    }
+    /**
+     * Send security alert for vulnerabilities.
+     */
+    notifySecurityAlert(authorId, pluginId, vulnerability, severity) {
+        return this.createNotification(authorId, "security_alert", `⚠️ Security alert`, `${severity.toUpperCase()}: ${vulnerability}. Please review and update.`, { vulnerability, severity }, pluginId);
+    }
+    /**
+     * Send notification when rating drops below threshold.
+     */
+    notifyRatingThreshold(authorId, pluginId, currentRating, threshold) {
+        if (currentRating >= threshold)
+            return null;
+        return this.createNotification(authorId, "rating_threshold", `Rating alert`, `Your plugin's rating dropped to ${currentRating.toFixed(1)}★ (threshold: ${threshold}★)`, { currentRating, threshold }, pluginId);
+    }
+    /**
+     * Send notification for dependency updates available.
+     */
+    notifyDependencyUpdate(authorId, pluginId, dependency, newVersion) {
+        return this.createNotification(authorId, "dependency_update", `Dependency update available`, `${dependency} has a new version: ${newVersion}. Consider updating.`, { dependency, newVersion }, pluginId);
+    }
+    /**
+     * Send digest compilation notification.
+     */
+    notifyCommunityDigest(authorId, digest) {
+        return this.createNotification(authorId, "community_digest", `${digest.frequency} digest`, `You have ${digest.totalCount} new updates from the community`, digest);
+    }
+    // ─── Statistics ────────────────────────────────────────────────────────────
+    /**
+     * Get notification statistics for an author.
+     */
+    getNotificationStats(authorId) {
+        const authorNotifs = this.getAuthorNotifications(authorId);
+        const byType = {};
+        for (const notif of authorNotifs) {
+            byType[notif.type] = (byType[notif.type] || 0) + 1;
+        }
+        return {
+            totalNotifications: authorNotifs.length,
+            unreadCount: authorNotifs.filter((n) => !n.read).length,
+            byType,
+            byStatus: {
+                read: authorNotifs.filter((n) => n.read).length,
+                unread: authorNotifs.filter((n) => !n.read).length,
+            },
+        };
+    }
+    // ─── Cache helpers ────────────────────────────────────────────────────────
+    getNotificationsCache() {
+        return this.notifications;
+    }
+    getPreferencesCache() {
+        return this.preferences;
+    }
+    getDigestSettingsCache() {
+        return this.digestSettings;
+    }
+}
+//# sourceMappingURL=author-notifications.js.map

package/dist/author-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"author-notifications.js","sourceRoot":"","sources":["../src/author-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkFjD,iFAAiF;AAEjF,MAAM,OAAO,wBAAwB;IAC3B,aAAa,GAA8B,IAAI,GAAG,EAAE,CAAC;IACrD,WAAW,GAAwC,IAAI,GAAG,EAAE,CAAC;IAC7D,cAAc,GAAgC,IAAI,GAAG,EAAE,CAAC;IACxD,WAAW,GAA+B,IAAI,GAAG,EAAE,CAAC,CAAC,qBAAqB;IAC1E,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC,CAAC,sBAAsB;IAE/E,8EAA8E;IAE9E;;OAEG;IACH,kBAAkB,CAChB,QAAgB,EAChB,IAAsB,EACtB,KAAa,EACb,OAAe,EACf,WAAoC,EAAE,EACtC,QAAiB;QAEjB,MAAM,EAAE,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC;QAEvC,qDAAqD;QACrD,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAExF,MAAM,YAAY,GAAiB;YACjC,EAAE;YACF,QAAQ;YACR,IAAI;YACJ,QAAQ;YACR,KAAK;YACL,OAAO;YACP,QAAQ;YACR,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAEzC,2CAA2C;QAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,cAAc,IAAI,cAAc,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,YAAY,CAAC,EAAE;gBACnB,KAAK;gBACL,OAAO;gBACP,IAAI;gBACJ,SAAS,EAAE,YAAY,CAAC,SAAS;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,oBAAoB,CAAC,QAAgB,EAAE,IAAsB;QACnE,wEAAwE;QACxE,MAAM,aAAa,GAAuB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QACjF,MAAM,QAAQ,GAA0B,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;YAClE,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC;YACrB,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEzB,OAAO;YACL,QAAQ;YACR,gBAAgB,EAAE,IAAI;YACtB,QAAQ;YACR,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC;IACxD,CAAC;IAED,sBAAsB,CAAC,QAAgB,EAAE,UAAU,GAAG,KAAK,EAAE,KAAK,GAAG,EAAE;QACrE,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAClE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;aACjF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,cAAsB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB,CAAC,QAAgB;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAClE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;YAClB,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACxC,KAAK,EAAE,CAAC;QACV,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB,CAAC,cAAsB;QACvC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC;IAED,6EAA6E;IAE7E;;OAEG;IACH,aAAa,CACX,QAAgB,EAChB,IAAsB,EACtB,QAA+B,EAC/B,OAAgB;QAEhB,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,GAA2B;YACnC,QAAQ;YACR,gBAAgB,EAAE,IAAI;YACtB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;YACjC,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,QAAgB,EAAE,IAAsB;QACpD,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,oBAAoB,CAAC,QAAgB;QACnC,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC/E,CAAC;IAED,uBAAuB,CAAC,QAAgB,EAAE,IAAsB;QAC9D,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,sBAAsB,CACpB,QAAgB,EAChB,IAAsB,EACtB,WAAkC,CAAC,QAAQ,EAAE,OAAO,CAAC;QAErD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,8EAA8E;IAE9E;;OAEG;IACH,iBAAiB,CACf,QAAgB,EAChB,SAA0B,EAC1B,KAAyB,EACzB,YAAqB,EACrB,aAAsB;QAEtB,MAAM,QAAQ,GAAmB;YAC/B,QAAQ;YACR,SAAS;YACT,YAAY;YACZ,aAAa,EAAE,aAAa,IAAI,OAAO;YACvC,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAgB,EAAE,SAA0B;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAE/D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,MAAM,YAAY,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC;QAExC,sCAAsC;QACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;YAChC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,MAAM,GAAmB;YAC7B,QAAQ;YACR,SAAS;YACT,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,kCAAkC;YAClE,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,WAAW;YACX,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5D,8BAA8B;QAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,uBAAuB,CAAC,QAAgB;QACtC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,8EAA8E;IAE9E;;OAEG;IACH,eAAe,CACb,QAAgB,EAChB,QAAgB,EAChB,UAAkB,EAClB,MAAc,EACd,OAAe;QAEf,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,YAAY,EACZ,4BAA4B,EAC5B,GAAG,UAAU,WAAW,MAAM,cAAc,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,EACvE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,EAC/B,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,uBAAuB,CACrB,QAAgB,EAChB,QAAgB,EAChB,gBAAwB;QAExB,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC;QAEjE,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5B,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,SAAS,aAAa,EACjD,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAC/B,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,mBAAmB,CACjB,QAAgB,EAChB,QAAgB,EAChB,aAAqB,EACrB,QAAgD;QAEhD,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,GAAG,QAAQ,CAAC,WAAW,EAAE,KAAK,aAAa,6BAA6B,EACxE,EAAE,aAAa,EAAE,QAAQ,EAAE,EAC3B,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CACnB,QAAgB,EAChB,QAAgB,EAChB,aAAqB,EACrB,SAAiB;QAEjB,IAAI,aAAa,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5C,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,mCAAmC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,SAAS,IAAI,EACzF,EAAE,aAAa,EAAE,SAAS,EAAE,EAC5B,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,sBAAsB,CACpB,QAAgB,EAChB,QAAgB,EAChB,UAAkB,EAClB,UAAkB;QAElB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,mBAAmB,EACnB,6BAA6B,EAC7B,GAAG,UAAU,uBAAuB,UAAU,sBAAsB,EACpE,EAAE,UAAU,EAAE,UAAU,EAAE,EAC1B,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,QAAgB,EAAE,MAAsB;QAC5D,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,kBAAkB,EAClB,GAAG,MAAM,CAAC,SAAS,SAAS,EAC5B,YAAY,MAAM,CAAC,UAAU,iCAAiC,EAC9D,MAA4C,CAC7C,CAAC;IACJ,CAAC;IAED,8EAA8E;IAE9E;;OAEG;IACH,oBAAoB,CAAC,QAAgB;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAE3D,MAAM,MAAM,GAAqC,EAAsC,CAAC;QACxF,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,OAAO;YACL,kBAAkB,EAAE,YAAY,CAAC,MAAM;YACvC,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;YACvD,MAAM;YACN,QAAQ,EAAE;gBACR,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;gBAC/C,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;aACnD;SACF,CAAC;IACJ,CAAC;IAED,6EAA6E;IAE7E,qBAAqB;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,sBAAsB;QACpB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/author-verification.d.ts

@@ -0,0 +1,79 @@
+export type VerificationStatus = "pending" | "verified" | "rejected" | "expired";
+export type VerificationStep = "github" | "email" | "cla" | "review" | "publisher";
+export interface VerificationToken {
+    token: string;
+    type: "email" | "github";
+    authorId: string;
+    expiresAt: string;
+    usedAt?: string;
+}
+export interface GitHubVerification {
+    githubId: string;
+    githubLogin: string;
+    githubName?: string;
+    githubAvatarUrl?: string;
+    verifiedAt: string;
+}
+export interface EmailVerification {
+    email: string;
+    verifiedAt: string;
+    domain: string;
+}
+export interface CLASignature {
+    version: string;
+    signedAt: string;
+    ipAddress?: string;
+}
+export interface VerificationRecord {
+    authorId: string;
+    status: VerificationStatus;
+    steps: VerificationStep[];
+    completedSteps: VerificationStep[];
+    github?: GitHubVerification;
+    email?: EmailVerification;
+    cla?: CLASignature;
+    publisherApprovedAt?: string;
+    publisherApprovedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface VerificationResult {
+    success: boolean;
+    step: VerificationStep;
+    message: string;
+    nextStep?: VerificationStep;
+    record?: VerificationRecord;
+}
+export declare class AuthorVerificationSystem {
+    private records;
+    private tokens;
+    startVerification(authorId: string): VerificationRecord;
+    getVerification(authorId: string): VerificationRecord | null;
+    generateGitHubState(authorId: string): string;
+    parseGitHubState(state: string): {
+        authorId: string;
+    } | null;
+    completeGitHubVerification(authorId: string, githubData: {
+        id: string;
+        login: string;
+        name?: string;
+        avatar_url?: string;
+    }): Promise<VerificationResult>;
+    generateEmailToken(authorId: string, email: string): string;
+    verifyEmailToken(token: string, email: string): Promise<VerificationResult>;
+    signCLA(authorId: string, claVersion: string, ipAddress?: string): Promise<VerificationResult>;
+    approvePublisher(authorId: string, approvedBy: string): Promise<VerificationResult>;
+    isStepComplete(authorId: string, step: VerificationStep): boolean;
+    isFullyVerified(record: VerificationRecord): boolean;
+    isPublisherVerified(authorId: string): boolean;
+    getNextStep(record: VerificationRecord): VerificationStep | null;
+    getVerificationProgress(authorId: string): {
+        total: number;
+        completed: number;
+        percent: number;
+        nextStep: VerificationStep | null;
+    };
+    private completeStep;
+    setRecordsCache(records: VerificationRecord[]): void;
+    getTokensCache(): Map<string, VerificationToken>;
+}