@tallpond/cli 0.0.2 → 0.0.4

package/README.md

@@ -58,12 +58,25 @@ handler:
 
 ```ts
 // functions/submitMove.ts — invoked as tallpond.functions.invoke('submitMove', args)
-export default async (ctx, args) => {
-  await ctx.db.query({ table: 'moves', insert: 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?, opts?)`
+(POST by default, `{ method: 'GET' }` for read routes) —
+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

package/cli.js

@@ -382,11 +382,15 @@ function decodeInvocation(token) {
 function makeCtx(env, token) {
   const fetchImpl = env.TALLPOND_FETCH ?? fetch
   const base = String(env.TALLPOND_GATEWAY_URL ?? '').replace(/\\/$/, '')
-  async function call(path, body) {
+  async function call(path, body, opts) {
+    const method = (opts && opts.method) || 'POST'
+    const bodyless = method === 'GET' || method === 'HEAD'
+    const headers = { authorization: 'Bearer ' + token }
+    if (!bodyless) headers['content-type'] = 'application/json'
     const res = await fetchImpl(base + path, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json', authorization: 'Bearer ' + token },
-      body: JSON.stringify(body),
+      method,
+      headers,
+      body: bodyless ? undefined : JSON.stringify(body),
     })
     const data = await res.json().catch(() => null)
     if (!res.ok) {

package/package.json

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