create-saasicat-admin 0.25.0 → 0.26.0

package/README.md

@@ -41,15 +41,15 @@ pnpm dev   # http://localhost:9100/admin/login
 
 ## Options
 
-| Flag             | Default         | Purpose                                            |
-| ---------------- | --------------- | -------------------------------------------------- |
-| `--project-key`  | `app`           | used as prefix in storage keys + tokens            |
-| `--brand-name`   | `App`           | shown in the AdminLayout header                    |
-| `--logo-text`    | `AP`            | two-letter badge in the logo                       |
-| `--api-base`     | `/api/v1/admin` | backend endpoint prefix                            |
-| `--dev-port`     | `9100`          | Vite dev server port                               |
-| `--backend-port` | `3000`          | backend port for the Vite proxy                    |
-| `--no-install`   | false           | only generate files, skip the final `pnpm install` |
+| Flag             | Default         | Purpose                                                 |
+| ---------------- | --------------- | ------------------------------------------------------- |
+| `--project-key`  | `app`           | catalogue this admin administers; also a storage prefix |
+| `--brand-name`   | `App`           | shown in the AdminLayout header                         |
+| `--logo-text`    | `AP`            | two-letter badge in the logo                            |
+| `--api-base`     | `/api/v1/admin` | backend endpoint prefix                                 |
+| `--dev-port`     | `9100`          | Vite dev server port                                    |
+| `--backend-port` | `3000`          | backend port for the Vite proxy                         |
+| `--no-install`   | false           | only generate files, skip the final `pnpm install`      |
 
 ## What is left to do afterwards
 

package/bin/create.js

@@ -119,7 +119,8 @@ async function main() {
         console.log('Usage: pnpm create saasicat-admin <dir> [flags]');
         console.log('');
         console.log('Flags:');
-        console.log('  --project-key=app           storage key prefix');
+        console.log('  --project-key=app           the catalogue this admin administers');
+        console.log('                              (also the storage-key prefix)');
         console.log('  --brand-name=App            brand name in the header');
         console.log('  --logo-text=AP              two-letter badge');
         console.log('  --api-base=/api/v1/admin    backend prefix');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-saasicat-admin",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Scaffolding CLI for SuperAdmin frontend projects (Vue 3 + Quasar + Vite). Generates a minimal working admin app built on @saasicat/ui-vue. Usage: `pnpm create saasicat-admin <dir>`.",
   "type": "module",
   "bin": {

package/templates/src/services/http.ts.tpl

@@ -4,7 +4,7 @@
 // storage are app-specific.
 
 import axios from 'axios';
-import type { HttpClient, HttpResponse } from '@saasicat/ui-vue';
+import { createAxiosHttpClient } from '@saasicat/ui-vue';
 
 const TOKEN_KEY = '__PROJECT_KEY__-admin-token';
 
@@ -15,29 +15,9 @@ api.interceptors.request.use((cfg) => {
     return cfg;
 });
 
-export const platformHttp: HttpClient = async (url, init) => {
-    const stripped = url.startsWith('/api/v1') ? url.slice(7) : url;
-    const r = await api.request({
-        url: stripped,
-        method: (init?.method ?? 'GET') as 'GET' | 'POST',
-        headers: init?.headers,
-        data: init?.body,
-        validateStatus: (s) => s < 500,
-    });
-    const res: HttpResponse = {
-        status: r.status,
-        headers: {
-            get: (n) => {
-                const v = r.headers[n.toLowerCase()];
-                return v == null ? null : String(v);
-            },
-        },
-        json: async () => r.data,
-        text: async () =>
-            typeof r.data === 'string' ? r.data : JSON.stringify(r.data),
-    };
-    return res;
-};
+// The instance already carries `/api/v1` as its baseURL and the platform passes
+// fully-qualified paths, so the prefix is stripped back off before the request.
+export const platformHttp = createAxiosHttpClient(api, { stripPrefix: '/api/v1' });
 
 export async function adminLogin(email: string, password: string) {
     try {

package/templates/src/services/platform-loaders.ts.tpl

@@ -5,7 +5,13 @@
 import { createPlatformLoaders, type SuperAdminEndpoints } from '@saasicat/ui-vue';
 import { getAuthToken, platformHttp } from './http';
 
-export const ADMIN_ENDPOINTS: SuperAdminEndpoints = { apiBase: '__API_BASE__' };
+// `projectKey` names the catalogue this admin administers — the same key your
+// backend configuration uses. The shell hands it to every platform resource,
+// so a catalogue page does not have to carry it as a prop.
+export const ADMIN_ENDPOINTS: SuperAdminEndpoints = {
+    apiBase: '__API_BASE__',
+    projectKey: '__PROJECT_KEY__',
+};
 
 export const loaders = createPlatformLoaders({
     endpoints: ADMIN_ENDPOINTS,