@thebehavioral/behave 0.0.1

package/README.md

@@ -0,0 +1,80 @@
+# behave
+
+CLI for fetching your coaching session data from [The Behavioral](https://thebehavioral.tech).
+
+## Requirements
+
+Node.js 18 or later.
+
+## Installation
+
+```sh
+npm install -g @thebehavioral/behave
+```
+
+## Setup
+
+1. Log in at [thebehavioral.tech](https://thebehavioral.tech) and go to your profile.
+2. Scroll to **API Keys** at the bottom and click **Create API Key**.
+3. Copy the key — it's shown only once.
+4. Run `behave login` and paste the key when prompted.
+
+Your key is saved to `~/.thebehavioral` (mode 0600).
+
+## Commands
+
+### `behave login`
+
+Save your API key.
+
+```sh
+behave login
+```
+
+### `behave session <id>`
+
+Fetch full details for a single session — transcript, coaching notes, and (for coaches) private notes.
+
+```sh
+behave session 550e8400-e29b-41d4-a716-446655440000
+```
+
+Returns: `{ session }`
+
+### `behave sessions`
+
+List coaching sessions you are part of (as coach or participant). Use `--coach-only` to restrict to sessions where you are the coach.
+
+```sh
+behave sessions
+behave sessions --coach-only
+behave sessions --from 2024-01-01 --to 2024-03-31
+behave sessions --coach-only --from 2024-01-01
+```
+
+Returns: `{ sessions[], total }`
+
+### `behave --help`
+
+Show usage.
+
+## Output
+
+All commands write JSON to stdout, making it easy to pipe into `jq` or other tools:
+
+```sh
+behave session <id> | jq '.session.transcript'
+behave sessions --from 2024-01-01 | jq '.sessions[].scheduled_at'
+```
+
+## Config file
+
+`~/.thebehavioral` stores your credentials as JSON (mode 0600):
+
+```json
+{
+  "api_key": "beh_..."
+}
+```
+
+The `base_url` defaults to `https://thebehavioral.tech` and can be overridden by adding it to the config file.

package/bin/behave.js

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+
+/**
+ * behave - CLI for The Behavioral coaching session data
+ *
+ * Usage:
+ *   behave login
+ *   behave sessions [--coach-only] [--from <date>] [--to <date>]
+ *   behave session <id>
+ *   behave --help
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { createInterface } from 'readline';
+
+const CONFIG_PATH = join(homedir(), '.thebehavioral');
+const DEFAULT_BASE_URL = 'https://thebehavioral.tech';
+
+// ─── Config ──────────────────────────────────────────────────────────────────
+
+function loadConfig() {
+  if (!existsSync(CONFIG_PATH)) {
+    die(
+      `No config found at ~/.thebehavioral\n` +
+        `Run: behave login\n` +
+        `Or see: behave --help`
+    );
+  }
+  try {
+    const raw = readFileSync(CONFIG_PATH, 'utf8').trim();
+    const cfg = JSON.parse(raw);
+    if (!cfg.api_key) {
+      die('Config at ~/.thebehavioral is missing api_key.\nRun: behave login');
+    }
+    cfg.base_url = cfg.base_url || DEFAULT_BASE_URL;
+    return cfg;
+  } catch {
+    die('Could not parse ~/.thebehavioral — expected JSON with api_key.');
+  }
+}
+
+function saveConfig(cfg) {
+  const dir = dirname(CONFIG_PATH);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2) + '\n', {
+    mode: 0o600,
+  });
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function die(msg) {
+  process.stderr.write(msg + '\n');
+  process.exit(1);
+}
+
+function out(data) {
+  process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}
+
+async function apiRequest(config, path, options = {}) {
+  const url = `${config.base_url.replace(/\/$/, '')}${path}`;
+  const headers = {
+    'Content-Type': 'application/json',
+    ...options.headers,
+  };
+  if (config.api_key) {
+    headers['Authorization'] = `Bearer ${config.api_key}`;
+  }
+  let res;
+  try {
+    res = await fetch(url, { ...options, headers });
+  } catch (err) {
+    die(`Network error: ${err.message}`);
+  }
+  let data;
+  try {
+    data = await res.json();
+  } catch {
+    die(`Non-JSON response from server (HTTP ${res.status})`);
+  }
+  if (!res.ok) {
+    die(`API error (${res.status}): ${data.error ?? JSON.stringify(data)}`);
+  }
+  return data;
+}
+
+function promptSecret(question) {
+  return new Promise((resolve) => {
+    process.stdout.write(question);
+    const rl = createInterface({
+      input: process.stdin,
+      output: null,
+      terminal: false,
+    });
+    if (process.stdin.isTTY) process.stdin.setRawMode(true);
+    let value = '';
+    const onData = (char) => {
+      char = char.toString();
+      if (char === '\n' || char === '\r' || char === '') {
+        if (process.stdin.isTTY) process.stdin.setRawMode(false);
+        process.stdout.write('\n');
+        process.stdin.removeListener('data', onData);
+        process.stdin.pause();
+        resolve(value);
+      } else if (char === '') {
+        process.stdout.write('\n');
+        process.exit(1);
+      } else if (char === '' || char === '\b') {
+        value = value.slice(0, -1);
+        process.stdout.write('\b \b');
+      } else {
+        value += char;
+        process.stdout.write('*');
+      }
+    };
+    process.stdin.resume();
+    process.stdin.on('data', onData);
+  });
+}
+
+function endOfDay(dateStr) {
+  if (!dateStr) return dateStr;
+  if (/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) return `${dateStr}T23:59:59.999Z`;
+  return dateStr;
+}
+
+function startOfDay(dateStr) {
+  if (!dateStr) return dateStr;
+  if (/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) return `${dateStr}T00:00:00.000Z`;
+  return dateStr;
+}
+
+// ─── Arg parsing ─────────────────────────────────────────────────────────────
+
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i].startsWith('--')) {
+      const key = argv[i].slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith('--')) {
+        flags[key] = next;
+        i++;
+      } else {
+        flags[key] = true;
+      }
+    } else {
+      positional.push(argv[i]);
+    }
+  }
+  return { flags, positional };
+}
+
+// ─── Commands ────────────────────────────────────────────────────────────────
+
+async function cmdLogin() {
+  process.stderr.write(
+    'Generate an API key at: ' +
+      DEFAULT_BASE_URL +
+      '/account/profile\n' +
+      '(scroll to the API Keys section at the bottom)\n\n'
+  );
+
+  const apiKey = await promptSecret('Paste API key: ');
+  if (!apiKey.trim()) die('API key cannot be empty.');
+
+  saveConfig({ api_key: apiKey.trim() });
+  process.stderr.write('API key saved to ~/.thebehavioral\n');
+}
+
+async function cmdSessions(flags) {
+  const config = loadConfig();
+
+  const params = new URLSearchParams();
+  if (flags['coach-only']) params.set('coach_only', 'true');
+  if (flags['from']) params.set('from', startOfDay(flags['from']));
+  if (flags['to']) params.set('to', endOfDay(flags['to']));
+
+  const qs = params.toString();
+  const data = await apiRequest(
+    config,
+    `/api/admin/cli/sessions${qs ? `?${qs}` : ''}`
+  );
+  out(data);
+}
+
+async function cmdSession(id) {
+  if (!id) die('Usage: behave session <id>');
+  const config = loadConfig();
+  const data = await apiRequest(config, `/api/admin/cli/sessions/${id}`);
+  out(data);
+}
+
+// ─── Help ─────────────────────────────────────────────────────────────────────
+
+const HELP = `
+behave — CLI for The Behavioral session data
+All output is JSON written to stdout.
+
+COMMANDS
+
+  behave login
+    Save your API key to ~/.thebehavioral.
+    Generate an API key at: ${DEFAULT_BASE_URL}/account/profile
+
+  behave sessions [--coach-only] [--from <date>] [--to <date>]
+    List coaching sessions you are part of (as coach or participant).
+    Use --coach-only to restrict to sessions where you are the coach.
+    Dates are ISO 8601 (e.g. 2024-01-01). Time defaults to start-of-day for
+    --from and end-of-day for --to when only a date is given.
+
+    Examples:
+      behave sessions
+      behave sessions --coach-only
+      behave sessions --from 2024-01-01 --to 2024-03-31
+      behave sessions --coach-only --from 2024-01-01
+
+    Returns: { sessions[], total }
+
+  behave session <id>
+    Fetch full details for a single session, including coaching_notes,
+    transcript, and private_notes (coaches only).
+
+    Example:
+      behave session 550e8400-e29b-41d4-a716-446655440000
+
+    Returns: { session }
+
+  behave --help
+    Show this message.
+
+CONFIG FILE
+
+  Credentials are stored in ~/.thebehavioral (mode 0600):
+    {
+      "api_key": "beh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+    }
+
+  The base_url defaults to ${DEFAULT_BASE_URL} and can be overridden
+  by adding a "base_url" key to the config file.
+
+GETTING AN API KEY
+
+  1. Log in to the site at ${DEFAULT_BASE_URL}
+  2. Go to your profile and scroll to "API Keys" at the bottom.
+  3. Click "Create API Key" and copy the key shown (it appears only once).
+  4. Run: behave login
+     Paste the key when prompted.
+`.trim();
+
+// ─── Entry point ─────────────────────────────────────────────────────────────
+
+const argv = process.argv.slice(2);
+const { flags, positional } = parseArgs(argv);
+
+if (flags['help'] || argv.length === 0) {
+  process.stdout.write(HELP + '\n');
+  process.exit(0);
+}
+
+const command = positional[0];
+
+switch (command) {
+  case 'login':
+    await cmdLogin();
+    break;
+  case 'sessions':
+    await cmdSessions(flags);
+    break;
+  case 'session':
+    await cmdSession(positional[1]);
+    break;
+  default:
+    die(`Unknown command: ${command}\nRun: behave --help`);
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@thebehavioral/behave",
+  "version": "0.0.1",
+  "description": "CLI for fetching your coaching session data from The Behavioral",
+  "type": "module",
+  "bin": {
+    "behave": "bin/behave.js"
+  },
+  "scripts": {
+    "test": "node --test test/unit.test.js",
+    "test:unit": "node --test test/unit.test.js",
+    "test:e2e": "node --test test/e2e.test.js",
+    "release": "./scripts/release.sh",
+    "release:minor": "./scripts/release.sh minor",
+    "release:major": "./scripts/release.sh major"
+  },
+  "files": [
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thebehavioral/behave.git"
+  },
+  "homepage": "https://thebehavioral.tech",
+  "main": "bin/behave.js",
+  "directories": {
+    "test": "test"
+  },
+  "author": "Austen McDonald",
+  "bugs": {
+    "url": "https://github.com/thebehavioral/behave/issues"
+  }
+}