guesty-cli 1.0.0

package/dist/commands/init.js

@@ -0,0 +1,109 @@
+import { Command } from "commander";
+import { createInterface } from "node:readline";
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const CONFIG_DIR = join(homedir(), ".guesty-cli");
+const ENV_FILE = join(CONFIG_DIR, ".env");
+function prompt(question, mask = false) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        if (mask && process.stdin.isTTY) {
+            process.stdout.write(question);
+            let value = "";
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+            process.stdin.setEncoding("utf8");
+            const onData = (ch) => {
+                if (ch === "\r" || ch === "\n") {
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                    process.stdin.removeListener("data", onData);
+                    rl.close();
+                    process.stdout.write("\n");
+                    resolve(value);
+                }
+                else if (ch === "\u0003") {
+                    process.exit(1);
+                }
+                else if (ch === "\u007F" || ch === "\b") {
+                    if (value.length > 0) {
+                        value = value.slice(0, -1);
+                        process.stdout.write("\b \b");
+                    }
+                }
+                else {
+                    value += ch;
+                    process.stdout.write("*");
+                }
+            };
+            process.stdin.on("data", onData);
+        }
+        else {
+            rl.question(question, (answer) => {
+                rl.close();
+                resolve(answer.trim());
+            });
+        }
+    });
+}
+async function testCredentials(clientId, clientSecret) {
+    try {
+        const res = await fetch("https://open-api.guesty.com/oauth2/token", {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: new URLSearchParams({
+                grant_type: "client_credentials",
+                scope: "open-api",
+                client_id: clientId,
+                client_secret: clientSecret,
+            }),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export const init = new Command("init")
+    .description("Set up Guesty CLI with your API credentials")
+    .option("--force", "Overwrite existing configuration")
+    .action(async (opts) => {
+    process.stdout.write("\n  Guesty CLI Setup\n");
+    process.stdout.write("  ================\n\n");
+    if (existsSync(ENV_FILE) && !opts.force) {
+        const existing = readFileSync(ENV_FILE, "utf8");
+        if (existing.includes("GUESTY_CLIENT_ID")) {
+            process.stdout.write("  Already configured. Run 'guesty init --force' to reconfigure.\n\n");
+            return;
+        }
+    }
+    process.stdout.write("  You'll need your Guesty Open API credentials.\n");
+    process.stdout.write("  Get them from: Guesty Dashboard > Marketplace > Open API\n\n");
+    const clientId = await prompt("  Client ID: ");
+    if (!clientId) {
+        process.stderr.write("\n  Error: Client ID is required.\n\n");
+        process.exit(1);
+    }
+    const clientSecret = await prompt("  Client Secret: ", true);
+    if (!clientSecret) {
+        process.stderr.write("\n  Error: Client Secret is required.\n\n");
+        process.exit(1);
+    }
+    process.stdout.write("\n  Verifying credentials...");
+    const valid = await testCredentials(clientId, clientSecret);
+    if (!valid) {
+        process.stdout.write(" failed.\n\n");
+        process.stderr.write("  Error: Invalid credentials. Check your Client ID and Secret.\n");
+        process.stderr.write("  Note: This uses 1 of your 5 daily token requests for verification.\n\n");
+        process.exit(1);
+    }
+    process.stdout.write(" verified.\n");
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    const envContent = `GUESTY_CLIENT_ID=${clientId}\nGUESTY_CLIENT_SECRET=${clientSecret}\n`;
+    writeFileSync(ENV_FILE, envContent);
+    process.stdout.write(`\n  Configuration saved to ${ENV_FILE}\n`);
+    process.stdout.write("  You're all set! Try: guesty res list --limit 1\n\n");
+});

package/dist/commands/integrations.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const integrations: Command;

package/dist/commands/integrations.js

@@ -0,0 +1,62 @@
+import { Command } from "commander";
+import { guestyFetch } from "../client.js";
+import { print } from "../output.js";
+export const integrations = new Command("integrations")
+    .alias("int")
+    .description("Manage integrations and channels");
+integrations
+    .command("list")
+    .description("List all integrations")
+    .action(async () => {
+    const data = await guestyFetch("/v1/integrations");
+    print(data);
+});
+integrations
+    .command("get <id>")
+    .description("Get an integration by ID")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/integrations/${id}`);
+    print(data);
+});
+integrations
+    .command("channels")
+    .description("List supported marketing channels")
+    .action(async () => {
+    const data = await guestyFetch("/v1/marketing/channels");
+    print(data);
+});
+integrations
+    .command("promotions")
+    .description("List all promotions")
+    .action(async () => {
+    const data = await guestyFetch("/v1/rm-promotions/promotions");
+    print(data);
+});
+integrations
+    .command("rate-plans")
+    .description("List all rate plans")
+    .action(async () => {
+    const data = await guestyFetch("/v1/rm-rate-plans-ext/rate-plans");
+    print(data);
+});
+integrations
+    .command("rate-plan <id>")
+    .description("Get a rate plan by ID")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/rm-rate-plans-ext/rate-plans/${id}`);
+    print(data);
+});
+integrations
+    .command("views")
+    .description("List all views")
+    .action(async () => {
+    const data = await guestyFetch("/v1/views");
+    print(data);
+});
+integrations
+    .command("view <id>")
+    .description("Get a view by ID")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/views/${id}`);
+    print(data);
+});

package/dist/commands/listings.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const listings: Command;

package/dist/commands/listings.js

@@ -0,0 +1,72 @@
+import { Command } from "commander";
+import { guestyFetch, paginateAll } from "../client.js";
+import { print } from "../output.js";
+import { readStdin } from "../stdin.js";
+export const listings = new Command("listings")
+    .alias("ls")
+    .description("Manage listings");
+listings
+    .command("list")
+    .description("List all listings")
+    .option("--fields <fields>", "Comma-separated fields to return")
+    .option("--limit <n>", "Max results", "100")
+    .option("--skip <n>", "Offset", "0")
+    .option("--all", "Fetch all pages")
+    .option("--active", "Only active listings")
+    .action(async (opts) => {
+    const params = {
+        limit: parseInt(opts.limit),
+        skip: parseInt(opts.skip),
+    };
+    if (opts.fields)
+        params.fields = opts.fields;
+    if (opts.active)
+        params.active = true;
+    if (opts.all) {
+        const results = await paginateAll("/v1/listings", params, "results");
+        print(results);
+    }
+    else {
+        const data = await guestyFetch("/v1/listings", { params });
+        print(data);
+    }
+});
+listings
+    .command("get <id>")
+    .description("Get a single listing by ID")
+    .option("--fields <fields>", "Comma-separated fields to return")
+    .action(async (id, opts) => {
+    const params = {};
+    if (opts.fields)
+        params.fields = opts.fields;
+    const data = await guestyFetch(`/v1/listings/${id}`, { params });
+    print(data);
+});
+listings
+    .command("update <id>")
+    .description("Update a listing (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (id, opts) => {
+    const body = opts.data
+        ? JSON.parse(opts.data)
+        : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/listings/${id}`, {
+        method: "PUT",
+        body,
+    });
+    print(data);
+});
+listings
+    .command("custom-fields <id>")
+    .description("Get custom fields for a listing")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/listings/${id}/custom-fields`);
+    print(data);
+});
+listings
+    .command("financials <id>")
+    .description("Get financial settings for a listing")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/financials/${id}`);
+    print(data);
+});

package/dist/commands/owners.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const owners: Command;

package/dist/commands/owners.js

@@ -0,0 +1,76 @@
+import { Command } from "commander";
+import { guestyFetch } from "../client.js";
+import { print } from "../output.js";
+import { readStdin } from "../stdin.js";
+export const owners = new Command("owners")
+    .description("Manage owners and ownerships");
+owners
+    .command("list")
+    .description("List all owners")
+    .option("--limit <n>", "Max results", "25")
+    .option("--skip <n>", "Offset", "0")
+    .action(async (opts) => {
+    const data = await guestyFetch("/v1/owners", {
+        params: { limit: parseInt(opts.limit), skip: parseInt(opts.skip) },
+    });
+    print(data);
+});
+owners
+    .command("get <ownerId>")
+    .description("Get a single owner")
+    .action(async (ownerId) => {
+    const data = await guestyFetch(`/v1/owners/${ownerId}`);
+    print(data);
+});
+owners
+    .command("create")
+    .description("Create an owner (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch("/v1/owners", { method: "POST", body });
+    print(data);
+});
+owners
+    .command("update <ownerId>")
+    .description("Update an owner (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (ownerId, opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/owners/${ownerId}`, { method: "PUT", body });
+    print(data);
+});
+owners
+    .command("delete <ownerId>")
+    .description("Delete an owner")
+    .action(async (ownerId) => {
+    const data = await guestyFetch(`/v1/owners/${ownerId}`, { method: "DELETE" });
+    print(data);
+});
+owners
+    .command("ownerships <listingId>")
+    .description("Get ownerships for a listing")
+    .action(async (listingId) => {
+    const data = await guestyFetch(`/v1/owners/listings/${listingId}/ownerships`);
+    print(data);
+});
+owners
+    .command("set-ownerships <listingId>")
+    .description("Set ownerships for a listing (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (listingId, opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/owners/listings/${listingId}/ownerships`, { method: "PUT", body });
+    print(data);
+});
+owners
+    .command("reservations")
+    .description("List owner reservations")
+    .option("--limit <n>", "Max results", "25")
+    .option("--skip <n>", "Offset", "0")
+    .action(async (opts) => {
+    const data = await guestyFetch("/v1/owners-reservations", {
+        params: { limit: parseInt(opts.limit), skip: parseInt(opts.skip) },
+    });
+    print(data);
+});

package/dist/commands/properties.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const properties: Command;

package/dist/commands/properties.js

@@ -0,0 +1,104 @@
+import { Command } from "commander";
+import { guestyFetch } from "../client.js";
+import { print } from "../output.js";
+import { readStdin } from "../stdin.js";
+export const properties = new Command("properties")
+    .alias("prop")
+    .description("Property settings: amenities, photos, spaces, house rules, complexes");
+properties
+    .command("amenities <propertyId>")
+    .description("Get amenities for a property")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/properties-api/amenities/${id}`);
+    print(data);
+});
+properties
+    .command("set-amenities <propertyId>")
+    .description("Set amenities for a property (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (id, opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/properties-api/amenities/${id}`, { method: "PUT", body });
+    print(data);
+});
+properties
+    .command("supported-amenities")
+    .description("List all supported amenities")
+    .action(async () => {
+    const data = await guestyFetch("/v1/properties-api/amenities/supported");
+    print(data);
+});
+properties
+    .command("photos <propertyId>")
+    .description("Get all photos for a property")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/properties-api/property-photos/property-photos/${id}`);
+    print(data);
+});
+properties
+    .command("add-photos <propertyId>")
+    .description("Add photos to a property (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (id, opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/properties-api/property-photos/property-photos/${id}`, { method: "POST", body });
+    print(data);
+});
+properties
+    .command("spaces <unitTypeId>")
+    .description("Get spaces for a unit type")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/properties/spaces/unit-type/${id}`);
+    print(data);
+});
+properties
+    .command("house-rules <unitTypeId>")
+    .description("Get house rules for a unit type")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/properties/house-rules/unit-type/${id}`);
+    print(data);
+});
+properties
+    .command("set-house-rules <unitTypeId>")
+    .description("Update house rules (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (id, opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/properties/house-rules/unit-type/${id}`, { method: "PUT", body });
+    print(data);
+});
+properties
+    .command("address <propertyId>")
+    .description("Get property address")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/address/${id}`);
+    print(data);
+});
+properties
+    .command("complexes")
+    .description("List all complexes")
+    .action(async () => {
+    const data = await guestyFetch("/v1/properties-api/complexes");
+    print(data);
+});
+properties
+    .command("complex <id>")
+    .description("Get a complex by ID")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/properties-api/complexes/${id}`);
+    print(data);
+});
+properties
+    .command("logs <propertyId>")
+    .description("Get property logs")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/property-logs/${id}`);
+    print(data);
+});
+properties
+    .command("custom-fields <propertyId>")
+    .description("Get custom fields for a property")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/properties-api/custom-fields/${id}`);
+    print(data);
+});

package/dist/commands/quotes.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const quotes: Command;

package/dist/commands/quotes.js

@@ -0,0 +1,31 @@
+import { Command } from "commander";
+import { guestyFetch } from "../client.js";
+import { print } from "../output.js";
+import { readStdin } from "../stdin.js";
+export const quotes = new Command("quotes")
+    .description("Manage quotes");
+quotes
+    .command("get <quoteId>")
+    .description("Get a quote by ID")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/quotes/${id}`);
+    print(data);
+});
+quotes
+    .command("create")
+    .description("Create a quote (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch("/v1/quotes", { method: "POST", body });
+    print(data);
+});
+quotes
+    .command("create-multiple")
+    .description("Create multiple quotes (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : JSON.parse(await readStdin());
+    const data = await guestyFetch("/v1/quotes/multiple", { method: "POST", body });
+    print(data);
+});

package/dist/commands/raw.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const raw: Command;

package/dist/commands/raw.js

@@ -0,0 +1,19 @@
+import { Command } from "commander";
+import { guestyFetch } from "../client.js";
+import { print } from "../output.js";
+export const raw = new Command("raw")
+    .description("Make a raw API call to any Guesty endpoint")
+    .argument("<method>", "HTTP method (GET, POST, PUT, DELETE, PATCH)")
+    .argument("<path>", "API path (e.g. /v1/listings)")
+    .option("--data <json>", "JSON body")
+    .option("--params <json>", "Query params as JSON")
+    .action(async (method, path, opts) => {
+    const body = opts.data ? JSON.parse(opts.data) : undefined;
+    const params = opts.params ? JSON.parse(opts.params) : undefined;
+    const data = await guestyFetch(path, {
+        method: method.toUpperCase(),
+        body,
+        params,
+    });
+    print(data);
+});

package/dist/commands/reservations.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const reservations: Command;

package/dist/commands/reservations.js

@@ -0,0 +1,126 @@
+import { Command } from "commander";
+import { guestyFetch, paginateAll } from "../client.js";
+import { print } from "../output.js";
+import { readStdin } from "../stdin.js";
+export const reservations = new Command("reservations")
+    .alias("res")
+    .description("Manage reservations");
+reservations
+    .command("list")
+    .description("List reservations with optional filters")
+    .option("--from <date>", "Check-in from date (YYYY-MM-DD)")
+    .option("--to <date>", "Check-in to date (YYYY-MM-DD)")
+    .option("--status <status>", "Filter by status (confirmed, canceled, inquiry, etc.)")
+    .option("--listing <id>", "Filter by listing ID")
+    .option("--guest <name>", "Filter by guest name")
+    .option("--source <source>", "Filter by source (Airbnb, Booking.com, etc.)")
+    .option("--limit <n>", "Max results", "25")
+    .option("--skip <n>", "Offset", "0")
+    .option("--sort <field>", "Sort field", "checkIn")
+    .option("--fields <fields>", "Comma-separated fields to return")
+    .option("--all", "Fetch all pages (up to 10k)")
+    .action(async (opts) => {
+    const params = {
+        limit: parseInt(opts.limit),
+        skip: parseInt(opts.skip),
+        sort: opts.sort,
+    };
+    if (opts.fields)
+        params.fields = opts.fields;
+    if (opts.status)
+        params.status = opts.status;
+    if (opts.listing)
+        params.listingId = opts.listing;
+    if (opts.source)
+        params.source = opts.source;
+    const filters = [];
+    if (opts.from)
+        filters.push(`checkIn>=${opts.from}`);
+    if (opts.to)
+        filters.push(`checkIn<=${opts.to}`);
+    if (opts.guest)
+        filters.push(`guestName=${opts.guest}`);
+    if (filters.length > 0)
+        params.filters = filters.join(",");
+    if (opts.all) {
+        const results = await paginateAll("/v1/reservations", params, "results");
+        print(results);
+    }
+    else {
+        const data = await guestyFetch("/v1/reservations", { params });
+        print(data);
+    }
+});
+reservations
+    .command("get <id>")
+    .description("Get a single reservation by ID")
+    .option("--fields <fields>", "Comma-separated fields to return")
+    .action(async (id, opts) => {
+    const params = {};
+    if (opts.fields)
+        params.fields = opts.fields;
+    const data = await guestyFetch(`/v1/reservations/${id}`, { params });
+    print(data);
+});
+reservations
+    .command("search <query>")
+    .description("Search reservations by guest name or confirmation code")
+    .option("--limit <n>", "Max results", "25")
+    .action(async (query, opts) => {
+    const data = await guestyFetch("/v1/reservations", {
+        params: {
+            q: query,
+            limit: parseInt(opts.limit),
+        },
+    });
+    print(data);
+});
+reservations
+    .command("update <id>")
+    .description("Update a reservation (pass JSON body via stdin or --data)")
+    .option("--data <json>", "JSON body")
+    .action(async (id, opts) => {
+    const body = opts.data
+        ? JSON.parse(opts.data)
+        : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/reservations/${id}`, {
+        method: "PUT",
+        body,
+    });
+    print(data);
+});
+reservations
+    .command("create")
+    .description("Create a reservation (pass JSON body via stdin or --data)")
+    .option("--data <json>", "JSON body")
+    .action(async (opts) => {
+    const body = opts.data
+        ? JSON.parse(opts.data)
+        : JSON.parse(await readStdin());
+    const data = await guestyFetch("/v1/reservations", {
+        method: "POST",
+        body,
+    });
+    print(data);
+});
+reservations
+    .command("balance <id>")
+    .description("Get the folio/balance for a reservation")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/accounting-api/reservations/${id}/balance`);
+    print(data);
+});
+reservations
+    .command("add-payment <id>")
+    .description("Add a payment to a reservation (--data or stdin)")
+    .option("--data <json>", "JSON body")
+    .action(async (id, opts) => {
+    const body = opts.data
+        ? JSON.parse(opts.data)
+        : JSON.parse(await readStdin());
+    const data = await guestyFetch(`/v1/reservations/${id}/payments`, {
+        method: "POST",
+        body,
+    });
+    print(data);
+});

package/dist/commands/reviews.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const reviews: Command;

package/dist/commands/reviews.js

@@ -0,0 +1,39 @@
+import { Command } from "commander";
+import { guestyFetch } from "../client.js";
+import { print } from "../output.js";
+export const reviews = new Command("reviews")
+    .description("Manage reviews");
+reviews
+    .command("list")
+    .description("List reviews")
+    .option("--listing <id>", "Filter by listing ID")
+    .option("--limit <n>", "Max results", "25")
+    .option("--skip <n>", "Offset", "0")
+    .action(async (opts) => {
+    const params = {
+        limit: parseInt(opts.limit),
+        skip: parseInt(opts.skip),
+    };
+    if (opts.listing)
+        params.listingId = opts.listing;
+    const data = await guestyFetch("/v1/reviews", { params });
+    print(data);
+});
+reviews
+    .command("get <id>")
+    .description("Get a single review")
+    .action(async (id) => {
+    const data = await guestyFetch(`/v1/reviews/${id}`);
+    print(data);
+});
+reviews
+    .command("reply <id>")
+    .description("Reply to a review")
+    .requiredOption("--body <text>", "Reply text")
+    .action(async (id, opts) => {
+    const data = await guestyFetch(`/v1/reviews/${id}/reply`, {
+        method: "POST",
+        body: { body: opts.body },
+    });
+    print(data);
+});