@jtl-software/create-cloud-app 0.0.16 → 0.0.18

package/README.md

@@ -2,6 +2,10 @@
 
 Scaffold a [JTL Platform](https://www.jtl-software.com/) cloud app in seconds.
 
+## Requirements
+
+Node.js **24** (current LTS) or newer. The scaffolded project sets the same floor via `engines.node`.
+
 ## Quick start
 
 ```bash

package/dist/index.js

@@ -20,6 +20,7 @@ var REDIRECT_URI = `http://localhost:${CALLBACK_PORT}/callback`;
 var DEFAULT_SCOPE = "openid offline_access";
 var DEFAULT_API_HOST = "https://api.jtl-cloud.com";
 var DEFAULT_AUTH_HOST = "https://auth.jtl-cloud.com";
+var DEFAULT_HUB_HOST = "https://hub.jtl-cloud.com";
 var CLIENT_IDS_BY_AUTH_HOST = {
   "auth.jtl-cloud.com": "b6aca875-c9a3-4010-9fd7-7f8d2e0b0333",
   "auth.dev.jtl-cloud.com": "9c230937-6a52-48d6-9a39-e97edd8ef511",
@@ -521,7 +522,8 @@ async function listTenantApps(apiBaseUrl, jwt, tenantId) {
       id,
       technicalName,
       clientId: entry.app?.clientId,
-      provisioningStatus: entry.app?.activeVersion?.provisioningStatus
+      provisioningStatus: entry.app?.activeVersion?.provisioningStatus,
+      isInstalled: entry.isInstalled
     };
   }).filter((a) => a !== null);
 }
@@ -553,6 +555,7 @@ function resolveOptions(args) {
       options: {
         "api-host": { type: "string" },
         "auth-host": { type: "string" },
+        "hub-host": { type: "string" },
         "client-id": { type: "string" },
         scope: { type: "string" },
         reauth: { type: "boolean" },
@@ -570,6 +573,7 @@ function resolveOptions(args) {
   }
   const api = parsed.values["api-host"] ? validateHost(parsed.values["api-host"], "api-host") : DEFAULT_API_HOST;
   const auth = parsed.values["auth-host"] ? validateHost(parsed.values["auth-host"], "auth-host") : DEFAULT_AUTH_HOST;
+  const hub = parsed.values["hub-host"] ? validateHost(parsed.values["hub-host"], "hub-host") : DEFAULT_HUB_HOST;
   const clientIdArg = parsed.values["client-id"];
   const clientId = clientIdArg ?? CLIENT_IDS_BY_AUTH_HOST[new URL(auth).hostname] ?? "";
   if (!clientId) {
@@ -587,6 +591,7 @@ function resolveOptions(args) {
   return {
     api,
     auth,
+    hub,
     clientId,
     scope: parsed.values.scope ?? DEFAULT_SCOPE,
     reauth: parsed.values.reauth ?? false,
@@ -758,6 +763,25 @@ async function provisionApp(apiBaseUrl, jwt, tenantId, appId) {
   }
   return { clientId, clientSecret };
 }
+function buildHubInstallUrl(hubHost, tenantSlug, appId) {
+  return `${hubHost}/${tenantSlug}/admin/app-overview/manage/${appId}/grants`;
+}
+function buildHubAppOverviewUrl(hubHost, tenantSlug) {
+  return `${hubHost}/${tenantSlug}/admin/app-overview?tab=development-apps`;
+}
+function printHubLink(hubHost, tenantSlug, appId, isInstalled) {
+  if (isInstalled) {
+    p.note(
+      pc.cyan(buildHubAppOverviewUrl(hubHost, tenantSlug)),
+      "Already installed \u2014 open in Hub"
+    );
+  } else {
+    p.note(
+      pc.cyan(buildHubInstallUrl(hubHost, tenantSlug, appId)),
+      "Install in Hub"
+    );
+  }
+}
 function credentialLabels(backend) {
   if (backend.kind === "node") {
     return {
@@ -772,7 +796,7 @@ function credentialLabels(backend) {
     pair: "JtlPlatform:ClientId/ClientSecret"
   };
 }
-async function persistCredentials(backend, clientId, clientSecret, root, opts) {
+async function persistCredentials(backend, clientId, clientSecret, root, opts, context) {
   const targetPath = backend.kind === "node" ? backend.envFile : backend.settingsFile;
   const relPath = path.relative(root, targetPath) || targetPath;
   const labels = credentialLabels(backend);
@@ -788,10 +812,22 @@ async function persistCredentials(backend, clientId, clientSecret, root, opts) {
     console.log(pc.cyan(labels.id) + "     = " + clientId);
     console.log(pc.cyan(labels.secret) + " = " + clientSecret);
     console.log();
+    printHubLink(
+      context.hub,
+      context.tenantSlug,
+      context.appId,
+      context.isInstalled
+    );
     p.outro(pc.green("Done. Credentials printed above; file left untouched."));
     return;
   }
   const written = writeBackendCredentials(backend, clientId, clientSecret);
+  printHubLink(
+    context.hub,
+    context.tenantSlug,
+    context.appId,
+    context.isInstalled
+  );
   p.outro(
     pc.green(
       `Done. Wrote ${labels.pair} to ${pc.cyan(path.relative(root, written) || written)}.`
@@ -811,6 +847,7 @@ async function register(argv = [], runOpts = {}) {
     [
       `${pc.dim("API")}        ${opts.api}`,
       `${pc.dim("Auth")}       ${opts.auth}`,
+      `${pc.dim("Hub")}        ${opts.hub}`,
       `${pc.dim("Client ID")}  ${opts.clientId}`,
       `${pc.dim("Scope")}      ${opts.scope}`
     ].join("\n"),
@@ -876,6 +913,12 @@ async function register(argv = [], runOpts = {}) {
       spinner3.stop("Failed to update manifest");
       bail(err.message);
     }
+    printHubLink(
+      opts.hub,
+      tenant.slug,
+      existing.id,
+      existing.isInstalled ?? false
+    );
     if (existing.clientId) {
       const labels = credentialLabels(backend);
       const envFile = backend.kind === "node" ? backend.envFile : backend.settingsFile;
@@ -923,7 +966,13 @@ async function register(argv = [], runOpts = {}) {
     spinner3.stop("Failed to provision app");
     bail(err.message);
   }
-  await persistCredentials(backend, clientId, clientSecret, root, opts);
+  await persistCredentials(backend, clientId, clientSecret, root, opts, {
+    hub: opts.hub,
+    tenantSlug: tenant.slug,
+    appId,
+    // A freshly created app can't be installed yet.
+    isInstalled: false
+  });
 }
 
 // src/scaffold.ts
@@ -1072,6 +1121,9 @@ async function scaffold({
     name: appName,
     version: "1.0.0",
     private: true,
+    engines: {
+      node: ">=24"
+    },
     workspaces: ["packages/*"],
     scripts: {
       dev: "turbo dev",

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@jtl-software/create-cloud-app",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "type": "module",
   "description": "CLI tool for scaffolding JTL Platform cloud apps",
   "bin": {
     "create-cloud-app": "./dist/index.js"
   },
+  "engines": {
+    "node": ">=24"
+  },
   "files": [
     "dist"
   ],
@@ -15,10 +18,10 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@jtl-software/cloud-app-template-backend-dotnet": "0.0.9",
-    "@jtl-software/cloud-app-template-backend-node": "0.0.11",
-    "@jtl-software/cloud-app-template-frontend-react": "0.0.13",
-    "@jtl-software/cloud-app-template-shared": "0.0.4",
+    "@jtl-software/cloud-app-template-backend-dotnet": "0.0.10",
+    "@jtl-software/cloud-app-template-backend-node": "0.0.12",
+    "@jtl-software/cloud-app-template-frontend-react": "0.0.15",
+    "@jtl-software/cloud-app-template-shared": "0.0.5",
     "picocolors": "^1.1.1"
   },
   "devDependencies": {