@tallpond/cli 0.0.3 → 0.0.5

package/README.md

@@ -72,7 +72,8 @@ export default async (ctx: FunctionContext, args: { resourceId: string; move: un
 ```
 
 The ctx surface is exactly `userId`, `resourceId`, `fn`, `invocationId`,
-`db.query`/`db.batch` (raw `/v1/db` wire shape), and `gateway(path, body)` —
+`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/>.
 
@@ -82,6 +83,22 @@ 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.
 
+## `tallpond test-session [--user name]`
+
+End-to-end testing without a browser: mints a bearer token for a synthetic
+test user of your app. Test users have no wallet — their usage bills your own
+balance directly (bounded by your per-app budget), and tokens expire after
+24h. The token alone goes to stdout:
+
+```sh
+ALICE=$(tallpond test-session --user alice)
+curl -H "Authorization: Bearer $ALICE" https://api.tallpond.com/v1/users/me
+```
+
+It authenticates on every user-facing route — tables, resources, functions,
+files, AI — as that user, metering normally. Mint two names for multi-user
+flows.
+
 Full command reference: <https://tallpond.com> → docs → CLI.
 
 ## License

package/cli.js

@@ -306,6 +306,9 @@ function deployFunctionsAsDev(gatewayUrl, token, appId, bundle, fetcher = fetch)
     bundle
   );
 }
+function createTestSession(gatewayUrl, token, appId, name, fetcher = fetch) {
+  return request(fetcher, gatewayUrl, token, "POST", `dev/apps/${appId}/test-users`, { name });
+}
 function collectBundleFiles(dir) {
   const out = [];
   const walk = (d) => {
@@ -382,11 +385,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) {
@@ -508,6 +515,7 @@ Usage:
   tallpond apps list                 List your apps
   tallpond deploy [schemaFile]       Deploy the app: schema + functions/ + built bundle
   tallpond typegen [schemaFile]      Generate row types (--out tallpond-env.d.ts)
+  tallpond test-session              Mint a bearer token for a synthetic test user
   tallpond help                      Show this help
 
 Common flags:
@@ -521,6 +529,10 @@ deploy flags:
   --no-bundle           deploy the schema only
   schemaFile            defaults to ./.tallpond.schema.ts (skipped if absent)
 
+test-session flags:
+  --user <name>         which test user (default "default"; same name = same user)
+  --json                print the full response as JSON instead of just the token
+
 Platform/CI escape hatch (bypasses login; uses the shared deploy token):
   --app-id <id> --deployment-id <id> --token <token>
   [env TALLPOND_APP_ID, TALLPOND_DEPLOYMENT_ID, TALLPOND_DEPLOY_TOKEN]
@@ -539,6 +551,7 @@ async function main(argv) {
     if (command === "create") return await runAppsCreate(argv.slice(1));
     if (command === "deploy") return await runDeploy(argv.slice(1));
     if (command === "typegen") return await runTypegen(argv.slice(1));
+    if (command === "test-session") return await runTestSession(argv.slice(1));
   } catch (e) {
     if (e instanceof DevApiError) {
       if (e.status === 401) {
@@ -816,6 +829,40 @@ ${renderBlockedChanges(result.changes)}
   }
   return 1;
 }
+async function runTestSession(args) {
+  const { values } = parseArgs({
+    args,
+    allowPositionals: false,
+    options: {
+      "gateway-url": { type: "string" },
+      user: { type: "string" },
+      json: { type: "boolean" }
+    }
+  });
+  const project = readProjectConfig();
+  if (!project) {
+    process.stderr.write(`error: no ${PROJECT_CONFIG_FILE} here \u2014 run \`tallpond apps create <name>\` first
+`);
+    return 1;
+  }
+  const gatewayUrl = resolveGatewayUrl(values["gateway-url"] ?? project.gatewayUrl);
+  const token = requireToken(gatewayUrl);
+  const session = await createTestSession(gatewayUrl, token, project.appId, values.user ?? "default");
+  if (values.json) {
+    process.stdout.write(`${JSON.stringify(session, null, 2)}
+`);
+    return 0;
+  }
+  process.stderr.write(
+    `test user ${session.user_id} \u2014 usage bills your own balance (token expires ${session.expires_at})
+use it as a bearer token, e.g.
+  curl -H "Authorization: Bearer <token>" ${gatewayUrl}/v1/users/me
+`
+  );
+  process.stdout.write(`${session.token}
+`);
+  return 0;
+}
 async function runTypegen(args) {
   const { values, positionals } = parseArgs({
     args,

package/index.js

@@ -241,6 +241,9 @@ function deployFunctionsAsDev(gatewayUrl, token, appId, bundle, fetcher = fetch)
     bundle
   );
 }
+function createTestSession(gatewayUrl, token, appId, name, fetcher = fetch) {
+  return request(fetcher, gatewayUrl, token, "POST", `dev/apps/${appId}/test-users`, { name });
+}
 function collectBundleFiles(dir) {
   const out = [];
   const walk = (d) => {
@@ -340,6 +343,7 @@ export {
   PROJECT_CONFIG_FILE,
   collectBundleFiles,
   createApp,
+  createTestSession,
   deploy,
   deployFunctionsAsDev,
   deploySchemaAsDev,

package/package.json

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