chadstart 1.0.0

package/demo/docker-compose.yml

@@ -0,0 +1,31 @@
+# demo/docker-compose.yml
+# ─────────────────────────────────────────────────────────────────────────────
+# Run the ChadStart Todo demo with Docker Compose.
+#
+# Usage (from this directory):
+#   cp ../.env.example .env          # create your .env — at minimum set TOKEN_SECRET_KEY
+#   docker compose up --build
+#
+# The build context is the repo root so the image is always built from
+# the current source, keeping the schema and code in sync.
+# ─────────────────────────────────────────────────────────────────────────────
+
+services:
+  app:
+    build:
+      context: ..          # repo root — Dockerfile lives there
+    ports:
+      - "3000:3000"
+    env_file:
+      - path: .env
+        required: false    # optional — defaults are safe for local dev
+    environment:
+      NODE_ENV: production
+      JWT_SECRET: changeme_asdklanion2iorn1i2n9qjw0m90m129qmd920
+    volumes:
+      - ./chadstart.yaml:/app/chadstart.yaml:ro
+      - ./data:/app/data
+      - ./public:/app/public
+      - ./uploads:/app/uploads
+      - ./functions:/app/functions:ro
+    restart: unless-stopped

package/demo/functions/greet.go

@@ -0,0 +1,39 @@
+// greet.go — ChadStart Go function
+// Returns a greeting from the Go runtime.
+//
+// Runtime: go
+// Trigger: GET /api/fn/greet/go (public)
+//
+// ChadStart passes event JSON via stdin; result must be printed as JSON to stdout.
+
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+)
+
+type Event struct {
+	Query map[string]string `json:"query"`
+}
+
+func main() {
+	var evt Event
+	dec := json.NewDecoder(os.Stdin)
+	// ignore decode errors — event may be wrapped in {"event":...}
+	_ = dec.Decode(&evt)
+
+	name := "World"
+	if evt.Query != nil {
+		if n, ok := evt.Query["name"]; ok && n != "" {
+			name = n
+		}
+	}
+
+	result := map[string]string{
+		"message": fmt.Sprintf("Hello, %s!", name),
+		"runtime": "go",
+	}
+	json.NewEncoder(os.Stdout).Encode(result)
+}

package/demo/functions/hello.cpp

@@ -0,0 +1,18 @@
+/**
+ * hello.cpp — ChadStart C++ function
+ * Reads the event JSON from stdin and returns a greeting.
+ *
+ * Runtime: c++
+ * Trigger: GET /api/fn/greet/cpp (public)
+ */
+#include <iostream>
+#include <string>
+
+int main() {
+    // Consume stdin (ChadStart passes the serialized event as JSON)
+    std::string line;
+    while (std::getline(std::cin, line)) {}
+
+    std::cout << "{\"message\":\"Hello, World!\",\"runtime\":\"c++\"}" << std::endl;
+    return 0;
+}

package/demo/functions/hello.py

@@ -0,0 +1,13 @@
+# hello.py — ChadStart Python function
+# Returns a greeting from the Python runtime.
+#
+# Runtime: python
+# Trigger: GET /api/fn/greet/python (public)
+
+
+def handler(event, ctx):
+    name = (event.get("query") or {}).get("name", "World")
+    return {
+        "message": f"Hello, {name}!",
+        "runtime": "python",
+    }

package/demo/functions/hello.rb

@@ -0,0 +1,10 @@
+# hello.rb — ChadStart Ruby function
+# Returns a greeting from the Ruby runtime.
+#
+# Runtime: ruby
+# Trigger: GET /api/fn/greet/ruby (public)
+
+def handler(event, ctx)
+  name = ((event['query'] || {})['name'] || 'World')
+  { 'message' => "Hello, #{name}!", 'runtime' => 'ruby' }
+end

package/demo/functions/onTodoCreated.js

@@ -0,0 +1,13 @@
+'use strict';
+/**
+ * onTodoCreated.js — ChadStart JS event-triggered function
+ * Fires when a new Todo is created (event: todo.created).
+ *
+ * Runtime: js
+ * Trigger: event — todo.created
+ */
+module.exports = async function handler(event, ctx) {
+  const todo = event.data || event;
+  console.log(`[todo.created] New todo: "${todo.title}" (id: ${todo.id})`);
+  return { received: true, todoId: todo.id };
+};

package/demo/functions/ping.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# ping.sh — ChadStart Bash function
+# Returns a simple pong response.
+#
+# Runtime: bash
+# Trigger: GET /api/fn/ping (public)
+#          cron: @hourly
+
+set -euo pipefail
+
+# ChadStart passes event JSON via stdin (or first arg).
+# For a ping we ignore the input and return JSON on stdout.
+echo '{"pong":true,"runtime":"bash","ts":"'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'"}'

package/demo/functions/stats.js

@@ -0,0 +1,22 @@
+'use strict';
+/**
+ * stats.js — ChadStart JS function
+ * Returns todo statistics: total, completed, and pending counts.
+ *
+ * Runtime: js (default)
+ * Trigger: GET /api/fn/stats (public)
+ */
+module.exports = async function handler(event, ctx) {
+  const { chadstart } = ctx;
+  if (!chadstart) {
+    return { total: 0, completed: 0, pending: 0 };
+  }
+  // Use perPage:1 so we only fetch counts from the DB — no row data transferred.
+  const [all, done] = await Promise.all([
+    chadstart.todos.findAll({ perPage: 1 }),
+    chadstart.todos.findAll({ completed: true, perPage: 1 }),
+  ]);
+  const total     = all.total  ?? 0;
+  const completed = done.total ?? 0;
+  return { total, completed, pending: total - completed };
+};