@tallpond/cli 0.0.1 → 0.0.3

package/README.md

@@ -49,6 +49,39 @@ apply automatically; destructive ones are blocked pending an explicit migration.
 The schema file is TypeScript: the CLI compiles it in-process (via esbuild) so it
 runs on any supported Node — no bun or global TS loader required.
 
+### Functions
+
+If the project has a `functions/` directory, `tallpond deploy` also deploys it.
+The convention: **each `.ts`/`.js` file directly under `functions/` is one
+invokable function**, named after the file, and must `export default` its
+handler:
+
+```ts
+// functions/submitMove.ts — invoked as tallpond.functions.invoke('submitMove', args)
+import type { FunctionContext } from '@tallpond/sdk' // type-only; nothing bundled
+
+export default async (ctx: FunctionContext, args: { resourceId: string; move: unknown }) => {
+  await ctx.db.query({
+    scope: { kind: 'resource', resourceId: args.resourceId },
+    table: 'moves',
+    op: 'insert',
+    values: { move: args.move },
+  })
+  return { ok: true }
+}
+```
+
+The ctx surface is exactly `userId`, `resourceId`, `fn`, `invocationId`,
+`db.query`/`db.batch` (raw `/v1/db` wire shape), and `gateway(path, body)` —
+annotate with `FunctionContext` so the compiler enforces it. Full contract:
+<https://tallpond.com/docs/functions/>.
+
+File names must be identifiers (letters/digits/underscores). Shared helpers and
+types belong in a subdirectory (e.g. `functions/lib/`) — subdirectories aren't
+scanned, and handlers can import from them freely (everything is bundled). A
+top-level file without a default export is skipped with a warning rather than
+deployed.
+
 Full command reference: <https://tallpond.com> → docs → CLI.
 
 ## License

package/cli.js

@@ -5,7 +5,7 @@ import { parseArgs } from "node:util";
 import { spawn } from "node:child_process";
 import { existsSync as existsSync2 } from "node:fs";
 import { writeFile as writeFile3 } from "node:fs/promises";
-import { resolve as resolve4 } from "node:path";
+import { basename as basename2, resolve as resolve4 } from "node:path";
 
 // src/deploy.ts
 import { extname, join, resolve } from "node:path";
@@ -436,7 +436,33 @@ export function createHandler(functions) {
   }
 }
 `;
-async function bundleFunctions(entries) {
+async function partitionByDefaultExport(entries) {
+  if (entries.length === 0) return { handlers: [], skipped: [] };
+  const { build } = await import("esbuild");
+  const result = await build({
+    entryPoints: entries.map((e) => e.file),
+    bundle: false,
+    format: "esm",
+    metafile: true,
+    write: false,
+    outdir: ".",
+    logLevel: "silent"
+  });
+  const withDefault = /* @__PURE__ */ new Set();
+  for (const out of Object.values(result.metafile.outputs)) {
+    if (out.entryPoint && out.exports.includes("default")) {
+      withDefault.add(resolve3(out.entryPoint));
+    }
+  }
+  const handlers = entries.filter((e) => withDefault.has(e.file));
+  const skipped = entries.filter((e) => !withDefault.has(e.file));
+  return { handlers, skipped };
+}
+async function bundleFunctions(all) {
+  const { handlers: entries, skipped } = await partitionByDefaultExport(all);
+  if (entries.length === 0) {
+    return { script: "", manifest: [], skipped };
+  }
   const dir = await mkdtemp2(join4(tmpdir2(), "tallpond-functions-"));
   try {
     await writeFile2(join4(dir, "runtime.mjs"), RUNTIME_SOURCE);
@@ -463,7 +489,8 @@ ${table}
     });
     return {
       script: result.outputFiles[0].text,
-      manifest: entries.map((e) => ({ name: e.name }))
+      manifest: entries.map((e) => ({ name: e.name })),
+      skipped
     };
   } finally {
     await rm2(dir, { recursive: true, force: true });
@@ -694,19 +721,33 @@ ${renderBlockedChanges(result.changes)}
   }
   const fnEntries = discoverFunctions(resolve4(process.cwd(), "functions"));
   if (fnEntries.length > 0) {
-    const bundle = await bundleFunctions(fnEntries);
-    const version2 = `f${Date.now().toString(36)}`;
-    try {
-      const res = await deployFunctionsAsDev(gatewayUrl, token, project.appId, { version: version2, ...bundle });
-      process.stdout.write(`functions: ${res.functions.join(", ")} (version ${res.version})
+    const { skipped, ...bundle } = await bundleFunctions(fnEntries);
+    for (const s of skipped) {
+      process.stderr.write(
+        `functions: skipping ${basename2(s.file)} \u2014 no default export (each file under functions/ is one handler; shared code belongs in a subdirectory)
+`
+      );
+    }
+    if (bundle.manifest.length > 0) {
+      const version2 = `f${Date.now().toString(36)}`;
+      try {
+        const res = await deployFunctionsAsDev(gatewayUrl, token, project.appId, { version: version2, ...bundle });
+        process.stdout.write(`functions: ${res.functions.join(", ")} (version ${res.version})
 `);
-    } catch (e) {
-      if (e instanceof DevApiError) {
-        process.stderr.write(`functions deploy failed: ${e.message}
+        if (res.invocable === false) {
+          process.stderr.write(
+            `warning: functions deployed but NOT invocable \u2014 ${res.invocable_detail ?? "the gateway reports functions are disabled"}
+`
+          );
+        }
+      } catch (e) {
+        if (e instanceof DevApiError) {
+          process.stderr.write(`functions deploy failed: ${e.message}
 `);
-        return 1;
+          return 1;
+        }
+        throw e;
       }
-      throw e;
     }
   }
   const dir = values.dir ?? (existsSync2(resolve4(process.cwd(), "dist")) ? "dist" : void 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallpond/cli",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "The tallpond developer CLI — sign in, register an app, and deploy schema + frontend with one command.",
   "license": "MIT",
   "repository": {