freeturtle 0.1.0

package/dist/src/cli/connect-farcaster.js

@@ -0,0 +1,265 @@
+import * as p from "@clack/prompts";
+import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { ViemLocalEip712Signer } from "@farcaster/hub-nodejs";
+import { bytesToHex, hexToBytes } from "viem";
+import { mnemonicToAccount } from "viem/accounts";
+import qrcode from "qrcode-terminal";
+const NEYNAR_BASE = "https://api.neynar.com/v2/farcaster";
+async function neynarPost(path, apiKey, body) {
+    const res = await fetch(`${NEYNAR_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+        },
+        ...(body ? { body: JSON.stringify(body) } : {}),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Neynar API error (${res.status}): ${text}`);
+    }
+    return res.json();
+}
+async function neynarGet(path, apiKey) {
+    const res = await fetch(`${NEYNAR_BASE}${path}`, {
+        headers: { "x-api-key": apiKey },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Neynar API error (${res.status}): ${text}`);
+    }
+    return res.json();
+}
+async function lookupFidByCustodyAddress(apiKey, address) {
+    const data = (await neynarGet(`/user/custody-address?custody_address=${address}`, apiKey));
+    return data.user.fid;
+}
+async function pollSignerStatus(apiKey, signerUuid, maxWaitMs = 180_000) {
+    const start = Date.now();
+    while (Date.now() - start < maxWaitMs) {
+        const data = (await neynarGet(`/signer?signer_uuid=${signerUuid}`, apiKey));
+        if (data.status === "approved")
+            return data;
+        await new Promise((r) => setTimeout(r, 3000));
+    }
+    throw new Error("Timed out waiting for approval");
+}
+export async function connectFarcaster(dir) {
+    p.intro("Connect Farcaster");
+    // Load existing .env values
+    const envPath = join(dir, ".env");
+    const existingEnv = {};
+    try {
+        const content = await readFile(envPath, "utf-8");
+        for (const line of content.split("\n")) {
+            const match = line.match(/^([A-Z_]+)=(.+)$/);
+            if (match)
+                existingEnv[match[1]] = match[2];
+        }
+    }
+    catch {
+        // No existing .env
+    }
+    p.note([
+        "You'll need:",
+        "",
+        "  1. Your Neynar API key (sign up at dev.neynar.com)",
+        "  2. The recovery phrase for the Farcaster account",
+        "     you want to post from",
+        "     Farcaster app → Settings → Advanced → Recovery phrase",
+        "",
+        "The recovery phrase is used locally to authorize the signer.",
+        "It is never sent to any server.",
+        "",
+        "After setup, a QR code will appear in your terminal.",
+        "Scan it with the Farcaster app to approve.",
+    ].join("\n"), "What you'll need");
+    let apiKey;
+    if (existingEnv.NEYNAR_API_KEY) {
+        const reuse = await p.confirm({
+            message: `Use existing Neynar API key? (${existingEnv.NEYNAR_API_KEY.slice(0, 8)}...)`,
+            initialValue: true,
+        });
+        if (p.isCancel(reuse)) {
+            p.cancel("Cancelled.");
+            return null;
+        }
+        if (reuse) {
+            apiKey = existingEnv.NEYNAR_API_KEY;
+        }
+        else {
+            const result = await p.text({
+                message: "Neynar API key",
+                validate: (v) => (v?.trim() ? undefined : "Required"),
+            });
+            if (p.isCancel(result)) {
+                p.cancel("Cancelled.");
+                return null;
+            }
+            apiKey = result;
+        }
+    }
+    else {
+        const result = await p.text({
+            message: "Neynar API key",
+            validate: (v) => (v?.trim() ? undefined : "Required"),
+        });
+        if (p.isCancel(result)) {
+            p.cancel("Cancelled.");
+            return null;
+        }
+        apiKey = result;
+    }
+    const mnemonic = await p.text({
+        message: "Farcaster recovery phrase (12 words, space-separated)",
+        placeholder: "word1 word2 word3 ... word12",
+        validate: (v) => {
+            if (!v?.trim())
+                return "Required";
+            const words = v.trim().split(/\s+/);
+            if (words.length !== 12)
+                return `Expected 12 words, got ${words.length}`;
+            return undefined;
+        },
+    });
+    if (p.isCancel(mnemonic)) {
+        p.cancel("Cancelled.");
+        return null;
+    }
+    const s = p.spinner();
+    // Step 1: Derive custody address and look up FID
+    s.start("Looking up your Farcaster account");
+    let fid;
+    let account;
+    try {
+        account = mnemonicToAccount(mnemonic);
+        fid = await lookupFidByCustodyAddress(apiKey, account.address);
+    }
+    catch (err) {
+        s.stop("Failed");
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        p.log.error(`Could not find Farcaster account: ${msg}`);
+        return null;
+    }
+    s.stop(`Found account (FID: ${fid})`);
+    // Step 2: Create signer
+    s.start("Creating signer");
+    let signer;
+    try {
+        signer = (await neynarPost("/signer", apiKey));
+    }
+    catch (err) {
+        s.stop("Failed");
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        p.log.error(`Could not create signer: ${msg}`);
+        return null;
+    }
+    s.stop("Signer created");
+    // Step 3: Sign the key request locally
+    s.start("Authorizing signer");
+    let sigHex;
+    let deadline;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const appAccountKey = new ViemLocalEip712Signer(account);
+        deadline = Math.floor(Date.now() / 1000) + 86400;
+        const keyBytes = hexToBytes(signer.public_key);
+        const signature = await appAccountKey.signKeyRequest({
+            requestFid: BigInt(fid),
+            key: keyBytes,
+            deadline: BigInt(deadline),
+        });
+        if (signature.isErr()) {
+            throw new Error("Signature generation failed");
+        }
+        sigHex = bytesToHex(signature.value);
+    }
+    catch (err) {
+        s.stop("Failed");
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        p.log.error(`Could not authorize signer: ${msg}`);
+        return null;
+    }
+    s.stop("Signer authorized");
+    // Step 4: Register signed key to get approval URL
+    s.start("Registering with Neynar");
+    let registeredSigner;
+    try {
+        registeredSigner = (await neynarPost("/signer/signed_key", apiKey, {
+            signer_uuid: signer.signer_uuid,
+            app_fid: fid,
+            deadline,
+            signature: sigHex,
+        }));
+    }
+    catch (err) {
+        s.stop("Failed");
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        p.log.error(`Could not register signer: ${msg}`);
+        return null;
+    }
+    s.stop("Registered");
+    if (!registeredSigner.signer_approval_url) {
+        p.log.error("No approval URL returned from Neynar.");
+        return null;
+    }
+    // Step 5: Show QR code
+    p.log.info("Scan this QR code with the Farcaster app to approve:\n");
+    await new Promise((resolve) => {
+        qrcode.generate(registeredSigner.signer_approval_url, { small: true }, (code) => {
+            console.log(code);
+            resolve();
+        });
+    });
+    console.log(`\n  Or open: ${registeredSigner.signer_approval_url}\n`);
+    // Step 6: Poll for approval
+    s.start("Waiting for approval (scan the QR code above)");
+    let approved;
+    try {
+        approved = await pollSignerApproval(apiKey, signer.signer_uuid);
+    }
+    catch {
+        s.stop("Timed out");
+        p.log.warn("Signer not yet approved. You can re-run this command to try again.");
+        return null;
+    }
+    s.stop("Signer approved!");
+    const approvedFid = String(approved.fid ?? fid);
+    // Step 7: Save to .env
+    let envContent = "";
+    try {
+        envContent = await readFile(envPath, "utf-8");
+    }
+    catch {
+        // No existing .env
+    }
+    const envVars = {
+        NEYNAR_API_KEY: apiKey,
+        FARCASTER_SIGNER_UUID: signer.signer_uuid,
+        FARCASTER_FID: approvedFid,
+    };
+    for (const [key, value] of Object.entries(envVars)) {
+        const regex = new RegExp(`^${key}=.*$`, "m");
+        if (regex.test(envContent)) {
+            envContent = envContent.replace(regex, `${key}=${value}`);
+        }
+        else {
+            envContent += `${envContent.endsWith("\n") || envContent === "" ? "" : "\n"}${key}=${value}\n`;
+        }
+    }
+    await mkdir(dirname(envPath), { recursive: true });
+    await writeFile(envPath, envContent, "utf-8");
+    await chmod(envPath, 0o600);
+    p.log.success("Credentials saved to .env");
+    p.outro("Farcaster connected!");
+    return {
+        neynarKey: apiKey,
+        signerUuid: signer.signer_uuid,
+        fid: approvedFid,
+    };
+}
+async function pollSignerApproval(apiKey, signerUuid, maxWaitMs = 180_000) {
+    return pollSignerStatus(apiKey, signerUuid, maxWaitMs);
+}
+//# sourceMappingURL=connect-farcaster.js.map

package/dist/src/cli/connect-farcaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-farcaster.js","sourceRoot":"","sources":["../../../src/cli/connect-farcaster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC,MAAM,WAAW,GAAG,qCAAqC,CAAC;AAU1D,KAAK,UAAU,UAAU,CACvB,IAAY,EACZ,MAAc,EACd,IAA8B;IAE9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,EAAE,EAAE;QAC/C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,WAAW,EAAE,MAAM;SACpB;QACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,IAAY,EACZ,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,EAAE,EAAE;QAC/C,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;KACjC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,MAAc,EACd,OAAe;IAEf,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,CAC3B,yCAAyC,OAAO,EAAE,EAClD,MAAM,CACP,CAA8B,CAAC;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAc,EACd,UAAkB,EAClB,SAAS,GAAG,OAAO;IAEnB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,CAC3B,uBAAuB,UAAU,EAAE,EACnC,MAAM,CACP,CAAmB,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAKhD,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAE7B,4BAA4B;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC7C,IAAI,KAAK;gBAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IAED,CAAC,CAAC,IAAI,CACJ;QACE,cAAc;QACd,EAAE;QACF,sDAAsD;QACtD,oDAAoD;QACpD,4BAA4B;QAC5B,4DAA4D;QAC5D,EAAE;QACF,8DAA8D;QAC9D,iCAAiC;QACjC,EAAE;QACF,sDAAsD;QACtD,4CAA4C;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,kBAAkB,CACnB,CAAC;IAEF,IAAI,MAAc,CAAC;IACnB,IAAI,WAAW,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;YAC5B,OAAO,EAAE,iCAAiC,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM;YACtF,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAC/D,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,WAAW,CAAC,cAAc,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBAC1B,OAAO,EAAE,gBAAgB;gBACzB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;aACtD,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YAChE,MAAM,GAAG,MAAM,CAAC;QAClB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YAC1B,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;SACtD,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAChE,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;QAC5B,OAAO,EAAE,uDAAuD;QAChE,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACd,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;gBAAE,OAAO,UAAU,CAAC;YAClC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;gBACrB,OAAO,0BAA0B,KAAK,CAAC,MAAM,EAAE,CAAC;YAClD,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAElE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAEtB,iDAAiD;IACjD,CAAC,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,OAA6C,CAAC;IAClD,IAAI,CAAC;QACH,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACtC,GAAG,GAAG,MAAM,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACjE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,uBAAuB,GAAG,GAAG,CAAC,CAAC;IAEtC,wBAAwB;IACxB,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC3B,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAmB,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACjE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAEzB,uCAAuC;IACvC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC9B,IAAI,MAAc,CAAC;IACnB,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,aAAa,GAAG,IAAI,qBAAqB,CAAC,OAAc,CAAC,CAAC;QAChE,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;QACjD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,UAA2B,CAAC,CAAC;QAEhE,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC;YACnD,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC;YACvB,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACjE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAE5B,kDAAkD;IAClD,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACnC,IAAI,gBAAgC,CAAC;IACrC,IAAI,CAAC;QACH,gBAAgB,GAAG,CAAC,MAAM,UAAU,CAAC,oBAAoB,EAAE,MAAM,EAAE;YACjE,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,GAAG;YACZ,QAAQ;YACR,SAAS,EAAE,MAAM;SAClB,CAAC,CAAmB,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACjE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAErB,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,CAAC;QAC1C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uBAAuB;IACvB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACrE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,mBAAoB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,gBAAgB,gBAAgB,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAEtE,4BAA4B;IAC5B,CAAC,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACzD,IAAI,QAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE3B,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IAEhD,uBAAuB;IACvB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,MAAM;QACtB,qBAAqB,EAAE,MAAM,CAAC,WAAW;QACzC,aAAa,EAAE,WAAW;KAC3B,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,UAAU,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC;QACjG,CAAC;IACH,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAE3C,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAEhC,OAAO;QACL,SAAS,EAAE,MAAM;QACjB,UAAU,EAAE,MAAM,CAAC,WAAW;QAC9B,GAAG,EAAE,WAAW;KACjB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,MAAc,EACd,UAAkB,EAClB,SAAS,GAAG,OAAO;IAEnB,OAAO,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC"}

package/dist/src/cli/connection-tests.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test a Telegram bot token by calling getMe.
+ */
+export declare function testTelegram(token: string): Promise<void>;
+/**
+ * Test a GitHub personal access token by calling /user.
+ */
+export declare function testGitHub(token: string): Promise<void>;
+/**
+ * Test a Postgres connection URL by connecting and immediately disconnecting.
+ */
+export declare function testDatabase(url: string): Promise<void>;
+/**
+ * Test an EVM RPC URL by calling eth_blockNumber.
+ */
+export declare function testOnchain(rpcUrl: string): Promise<void>;

package/dist/src/cli/connection-tests.js

@@ -0,0 +1,65 @@
+import pg from "pg";
+/**
+ * Test a Telegram bot token by calling getMe.
+ */
+export async function testTelegram(token) {
+    const res = await fetch(`https://api.telegram.org/bot${token}/getMe`);
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Telegram API error (${res.status}): ${body}`);
+    }
+    const data = (await res.json());
+    if (!data.ok) {
+        throw new Error(`Telegram returned error: ${data.description ?? "unknown"}`);
+    }
+}
+/**
+ * Test a GitHub personal access token by calling /user.
+ */
+export async function testGitHub(token) {
+    const res = await fetch("https://api.github.com/user", {
+        headers: {
+            Authorization: `Bearer ${token}`,
+            Accept: "application/vnd.github+json",
+        },
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`GitHub API error (${res.status}): ${body}`);
+    }
+}
+/**
+ * Test a Postgres connection URL by connecting and immediately disconnecting.
+ */
+export async function testDatabase(url) {
+    const client = new pg.Client({ connectionString: url });
+    try {
+        await client.connect();
+    }
+    finally {
+        await client.end().catch(() => { });
+    }
+}
+/**
+ * Test an EVM RPC URL by calling eth_blockNumber.
+ */
+export async function testOnchain(rpcUrl) {
+    const res = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            method: "eth_blockNumber",
+            params: [],
+            id: 1,
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`RPC error (${res.status}): ${await res.text()}`);
+    }
+    const data = (await res.json());
+    if (data.error) {
+        throw new Error(`RPC error: ${data.error.message}`);
+    }
+}
+//# sourceMappingURL=connection-tests.js.map

package/dist/src/cli/connection-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-tests.js","sourceRoot":"","sources":["../../../src/cli/connection-tests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,KAAK,QAAQ,CAAC,CAAC;IACtE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAC;IACzE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa;IAC5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,6BAA6B,EAAE;QACrD,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,MAAM,EAAE,6BAA6B;SACtC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;QAC9B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,EAAE;YACV,EAAE,EAAE,CAAC;SACN,CAAC;KACH,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoC,CAAC;IACnE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/src/cli/init.d.ts

@@ -0,0 +1 @@
+export declare function runInit(dir: string): Promise<void>;