@synteq/cli 0.2.0 → 1.1.2

package/dist/functions-support/cron.js

@@ -0,0 +1,99 @@
+/** The five fields and their ranges — the backend's `_CRON_RANGES`
+ *  (routers/functions.py), in the same order. Day-of-week allows 0-7. */
+const CRON_FIELDS = [
+    { name: "minute", lo: 0, hi: 59 },
+    { name: "hour", lo: 0, hi: 23 },
+    { name: "day-of-month", lo: 1, hi: 31 },
+    { name: "month", lo: 1, hi: 12 },
+    { name: "day-of-week", lo: 0, hi: 7 },
+];
+/** The backend's `_CRON_FIELD_RE`: digits, `*`, `,`, `-` and `/` only — no
+ *  names (MON, JAN) and no `?`/`L`/`#`. */
+const CRON_FIELD_RE = /^[0-9*,/-]+$/;
+const DIGITS_RE = /^[0-9]+$/;
+/** A port of the backend's `_valid_cron_field`: comma-separated parts, each
+ *  `*`, `N` or `A-B` (A <= B, both in range), optionally `/STEP` (STEP >= 1). */
+export function validCronField(field, lo, hi) {
+    if (!field || !CRON_FIELD_RE.test(field))
+        return false;
+    for (const part of field.split(",")) {
+        if (!part)
+            return false;
+        const slash = part.indexOf("/");
+        const expr = slash === -1 ? part : part.slice(0, slash);
+        const step = slash === -1 ? "" : part.slice(slash + 1);
+        // A "/" always needs a number after it ("*/" is refused by the server
+        // and by the orchestrator's scheduler, where it never fires).
+        if (slash !== -1) {
+            if (!DIGITS_RE.test(step) || Number(step) < 1)
+                return false;
+        }
+        if (expr === "*")
+            continue;
+        const dash = expr.indexOf("-");
+        if (dash !== -1) {
+            const a = expr.slice(0, dash);
+            const b = expr.slice(dash + 1);
+            if (!DIGITS_RE.test(a) || !DIGITS_RE.test(b))
+                return false;
+            if (!(lo <= Number(a) && Number(a) <= Number(b) && Number(b) <= hi))
+                return false;
+        }
+        else if (!DIGITS_RE.test(expr) || Number(expr) < lo || Number(expr) > hi) {
+            return false;
+        }
+    }
+    return true;
+}
+/** A 5-field cron expression, evaluated in UTC by the dispatcher, checked
+ *  with the backend's own grammar (`_valid_cron`) so a schedule the server
+ *  would 422 is refused here, before any call — and first of all the mistake
+ *  a shell makes for you: an unquoted `*` expanding to filenames, or a
+ *  schedule split across arguments. Returns the whitespace-collapsed form. */
+export function normalizeSchedule(raw) {
+    const schedule = raw.trim().replace(/\s+/g, " ");
+    const fields = schedule.split(" ");
+    if (fields.length !== 5) {
+        throw new Error(`A schedule is 5 cron fields (minute hour day-of-month month day-of-week), got ${fields.length}: "${schedule}". ` +
+            `Quote it so the shell leaves the stars alone, e.g. "*/15 * * * *".`);
+    }
+    fields.forEach((f, i) => {
+        const { name, lo, hi } = CRON_FIELDS[i];
+        if (!validCronField(f, lo, hi)) {
+            throw new Error(`"${f}" isn't a valid ${name} field in "${schedule}": use ${lo}-${hi}, with digits, *, ",", "-" and "/" only (no names like MON or JAN).`);
+        }
+    });
+    return schedule;
+}
+/** Resolve a trigger by full id or a unique id prefix (the short id the list
+ *  prints). Throws a plain Error — user error, not an API fault. */
+export function resolveTrigger(triggers, ref) {
+    const needle = ref.trim().toLowerCase();
+    if (!needle)
+        throw new Error("Give a trigger id (see `synteq function cron list`).");
+    const exact = triggers.find((t) => t.id.toLowerCase() === needle);
+    if (exact)
+        return exact;
+    const matches = triggers.filter((t) => t.id.toLowerCase().startsWith(needle));
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length === 0) {
+        // UUIDv7 ids share a long time-ordered prefix, so the list prints the
+        // TAIL of the id; accept that too.
+        const tail = triggers.filter((t) => t.id.toLowerCase().endsWith(needle));
+        if (tail.length === 1)
+            return tail[0];
+        if (tail.length > 1) {
+            throw new Error(`"${ref}" matches ${tail.length} triggers — use more of the id.`);
+        }
+        throw new Error(`No cron trigger "${ref}" on this function (see \`synteq function cron list\`).`);
+    }
+    throw new Error(`"${ref}" matches ${matches.length} triggers — use more of the id.`);
+}
+/** The short id the list shows. UUIDv7 puts the timestamp first, so triggers
+ *  made minutes apart share their leading characters — the tail is what tells
+ *  them apart. */
+export function shortTriggerId(id) {
+    return id.slice(-8);
+}
+//# sourceMappingURL=cron.js.map

package/dist/functions-support/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/functions-support/cron.ts"],"names":[],"mappings":"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"}

package/dist/functions-support/env.d.ts

@@ -0,0 +1,23 @@
+/** A function env var key: what the backend accepts (`FnEnvVarSetIn.key`,
+ *  1..255 characters) minus what can't survive the CLI's KEY=VALUE form —
+ *  whitespace and `=`. The ONE rule: `function env set` and
+ *  `function deploy --env/--secret` (and its prompt) all check keys with it. */
+export declare const FN_ENV_KEY_RE: RegExp;
+/** Why `key` isn't a valid function env var name, or null when it is. */
+export declare function envKeyProblem(key: string): string | null;
+export type FnEnvKind = "config" | "secret";
+/** One env var to set on a function: what `function env set` sends. */
+export interface FnEnvAssignment {
+    key: string;
+    value: string;
+    kind: FnEnvKind;
+}
+/**
+ * Parse `KEY=VALUE` into an assignment. A leading `!` on the key marks a
+ * secret (`!API_KEY=sk-…`) — the first-run prompt's shorthand only. The
+ * scripted flags say the kind instead (`--env` config, `--secret` secret) and
+ * pass it as `kind`; a `!` there is refused rather than silently becoming
+ * part of the key. Throws a plain Error (a user error) on a malformed pair,
+ * with a message fit for a prompt validator or `this.error`.
+ */
+export declare function parseEnvAssignment(raw: string, kind?: FnEnvKind): FnEnvAssignment;

package/dist/functions-support/env.js

@@ -0,0 +1,44 @@
+/** A function env var key: what the backend accepts (`FnEnvVarSetIn.key`,
+ *  1..255 characters) minus what can't survive the CLI's KEY=VALUE form —
+ *  whitespace and `=`. The ONE rule: `function env set` and
+ *  `function deploy --env/--secret` (and its prompt) all check keys with it. */
+export const FN_ENV_KEY_RE = /^[^\s=]{1,255}$/;
+/** Why `key` isn't a valid function env var name, or null when it is. */
+export function envKeyProblem(key) {
+    if (!key)
+        return "Empty key. Provide KEY=VALUE.";
+    if (key.length > 255)
+        return `"${key.slice(0, 20)}…" is longer than 255 characters.`;
+    if (!FN_ENV_KEY_RE.test(key))
+        return `"${key}" isn't a valid name: no spaces or "=".`;
+    return null;
+}
+/**
+ * Parse `KEY=VALUE` into an assignment. A leading `!` on the key marks a
+ * secret (`!API_KEY=sk-…`) — the first-run prompt's shorthand only. The
+ * scripted flags say the kind instead (`--env` config, `--secret` secret) and
+ * pass it as `kind`; a `!` there is refused rather than silently becoming
+ * part of the key. Throws a plain Error (a user error) on a malformed pair,
+ * with a message fit for a prompt validator or `this.error`.
+ */
+export function parseEnvAssignment(raw, kind) {
+    let text = raw.trimStart();
+    let resolved = kind ?? "config";
+    if (text.startsWith("!")) {
+        if (kind !== undefined) {
+            throw new Error(`"${raw.trim()}": the ! secret prefix is only for the interactive prompt — pass --secret KEY=VALUE instead.`);
+        }
+        resolved = "secret";
+        text = text.slice(1);
+    }
+    const eq = text.indexOf("=");
+    if (eq <= 0) {
+        throw new Error(`"${raw.trim()}" isn't KEY=VALUE.`);
+    }
+    const key = text.slice(0, eq).trim();
+    const problem = envKeyProblem(key);
+    if (problem)
+        throw new Error(problem);
+    return { key, value: text.slice(eq + 1), kind: resolved };
+}
+//# sourceMappingURL=env.js.map

package/dist/functions-support/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/functions-support/env.ts"],"names":[],"mappings":"AAAA;;;gFAGgF;AAChF,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE/C,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,+BAA+B,CAAC;IACjD,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC;IACrF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,GAAG,yCAAyC,CAAC;IACtF,OAAO,IAAI,CAAC;AACd,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,IAAgB;IAC9D,IAAI,IAAI,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAC3B,IAAI,QAAQ,GAAc,IAAI,IAAI,QAAQ,CAAC;IAC3C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,IAAI,GAAG,CAAC,IAAI,EAAE,8FAA8F,CAC7G,CAAC;QACJ,CAAC;QACD,QAAQ,GAAG,QAAQ,CAAC;QACpB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5D,CAAC"}

package/dist/functions-support/link.d.ts

@@ -0,0 +1,25 @@
+import type { Clients } from "../api/factory.js";
+import { type AppLink } from "../config/store.js";
+import type { Fn } from "../api/types.js";
+/** Guidance when a command needs a function but the cwd isn't linked to one. */
+export declare function notLinkedFunctionError(hint: string): string;
+/**
+ * The function a command should act on: `--name` when given, else the
+ * directory's link (which must be a FUNCTION link — an app link is refused
+ * with a pointer at `synteq …` app commands rather than silently 404ing).
+ *
+ * Returns the resolved row plus the (possibly rescoped) clients, mirroring
+ * BaseCommand.resolveLinkedApp's side effect without reaching into the
+ * command. Callers assign `this.clients = clients`.
+ */
+export declare function resolveLinkedFunction(clients: Clients, flags: {
+    name?: string;
+    team?: string;
+    insecure?: boolean;
+}, cwd?: string): Promise<{
+    fn: Fn;
+    clients: Clients;
+    link?: AppLink;
+}>;
+/** Build the link record `synteq function init` writes for a directory. */
+export declare function functionLink(fn: Fn, teamId: string, projectId: string): AppLink;

package/dist/functions-support/link.js

@@ -0,0 +1,51 @@
+import { clientsForLinkTeam } from "../apps-support/link.js";
+import { linkKind } from "../config/store.js";
+import { resolveFunction } from "./resolve.js";
+/** Guidance when a command needs a function but the cwd isn't linked to one. */
+export function notLinkedFunctionError(hint) {
+    return [
+        "No function given and this directory isn't linked to one.",
+        `Run \`synteq function init <name>\` here for a one-time setup, or pass ${hint}.`,
+    ].join("\n");
+}
+/**
+ * The function a command should act on: `--name` when given, else the
+ * directory's link (which must be a FUNCTION link — an app link is refused
+ * with a pointer at `synteq …` app commands rather than silently 404ing).
+ *
+ * Returns the resolved row plus the (possibly rescoped) clients, mirroring
+ * BaseCommand.resolveLinkedApp's side effect without reaching into the
+ * command. Callers assign `this.clients = clients`.
+ */
+export async function resolveLinkedFunction(clients, flags, cwd = process.cwd()) {
+    let ref = flags.name;
+    let projectId;
+    let link;
+    let scoped = clients;
+    if (!ref) {
+        link = clients.config.linkFor(cwd);
+        if (!link)
+            throw new Error(notLinkedFunctionError("--name <slug>"));
+        if (linkKind(link) !== "function") {
+            throw new Error(`This directory is linked to the app "${link.app_slug}", not a function. ` +
+                "Use `synteq deploy` / `synteq app …` here, or pass --name <slug>.");
+        }
+        ref = link.app_id;
+        projectId = link.project_id;
+        scoped = clientsForLinkTeam(clients, link, flags);
+    }
+    const fn = await resolveFunction(scoped.api, ref, projectId);
+    return { fn, clients: scoped, link };
+}
+/** Build the link record `synteq function init` writes for a directory. */
+export function functionLink(fn, teamId, projectId) {
+    return {
+        kind: "function",
+        team_id: teamId,
+        project_id: projectId,
+        app_id: fn.id,
+        app_slug: fn.slug,
+        linked_at: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=link.js.map

package/dist/functions-support/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/functions-support/link.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAgB,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO;QACL,2DAA2D;QAC3D,0EAA0E,IAAI,GAAG;KAClF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgB,EAChB,KAA2D,EAC3D,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;IACrB,IAAI,SAA6B,CAAC;IAClC,IAAI,IAAyB,CAAC;IAC9B,IAAI,MAAM,GAAG,OAAO,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,eAAe,CAAC,CAAC,CAAC;QACpE,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,wCAAwC,IAAI,CAAC,QAAQ,qBAAqB;gBACxE,mEAAmE,CACtE,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QAClB,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QAC5B,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7D,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,EAAM,EAAE,MAAc,EAAE,SAAiB;IACpE,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,SAAS;QACrB,MAAM,EAAE,EAAE,CAAC,EAAE;QACb,QAAQ,EAAE,EAAE,CAAC,IAAI;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/functions-support/poll.d.ts

@@ -0,0 +1,40 @@
+import type { ApiClient } from "../api/client.js";
+import type { FnBuild, FnRelease } from "../api/types.js";
+/**
+ * Follow a function deploy to its end. Two phases, because the backend
+ * splits them: the BUILD row reaches succeeded/failed, then the status cron
+ * mints a RELEASE and flips it current once the orchestrator reports Live.
+ *
+ * CONTRACT:
+ *  - `waitForBuild` polls GET /functions/{id}/builds/{buildId} every
+ *    `intervalMs` (min 2000) until status ∈ {succeeded, failed} or
+ *    `timeoutMs` elapses (→ throws DeployTimeoutError). `onStatus` fires
+ *    once per status CHANGE (never per poll) so the command can print
+ *    transitions without spam.
+ *  - `waitForRelease` polls GET /functions/{id}/releases until a release
+ *    whose buildId === build.id exists AND isCurrent, or one exists with a
+ *    failed-looking status (→ returns it; the command decides), or timeout.
+ *  - Both honour an AbortSignal for Ctrl-C.
+ */
+export declare const BUILD_TERMINAL: Set<string>;
+/**
+ * Release statuses that end the wait WITHOUT the release ever going current.
+ * `waitForRelease` RETURNS these rather than throwing — the command reports
+ * the outcome (and, for `failed`/`*_failed`, points at the build logs).
+ */
+export declare const RELEASE_TERMINAL_BAD: Set<string>;
+/** Floor on the poll interval, so a caller can't hammer the API. */
+export declare const MIN_INTERVAL_MS = 2000;
+export declare class DeployTimeoutError extends Error {
+    constructor(phase: "build" | "release", after: number);
+}
+export interface PollOpts {
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    onStatus?: (status: string, build: FnBuild) => void;
+}
+export declare function waitForBuild(api: ApiClient, fnId: string, buildId: string, opts?: PollOpts): Promise<FnBuild>;
+export declare function waitForRelease(api: ApiClient, fnId: string, buildId: string, opts?: Omit<PollOpts, "onStatus"> & {
+    onStatus?: (status: string, rel: FnRelease) => void;
+}): Promise<FnRelease>;

package/dist/functions-support/poll.js

@@ -0,0 +1,109 @@
+/**
+ * Follow a function deploy to its end. Two phases, because the backend
+ * splits them: the BUILD row reaches succeeded/failed, then the status cron
+ * mints a RELEASE and flips it current once the orchestrator reports Live.
+ *
+ * CONTRACT:
+ *  - `waitForBuild` polls GET /functions/{id}/builds/{buildId} every
+ *    `intervalMs` (min 2000) until status ∈ {succeeded, failed} or
+ *    `timeoutMs` elapses (→ throws DeployTimeoutError). `onStatus` fires
+ *    once per status CHANGE (never per poll) so the command can print
+ *    transitions without spam.
+ *  - `waitForRelease` polls GET /functions/{id}/releases until a release
+ *    whose buildId === build.id exists AND isCurrent, or one exists with a
+ *    failed-looking status (→ returns it; the command decides), or timeout.
+ *  - Both honour an AbortSignal for Ctrl-C.
+ */
+export const BUILD_TERMINAL = new Set(["succeeded", "failed"]);
+/**
+ * Release statuses that end the wait WITHOUT the release ever going current.
+ * `waitForRelease` RETURNS these rather than throwing — the command reports
+ * the outcome (and, for `failed`/`*_failed`, points at the build logs).
+ */
+export const RELEASE_TERMINAL_BAD = new Set([
+    "failed",
+    "health_failed",
+    "start_failed",
+    "superseded",
+]);
+/** Floor on the poll interval, so a caller can't hammer the API. */
+export const MIN_INTERVAL_MS = 2000;
+const DEFAULT_INTERVAL_MS = 3000;
+const DEFAULT_TIMEOUT_MS = 600_000;
+export class DeployTimeoutError extends Error {
+    constructor(phase, after) {
+        super(`Timed out after ${Math.round(after / 1000)}s waiting for the ${phase}.`);
+        this.name = "DeployTimeoutError";
+    }
+}
+/** The reason an aborted wait rejects with — the signal's, or a plain Error. */
+function abortReason(signal) {
+    return signal.reason ?? new Error("aborted");
+}
+/** Sleep `ms`, rejecting early (and clearing the timer) if `signal` aborts. */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortReason(signal));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortReason(signal));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export async function waitForBuild(api, fnId, buildId, opts = {}) {
+    const interval = Math.max(MIN_INTERVAL_MS, opts.intervalMs ?? DEFAULT_INTERVAL_MS);
+    const timeout = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const started = Date.now();
+    let last;
+    for (;;) {
+        if (opts.signal?.aborted)
+            throw abortReason(opts.signal);
+        const build = await api.functions.build(fnId, buildId);
+        if (build.status !== last) {
+            last = build.status;
+            opts.onStatus?.(build.status, build);
+        }
+        if (BUILD_TERMINAL.has(build.status))
+            return build;
+        const elapsed = Date.now() - started;
+        if (elapsed >= timeout)
+            throw new DeployTimeoutError("build", elapsed);
+        await sleep(interval, opts.signal);
+    }
+}
+export async function waitForRelease(api, fnId, buildId, opts = {}) {
+    const interval = Math.max(MIN_INTERVAL_MS, opts.intervalMs ?? DEFAULT_INTERVAL_MS);
+    const timeout = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const started = Date.now();
+    let last;
+    for (;;) {
+        if (opts.signal?.aborted)
+            throw abortReason(opts.signal);
+        const releases = await api.functions.releases(fnId);
+        const mine = releases.filter((r) => r.buildId === buildId);
+        // Newest first, so a rebuild that minted two rows reports the latest.
+        mine.sort((a, b) => b.number - a.number);
+        const current = mine.find((r) => r.isCurrent);
+        const bad = mine.find((r) => RELEASE_TERMINAL_BAD.has(r.status));
+        const decided = current ?? bad;
+        if (mine.length > 0 && mine[0].status !== last) {
+            last = mine[0].status;
+            opts.onStatus?.(mine[0].status, mine[0]);
+        }
+        if (decided)
+            return decided;
+        const elapsed = Date.now() - started;
+        if (elapsed >= timeout)
+            throw new DeployTimeoutError("release", elapsed);
+        await sleep(interval, opts.signal);
+    }
+}
+//# sourceMappingURL=poll.js.map

package/dist/functions-support/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../../src/functions-support/poll.ts"],"names":[],"mappings":"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"}

package/dist/functions-support/resolve.d.ts

@@ -0,0 +1,3 @@
+import { type ApiClient } from "../api/client.js";
+import type { Fn } from "../api/types.js";
+export declare function resolveFunction(api: ApiClient, ref: string, projectId?: string): Promise<Fn>;

package/dist/functions-support/resolve.js

@@ -0,0 +1,31 @@
+import { pageThrough } from "../api/client.js";
+import { idPrefixMatches, isIdPrefix } from "../apps-support/resolve.js";
+/**
+ * Resolve a function reference (slug OR uuid) to a full Fn row — the
+ * functions twin of apps-support/resolve.ts. A uuid goes straight to
+ * GET /functions/{id}; anything else is a slug asked of the server with
+ * `q=<slug>` (name / slug / hostname search, portal #419) and exact-matched
+ * here. An id prefix is not something `q` searches, so that walks every
+ * page of the project's list.
+ *
+ * Throws a plain Error (a user error the command surfaces as exit 1); an
+ * API fault is an ApiError and propagates to `this.fail`.
+ */
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export async function resolveFunction(api, ref, projectId) {
+    if (UUID_RE.test(ref))
+        return api.functions.get(ref);
+    const bySlug = await pageThrough((page) => api.functions.listPage(projectId, { q: ref, page }), (page) => page.items.some((f) => f.slug === ref));
+    let matches = bySlug.filter((f) => f.slug === ref);
+    if (matches.length === 0 && isIdPrefix(ref)) {
+        const all = await pageThrough((page) => api.functions.listPage(projectId, { page }));
+        matches = idPrefixMatches(all, ref, "function");
+    }
+    if (matches.length === 0) {
+        throw new Error(`No function named "${ref}" in the active project. Run \`synteq function list\` to see available functions.`);
+    }
+    if (matches.length > 1)
+        matches.sort((a, b) => b.id.localeCompare(a.id));
+    return matches[0];
+}
+//# sourceMappingURL=resolve.js.map

package/dist/functions-support/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/functions-support/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAc,EAAE,GAAW,EAAE,SAAkB;IACnF,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAC7D,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CACjD,CAAC;IACF,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrF,OAAO,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,mFAAmF,CAC7G,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/functions-support/runtime.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Runtime knowledge the CLI needs offline: which handler filenames belong to
+ * which runtime, and the starter each `synteq function init` scaffolds.
+ *
+ * HANDLER_ENTRIES mirrors the BACKEND's table verbatim
+ * (portal/backend/app/services/functions/source_shape.py::HANDLER_ENTRIES),
+ * in the same order, so what the CLI infers from a directory is what the
+ * build's shaping step will conclude from the same files. The two sets are
+ * disjoint by extension, which is what makes inference sound.
+ */
+export declare const RUNTIMES: readonly ["node22", "python312"];
+export type Runtime = (typeof RUNTIMES)[number];
+export declare const RUNTIME_LABELS: Record<Runtime, string>;
+export declare const HANDLER_ENTRIES: Record<Runtime, readonly string[]>;
+/**
+ * The runtime a set of ROOT-relative paths is written against, or null when
+ * they do not say: no recognised entry, a Dockerfile (that build path never
+ * consults the runtime), or entries for both runtimes at once.
+ */
+export declare function inferRuntime(paths: string[]): Runtime | null;
+/** The first entry filename per runtime — what `init` writes. */
+export declare function entryFor(runtime: Runtime): string;
+/**
+ * Starter handlers. The node one is byte-identical to the portal editor's
+ * seed (frontend/lib/functions/files.ts STARTER) so a function scaffolded
+ * from the terminal and one pasted in the browser start from the same file.
+ * Both are HANDLERS, not servers: the platform's shim owns the listener and
+ * imports this file expecting a default export (node) or `handler` (python).
+ */
+export declare const STARTERS: Record<Runtime, string>;

package/dist/functions-support/runtime.js

@@ -0,0 +1,52 @@
+/**
+ * Runtime knowledge the CLI needs offline: which handler filenames belong to
+ * which runtime, and the starter each `synteq function init` scaffolds.
+ *
+ * HANDLER_ENTRIES mirrors the BACKEND's table verbatim
+ * (portal/backend/app/services/functions/source_shape.py::HANDLER_ENTRIES),
+ * in the same order, so what the CLI infers from a directory is what the
+ * build's shaping step will conclude from the same files. The two sets are
+ * disjoint by extension, which is what makes inference sound.
+ */
+export const RUNTIMES = ["node22", "python312"];
+export const RUNTIME_LABELS = {
+    node22: "Node.js 22",
+    python312: "Python 3.12",
+};
+export const HANDLER_ENTRIES = {
+    node22: ["index.mjs", "index.js", "handler.mjs", "handler.js", "main.mjs", "main.js"],
+    python312: ["handler.py", "main.py", "index.py", "app.py"],
+};
+/**
+ * The runtime a set of ROOT-relative paths is written against, or null when
+ * they do not say: no recognised entry, a Dockerfile (that build path never
+ * consults the runtime), or entries for both runtimes at once.
+ */
+export function inferRuntime(paths) {
+    const names = new Set(paths.map((p) => p.replace(/^\.\//, "").trim()).filter(Boolean));
+    if (names.has("Dockerfile"))
+        return null;
+    const hits = RUNTIMES.filter((rt) => HANDLER_ENTRIES[rt].some((e) => names.has(e)));
+    return hits.length === 1 ? hits[0] : null;
+}
+/** The first entry filename per runtime — what `init` writes. */
+export function entryFor(runtime) {
+    return HANDLER_ENTRIES[runtime][0];
+}
+/**
+ * Starter handlers. The node one is byte-identical to the portal editor's
+ * seed (frontend/lib/functions/files.ts STARTER) so a function scaffolded
+ * from the terminal and one pasted in the browser start from the same file.
+ * Both are HANDLERS, not servers: the platform's shim owns the listener and
+ * imports this file expecting a default export (node) or `handler` (python).
+ */
+export const STARTERS = {
+    node22: `export default async function handler(event, context) {
+  return { hello: "world", path: event.path };
+}
+`,
+    python312: `def handler(event, context):
+    return {"hello": "world", "path": event["path"]}
+`,
+};
+//# sourceMappingURL=runtime.js.map

package/dist/functions-support/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/functions-support/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAU,CAAC;AAGzD,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,aAAa;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAuC;IACjE,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC;IACrF,SAAS,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC;CAC3D,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA4B;IAC/C,MAAM,EAAE;;;CAGT;IACC,SAAS,EAAE;;CAEZ;CACA,CAAC"}

package/dist/functions-support/source.d.ts

@@ -0,0 +1,92 @@
+import type { FnSourceFile } from "../api/types.js";
+/**
+ * Collect a directory into the `files` shape POST /functions/{id}/deploys/source
+ * takes: plain UTF-8 text files, root-relative slash paths, sorted.
+ *
+ * CONTRACT (the deploy command depends on every line of this):
+ *  - Walks `dir` recursively. Skips, at any depth: node_modules, .git,
+ *    .synteq (reserved for the platform shim — the backend refuses it),
+ *    __pycache__, .venv, venv, dist, build, target, .DS_Store, *.log,
+ *    dotenv files (`.env`, `.env.*` except `.env.example` / `.env.sample` /
+ *    `.env.template`; reason "dotenv", no opt-in), and anything matched by
+ *    a `.synteqignore` in `dir` (gitignore-style globs, one per line, `#`
+ *    comments) when one exists.
+ *  - Skips binary files (a NUL byte in the first 8 KiB) and any single file
+ *    larger than the whole source cap — each skip is reported in `skipped`
+ *    with a reason so the command can print them, never silently dropped.
+ *  - Refuses paths longer than 255 chars or containing `..` (backend limits).
+ *  - Enforces `maxFiles` on the number of collected files (the backend's
+ *    bundle member ceiling, `Fn.maxSourceFiles`; MAX_SOURCE_FILES without
+ *    one). Over it throws SourceTooManyFilesError naming the limit.
+ *  - Enforces `maxTotalBytes` on the sum of UTF-8 content. The caller passes
+ *    the backend's LIVE cap (`Fn.maxSourceBytes`, admin-editable); without
+ *    one, MAX_TOTAL_BYTES is the backend's own default. Over it throws
+ *    SourceTooLargeError naming the total and the largest offenders so the
+ *    user knows what to exclude.
+ *  - Never follows symlinks.
+ *  - Returns files sorted by path so a re-run of an unchanged tree produces
+ *    an identical payload.
+ */
+/**
+ * Fallback source ceiling, used only when the API row carries no
+ * `maxSourceBytes` (an older backend). Mirrors the backend's
+ * `DEFAULT_MAX_FUNCTION_SOURCE_MB` (5 MB); the live number is what an admin
+ * set in portal settings and rides on every GET /functions row.
+ */
+export declare const MAX_TOTAL_BYTES = 5000000;
+/**
+ * Fallback file-count ceiling, used only when the API row carries no
+ * `maxSourceFiles` (an older backend). Mirrors the backend's
+ * `source_shape.MAX_TARBALL_MEMBERS`.
+ */
+export declare const MAX_SOURCE_FILES = 4096;
+/**
+ * The editor's inline `files` shape takes at most this many files
+ * (`functions_deploys._MAX_SOURCE_FILES`). A tree that fits is sent that way
+ * so the deployed source stays re-openable in the portal editor; a larger one
+ * goes up as a tarball (`sourceB64`), which only the caps above bound.
+ */
+export declare const EDITOR_MAX_FILES = 32;
+export interface CollectOptions {
+    /** The backend's source cap for this function, in bytes. */
+    maxTotalBytes?: number;
+    /** The backend's file-count cap for this function. */
+    maxFiles?: number;
+}
+export interface SkippedFile {
+    path: string;
+    reason: "binary" | "too-large" | "ignored" | "dotenv" | "symlink" | "bad-path";
+}
+export interface CollectedSource {
+    files: FnSourceFile[];
+    skipped: SkippedFile[];
+    totalBytes: number;
+}
+export declare class SourceTooLargeError extends Error {
+    readonly totalBytes: number;
+    readonly largest: {
+        path: string;
+        bytes: number;
+    }[];
+    readonly limitBytes: number;
+    constructor(totalBytes: number, largest: {
+        path: string;
+        bytes: number;
+    }[], limitBytes?: number);
+}
+export declare class SourceTooManyFilesError extends Error {
+    readonly fileCount: number;
+    readonly limitFiles: number;
+    constructor(fileCount: number, limitFiles?: number);
+}
+interface IgnoreRule {
+    re: RegExp;
+    /** Trailing "/" — only matches directories. */
+    dirOnly: boolean;
+    /** Leading "/" or an interior "/" — matched against the full root-relative path. */
+    anchored: boolean;
+}
+export declare function parseIgnoreFile(text: string): IgnoreRule[];
+export declare function collectSourceFiles(dir: string, opts?: CollectOptions): Promise<CollectedSource>;
+export declare function tarballFromFiles(files: FnSourceFile[]): Buffer;
+export {};