@kud/gandi-cli 0.1.0 → 0.2.0

package/README.md

@@ -1,59 +1,192 @@
-# @kud/gandi-cli
+```
+ ██████╗  █████╗ ███╗  ██╗██████╗ ██╗      ██████╗██╗     ██╗
+██╔════╝ ██╔══██╗████╗ ██║██╔══██╗██║     ██╔════╝██║     ██║
+██║  ███╗███████║██╔██╗██║██║  ██║██║     ██║     ██║     ██║
+██║   ██║██╔══██║██║╚████║██║  ██║██║     ██║     ██║     ██║
+╚██████╔╝██║  ██║██║ ╚███║██████╔╝███████╗╚██████╗███████╗██║
+ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚══╝╚═════╝ ╚══════╝ ╚═════╝╚══════╝╚═╝
+```
+
+<div align="center">
+
+![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)
+![Node.js](https://img.shields.io/badge/Node.js-339933?style=flat-square&logo=node.js&logoColor=white)
+![npm](https://img.shields.io/badge/npm-%40kud%2Fgandi--cli-CB3837?style=flat-square&logo=npm&logoColor=white)
+![MIT](https://img.shields.io/badge/licence-MIT-22C55E?style=flat-square)
+
+**A modern CLI for the Gandi v5 REST API.**
+
+[Features](#-features) • [Quick Start](#-quick-start) • [CLI Reference](#-cli-reference) • [Development](#-development) • [Authentication](#-authentication)
+
+</div>
+
+---
 
-A modern CLI for the [Gandi v5 REST API](https://api.gandi.net/docs/).
+## 🌟 Features
 
-## Installation
+- 🌐 **Domain Management** — List all registered domains with expiry dates and statuses, and renew them for one or more years
+- 🔧 **Full DNS Control** — List, create, update, and delete LiveDNS records with support for custom TTLs and all standard record types
+- 🩺 **Permission Doctor** — Built-in `gandi doctor` checks your PAT scopes and shows exactly which commands are unlocked
+- 🔐 **PAT Authentication** — Uses Gandi Personal Access Tokens with fine-grained scope control — only grant what you need
+- ⚡ **Rich Terminal UI** — Built with Ink and React for spinners, aligned tables, and clean formatted output
+- 📦 **Zero Config** — Set one env var or add one line to a TOML file and you're ready to go
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install
 
 ```sh
 npm install -g @kud/gandi-cli
 ```
 
-## Authentication
+### 2. Authenticate
+
+Generate a **Personal Access Token** at **gandi.net → Account → Partage → Créer un jeton d'accès personnel** then export it:
+
+```sh
+export GANDI_API_KEY="your-token-here"
+```
+
+### 3. Check permissions
+
+```sh
+gandi doctor
+```
+
+```
+Gandi CLI
+Expires in 29 days · 1 entity
+
+✓  domain:view   gandi domain list
+✗  domain:renew  gandi domain renew
+✓  domain:tech   gandi dns list / set / delete
+```
+
+### 4. Manage domains and DNS
+
+```sh
+gandi domain list
+
+gandi dns list example.com
+gandi dns set example.com A www 1.2.3.4 --ttl 300
+gandi dns delete example.com A www
+```
+
+---
+
+## 📖 CLI Reference
+
+| Command                                                        | Description                                   |
+| -------------------------------------------------------------- | --------------------------------------------- |
+| `gandi doctor`                                                 | Check token info and permissions              |
+| `gandi domain list`                                            | List all domains with expiry dates and status |
+| `gandi domain renew <domain>`                                  | Renew a domain for 1 year                     |
+| `gandi domain renew <domain> --duration <years>`               | Renew for a specified number of years         |
+| `gandi dns list <domain>`                                      | List all DNS records for a domain             |
+| `gandi dns set <domain> <type> <name> <value>`                 | Create or replace a DNS record                |
+| `gandi dns set <domain> <type> <name> <value> --ttl <seconds>` | Set with a custom TTL in seconds              |
+| `gandi dns delete <domain> <type> <name>`                      | Delete a DNS record                           |
+
+---
+
+## 🔧 Development
+
+**Project Structure**
+
+```
+gandi-cli/
+├── src/
+│   ├── commands/
+│   │   ├── doctor.tsx
+│   │   ├── domain-list.tsx
+│   │   ├── domain-renew.tsx
+│   │   ├── dns-list.tsx
+│   │   ├── dns-set.tsx
+│   │   └── dns-delete.tsx
+│   ├── components/
+│   │   ├── error.tsx
+│   │   ├── spinner-action.tsx
+│   │   └── table.tsx
+│   ├── lib/
+│   │   ├── api.ts
+│   │   └── config.ts
+│   ├── types/
+│   │   └── gandi.ts
+│   └── index.tsx
+├── dist/
+├── package.json
+└── README.md
+```
+
+**Scripts**
+
+| Script          | Description                                  |
+| --------------- | -------------------------------------------- |
+| `npm run build` | Compile TypeScript to `dist/`                |
+| `npm run dev`   | Run directly with tsx — no build step needed |
+| `npm run start` | Run compiled output from `dist/`             |
+
+**Workflow**
+
+```sh
+git clone https://github.com/kud/gandi-cli.git
+cd gandi-cli
+npm install
+npm run dev -- doctor
+```
+
+---
 
-Generate a personal access token at **gandi.net → Account → Partage → Créer un jeton d'accès personnel**.
+## 🔒 Authentication
 
-Token name: `gandi-cli`  
-Expiry: your preference  
-Resource access: **Restreint aux produits sélectionnés**
+gandi-cli uses **Personal Access Tokens (PATs)** — not legacy API keys.
 
-Required permissions (Domaines section only):
+Generate a token at **gandi.net → Account → Partage → Créer un jeton d'accès personnel** with only the permissions you need:
 
-| Permission                                      | Commands                            |
+| Permission                                      | Required for                        |
 | ----------------------------------------------- | ----------------------------------- |
 | Voir la liste de vos domaines                   | `gandi domain list`                 |
 | Gérer le renouvellement de vos domaines         | `gandi domain renew`                |
 | Accéder aux enregistrements DNS de vos domaines | `gandi dns list`                    |
 | Gérer les enregistrements DNS de vos domaines   | `gandi dns set`, `gandi dns delete` |
 
-No Organisation, Facturation, Web Hosting, Cloud, or SSL permissions needed.
-
-Then export the key in your shell:
+**Via environment variable** (takes precedence):
 
 ```sh
 export GANDI_API_KEY="your-token-here"
 ```
 
-Or add it to `~/.config/gandi/config.toml`:
+**Via config file** (`~/.config/gandi/config.toml`):
 
 ```toml
 api_key = "your-token-here"
 ```
 
-## Usage
+- ✅ Only grant permissions each command actually needs
+- ✅ Set an expiry date on the token
+- ✅ Use `gandi doctor` to verify scopes before running commands
 
-### Domains
+---
 
-```sh
-gandi domain list
-gandi domain renew example.com
-gandi domain renew example.com --duration 2
-```
+## 🏗 Tech Stack
 
-### DNS
+| Component     | Details                |
+| ------------- | ---------------------- |
+| Runtime       | Node.js ≥ 20           |
+| Language      | TypeScript 5.x (ESM)   |
+| Terminal UI   | Ink 7 + React 19       |
+| CLI Framework | Commander.js 12        |
+| Config        | smol-toml              |
+| Package       | npm · `@kud/gandi-cli` |
 
-```sh
-gandi dns list example.com
-gandi dns set example.com A www 1.2.3.4
-gandi dns set example.com A www 1.2.3.4 --ttl 3600
-gandi dns delete example.com A www
-```
+---
+
+<div align="center">
+
+MIT © [kud](https://github.com/kud) — Made with ❤️ for the terminal
+
+⭐ Star this repo if it saves you time · [↑ Back to top](#)
+
+</div>

package/dist/commands/auth-whoami.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+declare const AuthWhoami: () => React.JSX.Element;
+export default AuthWhoami;
+//# sourceMappingURL=auth-whoami.d.ts.map

package/dist/commands/auth-whoami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-whoami.d.ts","sourceRoot":"","sources":["../../src/commands/auth-whoami.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AA2BlD,QAAA,MAAM,UAAU,yBAmDf,CAAA;AAED,eAAe,UAAU,CAAA"}

package/dist/commands/auth-whoami.js

@@ -0,0 +1,66 @@
+import React, { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import { getTokenInfo } from "../lib/api.js";
+import { getApiKey } from "../lib/config.js";
+import SpinnerAction from "../components/spinner-action.js";
+import ErrorMessage from "../components/error.js";
+const SCOPE_MAP = {
+    "domain:view": { label: "View domains", commands: "gandi domain list" },
+    "domain:renew": {
+        label: "Renew domains",
+        commands: "gandi domain renew",
+    },
+    "domain:tech": {
+        label: "Manage DNS",
+        commands: "gandi dns list / set / delete",
+    },
+};
+const formatExpiry = (seconds) => {
+    const days = Math.floor(seconds / 86400);
+    if (days > 0)
+        return `${days} day${days !== 1 ? "s" : ""}`;
+    const hours = Math.floor(seconds / 3600);
+    return `${hours} hour${hours !== 1 ? "s" : ""}`;
+};
+const AuthWhoami = () => {
+    const [info, setInfo] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        const run = async () => {
+            try {
+                const key = getApiKey();
+                const data = await getTokenInfo(key);
+                setInfo(data);
+            }
+            catch (e) {
+                setError(e.message);
+            }
+        };
+        run();
+    }, []);
+    if (error)
+        return React.createElement(ErrorMessage, { message: error });
+    if (!info)
+        return React.createElement(SpinnerAction, { label: "Checking token\u2026" });
+    const knownScopes = Object.keys(SCOPE_MAP);
+    return (React.createElement(Box, { flexDirection: "column", gap: 1 },
+        React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true, color: "white" }, info.pat_name),
+            React.createElement(Text, { color: "gray" },
+                "Expires in ",
+                formatExpiry(info.expires_in),
+                " \u00B7 ",
+                info.entities.length,
+                " ",
+                info.entities.length !== 1 ? "entities" : "entity")),
+        React.createElement(Box, { flexDirection: "column" }, knownScopes.map((scope) => {
+            const has = info.scope.includes(scope);
+            const entry = SCOPE_MAP[scope];
+            return (React.createElement(Box, { key: scope, gap: 2 },
+                React.createElement(Text, { color: has ? "green" : "red" }, has ? "✓" : "✗"),
+                React.createElement(Text, { color: has ? "white" : "gray", dimColor: !has }, scope),
+                React.createElement(Text, { color: "gray" }, entry.commands)));
+        }))));
+};
+export default AuthWhoami;
+//# sourceMappingURL=auth-whoami.js.map

package/dist/commands/auth-whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-whoami.js","sourceRoot":"","sources":["../../src/commands/auth-whoami.tsx"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,6 +2,7 @@
 import React from "react";
 import { render } from "ink";
 import { Command } from "commander";
+import AuthWhoami from "./commands/auth-whoami.js";
 import DomainList from "./commands/domain-list.js";
 import DomainRenew from "./commands/domain-renew.js";
 import DnsList from "./commands/dns-list.js";
@@ -12,6 +13,10 @@ program
     .name("gandi")
     .description("Modern CLI for the Gandi v5 REST API")
     .version("0.1.0");
+program
+    .command("auth")
+    .description("Check token info and permissions")
+    .action(() => void render(React.createElement(AuthWhoami, null)));
 const domain = program.command("domain").description("Manage domains");
 domain
     .command("list")

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,UAAU,MAAM,2BAA2B,CAAA;AAClD,OAAO,WAAW,MAAM,4BAA4B,CAAA;AACpD,OAAO,OAAO,MAAM,wBAAwB,CAAA;AAC5C,OAAO,MAAM,MAAM,uBAAuB,CAAA;AAC1C,OAAO,SAAS,MAAM,0BAA0B,CAAA;AAEhD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,sCAAsC,CAAC;KACnD,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAA;AAEtE,MAAM;KACH,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kBAAkB,CAAC;KAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,oBAAC,UAAU,OAAG,CAAC,CAAC,CAAA;AAE5C,MAAM;KACH,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,gBAAgB,CAAC;KAC7B,MAAM,CAAC,wBAAwB,EAAE,0BAA0B,EAAE,GAAG,CAAC;KACjE,MAAM,CAAC,CAAC,CAAS,EAAE,IAA0B,EAAE,EAAE;IAChD,KAAK,MAAM,CACT,oBAAC,WAAW,IAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAI,CAClE,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAA;AAExE,GAAG;KACA,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,+BAA+B,CAAC;KAC5C,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,oBAAC,OAAO,IAAC,MAAM,EAAE,CAAC,GAAI,CAAC,CAAC,CAAA;AAE7D,GAAG;KACA,OAAO,CAAC,oCAAoC,CAAC;KAC7C,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,OAAO,CAAC;KACxD,MAAM,CACL,CACE,CAAS,EACT,IAAY,EACZ,IAAY,EACZ,KAAa,EACb,IAAqB,EACrB,EAAE;IACF,KAAK,MAAM,CACT,oBAAC,MAAM,IACL,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAC3B,CACH,CAAA;AACH,CAAC,CACF,CAAA;AAEH,GAAG;KACA,OAAO,CAAC,+BAA+B,CAAC;KACxC,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,CAAC,CAAS,EAAE,IAAY,EAAE,IAAY,EAAE,EAAE;IAChD,KAAK,MAAM,CAAC,oBAAC,SAAS,IAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAI,CAAC,CAAA;AAC/D,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}

package/dist/lib/api.d.ts

@@ -1,6 +1,7 @@
-import type { Domain, DnsRecord } from "../types/gandi.js";
+import type { Domain, DnsRecord, TokenInfo } from "../types/gandi.js";
 export declare const listDomains: (apiKey: string) => Promise<Domain[]>;
 export declare const listDnsRecords: (apiKey: string, domain: string) => Promise<DnsRecord[]>;
 export declare const setDnsRecord: (apiKey: string, domain: string, type: string, name: string, values: string[], ttl?: number) => Promise<void>;
 export declare const deleteDnsRecord: (apiKey: string, domain: string, type: string, name: string) => Promise<void>;
+export declare const getTokenInfo: (apiKey: string) => Promise<TokenInfo>;
 //# sourceMappingURL=api.d.ts.map

package/dist/lib/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAc,MAAM,mBAAmB,CAAA;AA6BtE,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CACf,CAAA;AAE9C,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,OAAO,CAAC,SAAS,EAAE,CAC8C,CAAA;AAEpE,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,QAAQ,MAAM,EAAE,EAChB,YAAW,KACV,OAAO,CAAC,IAAI,CAIX,CAAA;AAEJ,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,MAAM,MAAM,KACX,OAAO,CAAC,IAAI,CAGX,CAAA"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EAET,SAAS,EACV,MAAM,mBAAmB,CAAA;AA6B1B,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CACf,CAAA;AAE9C,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,OAAO,CAAC,SAAS,EAAE,CAC8C,CAAA;AAEpE,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,QAAQ,MAAM,EAAE,EAChB,YAAW,KACV,OAAO,CAAC,IAAI,CAIX,CAAA;AAEJ,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,MAAM,MAAM,KACX,OAAO,CAAC,IAAI,CAGX,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,SAAS,CAWpE,CAAA"}

package/dist/lib/api.js

@@ -27,4 +27,16 @@ export const setDnsRecord = (apiKey, domain, type, name, values, ttl = 10800) =>
 export const deleteDnsRecord = (apiKey, domain, type, name) => request(apiKey, `/livedns/domains/${domain}/records/${name}/${type}`, {
     method: "DELETE",
 });
+export const getTokenInfo = async (apiKey) => {
+    const res = await fetch("https://id.gandi.net/tokeninfo", {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    if (!res.ok) {
+        const err = (await res
+            .json()
+            .catch(() => ({ message: res.statusText })));
+        throw new Error(err.message ?? `HTTP ${res.status}`);
+    }
+    return res.json();
+};
 //# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,0BAA0B,CAAA;AAE3C,MAAM,OAAO,GAAG,KAAK,EACnB,MAAc,EACd,IAAY,EACZ,UAAuB,EAAE,EACb,EAAE;IACd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;QAC5C,GAAG,OAAO;QACV,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE;YACjC,cAAc,EAAE,kBAAkB;YAClC,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG;aACnB,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAe,CAAA;QAC5D,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAC7C,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAqB,EAAE,CAC/D,OAAO,CAAW,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAc,EACd,MAAc,EACQ,EAAE,CACxB,OAAO,CAAc,MAAM,EAAE,oBAAoB,MAAM,UAAU,CAAC,CAAA;AAEpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAc,EACd,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,MAAgB,EAChB,GAAG,GAAG,KAAK,EACI,EAAE,CACjB,OAAO,CAAO,MAAM,EAAE,oBAAoB,MAAM,YAAY,IAAI,IAAI,IAAI,EAAE,EAAE;IAC1E,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;CAC/D,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAc,EACd,MAAc,EACd,IAAY,EACZ,IAAY,EACG,EAAE,CACjB,OAAO,CAAO,MAAM,EAAE,oBAAoB,MAAM,YAAY,IAAI,IAAI,IAAI,EAAE,EAAE;IAC1E,MAAM,EAAE,QAAQ;CACjB,CAAC,CAAA"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAOA,MAAM,QAAQ,GAAG,0BAA0B,CAAA;AAE3C,MAAM,OAAO,GAAG,KAAK,EACnB,MAAc,EACd,IAAY,EACZ,UAAuB,EAAE,EACb,EAAE;IACd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;QAC5C,GAAG,OAAO;QACV,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE;YACjC,cAAc,EAAE,kBAAkB;YAClC,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG;aACnB,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAe,CAAA;QAC5D,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAC7C,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAqB,EAAE,CAC/D,OAAO,CAAW,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAc,EACd,MAAc,EACQ,EAAE,CACxB,OAAO,CAAc,MAAM,EAAE,oBAAoB,MAAM,UAAU,CAAC,CAAA;AAEpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAc,EACd,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,MAAgB,EAChB,GAAG,GAAG,KAAK,EACI,EAAE,CACjB,OAAO,CAAO,MAAM,EAAE,oBAAoB,MAAM,YAAY,IAAI,IAAI,IAAI,EAAE,EAAE;IAC1E,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;CAC/D,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAc,EACd,MAAc,EACd,IAAY,EACZ,IAAY,EACG,EAAE,CACjB,OAAO,CAAO,MAAM,EAAE,oBAAoB,MAAM,YAAY,IAAI,IAAI,IAAI,EAAE,EAAE;IAC1E,MAAM,EAAE,QAAQ;CACjB,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,MAAc,EAAsB,EAAE;IACvE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,gCAAgC,EAAE;QACxD,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;KAC/C,CAAC,CAAA;IACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG;aACnB,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAe,CAAA;QAC5D,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAwB,CAAA;AACzC,CAAC,CAAA"}

package/dist/types/gandi.d.ts

@@ -28,4 +28,15 @@ export interface GandiError {
     object: string;
     cause: string;
 }
+export interface TokenInfo {
+    user_id: string;
+    sharing_id: string;
+    pat_id: string;
+    pat_name: string;
+    scope: string[];
+    entities: {
+        id: string;
+    }[];
+    expires_in: number;
+}
 //# sourceMappingURL=gandi.d.ts.map

package/dist/types/gandi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gandi.d.ts","sourceRoot":"","sources":["../../src/types/gandi.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAA;QAClB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,gBAAgB,EAAE,MAAM,CAAA;QACxB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd"}
+{"version":3,"file":"gandi.d.ts","sourceRoot":"","sources":["../../src/types/gandi.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAA;QAClB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,gBAAgB,EAAE,MAAM,CAAA;QACxB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gandi-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A modern CLI for the Gandi v5 REST API",
   "type": "module",
   "bin": {
@@ -11,9 +11,10 @@
   ],
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch",
+    "dev": "tsx src/index.tsx",
     "start": "node dist/index.js"
   },
+  "homepage": "https://kud.github.io/gandi-cli",
   "repository": {
     "type": "git",
     "url": "https://github.com/kud/gandi-cli"
@@ -27,6 +28,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
+    "tsx": "4.21.0",
     "typescript": "^5.5.4"
   }
 }