@saasicat/ui-vue 0.26.0 → 0.26.1

package/README.md

@@ -22,6 +22,29 @@ root config) enforces the boundaries in CI.
 | `@saasicat/ui-vue/quasar`                                               | `src/quasar/`                    | everything above + Quasar                | `createSuperAdminApp()` bootstrap and the Quasar notify-port implementation.                                                                                                                                                                                     |
 | `@saasicat/ui-vue/pages-standard/*`, `/pages-tenant/*`, `/components/*` | SFC directories                  | everything                               | The Quasar reference UI, shipped as raw `.vue` from `src/` (compiled by the consumer's Vite).                                                                                                                                                                    |
 
+### The shipped source has a language floor
+
+The last row is not a build output: those subpaths hand out `.vue` and `.ts`
+straight from `src/`, so **your** `tsconfig` compiles them, not ours. Anything
+they reach — which includes `src/client/` and `src/vue/` — therefore has to
+compile under the oldest language level a consumer uses.
+
+That floor is **ES2021** (`lib: ES2021, DOM`), with **TypeScript 5.0** as the
+minimum compiler. The language level is checked rather than promised:
+`pnpm --filter @saasicat/ui-vue test:shipped-source` compiles the closure
+reachable from every source-shipping subpath at that level, with
+`isolatedModules`, `useDefineForClassFields` and `strictPropertyInitialization`
+set the way a Vite app sets them, and CI runs it. The directories come from the export map, so a new source subpath
+is covered the day it is added. The compiler version is not checked — `satisfies`
+in the shipped source needs 4.9 or newer whatever `lib` says, and testing that
+would mean installing old compilers.
+
+Practically this rules out a handful of ES2022 conveniences in shipped code —
+`new Error(msg, { cause })` and `Object.hasOwn` are the two that have come up.
+Use `attachCause()` from `src/client/attach-cause.ts` and
+`Object.prototype.hasOwnProperty.call()` instead. Code that only ever runs from
+`dist/` is unaffected.
+
 Rules of thumb when contributing:
 
 - New page/business logic starts as a composable in `src/vue/` (or, if

package/dist/{chunk-BPF2BMCQ.js → chunk-COVQLDBZ.js}

@@ -4,6 +4,16 @@ function formatMessage(template, params) {
   return formatErrorMessage(template, params);
 }
 
+// src/client/attach-cause.ts
+function attachCause(error, cause) {
+  Object.defineProperty(error, "cause", {
+    value: cause,
+    configurable: true,
+    writable: true
+  });
+  return error;
+}
+
 // src/client/admin-error.ts
 var ADMIN_ERROR = /* @__PURE__ */ Symbol.for("@saasicat/ui-vue/AdminError");
 var PLATFORM_ERROR = /* @__PURE__ */ Symbol.for("@saasicat/ui-vue/PlatformError");
@@ -63,7 +73,8 @@ var AdminError = class extends Error {
   /** The request never reached the server. See `AdminErrorInit`. */
   transportFailure;
   constructor(init = {}) {
-    super(init.message ?? describe(init), { cause: init.cause });
+    super(init.message ?? describe(init));
+    if (init.cause !== void 0) attachCause(this, init.cause);
     this.name = "AdminError";
     this.status = init.status ?? 0;
     this.code = init.code;

package/dist/{chunk-O3J3ITF2.js → chunk-DT25QAU2.js}

@@ -4,7 +4,7 @@ import {
   bindResource,
   createSaCatalog,
   defaultKvStore
-} from "./chunk-BPF2BMCQ.js";
+} from "./chunk-COVQLDBZ.js";
 
 // src/vue/super-admin-context.ts
 var SUPER_ADMIN_BRAND_KEY = /* @__PURE__ */ Symbol.for(

package/dist/{chunk-NEXTZZRQ.js → chunk-O3Y3BYYS.js}

@@ -7,7 +7,7 @@ import {
   markTransportFailure,
   navMessages,
   trimTrailingSlashes
-} from "./chunk-BPF2BMCQ.js";
+} from "./chunk-COVQLDBZ.js";
 
 // src/client/version.ts
 var ADMIN_UI_VERSION = "1.2.0";
@@ -116,7 +116,7 @@ var DEFAULT_STANDARD_PAGE_ROUTES = {
   platformEmailHistory: "/admin/platform-email-history"
 };
 function isSupportedStandardPageKey(key) {
-  return Object.hasOwn(DEFAULT_STANDARD_PAGE_ROUTES, key);
+  return Object.prototype.hasOwnProperty.call(DEFAULT_STANDARD_PAGE_ROUTES, key);
 }
 var DEFAULT_ICONS = {
   dashboard: "dashboard",

package/dist/client/index.cjs

@@ -111,6 +111,16 @@ module.exports = __toCommonJS(client_exports);
 // src/client/version.ts
 var ADMIN_UI_VERSION = "1.2.0";
 
+// src/client/attach-cause.ts
+function attachCause(error, cause) {
+  Object.defineProperty(error, "cause", {
+    value: cause,
+    configurable: true,
+    writable: true
+  });
+  return error;
+}
+
 // src/client/i18n/format.ts
 var import_types = require("@saasicat/types");
 function formatMessage(template, params) {
@@ -176,7 +186,8 @@ var AdminError = class extends Error {
   /** The request never reached the server. See `AdminErrorInit`. */
   transportFailure;
   constructor(init = {}) {
-    super(init.message ?? describe(init), { cause: init.cause });
+    super(init.message ?? describe(init));
+    if (init.cause !== void 0) attachCause(this, init.cause);
     this.name = "AdminError";
     this.status = init.status ?? 0;
     this.code = init.code;
@@ -1003,7 +1014,7 @@ var DEFAULT_STANDARD_PAGE_ROUTES = {
   platformEmailHistory: "/admin/platform-email-history"
 };
 function isSupportedStandardPageKey(key) {
-  return Object.hasOwn(DEFAULT_STANDARD_PAGE_ROUTES, key);
+  return Object.prototype.hasOwnProperty.call(DEFAULT_STANDARD_PAGE_ROUTES, key);
 }
 var DEFAULT_ICONS = {
   dashboard: "dashboard",

package/dist/client/index.d.cts

@@ -260,6 +260,21 @@ declare class AdminError extends Error {
     readonly emptyResponse: boolean;
     /** The request never reached the server. See `AdminErrorInit`. */
     readonly transportFailure: boolean;
+    /**
+     * The error this one was raised from, when `AdminErrorInit` carried one.
+     *
+     * `declare` because the property is real but not emitted here: `attachCause`
+     * defines it, exactly as the ES2022 `Error` constructor would. The
+     * declaration is what makes it *readable* — `Error.cause` lives in
+     * `lib.es2022.error.d.ts`, and this package supports consumers on ES2021,
+     * where taking a cause in and never being able to read it out would be a
+     * one-way public API.
+     *
+     * Not `readonly`, unlike its siblings: the inherited `Error.cause` is
+     * writable, and narrowing that in a patch release would reject assignments
+     * a consumer can make today on ES2022.
+     */
+    cause?: unknown;
     constructor(init?: AdminErrorInit);
 }
 /** Whether `err` is an `AdminError`, including one from another bundle copy. */

package/dist/client/index.d.ts

@@ -260,6 +260,21 @@ declare class AdminError extends Error {
     readonly emptyResponse: boolean;
     /** The request never reached the server. See `AdminErrorInit`. */
     readonly transportFailure: boolean;
+    /**
+     * The error this one was raised from, when `AdminErrorInit` carried one.
+     *
+     * `declare` because the property is real but not emitted here: `attachCause`
+     * defines it, exactly as the ES2022 `Error` constructor would. The
+     * declaration is what makes it *readable* — `Error.cause` lives in
+     * `lib.es2022.error.d.ts`, and this package supports consumers on ES2021,
+     * where taking a cause in and never being able to read it out would be a
+     * one-way public API.
+     *
+     * Not `readonly`, unlike its siblings: the inherited `Error.cause` is
+     * writable, and narrowing that in a patch release would reject assignments
+     * a consumer can make today on ES2022.
+     */
+    cause?: unknown;
     constructor(init?: AdminErrorInit);
 }
 /** Whether `err` is an `AdminError`, including one from another bundle copy. */

package/dist/client/index.js

@@ -27,7 +27,7 @@ import {
   resolveLoginBranding,
   resolvePlans,
   todayIsoDate
-} from "../chunk-NEXTZZRQ.js";
+} from "../chunk-O3Y3BYYS.js";
 import {
   AdminError,
   BootLoadError,
@@ -86,7 +86,7 @@ import {
   tenantsResource,
   toAdminError,
   trimTrailingSlashes
-} from "../chunk-BPF2BMCQ.js";
+} from "../chunk-COVQLDBZ.js";
 export {
   ADMIN_UI_VERSION,
   ActionDefNotInManifestError,

package/dist/index.cjs

@@ -206,6 +206,16 @@ module.exports = __toCommonJS(src_exports);
 // src/client/version.ts
 var ADMIN_UI_VERSION = "1.2.0";
 
+// src/client/attach-cause.ts
+function attachCause(error, cause) {
+  Object.defineProperty(error, "cause", {
+    value: cause,
+    configurable: true,
+    writable: true
+  });
+  return error;
+}
+
 // src/client/i18n/format.ts
 var import_types = require("@saasicat/types");
 function formatMessage(template, params) {
@@ -271,7 +281,8 @@ var AdminError = class extends Error {
   /** The request never reached the server. See `AdminErrorInit`. */
   transportFailure;
   constructor(init = {}) {
-    super(init.message ?? describe(init), { cause: init.cause });
+    super(init.message ?? describe(init));
+    if (init.cause !== void 0) attachCause(this, init.cause);
     this.name = "AdminError";
     this.status = init.status ?? 0;
     this.code = init.code;
@@ -1098,7 +1109,7 @@ var DEFAULT_STANDARD_PAGE_ROUTES = {
   platformEmailHistory: "/admin/platform-email-history"
 };
 function isSupportedStandardPageKey(key) {
-  return Object.hasOwn(DEFAULT_STANDARD_PAGE_ROUTES, key);
+  return Object.prototype.hasOwnProperty.call(DEFAULT_STANDARD_PAGE_ROUTES, key);
 }
 var DEFAULT_ICONS = {
   dashboard: "dashboard",

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   resolveLoginBranding,
   resolvePlans,
   todayIsoDate
-} from "./chunk-NEXTZZRQ.js";
+} from "./chunk-O3Y3BYYS.js";
 import {
   SA_COLOR_SCHEMES,
   SA_LOCALE_STORAGE_KEY,
@@ -55,7 +55,7 @@ import {
   useSaMessages,
   useSaTheme,
   useSuperAdminI18n
-} from "./chunk-O3J3ITF2.js";
+} from "./chunk-DT25QAU2.js";
 import {
   AdminError,
   BootLoadError,
@@ -114,7 +114,7 @@ import {
   tenantsResource,
   toAdminError,
   trimTrailingSlashes
-} from "./chunk-BPF2BMCQ.js";
+} from "./chunk-COVQLDBZ.js";
 
 // src/vue/use-super-admin-context.ts
 import { inject } from "vue";

package/dist/quasar/index.cjs

@@ -38,6 +38,16 @@ var import_quasar4 = require("quasar");
 var import_pinia = require("pinia");
 var import_vue_router = require("vue-router");
 
+// src/client/attach-cause.ts
+function attachCause(error, cause) {
+  Object.defineProperty(error, "cause", {
+    value: cause,
+    configurable: true,
+    writable: true
+  });
+  return error;
+}
+
 // src/client/i18n/format.ts
 var import_types = require("@saasicat/types");
 
@@ -86,7 +96,8 @@ var AdminError = class extends Error {
   /** The request never reached the server. See `AdminErrorInit`. */
   transportFailure;
   constructor(init = {}) {
-    super(init.message ?? describe(init), { cause: init.cause });
+    super(init.message ?? describe(init));
+    if (init.cause !== void 0) attachCause(this, init.cause);
     this.name = "AdminError";
     this.status = init.status ?? 0;
     this.code = init.code;

package/dist/quasar/index.js

@@ -17,11 +17,11 @@ import {
   createSaTheme,
   createSuperAdminI18n,
   resolveSuperAdminEndpoints
-} from "../chunk-O3J3ITF2.js";
+} from "../chunk-DT25QAU2.js";
 import {
   defaultHttpClient,
   platformResources
-} from "../chunk-BPF2BMCQ.js";
+} from "../chunk-COVQLDBZ.js";
 
 // src/quasar/create-super-admin-app.ts
 import { createApp } from "vue";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/ui-vue",
-  "version": "0.26.0",
+  "version": "0.26.1",
   "description": "Vue 3 components, resource clients and composables for the SuperAdmin UI shell. Provides boot and manifest loaders, navigation, actions and standard pages.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -61,7 +61,7 @@
     "src"
   ],
   "dependencies": {
-    "@saasicat/types": "^0.26.0"
+    "@saasicat/types": "^0.26.1"
   },
   "peerDependencies": {
     "pinia": "^2.0.0 || ^3.0.0",
@@ -121,6 +121,7 @@
     "test:component": "vitest run --config vitest.config.ts",
     "test:e2e": "playwright test",
     "test:visual": "playwright test --project=visual",
-    "test:visual:update": "playwright test --project=visual --update-snapshots"
+    "test:visual:update": "playwright test --project=visual --update-snapshots",
+    "test:shipped-source": "node scripts/check-shipped-source.mjs"
   }
 }

package/src/client/admin-error.ts

@@ -19,6 +19,7 @@
 // `adminErrorMessage()` is what turns an error into user-facing text; it is
 // the only place that decides between `detail` and a translated fallback.
 
+import { attachCause } from './attach-cause.js';
 import { formatMessage } from './i18n/format.js';
 import type { SaMessages } from './i18n/messages.js';
 
@@ -234,9 +235,25 @@ export class AdminError extends Error {
     readonly emptyResponse: boolean;
     /** The request never reached the server. See `AdminErrorInit`. */
     readonly transportFailure: boolean;
+    /**
+     * The error this one was raised from, when `AdminErrorInit` carried one.
+     *
+     * `declare` because the property is real but not emitted here: `attachCause`
+     * defines it, exactly as the ES2022 `Error` constructor would. The
+     * declaration is what makes it *readable* — `Error.cause` lives in
+     * `lib.es2022.error.d.ts`, and this package supports consumers on ES2021,
+     * where taking a cause in and never being able to read it out would be a
+     * one-way public API.
+     *
+     * Not `readonly`, unlike its siblings: the inherited `Error.cause` is
+     * writable, and narrowing that in a patch release would reject assignments
+     * a consumer can make today on ES2022.
+     */
+    declare cause?: unknown;
 
     constructor(init: AdminErrorInit = {}) {
-        super(init.message ?? describe(init), { cause: init.cause });
+        super(init.message ?? describe(init));
+        if (init.cause !== undefined) attachCause(this, init.cause);
         this.name = 'AdminError';
         this.status = init.status ?? 0;
         this.code = init.code;

package/src/client/attach-cause.ts

@@ -0,0 +1,21 @@
+/**
+ * Attach a cause to an error without the ES2022 `Error` constructor option.
+ *
+ * `new Error(message, { cause })` needs `lib: ES2022`. This package ships four
+ * of its export subpaths as `.vue`/`.ts` **source** — a consumer compiles those
+ * files, and everything they reach, with their own `tsconfig`. One of them is on
+ * ES2021, where that second argument is a compile error in code they did not
+ * write.
+ *
+ * Defining the property afterwards reads identically to anything inspecting
+ * `error.cause`, and needs nothing above ES5. `scripts/check-shipped-source.mjs`
+ * holds the floor.
+ */
+export function attachCause<E extends Error>(error: E, cause: unknown): E {
+    Object.defineProperty(error, 'cause', {
+        value: cause,
+        configurable: true,
+        writable: true,
+    });
+    return error;
+}

package/src/client/nav-builder.ts

@@ -36,7 +36,9 @@ export const DEFAULT_STANDARD_PAGE_ROUTES: Record<StandardPageKey, string> = {
 };
 
 function isSupportedStandardPageKey(key: string): key is StandardPageKey {
-    return Object.hasOwn(DEFAULT_STANDARD_PAGE_ROUTES, key);
+    // `Object.hasOwn` is ES2022 and this file is compiled by consumers.
+    // See `attach-cause.ts` for why the floor is ES2021.
+    return Object.prototype.hasOwnProperty.call(DEFAULT_STANDARD_PAGE_ROUTES, key);
 }
 
 export interface BuildRouteEntry {

package/src/pages-standard/SuperAdminSetupWizard.vue

@@ -151,6 +151,7 @@
 </template>
 
 <script setup lang="ts">
+import { attachCause } from '../client/attach-cause.js';
 import { computed, reactive, ref } from 'vue';
 import { SETUP_ERROR_CODES, type SetupConfirmMfaResponse, type SetupResult } from '@saasicat/types';
 
@@ -237,10 +238,12 @@ async function postJson<T>(path: string, body: unknown): Promise<T> {
         if (err instanceof HttpJsonError) {
             // The message is translated for the user; `cause` keeps the status
             // and the machine-readable code reachable for anything upstream.
-            throw new Error(
-                (err.code && errorByCode.value[err.code]) ||
-                    formatMessage(msg.value.setup.errorHttp, { status: err.status }),
-                { cause: err },
+            throw attachCause(
+                new Error(
+                    (err.code && errorByCode.value[err.code]) ||
+                        formatMessage(msg.value.setup.errorHttp, { status: err.status }),
+                ),
+                err,
             );
         }
         throw err;