@przeprogramowani/10x-cli 1.2.0 → 1.3.1

package/dist/index.mjs

@@ -2271,7 +2271,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@przeprogramowani/10x-cli",
-  version: "1.2.0",
+  version: "1.3.1",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -3034,6 +3034,37 @@ function resolveApiBase() {
   throw new Error(`API_BASE_URL must be ${DEFAULT_API_BASE} or http://localhost[:port] (got ${JSON.stringify(override)})`);
 }
 var DEFAULT_TIMEOUT_MS = 30000;
+var UNKNOWN_API_ERROR_MESSAGE = "An unknown error occurred. Please contact 10xDevs mentors and share the command that caused this. Sorry for the issue!";
+var ERROR_CODE_MESSAGES = {
+  course_not_found: "Course not found.",
+  lesson_not_found: "Lesson not found.",
+  module_not_found: "Module not found.",
+  artifact_not_found: "Artifact not found.",
+  bundle_not_found: "Bundle not found.",
+  module_locked: "This module is not available yet.",
+  signing_failed: "Could not sign the download URL. Try again in a moment.",
+  invalid_json: "The server received a malformed request.",
+  unauthorized: "You are not signed in. Run `10x auth` first.",
+  no_membership: "No active course membership was found for this email.",
+  invalid_refresh_token: "Your session has expired. Run `10x auth` again.",
+  membership_revoked: "Your course membership has been revoked.",
+  rate_limited: "Too many requests. Please slow down and try again shortly.",
+  email_send_failed: "Could not send the login email. Try again in a moment.",
+  admin_access_required: "This action requires admin access.",
+  circle_api_error: "The membership service is temporarily unavailable.",
+  internal_error: "The server hit an unexpected error."
+};
+function messageForApiError(payload) {
+  if (!payload)
+    return;
+  if (typeof payload.message === "string" && payload.message.length > 0) {
+    return payload.message;
+  }
+  if (typeof payload.error === "string" && payload.error.length > 0) {
+    return ERROR_CODE_MESSAGES[payload.error];
+  }
+  return;
+}
 async function request(method, path, body, options = {}) {
   const base = resolveApiBase();
   const url = path.startsWith("http") ? path : `${base}${path}`;
@@ -3077,11 +3108,22 @@ async function request(method, path, body, options = {}) {
   }
   if (!response.ok) {
     const payload = parsed && typeof parsed === "object" ? parsed : undefined;
+    const mapped = messageForApiError(payload);
+    let errorMessage;
+    if (mapped) {
+      errorMessage = mapped;
+    } else if (payload) {
+      errorMessage = UNKNOWN_API_ERROR_MESSAGE;
+    } else if (response.statusText.length > 0) {
+      errorMessage = response.statusText;
+    } else {
+      errorMessage = UNKNOWN_API_ERROR_MESSAGE;
+    }
     return {
       ok: false,
       status: response.status,
-      code: payload?.code ?? `http_${response.status}`,
-      error: payload?.error ?? payload?.message ?? response.statusText,
+      code: typeof payload?.code === "string" ? payload.code : `http_${response.status}`,
+      error: errorMessage,
       payload
     };
   }
@@ -3990,7 +4032,7 @@ function checkToolDirectory() {
 }
 
 // src/lib/lesson-ref.ts
-var MIN_MODULE = 1;
+var MIN_MODULE = 0;
 var MAX_MODULE = 5;
 var LESSON_REF_RE = /^m(\d+)l(\d+)$/;
 var MODULE_REF_RE = /^(?:m)?(\d+)$/;
@@ -5213,7 +5255,7 @@ function renderCatalog(ctx, catalog) {
     output(ctx, `No modules available in '${catalog.course}'.`, undefined);
     return;
   }
-  const exampleModule = catalog.modules.find((m3) => m3.effectiveState === "unlocked")?.module ?? catalog.modules[0]?.module ?? 1;
+  const exampleModule = catalog.modules.find((m3) => m3.effectiveState === "unlocked")?.module ?? catalog.modules[0]?.module ?? 0;
   const lines = [];
   lines.push(`Course: ${catalog.course}`);
   lines.push("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@przeprogramowani/10x-cli",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Open-source CLI for 10xDevs course content",
   "repository": {
     "type": "git",

package/skills/10x-cli-guide/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: 10x-cli-guide
-description: Invoke this skill when the user asks how to USE the 10x-cli day-to-day — fetching lessons, listing modules, switching AI tools, troubleshooting errors, understanding where artifacts land, or working on a specific OS (Windows, Linux, macOS). Covers commands (get, list, doctor, auth --status/--logout), tool profiles, artifact locations, common errors, and platform-specific tips. Excludes: first-time installation and onboarding (use 10x-cli-setup instead), developing or contributing to 10x-cli source code, and general programming help.
+description: "Invoke this skill when the user asks how to USE the 10x-cli day-to-day — fetching lessons, listing modules, switching AI tools, troubleshooting errors, understanding where artifacts land, or working on a specific OS (Windows, Linux, macOS). Covers commands (get, list, doctor, auth --status/--logout), tool profiles, artifact locations, common errors, and platform-specific tips. Excludes: first-time installation and onboarding (use 10x-cli-setup instead), developing or contributing to 10x-cli source code, and general programming help."
 ---
 
 # 10x-cli Daily Usage Guide