@meddleware/access-gate-ui 0.1.10 → 0.1.12

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@meddleware/access-gate-ui",
-  "version": "0.1.10",
+  "version": "0.1.12",
+  "homepage": "https://docs.meddleware.co.uk/blockchain/sui/access-gate/",
   "description": "Operator console for creating and managing on-chain Sui access gates — create gates, configure settings, airdrop NFTs, and freeze gates via a wallet-connected SPA.",
   "author": "Meddleware <dev@meddleware.co.uk>",
   "license": "0BSD",
@@ -31,26 +32,31 @@
     "dev": "vite",
     "build": "vue-tsc --noEmit && vite build",
     "preview": "vite preview",
-    "type-check": "vue-tsc --noEmit"
+    "type-check": "vue-tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@meddleware/design-tokens": "^0.1.2",
-    "@meddleware/ui": "^0.1.11",
+    "@meddleware/design-tokens": "^0.1.3",
+    "@meddleware/ui": "^0.1.13",
     "@meddleware/nft-gate-client": "^0.0.6",
-    "@meddleware/wallet-adapter": "^0.0.5",
-    "@mysten/sui": "^2.30.0",
-    "@mysten/wallet-standard": "^0.20.0",
-    "vue": "^3.5.40"
+    "@meddleware/wallet-adapter": "^0.0.6",
+    "@mysten/sui": "^2.31.0",
+    "@mysten/wallet-standard": "^0.21.0",
+    "vue": "^3.5.43"
   },
   "devDependencies": {
     "@types/node": "~24.12.2",
-    "@vitejs/plugin-vue": "^6.0.8",
+    "@vitejs/plugin-vue": "^6.0.9",
+    "@vue/test-utils": "^2.5.1",
+    "jsdom": "^30.1.0",
     "typescript": "~6.0.0",
-    "vite": "^8.1.5",
-    "vue-tsc": "~3.3.0"
+    "vite": "^8.3.0",
+    "vitest": "~5.0.1",
+    "vue-tsc": "~3.3.11"
   },
   "engines": {
     "node": "^22.18.0 || >=24.12.0"

package/src/App.vue

@@ -10,6 +10,8 @@ import { NETWORK } from './config.js'
 import AccessGateView from './components/AccessGateView.vue'
 
 const { mode, set } = useColorMode('dark')
+const DOCS_URL = import.meta.env.VITE_DOCS_URL || 'https://docs.meddleware.co.uk/blockchain/sui/access-gate/'
+const DEV_URL  = import.meta.env.VITE_DEV_URL  || 'https://dev.meddleware.co.uk/sui/access-gate/'
 const { wallets, account, connect, disconnect } = useWallet()
 
 async function onConnect(): Promise<void> {
@@ -42,7 +44,7 @@ async function onConnect(): Promise<void> {
 
     <AccessGateView />
 
-    <AppFooter />
+    <AppFooter :docs-url="DOCS_URL" :dev-url="DEV_URL" />
   </div>
 </template>
 

package/src/components/GateCard.vue

@@ -99,7 +99,7 @@ function priceLabel(mist: bigint): string {
   color: var(--muted);
 }
 .badge--warn {
-  color: var(--mw-gold-500, #b8860b);
+  color: var(--warning);
   border-color: currentColor;
 }
 .actions {

package/src/constants.ts

@@ -30,3 +30,40 @@ export function accessGateNftType(network: SuiNetwork, soulbound: boolean): stri
   const variant = soulbound ? 'SoulboundAccessNFT' : 'AccessNFT'
   return `${ACCESS_GATE_PACKAGE_ID[network]}::access_gate::${variant}`
 }
+
+/** A canonical Sui package/object id: `0x` followed by exactly 64 lowercase hex digits. */
+const PACKAGE_ID_RE = /^0x[0-9a-f]{64}$/
+
+/**
+ * True iff `id` is a canonically-formatted Sui package id (`0x` + 64 lowercase hex). Empty or
+ * malformed ids (e.g. the not-yet-populated `mainnet` constants) return `false`.
+ */
+export function validatePackageId(id: string): boolean {
+  return PACKAGE_ID_RE.test(id)
+}
+
+/**
+ * Fail-closed diagnostic run at app init. The app already fails closed when a package id is empty
+ * (it produces an unusable `::access_gate::…` type string that no on-chain call will accept); this
+ * surfaces *why* with a clear console warning instead of a silent malformed request. It never
+ * throws — a mis-set network should degrade to "nothing works, here's the reason", not a white
+ * screen.
+ */
+export function warnIfPackageConfigInvalid(network: SuiNetwork): void {
+  const pkg = ACCESS_GATE_PACKAGE_ID[network]
+  const cfg = ACCESS_GATE_PLATFORM_CONFIG_ID[network]
+  if (!validatePackageId(pkg)) {
+    console.warn(
+      `[access-gate-ui] ACCESS_GATE_PACKAGE_ID for network "${network}" is not a valid package id ` +
+        `(${pkg === '' ? 'empty — not yet deployed' : `got "${pkg}"`}). Gate reads/writes will fail ` +
+        `closed until constants.ts is populated with the deployed package id.`,
+    )
+  }
+  if (!validatePackageId(cfg)) {
+    console.warn(
+      `[access-gate-ui] ACCESS_GATE_PLATFORM_CONFIG_ID for network "${network}" is not a valid ` +
+        `object id (${cfg === '' ? 'empty — not yet deployed' : `got "${cfg}"`}). Purchase-preview ` +
+        `and commission display will be unavailable until it is populated.`,
+    )
+  }
+}

package/src/main.ts

@@ -2,5 +2,11 @@ import '@meddleware/design-tokens/tokens.css'
 import '@meddleware/ui/base.css'
 import { createApp } from 'vue'
 import App from './App.vue'
+import { NETWORK } from './config'
+import { warnIfPackageConfigInvalid } from './constants'
+
+// Fail-closed diagnostic: surfaces a clear reason if the active network's package/config ids are
+// missing or malformed (e.g. mainnet before deploy) instead of silently issuing broken calls.
+warnIfPackageConfigInvalid(NETWORK)
 
 createApp(App).mount('#app')