@synteq/cli 0.2.0 → 1.1.1

package/dist/commands/function/init.js

@@ -0,0 +1,269 @@
+import { Args, Flags } from "@oclif/core";
+import { existsSync, statSync, readdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { BaseCommand } from "../../base/command.js";
+import { panel, isInteractive } from "../../ui/wizard.js";
+import { ensurePaymentMethod, PaymentMethodRequired } from "../../ui/payment-gate.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { ok, dim, statusColor } from "../../ui/glyphs.js";
+import { resolveFunction } from "../../functions-support/resolve.js";
+import { functionLink } from "../../functions-support/link.js";
+import { linkKind } from "../../config/store.js";
+import { HANDLER_ENTRIES, RUNTIMES, RUNTIME_LABELS, STARTERS, entryFor, inferRuntime, } from "../../functions-support/runtime.js";
+/**
+ * `synteq function init` — one command from an empty directory to a function
+ * you can deploy. It is the second step of the grammar the portal's New
+ * Function wizard prints:
+ *
+ *     synteq login
+ *     synteq function init <slug>
+ *     synteq function deploy --name <slug>
+ *
+ * Three things happen, each skipped when already done, so re-running is a
+ * no-op that says so:
+ *  1. The function is reused when a function with that slug already exists,
+ *     otherwise the name is checked (POST /functions/check-name) and created.
+ *  2. A starter handler is written when the directory has neither a
+ *     recognised handler entry nor a Dockerfile. An existing file is never
+ *     overwritten.
+ *  3. The directory is linked to the function, so every later
+ *     `synteq function …` in this tree resolves it without --name.
+ */
+export default class FunctionInit extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Scaffold a function in this directory and link it for flag-free deploys.",
+        "",
+        "Reuses an existing function of the same name, otherwise creates one. Writes",
+        "a starter handler only when the directory has no recognised entry file and",
+        "no Dockerfile — an existing file is never overwritten. Re-running is a",
+        "no-op that reports what was already in place.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> function init my-fn",
+        "<%= config.bin %> function init my-fn --runtime python312",
+        "<%= config.bin %> function init my-fn --dir ./api --location dfw",
+        "<%= config.bin %> function init my-fn --no-scaffold   # link only; bring your own handler",
+        "<%= config.bin %> function init my-fn -o json",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function name/slug. Optional when this directory is already linked to a function.",
+        }),
+    };
+    static flags = {
+        runtime: Flags.string({
+            options: [...RUNTIMES],
+            description: `Handler runtime for a newly created function: ${RUNTIMES.join(" or ")} (default: node22, or whatever the directory's files already imply).`,
+        }),
+        plan: Flags.string({
+            description: "Plan tier slug for a newly created function (default: the first tier in the catalog).",
+        }),
+        location: Flags.string({
+            description: "Location code, e.g. dfw, for a newly created function (default: the first location).",
+        }),
+        dir: Flags.string({
+            description: "Directory to scaffold and link (default: the current directory).",
+        }),
+        "no-scaffold": Flags.boolean({
+            description: "Don't write a starter handler; only create/reuse the function and link the directory.",
+        }),
+        project: Flags.string({
+            description: "Project id to create/look the function up in (defaults to the active project).",
+        }),
+        "from-deploy": Flags.boolean({
+            hidden: true,
+            description: "Internal: called by `function deploy` on a first run; skips the next-steps hint.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionInit);
+        try {
+            const dir = resolve(flags.dir && flags.dir !== "" ? flags.dir : ".");
+            if (!existsSync(dir) || !statSync(dir).isDirectory()) {
+                this.error(`Not a directory: ${dir}`, { exit: 1 });
+            }
+            // A name is optional only when this directory already points at a function.
+            const existingLink = this.clients.config.linkFor(dir);
+            let name = args.name;
+            if (!name) {
+                if (existingLink && linkKind(existingLink) === "function") {
+                    name = existingLink.app_slug;
+                }
+                else {
+                    this.error("Give the function a name: `synteq function init <name>`. (A name is optional only in a directory already linked to a function.)", { exit: 1 });
+                }
+            }
+            // 1. Reuse or create.
+            const topLevel = readdirSync(dir);
+            const inferred = inferRuntime(topLevel);
+            const runtime = flags.runtime ?? inferred ?? "node22";
+            let fn;
+            let created = false;
+            const found = await resolveFunction(this.clients.api, name, flags.project).catch((e) => {
+                // A plain Error is "no such function" — the create path. An ApiError
+                // (has `status`) is a real fault and must propagate.
+                if (e instanceof Error && !("status" in e))
+                    return null;
+                throw e;
+            });
+            if (found) {
+                fn = found;
+            }
+            else {
+                const check = await withSpinner(`Checking ${name}`, () => this.clients.api.functions.checkName(name));
+                if (!check.available) {
+                    this.error(`The name "${name}" isn't available${check.reason ? `: ${check.reason}` : "."}`, { exit: 1 });
+                }
+                // Every tier needs a payment method on the team, free included.
+                await ensurePaymentMethod({
+                    api: this.clients.api,
+                    apiBaseUrl: this.clients.config.get().api_base_url,
+                    interactive: isInteractive() && this.outputFormat === "table",
+                    log: (l) => this.log(l),
+                    action: "create the function",
+                }).catch((e) => {
+                    if (e instanceof PaymentMethodRequired)
+                        this.error(e.message, { exit: 1 });
+                    throw e;
+                });
+                const body = {
+                    name: name,
+                    planTier: flags.plan ?? (await this.defaultPlan()),
+                    runtime,
+                };
+                const locationId = await this.resolveLocation(flags.location);
+                if (locationId)
+                    body.locationId = locationId;
+                fn = await withSpinner(`Creating ${name}`, () => this.clients.api.functions.create(body, flags.project));
+                created = true;
+            }
+            // 2. Scaffold, unless the directory already says what it runs.
+            const fnRuntime = RUNTIMES.includes(fn.runtime)
+                ? fn.runtime
+                : runtime;
+            const hasDockerfile = topLevel.includes("Dockerfile");
+            let entryFile = null;
+            let entryKept = false;
+            if (flags["no-scaffold"]) {
+                // nothing to write
+            }
+            else if (inferred || hasDockerfile) {
+                entryKept = true;
+                entryFile = inferred ? this.existingEntry(topLevel, inferred) : "Dockerfile";
+            }
+            else {
+                const candidate = entryFor(fnRuntime);
+                const target = join(dir, candidate);
+                if (existsSync(target)) {
+                    // A file with the entry name exists but wasn't recognised as an
+                    // entry (e.g. a directory named index.mjs). Never clobber it.
+                    entryKept = true;
+                    entryFile = candidate;
+                }
+                else {
+                    writeFileSync(target, STARTERS[fnRuntime], { encoding: "utf8", flag: "wx" });
+                    entryFile = candidate;
+                }
+            }
+            // 3. Link the directory.
+            const alreadyLinked = existingLink !== undefined &&
+                linkKind(existingLink) === "function" &&
+                existingLink.app_id === fn.id;
+            const teamId = await this.resolveTeamId();
+            const projectId = flags.project ?? existingLink?.project_id ?? (await this.resolveProjectId(teamId));
+            this.clients.config.setLink(dir, functionLink(fn, teamId, projectId));
+            const payload = {
+                directory: dir,
+                created,
+                alreadyLinked,
+                entryFile,
+                entryWritten: Boolean(entryFile) && !entryKept,
+                function: fn,
+            };
+            this.emit(payload, () => {
+                const noop = !created && alreadyLinked && (entryKept || !entryFile);
+                this.log("");
+                this.log(panel(created ? "Function created" : noop ? "Already set up" : "Function linked", [
+                    ["Slug", fn.slug],
+                    ["Hostname", fn.hostname],
+                    ["Status", statusColor(fn.status)],
+                    ["Runtime", `${fn.runtime} ${dim(RUNTIME_LABELS[fnRuntime] ?? "")}`.trim()],
+                    ["Directory", dir],
+                    [
+                        "Entry",
+                        entryFile
+                            ? entryKept
+                                ? `${entryFile} ${dim("(kept existing)")}`
+                                : `${entryFile} ${dim("(written)")}`
+                            : dim("no scaffold"),
+                    ],
+                ]));
+                this.log("");
+                if (noop)
+                    this.log(dim("Nothing to do — this directory was already initialised."));
+                if (!flags["from-deploy"]) {
+                    this.log(ok(`Deploy it: synteq function deploy --name ${fn.slug}`));
+                    this.log(dim("  (or just `synteq function deploy` from this directory)"));
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+    /** Which recognised entry filename the directory actually carries — the
+     *  first HANDLER_ENTRIES hit, i.e. the one the backend's shaping step picks. */
+    existingEntry(names, rt) {
+        const set = new Set(names);
+        return HANDLER_ENTRIES[rt].find((e) => set.has(e)) ?? entryFor(rt);
+    }
+    async defaultPlan() {
+        const plans = await this.clients.api.functions.plans();
+        if (plans.length === 0) {
+            this.error("No function plans are available on this account.", { exit: 1 });
+        }
+        return plans[0].name;
+    }
+    async resolveLocation(code) {
+        const locations = await this.clients.api.functions.locations();
+        if (locations.length === 0) {
+            if (code)
+                this.error(`Unknown location "${code}" — no locations are available.`, { exit: 1 });
+            return undefined;
+        }
+        if (!code)
+            return locations[0].locationId;
+        const hit = locations.find((l) => l.code.toLowerCase() === code.toLowerCase());
+        if (!hit) {
+            this.error(`Unknown location "${code}". Available: ${locations.map((l) => l.code).join(", ")}.`, { exit: 1 });
+        }
+        return hit.locationId;
+    }
+    /** The team the link records: the active team, else the default team. */
+    async resolveTeamId() {
+        const configured = this.clients.config.get().active_team_id;
+        if (configured)
+            return configured;
+        const teams = await this.clients.api.auth.teams();
+        if (teams.length === 0) {
+            this.error("No teams on this account — sign in to the portal to create one.", { exit: 1 });
+        }
+        return (teams.find((t) => t.is_default) ?? teams[0]).id;
+    }
+    /** The project the link records: the configured default, else the team's. */
+    async resolveProjectId(teamId) {
+        const configured = this.clients.config.get().default_project_id;
+        if (configured)
+            return configured;
+        const projects = await this.clients.api.projects.list();
+        const inTeam = projects.filter((p) => !teamId || p.team_id === teamId);
+        const pool = inTeam.length > 0 ? inTeam : projects;
+        if (pool.length === 0) {
+            this.error("This team has no projects — create one in the portal first.", { exit: 1 });
+        }
+        return (pool.find((p) => p.is_default) ?? pool[0]).id;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/function/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/function/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACL,eAAe,EACf,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,YAAY,GAEb,MAAM,oCAAoC,CAAC;AAG5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG;QACnB,0EAA0E;QAC1E,EAAE;QACF,6EAA6E;QAC7E,4EAA4E;QAC5E,wEAAwE;QACxE,+CAA+C;KAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,QAAQ,GAAG;QAChB,uCAAuC;QACvC,2DAA2D;QAC3D,kEAAkE;QAClE,2FAA2F;QAC3F,+CAA+C;KAChD,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EACT,mFAAmF;SACtF,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC;YACtB,WAAW,EAAE,iDAAiD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,sEAAsE;SAC1J,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,uFAAuF;SACrG,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,sFAAsF;SACpG,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,kEAAkE;SAChF,CAAC;QACF,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC;YAC3B,WAAW,EAAE,uFAAuF;SACrG,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,gFAAgF;SAC9F,CAAC;QACF,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC;YAC3B,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,kFAAkF;SAChG,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACrE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrD,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,4EAA4E;YAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACtD,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACrB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC,KAAK,UAAU,EAAE,CAAC;oBAC1D,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC;gBAC/B,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,KAAK,CACR,iIAAiI,EACjI,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,sBAAsB;YACtB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAI,KAAK,CAAC,OAA+B,IAAI,QAAQ,IAAI,QAAQ,CAAC;YAE/E,IAAI,EAAM,CAAC;YACX,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAC9E,CAAC,CAAU,EAAE,EAAE;gBACb,qEAAqE;gBACrE,qDAAqD;gBACrD,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACxD,MAAM,CAAC,CAAC;YACV,CAAC,CACF,CAAC;YACF,IAAI,KAAK,EAAE,CAAC;gBACV,EAAE,GAAG,KAAK,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,YAAY,IAAI,EAAE,EAAE,GAAG,EAAE,CACvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,IAAK,CAAC,CAC5C,CAAC;gBACF,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;oBACrB,IAAI,CAAC,KAAK,CACR,aAAa,IAAI,oBAAoB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,EAC/E,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;gBACJ,CAAC;gBACD,gEAAgE;gBAChE,MAAM,mBAAmB,CAAC;oBACxB,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;oBACrB,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY;oBAClD,WAAW,EAAE,aAAa,EAAE,IAAI,IAAI,CAAC,YAAY,KAAK,OAAO;oBAC7D,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBACvB,MAAM,EAAE,qBAAqB;iBAC9B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACb,IAAI,CAAC,YAAY,qBAAqB;wBAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC3E,MAAM,CAAC,CAAC;gBACV,CAAC,CAAC,CAAC;gBACH,MAAM,IAAI,GAAe;oBACvB,IAAI,EAAE,IAAI;oBACV,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;oBAClD,OAAO;iBACR,CAAC;gBACF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC9D,IAAI,UAAU;oBAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;gBAC7C,EAAE,GAAG,MAAM,WAAW,CAAC,YAAY,IAAI,EAAE,EAAE,GAAG,EAAE,CAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CACvD,CAAC;gBACF,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAED,+DAA+D;YAC/D,MAAM,SAAS,GAAI,QAA8B,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC;gBACpE,CAAC,CAAE,EAAE,CAAC,OAAmB;gBACzB,CAAC,CAAC,OAAO,CAAC;YACZ,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,SAAS,GAAkB,IAAI,CAAC;YACpC,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzB,mBAAmB;YACrB,CAAC;iBAAM,IAAI,QAAQ,IAAI,aAAa,EAAE,CAAC;gBACrC,SAAS,GAAG,IAAI,CAAC;gBACjB,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACtC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACpC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvB,gEAAgE;oBAChE,8DAA8D;oBAC9D,SAAS,GAAG,IAAI,CAAC;oBACjB,SAAS,GAAG,SAAS,CAAC;gBACxB,CAAC;qBAAM,CAAC;oBACN,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC7E,SAAS,GAAG,SAAS,CAAC;gBACxB,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,MAAM,aAAa,GACjB,YAAY,KAAK,SAAS;gBAC1B,QAAQ,CAAC,YAAY,CAAC,KAAK,UAAU;gBACrC,YAAY,CAAC,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,IAAI,YAAY,EAAE,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;YACrG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;YAEtE,MAAM,OAAO,GAAG;gBACd,SAAS,EAAE,GAAG;gBACd,OAAO;gBACP,aAAa;gBACb,SAAS;gBACT,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS;gBAC9C,QAAQ,EAAE,EAAE;aACb,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,aAAa,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,CAAC;gBACpE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACb,IAAI,CAAC,GAAG,CACN,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,EAAE;oBAChF,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC;oBACjB,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC;oBACzB,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;oBAClC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,IAAI,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;oBAC3E,CAAC,WAAW,EAAE,GAAG,CAAC;oBAClB;wBACE,OAAO;wBACP,SAAS;4BACP,CAAC,CAAC,SAAS;gCACT,CAAC,CAAC,GAAG,SAAS,IAAI,GAAG,CAAC,iBAAiB,CAAC,EAAE;gCAC1C,CAAC,CAAC,GAAG,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC,EAAE;4BACtC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;qBACvB;iBACF,CAAC,CACH,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACb,IAAI,IAAI;oBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC,CAAC;gBACnF,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,4CAA4C,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBACpE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED;oFACgF;IACxE,aAAa,CAAC,KAAe,EAAE,EAAW;QAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,eAAe,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,kDAAkD,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,IAAa;QACzC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC/D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI,iCAAiC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9F,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,CACR,qBAAqB,IAAI,iBAAiB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACpF,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,yEAAyE;IACjE,KAAK,CAAC,aAAa;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC;QAC5D,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,iEAAiE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED,6EAA6E;IACrE,KAAK,CAAC,gBAAgB,CAAC,MAAc;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC;QAChE,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,6DAA6D,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC"}

package/dist/commands/function/invoke.d.ts

@@ -0,0 +1,29 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq function invoke` — call a deployed function over HTTPS.
+ *
+ * This one does NOT go through ApiClient: a function is served from its own
+ * hostname, not the portal API, and it takes no Synteq auth. It's a plain
+ * fetch, so the response is whatever the handler returned.
+ *
+ * `--insecure` is honoured here the same way ApiClient honours it (an undici
+ * dispatcher with certificate verification off) so a locally-served function
+ * behind a self-signed cert can be invoked in dev.
+ */
+export default class FunctionInvoke extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        path: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        method: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "content-type": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        header: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/invoke.js

@@ -0,0 +1,138 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveLinkedFunction } from "../../functions-support/link.js";
+import { statusColor, dim, cyan, G } from "../../ui/glyphs.js";
+/**
+ * `synteq function invoke` — call a deployed function over HTTPS.
+ *
+ * This one does NOT go through ApiClient: a function is served from its own
+ * hostname, not the portal API, and it takes no Synteq auth. It's a plain
+ * fetch, so the response is whatever the handler returned.
+ *
+ * `--insecure` is honoured here the same way ApiClient honours it (an undici
+ * dispatcher with certificate verification off) so a locally-served function
+ * behind a self-signed cert can be invoked in dev.
+ */
+export default class FunctionInvoke extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Invoke a deployed function over HTTPS and print its response.",
+        "",
+        "A plain HTTP request to the function's hostname — no Synteq credentials are",
+        "attached, so what you see is exactly what any caller sees. JSON bodies are",
+        "pretty-printed; anything else is printed as-is.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> function invoke                         # bare: GET / on the linked function",
+        "<%= config.bin %> function invoke my-fn --path /health",
+        `<%= config.bin %> function invoke my-fn --method POST --data '{"x":1}'`,
+        '<%= config.bin %> function invoke my-fn --header "X-Trace: abc" --header "Accept: text/plain"',
+        "<%= config.bin %> function invoke my-fn -o json           # {status, ms, headers, body}",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function slug (or uuid). Omit to use this directory's linked function.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) — the flag form of the positional arg.",
+        }),
+        path: Flags.string({
+            default: "/",
+            description: "Request path (and query string) to call (default: /).",
+        }),
+        method: Flags.string({
+            default: "GET",
+            description: "HTTP method (default: GET).",
+        }),
+        data: Flags.string({
+            char: "d",
+            description: "Request body. Sets Content-Type: application/json unless --content-type says otherwise.",
+        }),
+        "content-type": Flags.string({
+            description: "Content-Type for --data (default: application/json).",
+        }),
+        header: Flags.string({
+            multiple: true,
+            description: "Extra request header as KEY:VALUE. Repeat for more than one.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionInvoke);
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, {
+                ...flags,
+                name: args.name ?? flags.name,
+            }).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const path = flags.path.startsWith("/") ? flags.path : `/${flags.path}`;
+            const url = /^https?:\/\//.test(fn.hostname)
+                ? `${fn.hostname.replace(/\/+$/, "")}${path}`
+                : `https://${fn.hostname}${path}`;
+            const headers = {};
+            for (const raw of flags.header ?? []) {
+                const colon = raw.indexOf(":");
+                if (colon <= 0) {
+                    this.error(`Bad --header "${raw}". Use KEY:VALUE (e.g. --header "X-Trace: abc").`, {
+                        exit: 1,
+                    });
+                }
+                headers[raw.slice(0, colon).trim()] = raw.slice(colon + 1).trim();
+            }
+            if (flags.data != null && !Object.keys(headers).some((h) => h.toLowerCase() === "content-type")) {
+                headers["Content-Type"] = flags["content-type"] ?? "application/json";
+            }
+            const init = {
+                method: flags.method.toUpperCase(),
+                headers,
+                body: flags.data,
+            };
+            if (flags.insecure) {
+                const { Agent } = (await import("undici"));
+                init.dispatcher = new Agent({ connect: { rejectUnauthorized: false } });
+            }
+            const started = Date.now();
+            let res;
+            try {
+                res = await fetch(url, init);
+            }
+            catch (e) {
+                this.error(`Could not reach ${url}: ${e.message}`, { exit: 3 });
+            }
+            const ms = Date.now() - started;
+            const text = await res.text();
+            const responseHeaders = {};
+            res.headers.forEach((v, k) => {
+                responseHeaders[k] = v;
+            });
+            let parsed;
+            let isJson = false;
+            try {
+                parsed = JSON.parse(text);
+                isJson = true;
+            }
+            catch {
+                parsed = text;
+            }
+            this.emit({ status: res.status, ms, headers: responseHeaders, body: parsed }, () => {
+                this.log(`${statusColor(`${res.status} ${res.statusText}`.trim())} ${dim(G.bullet)} ${ms}ms ${dim(G.bullet)} ${cyan(url)}`);
+                this.log("");
+                this.log(isJson ? JSON.stringify(parsed, null, 2) : text);
+            });
+            // A non-2xx is the function's answer, not a CLI failure — but scripts
+            // still want a signal, so mirror curl --fail's spirit on 5xx only.
+            if (res.status >= 500)
+                this.exit(1);
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=invoke.js.map

package/dist/commands/function/invoke.js.map

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

package/dist/commands/function/link.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq function link [name]` — link this directory to a function without
+ * touching its files: `function init <name> --no-scaffold`, with a picker
+ * when no name is given on a TTY. The apps side is `synteq app link`.
+ */
+export default class FunctionLink extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        dir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "no-interactive": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /** One of the project's functions, or a name for a new one (created with
+     *  init's defaults — plan and location prompts follow on a TTY). */
+    private pick;
+}

package/dist/commands/function/link.js

@@ -0,0 +1,80 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import FunctionInit from "./init.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { dim } from "../../ui/glyphs.js";
+import { isInteractive, pickFromCatalog, promptString } from "../../ui/wizard.js";
+import { slugify } from "../link.js";
+const CREATE = "\0create";
+/**
+ * `synteq function link [name]` — link this directory to a function without
+ * touching its files: `function init <name> --no-scaffold`, with a picker
+ * when no name is given on a TTY. The apps side is `synteq app link`.
+ */
+export default class FunctionLink extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Link the current directory to a function: name one by slug or id, or pick one on a TTY.",
+        "Nothing is written to the directory (`function init` is the one that scaffolds a",
+        "handler). A linked directory deploys with a bare `synteq function deploy`.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> function link                 # interactive: pick one of the project's functions, or create one",
+        "<%= config.bin %> function link my-fn           # straight to an existing function by slug",
+        "<%= config.bin %> function link 01931234-...    # or by id",
+        "<%= config.bin %> function link my-fn --dir ./api --project 01931234-...",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function slug (or uuid) to link to. Omit on a TTY to pick from the project's functions.",
+        }),
+    };
+    static flags = {
+        dir: Flags.string({ description: "Directory to link (default: the current directory)." }),
+        project: Flags.string({
+            description: "Project id to look the function up in, and whose functions the picker lists (default: the active project).",
+        }),
+        "no-interactive": Flags.boolean({ description: "Never prompt; requires a name (errors when it's missing)." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionLink);
+        try {
+            let name = args.name;
+            if (!name) {
+                if (!isInteractive() || this.outputFormat !== "table" || flags["no-interactive"]) {
+                    this.error("Provide a function slug or id (or run on a TTY to pick one).", { exit: 1 });
+                }
+                name = await this.pick(flags.project ?? this.clients.config.get().default_project_id ?? undefined);
+            }
+            const argv = [name, "--no-scaffold"];
+            if (flags.dir)
+                argv.push("--dir", flags.dir);
+            if (flags.project)
+                argv.push("--project", flags.project);
+            await FunctionInit.run(argv, this.config);
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+    /** One of the project's functions, or a name for a new one (created with
+     *  init's defaults — plan and location prompts follow on a TTY). */
+    async pick(projectId) {
+        const fns = await withSpinner("Loading functions", () => this.clients.api.functions.list(projectId));
+        const items = [
+            ...fns.map((f) => ({ value: f.id, name: f.slug, description: `${f.status} · ${f.runtime} · ${f.region}` })),
+            { value: CREATE, name: "Create a new function…", description: "Name it; plan and location follow." },
+        ];
+        if (fns.length === 0)
+            this.log(dim("No functions in this project yet."));
+        const choice = fns.length === 0 ? CREATE : await pickFromCatalog("Which function should this directory deploy?", items);
+        if (choice !== CREATE)
+            return choice;
+        const raw = await promptString("Function name", {
+            validate: (s) => (slugify(s).length >= 2 ? true : "At least two letters or digits."),
+        });
+        return slugify(raw);
+    }
+}
+//# sourceMappingURL=link.js.map

package/dist/commands/function/link.js.map

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

package/dist/commands/function/list.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq function list` — serverless functions in the active project.
+ *
+ * Backend: GET /functions. Scoping matches `apps list` — the server resolves
+ * the active project from the `X-Project-Id` header, so `--project` overrides it.
+ */
+export default class FunctionList extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/list.js

@@ -0,0 +1,55 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { renderTable, shortId, truncationNote } from "../../ui/table.js";
+import { statusColor } from "../../ui/glyphs.js";
+/**
+ * `synteq function list` — serverless functions in the active project.
+ *
+ * Backend: GET /functions. Scoping matches `apps list` — the server resolves
+ * the active project from the `X-Project-Id` header, so `--project` overrides it.
+ */
+export default class FunctionList extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "List serverless functions in the active project.";
+    static examples = [
+        "<%= config.bin %> function list",
+        "<%= config.bin %> function list --project 019e...   # scope to a specific project",
+        "<%= config.bin %> function list -o json",
+    ];
+    static flags = {
+        project: Flags.string({
+            description: "Project id to scope to (defaults to the active project).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { flags } = await this.parse(FunctionList);
+        try {
+            const page = await this.clients.api.functions.listPage(flags.project);
+            const fns = page.items;
+            const note = truncationNote(fns.length, page.total, "--project");
+            this.emit(fns, () => {
+                if (fns.length === 0) {
+                    this.log("No functions. Create one with `synteq function init <name>`.");
+                    return;
+                }
+                this.log(renderTable(["ID", "SLUG", "STATUS", "RUNTIME", "PLAN", "REGION", "REL", "HOSTNAME"], fns.map((f) => [
+                    shortId(f.id),
+                    f.slug,
+                    statusColor(f.status),
+                    f.runtime,
+                    f.planTier,
+                    f.region,
+                    f.currentReleaseNumber != null ? String(f.currentReleaseNumber) : "—",
+                    f.hostname,
+                ])));
+            });
+            if (note)
+                this.info(note);
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map