sparkle-local

CLI + SDK pour exécuter des sources Sparkle en local (runtime embarqué : eval + SQLite pseudo-Redis).

CLI usage

sparkle-local --help

Run one file

sparkle-local run \
  --file commands/hello.ts \
  --handler default \
  --payload '{"username":"alex","message":"!hello"}' \
  --var API_KEY=secret

List source files

sparkle-local list --root . --src src

Start local Twitch listener server

sparkle-local serve \
  --root . \
  --src src \
  --broadcaster-id 123456789 \
  --refresh-token "<TWITCH_REFRESH_TOKEN>"

Required env vars:

• TWITCH_CLIENT_ID
• TWITCH_CLIENT_SECRET

Optional env fallbacks:

• TWITCH_BROADCASTER_ID
• TWITCH_REFRESH_TOKEN

Programmatic usage

import { invokeSparkleSourceFile } from "@workspace/sparkle-local"

await invokeSparkleSourceFile({
  runtimeAuthToken: "local-dev",
  rootDir: process.cwd(),
  filePathInSrc: "commands/hello.ts",
  handlerId: "default",
})