playcademy 0.14.27 → 0.14.28

package/dist/db.js

@@ -2049,6 +2049,7 @@ import {
   green,
   greenBright,
   red,
+  underline,
   yellow,
   yellowBright
 } from "colorette";
@@ -2750,6 +2751,7 @@ function formatError(error, indent = 0) {
 function customTransform(text) {
   let result = text;
   result = result.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  result = result.replace(/<<([^>]+)>>/g, (_, url) => underline(url));
   result = result.replace(/<([^>]+)>/g, (_, path) => blueBright(path));
   return result;
 }

package/dist/index.js

@@ -2436,6 +2436,7 @@ import {
   green,
   greenBright,
   red,
+  underline,
   yellow,
   yellowBright
 } from "colorette";
@@ -3168,6 +3169,7 @@ function setupGlobalErrorHandlers() {
 function customTransform(text5) {
   let result = text5;
   result = result.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  result = result.replace(/<<([^>]+)>>/g, (_, url) => underline(url));
   result = result.replace(/<([^>]+)>/g, (_, path4) => blueBright(path4));
   return result;
 }
@@ -3851,7 +3853,9 @@ async function requireConfigFile() {
     logger.error("No <playcademy.config.{js,json}> file found");
     logger.newLine();
     logger.admonition("note", "Getting Started", [
-      "Run `playcademy init` to create a config file first"
+      "Run `playcademy init` to create a config file first",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/quickstart>>"
     ]);
     logger.newLine();
     process.exit(1);
@@ -5519,7 +5523,7 @@ import { join as join12 } from "path";
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.26",
+  version: "0.14.27",
   type: "module",
   exports: {
     ".": {
@@ -5984,7 +5988,9 @@ function displayConfigSuccess(timebackConfig) {
   logger.admonition("tip", "Next Steps", [
     "1. Review and customize your config file",
     "2. Build your project",
-    "3. Run `playcademy deploy` to deploy"
+    "3. Run `playcademy deploy` to deploy",
+    "",
+    "Learn more: <<https://docs.playcademy.net/platform/quickstart>>"
   ]);
   logger.newLine();
   if (timebackConfig) {
@@ -5995,7 +6001,7 @@ function displayConfigSuccess(timebackConfig) {
       "  \u2192 Run `playcademy timeback setup`",
       "  \u2192 Then verify with `playcademy timeback verify`",
       "",
-      "This will create the necessary TimeBack resources."
+      "Learn more: <<https://docs.playcademy.net/timeback>>"
     ]);
     logger.newLine();
   }
@@ -6028,6 +6034,8 @@ function displaySuccessMessage(context2) {
   }
   const deployStep = nextSteps.length + 1;
   nextSteps.push(`${deployStep}. Deploy: \`playcademy deploy\``);
+  nextSteps.push("");
+  nextSteps.push("Learn more: <<https://docs.playcademy.net/platform/quickstart>>");
   logger.admonition("tip", "Next Steps", nextSteps);
   logger.newLine();
 }
@@ -8339,7 +8347,7 @@ async function confirmDeploymentPlan(plan, context2) {
 }
 
 // src/lib/deploy/output.ts
-import { underline } from "colorette";
+import { underline as underline2 } from "colorette";
 function displayCurrentConfiguration(context2) {
   const { config } = context2;
   logger.newLine();
@@ -8387,12 +8395,12 @@ function reportDeploymentSuccess(result, context2) {
   logger.success(`${game.displayName} ${action} successfully!`);
   logger.newLine();
   const baseUrl = getWebBaseUrl(client.getBaseUrl());
-  logger.data("Project URL", underline(`${baseUrl}/play/${game.slug}`), 1);
+  logger.data("Project URL", underline2(`${baseUrl}/play/${game.slug}`), 1);
   if (backendMetadata || context2.previousBackendBundleHash) {
     const env = getEnvironment();
     const subdomain = env === "staging" ? `${game.slug}-staging` : game.slug;
     const backendUrl = `https://${subdomain}.${GAME_WORKER_DOMAINS.production}/api`;
-    logger.data("Backend API", underline(`${backendUrl}`), 1);
+    logger.data("Backend API", underline2(`${backendUrl}`), 1);
   }
   logger.newLine();
 }
@@ -10756,7 +10764,9 @@ var loginCommand = new Command3("login").description("Authenticate with Playcade
       `Email: ${authProfile.email}`,
       `Environment: ${environment}`,
       ...profileName !== "default" ? [`Profile: ${profileName}`] : [],
-      ...profileName !== "default" ? [`Use \`--profile ${profileName}\` with commands to use this profile`] : []
+      ...profileName !== "default" ? [`Use \`--profile ${profileName}\` with commands to use this profile`] : [],
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/cli/authentication>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -11267,7 +11277,7 @@ var getStatusCommand = new Command12("status").description("Check your developer
 });
 
 // package.json
-var version2 = "0.14.26";
+var version2 = "0.14.27";
 
 // src/commands/dev/server.ts
 function setupCleanupHandlers(workspace, getServer) {
@@ -11319,7 +11329,9 @@ async function runDevServer(options) {
       logger.warn("No backend integrations or custom routes configured");
       logger.newLine();
       logger.admonition("tip", "How to Add Backend", [
-        `Add integrations to <playcademy.config.js> or run \`playcademy api init\``
+        "Add integrations to <playcademy.config.js> or run `playcademy api init`",
+        "",
+        "Learn more: <<https://docs.playcademy.net/platform/integrations>>"
       ]);
       logger.newLine();
       logger.remark("Nothing to do");
@@ -11433,7 +11445,9 @@ async function runApiInit() {
     logger.admonition("tip", "Next Steps", [
       `1. Review sample routes in <${apiDir}/sample/>`,
       "2. Run `playcademy dev` to test locally",
-      "3. Run `playcademy deploy` to deploy your project"
+      "3. Run `playcademy deploy` to deploy your project",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/custom-routes>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -11624,7 +11638,9 @@ var initAuthCommand = new Command16("init").description("Add authentication to y
       "1. Install dependencies: `bun install`",
       "2. Review auth config: <server/lib/auth.ts>",
       "3. Push schema: `bun db:push`",
-      "4. Start dev server: `playcademy dev`"
+      "4. Start dev server: `playcademy dev`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/authentication>>"
     ]);
     logger.newLine();
     if (additionalStrategies.length > 0) {
@@ -11757,7 +11773,9 @@ async function runDbInit() {
       "1. Install dependencies: `bun install`",
       "2. Review schema in <./server/db/schema/example.ts>",
       "3. Push schema: `bun db:push`",
-      "4. Start dev server: `playcademy dev`"
+      "4. Start dev server: `playcademy dev`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/database>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -11770,7 +11788,7 @@ async function runDbInit() {
 import { existsSync as existsSync23 } from "fs";
 import { join as join34 } from "path";
 import { confirm as confirm8, input as input7 } from "@inquirer/prompts";
-import { bold as bold12, redBright as redBright4, underline as underline2 } from "colorette";
+import { bold as bold12, redBright as redBright4, underline as underline3 } from "colorette";
 import { Miniflare as Miniflare2 } from "miniflare";
 async function runDbResetRemote(options) {
   const environment = ensureEnvironment(options.env);
@@ -11788,9 +11806,9 @@ async function runDbResetRemote(options) {
   const game = await client.games.fetch(deployedGame.gameId);
   logger.newLine();
   logger.admonition("warning", "DESTRUCTIVE OPERATION", [
-    `Are you sure you want to ${redBright4(underline2(bold12("DELETE ALL DATA")))} in your ${environment} database?`,
+    `Are you sure you want to ${redBright4(underline3(bold12("DELETE ALL DATA")))} in your ${environment} database?`,
     `All tables will be dropped and recreated from schema.`,
-    `This action is irreversible and ${underline2(bold12("cannot be undone"))}.`
+    `This action is irreversible and ${underline3(bold12("cannot be undone"))}.`
   ]);
   logger.newLine();
   const confirmed = await confirm8({
@@ -11911,7 +11929,7 @@ async function runDbReset(options = {}) {
 import { existsSync as existsSync24 } from "fs";
 import { join as join35 } from "path";
 import { confirm as confirm9, input as input8 } from "@inquirer/prompts";
-import { bold as bold13, redBright as redBright5, underline as underline3 } from "colorette";
+import { bold as bold13, redBright as redBright5, underline as underline4 } from "colorette";
 import { Miniflare as Miniflare3 } from "miniflare";
 async function runDbResetRemote2(gameSlug, environment) {
   const client = await requireAuthenticatedClient();
@@ -11955,8 +11973,8 @@ async function runDbSeedRemote(seedFile, options) {
   logger.newLine();
   if (willReset) {
     logger.admonition("warning", "Remote Database Seeding", [
-      `Are you sure you want to ${redBright5(underline3(bold13("DELETE ALL DATA")))} in your ${environment} database?`,
-      `This action is irreversible and ${underline3(bold13("cannot be undone"))}.`,
+      `Are you sure you want to ${redBright5(underline4(bold13("DELETE ALL DATA")))} in your ${environment} database?`,
+      `This action is irreversible and ${underline4(bold13("cannot be undone"))}.`,
       `Run this command with \`--no-reset\` if you want to seed without resetting.`
     ]);
   } else {
@@ -12156,7 +12174,9 @@ async function runKVClear(options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12268,7 +12288,9 @@ async function runKVDelete(key, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12345,7 +12367,9 @@ async function runKVGet(key, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12467,7 +12491,9 @@ async function runKVInit() {
     logger.admonition("tip", "Next Steps", [
       "1. Use `c.env.KV` in your API routes",
       "2. Run `playcademy dev` to test locally",
-      "3. Run `playcademy deploy`"
+      "3. Run `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -12515,7 +12541,9 @@ async function runKVInspect(key, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12633,7 +12661,9 @@ async function runKVList(options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12727,7 +12757,9 @@ async function runKVSeed(seedFile, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12870,7 +12902,9 @@ async function runKVSet(key, value, options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -12964,7 +12998,9 @@ async function runKVStats(options = {}) {
         logger.error("KV storage is not configured");
         logger.newLine();
         logger.admonition("tip", "Getting Started", [
-          "Run `playcademy kv init` to enable KV storage"
+          "Run `playcademy kv init` to enable KV storage",
+          "",
+          "Learn more: <<https://docs.playcademy.net/platform/integrations/kv>>"
         ]);
         logger.newLine();
       }
@@ -13582,7 +13618,9 @@ async function runBucketInit() {
     logger.admonition("tip", "Next Steps", [
       "1. Use `c.env.BUCKET` in your API routes to upload/download files",
       "2. Run `playcademy dev` to test locally",
-      "3. Run `playcademy deploy`"
+      "3. Run `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/integrations/bucket>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -13656,7 +13694,9 @@ async function runBucketListLocal(options) {
       logger.error("Bucket storage is not configured");
       logger.newLine();
       logger.admonition("tip", "Getting Started", [
-        "Run `playcademy bucket init` to enable bucket storage"
+        "Run `playcademy bucket init` to enable bucket storage",
+        "",
+        "Learn more: <<https://docs.playcademy.net/platform/integrations/bucket>>"
       ]);
       logger.newLine();
     }
@@ -13813,7 +13853,9 @@ async function runBucketPutLocal(key, filePath, options) {
       logger.error("Bucket storage is not configured");
       logger.newLine();
       logger.admonition("tip", "Getting Started", [
-        "Run `playcademy bucket init` to enable bucket storage"
+        "Run `playcademy bucket init` to enable bucket storage",
+        "",
+        "Learn more: <<https://docs.playcademy.net/platform/integrations/bucket>>"
       ]);
       logger.newLine();
     }
@@ -13926,7 +13968,7 @@ bucketCommand.command("bulk <directory>").description(
 import { Command as Command21 } from "commander";
 
 // src/commands/domain/add.ts
-import { underline as underline4 } from "colorette";
+import { underline as underline5 } from "colorette";
 async function runDomainAdd(hostname, options) {
   try {
     logger.newLine();
@@ -13952,7 +13994,7 @@ async function runDomainAdd(hostname, options) {
       async () => {
         return client.dev.games.domains.add(slug, normalizedHostname);
       },
-      (domain2) => `Custom domain added: ${underline4(`<https://${domain2.hostname}>`)}`
+      (domain2) => `Custom domain added: ${underline5(`<https://${domain2.hostname}>`)}`
     );
     logger.newLine();
     displayDomainValidationRecords(domain, normalizedHostname);
@@ -13962,7 +14004,9 @@ async function runDomainAdd(hostname, options) {
       `2. Run \`playcademy domain verify ${normalizedHostname}\` to check validation status`,
       "",
       "Note: SSL certificate validation may take a few minutes to initialize.",
-      `Run verify command to see all required DNS records once SSL provisioning begins.`
+      "Run verify command to see all required DNS records once SSL provisioning begins.",
+      "",
+      "Learn more: <<https://docs.playcademy.net/platform/cli/deployment#custom-domains>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -14067,7 +14111,7 @@ async function runDomainList(options) {
 }
 
 // src/commands/domain/verify.ts
-import { underline as underline5 } from "colorette";
+import { underline as underline6 } from "colorette";
 async function runDomainVerify(hostname, options) {
   try {
     if (!options.json) {
@@ -14094,7 +14138,7 @@ async function runDomainVerify(hostname, options) {
     displayDomainStatus(hostname, domain);
     if (domain.status === "active" && domain.sslStatus === "active") {
       logger.admonition("info", "Domain Active", [
-        `Your game is now accessible at: ${underline5(`<https://${hostname}>`)}`
+        `Your game is now accessible at: ${underline6(`<https://${hostname}>`)}`
       ]);
       logger.newLine();
     } else if (domain.status === "pending" || domain.status === "pending_validation" || domain.sslStatus === "pending_validation") {
@@ -14555,13 +14599,15 @@ var initCommand2 = new Command32("init").description("Add TimeBack integration t
     logger.success("TimeBack integration added!");
     logger.newLine();
     logger.admonition("tip", "Next Steps", [
-      `1. Set up TimeBack resources: \`playcademy timeback setup\``,
-      `2. Deploy your project: \`playcademy deploy\``
+      "1. Set up TimeBack resources: `playcademy timeback setup`",
+      "2. Deploy your project: `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/timeback>>"
     ]);
     logger.newLine();
   } catch (error) {
     logger.newLine();
-    throw error;
+    formatErrorAndExit(error);
   }
 });
 
@@ -14640,7 +14686,9 @@ var setupCommand = new Command33("setup").description("Set up TimeBack integrati
     }
     logger.admonition("tip", "Next Steps", [
       "1. Run `playcademy timeback verify` to verify the setup",
-      "2. Deploy your project with `playcademy deploy`"
+      "2. Deploy your project with `playcademy deploy`",
+      "",
+      "Learn more: <<https://docs.playcademy.net/timeback>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -14745,7 +14793,7 @@ var verifyCommand = new Command35("verify").description("Verify TimeBack integra
         "",
         `  \`playcademy timeback setup --env ${environment}\``,
         "",
-        "This will create the necessary TimeBack resources."
+        "Learn more: <<https://docs.playcademy.net/timeback>>"
       ]);
     } else {
       logger.error(`Verification failed: ${getErrorMessage(error)}`);
@@ -14846,11 +14894,11 @@ var debugCommand = new Command38("debug").description("Debug and inspect project
 // src/commands/vite/index.ts
 import { Command as Command39 } from "commander";
 
-// src/commands/vite/init.ts
+// src/commands/vite/config.ts
 import path3 from "node:path";
 import { confirm as confirm17 } from "@inquirer/prompts";
-import { dim as dim9, underline as underline6 } from "colorette";
-async function runViteInit() {
+import { dim as dim9 } from "colorette";
+async function runViteConfig() {
   try {
     logger.newLine();
     await requireConfigFile();
@@ -14895,7 +14943,7 @@ async function runViteInit() {
       `2. Run \`${devCommand2}\` to start development`,
       `3. Run \`${buildCommand}\` to build your project`,
       "",
-      `Learn more: ${underline6("<https://docs.playcademy.gg/vite-plugin>")}`
+      "Learn more: <<https://docs.playcademy.net/platform/vite-plugin>>"
     ]);
     logger.newLine();
   } catch (error) {
@@ -14909,7 +14957,7 @@ async function runViteInit() {
 
 // src/commands/vite/index.ts
 var viteCommand = new Command39("vite").description("Vite plugin management");
-viteCommand.command("init").description("Add Vite plugin to your project").action(runViteInit);
+viteCommand.command("config").description("Add Vite plugin to your project").action(runViteConfig);
 
 // src/index.ts
 setupGlobalErrorHandlers();

package/dist/templates/config/timeback-config.js.template

@@ -1,5 +1,5 @@
         // TimeBack integration configuration
-        // See https://docs.playcademy.com/timeback for more details
+        // See https://docs.playcademy.net/timeback for more details
         timeback: {
             course: {
                 subjects: {{SUBJECTS}},{{DEFAULT_SUBJECT}}

package/dist/utils.js

@@ -2031,6 +2031,7 @@ import {
   green,
   greenBright,
   red,
+  underline,
   yellow,
   yellowBright
 } from "colorette";
@@ -2732,6 +2733,7 @@ function formatError(error, indent = 0) {
 function customTransform(text) {
   let result = text;
   result = result.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  result = result.replace(/<<([^>]+)>>/g, (_, url) => underline(url));
   result = result.replace(/<([^>]+)>/g, (_, path2) => blueBright(path2));
   return result;
 }
@@ -3992,7 +3994,7 @@ import { join as join12 } from "path";
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.26",
+  version: "0.14.27",
   type: "module",
   exports: {
     ".": {

package/dist/version.js

@@ -1,7 +1,7 @@
 // package.json with { type: 'json' }
 var package_default = {
   name: "playcademy",
-  version: "0.14.26",
+  version: "0.14.27",
   type: "module",
   exports: {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.14.27",
+    "version": "0.14.28",
     "type": "module",
     "exports": {
         ".": {