@localpulse/cli 0.0.1

package/README.md

@@ -0,0 +1,65 @@
+# @localpulse/cli
+
+CLI for [Local Pulse](https://localpulse.nl) — ingest event posters, search events, and manage credentials.
+
+## Install
+
+**Via bunx (zero-install):**
+
+```sh
+bunx @localpulse/cli --help
+```
+
+**Standalone binary:**
+
+Download the latest binary for your platform from the [releases page](https://github.com/localpulse/local_pulse/releases), then:
+
+```sh
+chmod +x localpulse
+./localpulse --help
+```
+
+## Quick start
+
+```sh
+# Authenticate
+localpulse auth login --token lp_cli_...
+
+# Search events
+localpulse search "techno amsterdam" --date weekend --tz Europe/Amsterdam
+
+# Ingest a poster (creates a draft for review)
+localpulse ingest poster.jpg --research metadata.json
+
+# Ingest directly (skip draft)
+localpulse ingest poster.jpg --research metadata.json --force
+```
+
+## Commands
+
+### `auth login`
+
+Authenticate with a CLI token. Get one at [localpulse.nl/dev](https://localpulse.nl/dev).
+
+### `auth logout`
+
+Remove stored credentials.
+
+### `ingest <file> --research <payload.json>`
+
+Upload an event poster with research metadata. By default creates a draft for review at `localpulse.nl/publish/edit/<id>`. Use `--force` to submit directly. Use `--generate-skeleton` to see the research JSON format.
+
+### `search <query>`
+
+Search events by text. Supports `--city`, `--date today|weekend`, `--tz`, `--limit`, `--cursor`.
+
+## Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `LP_TOKEN` | Override stored token |
+| `LP_API_URL` | Override API URL (default: `https://localpulse.nl`) |
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@localpulse/cli",
+  "version": "0.0.1",
+  "description": "Local Pulse CLI — ingest event posters, search events, manage credentials",
+  "type": "module",
+  "license": "MIT",
+  "packageManager": "bun@1.3.5",
+  "bin": {
+    "localpulse": "./src/index.ts"
+  },
+  "files": [
+    "src/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "test": "bun test",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check:help": "bun run src/index.ts --help",
+    "build": "bun build --compile src/index.ts --outfile dist/localpulse",
+    "build:darwin-arm64": "bun build --compile --target=bun-darwin-arm64 src/index.ts --outfile dist/localpulse-darwin-arm64",
+    "build:darwin-x64": "bun build --compile --target=bun-darwin-x64 src/index.ts --outfile dist/localpulse-darwin-x64",
+    "build:linux-x64": "bun build --compile --target=bun-linux-x64 src/index.ts --outfile dist/localpulse-linux-x64",
+    "build:all": "bun run build:darwin-arm64 && bun run build:darwin-x64 && bun run build:linux-x64"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.48",
+    "ajv": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "typescript": "^5.9.2"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,137 @@
+import { writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { describe, expect, it } from "bun:test";
+
+import { validateResearchPayload } from "./lib/research-schema";
+
+const cwd = new URL("..", import.meta.url).pathname;
+
+function runCli(...args: string[]): { exitCode: number; stdout: string; stderr: string } {
+  const result = Bun.spawnSync({
+    cmd: ["bun", "run", "src/index.ts", ...args],
+    cwd,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+
+  return {
+    exitCode: result.exitCode,
+    stdout: new TextDecoder().decode(result.stdout),
+    stderr: new TextDecoder().decode(result.stderr),
+  };
+}
+
+describe("localpulse", () => {
+  it("shows root help with expected commands", () => {
+    const { exitCode, stdout } = runCli("--help");
+    expect(exitCode).toBe(0);
+    expect(stdout).toContain("ingest");
+    expect(stdout).toContain("search");
+    expect(stdout).toContain("auth");
+    expect(stdout).not.toMatch(/^\s+directives\s/m);
+    expect(stdout).not.toMatch(/^\s+event\s/m);
+    expect(stdout).not.toMatch(/^\s+status\s/m);
+    expect(stdout).not.toContain("--format");
+    expect(stdout).not.toContain("--filter-output");
+  });
+
+  it("shows version", () => {
+    const { exitCode, stdout } = runCli("--version");
+    expect(exitCode).toBe(0);
+    expect(stdout.trim()).toMatch(/^\d+\.\d+\.\d+$/);
+  });
+
+  it("shows ingest help with research as primary input", () => {
+    const { exitCode, stdout } = runCli("ingest", "--help");
+    expect(exitCode).toBe(0);
+    expect(stdout).toContain("--research");
+    expect(stdout).toContain("--generate-skeleton");
+    expect(stdout).toContain("--dry-run");
+    expect(stdout).not.toContain("--performers");
+    expect(stdout).not.toContain("--genre");
+    expect(stdout).not.toContain("--socials");
+    expect(stdout).not.toContain("--organizer");
+    expect(stdout).not.toContain("--price");
+    expect(stdout).not.toContain("--batch");
+  });
+
+  it("shows search help with --date instead of --time", () => {
+    const { exitCode, stdout } = runCli("search", "--help");
+    expect(exitCode).toBe(0);
+    expect(stdout).toContain("--date");
+    expect(stdout).toContain("--city");
+    expect(stdout).not.toContain("--time");
+  });
+
+  it("shows auth help", () => {
+    const { exitCode, stdout } = runCli("auth", "--help");
+    expect(exitCode).toBe(0);
+    expect(stdout).toContain("login");
+    expect(stdout).toContain("logout");
+  });
+
+  it("shows auth login help", () => {
+    const { exitCode, stdout } = runCli("auth", "login", "--help");
+    expect(exitCode).toBe(0);
+    expect(stdout).toContain("--token");
+    expect(stdout).toContain("--api-url");
+  });
+
+  it("rejects unknown commands", () => {
+    const { exitCode, stderr } = runCli("bogus");
+    expect(exitCode).toBe(1);
+    expect(stderr).toContain("Unknown command: bogus");
+  });
+
+  it("requires --research for ingest", () => {
+    const { exitCode, stderr } = runCli("ingest", "poster.jpg");
+    expect(exitCode).toBe(1);
+    expect(stderr).toContain("--research");
+  });
+
+  it("requires a file argument for ingest", () => {
+    const { exitCode, stderr } = runCli("ingest");
+    expect(exitCode).toBe(1);
+    expect(stderr).toContain("Usage:");
+  });
+
+  it("requires a query for search", () => {
+    const { exitCode, stderr } = runCli("search");
+    expect(exitCode).toBe(1);
+    expect(stderr).toContain("Search query is required");
+  });
+
+  it("outputs valid JSON from --generate-skeleton", () => {
+    const { exitCode, stdout } = runCli("ingest", "--generate-skeleton");
+    expect(exitCode).toBe(0);
+    const skeleton = JSON.parse(stdout);
+    expect(() => validateResearchPayload(skeleton)).not.toThrow();
+    expect(skeleton.performers).toBeDefined();
+    expect(skeleton.event).toBeDefined();
+    expect(skeleton.venue).toBeDefined();
+    expect(skeleton.organizer).toBeDefined();
+  });
+
+  it("validates research payload from file with --dry-run", async () => {
+    const researchFile = join(tmpdir(), `lp-test-${Date.now()}.json`);
+    await writeFile(researchFile, JSON.stringify({
+      performers: [{ name: "DJ Nobu", genre: "techno" }],
+      event: { title: "Test Night" },
+    }));
+
+    const { exitCode, stdout } = runCli("ingest", "../../README.md", "--research", researchFile, "--dry-run");
+    expect(exitCode).toBe(0);
+    expect(stdout).toContain("Dry run passed");
+  });
+
+  it("rejects invalid research payload", async () => {
+    const researchFile = join(tmpdir(), `lp-test-${Date.now()}.json`);
+    await writeFile(researchFile, JSON.stringify({ performers: "not-an-array" }));
+
+    const { exitCode, stderr } = runCli("ingest", "../../README.md", "--research", researchFile, "--dry-run");
+    expect(exitCode).toBe(1);
+    expect(stderr).toContain("Invalid research payload");
+  });
+});