@supacloud/cli 0.35.1 → 0.37.0

package/dist/index.js

@@ -6503,7 +6503,7 @@ var ACTION_POLICY = {
   },
   edge_functions: {
     read: ["list", "get_config", "source"],
-    local: ["check"],
+    local: ["check", "scaffold"],
     write: ["deploy", "deploy_bundle", "config", "activate", "delete"]
   },
   scheduled_functions: { read: ["list", "get"], write: ["create", "update", "delete"] },
@@ -10069,6 +10069,7 @@ import {
   existsSync as existsSync3,
   fstatSync,
   lstatSync,
+  mkdirSync,
   mkdtempSync,
   openSync,
   readFileSync as readFileSync3,
@@ -10087,13 +10088,15 @@ var CANONICAL_VERSION_PATTERN = /^(?:0|[1-9][0-9]*)$/;
 var SAFE_SLUG_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
 var ACTIVATION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
 var LEGACY_ACTIVATION_ID = "legacy";
+var FUNCTION_FRAMEWORKS = ["fetch", "elysia", "hono", "sveltekit-function"];
 var LIST_STRING_FIELDS = [
   "id",
   "name",
   "status",
   "entrypoint_path",
   "created_at",
-  "updated_at"
+  "updated_at",
+  "framework"
 ];
 var LIST_BOOLEAN_FIELDS = ["verify_jwt", "import_map"];
 function objectRecord(candidate) {
@@ -10105,6 +10108,45 @@ function canonicalVersion(candidate) {
 function stringRoutes(candidate) {
   return Array.isArray(candidate) && candidate.every((route) => typeof route === "string");
 }
+function projectedFunctionCapabilities(candidate) {
+  const record = objectRecord(candidate);
+  if (!record)
+    return null;
+  const projected = {};
+  for (const field of ["secrets", "outbound_hosts", "bindings"]) {
+    if (record[field] !== undefined && (!Array.isArray(record[field]) || record[field].some((entry) => typeof entry !== "string")))
+      return null;
+    if (record[field] !== undefined)
+      projected[field] = record[field];
+  }
+  if (record.background !== undefined && typeof record.background !== "boolean")
+    return null;
+  if (typeof record.background === "boolean")
+    projected.background = record.background;
+  return projected;
+}
+function projectedFunctionLimits(candidate) {
+  const record = objectRecord(candidate);
+  if (!record)
+    return null;
+  const projected = {};
+  const maxima = {
+    timeout_ms: 900000,
+    max_request_body_bytes: 30 * 1024 * 1024,
+    max_response_body_bytes: 30 * 1024 * 1024,
+    wait_until_timeout_ms: 900000
+  };
+  for (const field of Object.keys(maxima)) {
+    const value = record[field];
+    if (value === undefined)
+      continue;
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1 || value > maxima[field]) {
+      return null;
+    }
+    projected[field] = value;
+  }
+  return projected;
+}
 function optionalTypedFields(source, fields, expectedType) {
   return fields.every((field) => source[field] === undefined || typeof source[field] === expectedType);
 }
@@ -10116,7 +10158,11 @@ function validCommittedFunctionActivationId(candidate) {
 }
 function projectedFunctionListEntry(candidate) {
   const functionRecord = objectRecord(candidate);
-  if (!functionRecord || typeof functionRecord.slug !== "string" || !SAFE_SLUG_PATTERN.test(functionRecord.slug) || typeof functionRecord.version !== "number" || !Number.isSafeInteger(functionRecord.version) || functionRecord.version < 0 || !validObservedFunctionActivationId(functionRecord.activation_id) || !optionalTypedFields(functionRecord, LIST_STRING_FIELDS, "string") || !optionalTypedFields(functionRecord, LIST_BOOLEAN_FIELDS, "boolean") || functionRecord.background_routes !== undefined && !stringRoutes(functionRecord.background_routes))
+  if (!functionRecord || typeof functionRecord.slug !== "string" || !SAFE_SLUG_PATTERN.test(functionRecord.slug) || typeof functionRecord.version !== "number" || !Number.isSafeInteger(functionRecord.version) || functionRecord.version < 0 || !validObservedFunctionActivationId(functionRecord.activation_id) || !optionalTypedFields(functionRecord, LIST_STRING_FIELDS, "string") || !optionalTypedFields(functionRecord, LIST_BOOLEAN_FIELDS, "boolean") || functionRecord.framework !== undefined && !FUNCTION_FRAMEWORKS.includes(functionRecord.framework) || functionRecord.background_routes !== undefined && !stringRoutes(functionRecord.background_routes))
+    return null;
+  const capabilities = functionRecord.capabilities === undefined ? undefined : projectedFunctionCapabilities(functionRecord.capabilities);
+  const limits = functionRecord.limits === undefined ? undefined : projectedFunctionLimits(functionRecord.limits);
+  if (capabilities === null || limits === null)
     return null;
   const projected = {
     slug: functionRecord.slug,
@@ -10130,6 +10176,10 @@ function projectedFunctionListEntry(candidate) {
   if (functionRecord.background_routes !== undefined) {
     projected.background_routes = functionRecord.background_routes;
   }
+  if (capabilities !== undefined)
+    projected.capabilities = capabilities;
+  if (limits !== undefined)
+    projected.limits = limits;
   return projected;
 }
 function projectedFunctionList(payload) {
@@ -10176,13 +10226,23 @@ function projectedFunctionIdentity(payload, expectedProjectRef, expectedSlug) {
   const optionalFields = optionalConfigFields(response);
   if (!optionalFields || !coherentFunctionVersion(response.active_version, optionalFields.version))
     return null;
+  const framework = response.framework;
+  if (framework !== undefined && !FUNCTION_FRAMEWORKS.includes(framework))
+    return null;
+  const capabilities = response.capabilities === undefined ? undefined : projectedFunctionCapabilities(response.capabilities);
+  const limits = response.limits === undefined ? undefined : projectedFunctionLimits(response.limits);
+  if (capabilities === null || limits === null)
+    return null;
   return {
     project_ref: expectedProjectRef,
     slug: expectedSlug,
     active_version: response.active_version,
     verify_jwt: response.verify_jwt,
     background_routes: response.background_routes,
+    ...framework === undefined ? {} : { framework },
     ...optionalFields,
+    ...capabilities === undefined ? {} : { capabilities },
+    ...limits === undefined ? {} : { limits },
     activation_id: response.activation_id
   };
 }
@@ -10193,14 +10253,26 @@ function configMatchesExpectation(response, expected) {
   if (typeof response.verify_jwt !== "boolean" || !stringRoutes(response.background_routes)) {
     return false;
   }
+  if (response.framework !== undefined && !FUNCTION_FRAMEWORKS.includes(response.framework))
+    return false;
   if (expected.verify_jwt !== undefined && response.verify_jwt !== expected.verify_jwt)
     return false;
+  if (expected.framework !== undefined && response.framework !== expected.framework)
+    return false;
+  if (expected.capabilities !== undefined && JSON.stringify(response.capabilities) !== JSON.stringify(expected.capabilities))
+    return false;
+  if (expected.limits !== undefined && JSON.stringify(response.limits) !== JSON.stringify(expected.limits))
+    return false;
   return expected.background_routes === undefined || JSON.stringify(response.background_routes) === JSON.stringify(expected.background_routes);
 }
 function confirmedFunctionConfigMutation(payload, expectation) {
   const response = objectRecord(payload);
   if (!response || !mutationIdentityMatches(response, expectation) || !configMatchesExpectation(response, expectation.config))
     return null;
+  const capabilities = response.capabilities === undefined ? undefined : projectedFunctionCapabilities(response.capabilities);
+  const limits = response.limits === undefined ? undefined : projectedFunctionLimits(response.limits);
+  if (capabilities === null || limits === null)
+    return null;
   const optionalFields = optionalConfigFields(response);
   if (!optionalFields)
     return null;
@@ -10211,7 +10283,10 @@ function confirmedFunctionConfigMutation(payload, expectation) {
     activation_id: response.activation_id,
     verify_jwt: response.verify_jwt,
     background_routes: response.background_routes,
-    ...optionalFields
+    ...response.framework === undefined ? {} : { framework: response.framework },
+    ...optionalFields,
+    ...capabilities === undefined ? {} : { capabilities },
+    ...limits === undefined ? {} : { limits }
   };
 }
 function confirmedFunctionDeletion(payload, expectation) {
@@ -10233,6 +10308,93 @@ function confirmedFunctionDeletion(payload, expectation) {
 var execFileAsync = promisify(execFile);
 var SHA256_HEX_PATTERN = /^[a-f0-9]{64}$/;
 var FORBIDDEN_BUNDLE_SEGMENTS = new Set(["node_modules", ".git"]);
+var FUNCTION_FRAMEWORKS2 = ["fetch", "elysia", "hono", "sveltekit-function"];
+function scaffoldFiles(framework, slug) {
+  if (framework === "elysia") {
+    return {
+      "package.json": JSON.stringify({
+        private: true,
+        type: "module",
+        dependencies: { elysia: "^1.4.30" }
+      }, null, 2) + `
+`,
+      "index.ts": `import { Elysia } from "elysia";
+
+export default new Elysia()
+  .get("/", () => ({ function: "${slug}", framework: "elysia" }));
+`
+    };
+  }
+  if (framework === "hono") {
+    return {
+      "package.json": JSON.stringify({
+        private: true,
+        type: "module",
+        dependencies: { hono: "^4.13.5" }
+      }, null, 2) + `
+`,
+      "index.ts": `import { Hono } from "hono";
+
+const app = new Hono();
+app.get("/", (context) => context.json({ function: "${slug}", framework: "hono" }));
+
+export default app;
+`
+    };
+  }
+  if (framework === "sveltekit-function") {
+    return {
+      "package.json": JSON.stringify({
+        private: true,
+        type: "module",
+        scripts: { build: "vite build" },
+        devDependencies: {
+          "@supacloud/function-adapter": "^0.1.0",
+          "@sveltejs/kit": "^2.70.3",
+          "@sveltejs/vite-plugin-svelte": "^7.3.0",
+          svelte: "^5.57.0",
+          vite: "^8.2.2"
+        }
+      }, null, 2) + `
+`,
+      "svelte.config.js": `import adapter from "@supacloud/function-adapter/sveltekit-adapter";
+
+export default { kit: { adapter: adapter() } };
+`,
+      "vite.config.ts": `import { sveltekit } from "@sveltejs/kit/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({ plugins: [sveltekit()] });
+`,
+      "src/routes/+server.ts": `export function GET() {
+  return Response.json({ function: "${slug}", framework: "sveltekit-function" });
+}
+`
+    };
+  }
+  return { "index.ts": `export default function handler(request: Request) {
+  return Response.json({ function: "${slug}", path: new URL(request.url).pathname });
+}
+` };
+}
+function scaffoldFunction(pathArg, slug, framework) {
+  if (typeof slug !== "string" || !/^[A-Za-z0-9_-]{1,128}$/.test(slug)) {
+    throw new Error("'slug' required for 'scaffold'");
+  }
+  if (typeof framework !== "string" || !FUNCTION_FRAMEWORKS2.includes(framework)) {
+    throw new Error("'framework' required for 'scaffold'");
+  }
+  const target = resolve2(typeof pathArg === "string" ? pathArg : join2("supabase", "functions", slug));
+  if (existsSync3(target))
+    throw new Error(`Scaffold target already exists: ${target}`);
+  const files = scaffoldFiles(framework, slug);
+  for (const [relativePath, contents] of Object.entries(files)) {
+    const destination = join2(target, relativePath);
+    mkdirSync(resolve2(destination, ".."), { recursive: true });
+    writeFileSync(destination, contents, { flag: "wx" });
+  }
+  return JSON.stringify({ success: true, framework, path: target, files: Object.keys(files) }, null, 2);
+}
 function openFileIdentity(descriptor) {
   const state = fstatSync(descriptor, { bigint: true });
   if (!state.isFile())
@@ -10441,6 +10603,18 @@ function parseBackgroundRoutes(value) {
 }
 var backgroundRoutesSchema = Type.Optional(decodedSchema(Type.Union([Type.String(), Type.Array(Type.String())]), Type.Array(Type.String()), parseBackgroundRoutes));
 var functionFilesRecordSchema = Type.Record(Type.String(), Type.String());
+var functionCapabilitiesSchema = Type.Object({
+  secrets: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { maxItems: 128 })),
+  outbound_hosts: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { maxItems: 128 })),
+  bindings: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { maxItems: 128 })),
+  background: Type.Optional(Type.Boolean())
+}, { additionalProperties: false });
+var functionLimitsSchema = Type.Object({
+  timeout_ms: Type.Optional(Type.Integer({ minimum: 1, maximum: 900000 })),
+  max_request_body_bytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 30 * 1024 * 1024 })),
+  max_response_body_bytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 30 * 1024 * 1024 })),
+  wait_until_timeout_ms: Type.Optional(Type.Integer({ minimum: 1, maximum: 900000 }))
+}, { additionalProperties: false });
 function parseFunctionFiles(input) {
   if (typeof input !== "string")
     return input;
@@ -10648,12 +10822,18 @@ function confirmedFunctionConfig(payload, expected) {
     return false;
   if (expected.verify_jwt !== undefined && response.verify_jwt !== expected.verify_jwt)
     return false;
+  if (expected.framework !== undefined && response.framework !== expected.framework)
+    return false;
   if (expected.background_routes !== undefined) {
     if (!Array.isArray(response.background_routes))
       return false;
     if (JSON.stringify(response.background_routes) !== JSON.stringify(expected.background_routes))
       return false;
   }
+  if (expected.capabilities !== undefined && JSON.stringify(response.capabilities) !== JSON.stringify(expected.capabilities))
+    return false;
+  if (expected.limits !== undefined && JSON.stringify(response.limits) !== JSON.stringify(expected.limits))
+    return false;
   return true;
 }
 function functionSourceCode(payload, field = "code") {
@@ -10745,7 +10925,18 @@ function confirmedFunctionMutation(expectation, payload) {
   const activationId = receipt.activation_id;
   if (activeVersion === null || !validCommittedFunctionActivationId(activationId) || config.activation_id !== activationId || typeof config.verify_jwt !== "boolean" || !confirmedFunctionConfig(config, expectation.config ?? {}))
     return null;
-  return { activeVersion, activationId, verifyJwt: config.verify_jwt };
+  const framework = config.framework;
+  if (framework !== undefined && (typeof framework !== "string" || !FUNCTION_FRAMEWORKS2.includes(framework))) {
+    return null;
+  }
+  return {
+    activeVersion,
+    activationId,
+    verifyJwt: config.verify_jwt,
+    ...framework === undefined ? {} : { framework },
+    ...config.capabilities === undefined ? {} : { capabilities: config.capabilities },
+    ...config.limits === undefined ? {} : { limits: config.limits }
+  };
 }
 function functionMutationResponse(expectation, response) {
   if (!response.ok)
@@ -10762,7 +10953,10 @@ function functionMutationResponse(expectation, response) {
     activation_id: confirmed.activationId,
     active_version: confirmed.activeVersion,
     version: confirmed.activeVersion,
-    verify_jwt: confirmed.verifyJwt
+    verify_jwt: confirmed.verifyJwt,
+    ...confirmed.framework === undefined ? {} : { framework: confirmed.framework },
+    ...confirmed.capabilities === undefined ? {} : { capabilities: confirmed.capabilities },
+    ...confirmed.limits === undefined ? {} : { limits: confirmed.limits }
   });
 }
 function readOnlyActivationResult() {
@@ -10824,13 +11018,13 @@ async function activateFunctionVersion(http, args, readOnly = false) {
 }
 function registerAdvancedTools(server, http, environment = process.env, options = {}) {
   server.tool("edge_functions", `Edge Function management (Deno/Bun serverless). Source deploys are bundled; verified prebuilt artifacts stay byte-exact.
-Actions: list, get_config, deploy, deploy_bundle, config, source, activate, delete, check`, {
-    action: withDescription(stringEnum(["list", "get_config", "deploy", "deploy_bundle", "config", "source", "activate", "delete", "check"]), "Action"),
-    ref: withDescription(Type.String(), "Project ref"),
+Actions: list, get_config, deploy, deploy_bundle, config, source, activate, delete, check, scaffold`, {
+    action: withDescription(stringEnum(["list", "get_config", "deploy", "deploy_bundle", "config", "source", "activate", "delete", "check", "scaffold"]), "Action"),
+    ref: optional(Type.String(), "Project ref (not used by scaffold)"),
     slug: optional(Type.String(), "[get_config/deploy/deploy_bundle/config/source/activate/delete/check] Function name"),
     version: withDescription(functionVersionSchema, "[source/activate] Existing immutable Function version; source requires a positive version"),
     code: optional(Type.String(), "[deploy/check] Function source code (TypeScript)"),
-    path: optional(Type.String(), "[deploy/check] Local file path to read code from (alternative to code)"),
+    path: optional(Type.String(), "[deploy/check] Source path; [scaffold] optional target directory"),
     "prebundled-path": optional(Type.String(), "[deploy] Prebuilt runtime bundle to upload without rebuilding; requires expected-sha256"),
     "expected-sha256": optional(Type.String({ pattern: SHA256_HEX_PATTERN.source, minLength: 64, maxLength: 64 }), "[deploy] Required lowercase SHA-256 of the exact prebundled-path bytes"),
     output: optional(Type.String(), "[source] Write source to this local file instead of stdout; the file must not already exist"),
@@ -10840,12 +11034,18 @@ Actions: list, get_config, deploy, deploy_bundle, config, source, activate, dele
     minify: optional(Type.Boolean(), "[deploy/deploy_bundle] Minify bundle"),
     verify_jwt: optional(Type.Boolean(), "[deploy/deploy_bundle/config] Set JWT verification for this function"),
     background_routes: withDescription(backgroundRoutesSchema, "[deploy/deploy_bundle/config] Background route paths; pass comma-separated or JSON array in CLI"),
+    framework: optional(withDescription(stringEnum(["fetch", "elysia", "hono", "sveltekit-function"]), "[deploy/deploy_bundle/config/scaffold] Fetch framework adapter profile")),
+    capabilities: optional(functionCapabilitiesSchema, "[deploy/deploy_bundle/config] Host capabilities: secrets, outbound_hosts, bindings, background"),
+    limits: optional(functionLimitsSchema, "[deploy/deploy_bundle/config] Execution limits in milliseconds/bytes"),
     "expected-active-version": withDescription(expectedActiveVersionSchema, "[deploy/deploy_bundle/activate] Required current active version, or 'absent' when none exists"),
     "expected-activation-id": withDescription(expectedActivationIdSchema, "[deploy/deploy_bundle/config/activate/delete] Required activation ID from list, or 'legacy' for a new or legacy function")
   }, async (args) => {
     if (args.action === "activate")
       return activateFunctionVersion(http, args, options.readOnly);
-    const { action, ref, slug, path: pathArg, output, entrypoint, minify, verify_jwt, background_routes } = args;
+    if (args.action === "scaffold") {
+      return { content: [{ type: "text", text: scaffoldFunction(args.path, args.slug, args.framework) }] };
+    }
+    const { action, ref, slug, path: pathArg, output, entrypoint, minify, verify_jwt, background_routes, framework, capabilities, limits } = args;
     rejectActionSpecificFlags(action, args);
     const expectedActiveVersion = action === "deploy" || action === "deploy_bundle" ? requiredExpectedActiveVersion(args, action) : undefined;
     const expectedActivationId = FUNCTION_IDENTITY_MUTATIONS.has(action) ? requiredExpectedActivationId(args, action) : undefined;
@@ -10857,7 +11057,10 @@ Actions: list, get_config, deploy, deploy_bundle, config, source, activate, dele
     let text;
     const functionConfig = () => ({
       ...typeof verify_jwt === "boolean" ? { verify_jwt } : {},
-      ...Array.isArray(background_routes) ? { background_routes } : {}
+      ...Array.isArray(background_routes) ? { background_routes } : {},
+      ...typeof framework === "string" ? { framework } : {},
+      ...capabilities === undefined ? {} : { capabilities },
+      ...limits === undefined ? {} : { limits }
     });
     const hasFunctionConfig = () => Object.keys(functionConfig()).length > 0;
     const checkSyntax = async (sourceCode) => {
@@ -10946,7 +11149,7 @@ ${deployCheck.err}`;
       case "config":
         need("slug", slug);
         if (!hasFunctionConfig()) {
-          throw new Error("'verify_jwt' or 'background_routes' required for 'config'");
+          throw new Error("'verify_jwt', 'background_routes', 'framework', 'capabilities', or 'limits' required for 'config'");
         }
         return updateFunctionConfiguration(http, {
           projectRef: ref,
@@ -13120,7 +13323,7 @@ function registerBranchTools(server, http, options = {}) {
 
 // src/shared/tools/supabase-cli-tools.ts
 import { spawn } from "node:child_process";
-import { chmodSync, existsSync as existsSync5, mkdirSync, statSync as statSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { chmodSync, existsSync as existsSync5, mkdirSync as mkdirSync2, statSync as statSync3, writeFileSync as writeFileSync2 } from "node:fs";
 import { dirname, isAbsolute, join as join3, resolve as resolve4 } from "node:path";
 var SENSITIVE_ENV_KEY = /(?:^|_)(?:PASSWORD|PASS|SECRET|TOKEN|KEY|CREDENTIALS?|AUTHORIZATION|AUTH|SESSION|COOKIE|BEARER|DB_URI|DB_URL|DSN|DATABASE_URL|DATABASE_URI|CONNECTION_STRING|CONNECTION_URI)(?:_|$)/i;
 var VALID_VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
@@ -13447,7 +13650,7 @@ async function executeOfficialAction(request, runtime) {
   const normalizedRequest = { ...request, workdir };
   const outputPath = actionOutputPath(normalizedRequest, workdir);
   if (outputPath)
-    mkdirSync(dirname(outputPath), { recursive: true });
+    mkdirSync2(dirname(outputPath), { recursive: true });
   const secrets = sensitiveValues(runtime.environment, request.db_url);
   const execution = await runtime.executeOfficialCli(normalizedRequest);
   if (execution.exitCode === 0 && request.action === "gen_types" && outputPath) {
@@ -13733,7 +13936,7 @@ import {
   cpSync,
   existsSync as existsSync7,
   lstatSync as lstatSync2,
-  mkdirSync as mkdirSync2,
+  mkdirSync as mkdirSync3,
   mkdtempSync as mkdtempSync2,
   readdirSync as readdirSync3,
   readFileSync as readFileSync5,
@@ -13780,7 +13983,7 @@ function availableBackupDirectory(destinationDirectory, now) {
   return candidate;
 }
 function stagedSkill(sourceDirectory, targetRoot) {
-  mkdirSync2(targetRoot, { recursive: true });
+  mkdirSync3(targetRoot, { recursive: true });
   const stagingRoot = mkdtempSync2(join5(targetRoot, ".supacloud-cli-install-"));
   const stagingSkill = join5(stagingRoot, SKILL_NAME);
   try {
@@ -14955,7 +15158,7 @@ function registerReleaseTools(server, http, options = {}) {
 // package.json
 var package_default = {
   name: "@supacloud/cli",
-  version: "0.35.1",
+  version: "0.37.0",
   description: "Project-scoped CLI for SupaCloud users",
   type: "module",
   main: "./dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/cli",
-  "version": "0.35.1",
+  "version": "0.37.0",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",