cutsio 0.2.0 → 0.2.1

package/README.md

@@ -20,6 +20,7 @@ Create an **organization** API key in Cutsio: Settings → Organization → API
 cutsio login --url https://studio.cutsio.com --key ak_...
 cutsio whoami
 cutsio logout          # removes the stored key
+cutsio welcome         # replay the first-run banner
 ```
 
 On macOS the key goes into the **Keychain**; elsewhere it is written to

package/dist/index.js

@@ -93,20 +93,21 @@ function resolveApiUrl(flag) {
 }
 async function resolveApiKey() {
   const fromEnv = process.env.CUTSIO_API_KEY;
-  if (fromEnv && fromEnv.length > 0) return fromEnv;
+  if (fromEnv && fromEnv.length > 0) return { apiKey: fromEnv, migrated: false };
   const stored = await getStoredKey();
-  if (stored) return stored;
+  if (stored) return { apiKey: stored, migrated: false };
   const config = readConfig();
   const legacy = config?.apiKey;
-  if (!legacy) return null;
+  if (!legacy) return { apiKey: null, migrated: false };
   if (keychainAvailable()) {
     try {
       await setStoredKey(legacy);
       writeConfig({ apiUrl: config?.apiUrl ?? DEFAULT_API_URL });
+      return { apiKey: legacy, migrated: true };
     } catch {
     }
   }
-  return legacy;
+  return { apiKey: legacy, migrated: false };
 }
 async function saveCredentials(apiUrl, apiKey) {
   if (keychainAvailable()) {
@@ -351,7 +352,8 @@ function resolveSelection(manifest, selection) {
 
 // src/commands/list.ts
 async function listCommand(flags) {
-  const apiKey = await resolveApiKey();
+  const { apiKey, migrated } = await resolveApiKey();
+  if (migrated) console.error("Moved your API key into the macOS Keychain.");
   if (!apiKey) {
     console.error("No API key. Run `cutsio login` or set CUTSIO_API_KEY.");
     return 1;
@@ -1113,7 +1115,8 @@ async function promptSelection(manifest) {
 
 // src/commands/sync.ts
 async function syncCommand(flags) {
-  const apiKey = await resolveApiKey();
+  const { apiKey, migrated } = await resolveApiKey();
+  if (migrated) console.error("Moved your API key into the macOS Keychain.");
   if (!apiKey) {
     console.error("No API key. Run `cutsio login` or set CUTSIO_API_KEY.");
     return 1;
@@ -1230,23 +1233,6 @@ function positiveInt(value, fallback) {
   return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
 }
 
-// src/commands/whoami.ts
-async function whoamiCommand(flags) {
-  const apiKey = await resolveApiKey();
-  if (!apiKey) {
-    console.error("No API key. Run `cutsio login` or set CUTSIO_API_KEY.");
-    return 1;
-  }
-  const client = new CutsioClient(resolveApiUrl(flags.url), apiKey);
-  try {
-    console.log(JSON.stringify(await client.whoami(), null, 2));
-    return 0;
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    return 1;
-  }
-}
-
 // src/ui/banner.ts
 var WORDMARK = [
   " \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
@@ -1275,6 +1261,34 @@ async function revealBanner() {
   if (animationsEnabled) await sleep2(60);
 }
 
+// src/commands/welcome.ts
+async function welcomeCommand() {
+  await revealBanner();
+  console.log(`  ${color.dim("login")}    cutsio login`);
+  console.log(`  ${color.dim("browse")}   cutsio list`);
+  console.log(`  ${color.dim("sync")}     cutsio sync --out ~/Cutsio --interactive`);
+  console.log();
+  return 0;
+}
+
+// src/commands/whoami.ts
+async function whoamiCommand(flags) {
+  const { apiKey, migrated } = await resolveApiKey();
+  if (migrated) console.error("Moved your API key into the macOS Keychain.");
+  if (!apiKey) {
+    console.error("No API key. Run `cutsio login` or set CUTSIO_API_KEY.");
+    return 1;
+  }
+  const client = new CutsioClient(resolveApiUrl(flags.url), apiKey);
+  try {
+    console.log(JSON.stringify(await client.whoami(), null, 2));
+    return 0;
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return 1;
+  }
+}
+
 // src/index.ts
 function parseFlags(args) {
   const flags = {};
@@ -1306,6 +1320,7 @@ function printHelp() {
 Usage:
   cutsio login [--url URL] [--key KEY]
   cutsio logout
+  cutsio welcome
   cutsio whoami [--url URL]
   cutsio list [--videos] [--search TERM] [--json] [--url URL]
   cutsio sync [--all | --folder REFS | --collection REFS | --video IDS | --search TERMS | --unfiled | --interactive]
@@ -1352,6 +1367,8 @@ async function main() {
       return loginCommand(flags);
     case "logout":
       return logoutCommand();
+    case "welcome":
+      return welcomeCommand();
     case "whoami":
       return whoamiCommand(flags);
     case "list":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cutsio",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Sync Cutsio mezzanine masters to a local folder",
   "type": "module",
   "bin": {