sandstream-kit 1.0.0

package/dist/cache-manager.js

@@ -0,0 +1,244 @@
+// ─── Types ────────────────────────────────────────────────────────────────────
+// ─── CacheManager ────────────────────────────────────────────────────────────
+export class CacheManager {
+    cache = new Map();
+    hits = 0;
+    misses = 0;
+    evictions = 0;
+    config;
+    constructor(config = { maxSize: 1000, defaultTtl: 3600, strategy: "lru" }) {
+        this.config = config;
+    }
+    // ─── Basic Operations ──────────────────────────────────────────────────────
+    /**
+     * Set cache entry.
+     */
+    set(key, value, ttl) {
+        // Check capacity
+        if (this.cache.size >= this.config.maxSize &&
+            !this.cache.has(key)) {
+            this.evictEntry();
+        }
+        const expiresAt = ttl
+            ? new Date(Date.now() + ttl * 1000).toISOString()
+            : undefined;
+        this.cache.set(key, {
+            key,
+            value,
+            ttl,
+            createdAt: new Date().toISOString(),
+            expiresAt,
+            hits: 0,
+        });
+    }
+    /**
+     * Get cache entry.
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return null;
+        }
+        // Check expiration
+        if (entry.expiresAt && new Date(entry.expiresAt) < new Date()) {
+            this.cache.delete(key);
+            this.misses++;
+            return null;
+        }
+        // Record hit
+        entry.hits++;
+        this.hits++;
+        return entry.value;
+    }
+    /**
+     * Check if key exists.
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        // Check expiration
+        if (entry.expiresAt && new Date(entry.expiresAt) < new Date()) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delete cache entry.
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all cache entries.
+     */
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    // ─── Cache Invalidation ────────────────────────────────────────────────────
+    /**
+     * Invalidate entries by pattern.
+     */
+    invalidatePattern(pattern) {
+        let count = 0;
+        const regex = new RegExp(pattern);
+        for (const key of this.cache.keys()) {
+            if (regex.test(key)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Invalidate entries by prefix.
+     */
+    invalidatePrefix(prefix) {
+        let count = 0;
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(prefix)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Clear expired entries.
+     */
+    cleanExpired() {
+        let count = 0;
+        const now = new Date();
+        for (const entry of this.cache.values()) {
+            if (entry.expiresAt && new Date(entry.expiresAt) < now) {
+                this.cache.delete(entry.key);
+                count++;
+            }
+        }
+        return count;
+    }
+    // ─── Eviction Strategy ─────────────────────────────────────────────────────
+    evictEntry() {
+        let keyToEvict = null;
+        if (this.config.strategy === "lru") {
+            // Least Recently Used: lowest hit count
+            keyToEvict = this.findLRUKey();
+        }
+        else if (this.config.strategy === "lfu") {
+            // Least Frequently Used: oldest entry
+            keyToEvict = this.findLFUKey();
+        }
+        else if (this.config.strategy === "fifo") {
+            // First In First Out: oldest by creation time
+            keyToEvict = this.findFIFOKey();
+        }
+        if (keyToEvict) {
+            this.cache.delete(keyToEvict);
+            this.evictions++;
+        }
+    }
+    findLRUKey() {
+        let minHits = Infinity;
+        let oldestKey = null;
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.hits < minHits) {
+                minHits = entry.hits;
+                oldestKey = key;
+            }
+        }
+        return oldestKey;
+    }
+    findLFUKey() {
+        let minTime = Infinity;
+        let oldestKey = null;
+        for (const [key, entry] of this.cache.entries()) {
+            const createdTime = new Date(entry.createdAt).getTime();
+            if (createdTime < minTime) {
+                minTime = createdTime;
+                oldestKey = key;
+            }
+        }
+        return oldestKey;
+    }
+    findFIFOKey() {
+        return this.cache.keys().next().value || null;
+    }
+    // ─── Statistics ────────────────────────────────────────────────────────────
+    /**
+     * Get cache statistics.
+     */
+    getStats() {
+        const totalRequests = this.hits + this.misses;
+        const hitRate = totalRequests > 0 ? this.hits / totalRequests : 0;
+        return {
+            totalSize: this.cache.size,
+            totalEntries: this.cache.size,
+            hitRate: Math.round(hitRate * 100) / 100,
+            evictions: this.evictions,
+        };
+    }
+    /**
+     * Get hit count.
+     */
+    getHits() {
+        return this.hits;
+    }
+    /**
+     * Get miss count.
+     */
+    getMisses() {
+        return this.misses;
+    }
+    /**
+     * Get hit rate percentage.
+     */
+    getHitRate() {
+        const total = this.hits + this.misses;
+        if (total === 0)
+            return 0;
+        return Math.round((this.hits / total) * 100);
+    }
+    // ─── Cache Inspection ──────────────────────────────────────────────────────
+    /**
+     * Get all cache keys.
+     */
+    getKeys() {
+        return [...this.cache.keys()];
+    }
+    /**
+     * Get cache entry details.
+     */
+    getEntry(key) {
+        const entry = this.cache.get(key);
+        return entry ? entry : null;
+    }
+    /**
+     * Get all entries.
+     */
+    getAllEntries() {
+        return [...this.cache.values()];
+    }
+    /**
+     * Get size in bytes (rough estimate).
+     */
+    getApproximateSize() {
+        let size = 0;
+        for (const entry of this.cache.values()) {
+            // Rough estimate: key length + value serialization
+            size += entry.key.length + JSON.stringify(entry.value).length;
+        }
+        return size;
+    }
+    // ─── Cache helpers ────────────────────────────────────────────────────────
+    getCacheMap() {
+        return this.cache;
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+//# sourceMappingURL=cache-manager.js.map

package/dist/cache-manager.js.map

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

package/dist/cdn-adapter.d.ts

@@ -0,0 +1,64 @@
+import { AbstractServiceAdapter, type ServiceConfig, type ServiceEvent, type ServiceHealth } from "./service-adapter.js";
+/**
+ * CDN adapter for CloudFront and Cloudflare integration.
+ */
+export declare class CDNAdapter extends AbstractServiceAdapter {
+    private lastHealthCheck;
+    private healthCheckErrors;
+    private cacheStats;
+    constructor(config?: ServiceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    getHealth(): Promise<ServiceHealth>;
+    protected sendEvent(event: ServiceEvent): Promise<void>;
+    /**
+     * Purge cache for specific paths.
+     */
+    purge(paths: string[]): Promise<boolean>;
+    /**
+     * Purge all cache.
+     */
+    purgeAll(): Promise<boolean>;
+    /**
+     * Record cache hit.
+     */
+    recordCacheHit(path: string, sizeBytes?: number): Promise<boolean>;
+    /**
+     * Record cache miss.
+     */
+    recordCacheMiss(path: string, sizeBytes?: number): Promise<boolean>;
+    /**
+     * Set cache headers.
+     */
+    setCachePolicy(pathPattern: string, ttl: number, cacheKeyPolicy?: Record<string, string>): Promise<boolean>;
+    /**
+     * Get current cache statistics.
+     */
+    getCacheStats(): {
+        hits: number;
+        misses: number;
+        evictions: number;
+        invalidations: number;
+        hitRate: number;
+    };
+    /**
+     * Record cache eviction.
+     */
+    recordEviction(): Promise<boolean>;
+    /**
+     * Flush all queued events.
+     */
+    private flushQueue;
+    /**
+     * Get CDN configuration info.
+     */
+    getInfo(): {
+        provider: string;
+        endpoint: string;
+        apiKey: string;
+    };
+}
+/**
+ * Create a CDN adapter from environment variables.
+ */
+export declare function createCDNAdapter(enabled?: boolean): CDNAdapter;

package/dist/cdn-adapter.js

@@ -0,0 +1,263 @@
+// ─── CDN Integration Adapter (CloudFront/Cloudflare) ────────────────────
+import { AbstractServiceAdapter, simulatedFailuresEnabled, } from "./service-adapter.js";
+/**
+ * CDN adapter for CloudFront and Cloudflare integration.
+ */
+export class CDNAdapter extends AbstractServiceAdapter {
+    lastHealthCheck = new Date().toISOString();
+    healthCheckErrors = 0;
+    cacheStats = {
+        hits: 0,
+        misses: 0,
+        evictions: 0,
+        invalidations: 0,
+    };
+    constructor(config = { enabled: false }) {
+        super("cdn", "1.0.0", config);
+    }
+    async connect() {
+        if (!this.config.enabled) {
+            this.connected = false;
+            return;
+        }
+        // Validate required config
+        if (!this.config.apiKey) {
+            throw new Error("CDN API Key is required");
+        }
+        if (!this.config.endpoint) {
+            throw new Error("CDN endpoint/distribution ID is required");
+        }
+        // Simulate connection test
+        await new Promise((resolve) => setTimeout(resolve, 75));
+        this.connected = true;
+        // Flush queued events
+        await this.flushQueue();
+    }
+    async disconnect() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+        this.connected = false;
+    }
+    async getHealth() {
+        const responseTime = Math.random() * 100;
+        try {
+            if (!this.connected) {
+                this.healthCheckErrors++;
+            }
+            this.lastHealthCheck = new Date().toISOString();
+            const status = this.healthCheckErrors < 3
+                ? this.connected
+                    ? "healthy"
+                    : "degraded"
+                : "unhealthy";
+            return {
+                status,
+                lastCheck: this.lastHealthCheck,
+                responseTime: Math.round(responseTime),
+                errorCount: this.healthCheckErrors,
+            };
+        }
+        catch {
+            this.healthCheckErrors++;
+            return {
+                status: "unhealthy",
+                lastCheck: new Date().toISOString(),
+                responseTime: -1,
+                errorCount: this.healthCheckErrors,
+            };
+        }
+    }
+    async sendEvent(event) {
+        if (!this.connected) {
+            throw new Error("Not connected to CDN");
+        }
+        // Validate event
+        if (!event.type || !event.data) {
+            throw new Error("Invalid event format");
+        }
+        // Simulate CDN API call
+        await new Promise((resolve) => setTimeout(resolve, Math.random() * 75));
+        // Simulate occasional failures (0.2% rate for CDN)
+        if (simulatedFailuresEnabled() && Math.random() < 0.002) {
+            throw new Error("Simulated CDN API error");
+        }
+    }
+    /**
+     * Purge cache for specific paths.
+     */
+    async purge(paths) {
+        const event = {
+            type: "event",
+            data: {
+                operation: "purge",
+                paths,
+                count: paths.length,
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                operation: "purge",
+            },
+        };
+        const success = await this.send(event);
+        if (success) {
+            this.cacheStats.invalidations += paths.length;
+        }
+        return success;
+    }
+    /**
+     * Purge all cache.
+     */
+    async purgeAll() {
+        const event = {
+            type: "event",
+            data: {
+                operation: "purge_all",
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                operation: "purge_all",
+            },
+        };
+        const success = await this.send(event);
+        if (success) {
+            this.cacheStats.invalidations++;
+        }
+        return success;
+    }
+    /**
+     * Record cache hit.
+     */
+    async recordCacheHit(path, sizeBytes) {
+        const event = {
+            type: "metric",
+            data: {
+                operation: "cache_hit",
+                path,
+                sizeBytes,
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                operation: "cache_hit",
+            },
+        };
+        const success = await this.send(event);
+        if (success) {
+            this.cacheStats.hits++;
+        }
+        return success;
+    }
+    /**
+     * Record cache miss.
+     */
+    async recordCacheMiss(path, sizeBytes) {
+        const event = {
+            type: "metric",
+            data: {
+                operation: "cache_miss",
+                path,
+                sizeBytes,
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                operation: "cache_miss",
+            },
+        };
+        const success = await this.send(event);
+        if (success) {
+            this.cacheStats.misses++;
+        }
+        return success;
+    }
+    /**
+     * Set cache headers.
+     */
+    async setCachePolicy(pathPattern, ttl, cacheKeyPolicy) {
+        const event = {
+            type: "event",
+            data: {
+                operation: "set_cache_policy",
+                pathPattern,
+                ttl,
+                cacheKeyPolicy,
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                operation: "set_cache_policy",
+            },
+        };
+        return this.send(event);
+    }
+    /**
+     * Get current cache statistics.
+     */
+    getCacheStats() {
+        const total = this.cacheStats.hits + this.cacheStats.misses;
+        const hitRate = total > 0 ? (this.cacheStats.hits / total) * 100 : 0;
+        return {
+            ...this.cacheStats,
+            hitRate: Math.round(hitRate * 100) / 100,
+        };
+    }
+    /**
+     * Record cache eviction.
+     */
+    async recordEviction() {
+        const event = {
+            type: "metric",
+            data: {
+                operation: "eviction",
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                operation: "eviction",
+            },
+        };
+        const success = await this.send(event);
+        if (success) {
+            this.cacheStats.evictions++;
+        }
+        return success;
+    }
+    /**
+     * Flush all queued events.
+     */
+    async flushQueue() {
+        const queued = this.getQueuedEvents();
+        if (queued.length === 0)
+            return;
+        const { sent, failed } = await this.batch(queued);
+        if (sent > 0) {
+            this.clearQueue();
+        }
+        console.log(`Flushed CDN queue: ${sent} sent, ${failed} failed`);
+    }
+    /**
+     * Get CDN configuration info.
+     */
+    getInfo() {
+        const provider = this.config.endpoint?.includes("cloudflare") ? "cloudflare" : "cloudfront";
+        return {
+            provider,
+            endpoint: this.config.endpoint || "",
+            apiKey: this.config.apiKey ? "***" : "",
+        };
+    }
+}
+/**
+ * Create a CDN adapter from environment variables.
+ */
+export function createCDNAdapter(enabled = true) {
+    const apiKey = process.env.CDN_API_KEY;
+    const endpoint = process.env.CDN_ENDPOINT || process.env.CLOUDFRONT_DISTRIBUTION_ID;
+    if (enabled && (!apiKey || !endpoint)) {
+        console.warn("CDN is enabled but CDN_API_KEY and CDN_ENDPOINT environment variables are required");
+    }
+    return new CDNAdapter({
+        enabled: enabled && !!apiKey && !!endpoint,
+        apiKey,
+        endpoint,
+    });
+}
+//# sourceMappingURL=cdn-adapter.js.map

package/dist/cdn-adapter.js.map

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

package/dist/certification-workflow-model.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Certification Workflow Engine — data models
+ * Multi-stage approval workflow for plugin certifications
+ */
+export type WorkflowStage = "validation" | "review" | "approval" | "release" | "completed";
+export type ApprovalStatus = "pending" | "approved" | "rejected" | "escalated" | "blocked";
+export type ReviewerRole = "validator" | "reviewer" | "approver" | "release_manager" | "admin";
+export interface CertificationWorkflow {
+    id: string;
+    plugin_id: string;
+    plugin_version: string;
+    plugin_name: string;
+    current_stage: WorkflowStage;
+    status: ApprovalStatus;
+    validation_report_id?: string;
+    created_by: string;
+    created_at: string;
+    started_at?: string;
+    completed_at?: string;
+    expires_at?: string;
+    stages_completed: WorkflowStage[];
+    approval_chain: ApprovalStep[];
+    audit_trail: WorkflowAuditEvent[];
+}
+export interface ApprovalStep {
+    id: string;
+    workflow_id: string;
+    stage: WorkflowStage;
+    step_number: number;
+    required_role: ReviewerRole;
+    assigned_to?: string;
+    assigned_to_name?: string;
+    status: ApprovalStatus;
+    approved_by?: string;
+    approved_by_name?: string;
+    approved_at?: string;
+    rejection_reason?: string;
+    comments?: string;
+    deadline?: string;
+    escalated: boolean;
+    escalated_to?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkflowAuditEvent {
+    id: string;
+    workflow_id: string;
+    stage: WorkflowStage;
+    event_type: string;
+    actor_id: string;
+    actor_name: string;
+    actor_role: ReviewerRole;
+    details: Record<string, unknown>;
+    timestamp: string;
+    created_at: string;
+}
+export interface ApprovalChainTemplate {
+    id: string;
+    name: string;
+    certification_tier: string;
+    stages: {
+        stage: WorkflowStage;
+        step_number: number;
+        required_role: ReviewerRole;
+        min_approval_count: number;
+        escalation_deadline_hours?: number;
+        can_auto_approve?: boolean;
+    }[];
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkflowMetrics {
+    total_workflows: number;
+    active_workflows: number;
+    completed_workflows: number;
+    failed_workflows: number;
+    average_completion_hours: number;
+    average_stage_duration_hours: Record<WorkflowStage, number>;
+    approval_rate_percent: number;
+    rejection_rate_percent: number;
+    escalation_rate_percent: number;
+    bottleneck_stage: WorkflowStage;
+}
+export interface ReviewerAssignment {
+    id: string;
+    workflow_id: string;
+    approval_step_id: string;
+    reviewer_id: string;
+    reviewer_name: string;
+    reviewer_role: ReviewerRole;
+    assigned_at: string;
+    response_deadline: string;
+    responded_at?: string;
+    response: "approved" | "rejected" | "escalated" | "no_response";
+}