@surf-ai/sdk 0.1.6-beta → 1.0.0-alpha.0

package/dist/db/index.cjs

@@ -28,28 +28,49 @@ __export(db_exports, {
 });
 module.exports = __toCommonJS(db_exports);
 
-// src/data/client.ts
-var DEFAULT_PUBLIC_URL = "https://api.ask.surf/gateway/v1";
-function env(surfName, legacyName) {
-  return process.env[surfName] || process.env[legacyName];
-}
-function resolveConfig() {
-  const proxyBase = env("SURF_SANDBOX_PROXY_BASE", "DATA_PROXY_BASE");
-  if (proxyBase) {
-    return { baseUrl: proxyBase, headers: {} };
-  }
-  const gatewayUrl = env("SURF_DEPLOYED_GATEWAY_URL", "GATEWAY_URL");
-  const appToken = env("SURF_DEPLOYED_APP_TOKEN", "APP_TOKEN");
-  if (gatewayUrl && appToken) {
-    return {
-      baseUrl: `${gatewayUrl.replace(/\/$/, "")}/gateway/v1`,
-      headers: { Authorization: `Bearer ${appToken}` }
-    };
+// 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: DEFAULT_PUBLIC_URL, headers: {} };
+  return { baseUrl: config.baseUrl, apiKey: config.apiKey };
+}
+
+// src/core/transport.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function normalizePath(path) {
-  return String(path || "").replace(/^\/+/, "").replace(/^(?:proxy\/)+/, "");
+  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++) {
@@ -59,33 +80,38 @@ async function fetchJson(url, init, retries = 1) {
       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 new Promise((r) => setTimeout(r, 1e3));
+    if (text) {
+      return JSON.parse(text);
+    }
+    if (attempt < retries) {
+      await sleep(1e3);
+    }
   }
   throw new Error(`Empty response from ${url}`);
 }
-async function get(path, params) {
-  const config = resolveConfig();
-  const cleaned = {};
-  if (params) {
-    for (const [k, v] of Object.entries(params)) {
-      if (v != null) cleaned[k] = String(v);
-    }
-  }
-  const qs = Object.keys(cleaned).length ? "?" + new URLSearchParams(cleaned).toString() : "";
-  return fetchJson(`${config.baseUrl}/${normalizePath(path)}${qs}`, {
-    headers: config.headers
+async function getJson(path, params) {
+  return fetchJson(buildUrl(path, params), {
+    headers: buildHeaders()
   });
 }
-async function post(path, body) {
-  const config = resolveConfig();
-  return fetchJson(`${config.baseUrl}/${normalizePath(path)}`, {
+async function postJson(path, body) {
+  return fetchJson(buildUrl(path), {
     method: "POST",
-    headers: { ...config.headers, "Content-Type": "application/json" },
+    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);
+}
+
 // src/db/index.ts
 async function dbProvision() {
   return post("db/provision");

package/dist/db/index.d.cts

@@ -13,7 +13,7 @@
  *   const result = await dbQuery('SELECT * FROM users WHERE id = $1', [userId])
  */
 /**
- * Provision a database for the current user via /proxy/db/provision.
+ * Provision a database for the current user via db/provision.
  * Returns connection metadata. Neon auto-creates the DB if it doesn't exist.
  */
 declare function dbProvision(): Promise<{
@@ -23,7 +23,7 @@ declare function dbProvision(): Promise<{
     password: string;
 }>;
 /**
- * Execute a SQL query via /proxy/db/query.
+ * Execute a SQL query via db/query.
  * Uses pg-proxy driver under the hood — Drizzle ORM calls this automatically.
  *
  * @param options.arrayMode - When true, rows are returned as positional arrays

package/dist/db/index.d.ts

@@ -13,7 +13,7 @@
  *   const result = await dbQuery('SELECT * FROM users WHERE id = $1', [userId])
  */
 /**
- * Provision a database for the current user via /proxy/db/provision.
+ * Provision a database for the current user via db/provision.
  * Returns connection metadata. Neon auto-creates the DB if it doesn't exist.
  */
 declare function dbProvision(): Promise<{
@@ -23,7 +23,7 @@ declare function dbProvision(): Promise<{
     password: string;
 }>;
 /**
- * Execute a SQL query via /proxy/db/query.
+ * Execute a SQL query via db/query.
  * Uses pg-proxy driver under the hood — Drizzle ORM calls this automatically.
  *
  * @param options.arrayMode - When true, rows are returned as positional arrays

package/dist/db/index.js

@@ -1,25 +1,46 @@
-// src/data/client.ts
-var DEFAULT_PUBLIC_URL = "https://api.ask.surf/gateway/v1";
-function env(surfName, legacyName) {
-  return process.env[surfName] || process.env[legacyName];
-}
-function resolveConfig() {
-  const proxyBase = env("SURF_SANDBOX_PROXY_BASE", "DATA_PROXY_BASE");
-  if (proxyBase) {
-    return { baseUrl: proxyBase, headers: {} };
-  }
-  const gatewayUrl = env("SURF_DEPLOYED_GATEWAY_URL", "GATEWAY_URL");
-  const appToken = env("SURF_DEPLOYED_APP_TOKEN", "APP_TOKEN");
-  if (gatewayUrl && appToken) {
-    return {
-      baseUrl: `${gatewayUrl.replace(/\/$/, "")}/gateway/v1`,
-      headers: { Authorization: `Bearer ${appToken}` }
-    };
+// 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: DEFAULT_PUBLIC_URL, headers: {} };
+  return { baseUrl: config.baseUrl, apiKey: config.apiKey };
+}
+
+// src/core/transport.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function normalizePath(path) {
-  return String(path || "").replace(/^\/+/, "").replace(/^(?:proxy\/)+/, "");
+  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++) {
@@ -29,33 +50,38 @@ async function fetchJson(url, init, retries = 1) {
       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 new Promise((r) => setTimeout(r, 1e3));
+    if (text) {
+      return JSON.parse(text);
+    }
+    if (attempt < retries) {
+      await sleep(1e3);
+    }
   }
   throw new Error(`Empty response from ${url}`);
 }
-async function get(path, params) {
-  const config = resolveConfig();
-  const cleaned = {};
-  if (params) {
-    for (const [k, v] of Object.entries(params)) {
-      if (v != null) cleaned[k] = String(v);
-    }
-  }
-  const qs = Object.keys(cleaned).length ? "?" + new URLSearchParams(cleaned).toString() : "";
-  return fetchJson(`${config.baseUrl}/${normalizePath(path)}${qs}`, {
-    headers: config.headers
+async function getJson(path, params) {
+  return fetchJson(buildUrl(path, params), {
+    headers: buildHeaders()
   });
 }
-async function post(path, body) {
-  const config = resolveConfig();
-  return fetchJson(`${config.baseUrl}/${normalizePath(path)}`, {
+async function postJson(path, body) {
+  return fetchJson(buildUrl(path), {
     method: "POST",
-    headers: { ...config.headers, "Content-Type": "application/json" },
+    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);
+}
+
 // src/db/index.ts
 async function dbProvision() {
   return post("db/provision");

package/dist/server/index.cjs

@@ -30,32 +30,58 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/data/client.ts
-var client_exports = {};
-__export(client_exports, {
-  get: () => get,
-  post: () => post
-});
-function env(surfName, legacyName) {
-  return process.env[surfName] || process.env[legacyName];
+// src/core/config.ts
+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 resolveConfig() {
-  const proxyBase = env("SURF_SANDBOX_PROXY_BASE", "DATA_PROXY_BASE");
-  if (proxyBase) {
-    return { baseUrl: proxyBase, headers: {} };
+function requireSurfApiConfig() {
+  const config = readSurfApiConfig();
+  if (!config.apiKey) {
+    throw new Error("SURF_API_KEY is required");
   }
-  const gatewayUrl = env("SURF_DEPLOYED_GATEWAY_URL", "GATEWAY_URL");
-  const appToken = env("SURF_DEPLOYED_APP_TOKEN", "APP_TOKEN");
-  if (gatewayUrl && appToken) {
-    return {
-      baseUrl: `${gatewayUrl.replace(/\/$/, "")}/gateway/v1`,
-      headers: { Authorization: `Bearer ${appToken}` }
-    };
+  return { baseUrl: config.baseUrl, apiKey: config.apiKey };
+}
+function readAdminApiKey() {
+  return process.env.SURF_API_KEY;
+}
+var DEFAULT_API_BASE_URL;
+var init_config = __esm({
+  "src/core/config.ts"() {
+    "use strict";
+    DEFAULT_API_BASE_URL = "https://api.ask.surf/gateway/v1";
   }
-  return { baseUrl: DEFAULT_PUBLIC_URL, headers: {} };
+});
+
+// src/core/transport.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function normalizePath(path2) {
-  return String(path2 || "").replace(/^\/+/, "").replace(/^(?:proxy\/)+/, "");
+  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++) {
@@ -65,37 +91,52 @@ async function fetchJson(url, init, retries = 1) {
       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 new Promise((r) => setTimeout(r, 1e3));
+    if (text) {
+      return JSON.parse(text);
+    }
+    if (attempt < retries) {
+      await sleep(1e3);
+    }
   }
   throw new Error(`Empty response from ${url}`);
 }
-async function get(path2, params) {
-  const config = resolveConfig();
-  const cleaned = {};
-  if (params) {
-    for (const [k, v] of Object.entries(params)) {
-      if (v != null) cleaned[k] = String(v);
-    }
-  }
-  const qs = Object.keys(cleaned).length ? "?" + new URLSearchParams(cleaned).toString() : "";
-  return fetchJson(`${config.baseUrl}/${normalizePath(path2)}${qs}`, {
-    headers: config.headers
+async function getJson(path2, params) {
+  return fetchJson(buildUrl(path2, params), {
+    headers: buildHeaders()
   });
 }
-async function post(path2, body) {
-  const config = resolveConfig();
-  return fetchJson(`${config.baseUrl}/${normalizePath(path2)}`, {
+async function postJson(path2, body) {
+  return fetchJson(buildUrl(path2), {
     method: "POST",
-    headers: { ...config.headers, "Content-Type": "application/json" },
+    headers: buildHeaders({
+      "Content-Type": "application/json"
+    }),
     body: body ? JSON.stringify(body) : void 0
   });
 }
-var DEFAULT_PUBLIC_URL;
+var init_transport = __esm({
+  "src/core/transport.ts"() {
+    "use strict";
+    init_config();
+  }
+});
+
+// src/data/client.ts
+var client_exports = {};
+__export(client_exports, {
+  get: () => get,
+  post: () => post
+});
+async function get(path2, params) {
+  return getJson(path2, params);
+}
+async function post(path2, body) {
+  return postJson(path2, body);
+}
 var init_client = __esm({
   "src/data/client.ts"() {
     "use strict";
-    DEFAULT_PUBLIC_URL = "https://api.ask.surf/gateway/v1";
+    init_transport();
   }
 });
 
@@ -112,18 +153,27 @@ var import_express = __toESM(require("express"), 1);
 var import_cors = __toESM(require("cors"), 1);
 var import_fs = __toESM(require("fs"), 1);
 var import_path = __toESM(require("path"), 1);
-var import_http_proxy_middleware = require("http-proxy-middleware");
 var import_croner = require("croner");
+init_config();
+function requireBearerAuth(req, res, next) {
+  const apiKey = readAdminApiKey();
+  if (!apiKey) {
+    return res.status(503).json({ error: "SURF_API_KEY is not configured" });
+  }
+  if (req.headers.authorization !== `Bearer ${apiKey}`) {
+    return res.status(401).json({ error: "Unauthorized" });
+  }
+  next();
+}
 function createServer(options = {}) {
-  const port = options.port || parseInt(process.env.PORT || "3001", 10);
+  const port = options.port ?? (process.env.PORT ? Number.parseInt(process.env.PORT, 10) : void 0);
+  if (!Number.isInteger(port)) {
+    throw new Error("createServer requires a port via options.port or process.env.PORT");
+  }
   const routesDir = options.routesDir || import_path.default.join(process.cwd(), "routes");
   const cronDir = options.cronDir || process.cwd();
-  const enableProxy = options.proxy !== false;
   const app = (0, import_express.default)();
   app.use((0, import_cors.default)());
-  if (enableProxy) {
-    setupProxy(app, port);
-  }
   app.use(import_express.default.json());
   app.get("/api/health", (_req, res) => {
     res.json({ status: "ok" });
@@ -133,12 +183,13 @@ function createServer(options = {}) {
       if (!file.endsWith(".js") && !file.endsWith(".ts")) continue;
       const name = file.replace(/\.(js|ts)$/, "");
       try {
-        const route = require(import_path.default.join(routesDir, file));
-        const handler = route.default || route;
+        const handler = require(import_path.default.join(routesDir, file));
         if (typeof handler === "function") {
           app.use(`/api/${name}`, handler);
           console.log(`Route registered: /api/${name}`);
+          continue;
         }
+        throw new Error(`Route module must export a handler function via module.exports`);
       } catch (err) {
         console.error(`Failed to load route ${file}: ${err.message}`);
       }
@@ -162,51 +213,6 @@ function createServer(options = {}) {
     }
   };
 }
-function env2(surfName, legacyName) {
-  return process.env[surfName] || process.env[legacyName];
-}
-function setupProxy(app, port) {
-  const gatewayUrl = env2("SURF_DEPLOYED_GATEWAY_URL", "GATEWAY_URL");
-  const appToken = env2("SURF_DEPLOYED_APP_TOKEN", "APP_TOKEN");
-  const proxyBase = env2("SURF_SANDBOX_PROXY_BASE", "DATA_PROXY_BASE");
-  const isDeployed = Boolean(gatewayUrl && appToken);
-  const bufferResponse = (0, import_http_proxy_middleware.responseInterceptor)(async (buf) => buf);
-  if (isDeployed) {
-    app.use("/proxy", (0, import_http_proxy_middleware.createProxyMiddleware)({
-      target: gatewayUrl,
-      changeOrigin: true,
-      selfHandleResponse: true,
-      pathRewrite: (p) => "/gateway/v1" + p,
-      headers: {
-        Authorization: `Bearer ${appToken}`,
-        "Accept-Encoding": "identity"
-      },
-      on: { proxyRes: bufferResponse }
-    }));
-    const loopback = `http://127.0.0.1:${port}/proxy`;
-    process.env.SURF_SANDBOX_PROXY_BASE = loopback;
-    process.env.DATA_PROXY_BASE = loopback;
-  } else if (proxyBase) {
-    const target = proxyBase.replace(/\/proxy$/, "");
-    app.use((0, import_http_proxy_middleware.createProxyMiddleware)({
-      target,
-      changeOrigin: true,
-      pathFilter: "/proxy",
-      on: {
-        proxyReq: (proxyReq, req) => {
-          console.log(`[proxy] >> ${req.method} ${req.originalUrl}`);
-        },
-        proxyRes: (proxyRes, req) => {
-          console.log(`[proxy] << ${proxyRes.statusCode} ${req.method} ${req.originalUrl}`);
-        },
-        error: (err, req, res) => {
-          console.error(`[proxy] !! ${req.method} ${req.originalUrl} error: ${err.message}`);
-          if (!res.headersSent) res.status(502).json({ error: err.message });
-        }
-      }
-    }));
-  }
-}
 var schemaSync = { run: async () => {
 }, watch: () => {
 } };
@@ -310,7 +316,7 @@ function setupSchemaSync(app, schemaDir) {
     }
     console.error("DB schema sync failed after all retries");
   }
-  app.post("/api/__sync-schema", async (_req, res) => {
+  app.post("/api/__sync-schema", requireBearerAuth, async (_req, res) => {
     try {
       await syncWithRetry(2, 1500);
       res.json({ ok: true });
@@ -414,16 +420,7 @@ function setupCron(app, cronDir) {
       console.log(`Cron registered: [${task.id}] ${task.name} (${task.schedule})`);
     }
   }
-  const envFn = (s, l) => process.env[s] || process.env[l];
-  app.use("/api/cron", (req, res, next) => {
-    const appToken = envFn("SURF_DEPLOYED_APP_TOKEN", "APP_TOKEN");
-    if (!appToken) return next();
-    const auth = req.headers.authorization;
-    if (!auth || auth !== `Bearer ${appToken}`) {
-      return res.status(401).json({ error: "Unauthorized" });
-    }
-    next();
-  });
+  app.use("/api/cron", requireBearerAuth);
   app.get("/api/cron", (_req, res) => {
     res.json(cronTasks.map((t) => {
       const state = cronState.get(t.id) || { lastRunAt: null, lastStatus: null, lastError: null };

package/dist/server/index.d.cts

@@ -1,10 +1,9 @@
 import express from 'express';
 
 /**
- * Express server runtime — replaces scaffold server.js + routes/proxy.js.
+ * Express server runtime — replaces scaffold server.js.
  *
  * Handles:
- *   - /proxy/* passthrough (env-aware: sandbox → OutboundProxy, deployed → hermod)
  *   - Auto-loading routes from routes/*.js → /api/{name}
  *   - Cron job system from cron.json
  *   - DB schema sync on startup
@@ -12,18 +11,16 @@ import express from 'express';
  */
 
 interface ServerOptions {
-    /** Port to listen on (default: PORT env, fallback 3001) */
+    /** Port to listen on. Falls back to the PORT env var when omitted. */
     port?: number;
     /** Directory containing route files (default: ./routes) */
     routesDir?: string;
     /** Directory containing cron.json (default: .) */
     cronDir?: string;
-    /** Enable /proxy/* passthrough (default: true) */
-    proxy?: boolean;
 }
 declare function createServer(options?: ServerOptions): {
     app: express.Express;
-    port: number;
+    port: number | undefined;
     start(): Promise<void>;
 };
 
@@ -3454,17 +3451,14 @@ interface V2PolymarketVolumeChartParams {
 }
 
 /**
- * Environment-aware data API client.
+ * 1.0 data API client.
  *
- * Reads env vars to determine routing (prefixed vars take priority):
- *   - SURF_SANDBOX_PROXY_BASE → sandbox (OutboundProxy handles auth)
- *   - SURF_DEPLOYED_GATEWAY_URL + SURF_DEPLOYED_APP_TOKEN → deployed (hermod with Bearer)
- *   - Neither → public (api.ask.surf, caller provides own auth)
+ * Reads:
+ *   - SURF_API_BASE_URL (default: https://api.asksurf.ai/gateway/v1)
+ *   - SURF_API_KEY      (required)
  *
- * Backward-compatible aliases:
- *   DATA_PROXY_BASE → SURF_SANDBOX_PROXY_BASE
- *   GATEWAY_URL     → SURF_DEPLOYED_GATEWAY_URL
- *   APP_TOKEN       → SURF_DEPLOYED_APP_TOKEN
+ * All requests are sent directly to the configured API base URL using
+ * Authorization: Bearer <SURF_API_KEY>.
  */
 /** Low-level GET — escape hatch for endpoints not yet in the SDK. */
 declare function get<T = any>(path: string, params?: Record<string, any>): Promise<T>;

package/dist/server/index.d.ts

@@ -1,10 +1,9 @@
 import express from 'express';
 
 /**
- * Express server runtime — replaces scaffold server.js + routes/proxy.js.
+ * Express server runtime — replaces scaffold server.js.
  *
  * Handles:
- *   - /proxy/* passthrough (env-aware: sandbox → OutboundProxy, deployed → hermod)
  *   - Auto-loading routes from routes/*.js → /api/{name}
  *   - Cron job system from cron.json
  *   - DB schema sync on startup
@@ -12,18 +11,16 @@ import express from 'express';
  */
 
 interface ServerOptions {
-    /** Port to listen on (default: PORT env, fallback 3001) */
+    /** Port to listen on. Falls back to the PORT env var when omitted. */
     port?: number;
     /** Directory containing route files (default: ./routes) */
     routesDir?: string;
     /** Directory containing cron.json (default: .) */
     cronDir?: string;
-    /** Enable /proxy/* passthrough (default: true) */
-    proxy?: boolean;
 }
 declare function createServer(options?: ServerOptions): {
     app: express.Express;
-    port: number;
+    port: number | undefined;
     start(): Promise<void>;
 };
 
@@ -3454,17 +3451,14 @@ interface V2PolymarketVolumeChartParams {
 }
 
 /**
- * Environment-aware data API client.
+ * 1.0 data API client.
  *
- * Reads env vars to determine routing (prefixed vars take priority):
- *   - SURF_SANDBOX_PROXY_BASE → sandbox (OutboundProxy handles auth)
- *   - SURF_DEPLOYED_GATEWAY_URL + SURF_DEPLOYED_APP_TOKEN → deployed (hermod with Bearer)
- *   - Neither → public (api.ask.surf, caller provides own auth)
+ * Reads:
+ *   - SURF_API_BASE_URL (default: https://api.asksurf.ai/gateway/v1)
+ *   - SURF_API_KEY      (required)
  *
- * Backward-compatible aliases:
- *   DATA_PROXY_BASE → SURF_SANDBOX_PROXY_BASE
- *   GATEWAY_URL     → SURF_DEPLOYED_GATEWAY_URL
- *   APP_TOKEN       → SURF_DEPLOYED_APP_TOKEN
+ * All requests are sent directly to the configured API base URL using
+ * Authorization: Bearer <SURF_API_KEY>.
  */
 /** Low-level GET — escape hatch for endpoints not yet in the SDK. */
 declare function get<T = any>(path: string, params?: Record<string, any>): Promise<T>;