@surf-ai/sdk 1.0.0-alpha.0 → 1.0.0-alpha.2

package/dist/server/index.js

@@ -1,16 +1,244 @@
-import {
-  __require,
-  get,
-  post,
-  readAdminApiKey
-} from "../chunk-4NA3GKVD.js";
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 
 // src/server/runtime.ts
 import express from "express";
 import cors from "cors";
-import fs from "fs";
+import fs2 from "fs";
 import path from "path";
 import { Cron } from "croner";
+
+// src/core/config.ts
+var DEFAULT_API_BASE_URL = "https://api.ask.surf/gateway/v1";
+function trimTrailingSlashes(value) {
+  return String(value || "").replace(/\/+$/, "");
+}
+function readSurfApiConfig() {
+  return {
+    baseUrl: trimTrailingSlashes(process.env.SURF_API_BASE_URL || DEFAULT_API_BASE_URL),
+    apiKey: process.env.SURF_API_KEY
+  };
+}
+function requireSurfApiConfig() {
+  const config = readSurfApiConfig();
+  if (!config.apiKey) {
+    throw new Error("SURF_API_KEY is required");
+  }
+  return { baseUrl: config.baseUrl, apiKey: config.apiKey };
+}
+function readAdminApiKey() {
+  return process.env.SURF_API_KEY;
+}
+
+// src/db/schema-sync.ts
+import fs from "fs";
+
+// src/core/transport.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function normalizePath(path2) {
+  return String(path2 || "").replace(/^\/+/, "");
+}
+function buildUrl(path2, params) {
+  const { baseUrl } = requireSurfApiConfig();
+  const url = new URL(`${baseUrl}/${normalizePath(path2)}`);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      if (value != null) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+  }
+  return url.toString();
+}
+function buildHeaders(extra) {
+  const { apiKey } = requireSurfApiConfig();
+  const headers = new Headers(extra);
+  headers.set("Authorization", `Bearer ${apiKey}`);
+  return headers;
+}
+async function fetchJson(url, init, retries = 1) {
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    const res = await fetch(url, init);
+    if (!res.ok) {
+      const text2 = await res.text();
+      throw new Error(`API error ${res.status}: ${text2.slice(0, 200)}`);
+    }
+    const text = await res.text();
+    if (text) {
+      return JSON.parse(text);
+    }
+    if (attempt < retries) {
+      await sleep(1e3);
+    }
+  }
+  throw new Error(`Empty response from ${url}`);
+}
+async function getJson(path2, params) {
+  return fetchJson(buildUrl(path2, params), {
+    headers: buildHeaders()
+  });
+}
+async function postJson(path2, body) {
+  return fetchJson(buildUrl(path2), {
+    method: "POST",
+    headers: buildHeaders({
+      "Content-Type": "application/json"
+    }),
+    body: body ? JSON.stringify(body) : void 0
+  });
+}
+
+// src/data/client.ts
+async function get(path2, params) {
+  return getJson(path2, params);
+}
+async function post(path2, body) {
+  return postJson(path2, body);
+}
+
+// src/db/schema-sync.ts
+var syncing = false;
+async function syncSchema(options) {
+  const { schemaPath, retries = 3, retryDelay = 2e3 } = options;
+  for (let i = 0; i < retries; i++) {
+    try {
+      await doSyncSchema(schemaPath);
+      return;
+    } catch (err) {
+      console.error(`DB schema sync attempt ${i + 1}/${retries} failed: ${err.message}`);
+      if (i < retries - 1) await new Promise((r) => setTimeout(r, retryDelay * (i + 1)));
+    }
+  }
+  console.error("DB schema sync failed after all retries");
+}
+async function doSyncSchema(schemaPath) {
+  if (syncing) return;
+  syncing = true;
+  try {
+    if (!fs.existsSync(schemaPath)) return;
+    let schema;
+    if (schemaPath.endsWith(".ts")) {
+      try {
+        schema = await import(`${schemaPath}?t=${Date.now()}`);
+      } catch (err) {
+        if (err instanceof SyntaxError) {
+          console.log("DB: schema file has syntax error, waiting for next change...");
+          return;
+        }
+        if (err.message.includes("Cannot find module") || err.message.includes("is not a function")) {
+          return;
+        }
+        throw err;
+      }
+    } else {
+      try {
+        delete __require.cache[__require.resolve(schemaPath)];
+      } catch {
+      }
+      try {
+        schema = __require(schemaPath);
+      } catch (err) {
+        if (err instanceof SyntaxError) {
+          console.log("DB: schema file has syntax error, waiting for next change...");
+          return;
+        }
+        if (err.message.includes("Cannot find module") || err.message.includes("is not a function")) {
+          return;
+        }
+        throw err;
+      }
+    }
+    let getTableConfig;
+    try {
+      getTableConfig = __require("drizzle-orm/pg-core").getTableConfig;
+    } catch {
+      return;
+    }
+    const tables = Object.values(schema).filter(
+      (t) => t && typeof t === "object" && /* @__PURE__ */ Symbol.for("drizzle:Name") in t
+    );
+    if (tables.length === 0) return;
+    await post("db/provision", {});
+    const existing = (await get("db/tables")).map((t) => t.name);
+    const missing = tables.filter((t) => !existing.includes(getTableConfig(t).name));
+    if (missing.length > 0) {
+      const { generateDrizzleJson, generateMigration } = __require("drizzle-kit/api");
+      const missingSchema = {};
+      for (const t of missing) missingSchema[getTableConfig(t).name] = t;
+      const sqls = await generateMigration(generateDrizzleJson({}), generateDrizzleJson(missingSchema));
+      for (const sql of sqls) {
+        for (let attempt = 0; attempt < 2; attempt++) {
+          try {
+            await post("db/query", { sql, params: [] });
+            console.log(`DB: Executed: ${sql.slice(0, 80)}...`);
+            break;
+          } catch (err) {
+            if (attempt === 0) {
+              console.warn(`DB: Retrying after: ${err.message}`);
+              await new Promise((r) => setTimeout(r, 1500));
+            } else {
+              console.error(`DB: Failed: ${sql.slice(0, 80)}... \u2014 ${err.message}`);
+            }
+          }
+        }
+      }
+    }
+    const existingTables = tables.filter((t) => existing.includes(getTableConfig(t).name));
+    for (const t of existingTables) {
+      const cfg = getTableConfig(t);
+      try {
+        const live = await get("db/table-schema", { table: cfg.name });
+        const liveCols = new Set((live.columns || []).map((c) => c.name));
+        for (const col of cfg.columns) {
+          if (!liveCols.has(col.name)) {
+            const colType = col.getSQLType();
+            const ddl = `ALTER TABLE "${cfg.name}" ADD COLUMN IF NOT EXISTS "${col.name}" ${colType}`;
+            try {
+              await post("db/query", { sql: ddl, params: [] });
+              console.log(`DB: Added column ${col.name} to ${cfg.name}`);
+            } catch (err) {
+              console.warn(`DB: Failed to add column ${col.name} to ${cfg.name}: ${err.message}`);
+            }
+          }
+        }
+      } catch (err) {
+        console.warn(`DB: Column check failed for ${cfg.name}: ${err.message}`);
+      }
+    }
+  } finally {
+    syncing = false;
+  }
+}
+function watchSchema(schemaPath, options) {
+  const { debounceMs = 1e3, retries = 2, retryDelay = 1500 } = options || {};
+  if (!fs.existsSync(schemaPath)) return () => {
+  };
+  let debounce = null;
+  fs.watchFile(schemaPath, { interval: 2e3 }, () => {
+    if (debounce) clearTimeout(debounce);
+    debounce = setTimeout(async () => {
+      console.log("DB: schema file changed, re-syncing tables...");
+      try {
+        await syncSchema({ schemaPath, retries, retryDelay });
+        console.log("DB: schema re-sync complete");
+      } catch (err) {
+        console.error(`DB: schema re-sync failed: ${err.message}`);
+      }
+    }, debounceMs);
+  });
+  return () => {
+    fs.unwatchFile(schemaPath);
+    if (debounce) clearTimeout(debounce);
+  };
+}
+
+// src/server/runtime.ts
 function requireBearerAuth(req, res, next) {
   const apiKey = readAdminApiKey();
   if (!apiKey) {
@@ -22,9 +250,10 @@ function requireBearerAuth(req, res, next) {
   next();
 }
 function createServer(options = {}) {
-  const port = options.port ?? (process.env.PORT ? Number.parseInt(process.env.PORT, 10) : void 0);
+  const rawPort = process.env.BACKEND_PORT;
+  const port = options.port ?? (rawPort ? Number.parseInt(rawPort, 10) : void 0);
   if (!Number.isInteger(port)) {
-    throw new Error("createServer requires a port via options.port or process.env.PORT");
+    throw new Error("createServer requires a port via options.port or BACKEND_PORT env var");
   }
   const routesDir = options.routesDir || path.join(process.cwd(), "routes");
   const cronDir = options.cronDir || process.cwd();
@@ -34,8 +263,8 @@ function createServer(options = {}) {
   app.get("/api/health", (_req, res) => {
     res.json({ status: "ok" });
   });
-  if (fs.existsSync(routesDir)) {
-    for (const file of fs.readdirSync(routesDir)) {
+  if (fs2.existsSync(routesDir)) {
+    for (const file of fs2.readdirSync(routesDir)) {
       if (!file.endsWith(".js") && !file.endsWith(".ts")) continue;
       const name = file.replace(/\.(js|ts)$/, "");
       try {
@@ -73,108 +302,11 @@ var schemaSync = { run: async () => {
 }, watch: () => {
 } };
 function setupSchemaSync(app, schemaDir) {
-  let syncing = false;
   let schemaReady = false;
-  async function doSyncSchema() {
-    if (syncing) return;
-    syncing = true;
-    try {
-      const schemaPath = path.join(schemaDir, "schema.js");
-      if (!fs.existsSync(schemaPath)) return;
-      try {
-        delete __require.cache[__require.resolve(schemaPath)];
-      } catch {
-      }
-      let schema;
-      try {
-        schema = __require(schemaPath);
-      } catch (err) {
-        if (err instanceof SyntaxError) {
-          console.log("DB: schema.js has syntax error, waiting for next change...");
-          return;
-        }
-        if (err.message.includes("Cannot find module") || err.message.includes("is not a function")) {
-          return;
-        }
-        throw err;
-      }
-      let getTableConfig;
-      try {
-        getTableConfig = __require("drizzle-orm/pg-core").getTableConfig;
-      } catch {
-        return;
-      }
-      const tables = Object.values(schema).filter(
-        (t) => t && typeof t === "object" && /* @__PURE__ */ Symbol.for("drizzle:Name") in t
-      );
-      if (tables.length === 0) return;
-      const { get: dbGet, post: dbPost } = await import("../client-Z45B2GYT.js");
-      await dbPost("db/provision");
-      const existing = (await dbGet("db/tables")).map((t) => t.name);
-      const missing = tables.filter((t) => !existing.includes(getTableConfig(t).name));
-      if (missing.length > 0) {
-        const { generateDrizzleJson, generateMigration } = __require("drizzle-kit/api");
-        const missingSchema = {};
-        for (const t of missing) missingSchema[getTableConfig(t).name] = t;
-        const sqls = await generateMigration(generateDrizzleJson({}), generateDrizzleJson(missingSchema));
-        for (const sql of sqls) {
-          for (let attempt = 0; attempt < 2; attempt++) {
-            try {
-              await dbPost("db/query", { sql, params: [] });
-              console.log(`DB: Executed: ${sql.slice(0, 80)}...`);
-              break;
-            } catch (err) {
-              if (attempt === 0) {
-                console.warn(`DB: Retrying after: ${err.message}`);
-                await new Promise((r) => setTimeout(r, 1500));
-              } else {
-                console.error(`DB: Failed: ${sql.slice(0, 80)}... \u2014 ${err.message}`);
-              }
-            }
-          }
-        }
-      }
-      const existingTables = tables.filter((t) => existing.includes(getTableConfig(t).name));
-      for (const t of existingTables) {
-        const cfg = getTableConfig(t);
-        try {
-          const live = await dbGet("db/table-schema", { table: cfg.name });
-          const liveCols = new Set((live.columns || []).map((c) => c.name));
-          for (const col of cfg.columns) {
-            if (!liveCols.has(col.name)) {
-              const colType = col.getSQLType();
-              const ddl = `ALTER TABLE "${cfg.name}" ADD COLUMN IF NOT EXISTS "${col.name}" ${colType}`;
-              try {
-                await dbPost("db/query", { sql: ddl, params: [] });
-                console.log(`DB: Added column ${col.name} to ${cfg.name}`);
-              } catch (err) {
-                console.warn(`DB: Failed to add column ${col.name} to ${cfg.name}: ${err.message}`);
-              }
-            }
-          }
-        } catch (err) {
-          console.warn(`DB: Column check failed for ${cfg.name}: ${err.message}`);
-        }
-      }
-    } finally {
-      syncing = false;
-    }
-  }
-  async function syncWithRetry(retries = 3, delay = 2e3) {
-    for (let i = 0; i < retries; i++) {
-      try {
-        await doSyncSchema();
-        return;
-      } catch (err) {
-        console.error(`DB schema sync attempt ${i + 1}/${retries} failed: ${err.message}`);
-        if (i < retries - 1) await new Promise((r) => setTimeout(r, delay * (i + 1)));
-      }
-    }
-    console.error("DB schema sync failed after all retries");
-  }
+  const schemaPath = path.join(schemaDir, "schema.js");
   app.post("/api/__sync-schema", requireBearerAuth, async (_req, res) => {
     try {
-      await syncWithRetry(2, 1500);
+      await syncSchema({ schemaPath, retries: 2, retryDelay: 1500 });
       res.json({ ok: true });
     } catch (err) {
       res.status(500).json({ ok: false, error: err.message });
@@ -186,7 +318,7 @@ function setupSchemaSync(app, schemaDir) {
   });
   schemaSync.run = async () => {
     try {
-      await syncWithRetry();
+      await syncSchema({ schemaPath });
       schemaReady = true;
       console.log("Schema sync complete, API ready");
     } catch {
@@ -195,21 +327,7 @@ function setupSchemaSync(app, schemaDir) {
     }
   };
   schemaSync.watch = () => {
-    const schemaPath = path.join(schemaDir, "schema.js");
-    if (!fs.existsSync(schemaPath)) return;
-    let debounce = null;
-    fs.watchFile(schemaPath, { interval: 2e3 }, () => {
-      if (debounce) clearTimeout(debounce);
-      debounce = setTimeout(async () => {
-        console.log("DB: schema.js changed, re-syncing tables...");
-        try {
-          await syncWithRetry(2, 1500);
-          console.log("DB: schema re-sync complete");
-        } catch (err) {
-          console.error(`DB: schema re-sync failed: ${err.message}`);
-        }
-      }, 1e3);
-    });
+    watchSchema(schemaPath);
   };
 }
 function setupCron(app, cronDir) {
@@ -225,10 +343,10 @@ function setupCron(app, cronDir) {
     }
     cronJobs.clear();
     const cronPath = path.join(cronDir, "cron.json");
-    if (!fs.existsSync(cronPath)) return;
+    if (!fs2.existsSync(cronPath)) return;
     let tasks;
     try {
-      tasks = JSON.parse(fs.readFileSync(cronPath, "utf-8"));
+      tasks = JSON.parse(fs2.readFileSync(cronPath, "utf-8"));
     } catch (e) {
       console.error("Failed to parse cron.json:", e.message);
       return;
@@ -309,7 +427,7 @@ function setupCron(app, cronDir) {
     const cronPath = path.join(cronDir, "cron.json");
     let tasks = [];
     try {
-      if (fs.existsSync(cronPath)) tasks = JSON.parse(fs.readFileSync(cronPath, "utf8"));
+      if (fs2.existsSync(cronPath)) tasks = JSON.parse(fs2.readFileSync(cronPath, "utf8"));
     } catch {
       tasks = [];
     }
@@ -318,7 +436,7 @@ function setupCron(app, cronDir) {
     }
     const newTask = { id, name, schedule, handler, enabled, timeout };
     tasks.push(newTask);
-    fs.writeFileSync(cronPath, JSON.stringify(tasks, null, 2));
+    fs2.writeFileSync(cronPath, JSON.stringify(tasks, null, 2));
     loadCronJobs();
     res.status(201).json(newTask);
   });
@@ -326,7 +444,7 @@ function setupCron(app, cronDir) {
     const cronPath = path.join(cronDir, "cron.json");
     let tasks = [];
     try {
-      if (fs.existsSync(cronPath)) tasks = JSON.parse(fs.readFileSync(cronPath, "utf8"));
+      if (fs2.existsSync(cronPath)) tasks = JSON.parse(fs2.readFileSync(cronPath, "utf8"));
     } catch {
       tasks = [];
     }
@@ -347,7 +465,7 @@ function setupCron(app, cronDir) {
       }
     }
     tasks[idx] = { ...tasks[idx], ...updates, id: req.params.id };
-    fs.writeFileSync(cronPath, JSON.stringify(tasks, null, 2));
+    fs2.writeFileSync(cronPath, JSON.stringify(tasks, null, 2));
     loadCronJobs();
     res.json(tasks[idx]);
   });
@@ -355,14 +473,14 @@ function setupCron(app, cronDir) {
     const cronPath = path.join(cronDir, "cron.json");
     let tasks = [];
     try {
-      if (fs.existsSync(cronPath)) tasks = JSON.parse(fs.readFileSync(cronPath, "utf8"));
+      if (fs2.existsSync(cronPath)) tasks = JSON.parse(fs2.readFileSync(cronPath, "utf8"));
     } catch {
       tasks = [];
     }
     const idx = tasks.findIndex((t) => t.id === req.params.id);
     if (idx === -1) return res.status(404).json({ error: "Task not found" });
     tasks.splice(idx, 1);
-    fs.writeFileSync(cronPath, JSON.stringify(tasks, null, 2));
+    fs2.writeFileSync(cronPath, JSON.stringify(tasks, null, 2));
     cronState.delete(req.params.id);
     loadCronJobs();
     res.json({ ok: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surf-ai/sdk",
-  "version": "1.0.0-alpha.0",
+  "version": "1.0.0-alpha.2",
   "description": "Surf platform SDK — data API client, server runtime, and database helpers",
   "type": "module",
   "exports": {

package/dist/chunk-4NA3GKVD.js

@@ -1,100 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/core/config.ts
-var DEFAULT_API_BASE_URL = "https://api.ask.surf/gateway/v1";
-function trimTrailingSlashes(value) {
-  return String(value || "").replace(/\/+$/, "");
-}
-function readSurfApiConfig() {
-  return {
-    baseUrl: trimTrailingSlashes(process.env.SURF_API_BASE_URL || DEFAULT_API_BASE_URL),
-    apiKey: process.env.SURF_API_KEY
-  };
-}
-function requireSurfApiConfig() {
-  const config = readSurfApiConfig();
-  if (!config.apiKey) {
-    throw new Error("SURF_API_KEY is required");
-  }
-  return { baseUrl: config.baseUrl, apiKey: config.apiKey };
-}
-function readAdminApiKey() {
-  return process.env.SURF_API_KEY;
-}
-
-// src/core/transport.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function normalizePath(path) {
-  return String(path || "").replace(/^\/+/, "");
-}
-function buildUrl(path, params) {
-  const { baseUrl } = requireSurfApiConfig();
-  const url = new URL(`${baseUrl}/${normalizePath(path)}`);
-  if (params) {
-    for (const [key, value] of Object.entries(params)) {
-      if (value != null) {
-        url.searchParams.set(key, String(value));
-      }
-    }
-  }
-  return url.toString();
-}
-function buildHeaders(extra) {
-  const { apiKey } = requireSurfApiConfig();
-  const headers = new Headers(extra);
-  headers.set("Authorization", `Bearer ${apiKey}`);
-  return headers;
-}
-async function fetchJson(url, init, retries = 1) {
-  for (let attempt = 0; attempt <= retries; attempt++) {
-    const res = await fetch(url, init);
-    if (!res.ok) {
-      const text2 = await res.text();
-      throw new Error(`API error ${res.status}: ${text2.slice(0, 200)}`);
-    }
-    const text = await res.text();
-    if (text) {
-      return JSON.parse(text);
-    }
-    if (attempt < retries) {
-      await sleep(1e3);
-    }
-  }
-  throw new Error(`Empty response from ${url}`);
-}
-async function getJson(path, params) {
-  return fetchJson(buildUrl(path, params), {
-    headers: buildHeaders()
-  });
-}
-async function postJson(path, body) {
-  return fetchJson(buildUrl(path), {
-    method: "POST",
-    headers: buildHeaders({
-      "Content-Type": "application/json"
-    }),
-    body: body ? JSON.stringify(body) : void 0
-  });
-}
-
-// src/data/client.ts
-async function get(path, params) {
-  return getJson(path, params);
-}
-async function post(path, body) {
-  return postJson(path, body);
-}
-
-export {
-  __require,
-  readAdminApiKey,
-  get,
-  post
-};

package/dist/client-Z45B2GYT.js

@@ -1,8 +0,0 @@
-import {
-  get,
-  post
-} from "./chunk-4NA3GKVD.js";
-export {
-  get,
-  post
-};