flingit 0.0.1

package/dist/runtime/db.js

@@ -0,0 +1,137 @@
+/**
+ * Database primitive using SQLite
+ *
+ * The database API matches Cloudflare D1 for portability.
+ * Locally, this runs against SQLite via better-sqlite3.
+ * In production, it runs against Cloudflare D1.
+ */
+import Database from "better-sqlite3";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+// Database path - configurable via environment
+const DB_PATH = process.env["FLING_DB_PATH"] ?? join(process.cwd(), ".fling", "data", "local.db");
+let database = null;
+function getDatabase() {
+    if (!database) {
+        // Ensure directory exists
+        const dir = dirname(DB_PATH);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        database = new Database(DB_PATH);
+        database.pragma("journal_mode = WAL");
+    }
+    return database;
+}
+/**
+ * D1-compatible prepared statement wrapper
+ */
+class PreparedStatement {
+    sql;
+    params = [];
+    constructor(sql) {
+        this.sql = sql;
+    }
+    /**
+     * Bind parameters to the statement
+     */
+    bind(...params) {
+        this.params = params;
+        return this;
+    }
+    /**
+     * Execute and return the first row
+     */
+    first() {
+        const db = getDatabase();
+        const stmt = db.prepare(this.sql);
+        return (stmt.get(...this.params) ?? null);
+    }
+    /**
+     * Execute and return all rows
+     */
+    all() {
+        const db = getDatabase();
+        const stmt = db.prepare(this.sql);
+        const results = stmt.all(...this.params);
+        return { results };
+    }
+    /**
+     * Execute a statement (INSERT/UPDATE/DELETE)
+     */
+    run() {
+        const db = getDatabase();
+        const stmt = db.prepare(this.sql);
+        const result = stmt.run(...this.params);
+        return {
+            success: true,
+            meta: {
+                changes: result.changes,
+                last_row_id: Number(result.lastInsertRowid),
+            },
+        };
+    }
+}
+/**
+ * D1-compatible database interface
+ */
+export const db = {
+    /**
+     * Prepare a SQL statement with parameter binding
+     *
+     * @example
+     * ```typescript
+     * const episode = await db.prepare("SELECT * FROM episodes WHERE id = ?")
+     *   .bind(episodeId)
+     *   .first();
+     * ```
+     */
+    prepare(sql) {
+        return new PreparedStatement(sql);
+    },
+    /**
+     * Execute raw SQL (for DDL statements like CREATE TABLE)
+     *
+     * @example
+     * ```typescript
+     * await db.exec(`
+     *   CREATE TABLE IF NOT EXISTS episodes (
+     *     id INTEGER PRIMARY KEY AUTOINCREMENT,
+     *     title TEXT NOT NULL
+     *   )
+     * `);
+     * ```
+     */
+    exec(sql) {
+        const db = getDatabase();
+        db.exec(sql);
+    },
+    /**
+     * Execute multiple statements atomically
+     *
+     * @example
+     * ```typescript
+     * await db.batch([
+     *   db.prepare("INSERT INTO users (id, name) VALUES (?, ?)").bind(id, name),
+     *   db.prepare("INSERT INTO projects (id, user_id) VALUES (?, ?)").bind(projId, id),
+     * ]);
+     * ```
+     */
+    batch(statements) {
+        const database = getDatabase();
+        const transaction = database.transaction(() => {
+            return statements.map((stmt) => stmt.run());
+        });
+        return transaction();
+    },
+    /**
+     * Close the database connection (internal use)
+     */
+    close() {
+        if (database) {
+            database.close();
+            database = null;
+        }
+    },
+};
+//# sourceMappingURL=db.js.map

package/dist/runtime/db.js.map

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

package/dist/runtime/http.d.ts

@@ -0,0 +1,33 @@
+/**
+ * HTTP primitive using Hono
+ *
+ * Fling uses Hono for HTTP. This module exports a configured Hono app
+ * that works identically in local development and production deployment.
+ */
+import { Hono } from "hono";
+type Variables = {
+    requestId: string;
+};
+/**
+ * The main Hono app instance.
+ *
+ * @example
+ * ```typescript
+ * import { app } from "fling";
+ *
+ * app.get("/", (c) => {
+ *   return c.text("Hello from Fling!");
+ * });
+ *
+ * app.get("/feed.xml", async (c) => {
+ *   const episodes = await db.prepare("SELECT * FROM episodes").all();
+ *   const xml = buildRssFeed(episodes);
+ *   return c.text(xml, 200, { "Content-Type": "application/rss+xml" });
+ * });
+ * ```
+ */
+export declare const app: Hono<{
+    Variables: Variables;
+}, import("hono/types").BlankSchema, "/">;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/runtime/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAK5B,KAAK,SAAS,GAAG;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,GAAG;eAAyB,SAAS;yCAAK,CAAC"}

package/dist/runtime/http.js

@@ -0,0 +1,36 @@
+/**
+ * HTTP primitive using Hono
+ *
+ * Fling uses Hono for HTTP. This module exports a configured Hono app
+ * that works identically in local development and production deployment.
+ */
+import { Hono } from "hono";
+import { randomUUID } from "node:crypto";
+import { withLogContext } from "./log.js";
+/**
+ * The main Hono app instance.
+ *
+ * @example
+ * ```typescript
+ * import { app } from "fling";
+ *
+ * app.get("/", (c) => {
+ *   return c.text("Hello from Fling!");
+ * });
+ *
+ * app.get("/feed.xml", async (c) => {
+ *   const episodes = await db.prepare("SELECT * FROM episodes").all();
+ *   const xml = buildRssFeed(episodes);
+ *   return c.text(xml, 200, { "Content-Type": "application/rss+xml" });
+ * });
+ * ```
+ */
+export const app = new Hono();
+// Add request ID middleware for log context
+app.use("*", async (c, next) => {
+    const requestId = randomUUID();
+    c.set("requestId", requestId);
+    // Wrap handler execution with log context
+    return withLogContext({ requestId }, () => next());
+});
+//# sourceMappingURL=http.js.map

package/dist/runtime/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAO1C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,EAA4B,CAAC;AAExD,4CAA4C;AAC5C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;IAC7B,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE9B,0CAA0C;IAC1C,OAAO,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAkB,CAAC;AACtE,CAAC,CAAC,CAAC"}

package/dist/runtime/log.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Logging primitive with structured output and persistent storage
+ *
+ * Logs are structured (JSON) and include automatic context
+ * (timestamp, request ID for HTTP handlers, cron job name).
+ * Logs are stored in SQLite for querying via `fling logs`.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+interface LogContext {
+    requestId?: string;
+    cronJob?: string;
+    [key: string]: unknown;
+}
+/**
+ * Structured logging interface
+ */
+export declare const log: {
+    /**
+     * Log a debug message
+     */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an info message
+     *
+     * @example
+     * ```typescript
+     * log.info("Processing episode", { title, date });
+     * ```
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     *
+     * @example
+     * ```typescript
+     * log.warn("Rate limit approaching", { remaining: 10 });
+     * ```
+     */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     *
+     * @example
+     * ```typescript
+     * log.error("Failed to fetch feed", { url, error: e.message });
+     * ```
+     */
+    error(message: string, data?: Record<string, unknown>): void;
+};
+/**
+ * Run a function with logging context (internal use)
+ */
+export declare function withLogContext<T>(context: LogContext, fn: () => T | Promise<T>): T | Promise<T>;
+/**
+ * Query options for retrieving stored logs
+ */
+export interface LogQueryOptions {
+    level?: LogLevel;
+    since?: Date;
+    cronJob?: string;
+    requestId?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * A stored log entry
+ */
+export interface StoredLogEntry {
+    id: number;
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    requestId: string | null;
+    cronJob: string | null;
+    data: Record<string, unknown> | null;
+}
+/**
+ * Query stored logs with optional filters
+ */
+export declare function queryLogs(options?: LogQueryOptions): StoredLogEntry[];
+/**
+ * Close the log database connection (call on shutdown)
+ */
+export declare function closeLogDatabase(): void;
+/**
+ * Clear all stored logs (for testing)
+ */
+export declare function clearLogs(): void;
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/runtime/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/runtime/log.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAsHD;;GAEG;AACH,eAAO,MAAM,GAAG;IACd;;OAEG;mBACY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK5D;;;;;;;OAOG;kBACW,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK3D;;;;;;;OAOG;kBACW,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK3D;;;;;;;OAOG;mBACY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAI7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,EAAE,CAsDzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAGhC"}

package/dist/runtime/log.js

@@ -0,0 +1,211 @@
+/**
+ * Logging primitive with structured output and persistent storage
+ *
+ * Logs are structured (JSON) and include automatic context
+ * (timestamp, request ID for HTTP handlers, cron job name).
+ * Logs are stored in SQLite for querying via `fling logs`.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import Database from "better-sqlite3";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+// Configuration
+const LOG_DB_PATH = process.env["FLING_DB_PATH"] ?? join(process.cwd(), ".fling", "data", "local.db");
+const MAX_LOG_ENTRIES = parseInt(process.env["FLING_LOG_MAX_ENTRIES"] ?? "10000", 10);
+// AsyncLocalStorage for request/cron context
+const contextStorage = new AsyncLocalStorage();
+// Database connection for log storage
+let logDb = null;
+let writeCount = 0;
+function getLogDatabase() {
+    if (!logDb) {
+        const dir = dirname(LOG_DB_PATH);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        logDb = new Database(LOG_DB_PATH);
+        logDb.pragma("journal_mode = WAL");
+        // Create logs table
+        logDb.exec(`
+      CREATE TABLE IF NOT EXISTS _fling_logs (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        timestamp TEXT NOT NULL,
+        level TEXT NOT NULL,
+        message TEXT NOT NULL,
+        request_id TEXT,
+        cron_job TEXT,
+        data TEXT,
+        created_at INTEGER DEFAULT (unixepoch())
+      )
+    `);
+        // Create indexes for common queries
+        logDb.exec(`
+      CREATE INDEX IF NOT EXISTS idx_logs_timestamp ON _fling_logs(timestamp DESC);
+      CREATE INDEX IF NOT EXISTS idx_logs_level ON _fling_logs(level);
+      CREATE INDEX IF NOT EXISTS idx_logs_cron_job ON _fling_logs(cron_job);
+      CREATE INDEX IF NOT EXISTS idx_logs_created_at ON _fling_logs(created_at);
+    `);
+    }
+    return logDb;
+}
+function storeLog(level, message, data) {
+    try {
+        const context = contextStorage.getStore() ?? {};
+        const db = getLogDatabase();
+        const stmt = db.prepare(`
+      INSERT INTO _fling_logs (timestamp, level, message, request_id, cron_job, data)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(new Date().toISOString(), level, message, context.requestId ?? null, context.cronJob ?? null, data ? JSON.stringify(data) : null);
+        // Periodic cleanup
+        writeCount++;
+        if (writeCount >= 100) {
+            writeCount = 0;
+            cleanupOldLogs();
+        }
+    }
+    catch {
+        // Silently ignore storage errors to not break logging
+    }
+}
+function cleanupOldLogs() {
+    try {
+        const db = getLogDatabase();
+        db.exec(`
+      DELETE FROM _fling_logs
+      WHERE id NOT IN (
+        SELECT id FROM _fling_logs
+        ORDER BY created_at DESC
+        LIMIT ${MAX_LOG_ENTRIES}
+      )
+    `);
+    }
+    catch {
+        // Silently ignore cleanup errors
+    }
+}
+function formatLog(level, message, data) {
+    const context = contextStorage.getStore() ?? {};
+    const logEntry = {
+        timestamp: new Date().toISOString(),
+        level,
+        message,
+        ...context,
+        ...data,
+    };
+    return JSON.stringify(logEntry);
+}
+/**
+ * Structured logging interface
+ */
+export const log = {
+    /**
+     * Log a debug message
+     */
+    debug(message, data) {
+        console.debug(formatLog("debug", message, data));
+        storeLog("debug", message, data);
+    },
+    /**
+     * Log an info message
+     *
+     * @example
+     * ```typescript
+     * log.info("Processing episode", { title, date });
+     * ```
+     */
+    info(message, data) {
+        console.info(formatLog("info", message, data));
+        storeLog("info", message, data);
+    },
+    /**
+     * Log a warning message
+     *
+     * @example
+     * ```typescript
+     * log.warn("Rate limit approaching", { remaining: 10 });
+     * ```
+     */
+    warn(message, data) {
+        console.warn(formatLog("warn", message, data));
+        storeLog("warn", message, data);
+    },
+    /**
+     * Log an error message
+     *
+     * @example
+     * ```typescript
+     * log.error("Failed to fetch feed", { url, error: e.message });
+     * ```
+     */
+    error(message, data) {
+        console.error(formatLog("error", message, data));
+        storeLog("error", message, data);
+    },
+};
+/**
+ * Run a function with logging context (internal use)
+ */
+export function withLogContext(context, fn) {
+    return contextStorage.run(context, fn);
+}
+/**
+ * Query stored logs with optional filters
+ */
+export function queryLogs(options = {}) {
+    const db = getLogDatabase();
+    const conditions = [];
+    const params = [];
+    if (options.level) {
+        conditions.push("level = ?");
+        params.push(options.level);
+    }
+    if (options.since) {
+        conditions.push("timestamp >= ?");
+        params.push(options.since.toISOString());
+    }
+    if (options.cronJob) {
+        conditions.push("cron_job = ?");
+        params.push(options.cronJob);
+    }
+    if (options.requestId) {
+        conditions.push("request_id = ?");
+        params.push(options.requestId);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const limit = options.limit ?? 100;
+    const offset = options.offset ?? 0;
+    const query = `
+    SELECT * FROM _fling_logs
+    ${whereClause}
+    ORDER BY timestamp DESC
+    LIMIT ? OFFSET ?
+  `;
+    const rows = db.prepare(query).all(...params, limit, offset);
+    return rows.map((row) => ({
+        id: row.id,
+        timestamp: row.timestamp,
+        level: row.level,
+        message: row.message,
+        requestId: row.request_id,
+        cronJob: row.cron_job,
+        data: row.data ? JSON.parse(row.data) : null,
+    }));
+}
+/**
+ * Close the log database connection (call on shutdown)
+ */
+export function closeLogDatabase() {
+    if (logDb) {
+        logDb.close();
+        logDb = null;
+    }
+}
+/**
+ * Clear all stored logs (for testing)
+ */
+export function clearLogs() {
+    const db = getLogDatabase();
+    db.exec("DELETE FROM _fling_logs");
+}
+//# sourceMappingURL=log.js.map

package/dist/runtime/log.js.map

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

package/dist/runtime/migrate.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Database migrations for Fling
+ *
+ * Migrations run automatically on app startup. Each migration runs exactly once,
+ * tracked in the `_migrations` table. Migrations execute in alphabetical order
+ * by name.
+ *
+ * @example
+ * ```typescript
+ * import { migrate, db } from "fling";
+ *
+ * migrate("001_create_users", async () => {
+ *   await db.prepare(`
+ *     CREATE TABLE users (
+ *       id INTEGER PRIMARY KEY AUTOINCREMENT,
+ *       name TEXT NOT NULL
+ *     )
+ *   `).run();
+ * });
+ * ```
+ */
+interface Migration {
+    name: string;
+    handler: () => Promise<void>;
+}
+/**
+ * Register a database migration.
+ *
+ * @param name - Unique identifier for the migration (use numeric prefix for ordering, e.g., "001_create_users")
+ * @param handler - Async function that performs the migration
+ *
+ * @example
+ * ```typescript
+ * migrate("001_create_users", async () => {
+ *   await db.prepare(`CREATE TABLE users (...)`).run();
+ * });
+ * ```
+ */
+export declare function migrate(name: string, handler: () => Promise<void>): void;
+/**
+ * Run all pending migrations.
+ * Called automatically by the Fling runtime on startup.
+ */
+export declare function runMigrations(): Promise<void>;
+/**
+ * Get all registered migrations (for testing/debugging).
+ */
+export declare function getMigrations(): Map<string, Migration>;
+/**
+ * Clear all registered migrations (for testing).
+ */
+export declare function clearMigrations(): void;
+export {};
+//# sourceMappingURL=migrate.d.ts.map

package/dist/runtime/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/runtime/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC3B,IAAI,CAKN;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAmFnD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}