@zuvo/cli 0.1.6 → 0.1.7

package/README.md

@@ -8,6 +8,9 @@ zuvo login
 zuvo projects list
 zuvo link --project <ref>
 zuvo functions deploy
+zuvo functions logs
+zuvo functions logs hello --since 6h
+zuvo functions logs -f
 zuvo secrets set OPENAI_API_KEY=sk-…
 zuvo secrets set --env-file ./supabase/.env.local
 zuvo secrets list

package/dist/hosting.js

@@ -56,3 +56,33 @@ export function hostingLogsSql(limit) {
     const safe = Math.min(Math.max(1, Math.floor(limit)), 5_000);
     return `select id, timestamp, event_message from hosting_logs order by timestamp desc limit ${safe}`;
 }
+/** Slug or UUID safe to embed in analytics SQL. */
+export function assertSafeFunctionKey(key) {
+    const trimmed = key.trim();
+    if (!/^[a-zA-Z0-9_-]{1,128}$/.test(trimmed)) {
+        throw new Error(`Invalid function name: ${key} (use slug or UUID: letters, digits, _, -)`);
+    }
+    return trimmed;
+}
+export function functionLogsSql(limit, functionKey) {
+    const safe = Math.min(Math.max(1, Math.floor(limit)), 5_000);
+    const where = functionKey
+        ? ` where metadata.function_id = '${assertSafeFunctionKey(functionKey)}'`
+        : '';
+    return `select id, timestamp, event_message from function_logs${where} order by timestamp desc limit ${safe}`;
+}
+export function formatFunctionLogLine(row) {
+    const ts = formatLogTimestamp(row.timestamp);
+    const metaFn = row.metadata && typeof row.metadata.function_id === 'string'
+        ? row.metadata.function_id
+        : '';
+    const fn = row.function_id || metaFn;
+    const bits = [
+        ts,
+        fn ? `[${fn}]` : '',
+        row.method || '',
+        row.status_code != null ? String(row.status_code) : '',
+        row.event_message ?? '',
+    ].filter(Boolean);
+    return bits.join('  ');
+}

package/dist/index.js

@@ -4,7 +4,7 @@ import { apiRequest, ApiError } from './api.js';
 import { argvAfterCommand } from './argv.js';
 import { apiUrlFromEnv, deleteAccessToken, isAccessToken, requireLinkedRef, saveLinkedRef, } from './config.js';
 import { encodeFunctionForm, listFunctionSlugs, loadFunctionBundle } from './functions.js';
-import { formatHostingLogLine, formatLogTimestamp, hostingLogsSql, parseSince, sortLogsChronological, } from './hosting.js';
+import { formatFunctionLogLine, formatHostingLogLine, formatLogTimestamp, functionLogsSql, hostingLogsSql, parseSince, sortLogsChronological, } from './hosting.js';
 import { loginBrowser, loginWithToken } from './login.js';
 import { loadLocalMigrations, pendingMigrations } from './migrations.js';
 import { loadSecretsEnvFile, parseSecretArgs } from './secrets.js';
@@ -18,6 +18,7 @@ Commands:
   link --project <ref>
   functions list
   functions deploy [slug]
+  functions logs [slug] [--limit N] [--since 1h|30m|ISO] [-f|--follow]
   secrets list
   secrets set NAME=VALUE [NAME=VALUE ...]
   secrets set --env-file <path>
@@ -151,6 +152,84 @@ async function deployOne(apiUrl, ref, slug) {
     const meta = await apiRequest(apiUrl, 'POST', `/v1/projects/${ref}/functions/deploy`, { form, query: { slug: bundle.slug } });
     console.log(`Deployed ${meta.slug || bundle.slug}${meta.version != null ? ` (v${meta.version})` : ''}`);
 }
+async function fetchFunctionLogs(apiUrl, ref, opts) {
+    const body = {
+        sql: functionLogsSql(opts.limit, opts.functionKey),
+    };
+    if (opts.since)
+        body.iso_timestamp_start = opts.since.toISOString();
+    const data = await apiRequest(apiUrl, 'POST', `/platform/projects/${ref}/analytics/endpoints/logs.all`, { json: body });
+    return Array.isArray(data?.result) ? data.result : [];
+}
+async function cmdFunctionsLogs(apiUrl, argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            limit: { type: 'string' },
+            since: { type: 'string' },
+            follow: { type: 'boolean', short: 'f' },
+            'api-url': { type: 'string' },
+        },
+        allowPositionals: true,
+        strict: false,
+    });
+    const ref = await requireLinkedRef();
+    const functionKey = positionals.find((arg) => !arg.startsWith('-'));
+    const limitRaw = typeof values.limit === 'string' ? Number(values.limit) : 100;
+    const limit = Number.isFinite(limitRaw) ? limitRaw : 100;
+    const since = typeof values.since === 'string' && values.since.trim()
+        ? parseSince(values.since)
+        : parseSince('1h');
+    const follow = Boolean(values.follow);
+    const seen = new Set();
+    const printNew = (rows) => {
+        for (const row of sortLogsChronological(rows)) {
+            const key = row.id || `${formatFunctionLogLine(row)}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            console.log(formatFunctionLogLine(row));
+        }
+    };
+    const initial = await fetchFunctionLogs(apiUrl, ref, {
+        limit,
+        since,
+        functionKey,
+    });
+    if (!initial.length && !follow) {
+        console.log(functionKey
+            ? `No edge function logs for ${functionKey} in range.`
+            : 'No edge function logs in range.');
+        return;
+    }
+    printNew(initial);
+    if (!follow)
+        return;
+    let cursor = since;
+    for (const row of sortLogsChronological(initial)) {
+        const iso = formatLogTimestamp(row.timestamp);
+        const parsed = iso ? new Date(iso) : null;
+        if (parsed && !Number.isNaN(parsed.getTime()) && parsed > cursor)
+            cursor = parsed;
+    }
+    console.error('Following edge function logs… (Ctrl+C to stop)');
+    for (;;) {
+        await new Promise((r) => setTimeout(r, 2_500));
+        const nextSince = new Date(Math.max(0, cursor.getTime() - 1_000));
+        const rows = await fetchFunctionLogs(apiUrl, ref, {
+            limit: Math.max(limit, 200),
+            since: nextSince,
+            functionKey,
+        });
+        printNew(rows);
+        for (const row of sortLogsChronological(rows)) {
+            const iso = formatLogTimestamp(row.timestamp);
+            const parsed = iso ? new Date(iso) : null;
+            if (parsed && !Number.isNaN(parsed.getTime()) && parsed > cursor)
+                cursor = parsed;
+        }
+    }
+}
 async function cmdFunctionsDeploy(apiUrl, argv) {
     const ref = await requireLinkedRef();
     const slug = argv.find((arg) => !arg.startsWith('-'));
@@ -599,6 +678,8 @@ async function main() {
             await cmdFunctionsList(apiUrl);
         else if (command === 'functions' && sub === 'deploy')
             await cmdFunctionsDeploy(apiUrl, argvAfterCommand(argv, 'functions', 'deploy'));
+        else if (command === 'functions' && sub === 'logs')
+            await cmdFunctionsLogs(apiUrl, argvAfterCommand(argv, 'functions', 'logs'));
         else if (command === 'secrets' && (sub === 'list' || !sub))
             await cmdSecretsList(apiUrl);
         else if (command === 'secrets' && sub === 'set')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zuvo/cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "description": "Zuvo CLI — login, link, functions/hosting deploy, secrets, env, db push, and logs",
   "license": "MIT",