@floomhq/floom 1.0.63 → 2.0.0

package/dist/lib/api.js

@@ -1,142 +0,0 @@
-import { friendlyHttp, friendlyNetwork, FloomError } from "../errors.js";
-/**
- * Shared HTTP helpers for CLI commands. Mirrors the mcp-sync/lib/api.ts
- * patterns but throws FloomError instances so the CLI's printError gives
- * users a clean message instead of a stack trace.
- */
-export const DEFAULT_TIMEOUT_MS = 60_000;
-export async function floomFetch(url, action, opts = {}) {
-    const headers = { ...(opts.headers ?? {}) };
-    if (opts.token)
-        headers.authorization = `Bearer ${opts.token}`;
-    if (opts.body !== undefined)
-        headers["content-type"] = "application/json";
-    const attempts = Math.max(1, 1 + rateLimitRetries(opts.rateLimitRetries));
-    for (let attempt = 0; attempt < attempts; attempt += 1) {
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), requestTimeoutMs(opts.timeoutMs));
-        let res;
-        try {
-            res = await fetch(url, {
-                method: opts.method ?? "GET",
-                headers,
-                signal: controller.signal,
-                ...(opts.body !== undefined ? { body: JSON.stringify(opts.body) } : {}),
-            });
-        }
-        catch (err) {
-            if (err.name === "AbortError") {
-                throw new FloomError(`Request timed out while trying to ${action}.`, "Try again in a moment.");
-            }
-            throw friendlyNetwork(err);
-        }
-        finally {
-            clearTimeout(timer);
-        }
-        if (res.status === 429 && attempt < attempts - 1) {
-            await drainResponse(res);
-            await sleep(rateLimitDelayMs(res, attempt));
-            continue;
-        }
-        if (opts.checkOk !== false && !res.ok) {
-            throw friendlyHttp(res.status, action, await responseErrorDetail(res));
-        }
-        return res;
-    }
-    throw new FloomError(`Request failed (HTTP 429) while trying to ${action}.`);
-}
-function requestTimeoutMs(override) {
-    if (override !== undefined)
-        return override;
-    const fromEnv = Number(process.env.FLOOM_REQUEST_TIMEOUT_MS);
-    if (Number.isFinite(fromEnv) && fromEnv > 0)
-        return fromEnv;
-    return DEFAULT_TIMEOUT_MS;
-}
-function rateLimitRetries(override) {
-    if (override !== undefined)
-        return Math.max(0, Math.floor(override));
-    const fromEnv = Number(process.env.FLOOM_RATE_LIMIT_RETRIES);
-    if (Number.isFinite(fromEnv) && fromEnv >= 0)
-        return Math.floor(fromEnv);
-    return 8;
-}
-function rateLimitDelayMs(res, attempt) {
-    const retryAfter = res.headers.get("retry-after");
-    if (retryAfter) {
-        const seconds = Number(retryAfter);
-        if (Number.isFinite(seconds) && seconds >= 0) {
-            return capRateLimitDelay(seconds * 1000);
-        }
-        const dateMs = Date.parse(retryAfter);
-        if (Number.isFinite(dateMs)) {
-            return capRateLimitDelay(Math.max(0, dateMs - Date.now()));
-        }
-    }
-    const resetSeconds = Number(res.headers.get("x-ratelimit-reset"));
-    if (Number.isFinite(resetSeconds) && resetSeconds > 0) {
-        return capRateLimitDelay(Math.max(0, (resetSeconds * 1000) - Date.now()));
-    }
-    const base = Number(process.env.FLOOM_RATE_LIMIT_RETRY_MS);
-    const fallback = Number.isFinite(base) && base >= 0 ? base : 1_000;
-    return capRateLimitDelay(fallback * (attempt + 1));
-}
-function capRateLimitDelay(ms) {
-    const fromEnv = Number(process.env.FLOOM_RATE_LIMIT_MAX_WAIT_MS);
-    const max = Number.isFinite(fromEnv) && fromEnv > 0 ? fromEnv : 65_000;
-    return Math.min(Math.max(0, ms), max);
-}
-async function drainResponse(res) {
-    try {
-        await res.arrayBuffer();
-    }
-    catch {
-        // Ignore bodies from rate-limit responses; the retry decision is header-based.
-    }
-}
-async function responseErrorDetail(res) {
-    try {
-        const text = await res.text();
-        if (!text.trim())
-            return null;
-        try {
-            const json = JSON.parse(text);
-            const detail = typeof json.error === "string"
-                ? json.error
-                : typeof json.message === "string"
-                    ? json.message
-                    : null;
-            const hint = typeof json.hint === "string" ? json.hint : null;
-            return [detail, hint].filter(Boolean).join("\n") || null;
-        }
-        catch {
-            return text.trim().slice(0, 400);
-        }
-    }
-    catch {
-        return null;
-    }
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-export async function getJson(url, action, token) {
-    const res = await floomFetch(url, action, token ? { token } : {});
-    return (await res.json());
-}
-export async function getText(url, action, token) {
-    const res = await floomFetch(url, action, token ? { token } : {});
-    return res.text();
-}
-export async function postJson(url, action, token, body) {
-    const res = await floomFetch(url, action, { method: "POST", token, body });
-    return (await res.json());
-}
-export async function deleteRequest(url, action, token) {
-    const res = await floomFetch(url, action, { method: "DELETE", token });
-    return (await res.json());
-}
-export async function putJson(url, action, token, body) {
-    const res = await floomFetch(url, action, { method: "PUT", token, body });
-    return (await res.json());
-}

package/dist/lib/skill-labels.js

@@ -1,140 +0,0 @@
-/**
- * CLI-side mirror of the web's skill-labels: type label + tool label + a tiny
- * frontmatter parser for `requires:`. No React, no `gray-matter` — keep the
- * CLI dep tree thin.
- *
- * The frontmatter parser intentionally only supports two `requires` shapes:
- *   requires: [gmail, linear]
- *   requires:
- *     - gmail
- *     - linear
- *
- * That covers >99% of real skills. If a skill uses a more exotic YAML shape
- * we silently get an empty list — not a crash.
- */
-const SKILL_TYPE_LABELS = {
-    knowledge: "Knowledge",
-    instruction: "Instruction",
-    workflow: "Workflow",
-    skill: "Skill",
-};
-const TOOL_LABELS = {
-    gmail: "Gmail",
-    "google-mail": "Gmail",
-    calendar: "Google Calendar",
-    "google-calendar": "Google Calendar",
-    drive: "Google Drive",
-    "google-drive": "Google Drive",
-    docs: "Google Docs",
-    "google-docs": "Google Docs",
-    sheets: "Google Sheets",
-    "google-sheets": "Google Sheets",
-    github: "GitHub",
-    gitlab: "GitLab",
-    linear: "Linear",
-    notion: "Notion",
-    slack: "Slack",
-    intercom: "Intercom",
-    zendesk: "Zendesk",
-    hubspot: "HubSpot",
-    salesforce: "Salesforce",
-    stripe: "Stripe",
-    airtable: "Airtable",
-    jira: "Jira",
-    asana: "Asana",
-    trello: "Trello",
-    zapier: "Zapier",
-    composio: "Composio",
-    whatsapp: "WhatsApp",
-    telegram: "Telegram",
-    discord: "Discord",
-    twitter: "Twitter",
-    x: "X",
-    linkedin: "LinkedIn",
-    openai: "OpenAI",
-    anthropic: "Anthropic",
-    gemini: "Gemini",
-    claude: "Claude",
-    perplexity: "Perplexity",
-    supabase: "Supabase",
-    vercel: "Vercel",
-    resend: "Resend",
-    twilio: "Twilio",
-    webhook: "Webhook",
-    http: "HTTP",
-};
-export function formatType(value) {
-    if (!value)
-        return "Skill";
-    const normalized = value.toLowerCase();
-    return SKILL_TYPE_LABELS[normalized] ?? "Skill";
-}
-export function formatTool(slug) {
-    const normalized = slug.trim().toLowerCase();
-    if (!normalized)
-        return slug;
-    if (TOOL_LABELS[normalized])
-        return TOOL_LABELS[normalized];
-    return normalized
-        .split(/[-_\s]+/)
-        .filter(Boolean)
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-        .join(" ");
-}
-export function formatToolList(tools) {
-    return tools.map(formatTool).join(", ");
-}
-/**
- * Pull `requires:` out of YAML frontmatter. Returns a deduped lowercase list
- * or [] if absent / malformed.
- */
-export function extractRequires(body) {
-    if (!body)
-        return [];
-    const trimmed = body.replace(/^/, "");
-    if (!trimmed.startsWith("---"))
-        return [];
-    const end = trimmed.indexOf("\n---", 3);
-    if (end === -1)
-        return [];
-    const headerBlock = trimmed.slice(3, end);
-    const lines = headerBlock.split(/\r?\n/);
-    const seen = new Set();
-    const out = [];
-    for (let i = 0; i < lines.length; i++) {
-        const raw = lines[i] ?? "";
-        const line = raw.trim();
-        const inlineMatch = /^requires\s*:\s*\[(.*?)\]\s*$/i.exec(line);
-        if (inlineMatch) {
-            const inner = inlineMatch[1] ?? "";
-            for (const part of inner.split(",")) {
-                const value = part.trim().replace(/^['"]|['"]$/g, "").toLowerCase();
-                if (value && !seen.has(value)) {
-                    seen.add(value);
-                    out.push(value);
-                }
-            }
-            return out;
-        }
-        if (/^requires\s*:\s*$/i.test(line)) {
-            // Block form. Scan subsequent indented `- foo` lines until indent breaks.
-            for (let j = i + 1; j < lines.length; j++) {
-                const next = lines[j] ?? "";
-                const itemMatch = /^\s+-\s+(.+?)\s*$/.exec(next);
-                if (!itemMatch) {
-                    // First non-list line ends the block.
-                    if (next.trim() === "")
-                        continue;
-                    break;
-                }
-                const value = (itemMatch[1] ?? "").replace(/^['"]|['"]$/g, "").trim().toLowerCase();
-                if (value && !seen.has(value)) {
-                    seen.add(value);
-                    out.push(value);
-                }
-            }
-            return out;
-        }
-    }
-    return out;
-}

package/dist/library.js

@@ -1,102 +0,0 @@
-import ora from "ora";
-import { readConfig, resolveApiUrl } from "./config.js";
-import { deleteRequest, getJson, postJson, putJson } from "./lib/api.js";
-import { c, symbols } from "./ui.js";
-import { FloomError } from "./errors.js";
-function formatLibraryRow(lib) {
-    const name = lib.name ?? c.dim("(unnamed)");
-    const vis = c.dim(`[${lib.visibility}]`);
-    return `   ${c.cyan(lib.slug.padEnd(22))}  ${name}  ${vis}`;
-}
-export async function libraryList(opts = {}) {
-    const cfg = await readConfig();
-    const apiUrl = resolveApiUrl(cfg);
-    const spinner = opts.json ? null : ora({ text: c.dim("Loading libraries..."), color: "yellow" }).start();
-    let result;
-    try {
-        result = await getJson(`${apiUrl}/api/v1/libraries`, "load libraries", cfg?.accessToken);
-    }
-    finally {
-        spinner?.stop();
-    }
-    if (opts.json) {
-        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-        return;
-    }
-    process.stdout.write(`\n${symbols.dot}  ${c.bold("Public libraries")} ${c.dim(`(${result.libraries.length})`)}\n\n`);
-    if (result.libraries.length === 0) {
-        process.stdout.write(`   ${c.dim("No public libraries yet.")}\n\n`);
-        return;
-    }
-    for (const lib of result.libraries)
-        process.stdout.write(`${formatLibraryRow(lib)}\n`);
-    process.stdout.write("\n");
-}
-export async function libraryCreate(opts) {
-    const cfg = await readConfig();
-    if (!cfg)
-        throw new FloomError("Not signed in.", "Run `npx -y @floomhq/floom login` first.");
-    const apiUrl = resolveApiUrl(cfg);
-    const result = await postJson(`${apiUrl}/api/v1/libraries`, "create library", cfg.accessToken, {
-        slug: opts.slug,
-        name: opts.name,
-        ...(opts.description !== undefined ? { description: opts.description } : {}),
-        ...(opts.visibility ? { visibility: opts.visibility } : {}),
-    });
-    process.stdout.write(`\n${symbols.ok}  Library created: ${c.cyan(result.slug)}\n`);
-    process.stdout.write(`   ${c.dim("API:")}  ${apiUrl}/api/v1/libraries/${result.slug}\n`);
-    process.stdout.write(`   ${c.dim("Sync:")} floom library subscribe ${result.slug}\n\n`);
-}
-export async function libraryAddSkill(opts) {
-    const cfg = await readConfig();
-    if (!cfg)
-        throw new FloomError("Not signed in.", "Run `npx -y @floomhq/floom login` first.");
-    const apiUrl = resolveApiUrl(cfg);
-    await postJson(`${apiUrl}/api/v1/libraries/${encodeURIComponent(opts.librarySlug)}/skills`, "add skill to library", cfg.accessToken, {
-        skill_slug: opts.skillSlug,
-        ...(opts.folder !== undefined ? { folder: opts.folder } : {}),
-        ...(opts.tags ? { tags: opts.tags } : {}),
-    });
-    const folderText = opts.folder ?? c.dim("(root)");
-    const tagsText = opts.tags?.length ? opts.tags.join(", ") : c.dim("(none)");
-    process.stdout.write(`\n${symbols.ok}  Added ${c.cyan(opts.skillSlug)} to ${c.cyan(opts.librarySlug)}\n`);
-    process.stdout.write(`   ${c.dim("folder:")} ${folderText}\n`);
-    process.stdout.write(`   ${c.dim("tags:")}   ${tagsText}\n\n`);
-}
-export async function libraryRemoveSkill(librarySlug, skillSlug) {
-    const cfg = await readConfig();
-    if (!cfg)
-        throw new FloomError("Not signed in.", "Run `npx -y @floomhq/floom login` first.");
-    const apiUrl = resolveApiUrl(cfg);
-    await deleteRequest(`${apiUrl}/api/v1/libraries/${encodeURIComponent(librarySlug)}/skills/${encodeURIComponent(skillSlug)}`, "remove skill from library", cfg.accessToken);
-    process.stdout.write(`\n${symbols.ok}  Removed ${c.cyan(skillSlug)} from ${c.cyan(librarySlug)}\n\n`);
-}
-export async function librarySubscribe(slug) {
-    const cfg = await readConfig();
-    if (!cfg)
-        throw new FloomError("Not signed in.", "Run `npx -y @floomhq/floom login` first.");
-    const apiUrl = resolveApiUrl(cfg);
-    await postJson(`${apiUrl}/api/v1/me/subscriptions`, "subscribe to library", cfg.accessToken, { library_slug: slug });
-    process.stdout.write(`\n${symbols.ok}  Subscribed to ${c.cyan(slug)}\n`);
-    process.stdout.write(`   ${c.dim("Run `floom sync --target claude` or `floom sync --target codex` to pull this library locally.")}\n\n`);
-}
-export async function libraryUnsubscribe(slug) {
-    const cfg = await readConfig();
-    if (!cfg)
-        throw new FloomError("Not signed in.", "Run `npx -y @floomhq/floom login` first.");
-    const apiUrl = resolveApiUrl(cfg);
-    await deleteRequest(`${apiUrl}/api/v1/me/subscriptions/${encodeURIComponent(slug)}`, "unsubscribe from library", cfg.accessToken);
-    process.stdout.write(`\n${symbols.ok}  Unsubscribed from ${c.cyan(slug)}\n\n`);
-}
-export async function moveSkill(opts) {
-    const cfg = await readConfig();
-    if (!cfg)
-        throw new FloomError("Not signed in.", "Run `npx -y @floomhq/floom login` first.");
-    const apiUrl = resolveApiUrl(cfg);
-    await putJson(`${apiUrl}/api/v1/me/skills/${encodeURIComponent(opts.slug)}/override`, "set skill override", cfg.accessToken, { folder: opts.folder, tags: opts.tags });
-    const folderText = opts.folder ?? c.dim("(root)");
-    const tagsText = opts.tags.length ? opts.tags.join(", ") : c.dim("(none)");
-    process.stdout.write(`\n${symbols.ok}  Moved ${c.cyan(opts.slug)}\n`);
-    process.stdout.write(`   ${c.dim("folder:")} ${folderText}\n`);
-    process.stdout.write(`   ${c.dim("tags:")}   ${tagsText}\n\n`);
-}

package/dist/list.js

@@ -1,79 +0,0 @@
-import ora from "ora";
-import { readConfig, resolveApiUrl } from "./config.js";
-import { getJson } from "./lib/api.js";
-import { extractRequires, formatToolList, formatType } from "./lib/skill-labels.js";
-import { c, symbols } from "./ui.js";
-import { FloomError } from "./errors.js";
-import { formatVersionLabel } from "./version.js";
-function formatRow(s) {
-    const title = s.title ?? c.dim("(untitled)");
-    const visibility = c.dim(`[${s.visibility}]`);
-    const type = c.dim(`[${formatType(s.asset_type)}]`);
-    const version = s.version ? c.dim(formatVersionLabel(s.version)) : "";
-    const updated = c.dim(formatRelative(s.updated_at));
-    const requires = extractRequires(s.body_md);
-    const needs = requires.length > 0 ? c.dim(`needs ${formatToolList(requires)}`) : "";
-    return `   ${c.cyan(s.slug.padEnd(14))}  ${title}  ${type}  ${visibility}  ${version}  ${updated}${needs ? `  ${needs}` : ""}`;
-}
-function formatRelative(iso) {
-    const diff = Date.now() - new Date(iso).getTime();
-    if (Number.isNaN(diff))
-        return iso;
-    const sec = Math.floor(diff / 1000);
-    if (sec < 60)
-        return `${sec}s ago`;
-    const min = Math.floor(sec / 60);
-    if (min < 60)
-        return `${min}m ago`;
-    const hr = Math.floor(min / 60);
-    if (hr < 24)
-        return `${hr}h ago`;
-    const day = Math.floor(hr / 24);
-    if (day < 30)
-        return `${day}d ago`;
-    return new Date(iso).toISOString().slice(0, 10);
-}
-export async function list(opts) {
-    const cfg = await readConfig();
-    if (!cfg) {
-        throw new FloomError("Not signed in.", "Run `npx -y @floomhq/floom login` first.");
-    }
-    const apiUrl = resolveApiUrl(cfg);
-    const spinner = opts.json ? null : ora({ text: c.dim("Loading skills..."), color: "yellow" }).start();
-    let published = [];
-    try {
-        let cursor;
-        const seenCursors = new Set();
-        for (let page = 0; page < 1000; page += 1) {
-            const url = new URL(`${apiUrl}/api/v1/me/skills`);
-            url.searchParams.set("limit", "100");
-            url.searchParams.set("scope", "owned");
-            if (cursor)
-                url.searchParams.set("cursor", cursor);
-            const mine = await getJson(url.toString(), "load your skills", cfg.accessToken);
-            published.push(...(mine.skills ?? []));
-            if (!mine.next_cursor)
-                break;
-            if (seenCursors.has(mine.next_cursor))
-                throw new FloomError("Invalid skills response.");
-            seenCursors.add(mine.next_cursor);
-            cursor = mine.next_cursor;
-        }
-    }
-    finally {
-        spinner?.stop();
-    }
-    if (opts.json) {
-        process.stdout.write(`${JSON.stringify({ published }, null, 2)}\n`);
-        return;
-    }
-    process.stdout.write(`\n${symbols.dot}  ${c.bold("Skills")} ${c.dim(`(${published.length})`)}\n\n`);
-    if (published.length === 0) {
-        process.stdout.write(`   ${c.dim("Nothing published yet. Try `npx -y @floomhq/floom publish my-skill`.")}\n`);
-    }
-    else {
-        for (const s of published)
-            process.stdout.write(`${formatRow(s)}\n`);
-    }
-    process.stdout.write("\n");
-}