@supercycle/cli 0.1.0

package/dist/commands/login.js

@@ -0,0 +1,76 @@
+import { Box, Text, useApp } from "ink";
+import TextInput from "ink-text-input";
+import { option } from "pastel";
+import React, { useState, useEffect } from "react";
+import zod from "zod";
+import ErrorMessage from "../components/ErrorMessage.js";
+import Loading from "../components/Loading.js";
+import { SupercycleClient } from "../lib/client.js";
+import { saveConfig, getBaseUrl, configPath } from "../lib/config.js";
+export const description = "Store and validate your Supercycle API key";
+export const options = zod.object({
+    key: zod
+        .string()
+        .optional()
+        .describe(option({
+        description: "API key (skips the interactive prompt)",
+    })),
+});
+export default function Login({ options }) {
+    const { exit } = useApp();
+    const [value, setValue] = useState("");
+    const [phase, setPhase] = useState(options.key ? { name: "validating" } : { name: "prompt" });
+    async function validateAndSave(key) {
+        const trimmed = key.trim();
+        if (!trimmed) {
+            setPhase({ name: "error", message: "No API key provided." });
+            return;
+        }
+        setPhase({ name: "validating" });
+        const client = new SupercycleClient({
+            token: trimmed,
+            baseUrl: getBaseUrl(),
+        });
+        try {
+            await client.listCycles({ limit: 1 });
+            saveConfig({ apiKey: trimmed, baseUrl: getBaseUrl() });
+            setPhase({ name: "done" });
+        }
+        catch (error) {
+            setPhase({
+                name: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // If a key was passed as a flag, validate it immediately.
+    useEffect(() => {
+        if (options.key) {
+            void validateAndSave(options.key);
+        }
+    }, [options]);
+    // Exit (with the right code) once we reach a terminal phase.
+    useEffect(() => {
+        if (phase.name === "done") {
+            exit();
+        }
+        else if (phase.name === "error") {
+            process.exitCode = 1;
+            exit();
+        }
+    }, [phase, exit]);
+    if (phase.name === "prompt") {
+        return (React.createElement(Box, null,
+            React.createElement(Text, null, "Enter your Supercycle API key: "),
+            React.createElement(TextInput, { value: value, onChange: setValue, onSubmit: validateAndSave, mask: "*" })));
+    }
+    if (phase.name === "validating") {
+        return React.createElement(Loading, { label: "Validating API key\u2026" });
+    }
+    if (phase.name === "error") {
+        return React.createElement(ErrorMessage, { message: phase.message });
+    }
+    return React.createElement(Text, { color: "green" },
+        "\u2714 API key saved to ",
+        configPath());
+}

package/dist/commands/products/import.js

@@ -0,0 +1,65 @@
+import { Box, Text } from "ink";
+import { option } from "pastel";
+import React from "react";
+import zod from "zod";
+import ErrorMessage from "../../components/ErrorMessage.js";
+import ExitError from "../../components/ExitError.js";
+import JsonOutput from "../../components/JsonOutput.js";
+import Loading from "../../components/Loading.js";
+import { useAsync } from "../../hooks/useAsync.js";
+import { resolveClient, NO_TOKEN_HINT } from "../../lib/resolveClient.js";
+export const description = "Import Shopify products into Supercycle by ID";
+export const options = zod.object({
+    ids: zod
+        .string()
+        .describe(option({ description: "Comma-separated Shopify product IDs to import (required)" })),
+    json: zod
+        .boolean()
+        .default(false)
+        .describe(option({ description: "Output raw JSON" })),
+});
+function parseIds(raw) {
+    const ids = [];
+    for (const part of raw.split(",")) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const id = Number(trimmed);
+        if (!Number.isInteger(id) || id <= 0)
+            return null;
+        ids.push(id);
+    }
+    return ids.length > 0 ? ids : null;
+}
+export default function Import({ options }) {
+    const ids = parseIds(options.ids);
+    const resolved = resolveClient();
+    const state = useAsync(async () => {
+        if (!ids)
+            throw new Error("Provide one or more numeric product IDs via --ids.");
+        if (!resolved.client)
+            throw new Error(resolved.error);
+        return resolved.client.importProducts(ids);
+    }, []);
+    if (state.loading) {
+        return options.json ? null : React.createElement(Loading, { label: "Importing products\u2026" });
+    }
+    if (state.error) {
+        if (options.json)
+            return React.createElement(ExitError, { message: state.error.message });
+        return (React.createElement(ErrorMessage, { message: state.error.message, hint: resolved.error ? NO_TOKEN_HINT : undefined }));
+    }
+    if (options.json) {
+        return React.createElement(JsonOutput, { data: state.data });
+    }
+    const imported = state.data.productIds ?? [];
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, { color: "green" },
+            "\u2714 Imported ",
+            imported.length,
+            " product",
+            imported.length === 1 ? "" : "s"),
+        imported.length > 0 ? React.createElement(Text, { dimColor: true },
+            "IDs: ",
+            imported.join(", ")) : null));
+}

package/dist/commands/products/index.js

@@ -0,0 +1,3 @@
+// Group landing: description only (no default export) so Pastel falls through
+// to Commander's auto-generated help listing the subcommands.
+export const description = "List and import products";

package/dist/commands/products/list.js

@@ -0,0 +1,19 @@
+import React from "react";
+import zod from "zod";
+import ProductsListView from "../../components/ProductsListView.js";
+import { listViewShape } from "../../lib/listViewOptions.js";
+export const description = "List products, optionally filtered by search";
+export const options = zod.object({
+    ...listViewShape(),
+});
+function buildFilters(options) {
+    const view = options;
+    return {
+        search: view.search,
+        limit: view.limit,
+        page: view.page,
+    };
+}
+export default function List({ options }) {
+    return React.createElement(ProductsListView, { filters: buildFilters(options), all: options.all, json: options.json });
+}

package/dist/commands/returns/comment.js

@@ -0,0 +1,29 @@
+import { argument, option } from "pastel";
+import React from "react";
+import zod from "zod";
+import CommentResultView from "../../components/CommentResultView.js";
+import ErrorMessage from "../../components/ErrorMessage.js";
+export const description = "Add a comment to a return's timeline";
+export const args = zod.tuple([
+    zod.string().describe(argument({ name: "id", description: "Numeric return ID" })),
+    zod.string().describe(argument({ name: "message", description: "Comment text" })),
+]);
+export const options = zod.object({
+    json: zod
+        .boolean()
+        .default(false)
+        .describe(option({ description: "Output raw JSON" })),
+});
+export default function Comment({ args, options }) {
+    const [id, message] = args;
+    if (!message.trim()) {
+        return React.createElement(ErrorMessage, { message: "Comment message cannot be empty." });
+    }
+    return (React.createElement(CommentResultView, { loadingLabel: `Adding comment to return ${id}…`, action: (client) => client.createTimelineComment({
+            timelineEvent: {
+                eventableId: Number(id),
+                eventableType: "ReturnOrder",
+                message,
+            },
+        }), json: options.json }));
+}

package/dist/commands/returns/get.js

@@ -0,0 +1,50 @@
+import { argument, option } from "pastel";
+import React from "react";
+import zod from "zod";
+import ErrorMessage from "../../components/ErrorMessage.js";
+import ExitError from "../../components/ExitError.js";
+import JsonOutput from "../../components/JsonOutput.js";
+import Loading from "../../components/Loading.js";
+import ReturnDetail from "../../components/ReturnDetail.js";
+import { useAsync } from "../../hooks/useAsync.js";
+import { resolveClient, NO_TOKEN_HINT } from "../../lib/resolveClient.js";
+export const description = "Retrieve a single return by ID";
+export const args = zod.tuple([
+    zod.string().describe(argument({
+        name: "id",
+        description: "Numeric ID of the return",
+    })),
+]);
+export const options = zod.object({
+    include: zod
+        .string()
+        .optional()
+        .describe(option({
+        description: "Relations to include, e.g. timelineEvents",
+    })),
+    json: zod
+        .boolean()
+        .default(false)
+        .describe(option({ description: "Output raw JSON" })),
+});
+export default function Get({ args, options }) {
+    const [id] = args;
+    const resolved = resolveClient();
+    const state = useAsync(async () => {
+        if (!resolved.client)
+            throw new Error(resolved.error);
+        return resolved.client.getReturn(id, { include: options.include });
+    }, []);
+    if (state.loading) {
+        return options.json ? null : React.createElement(Loading, { label: `Fetching return ${id}…` });
+    }
+    if (state.error) {
+        if (options.json)
+            return React.createElement(ExitError, { message: state.error.message });
+        return (React.createElement(ErrorMessage, { message: state.error.message, hint: resolved.error ? NO_TOKEN_HINT : undefined }));
+    }
+    if (options.json) {
+        return React.createElement(JsonOutput, { data: state.data });
+    }
+    return React.createElement(ReturnDetail, { order: state.data });
+}

package/dist/commands/returns/index.js

@@ -0,0 +1,3 @@
+// Group landing: description only (no default export) so Pastel falls through
+// to Commander's auto-generated help listing the subcommands.
+export const description = "List, inspect, and update returns";

package/dist/commands/returns/list.js

@@ -0,0 +1,27 @@
+import { option } from "pastel";
+import React from "react";
+import zod from "zod";
+import ReturnsListView from "../../components/ReturnsListView.js";
+import { listViewShape } from "../../lib/listViewOptions.js";
+export const description = "List returns, optionally filtered";
+export const options = zod.object({
+    ...listViewShape(),
+    status: zod
+        .string()
+        .optional()
+        .describe(option({
+        description: "Return status (comma-separated): requested,expected,received,in_progress,completed,cancelled",
+    })),
+});
+function buildFilters(options) {
+    const view = options;
+    return {
+        search: view.search,
+        limit: view.limit,
+        page: view.page,
+        status: options.status,
+    };
+}
+export default function List({ options }) {
+    return React.createElement(ReturnsListView, { filters: buildFilters(options), all: options.all, json: options.json });
+}

package/dist/commands/returns/update.js

@@ -0,0 +1,68 @@
+import { argument, option } from "pastel";
+import React from "react";
+import zod from "zod";
+import ErrorMessage from "../../components/ErrorMessage.js";
+import ReturnActionView from "../../components/ReturnActionView.js";
+export const description = "Update a return's status and/or line statuses";
+const lineStatus = ["awaiting", "received", "missing"];
+export const args = zod.tuple([
+    zod.string().describe(argument({ name: "id", description: "Numeric return ID" })),
+]);
+export const options = zod.object({
+    status: zod
+        .string()
+        .optional()
+        .describe(option({
+        description: "New return status: requested|expected|received|in_progress|completed|cancelled",
+    })),
+    line: zod
+        .string()
+        .optional()
+        .describe(option({
+        description: 'Set line statuses as "lineId:status" pairs, comma-separated (status: awaiting|received|missing). Line IDs come from `returns get <id>`.',
+    })),
+    json: zod
+        .boolean()
+        .default(false)
+        .describe(option({ description: "Output raw JSON" })),
+});
+// Parse a "12:received,13:missing" string into returnLines entries.
+function parseLines(raw) {
+    const lines = [];
+    for (const part of raw.split(",")) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const [idPart, statusPart] = trimmed.split(":");
+        const id = Number(idPart);
+        if (!Number.isInteger(id) || id <= 0) {
+            return { ok: false, error: `Invalid line ID in "${trimmed}". Expected "lineId:status".` };
+        }
+        if (!statusPart || !lineStatus.includes(statusPart)) {
+            return {
+                ok: false,
+                error: `Invalid status in "${trimmed}". Expected one of: ${lineStatus.join(", ")}.`,
+            };
+        }
+        lines.push({ id, status: statusPart });
+    }
+    return { ok: true, lines };
+}
+export default function Update({ args, options }) {
+    const [id] = args;
+    if (!options.status && !options.line) {
+        return React.createElement(ErrorMessage, { message: "Nothing to update. Pass --status and/or --line." });
+    }
+    const body = {};
+    if (options.status)
+        body.status = options.status;
+    if (options.line) {
+        const parsed = parseLines(options.line);
+        if (!parsed.ok) {
+            return React.createElement(ErrorMessage, { message: parsed.error });
+        }
+        if (parsed.lines.length > 0)
+            body.returnLines = parsed.lines;
+    }
+    return (React.createElement(ReturnActionView, { loadingLabel: `Updating return ${id}…`, action: (client) => client.updateReturn(id, body), successLabel: (o) => `Return #${o.sequentialId ?? o.id} updated`, json: options.json }));
+}

package/dist/components/CommentResultView.js

@@ -0,0 +1,40 @@
+import { Box, Text } from "ink";
+import React from "react";
+import { useAsync } from "../hooks/useAsync.js";
+import { resolveClient, NO_TOKEN_HINT } from "../lib/resolveClient.js";
+import ErrorMessage from "./ErrorMessage.js";
+import ExitError from "./ExitError.js";
+import JsonOutput from "./JsonOutput.js";
+import Loading from "./Loading.js";
+// Runs a create-timeline-comment action and reports the new comment.
+export default function CommentResultView({ action, loadingLabel = "Adding comment…", json, }) {
+    const resolved = resolveClient();
+    const state = useAsync(async () => {
+        if (!resolved.client)
+            throw new Error(resolved.error);
+        return action(resolved.client);
+    }, []);
+    if (state.loading) {
+        return json ? null : React.createElement(Loading, { label: loadingLabel });
+    }
+    if (state.error) {
+        if (json)
+            return React.createElement(ExitError, { message: state.error.message });
+        return (React.createElement(ErrorMessage, { message: state.error.message, hint: resolved.error ? NO_TOKEN_HINT : undefined }));
+    }
+    if (json) {
+        return React.createElement(JsonOutput, { data: state.data });
+    }
+    const comment = state.data;
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, { color: "green" },
+            "\u2714 Comment added to ",
+            comment.eventableType,
+            " ",
+            comment.eventableId,
+            " (comment ID ",
+            comment.id,
+            ")"),
+        React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, { dimColor: true }, comment.message))));
+}

package/dist/components/CustomFieldResultView.js

@@ -0,0 +1,46 @@
+import { Box, Text } from "ink";
+import React from "react";
+import { useAsync } from "../hooks/useAsync.js";
+import { dash } from "../lib/format.js";
+import { resolveClient, NO_TOKEN_HINT } from "../lib/resolveClient.js";
+import ErrorMessage from "./ErrorMessage.js";
+import ExitError from "./ExitError.js";
+import JsonOutput from "./JsonOutput.js";
+import Loading from "./Loading.js";
+// Runs a custom-field create/update action, then shows a confirmation line plus
+// the resulting field's key/value/owner.
+export default function CustomFieldResultView({ action, successLabel, loadingLabel = "Saving custom field…", json, }) {
+    const resolved = resolveClient();
+    const state = useAsync(async () => {
+        if (!resolved.client)
+            throw new Error(resolved.error);
+        return action(resolved.client);
+    }, []);
+    if (state.loading) {
+        return json ? null : React.createElement(Loading, { label: loadingLabel });
+    }
+    if (state.error) {
+        if (json)
+            return React.createElement(ExitError, { message: state.error.message });
+        return (React.createElement(ErrorMessage, { message: state.error.message, hint: resolved.error ? NO_TOKEN_HINT : undefined }));
+    }
+    if (json) {
+        return React.createElement(JsonOutput, { data: state.data });
+    }
+    const field = state.data;
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, { color: "green" },
+            "\u2714 ",
+            successLabel(field)),
+        React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+            React.createElement(Text, { dimColor: true },
+                dash(field.key),
+                " = ",
+                dash(field.value)),
+            React.createElement(Text, { dimColor: true },
+                field.ownerType,
+                " ",
+                field.ownerId,
+                " \u00B7 field ID ",
+                field.id))));
+}

package/dist/components/CycleActionView.js

@@ -0,0 +1,36 @@
+import { Box, Text } from "ink";
+import React from "react";
+import { useAsync } from "../hooks/useAsync.js";
+import { resolveClient, NO_TOKEN_HINT } from "../lib/resolveClient.js";
+import CycleDetail from "./CycleDetail.js";
+import ErrorMessage from "./ErrorMessage.js";
+import ExitError from "./ExitError.js";
+import JsonOutput from "./JsonOutput.js";
+import Loading from "./Loading.js";
+// Runs a single cycle-mutating action, then shows a confirmation line plus the
+// updated cycle (or raw JSON). Used by fulfil/receive/pack/reschedule/etc.
+export default function CycleActionView({ action, successLabel, loadingLabel = "Updating cycle…", json, }) {
+    const resolved = resolveClient();
+    const state = useAsync(async () => {
+        if (!resolved.client)
+            throw new Error(resolved.error);
+        return action(resolved.client);
+    }, []);
+    if (state.loading) {
+        return json ? null : React.createElement(Loading, { label: loadingLabel });
+    }
+    if (state.error) {
+        if (json)
+            return React.createElement(ExitError, { message: state.error.message });
+        return (React.createElement(ErrorMessage, { message: state.error.message, hint: resolved.error ? NO_TOKEN_HINT : undefined }));
+    }
+    if (json) {
+        return React.createElement(JsonOutput, { data: state.data });
+    }
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, { color: "green" },
+            "\u2714 ",
+            successLabel(state.data)),
+        React.createElement(Box, { marginTop: 1 },
+            React.createElement(CycleDetail, { cycle: state.data }))));
+}

package/dist/components/CycleDetail.js

@@ -0,0 +1,60 @@
+import { Box, Text } from "ink";
+import React from "react";
+import { customerName, formatDateTime, titleCase, dash, EMPTY } from "../lib/format.js";
+import Status from "./Status.js";
+function Section({ title, children }) {
+    return (React.createElement(Box, { flexDirection: "column", marginBottom: 1 },
+        React.createElement(Text, { bold: true, underline: true }, title),
+        children));
+}
+function Field({ label, children }) {
+    return (React.createElement(Box, null,
+        React.createElement(Box, { width: 18 },
+            React.createElement(Text, { dimColor: true }, label)),
+        React.createElement(Box, null, typeof children === "string" ? React.createElement(Text, null, children) : children)));
+}
+export default function CycleDetail({ cycle }) {
+    const { item, timelineEvents, tags, customFields } = cycle;
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Section, { title: `Cycle #${cycle.sequentialId ?? cycle.id}` },
+            React.createElement(Field, { label: "ID" }, String(cycle.id)),
+            React.createElement(Field, { label: "Order" }, dash(cycle.shopifyOrderName)),
+            React.createElement(Field, { label: "Method" }, titleCase(cycle.methodType)),
+            React.createElement(Field, { label: "Status" },
+                React.createElement(Status, { value: cycle.status })),
+            React.createElement(Field, { label: "Fulfillment" },
+                React.createElement(Status, { value: cycle.fulfillmentStatus })),
+            React.createElement(Field, { label: "Receival" },
+                React.createElement(Status, { value: cycle.receivalStatus })),
+            React.createElement(Field, { label: "Packing" },
+                React.createElement(Status, { value: cycle.packingStatus }))),
+        React.createElement(Section, { title: "Customer" },
+            React.createElement(Field, { label: "Name" }, customerName(cycle.customer)),
+            React.createElement(Field, { label: "Email" }, dash(cycle.customer?.email))),
+        item ? (React.createElement(Section, { title: "Item" },
+            React.createElement(Field, { label: "Product" }, dash(item.productTitle)),
+            React.createElement(Field, { label: "Variant" }, dash(item.variantTitle)),
+            React.createElement(Field, { label: "Serial" }, dash(item.serial)),
+            React.createElement(Field, { label: "Visibility" },
+                React.createElement(Status, { value: item.visibility })),
+            React.createElement(Field, { label: "Pick location" }, dash(item.pickLocation)))) : null,
+        React.createElement(Section, { title: "Dates" },
+            React.createElement(Field, { label: "Fulfill due" }, formatDateTime(cycle.fulfillAt)),
+            React.createElement(Field, { label: "Fulfilled" }, formatDateTime(cycle.fulfilledAt)),
+            React.createElement(Field, { label: "Rental start" }, formatDateTime(cycle.rentalStart)),
+            React.createElement(Field, { label: "Rental end" }, formatDateTime(cycle.rentalEnd)),
+            React.createElement(Field, { label: "Receive due" }, formatDateTime(cycle.receiveAt)),
+            React.createElement(Field, { label: "Received" }, formatDateTime(cycle.receivedAt)),
+            React.createElement(Field, { label: "Restock by" }, formatDateTime(cycle.restockBy)),
+            React.createElement(Field, { label: "Created" }, formatDateTime(cycle.createdAt)),
+            React.createElement(Field, { label: "Updated" }, formatDateTime(cycle.updatedAt))),
+        tags && tags.length > 0 ? (React.createElement(Section, { title: "Tags" },
+            React.createElement(Text, null, tags.join(", ")))) : null,
+        customFields && customFields.length > 0 ? (React.createElement(Section, { title: "Custom fields" }, customFields.map((field) => (React.createElement(Field, { key: field.id, label: field.key }, dash(field.value)))))) : null,
+        timelineEvents && timelineEvents.length > 0 ? (React.createElement(Section, { title: "Timeline" }, timelineEvents.map((event) => (React.createElement(Box, { key: event.id },
+            React.createElement(Box, { width: 20 },
+                React.createElement(Text, { dimColor: true, wrap: "truncate" }, formatDateTime(event.createdAt))),
+            React.createElement(Box, { width: 28 },
+                React.createElement(Text, { wrap: "truncate" }, titleCase(event.eventType))),
+            React.createElement(Text, { dimColor: true }, event.author ?? EMPTY)))))) : null));
+}

package/dist/components/CycleTable.js

@@ -0,0 +1,68 @@
+import { Box, Text } from "ink";
+import React from "react";
+import { customerName, formatDate, titleCase, dash } from "../lib/format.js";
+import Status from "./Status.js";
+const COLUMNS = {
+    id: 10,
+    cycle: 7,
+    order: 10,
+    customer: 18,
+    method: 12,
+    status: 11,
+    fulfillment: 12,
+    receival: 10,
+    start: 12,
+};
+// `noShrink` keeps a column at full width even on narrow terminals — used for
+// the identifier columns so they stay readable for follow-up commands.
+function Cell({ width, noShrink, children, }) {
+    return (React.createElement(Box, { width: width, marginRight: 1, flexShrink: noShrink ? 0 : 1 }, children));
+}
+function HeaderCell({ width, label, noShrink, }) {
+    return (React.createElement(Cell, { width: width, noShrink: noShrink },
+        React.createElement(Text, { bold: true, dimColor: true, wrap: "truncate" }, label)));
+}
+export default function CycleTable({ cycles, nextPage }) {
+    if (cycles.length === 0) {
+        return React.createElement(Text, { dimColor: true }, "No cycles matched your filters.");
+    }
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Box, null,
+            React.createElement(HeaderCell, { width: COLUMNS.id, label: "ID", noShrink: true }),
+            React.createElement(HeaderCell, { width: COLUMNS.cycle, label: "Cycle #", noShrink: true }),
+            React.createElement(HeaderCell, { width: COLUMNS.order, label: "Order" }),
+            React.createElement(HeaderCell, { width: COLUMNS.customer, label: "Customer" }),
+            React.createElement(HeaderCell, { width: COLUMNS.method, label: "Method" }),
+            React.createElement(HeaderCell, { width: COLUMNS.status, label: "Status" }),
+            React.createElement(HeaderCell, { width: COLUMNS.fulfillment, label: "Fulfillment" }),
+            React.createElement(HeaderCell, { width: COLUMNS.receival, label: "Receival" }),
+            React.createElement(HeaderCell, { width: COLUMNS.start, label: "Rental start" })),
+        cycles.map((cycle) => (React.createElement(Box, { key: cycle.id },
+            React.createElement(Cell, { width: COLUMNS.id, noShrink: true },
+                React.createElement(Text, { wrap: "truncate" }, cycle.id)),
+            React.createElement(Cell, { width: COLUMNS.cycle, noShrink: true },
+                React.createElement(Text, { dimColor: true, wrap: "truncate" }, cycle.sequentialId == null ? "—" : `#${cycle.sequentialId}`)),
+            React.createElement(Cell, { width: COLUMNS.order },
+                React.createElement(Text, { wrap: "truncate" }, dash(cycle.shopifyOrderName))),
+            React.createElement(Cell, { width: COLUMNS.customer },
+                React.createElement(Text, { wrap: "truncate" }, customerName(cycle.customer))),
+            React.createElement(Cell, { width: COLUMNS.method },
+                React.createElement(Text, { wrap: "truncate" }, titleCase(cycle.methodType))),
+            React.createElement(Cell, { width: COLUMNS.status },
+                React.createElement(Status, { value: cycle.status })),
+            React.createElement(Cell, { width: COLUMNS.fulfillment },
+                React.createElement(Status, { value: cycle.fulfillmentStatus })),
+            React.createElement(Cell, { width: COLUMNS.receival },
+                React.createElement(Status, { value: cycle.receivalStatus })),
+            React.createElement(Cell, { width: COLUMNS.start },
+                React.createElement(Text, { wrap: "truncate" }, formatDate(cycle.rentalStart)))))),
+        React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+            React.createElement(Text, { dimColor: true },
+                cycles.length,
+                " cycle",
+                cycles.length === 1 ? "" : "s",
+                " shown \u00B7 use the ID column with `cycles get <id>`"),
+            nextPage ? React.createElement(Text, { dimColor: true },
+                "Next page: --page ",
+                nextPage) : null)));
+}

package/dist/components/CyclesListView.js

@@ -0,0 +1,30 @@
+import React from "react";
+import { useAsync } from "../hooks/useAsync.js";
+import { resolveClient, NO_TOKEN_HINT } from "../lib/resolveClient.js";
+import CycleTable from "./CycleTable.js";
+import ErrorMessage from "./ErrorMessage.js";
+import ExitError from "./ExitError.js";
+import JsonOutput from "./JsonOutput.js";
+import Loading from "./Loading.js";
+// Fetch a list of cycles (optionally following every page) and render it as a
+// table or raw JSON. Shared by `list` and the read-convenience commands.
+export default function CyclesListView({ filters, all, json }) {
+    const resolved = resolveClient();
+    const state = useAsync(async () => {
+        if (!resolved.client)
+            throw new Error(resolved.error);
+        return all ? resolved.client.listAllCycles(filters) : resolved.client.listCycles(filters);
+    }, []);
+    if (state.loading) {
+        return json ? null : React.createElement(Loading, { label: "Fetching cycles\u2026" });
+    }
+    if (state.error) {
+        if (json)
+            return React.createElement(ExitError, { message: state.error.message });
+        return (React.createElement(ErrorMessage, { message: state.error.message, hint: resolved.error ? NO_TOKEN_HINT : undefined }));
+    }
+    if (json) {
+        return React.createElement(JsonOutput, { data: state.data });
+    }
+    return React.createElement(CycleTable, { cycles: state.data.data, nextPage: state.data.nextPage });
+}

package/dist/components/ErrorMessage.js

@@ -0,0 +1,13 @@
+import { Box, Text } from "ink";
+import React, { useEffect } from "react";
+export default function ErrorMessage({ message, hint }) {
+    // Rendering an error always means the command failed.
+    useEffect(() => {
+        process.exitCode = 1;
+    }, []);
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, { color: "red" },
+            "\u2716 ",
+            message),
+        hint ? React.createElement(Text, { dimColor: true }, hint) : null));
+}