aimeat 1.2.0

package/dist/src/services/match-notification.js

@@ -0,0 +1,121 @@
+/**
+ * Match Notification Service — Phase 1.6
+ *
+ * Background job that periodically scans the directory index for
+ * new matches and sends email notifications to users who opted in.
+ */
+import { logger } from '../utils/logger.js';
+export function startMatchNotificationJob(config, storage, emailService, directoryService) {
+    if (!config.matchNotificationEnabled) {
+        logger.info('Match notification job disabled');
+        return null;
+    }
+    if (!emailService.enabled) {
+        logger.info('Match notification job skipped (email not configured)');
+        return null;
+    }
+    const state = {
+        lastRunAt: null,
+        knownGhiis: new Set(),
+    };
+    const run = async () => {
+        try {
+            // Rebuild directory index first to get latest data
+            await directoryService.rebuildIndex();
+            const stats = directoryService.getStats();
+            const allEntries = (await directoryService.search({ perPage: 10000 })).entries;
+            if (state.lastRunAt === null) {
+                // First run: just populate the known set, don't send notifications
+                for (const entry of allEntries) {
+                    state.knownGhiis.add(entry.ghii);
+                }
+                state.lastRunAt = new Date().toISOString();
+                logger.info('Match notification: initial index populated', { count: allEntries.length });
+                return;
+            }
+            // Find new entries since last run
+            const newEntries = allEntries.filter(e => !state.knownGhiis.has(e.ghii));
+            if (newEntries.length === 0) {
+                state.lastRunAt = new Date().toISOString();
+                return;
+            }
+            logger.info('Match notification: found new entries', { count: newEntries.length });
+            // For each existing user, check if any new entries share interests
+            for (const existing of allEntries) {
+                if (newEntries.some(n => n.ghii === existing.ghii))
+                    continue; // skip new entries themselves
+                const matches = [];
+                for (const newEntry of newEntries) {
+                    const shared = existing.interests.filter(i => newEntry.interests.map(x => x.toLowerCase()).includes(i.toLowerCase()));
+                    if (shared.length > 0) {
+                        let distance;
+                        if (existing.city && newEntry.city && existing.city.toLowerCase() === newEntry.city.toLowerCase()) {
+                            distance = existing.city;
+                        }
+                        matches.push({
+                            ghii: newEntry.ghii,
+                            displayName: newEntry.displayName,
+                            sharedInterests: shared,
+                            distance,
+                        });
+                    }
+                }
+                if (matches.length === 0)
+                    continue;
+                // Find notification email for this user via GHII record
+                try {
+                    const ghiiRecord = await storage.getGHII(existing.ghii);
+                    if (!ghiiRecord)
+                        continue;
+                    // Check consent for notifications
+                    const agents = await storage.getAgentsByOwner(ghiiRecord.ownerName);
+                    let hasNotificationConsent = false;
+                    for (const agent of agents) {
+                        const consents = await storage.listConsents(agent.gaii, { status: 'active' });
+                        if (consents.some(c => c.purpose === 'community-discovery' && c.status === 'active')) {
+                            hasNotificationConsent = true;
+                            break;
+                        }
+                    }
+                    if (!hasNotificationConsent)
+                        continue;
+                    // Send match suggestion email if the user has a notification email
+                    if (ghiiRecord.notificationEmail) {
+                        await emailService.sendMatchSuggestion(ghiiRecord.notificationEmail, matches, ghiiRecord.locale);
+                        logger.info('Match notification sent', {
+                            recipientGhii: existing.ghii,
+                            matchCount: matches.length,
+                        });
+                    }
+                    else {
+                        logger.info('Match notification skipped (no notification email)', {
+                            recipientGhii: existing.ghii,
+                            matchCount: matches.length,
+                        });
+                    }
+                }
+                catch {
+                    // Skip users we can't find email for
+                }
+            }
+            // Update known set
+            for (const entry of newEntries) {
+                state.knownGhiis.add(entry.ghii);
+            }
+            state.lastRunAt = new Date().toISOString();
+            logger.info('Match notification run complete', { newEntries: newEntries.length });
+        }
+        catch (err) {
+            logger.error('Match notification job failed', { error: String(err) });
+        }
+    };
+    const intervalMs = config.matchNotificationIntervalHours * 3_600_000;
+    const timer = setInterval(run, intervalMs);
+    // Run first check after a delay to let the directory index build
+    setTimeout(run, 30_000);
+    logger.info('Match notification job scheduled', {
+        intervalHours: config.matchNotificationIntervalHours,
+    });
+    return timer;
+}
+//# sourceMappingURL=match-notification.js.map

package/dist/src/services/match-notification.js.map

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

package/dist/src/services/matching.d.ts

@@ -0,0 +1,54 @@
+/**
+ * AI Matching Engine — Phase 2.1
+ *
+ * Automated matching system that compares user profiles based on
+ * interests, geographic proximity, activity, and compatibility.
+ *
+ * Scoring formula:
+ *   match_score = (0.40 x shared_interests_score)
+ *               + (0.25 x distance_score)
+ *               + (0.20 x activity_score)
+ *               + (0.15 x compatibility_score)
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage, MatchRecord } from '../storage/interface.js';
+import type { DirectoryService } from './directory.js';
+import type { EmailService } from './email.js';
+export interface ProfileData {
+    ghii: string;
+    displayName: string;
+    interests: string[];
+    seeking?: string[];
+    city?: string;
+    area?: string;
+    country?: string;
+    lat?: number;
+    lon?: number;
+    lastActivityAt?: string;
+}
+export interface MatchScore {
+    score: number;
+    breakdown: {
+        sharedInterests: string[];
+        distanceKm: number | null;
+        activityDays: number;
+        sharedInterestsScore: number;
+        distanceScore: number;
+        activityScore: number;
+        compatibilityScore: number;
+    };
+}
+export interface MatchingRoundResult {
+    profilesScanned: number;
+    matchesCreated: number;
+    durationMs: number;
+    timestamp: string;
+}
+export interface MatchingEngine {
+    runMatchingRound(): Promise<MatchingRoundResult>;
+    calculateMatchScore(profileA: ProfileData, profileB: ProfileData, maxDistanceKm: number): MatchScore;
+    getSuggestionsForProfile(ghii: string): Promise<MatchRecord[]>;
+}
+export declare function createMatchingEngine(config: AimeatConfig, storage: Storage, directoryService: DirectoryService, emailService: EmailService): MatchingEngine;
+export declare function startMatchingScheduler(config: AimeatConfig, matchingEngine: MatchingEngine): NodeJS.Timeout | null;
+//# sourceMappingURL=matching.d.ts.map

package/dist/src/services/matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.d.ts","sourceRoot":"","sources":["../../../src/services/matching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjD,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC;IACrG,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAChE;AAwGD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,GACzB,cAAc,CAqMhB;AAID,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,cAAc,GAC7B,MAAM,CAAC,OAAO,GAAG,IAAI,CA8BvB"}

package/dist/src/services/matching.js

@@ -0,0 +1,293 @@
+/**
+ * AI Matching Engine — Phase 2.1
+ *
+ * Automated matching system that compares user profiles based on
+ * interests, geographic proximity, activity, and compatibility.
+ *
+ * Scoring formula:
+ *   match_score = (0.40 x shared_interests_score)
+ *               + (0.25 x distance_score)
+ *               + (0.20 x activity_score)
+ *               + (0.15 x compatibility_score)
+ */
+import { randomBytes } from 'node:crypto';
+import { logger } from '../utils/logger.js';
+// ── Haversine distance ───────────────────────────────────────
+function haversineKm(lat1, lon1, lat2, lon2) {
+    const R = 6371;
+    const dLat = (lat2 - lat1) * Math.PI / 180;
+    const dLon = (lon2 - lon1) * Math.PI / 180;
+    const a = Math.sin(dLat / 2) ** 2 +
+        Math.cos(lat1 * Math.PI / 180) * Math.cos(lat2 * Math.PI / 180) * Math.sin(dLon / 2) ** 2;
+    return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+}
+// ── Score calculation ────────────────────────────────────────
+function calculateMatchScoreImpl(profileA, profileB, maxDistanceKm) {
+    // 1. Shared interests score: min(shared_count / 3, 1.0)
+    const lowerA = profileA.interests.map(i => i.toLowerCase());
+    const lowerB = profileB.interests.map(i => i.toLowerCase());
+    const sharedInterests = [];
+    for (const interest of profileA.interests) {
+        if (lowerB.includes(interest.toLowerCase())) {
+            sharedInterests.push(interest);
+        }
+    }
+    const sharedInterestsScore = Math.min(sharedInterests.length / 3, 1.0);
+    // 2. Distance score: max(1.0 - (distance_km / max_distance_km), 0)
+    let distanceKm = null;
+    let distanceScore = 0.5; // default when location is unknown
+    if (profileA.lat !== undefined && profileA.lon !== undefined &&
+        profileB.lat !== undefined && profileB.lon !== undefined) {
+        distanceKm = haversineKm(profileA.lat, profileA.lon, profileB.lat, profileB.lon);
+        distanceScore = Math.max(1.0 - (distanceKm / maxDistanceKm), 0);
+    }
+    // 3. Activity score: max(1.0 - (days_since_last_activity / 90), 0)
+    let activityDays = 90; // default: assume inactive
+    if (profileB.lastActivityAt) {
+        const daysSince = (Date.now() - new Date(profileB.lastActivityAt).getTime()) / 86_400_000;
+        activityDays = Math.round(daysSince);
+    }
+    const activityScore = Math.max(1.0 - (activityDays / 90), 0);
+    // 4. Compatibility score: seeking_match_ratio
+    let compatibilityScore = 0.5; // default when no seeking data
+    if (profileA.seeking && profileA.seeking.length > 0) {
+        const seekingLower = profileA.seeking.map(s => s.toLowerCase());
+        // How well does profileB match what profileA is seeking?
+        const matchCount = seekingLower.filter(s => lowerB.includes(s) ||
+            (profileB.city?.toLowerCase() === s) ||
+            (profileB.area?.toLowerCase() === s) ||
+            (profileB.country?.toLowerCase() === s)).length;
+        compatibilityScore = Math.min(matchCount / profileA.seeking.length, 1.0);
+    }
+    // Weighted sum
+    const score = (0.40 * sharedInterestsScore) +
+        (0.25 * distanceScore) +
+        (0.20 * activityScore) +
+        (0.15 * compatibilityScore);
+    return {
+        score: Math.round(score * 1000) / 1000, // 3 decimal places
+        breakdown: {
+            sharedInterests,
+            distanceKm: distanceKm !== null ? Math.round(distanceKm * 10) / 10 : null,
+            activityDays,
+            sharedInterestsScore: Math.round(sharedInterestsScore * 1000) / 1000,
+            distanceScore: Math.round(distanceScore * 1000) / 1000,
+            activityScore: Math.round(activityScore * 1000) / 1000,
+            compatibilityScore: Math.round(compatibilityScore * 1000) / 1000,
+        },
+    };
+}
+// ── DirectoryEntry to ProfileData conversion ─────────────────
+function entryToProfile(entry, lastActivityAt) {
+    return {
+        ghii: entry.ghii,
+        displayName: entry.displayName,
+        interests: entry.interests,
+        city: entry.city,
+        area: entry.area,
+        country: entry.country,
+        lat: entry.lat,
+        lon: entry.lon,
+        lastActivityAt,
+    };
+}
+// ── Factory ──────────────────────────────────────────────────
+export function createMatchingEngine(config, storage, directoryService, emailService) {
+    let lastRoundResult = null;
+    async function runMatchingRound() {
+        const startTime = Date.now();
+        let matchesCreated = 0;
+        try {
+            // 1. Rebuild directory index to get latest data
+            await directoryService.rebuildIndex();
+            // 2. Get all profiles with consent for matching
+            const allEntries = (await directoryService.search({ perPage: 10000 })).entries;
+            // Filter to profiles with matching consent
+            const matchableProfiles = [];
+            for (const entry of allEntries) {
+                try {
+                    const ghiiRecord = await storage.getGHII(entry.ghii);
+                    if (!ghiiRecord)
+                        continue;
+                    const agents = await storage.getAgentsByOwner(ghiiRecord.ownerName);
+                    let hasMatchingConsent = false;
+                    let consentAgentGaii = '';
+                    for (const agent of agents) {
+                        const consents = await storage.listConsents(agent.gaii, { status: 'active' });
+                        const matchConsent = consents.find(c => c.purpose === 'matching' && c.status === 'active');
+                        if (matchConsent) {
+                            hasMatchingConsent = true;
+                            consentAgentGaii = agent.gaii;
+                            break;
+                        }
+                    }
+                    if (hasMatchingConsent) {
+                        matchableProfiles.push({ entry, agentGaii: consentAgentGaii });
+                    }
+                }
+                catch {
+                    // Skip profiles we can't check consent for
+                }
+            }
+            const profilesScanned = matchableProfiles.length;
+            logger.info('Matching round: scanning profiles', { count: profilesScanned });
+            // 3. For each profile, find potential matches
+            const cooldownMs = config.matchCooldownDays * 86_400_000;
+            for (const { entry: profileA, agentGaii: agentA } of matchableProfiles) {
+                const profileDataA = entryToProfile(profileA);
+                // Load seeking data from memory
+                const ghiiA = await storage.getGHII(profileA.ghii);
+                if (ghiiA) {
+                    const seekingMemory = await storage.getMemory(agentA, `profile.${ghiiA.username}.seeking`);
+                    if (seekingMemory?.value) {
+                        if (Array.isArray(seekingMemory.value)) {
+                            profileDataA.seeking = seekingMemory.value;
+                        }
+                        else if (typeof seekingMemory.value === 'object' && seekingMemory.value !== null) {
+                            const val = seekingMemory.value;
+                            if (Array.isArray(val.items))
+                                profileDataA.seeking = val.items;
+                            if (Array.isArray(val.seeking))
+                                profileDataA.seeking = val.seeking;
+                        }
+                    }
+                }
+                const candidates = [];
+                for (const { entry: profileB } of matchableProfiles) {
+                    // Skip self
+                    if (profileB.ghii === profileA.ghii)
+                        continue;
+                    // Check cooldown: skip if already suggested recently
+                    const existingMatch = await storage.getMatchByPair(profileA.ghii, profileB.ghii);
+                    if (existingMatch) {
+                        const matchAge = Date.now() - new Date(existingMatch.createdAt).getTime();
+                        // Skip if within cooldown and not dismissed/expired
+                        if (matchAge < cooldownMs && !['dismissed', 'expired'].includes(existingMatch.status)) {
+                            continue;
+                        }
+                        // Skip if recently dismissed (within cooldown)
+                        if (existingMatch.status === 'dismissed' && matchAge < cooldownMs) {
+                            continue;
+                        }
+                    }
+                    const profileDataB = entryToProfile(profileB);
+                    const score = calculateMatchScoreImpl(profileDataA, profileDataB, config.matchMaxDistanceKm);
+                    // Only include matches above threshold
+                    if (score.score >= config.matchThreshold) {
+                        candidates.push({ score, entry: profileB });
+                    }
+                }
+                // Sort by score descending, take top N
+                candidates.sort((a, b) => b.score.score - a.score.score);
+                const topCandidates = candidates.slice(0, config.matchMaxSuggestions);
+                // 4. Create MatchRecords
+                for (const { score, entry: profileB } of topCandidates) {
+                    const now = new Date().toISOString();
+                    const expiresAt = new Date(Date.now() + 30 * 86_400_000).toISOString(); // 30 days
+                    const matchRecord = {
+                        id: `match-${randomBytes(8).toString('hex')}`,
+                        profileA: profileA.ghii,
+                        profileB: profileB.ghii,
+                        score: score.score,
+                        breakdown: score.breakdown,
+                        status: 'suggested',
+                        notifiedAt: null,
+                        respondedAt: null,
+                        expiresAt,
+                        createdAt: now,
+                    };
+                    await storage.createMatch(matchRecord);
+                    matchesCreated++;
+                    // 5. Send email notification if enabled
+                    if (emailService.enabled) {
+                        try {
+                            const ghiiRecordA = await storage.getGHII(profileA.ghii);
+                            if (ghiiRecordA?.emailHash) {
+                                // Look up email from verification records
+                                const verifications = await storage.getEmailVerificationsByOwner?.(ghiiRecordA.ownerName);
+                                const verified = verifications?.find(v => v.status === 'verified');
+                                if (verified) {
+                                    // Update status to notified
+                                    await storage.updateMatch(matchRecord.id, {
+                                        status: 'notified',
+                                        notifiedAt: new Date().toISOString(),
+                                    });
+                                    logger.info('Match notification would send', {
+                                        recipientGhii: profileA.ghii,
+                                        matchedGhii: profileB.ghii,
+                                        score: score.score,
+                                    });
+                                }
+                            }
+                        }
+                        catch {
+                            // Failed to send notification — match still created
+                        }
+                    }
+                }
+            }
+            // 6. Clean up expired matches
+            const expired = await storage.deleteExpiredMatches();
+            if (expired > 0) {
+                logger.info('Matching round: cleaned expired matches', { count: expired });
+            }
+            const result = {
+                profilesScanned,
+                matchesCreated,
+                durationMs: Date.now() - startTime,
+                timestamp: new Date().toISOString(),
+            };
+            lastRoundResult = result;
+            logger.info('Matching round complete', result);
+            return result;
+        }
+        catch (err) {
+            logger.error('Matching round failed', { error: String(err) });
+            return {
+                profilesScanned: 0,
+                matchesCreated: 0,
+                durationMs: Date.now() - startTime,
+                timestamp: new Date().toISOString(),
+            };
+        }
+    }
+    function calculateMatchScore(profileA, profileB, maxDistanceKm) {
+        return calculateMatchScoreImpl(profileA, profileB, maxDistanceKm);
+    }
+    async function getSuggestionsForProfile(ghii) {
+        return storage.listMatchesByProfile(ghii, { status: 'suggested' });
+    }
+    return {
+        runMatchingRound,
+        calculateMatchScore,
+        getSuggestionsForProfile,
+    };
+}
+// ── Scheduler ────────────────────────────────────────────────
+export function startMatchingScheduler(config, matchingEngine) {
+    if (!config.matchingEnabled) {
+        logger.info('AI Matching engine disabled');
+        return null;
+    }
+    const intervalMs = config.matchIntervalHours * 3_600_000;
+    const timer = setInterval(() => {
+        matchingEngine.runMatchingRound().catch(err => {
+            logger.error('Scheduled matching round failed', { error: String(err) });
+        });
+    }, intervalMs);
+    // Run first matching round after a delay to let directory index build
+    setTimeout(() => {
+        matchingEngine.runMatchingRound().catch(err => {
+            logger.error('Initial matching round failed', { error: String(err) });
+        });
+    }, 60_000); // 1 minute delay
+    logger.info('AI Matching scheduler started', {
+        intervalHours: config.matchIntervalHours,
+        threshold: config.matchThreshold,
+        maxSuggestions: config.matchMaxSuggestions,
+        maxDistanceKm: config.matchMaxDistanceKm,
+        cooldownDays: config.matchCooldownDays,
+    });
+    return timer;
+}
+//# sourceMappingURL=matching.js.map

package/dist/src/services/matching.js.map

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

package/dist/src/services/memory-replication.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Memory Replication Service — consent-based memory replication to federation peers.
+ * Per RFC v1.6 §13.11.4 (replication protocol) and §13.11.5 (queue).
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import type { PeerInfo } from '../services/federation.js';
+export interface ReplicationResult {
+    peer_node_id: string;
+    entries_sent: number;
+    entries_failed: number;
+    consent_denied: number;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Check if a memory entry is eligible for federation replication.
+ * Requirements:
+ * 1. visibility: 'public'
+ * 2. Active consent with scope 'federation' exists
+ */
+export declare function isEligibleForReplication(storage: Storage, ownerGaii: string, key: string): Promise<{
+    eligible: boolean;
+    consentId?: string;
+}>;
+/**
+ * Replicate a single memory entry to a specific peer.
+ */
+export declare function replicateMemoryToPeer(peer: PeerInfo, ownerGaii: string, key: string, config: AimeatConfig, storage: Storage): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Replicate all eligible memories to all active peers.
+ * Called during scheduled sync cycles.
+ */
+export declare function replicateMemoryToAllPeers(config: AimeatConfig, storage: Storage, peers: Map<string, PeerInfo>): Promise<ReplicationResult[]>;
+/**
+ * Enqueue a memory entry for replication via the replication queue.
+ * Called from memory write handlers when an eligible entry is created/updated.
+ */
+export declare function enqueueMemoryReplication(ownerGaii: string, key: string, config: AimeatConfig, storage: Storage, peers: Map<string, PeerInfo>): Promise<void>;
+//# sourceMappingURL=memory-replication.d.ts.map

package/dist/src/services/memory-replication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-replication.d.ts","sourceRoot":"","sources":["../../../src/services/memory-replication.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAK1D,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBpD;AAwBD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/C;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuE9B;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf"}