@meetploy/cli 1.15.0 → 1.17.0

package/dist/index.js

@@ -8,11 +8,11 @@ import { parse } from 'yaml';
 import { build } from 'esbuild';
 import { watch } from 'chokidar';
 import { randomBytes, randomUUID, createHmac, pbkdf2Sync, timingSafeEqual, createHash } from 'crypto';
+import { homedir, tmpdir } from 'os';
 import { getCookie, deleteCookie, setCookie } from 'hono/cookie';
 import { URL, fileURLToPath } from 'url';
 import { serve } from '@hono/node-server';
 import { Hono } from 'hono';
-import { homedir, tmpdir } from 'os';
 import Database from 'better-sqlite3';
 import { spawn, exec } from 'child_process';
 import createClient from 'openapi-fetch';
@@ -147,6 +147,22 @@ function validateBindings(bindings, bindingType, configFile) {
     }
   }
 }
+function validateCronBindings(bindings, configFile) {
+  if (bindings === void 0) {
+    return;
+  }
+  for (const [bindingName, cronExpression] of Object.entries(bindings)) {
+    if (!BINDING_NAME_REGEX.test(bindingName)) {
+      throw new Error(`Invalid cron binding name '${bindingName}' in ${configFile}. Binding names must be uppercase with underscores (e.g., HOURLY_CLEANUP, DAILY_REPORT)`);
+    }
+    if (typeof cronExpression !== "string") {
+      throw new Error(`Cron binding '${bindingName}' in ${configFile} must have a string value (cron expression)`);
+    }
+    if (!CRON_EXPRESSION_REGEX.test(cronExpression.trim())) {
+      throw new Error(`Invalid cron expression '${cronExpression}' for binding '${bindingName}' in ${configFile}. Must be a valid cron expression with 5 fields (e.g., "0 * * * *", "*/5 * * * *")`);
+    }
+  }
+}
 function validateRelativePath(path, fieldName, configFile) {
   if (path === void 0) {
     return void 0;
@@ -200,7 +216,9 @@ function validatePloyConfig(config, configFile = "ploy.yaml", options = {}) {
   validateBindings(config.queue, "queue", configFile);
   validateBindings(config.cache, "cache", configFile);
   validateBindings(config.state, "state", configFile);
+  validateBindings(config.fs, "fs", configFile);
   validateBindings(config.workflow, "workflow", configFile);
+  validateCronBindings(config.cron, configFile);
   if (config.ai !== void 0 && typeof config.ai !== "boolean") {
     throw new Error(`'ai' in ${configFile} must be a boolean`);
   }
@@ -276,7 +294,7 @@ function readAndValidatePloyConfigSync(projectDir, configPath, validationOptions
   return validatePloyConfig(config, configFile, validationOptions);
 }
 function hasBindings(config) {
-  return !!(config.env ?? config.db ?? config.queue ?? config.cache ?? config.state ?? config.workflow ?? config.ai ?? config.auth);
+  return !!(config.env ?? config.db ?? config.queue ?? config.cache ?? config.state ?? config.fs ?? config.workflow ?? config.cron ?? config.ai ?? config.auth);
 }
 function parseDotEnv(content) {
   const result = {};
@@ -338,7 +356,7 @@ function getWorkerEntryPoint(projectDir, config) {
   }
   throw new Error("Could not find worker entry point. Specify 'main' in ploy.yaml");
 }
-var readFileAsync, DEFAULT_COMPATIBILITY_FLAGS, DEFAULT_COMPATIBILITY_DATE, BINDING_NAME_REGEX, RESOURCE_NAME_REGEX;
+var readFileAsync, DEFAULT_COMPATIBILITY_FLAGS, DEFAULT_COMPATIBILITY_DATE, BINDING_NAME_REGEX, RESOURCE_NAME_REGEX, CRON_EXPRESSION_REGEX;
 var init_ploy_config = __esm({
   "../tools/dist/ploy-config.js"() {
     readFileAsync = promisify(readFile$1);
@@ -346,6 +364,7 @@ var init_ploy_config = __esm({
     DEFAULT_COMPATIBILITY_DATE = "2025-04-02";
     BINDING_NAME_REGEX = /^[A-Z][A-Z0-9_]*$/;
     RESOURCE_NAME_REGEX = /^[a-z][a-z0-9_]*$/;
+    CRON_EXPRESSION_REGEX = /^(\*|[0-9,\-/]+)\s+(\*|[0-9,\-/]+)\s+(\*|[0-9,\-/]+)\s+(\*|[0-9,\-/]+)\s+(\*|[0-9,\-/]+)$/;
   }
 });
 
@@ -757,6 +776,124 @@ var init_db_runtime = __esm({
   }
 });
 
+// ../emulator/dist/runtime/fs-runtime.js
+var FS_RUNTIME_CODE;
+var init_fs_runtime = __esm({
+  "../emulator/dist/runtime/fs-runtime.js"() {
+    FS_RUNTIME_CODE = `
+interface FileStoragePutOptions {
+  contentType?: string;
+}
+
+interface FileStorageListOptions {
+  prefix?: string;
+  limit?: number;
+}
+
+interface FileStorageObject {
+  body: string;
+  contentType: string;
+  size: number;
+}
+
+interface FileStorageKey {
+  key: string;
+  size: number;
+  contentType: string;
+}
+
+interface FileStorageListResult {
+  keys: FileStorageKey[];
+}
+
+interface FileStorageBinding {
+  put: (key: string, value: string, options?: FileStoragePutOptions) => Promise<void>;
+  get: (key: string) => Promise<FileStorageObject | null>;
+  delete: (key: string) => Promise<void>;
+  list: (options?: FileStorageListOptions) => Promise<FileStorageListResult>;
+}
+
+export function initializeFileStorage(fsName: string, serviceUrl: string): FileStorageBinding {
+  return {
+    async put(key: string, value: string, options?: FileStoragePutOptions): Promise<void> {
+      const response = await fetch(serviceUrl + "/fs/put", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          fsName,
+          key,
+          value,
+          contentType: options?.contentType || "application/octet-stream",
+        }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error("File storage put failed: " + errorText);
+      }
+    },
+
+    async get(key: string): Promise<FileStorageObject | null> {
+      const response = await fetch(serviceUrl + "/fs/get", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ fsName, key }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error("File storage get failed: " + errorText);
+      }
+
+      const result = await response.json();
+      if (result.found === false) {
+        return null;
+      }
+      return {
+        body: result.body,
+        contentType: result.contentType,
+        size: result.size,
+      };
+    },
+
+    async delete(key: string): Promise<void> {
+      const response = await fetch(serviceUrl + "/fs/delete", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ fsName, key }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error("File storage delete failed: " + errorText);
+      }
+    },
+
+    async list(options?: FileStorageListOptions): Promise<FileStorageListResult> {
+      const response = await fetch(serviceUrl + "/fs/list", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          fsName,
+          prefix: options?.prefix,
+          limit: options?.limit,
+        }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error("File storage list failed: " + errorText);
+      }
+
+      const result = await response.json();
+      return { keys: result.keys };
+    },
+  };
+}
+`;
+  }
+});
+
 // ../emulator/dist/runtime/queue-runtime.js
 var QUEUE_RUNTIME_CODE;
 var init_queue_runtime = __esm({
@@ -1121,6 +1258,12 @@ function generateWrapperCode(config, mockServiceUrl, envVars) {
       bindings.push(`  ${bindingName}: initializeState("${stateName}", "${mockServiceUrl}"),`);
     }
   }
+  if (config.fs) {
+    imports.push('import { initializeFileStorage } from "__ploy_fs_runtime__";');
+    for (const [bindingName, fsName] of Object.entries(config.fs)) {
+      bindings.push(`  ${bindingName}: initializeFileStorage("${fsName}", "${mockServiceUrl}"),`);
+    }
+  }
   if (config.workflow) {
     imports.push('import { initializeWorkflow, createStepContext, executeWorkflow } from "__ploy_workflow_runtime__";');
     for (const [bindingName, workflowName] of Object.entries(config.workflow)) {
@@ -1155,6 +1298,37 @@ function generateWrapperCode(config, mockServiceUrl, envVars) {
       }
     }
   }` : "";
+  const cronHandlerCode = config.cron ? `
+  // Handle cron trigger delivery
+  if (request.headers.get("X-Ploy-Cron-Trigger") === "true") {
+    const cronExpression = request.headers.get("X-Ploy-Cron-Expression");
+    const scheduledTime = parseInt(request.headers.get("X-Ploy-Cron-Scheduled-Time") || String(Date.now()), 10);
+
+    if (cronExpression && userWorker.scheduled) {
+      let noRetryFlag = false;
+      const event = {
+        cron: cronExpression,
+        scheduledTime,
+        noRetry() { noRetryFlag = true; }
+      };
+      try {
+        await userWorker.scheduled(event, injectedEnv, ctx);
+        return new Response(JSON.stringify({ success: true, noRetry: noRetryFlag }), {
+          headers: { "Content-Type": "application/json" }
+        });
+      } catch (error) {
+        return new Response(JSON.stringify({ success: false, error: String(error) }), {
+          status: 500,
+          headers: { "Content-Type": "application/json" }
+        });
+      }
+    }
+
+    return new Response(JSON.stringify({ success: false, error: "No scheduled handler defined" }), {
+      status: 404,
+      headers: { "Content-Type": "application/json" }
+    });
+  }` : "";
   const queueHandlerCode = config.queue ? `
   // Handle queue message delivery
   if (request.headers.get("X-Ploy-Queue-Delivery") === "true") {
@@ -1198,6 +1372,7 @@ ${bindings.join("\n")}
 export default {
   async fetch(request, env, ctx) {
     const injectedEnv = { ...env, ...ployBindings };${envVarsCode}
+    ${cronHandlerCode}
     ${workflowHandlerCode}
     ${queueHandlerCode}
 
@@ -1237,6 +1412,10 @@ function createRuntimePlugin(_config) {
         path: "__ploy_state_runtime__",
         namespace: "ploy-runtime"
       }));
+      build2.onResolve({ filter: /^__ploy_fs_runtime__$/ }, () => ({
+        path: "__ploy_fs_runtime__",
+        namespace: "ploy-runtime"
+      }));
       build2.onResolve({ filter: /^__ploy_workflow_runtime__$/ }, () => ({
         path: "__ploy_workflow_runtime__",
         namespace: "ploy-runtime"
@@ -1257,6 +1436,10 @@ function createRuntimePlugin(_config) {
         contents: STATE_RUNTIME_CODE,
         loader: "ts"
       }));
+      build2.onLoad({ filter: /^__ploy_fs_runtime__$/, namespace: "ploy-runtime" }, () => ({
+        contents: FS_RUNTIME_CODE,
+        loader: "ts"
+      }));
       build2.onLoad({ filter: /^__ploy_workflow_runtime__$/, namespace: "ploy-runtime" }, () => ({
         contents: WORKFLOW_RUNTIME_CODE,
         loader: "ts"
@@ -1299,6 +1482,7 @@ var init_bundler = __esm({
   "../emulator/dist/bundler/bundler.js"() {
     init_cache_runtime();
     init_db_runtime();
+    init_fs_runtime();
     init_queue_runtime();
     init_state_runtime();
     init_workflow_runtime();
@@ -1559,6 +1743,205 @@ var init_workerd_config = __esm({
   "../emulator/dist/config/workerd-config.js"() {
   }
 });
+function parseCronField(field, min, max) {
+  const values = /* @__PURE__ */ new Set();
+  for (const part of field.split(",")) {
+    const trimmed = part.trim();
+    if (trimmed === "*") {
+      for (let i = min; i <= max; i++) {
+        values.add(i);
+      }
+      continue;
+    }
+    const stepMatch = trimmed.match(/^(.+)\/(\d+)$/);
+    if (stepMatch) {
+      const step = parseInt(stepMatch[2], 10);
+      const base = stepMatch[1];
+      let start = min;
+      let end = max;
+      if (base !== "*") {
+        const rangeMatch2 = base.match(/^(\d+)-(\d+)$/);
+        if (rangeMatch2) {
+          start = parseInt(rangeMatch2[1], 10);
+          end = parseInt(rangeMatch2[2], 10);
+        } else {
+          start = parseInt(base, 10);
+        }
+      }
+      if (start < min || start > max || end < min || end > max) {
+        throw new Error(`Cron field range ${start}-${end} is out of bounds (${min}-${max})`);
+      }
+      for (let i = start; i <= end; i += step) {
+        values.add(i);
+      }
+      continue;
+    }
+    const rangeMatch = trimmed.match(/^(\d+)-(\d+)$/);
+    if (rangeMatch) {
+      const start = parseInt(rangeMatch[1], 10);
+      const end = parseInt(rangeMatch[2], 10);
+      if (start < min || start > max || end < min || end > max) {
+        throw new Error(`Cron field range ${start}-${end} is out of bounds (${min}-${max})`);
+      }
+      for (let i = start; i <= end; i++) {
+        values.add(i);
+      }
+      continue;
+    }
+    const num = parseInt(trimmed, 10);
+    if (isNaN(num)) {
+      throw new Error(`Invalid cron field value: '${trimmed}' (expected number, range, step, or wildcard)`);
+    }
+    if (num < min || num > max) {
+      throw new Error(`Cron field value ${num} is out of range (${min}-${max})`);
+    }
+    values.add(num);
+  }
+  return { values };
+}
+function parseCronExpression(expression) {
+  const parts = expression.trim().split(/\s+/);
+  if (parts.length !== 5) {
+    throw new Error(`Invalid cron expression: ${expression} (expected 5 fields)`);
+  }
+  return [
+    parseCronField(parts[0], 0, 59),
+    parseCronField(parts[1], 0, 23),
+    parseCronField(parts[2], 1, 31),
+    parseCronField(parts[3], 1, 12),
+    parseCronField(parts[4], 0, 6)
+  ];
+}
+function cronMatchesDate(fields, date) {
+  const minute = date.getMinutes();
+  const hour = date.getHours();
+  const dayOfMonth = date.getDate();
+  const month = date.getMonth() + 1;
+  const dayOfWeek = date.getDay();
+  return fields[0].values.has(minute) && fields[1].values.has(hour) && fields[2].values.has(dayOfMonth) && fields[3].values.has(month) && fields[4].values.has(dayOfWeek);
+}
+function createCronScheduler(db, cronBindings, workerUrl) {
+  let interval = null;
+  const parsedCrons = /* @__PURE__ */ new Map();
+  let lastCheckedMinute = -1;
+  for (const [name, expression] of Object.entries(cronBindings)) {
+    try {
+      const fields = parseCronExpression(expression);
+      parsedCrons.set(name, { expression, fields });
+    } catch (err) {
+      error(`Failed to parse cron expression for '${name}': ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  async function checkCrons() {
+    const now = /* @__PURE__ */ new Date();
+    const currentMinute = Math.floor(now.getTime() / 6e4);
+    if (currentMinute === lastCheckedMinute) {
+      return;
+    }
+    lastCheckedMinute = currentMinute;
+    for (const [name, cron] of parsedCrons) {
+      if (cronMatchesDate(cron.fields, now)) {
+        await triggerScheduledHandler(db, name, cron.expression, now, workerUrl);
+      }
+    }
+  }
+  return {
+    start() {
+      if (interval) {
+        return;
+      }
+      log(`Cron scheduler started with ${parsedCrons.size} trigger(s)`);
+      for (const [name, cron] of parsedCrons) {
+        log(`  ${name}: ${cron.expression}`);
+      }
+      interval = setInterval(() => {
+        checkCrons().catch((err) => {
+          error(`Cron check error: ${err instanceof Error ? err.message : String(err)}`);
+        });
+      }, 15e3);
+      checkCrons().catch(() => {
+      });
+    },
+    stop() {
+      if (interval) {
+        clearInterval(interval);
+        interval = null;
+      }
+    }
+  };
+}
+async function triggerScheduledHandler(db, cronName, cronExpression, triggerTime, workerUrl) {
+  const executionId = randomUUID();
+  const now = Math.floor(Date.now() / 1e3);
+  db.prepare(`INSERT INTO cron_executions (id, cron_name, cron_expression, status, triggered_at)
+		 VALUES (?, ?, ?, 'running', ?)`).run(executionId, cronName, cronExpression, now);
+  log(`[cron] Triggering '${cronName}' (${cronExpression}) execution=${executionId}`);
+  try {
+    const response = await fetch(workerUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Ploy-Cron-Trigger": "true",
+        "X-Ploy-Cron-Name": cronName,
+        "X-Ploy-Cron-Expression": cronExpression,
+        "X-Ploy-Cron-Execution-Id": executionId,
+        "X-Ploy-Cron-Scheduled-Time": String(triggerTime.getTime())
+      },
+      body: JSON.stringify({
+        cron: cronExpression,
+        scheduledTime: triggerTime.getTime()
+      })
+    });
+    const completedAt = Math.floor(Date.now() / 1e3);
+    const durationMs = Date.now() - triggerTime.getTime();
+    if (response.ok) {
+      db.prepare(`UPDATE cron_executions SET status = 'completed', completed_at = ?, duration_ms = ? WHERE id = ?`).run(completedAt, durationMs, executionId);
+      log(`[cron] '${cronName}' completed successfully (${durationMs}ms)`);
+    } else {
+      const errorText = await response.text();
+      db.prepare(`UPDATE cron_executions SET status = 'failed', completed_at = ?, duration_ms = ?, error = ? WHERE id = ?`).run(completedAt, durationMs, errorText, executionId);
+      error(`[cron] '${cronName}' failed: ${errorText}`);
+    }
+  } catch (err) {
+    const completedAt = Math.floor(Date.now() / 1e3);
+    const errorMessage = err instanceof Error ? err.message : String(err);
+    db.prepare(`UPDATE cron_executions SET status = 'failed', completed_at = ?, error = ? WHERE id = ?`).run(completedAt, errorMessage, executionId);
+    error(`[cron] '${cronName}' error: ${errorMessage}`);
+  }
+}
+var init_cron_service = __esm({
+  "../emulator/dist/services/cron-service.js"() {
+    init_logger();
+  }
+});
+function getProjectHash(projectDir) {
+  return createHash("sha256").update(projectDir).digest("hex").slice(0, 12);
+}
+function getTempDir(projectDir) {
+  const hash = getProjectHash(projectDir);
+  return join(tmpdir(), `ploy-emulator-${hash}`);
+}
+function getDataDir(projectDir) {
+  return join(projectDir, ".ploy");
+}
+function ensureDir(dir) {
+  mkdirSync(dir, { recursive: true });
+}
+function ensureTempDir(projectDir) {
+  const tempDir = getTempDir(projectDir);
+  ensureDir(tempDir);
+  return tempDir;
+}
+function ensureDataDir(projectDir) {
+  const dataDir = getDataDir(projectDir);
+  ensureDir(dataDir);
+  ensureDir(join(dataDir, "db"));
+  return dataDir;
+}
+var init_paths = __esm({
+  "../emulator/dist/utils/paths.js"() {
+  }
+});
 function generateId() {
   return randomBytes(16).toString("hex");
 }
@@ -1871,7 +2254,9 @@ function createDashboardRoutes(app, dbManager2, config) {
       queue: config.queue,
       cache: config.cache,
       state: config.state,
+      fs: config.fs,
       workflow: config.workflow,
+      cron: config.cron,
       auth: config.auth
     });
   });
@@ -2365,6 +2750,67 @@ function createDashboardRoutes(app, dbManager2, config) {
       return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
     }
   });
+  app.get("/api/fs/:binding/entries", (c) => {
+    const binding = c.req.param("binding");
+    const fsName = config.fs?.[binding];
+    const limit = parseInt(c.req.query("limit") || "20", 10);
+    const offset = parseInt(c.req.query("offset") || "0", 10);
+    if (!fsName) {
+      return c.json({ error: "File storage binding not found" }, 404);
+    }
+    try {
+      const db = dbManager2.emulatorDb;
+      const total = db.prepare(`SELECT COUNT(*) as count FROM fs_entries WHERE fs_name = ?`).get(fsName).count;
+      const entries = db.prepare(`SELECT key, size, content_type, created_at
+					 FROM fs_entries
+					 WHERE fs_name = ?
+					 ORDER BY key ASC
+					 LIMIT ? OFFSET ?`).all(fsName, limit, offset);
+      return c.json({
+        entries: entries.map((e) => ({
+          key: e.key,
+          size: e.size,
+          contentType: e.content_type,
+          createdAt: new Date(e.created_at * 1e3).toISOString()
+        })),
+        total,
+        limit,
+        offset
+      });
+    } catch (err) {
+      return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+    }
+  });
+  app.get("/api/cron/:binding/executions", (c) => {
+    const binding = c.req.param("binding");
+    const cronExpression = config.cron?.[binding];
+    const limit = parseInt(c.req.query("limit") ?? "20", 10);
+    if (!cronExpression) {
+      return c.json({ error: "Cron binding not found" }, 404);
+    }
+    try {
+      const db = dbManager2.emulatorDb;
+      const executions = db.prepare(`SELECT id, cron_name, cron_expression, status, error, duration_ms, triggered_at, completed_at, created_at
+					 FROM cron_executions
+					 WHERE cron_name = ?
+					 ORDER BY triggered_at DESC
+					 LIMIT ?`).all(binding, limit);
+      return c.json({
+        cronExpression,
+        executions: executions.map((e) => ({
+          id: e.id,
+          status: e.status.toUpperCase(),
+          error: e.error,
+          durationMs: e.duration_ms,
+          triggeredAt: new Date(e.triggered_at * 1e3).toISOString(),
+          completedAt: e.completed_at ? new Date(e.completed_at * 1e3).toISOString() : null,
+          createdAt: new Date(e.created_at * 1e3).toISOString()
+        }))
+      });
+    } catch (err) {
+      return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+    }
+  });
   if (hasDashboard) {
     app.get("/assets/*", (c) => {
       const path = c.req.path;
@@ -2515,6 +2961,125 @@ var init_db_service = __esm({
   "../emulator/dist/services/db-service.js"() {
   }
 });
+function createFsHandlers(db, dataDir) {
+  const fsBaseDir = join(dataDir, "fs");
+  mkdirSync(fsBaseDir, { recursive: true });
+  function getFsDir(fsName) {
+    const dir = join(fsBaseDir, fsName);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+  }
+  function encodedKeyPath(fsDir, key) {
+    return join(fsDir, encodeURIComponent(key));
+  }
+  const putHandler = async (c) => {
+    try {
+      const body = await c.req.json();
+      const { fsName, key, value, contentType } = body;
+      if (!fsName || !key) {
+        return c.json({ error: "Missing required fields: fsName, key, value" }, 400);
+      }
+      const fsDir = getFsDir(fsName);
+      const filePath = encodedKeyPath(fsDir, key);
+      writeFileSync(filePath, value, "utf-8");
+      const size = Buffer.byteLength(value, "utf-8");
+      const now = Math.floor(Date.now() / 1e3);
+      db.prepare(`INSERT OR REPLACE INTO fs_entries (fs_name, key, content_type, size, created_at) VALUES (?, ?, ?, ?, ?)`).run(fsName, key, contentType ?? "application/octet-stream", size, now);
+      return c.json({ success: true });
+    } catch (err) {
+      error(`[fs-service] put error: ${err instanceof Error ? err.message : String(err)}`);
+      return c.json({
+        error: `put failed: ${err instanceof Error ? err.message : String(err)}`
+      }, 500);
+    }
+  };
+  const getHandler = async (c) => {
+    try {
+      const body = await c.req.json();
+      const { fsName, key } = body;
+      if (!fsName || !key) {
+        return c.json({ error: "Missing required fields: fsName, key" }, 400);
+      }
+      const row = db.prepare(`SELECT content_type, size FROM fs_entries WHERE fs_name = ? AND key = ?`).get(fsName, key);
+      if (!row) {
+        return c.json({ found: false });
+      }
+      const fsDir = getFsDir(fsName);
+      const filePath = encodedKeyPath(fsDir, key);
+      if (!existsSync(filePath)) {
+        db.prepare(`DELETE FROM fs_entries WHERE fs_name = ? AND key = ?`).run(fsName, key);
+        return c.json({ found: false });
+      }
+      const fileContent = readFileSync(filePath, "utf-8");
+      return c.json({
+        found: true,
+        body: fileContent,
+        contentType: row.content_type,
+        size: row.size
+      });
+    } catch (err) {
+      error(`[fs-service] get error: ${err instanceof Error ? err.message : String(err)}`);
+      return c.json({
+        error: `get failed: ${err instanceof Error ? err.message : String(err)}`
+      }, 500);
+    }
+  };
+  const deleteHandler = async (c) => {
+    try {
+      const body = await c.req.json();
+      const { fsName, key } = body;
+      if (!fsName || !key) {
+        return c.json({ error: "Missing required fields: fsName, key" }, 400);
+      }
+      db.prepare(`DELETE FROM fs_entries WHERE fs_name = ? AND key = ?`).run(fsName, key);
+      const fsDir = getFsDir(fsName);
+      const filePath = encodedKeyPath(fsDir, key);
+      if (existsSync(filePath)) {
+        unlinkSync(filePath);
+      }
+      return c.json({ success: true });
+    } catch (err) {
+      error(`[fs-service] delete error: ${err instanceof Error ? err.message : String(err)}`);
+      return c.json({
+        error: `delete failed: ${err instanceof Error ? err.message : String(err)}`
+      }, 500);
+    }
+  };
+  const listHandler = async (c) => {
+    try {
+      const body = await c.req.json();
+      const { fsName, prefix, limit } = body;
+      if (!fsName) {
+        return c.json({ error: "Missing required field: fsName" }, 400);
+      }
+      const effectiveLimit = limit ?? 1e3;
+      const keys = prefix ? db.prepare(`SELECT key, size, content_type FROM fs_entries WHERE fs_name = ? AND key LIKE ? ORDER BY key ASC LIMIT ?`).all(fsName, `${prefix}%`, effectiveLimit) : db.prepare(`SELECT key, size, content_type FROM fs_entries WHERE fs_name = ? ORDER BY key ASC LIMIT ?`).all(fsName, effectiveLimit);
+      return c.json({
+        keys: keys.map((k) => ({
+          key: k.key,
+          size: k.size,
+          contentType: k.content_type
+        }))
+      });
+    } catch (err) {
+      error(`[fs-service] list error: ${err instanceof Error ? err.message : String(err)}`);
+      return c.json({
+        error: `list failed: ${err instanceof Error ? err.message : String(err)}`
+      }, 500);
+    }
+  };
+  return {
+    putHandler,
+    getHandler,
+    deleteHandler,
+    listHandler
+  };
+}
+var init_fs_service = __esm({
+  "../emulator/dist/services/fs-service.js"() {
+    init_logger();
+  }
+});
 function createQueueHandlers(db) {
   const sendHandler = async (c) => {
     try {
@@ -2948,6 +3513,14 @@ async function startMockServer(dbManager2, config, options = {}) {
     app.post("/state/set", stateHandlers.setHandler);
     app.post("/state/delete", stateHandlers.deleteHandler);
   }
+  if (config.fs) {
+    const dataDir = getDataDir(process.cwd());
+    const fsHandlers = createFsHandlers(dbManager2.emulatorDb, dataDir);
+    app.post("/fs/put", fsHandlers.putHandler);
+    app.post("/fs/get", fsHandlers.getHandler);
+    app.post("/fs/delete", fsHandlers.deleteHandler);
+    app.post("/fs/list", fsHandlers.listHandler);
+  }
   if (config.auth) {
     const authHandlers = createAuthHandlers(dbManager2.emulatorDb);
     app.post("/auth/signup", authHandlers.signupHandler);
@@ -2979,44 +3552,18 @@ async function startMockServer(dbManager2, config, options = {}) {
 var DEFAULT_MOCK_SERVER_PORT;
 var init_mock_server = __esm({
   "../emulator/dist/services/mock-server.js"() {
+    init_paths();
     init_auth_service();
     init_cache_service();
     init_dashboard_routes();
     init_db_service();
+    init_fs_service();
     init_queue_service();
     init_state_service();
     init_workflow_service();
     DEFAULT_MOCK_SERVER_PORT = 4003;
   }
 });
-function getProjectHash(projectDir) {
-  return createHash("sha256").update(projectDir).digest("hex").slice(0, 12);
-}
-function getTempDir(projectDir) {
-  const hash = getProjectHash(projectDir);
-  return join(tmpdir(), `ploy-emulator-${hash}`);
-}
-function getDataDir(projectDir) {
-  return join(projectDir, ".ploy");
-}
-function ensureDir(dir) {
-  mkdirSync(dir, { recursive: true });
-}
-function ensureTempDir(projectDir) {
-  const tempDir = getTempDir(projectDir);
-  ensureDir(tempDir);
-  return tempDir;
-}
-function ensureDataDir(projectDir) {
-  const dataDir = getDataDir(projectDir);
-  ensureDir(dataDir);
-  ensureDir(join(dataDir, "db"));
-  return dataDir;
-}
-var init_paths = __esm({
-  "../emulator/dist/utils/paths.js"() {
-  }
-});
 function initializeDatabases(projectDir) {
   const dataDir = ensureDataDir(projectDir);
   const d1Databases = /* @__PURE__ */ new Map();
@@ -3158,6 +3705,32 @@ CREATE TABLE IF NOT EXISTS state_entries (
   value TEXT NOT NULL,
   PRIMARY KEY (state_name, key)
 );
+
+-- File storage entries table (metadata for stored files)
+CREATE TABLE IF NOT EXISTS fs_entries (
+  fs_name TEXT NOT NULL,
+  key TEXT NOT NULL,
+  content_type TEXT NOT NULL DEFAULT 'application/octet-stream',
+  size INTEGER NOT NULL DEFAULT 0,
+  created_at INTEGER DEFAULT (strftime('%s', 'now')),
+  PRIMARY KEY (fs_name, key)
+);
+
+-- Cron executions table
+CREATE TABLE IF NOT EXISTS cron_executions (
+  id TEXT PRIMARY KEY,
+  cron_name TEXT NOT NULL,
+  cron_expression TEXT NOT NULL,
+  status TEXT DEFAULT 'running',
+  error TEXT,
+  duration_ms INTEGER,
+  triggered_at INTEGER NOT NULL,
+  completed_at INTEGER,
+  created_at INTEGER DEFAULT (strftime('%s', 'now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_cron_executions_name
+  ON cron_executions(cron_name, triggered_at);
 `;
   }
 });
@@ -3174,6 +3747,7 @@ var init_emulator = __esm({
     init_env();
     init_ploy_config2();
     init_workerd_config();
+    init_cron_service();
     init_mock_server();
     init_queue_service();
     init_logger();
@@ -3189,6 +3763,7 @@ var init_emulator = __esm({
       workerdProcess = null;
       fileWatcher = null;
       queueProcessor = null;
+      cronScheduler = null;
       resolvedEnvVars = {};
       constructor(options = {}) {
         const port = options.port ?? 8787;
@@ -3256,6 +3831,12 @@ var init_emulator = __esm({
             this.queueProcessor.start();
             debug("Queue processor started", this.options.verbose);
           }
+          if (this.config.cron) {
+            const workerUrl2 = `http://${this.options.host}:${String(this.options.port)}`;
+            this.cronScheduler = createCronScheduler(this.dbManager.emulatorDb, this.config.cron, workerUrl2);
+            this.cronScheduler.start();
+            debug("Cron scheduler started", this.options.verbose);
+          }
           success(`Emulator running at http://${this.options.host}:${String(this.options.port)}`);
           log(`  Dashboard: http://${this.options.host}:${String(this.mockServer.port)}`);
           if (Object.keys(this.resolvedEnvVars).length > 0) {
@@ -3270,9 +3851,17 @@ var init_emulator = __esm({
           if (this.config.cache) {
             log(`  Cache bindings: ${Object.keys(this.config.cache).join(", ")}`);
           }
+          if (this.config.fs) {
+            log(`  File Storage bindings: ${Object.keys(this.config.fs).join(", ")}`);
+          }
           if (this.config.workflow) {
             log(`  Workflow bindings: ${Object.keys(this.config.workflow).join(", ")}`);
           }
+          if (this.config.cron) {
+            for (const [name, expr] of Object.entries(this.config.cron)) {
+              log(`  Cron: ${name} = ${expr}`);
+            }
+          }
           this.setupSignalHandlers();
         } catch (err) {
           error(`Failed to start emulator: ${err instanceof Error ? err.message : String(err)}`);
@@ -3397,6 +3986,10 @@ var init_emulator = __esm({
         process.on("SIGTERM", handler);
       }
       async stop() {
+        if (this.cronScheduler) {
+          this.cronScheduler.stop();
+          this.cronScheduler = null;
+        }
         if (this.queueProcessor) {
           this.queueProcessor.stop();
           this.queueProcessor = null;
@@ -5333,7 +5926,7 @@ async function typesCommand(options = {}) {
     console.error("Error: ploy.yaml not found in current directory");
     process.exit(1);
   }
-  const hasBindings2 = config.env || config.ai || config.db || config.queue || config.cache || config.state || config.workflow;
+  const hasBindings2 = config.env || config.ai || config.db || config.queue || config.cache || config.state || config.workflow || config.cron;
   if (!hasBindings2) {
     console.log("No bindings found in ploy.yaml. Generating empty Env.");
   }