@sirenodeck/sirenodeck 0.1.1-alpha.0

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "@sirenodeck/sirenodeck",
+  "version": "0.1.1-alpha.0",
+  "description": "CLI for managing Elgato Stream Deck devices via a config-driven deck system.",
+  "bugs": {
+    "url": "https://github.com/sergiocarracedo/sireno-deck/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sergiocarracedo/sireno-deck.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "sirenodeck": "./bin/sirenodeck.js"
+  },
+  "files": [
+    "bin",
+    "config",
+    "dist/main.mjs",
+    "src",
+    "LICENSE",
+    "README.md",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__/**",
+    "!**/*.snap"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./api": {
+      "types": "./src/api/index.ts",
+      "default": "./src/api/index.ts"
+    },
+    "./react": {
+      "types": "./src/api/react/index.ts",
+      "default": "./src/api/react/index.ts"
+    },
+    "./vite": {
+      "types": "./src/vite/index.ts",
+      "default": "./src/vite/index.ts"
+    },
+    "./cli": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./ui": {
+      "types": "./src/ui/index.ts",
+      "default": "./src/ui/index.ts"
+    },
+    "./ui/ButtonFrame": {
+      "types": "./src/ui/ButtonFrame.tsx",
+      "default": "./src/ui/ButtonFrame.tsx"
+    },
+    "./ui/surfaces/IconLabelSurface": {
+      "types": "./src/ui/surfaces/IconLabelSurface.tsx",
+      "default": "./src/ui/surfaces/IconLabelSurface.tsx"
+    },
+    "./ui/surfaces/IconLabelProgressSurface": {
+      "types": "./src/ui/surfaces/IconLabelProgressSurface.tsx",
+      "default": "./src/ui/surfaces/IconLabelProgressSurface.tsx"
+    },
+    "./ui/surfaces/TemporaryErrorSurface": {
+      "types": "./src/ui/surfaces/TemporaryErrorSurface.tsx",
+      "default": "./src/ui/surfaces/TemporaryErrorSurface.tsx"
+    },
+    "./ui/primitives/Label": {
+      "types": "./src/ui/primitives/Label.tsx",
+      "default": "./src/ui/primitives/Label.tsx"
+    },
+    "./ui/primitives/Text": {
+      "types": "./src/ui/primitives/Text.tsx",
+      "default": "./src/ui/primitives/Text.tsx"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@elgato-stream-deck/node": "^7.6.3",
+    "@heroui/react": "3.0.0-rc.1",
+    "@heroui/styles": "3.0.0-rc.1",
+    "@meteocons/svg-static": "^0.1.0",
+    "chokidar": "^5.0.0",
+    "dbus-next": "^0.10.2",
+    "execa": "^9.6.0",
+    "get-windows": "^9.0.0",
+    "jsonc-parser": "^3.3.1",
+    "pino": "^10.3.1",
+    "playwright": "^1.50.0",
+    "qrcode": "^1.5.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sharp": "^0.34.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.9.0",
+    "yargs": "^18.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.0.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.1.0",
+    "@types/node": "^22.10.0",
+    "@types/qrcode": "^1.5.5",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/ws": "^8.5.13",
+    "@types/yargs": "^17.0.35",
+    "@vitejs/plugin-react": "^6.0.0",
+    "jsdom": "^25.0.1",
+    "lucide-react": "^1.22.0",
+    "oxfmt": "latest",
+    "oxlint": "latest",
+    "pino-pretty": "^13.0.0",
+    "tailwindcss": "^4.0.0",
+    "tsdown": "^0.22.14",
+    "tsx": "^4.22.4",
+    "typescript": "7.0.1-rc",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "dev": "node bin/dev.js",
+    "start": "node --import tsx src/cli/main.ts",
+    "build": "tsdown",
+    "build:frontend": "vite --config frontend/vite.build.config.ts build",
+    "build:config-ui": "vite --config config-ui/vite.config.ts build",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint src",
+    "format": "oxfmt src"
+  }
+}

package/src/action/executor.ts

@@ -0,0 +1,156 @@
+import { execa } from "execa"
+
+import { getOriginalCwd } from "@/cli/cwd"
+import type { HostContext } from "@/deck/host-context"
+import { getHostContext } from "@/deck/host-context"
+
+export interface ActionResult {
+  stdout: string
+  stderr: string
+  exitCode: number
+  durationMs: number
+}
+
+export class ActionError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = "ActionError"
+  }
+}
+
+export interface ActionExecutorOptions {
+  cwd?: string
+  env?: Readonly<Record<string, string>>
+  /** Kill the command after this many milliseconds. */
+  timeoutMs?: number
+}
+
+export interface ActionExecutor {
+  run(command: string, options?: ActionExecutorOptions): Promise<ActionResult>
+}
+
+const PLACEHOLDER_RE = /\{\{\s*host\.([a-zA-Z]+)\s*\}\}/g
+
+const KNOWN_HOST_KEYS: ReadonlySet<keyof HostContext | string> = new Set([
+  "hostname",
+  "platform",
+  "username",
+  "homedir",
+  "arch",
+])
+
+const shellSingleQuote = (value: string): string => {
+  // ponytail: shell-quote a value so it can be embedded inside a single-quoted
+  // POSIX sh string. The only escape sequence for that is '\'' (close, escape,
+  // reopen). Anything else is passed through verbatim.
+  return `'${value.replaceAll(`'`, `'\\''`)}'`
+}
+
+const interpolate = (command: string, host: HostContext): string => {
+  const remaining = new Set<string>()
+  const replaced = command.replace(PLACEHOLDER_RE, (_match, key: string) => {
+    if (!KNOWN_HOST_KEYS.has(key)) {
+      remaining.add(key)
+      return `{{ host.${key} }}`
+    }
+    if (key === "hostname") return shellSingleQuote(host.hostname)
+    if (key === "platform") return shellSingleQuote(host.platform)
+    if (key === "arch") return shellSingleQuote(host.arch)
+    if (key === "username") return shellSingleQuote(host.userInfo.username)
+    if (key === "homedir") return shellSingleQuote(host.userInfo.homedir)
+    return `{{ host.${key} }}`
+  })
+  if (remaining.size > 0) {
+    throw new ActionError(
+      `Unknown host placeholder(s): ${[...remaining].map((k) => `{{ host.${k} }}`).join(", ")}`,
+    )
+  }
+  return replaced
+}
+
+export interface CreateActionExecutorOptions {
+  host: HostContext
+}
+
+export const createActionExecutor = (
+  options: CreateActionExecutorOptions,
+): ActionExecutor => {
+  const run = async (
+    command: string,
+    runOptions: ActionExecutorOptions = {},
+  ): Promise<ActionResult> => {
+    const interpolated = interpolate(command, options.host)
+    const cwd = runOptions.cwd ?? getOriginalCwd()
+    const env = runOptions.env
+      ? { ...process.env, ...runOptions.env }
+      : process.env
+    const started = Date.now()
+    const result = await execa("/bin/sh", ["-c", interpolated], {
+      cwd,
+      env,
+      reject: false,
+      all: false,
+      ...(runOptions.timeoutMs !== undefined
+        ? { timeoutMs: runOptions.timeoutMs }
+        : {}),
+    })
+    return {
+      stdout: result.stdout ?? "",
+      stderr: result.stderr ?? "",
+      exitCode: result.exitCode ?? -1,
+      durationMs: Date.now() - started,
+    }
+  }
+
+  return { run }
+}
+
+export interface ExecuteCommandOptions {
+  cwd?: string
+  env?: Readonly<Record<string, string>>
+  timeoutMs?: number
+}
+
+export interface ExecuteCommandResult {
+  stdout: string
+  stderr: string
+  exitCode: number
+  failed: boolean
+  code: number
+}
+
+export const executeCommand = async (
+  command: string,
+  options: ExecuteCommandOptions = {},
+): Promise<ExecuteCommandResult> => {
+  await getHostContext()
+  const cwd = options.cwd ?? getOriginalCwd()
+  const env = options.env ? { ...process.env, ...options.env } : process.env
+  try {
+    const result = await execa("/bin/sh", ["-c", command], {
+      cwd,
+      env,
+      reject: false,
+      all: false,
+      ...(options.timeoutMs !== undefined
+        ? { timeout: options.timeoutMs }
+        : {}),
+    })
+    return {
+      stdout: result.stdout ?? "",
+      stderr: result.stderr ?? "",
+      exitCode: result.exitCode ?? -1,
+      failed: result.exitCode !== 0,
+      code: result.exitCode ?? -1,
+    }
+  } catch (err) {
+    const error = err as { stdout?: string; stderr?: string; exitCode?: number }
+    return {
+      stdout: error.stdout ?? "",
+      stderr: error.stderr ?? "",
+      exitCode: error.exitCode ?? -1,
+      failed: true,
+      code: error.exitCode ?? -1,
+    }
+  }
+}

package/src/action/index.ts

@@ -0,0 +1,7 @@
+export type {
+  ActionExecutor,
+  ActionExecutorOptions,
+  ActionResult,
+} from "./executor"
+export { ActionError, createActionExecutor } from "./executor"
+export { NotImplementedError } from "@/util/errors"

package/src/addon/api-types.ts

@@ -0,0 +1,15 @@
+import type { AddonFrontend, AddonGeneratedDeck } from "./api"
+
+export const SIRENO_ADDON_API_VERSION = 1 as const
+
+export interface AddonPollerChannel {
+  readonly channel: string
+  readonly intervalMs: number
+  readonly poll: () => unknown | Promise<unknown>
+}
+
+export interface AddonPoller {
+  readonly channels: ReadonlyArray<AddonPollerChannel>
+}
+
+export type { AddonFrontend, AddonGeneratedDeck }