sandstream-kit 1.0.0

package/dist/datadog-adapter.js

@@ -0,0 +1,245 @@
+import { IdGenerators } from "./id-generator.js";
+// ─── Datadog APM & Analytics Adapter ──────────────────────────────────────
+import { AbstractServiceAdapter, } from "./service-adapter.js";
+/**
+ * Datadog adapter for APM, metrics, and analytics.
+ */
+export class DatadogAdapter extends AbstractServiceAdapter {
+    lastHealthCheck = new Date().toISOString();
+    healthCheckErrors = 0;
+    metrics = new Map();
+    traces = new Map();
+    constructor(config = { enabled: false }) {
+        super("datadog", "1.0.0", config);
+    }
+    async connect() {
+        if (!this.config.enabled) {
+            this.connected = false;
+            return;
+        }
+        if (!this.config.apiKey) {
+            throw new Error("Datadog API Key is required");
+        }
+        // Validate API key format (should be alphanumeric)
+        if (!this.config.apiKey.match(/^[a-f0-9]{32}$/i)) {
+            throw new Error("Invalid Datadog API Key format");
+        }
+        // Simulate connection test
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        this.connected = true;
+        // Flush queued events
+        await this.flushQueue();
+    }
+    async disconnect() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+        this.metrics.clear();
+        this.traces.clear();
+        this.connected = false;
+    }
+    async getHealth() {
+        const responseTime = Math.random() * 50;
+        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 Datadog");
+        }
+        // Validate event
+        if (!event.type || !event.data) {
+            throw new Error("Invalid event format");
+        }
+        // Simulate sending to Datadog (fixed delay to avoid flaky tests)
+        await new Promise((resolve) => setTimeout(resolve, 5));
+        // Simulate occasional failures (disabled in test — use explicit error injection instead)
+        // if (Math.random() < 0.01) {
+        //   throw new Error("Simulated Datadog API error");
+        // }
+    }
+    /**
+     * Record a metric value.
+     */
+    async recordMetric(name, value, tags) {
+        this.metrics.set(name, value);
+        const event = {
+            type: "metric",
+            data: {
+                name,
+                value,
+                tags,
+                timestamp: Date.now(),
+            },
+            timestamp: new Date().toISOString(),
+        };
+        return this.send(event);
+    }
+    /**
+     * Increment a metric counter.
+     */
+    async incrementMetric(name, increment = 1) {
+        const current = this.metrics.get(name) || 0;
+        this.metrics.set(name, current + increment);
+        return this.recordMetric(name, current + increment);
+    }
+    /**
+     * Get current metric value.
+     */
+    getMetric(name) {
+        return this.metrics.get(name);
+    }
+    /**
+     * Start a trace span.
+     */
+    async startSpan(traceId, spanName, parentSpanId) {
+        const spanId = `${traceId}-${IdGenerators.span().slice(-12)}`;
+        this.traces.set(spanId, {
+            startTime: Date.now(),
+            status: "active",
+        });
+        const event = {
+            type: "trace",
+            data: {
+                traceId,
+                spanId,
+                spanName,
+                parentSpanId,
+                startTime: Date.now(),
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                spanType: "span",
+            },
+        };
+        await this.send(event);
+        return spanId;
+    }
+    /**
+     * End a trace span.
+     */
+    async endSpan(spanId, status = "ok") {
+        const span = this.traces.get(spanId);
+        if (span) {
+            span.endTime = Date.now();
+            span.status = status;
+        }
+        const event = {
+            type: "trace",
+            data: {
+                spanId,
+                status,
+                endTime: Date.now(),
+                duration: span ? span.endTime - span.startTime : 0,
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                spanType: "span-end",
+            },
+        };
+        await this.send(event);
+    }
+    /**
+     * Record a log event.
+     */
+    async logEvent(message, level = "info", metadata) {
+        const event = {
+            type: "log",
+            data: {
+                message,
+                level,
+                metadata,
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                level,
+            },
+        };
+        return this.send(event);
+    }
+    /**
+     * Record a custom event/incident.
+     */
+    async recordEvent(title, text, tags, severity) {
+        const event = {
+            type: "event",
+            data: {
+                title,
+                text,
+                severity,
+                timestamp: Date.now(),
+            },
+            timestamp: new Date().toISOString(),
+            tags: {
+                ...tags,
+                severity: severity || "medium",
+            },
+        };
+        return this.send(event);
+    }
+    /**
+     * 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 Datadog queue: ${sent} sent, ${failed} failed`);
+    }
+    /**
+     * Get Datadog site configuration.
+     */
+    getSiteInfo() {
+        return {
+            apiKey: this.config.apiKey || "",
+            site: this.config.endpoint || "datadoghq.com",
+            metricsCount: this.metrics.size,
+            tracesCount: this.traces.size,
+        };
+    }
+}
+/**
+ * Create a Datadog adapter from environment variables.
+ */
+export function createDatadogAdapter(enabled = true) {
+    const apiKey = process.env.DATADOG_API_KEY;
+    const site = process.env.DATADOG_SITE || "datadoghq.com";
+    if (enabled && !apiKey) {
+        console.warn("Datadog is enabled but DATADOG_API_KEY environment variable is not set");
+    }
+    return new DatadogAdapter({
+        enabled: enabled && !!apiKey,
+        apiKey,
+        endpoint: site,
+    });
+}
+//# sourceMappingURL=datadog-adapter.js.map

package/dist/datadog-adapter.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,15 @@
+import type { kitConfig } from "./config.js";
+export type DoctorCheckStatus = "pass" | "warn" | "fail" | "skip";
+export interface DoctorCheck {
+    name: string;
+    status: DoctorCheckStatus;
+    detail: string;
+    category: string;
+}
+export interface DoctorResult {
+    checks: DoctorCheck[];
+    passed: number;
+    warnings: number;
+    failed: number;
+}
+export declare function runDoctor(config: kitConfig, cwd: string): Promise<DoctorResult>;

package/dist/doctor.js

@@ -0,0 +1,131 @@
+import { readFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+async function checkNodeVersion(cwd) {
+    const name = "Node.js version";
+    const category = "runtime";
+    try {
+        const pkgJson = await readFile(join(cwd, "package.json"), "utf-8");
+        const pkg = JSON.parse(pkgJson);
+        const required = pkg?.engines?.node;
+        if (!required) {
+            return { name, status: "skip", detail: "No engines.node in package.json", category };
+        }
+        const current = process.version; // "v22.22.2"
+        const currentMajor = parseInt(current.replace("v", "").split(".")[0], 10);
+        const match = required.match(/(\d+)/);
+        const requiredMajor = match ? parseInt(match[1], 10) : null;
+        if (requiredMajor === null) {
+            return { name, status: "skip", detail: `Cannot parse engines.node: ${required}`, category };
+        }
+        if (currentMajor >= requiredMajor) {
+            return { name, status: "pass", detail: `${current} (requires ${required})`, category };
+        }
+        else {
+            return { name, status: "fail", detail: `${current} does not satisfy ${required}`, category };
+        }
+    }
+    catch {
+        return { name, status: "skip", detail: "No package.json found", category };
+    }
+}
+async function checkMise() {
+    const name = "mise";
+    const category = "tooling";
+    try {
+        const { stdout } = await execFileAsync("mise", ["--version"]);
+        const version = stdout.trim();
+        return { name, status: "pass", detail: `installed (${version})`, category };
+    }
+    catch {
+        return {
+            name,
+            status: "warn",
+            detail: "mise not found — tool installation will not work",
+            category,
+        };
+    }
+}
+async function checkEnvLocal(config, cwd) {
+    if (!config.secrets)
+        return null;
+    const name = ".env.local";
+    const category = "secrets";
+    const envPath = join(cwd, ".env.local");
+    try {
+        await access(envPath);
+        return { name, status: "pass", detail: ".env.local exists", category };
+    }
+    catch {
+        return {
+            name,
+            status: "warn",
+            detail: ".env.local not found (run: kit secrets)",
+            category,
+        };
+    }
+}
+async function checkToolsInPath(config) {
+    if (!config.tools)
+        return [];
+    const checks = [];
+    for (const toolName of Object.keys(config.tools)) {
+        const name = `${toolName} in PATH`;
+        const category = "tools";
+        try {
+            const { stdout } = await execFileAsync("which", [toolName]);
+            const path = stdout.trim();
+            checks.push({ name, status: "pass", detail: path, category });
+        }
+        catch {
+            checks.push({
+                name,
+                status: "warn",
+                detail: "not in PATH (run: kit install, then re-open terminal)",
+                category,
+            });
+        }
+    }
+    return checks;
+}
+async function checkGitHooks(config) {
+    if (!config.hooks)
+        return [];
+    const { checkHooks, isGitRepository } = await import("./check-hooks.js");
+    if (!isGitRepository()) {
+        return [
+            {
+                name: "git hooks",
+                status: "skip",
+                detail: "not a git repository",
+                category: "hooks",
+            },
+        ];
+    }
+    const hookResults = await checkHooks(config.hooks);
+    return hookResults.map((h) => ({
+        name: h.hookName,
+        category: "hooks",
+        status: (!h.installed ? "fail" : !h.upToDate ? "warn" : "pass"),
+        detail: h.detail,
+    }));
+}
+export async function runDoctor(config, cwd) {
+    const allChecks = [];
+    allChecks.push(await checkNodeVersion(cwd));
+    allChecks.push(await checkMise());
+    const envLocalCheck = await checkEnvLocal(config, cwd);
+    if (envLocalCheck)
+        allChecks.push(envLocalCheck);
+    const toolsInPathChecks = await checkToolsInPath(config);
+    allChecks.push(...toolsInPathChecks);
+    const hookChecks = await checkGitHooks(config);
+    allChecks.push(...hookChecks);
+    const passed = allChecks.filter((c) => c.status === "pass").length;
+    const warnings = allChecks.filter((c) => c.status === "warn").length;
+    const failed = allChecks.filter((c) => c.status === "fail").length;
+    return { checks: allChecks, passed, warnings, failed };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/documentation-generator.d.ts

@@ -0,0 +1,226 @@
+export type DocType = "guide" | "api" | "example" | "tutorial" | "troubleshooting" | "architecture";
+export type DocFormat = "markdown" | "html" | "pdf";
+export interface DocPage {
+    id: string;
+    title: string;
+    slug: string;
+    type: DocType;
+    content: string;
+    format: DocFormat;
+    author: string;
+    createdAt: string;
+    updatedAt: string;
+    views: number;
+    tags: string[];
+    relatedPages: string[];
+    toc?: TableOfContents[];
+}
+export interface TableOfContents {
+    level: number;
+    title: string;
+    id: string;
+}
+export interface APIDoc {
+    endpoint: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE" | "PUT";
+    description: string;
+    parameters: Array<{
+        name: string;
+        type: string;
+        required: boolean;
+        description: string;
+    }>;
+    response: {
+        type: string;
+        example: Record<string, unknown>;
+    };
+    errors: Array<{
+        code: number;
+        message: string;
+    }>;
+}
+export interface Example {
+    id: string;
+    title: string;
+    description: string;
+    language: "typescript" | "javascript" | "python" | "bash";
+    code: string;
+    explanation: string;
+    tags: string[];
+    difficulty: "beginner" | "intermediate" | "advanced";
+    runnable: boolean;
+}
+export interface Tutorial {
+    id: string;
+    title: string;
+    description: string;
+    steps: Array<{
+        title: string;
+        content: string;
+        code?: string;
+        expectedOutcome: string;
+    }>;
+    estimatedTime: number;
+    difficulty: "beginner" | "intermediate" | "advanced";
+    prerequisites: string[];
+    relatedDocs: string[];
+}
+export interface DocSearchResult {
+    page: DocPage;
+    relevance: number;
+    snippet: string;
+}
+export interface DocCollection {
+    category: string;
+    pages: DocPage[];
+    description: string;
+    order: number;
+}
+export declare class DocumentationGenerator {
+    private pages;
+    private apiDocs;
+    private examples;
+    private tutorials;
+    private collections;
+    private searchIndex;
+    /**
+     * Create a documentation page.
+     */
+    createPage(title: string, content: string, type: DocType, author: string, tags?: string[]): DocPage;
+    /**
+     * Get a page by ID.
+     */
+    getPage(pageId: string): DocPage | null;
+    /**
+     * Update a page.
+     */
+    updatePage(pageId: string, updates: Partial<DocPage>): DocPage | null;
+    /**
+     * Delete a page.
+     */
+    deletePage(pageId: string): boolean;
+    /**
+     * Generate table of contents from markdown headings.
+     */
+    private generateTableOfContents;
+    /**
+     * Index page content for full-text search.
+     */
+    private indexPage;
+    /**
+     * Extract searchable terms from content.
+     */
+    private extractTerms;
+    private isStopWord;
+    /**
+     * Search documentation by keyword.
+     */
+    search(query: string, limit?: number): DocSearchResult[];
+    /**
+     * Extract snippet around query term.
+     */
+    private extractSnippet;
+    /**
+     * Register API endpoint documentation.
+     */
+    registerAPIDoc(doc: APIDoc): void;
+    /**
+     * Get API documentation for an endpoint.
+     */
+    getAPIDoc(endpoint: string): APIDoc | null;
+    /**
+     * Get all API documentation.
+     */
+    getAllAPIDocsIndex(): APIDoc[];
+    /**
+     * Generate OpenAPI spec from registered endpoints.
+     */
+    generateOpenAPISpec(version?: string, baseUrl?: string): Record<string, unknown>;
+    /**
+     * Register a code example.
+     */
+    registerExample(example: Example): void;
+    /**
+     * Get example by ID.
+     */
+    getExample(exampleId: string): Example | null;
+    /**
+     * Get examples by tag.
+     */
+    getExamplesByTag(tag: string): Example[];
+    /**
+     * Get examples by difficulty.
+     */
+    getExamplesByDifficulty(difficulty: string): Example[];
+    /**
+     * Register a tutorial.
+     */
+    registerTutorial(tutorial: Tutorial): void;
+    /**
+     * Get tutorial by ID.
+     */
+    getTutorial(tutorialId: string): Tutorial | null;
+    /**
+     * Get tutorials by difficulty.
+     */
+    getTutorialsByDifficulty(difficulty: string): Tutorial[];
+    /**
+     * Get tutorials for beginners.
+     */
+    getBeginnerTutorials(): Tutorial[];
+    /**
+     * Create a documentation collection (category).
+     */
+    createCollection(category: string, description: string, pages: DocPage[], order?: number): DocCollection;
+    /**
+     * Get collection by category.
+     */
+    getCollection(category: string): DocCollection | null;
+    /**
+     * Get all collections sorted by order.
+     */
+    getAllCollections(): DocCollection[];
+    /**
+     * Generate documentation HTML site structure.
+     */
+    generateSiteStructure(): {
+        collections: Array<{
+            name: string;
+            pages: Array<{
+                title: string;
+                slug: string;
+                type: DocType;
+            }>;
+        }>;
+    };
+    /**
+     * Generate a static site dump (markdown files).
+     */
+    generateMarkdownDump(): Record<string, string>;
+    /**
+     * Generate navigation sidebar structure.
+     */
+    generateNavigation(): Array<{
+        label: string;
+        items: Array<{
+            label: string;
+            href: string;
+            type: DocType;
+        }>;
+    }>;
+    /**
+     * Get documentation statistics.
+     */
+    getStats(): {
+        totalPages: number;
+        byType: Record<DocType, number>;
+        totalViews: number;
+        totalExamples: number;
+        totalTutorials: number;
+        avgPageLength: number;
+    };
+    getPagesCache(): Map<string, DocPage>;
+    getExamplesCache(): Map<string, Example>;
+    getTutorialsCache(): Map<string, Tutorial>;
+    getAPIDocsCache(): Map<string, APIDoc>;
+}