flingit 0.0.7 → 0.0.9

package/dist/cli/utils/claude-code.js

@@ -0,0 +1,43 @@
+/**
+ * Claude Code detection and launch utilities.
+ */
+import { execSync } from "node:child_process";
+/**
+ * Check if Claude Code is installed and available in PATH.
+ * @returns true if claude command is available
+ */
+export function isClaudeCodeInstalled() {
+    try {
+        // Use 'which' on Unix-like systems, 'where' on Windows
+        const cmd = process.platform === "win32" ? "where claude" : "which claude";
+        execSync(cmd, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the error message for when Claude Code is not installed.
+ * @returns Error message with installation instructions
+ */
+export function getClaudeCodeNotInstalledError() {
+    return `Error: Claude Code is not installed or not in your PATH.
+
+Fling uses Claude Code as its AI coding assistant. To install it, visit:
+  https://docs.anthropic.com/en/docs/claude-code/overview
+
+After installation, run 'fling' again to continue.`;
+}
+/**
+ * Check if Claude Code is installed and exit with error if not.
+ * @returns true if installed, process exits if not
+ */
+export function requireClaudeCode() {
+    if (!isClaudeCodeInstalled()) {
+        console.error(getClaudeCodeNotInstalledError());
+        process.exit(1);
+    }
+    return true;
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/cli/utils/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/cli/utils/claude-code.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,uDAAuD;QACvD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QAC3E,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO;;;;;mDAK0C,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/utils/node-version.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Node.js version check utilities.
+ */
+export declare const MIN_NODE_VERSION = 22;
+/**
+ * Parse the major version from a Node.js version string.
+ * @param version - Version string like "v20.10.0" or "22.0.0"
+ * @returns The major version number
+ */
+export declare function parseMajorVersion(version: string): number;
+/**
+ * Check if the current Node.js version meets the minimum requirement.
+ * @param version - Version string to check (defaults to process.version)
+ * @returns true if version is sufficient, false otherwise
+ */
+export declare function isNodeVersionSupported(version?: string): boolean;
+/**
+ * Get the error message for unsupported Node versions.
+ * @param version - Current Node.js version string
+ * @returns Error message with upgrade instructions
+ */
+export declare function getNodeVersionError(version: string): string;
+/**
+ * Check Node.js version and exit with error if unsupported.
+ * This is called at CLI entry points.
+ */
+export declare function checkNodeVersion(): void;
+//# sourceMappingURL=node-version.d.ts.map

package/dist/cli/utils/node-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/node-version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,MAAwB,GAAG,OAAO,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/cli/utils/node-version.js

@@ -0,0 +1,54 @@
+/**
+ * Node.js version check utilities.
+ */
+export const MIN_NODE_VERSION = 22;
+/**
+ * Parse the major version from a Node.js version string.
+ * @param version - Version string like "v20.10.0" or "22.0.0"
+ * @returns The major version number
+ */
+export function parseMajorVersion(version) {
+    // Remove leading 'v' if present
+    const cleaned = version.startsWith("v") ? version.slice(1) : version;
+    const major = cleaned.split(".")[0] ?? "0";
+    return parseInt(major, 10);
+}
+/**
+ * Check if the current Node.js version meets the minimum requirement.
+ * @param version - Version string to check (defaults to process.version)
+ * @returns true if version is sufficient, false otherwise
+ */
+export function isNodeVersionSupported(version = process.version) {
+    const major = parseMajorVersion(version);
+    return major >= MIN_NODE_VERSION;
+}
+/**
+ * Get the error message for unsupported Node versions.
+ * @param version - Current Node.js version string
+ * @returns Error message with upgrade instructions
+ */
+export function getNodeVersionError(version) {
+    return `Error: Fling requires Node.js ${MIN_NODE_VERSION} or later.
+
+You are running Node.js ${version}
+
+To upgrade, we recommend using nvm (Node Version Manager):
+  https://github.com/nvm-sh/nvm
+
+After installing nvm:
+  nvm install ${MIN_NODE_VERSION}
+  nvm use ${MIN_NODE_VERSION}
+
+Then try again.`;
+}
+/**
+ * Check Node.js version and exit with error if unsupported.
+ * This is called at CLI entry points.
+ */
+export function checkNodeVersion() {
+    if (!isNodeVersionSupported()) {
+        console.error(getNodeVersionError(process.version));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=node-version.js.map

package/dist/cli/utils/node-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.js","sourceRoot":"","sources":["../../../src/cli/utils/node-version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,gCAAgC;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC3C,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB,OAAO,CAAC,OAAO;IACtE,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,KAAK,IAAI,gBAAgB,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,iCAAiC,gBAAgB;;0BAEhC,OAAO;;;;;;gBAMjB,gBAAgB;YACpB,gBAAgB;;gBAEZ,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,sBAAsB,EAAE,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flingit",
-    "version": "0.0.7",
+    "version": "0.0.9",
     "description": "Personal Software Platform - Build and deploy personal tools through conversation",
     "type": "module",
     "engines": {

package/templates/default/CLAUDE.md

@@ -37,6 +37,14 @@ Run `npm start` (or `fling dev`) to start development:
 - **API**: http://localhost:3210 (Hono backend)
 - Vite proxies `/api/*` requests to the API server
 
+### Hot Module Replacement (HMR)
+
+The dev server provides hot reloading for both frontend AND backend - no restart needed:
+- **Frontend (React)**: Changes to `src/react-app/` are instantly reflected via Vite HMR
+- **Backend (Worker)**: Changes to `src/worker/` are automatically reloaded via tsx watch
+
+Just edit and save - changes appear immediately.
+
 ## Fling API (Backend)
 
 All primitives are imported from `"flingit"` in the backend:
@@ -206,6 +214,29 @@ Be aware of these constraints when building:
 - Must use Workers-compatible packages (check package docs for "Cloudflare Workers" or "edge runtime" support)
 - Web standard APIs work fine (fetch, crypto.subtle, TextEncoder, etc.)
 
+### Backend Assets (Images, Fonts, etc.)
+
+If the backend needs to return or process an asset (image, icon, font), keep it small and embed it directly in the code as base64:
+
+```typescript
+// Small assets should be base64 encoded directly in the code
+const FAVICON_BASE64 = "iVBORw0KGgo..."; // base64-encoded PNG
+
+app.get("/favicon.ico", (c) => {
+  const buffer = Uint8Array.from(atob(FAVICON_BASE64), c => c.charCodeAt(0));
+  return new Response(buffer, {
+    headers: { "Content-Type": "image/x-icon" }
+  });
+});
+```
+
+This is necessary because:
+- Workers have limited memory (~128MB)
+- There's no built-in asset serving for backend code
+- Base64 keeps assets bundled with the code
+
+**For large assets:** Serve them from the frontend (`public/` folder) instead.
+
 **If the user's request might hit these limitations, warn them early and suggest alternatives.**
 
 ## Key Points

package/templates/default/skills/fling/API.md

@@ -333,3 +333,81 @@ Secret names must be uppercase with underscores:
 - `apiKey` ✗
 - `github-token` ✗
 
+## WebAssembly (WASM)
+
+Fling supports importing WebAssembly modules in your backend code. This enables using libraries like `@resvg/resvg-wasm` for SVG rendering, image processing, and other compute-intensive tasks.
+
+### Basic Usage
+
+```typescript
+import { app } from "flingit";
+import wasmBinary from "@resvg/resvg-wasm/index_bg.wasm";
+import { initWasm, Resvg } from "@resvg/resvg-wasm";
+
+// Initialize WASM once
+let initialized = false;
+
+app.get("/api/svg-to-png", async (c) => {
+  if (!initialized) {
+    await initWasm(wasmBinary);
+    initialized = true;
+  }
+
+  const svg = c.req.query("svg") ?? '<svg width="100" height="100"><circle cx="50" cy="50" r="40" fill="red"/></svg>';
+  const resvg = new Resvg(svg);
+  const png = resvg.render().asPng();
+
+  return c.body(png, 200, { "Content-Type": "image/png" });
+});
+```
+
+### How It Works
+
+WASM files are handled differently in local development vs production, but the same code works for both:
+
+| Environment | What `import wasm from "*.wasm"` returns |
+|-------------|------------------------------------------|
+| Local (Node.js) | `Uint8Array` (raw bytes) |
+| Production (Cloudflare) | `WebAssembly.Module` (pre-compiled) |
+
+Most WASM libraries (like `@resvg/resvg-wasm`) accept both types in their init functions, so your code works unchanged in both environments.
+
+### TypeScript Support
+
+Add a type declaration file (e.g., `src/worker/wasm.d.ts`):
+
+```typescript
+declare module "*.wasm" {
+  const content: WebAssembly.Module | Uint8Array;
+  export default content;
+}
+```
+
+### Direct WASM Instantiation
+
+For custom WASM modules without a library wrapper:
+
+```typescript
+import wasmModule from "./my-module.wasm";
+
+let instance: WebAssembly.Instance | null = null;
+
+app.get("/api/compute", async (c) => {
+  if (!instance) {
+    const result = await WebAssembly.instantiate(wasmModule);
+    instance = result instanceof WebAssembly.Instance ? result : result.instance;
+  }
+
+  const compute = instance.exports.compute as (x: number) => number;
+  const result = compute(42);
+
+  return c.json({ result });
+});
+```
+
+### Important Notes
+
+- **Cloudflare blocks dynamic WASM compilation** - You cannot use `WebAssembly.instantiate(bytes)` with raw bytes fetched at runtime. WASM must be imported statically so Cloudflare can pre-compile it at deploy time.
+- **Initialize once** - WASM initialization is expensive. Cache the instance and reuse it across requests.
+- **Bundle size** - WASM modules count toward the 10MB bundle limit. Large WASM files may require optimization.
+

package/templates/default/skills/fling/SKILL.md

@@ -4,13 +4,14 @@ You are working on a Fling project - a personal software platform for building a
 
 ## Core Concepts
 
-Fling provides five primitives that work identically in local development and production:
+Fling provides six primitives that work identically in local development and production:
 
 1. **HTTP** - Expose endpoints via Hono
 2. **Database** - SQLite locally, D1 in production
 3. **Secrets** - Secure credential management
 4. **Migrations** - Version your database schema
 5. **Cron** - Scheduled tasks that run on a schedule
+6. **WASM** - WebAssembly modules for compute-intensive tasks
 
 ## Project Structure