pi-spotify-widget 0.1.0

package/lib/widget-render.ts

@@ -0,0 +1,122 @@
+import type { PlaybackSnapshot } from "./playback-snapshot.ts";
+
+type ThemeColor = "accent" | "dim" | "muted" | "success" | "error";
+type Theme = {
+  fg: (color: ThemeColor, text: string) => string;
+};
+
+const defaultTheme: Theme = {
+  fg: (_color, text) => text,
+};
+
+const SEEK_BAR_WIDTH = 18;
+const MAX_META_LEN = 48;
+
+function ageText(fetchedAt: number, now = Date.now()): string {
+  const seconds = Math.max(0, Math.floor((now - fetchedAt) / 1000));
+  return `updated ${seconds}s ago`;
+}
+
+function staleHint(stale: boolean, theme: Theme): string {
+  return stale ? theme.fg("dim", " (stale)") : "";
+}
+
+function truncate(text: string, max: number): string {
+  const trimmed = text.trim();
+  if (trimmed.length <= max) return trimmed;
+  return `${trimmed.slice(0, Math.max(0, max - 1))}…`;
+}
+
+export function formatClock(ms: number): string {
+  const totalSec = Math.max(0, Math.floor(ms / 1000));
+  const hours = Math.floor(totalSec / 3600);
+  const minutes = Math.floor((totalSec % 3600) / 60);
+  const seconds = totalSec % 60;
+  const sec = seconds.toString().padStart(2, "0");
+  if (hours > 0) {
+    return `${hours}:${minutes.toString().padStart(2, "0")}:${sec}`;
+  }
+  return `${minutes}:${sec}`;
+}
+
+export function effectiveProgressMs(snapshot: PlaybackSnapshot, now = Date.now()): number | undefined {
+  if (typeof snapshot.progressMs !== "number" || !Number.isFinite(snapshot.progressMs)) {
+    return undefined;
+  }
+  if (!snapshot.isPlaying) return Math.max(0, snapshot.progressMs);
+  const elapsed = Math.max(0, now - snapshot.fetchedAt);
+  const live = snapshot.progressMs + elapsed;
+  if (typeof snapshot.durationMs === "number" && snapshot.durationMs > 0) {
+    return Math.min(snapshot.durationMs, live);
+  }
+  return live;
+}
+
+export function renderSeekBar(
+  progressMs: number,
+  durationMs: number,
+  options?: { width?: number; isPlaying?: boolean },
+): string {
+  const width = options?.width ?? SEEK_BAR_WIDTH;
+  const headChar = options?.isPlaying === false ? "◆" : "●";
+
+  if (durationMs <= 0) return "─".repeat(width);
+
+  const ratio = Math.min(1, Math.max(0, progressMs / durationMs));
+  const head = Math.min(width - 1, Math.round(ratio * (width - 1)));
+  const chars: string[] = [];
+  for (let i = 0; i < width; i += 1) {
+    if (i < head) chars.push("━");
+    else if (i === head) chars.push(headChar);
+    else chars.push("─");
+  }
+  return chars.join("");
+}
+
+export function renderProgressLine(snapshot: PlaybackSnapshot, now = Date.now()): string | null {
+  const progressMs = effectiveProgressMs(snapshot, now);
+  if (progressMs === undefined) return null;
+
+  const current = formatClock(progressMs);
+  if (typeof snapshot.durationMs !== "number" || snapshot.durationMs <= 0) {
+    return `${current} elapsed`;
+  }
+
+  const bar = renderSeekBar(progressMs, snapshot.durationMs, { isPlaying: snapshot.isPlaying });
+  return `${current} ${bar} ${formatClock(snapshot.durationMs)}`;
+}
+
+export function renderNoAuth(theme: Theme = defaultTheme): string[] {
+  return [theme.fg("dim", "♫ Run /spotify:login")];
+}
+
+export function renderIdle(snapshot: PlaybackSnapshot | null, theme: Theme = defaultTheme, options?: { stale?: boolean; now?: number }): string[] {
+  const stale = options?.stale ?? false;
+  return [theme.fg("dim", `♫ Nothing playing${stale ? " (stale)" : ""}`)];
+}
+
+export function renderSnapshot(snapshot: PlaybackSnapshot, theme: Theme = defaultTheme, options?: { stale?: boolean; now?: number }): string[] {
+  const now = options?.now ?? Date.now();
+  const stale = options?.stale ?? false;
+  const icon = snapshot.isPlaying ? "▶" : "⏸";
+  const meta = truncate(`${snapshot.track} — ${snapshot.artist}`, MAX_META_LEN);
+  const progressLine = renderProgressLine(snapshot, now);
+
+  const lines = [theme.fg("accent", `♫ ${icon} ${meta}${staleHint(stale, theme)}`)];
+  if (progressLine) {
+    lines.push(theme.fg("muted", progressLine));
+  }
+  return lines;
+}
+
+export function renderError(message: string, theme: Theme = defaultTheme): string[] {
+  return [theme.fg("error", `♫ Spotify: ${message}`)];
+}
+
+export const __testing = {
+  ageText,
+  effectiveProgressMs,
+  formatClock,
+  renderProgressLine,
+  renderSeekBar,
+};

package/lib/x-share.ts

@@ -0,0 +1,211 @@
+import { createHmac, randomBytes } from "node:crypto";
+import { spawn } from "node:child_process";
+import type { PlaybackSnapshot } from "./playback-snapshot.ts";
+
+export interface XCredentials {
+  apiKey: string;
+  apiSecret: string;
+  accessToken: string;
+  accessTokenSecret: string;
+}
+
+export type ShareMode = "intent" | "api";
+
+export interface ShareResult {
+  mode: ShareMode;
+  text: string;
+  tweetUrl?: string;
+  intentUrl?: string;
+}
+
+export const PI_INSTALL_URL = "https://pi.dev";
+export const SPOTIFY_PACKAGE_INSTALL = "pi install npm:pi-spotify-widget";
+
+const X_TWEET_ENDPOINT = "https://api.twitter.com/2/tweets";
+const X_INTENT_BASE = "https://twitter.com/intent/tweet";
+
+export function resolveXCredentials(env: NodeJS.ProcessEnv = process.env): XCredentials | null {
+  const apiKey = env.PI_X_API_KEY?.trim() || env.X_API_KEY?.trim();
+  const apiSecret = env.PI_X_API_SECRET?.trim() || env.X_API_SECRET?.trim();
+  const accessToken = env.PI_X_ACCESS_TOKEN?.trim() || env.X_ACCESS_TOKEN?.trim();
+  const accessTokenSecret = env.PI_X_ACCESS_TOKEN_SECRET?.trim() || env.X_ACCESS_TOKEN_SECRET?.trim();
+  if (!apiKey || !apiSecret || !accessToken || !accessTokenSecret) return null;
+  return { apiKey, apiSecret, accessToken, accessTokenSecret };
+}
+
+export function buildNowPlayingShareText(
+  snapshot: PlaybackSnapshot,
+  customPrefix?: string,
+): string {
+  const icon = snapshot.isPlaying ? "▶" : "⏸";
+  const core = `${icon} ${snapshot.track} — ${snapshot.artist}`;
+  const withUrl = snapshot.spotifyUrl ? `${core}\n${snapshot.spotifyUrl}` : core;
+  const prefix = customPrefix?.trim();
+  if (!prefix) return withUrl;
+  return `${prefix}\n\n${withUrl}`;
+}
+
+export function buildShareIntentUrl(text: string): string {
+  return `${X_INTENT_BASE}?text=${encodeURIComponent(text)}`;
+}
+
+
+/** Soccer-widget style X post: headline, track, install steps, note, hashtags. */
+export function buildSpotifySharePostText(
+  snapshot: PlaybackSnapshot,
+  customPrefix?: string,
+): string {
+  const icon = snapshot.isPlaying ? "▶" : "⏸";
+  const headline = customPrefix?.trim() || "Now playing on Pi";
+  const lines: string[] = [
+    `${headline} 🎧`,
+    `${icon} ${snapshot.track} — ${snapshot.artist}`,
+  ];
+  if (snapshot.spotifyUrl) lines.push(snapshot.spotifyUrl);
+  lines.push(
+    "Try it:",
+    `1 install ${PI_INSTALL_URL}`,
+    `2 ${SPOTIFY_PACKAGE_INSTALL}`,
+    "3 /spotify:login",
+    "4 /spotify:share",
+    "BYO Spotify Client ID. Login once in Pi.",
+    "#NowPlaying #Spotify",
+  );
+  return lines.join("\n");
+}
+
+export function openSpotifySharePost(
+  snapshot: PlaybackSnapshot,
+  options: { customPrefix?: string; openUrl?: (url: string) => void } = {},
+): ShareResult {
+  const text = buildSpotifySharePostText(snapshot, options.customPrefix);
+  return openShareIntent(text, options);
+}
+
+/** Same browser launch as pi-soccer-widget (cmd start on Windows). */
+export function openBrowserUrl(url: string): void {
+  if (process.env.PI_SPOTIFY_DISABLE_OPEN === "1") return;
+
+  const platform = process.platform;
+  const command = platform === "win32" ? "cmd" : platform === "darwin" ? "open" : "xdg-open";
+  const args = platform === "win32" ? ["/c", "start", "", url] : [url];
+  const child = spawn(command, args, { detached: true, stdio: "ignore", shell: false });
+  child.unref?.();
+}
+
+export function openShareIntent(
+  text: string,
+  options: { openUrl?: (url: string) => void } = {},
+): ShareResult {
+  const intentUrl = buildShareIntentUrl(text);
+  (options.openUrl ?? openBrowserUrl)(intentUrl);
+  return { mode: "intent", text, intentUrl };
+}
+
+function percentEncode(value: string): string {
+  return encodeURIComponent(value).replace(/[!'()*]/g, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+
+function oauth1Signature(
+  method: string,
+  url: string,
+  oauthParams: Record<string, string>,
+  credentials: XCredentials,
+): string {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(oauthParams)) params.append(key, value);
+  const paramString = Array.from(params.entries())
+    .sort(([aKey, aVal], [bKey, bVal]) => (aKey === bKey ? aVal.localeCompare(bVal) : aKey.localeCompare(bKey)))
+    .map(([key, value]) => `${percentEncode(key)}=${percentEncode(value)}`)
+    .join("&");
+
+  const base = [
+    method.toUpperCase(),
+    percentEncode(url),
+    percentEncode(paramString),
+  ].join("&");
+
+  const signingKey = `${percentEncode(credentials.apiSecret)}&${percentEncode(credentials.accessTokenSecret)}`;
+  return createHmac("sha1", signingKey).update(base).digest("base64");
+}
+
+function oauth1Header(method: string, url: string, credentials: XCredentials): string {
+  const oauthParams: Record<string, string> = {
+    oauth_consumer_key: credentials.apiKey,
+    oauth_nonce: randomBytes(16).toString("hex"),
+    oauth_signature_method: "HMAC-SHA1",
+    oauth_timestamp: Math.floor(Date.now() / 1000).toString(),
+    oauth_token: credentials.accessToken,
+    oauth_version: "1.0",
+  };
+  oauthParams.oauth_signature = oauth1Signature(method, url, oauthParams, credentials);
+
+  const header = Object.entries(oauthParams)
+    .sort(([a], [b]) => a.localeCompare(b))
+    .map(([key, value]) => `${percentEncode(key)}="${percentEncode(value)}"`)
+    .join(", ");
+
+  return `OAuth ${header}`;
+}
+
+export async function postToXApi(
+  text: string,
+  options: { credentials?: XCredentials | null; fetchFn?: typeof fetch } = {},
+): Promise<ShareResult> {
+  const credentials = options.credentials ?? resolveXCredentials();
+  const fetchFn = options.fetchFn ?? fetch;
+  if (!credentials) {
+    throw new Error("X API credentials are not configured. Set PI_X_API_KEY and related env vars, or use /spotify:share without 'api'.");
+  }
+
+  const res = await fetchFn(X_TWEET_ENDPOINT, {
+    method: "POST",
+    headers: {
+      Authorization: oauth1Header("POST", X_TWEET_ENDPOINT, credentials),
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ text }),
+  });
+
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(`X post failed (HTTP ${res.status})${body ? `: ${body.slice(0, 160)}` : ""}`);
+  }
+
+  const payload = await res.json() as { data?: { id?: string } };
+  const id = payload.data?.id;
+  return {
+    mode: "api",
+    text,
+    tweetUrl: id ? `https://x.com/i/web/status/${id}` : undefined,
+  };
+}
+
+export async function shareToX(
+  text: string,
+  options: { mode?: ShareMode; credentials?: XCredentials | null; fetchFn?: typeof fetch; openUrl?: (url: string) => void } = {},
+): Promise<ShareResult> {
+  const mode = options.mode ?? "intent";
+  if (mode === "intent") return openShareIntent(text, options);
+  return postToXApi(text, options);
+}
+
+/** @deprecated use shareToX */
+export async function postToX(
+  text: string,
+  options: { credentials?: XCredentials | null; fetchFn?: typeof fetch; openUrl?: (url: string) => void } = {},
+): Promise<ShareResult> {
+  return shareToX(text, { ...options, mode: "intent" });
+}
+
+export const __testing = {
+  buildNowPlayingShareText,
+  buildShareIntentUrl,
+  oauth1Signature,
+  buildSpotifySharePostText,
+  openBrowserUrl,
+  openShareIntent,
+  openSpotifySharePost,
+  resolveXCredentials,
+  shareToX,
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "pi-spotify-widget",
+  "version": "0.1.0",
+  "description": "Lightweight Spotify Now Playing widget for Pi Coding Agent.",
+  "type": "module",
+  "license": "MIT",
+  "author": "eiei114",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "agent-skill",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eiei114/pi-spotify-widget.git"
+  },
+  "bugs": {
+    "url": "https://github.com/eiei114/pi-spotify-widget/issues"
+  },
+  "homepage": "https://github.com/eiei114/pi-spotify-widget#readme",
+  "files": [
+    "extensions/",
+    "lib/",
+    "docs/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "skills/"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "node --test tests/*.test.mjs",
+    "ci": "npm run typecheck && npm test && npm run pack:check",
+    "pack:check": "npm pack --dry-run"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ],
+    "skills": [
+      "./skills/spotify-playback"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "latest",
+    "@earendil-works/pi-coding-agent": "latest",
+    "@earendil-works/pi-tui": "latest",
+    "typebox": "latest",
+    "@types/node": "^22.0.0",
+    "typescript": "^6.0.3"
+  }
+}

package/skills/spotify-playback/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: spotify-playback
+description: Control Spotify playback and share now playing to X from Pi.
+---
+
+# Spotify Playback & Share
+
+When the user asks about music control or sharing, run the matching Pi command.
+
+## Playback
+
+| User intent | Run |
+|---|---|
+| 前の曲 / previous | `/spotify:prev` |
+| 次の曲 / skip / next | `/spotify:next` |
+| 止めて / stop / pause | `/spotify:pause` |
+| 再生 / resume / play | `/spotify:play` |
+
+If the user wants to play a specific track by URL, run `/spotify:play-uri <spotify-url>`.
+
+## Share to X (soccer-widget style)
+
+| User intent | Run |
+|---|---|
+| Xに投稿 / シェア / tweet this song | `/spotify:share` |
+| コメント付きでシェア | `/spotify:share <your message>` |
+
+Opens X compose with prefilled text (track, install steps, hashtags). Screenshot upload is manual.