MapColonies · netanelC · Jul 20, 2025 · Jul 20, 2025
diff --git a/package-lock.json b/package-lock.json
diff --git a/packages/kiosk-ui/src/components/main-page/application-card.tsx b/packages/kiosk-ui/src/components/main-page/application-card.tsx
@@ -1,9 +1,10 @@
-import { CheckCircle, ExternalLink } from 'lucide-react';
+import { ExternalLink } from 'lucide-react';
 import { Card, CardContent } from '@/components/ui/card';
 import classNames from 'classnames';
 import { cn } from '@/lib/utils';
 
 interface ApplicationCardProps {
+  disable?: boolean;
   icon: string;
   iconAlt: string;
   title: string;
@@ -15,16 +16,32 @@ interface ApplicationCardProps {
   shadowColor?: string;
 }
 
-export function ApplicationCard({ icon, iconAlt, title, subtitle, description, iconBgColor, checkColor, link, shadowColor }: ApplicationCardProps) {
+export function ApplicationCard({
+  icon,
+  iconAlt,
+  title,
+  subtitle,
+  description,
+  iconBgColor,
+  checkColor,
+  link,
+  shadowColor,
+  disable,
+}: ApplicationCardProps) {
   // Use a stronger shadow in dark mode, but keep it subtle
   const darkShadow = shadowColor ? shadowColor.replace(/0\.15\)/, '0.35)') : undefined;
   const isDark = typeof window !== 'undefined' && window.matchMedia('(prefers-color-scheme: dark)').matches;
   const appliedShadow = shadowColor ? (isDark ? darkShadow : shadowColor) : undefined;
 
+  const isDisabled = !!disable;
+
   const content = (
     <Card
       className={cn(
-        classNames('border rounded-xl transition-shadow duration-200', { 'hover:shadow-lg hover:-translate-y-1 hover:border-primary/30': link })
+        classNames('border rounded-xl transition-shadow duration-200', {
+          'hover:shadow-lg hover:-translate-y-1 hover:border-primary/30': link && !isDisabled,
+          'pointer-events-none': isDisabled,
+        })
       )}
       style={{
         boxShadow: appliedShadow ? `0 2px 16px 0 ${appliedShadow}` : undefined,
@@ -43,22 +60,19 @@ export function ApplicationCard({ icon, iconAlt, title, subtitle, description, i
             <p className="text-xs text-muted-foreground leading-tight">{subtitle}</p>
             <p className="text-xs text-muted-foreground leading-tight">{description}</p>
           </div>
-          {/* Use ExternalLink icon if clickable, else CheckCircle */}
-          {link ? (
-            <ExternalLink className={cn('h-4 w-4 flex-shrink-0', checkColor)} />
-          ) : (
-            <CheckCircle className={cn('h-4 w-4 flex-shrink-0', checkColor)} />
-          )}
+          {/* Show icon only if not disabled and link exists, else nothing */}
+          {link && !isDisabled ? <ExternalLink className={cn('h-4 w-4 flex-shrink-0', checkColor)} /> : null}
         </div>
       </CardContent>
     </Card>
   );
 
-  return link ? (
-    <a href={link} target="_blank" rel="noopener noreferrer" className="block">
-      {content}
-    </a>
-  ) : (
-    content
-  );
+  if (link && !isDisabled) {
+    return (
+      <a href={link} target="_blank" rel="noopener noreferrer" className="block">
+        {content}
+      </a>
+    );
+  }
+  return content;
 }
diff --git a/packages/kiosk-ui/src/components/main-page/supported-applications.tsx b/packages/kiosk-ui/src/components/main-page/supported-applications.tsx
@@ -14,6 +14,7 @@ export function SupportedApplications() {
 
       {/* QGIS Card */}
       <ApplicationCard
+        disable={!guides?.enabled} // Disable if guides are not enabled
         icon={QGISLogo}
         iconAlt={t('applications.qgis.alt')}
         title={t('applications.qgis.title')}
@@ -27,6 +28,7 @@ export function SupportedApplications() {
 
       {/* ArcGIS Pro Card */}
       <ApplicationCard
+        disable={!guides?.enabled} // Disable if guides are not enabled
         icon={ArcGISLogo}
         iconAlt={t('applications.arcgis.alt')}
         title={t('applications.arcgis.title')}

diff --git a/packages/kiosk-ui/src/types/openapi.d.ts b/packages/kiosk-ui/src/types/openapi.d.ts
@@ -127,6 +127,8 @@ export interface components {
       qgis: string;
       /** @description Link to ArcGIS Pro documentation */
       arcgis: string;
+      /** @description Whether the guides are enabled */
+      enabled: boolean;
     };
     /**
      * @description Type of file to retrieve (qlr for QGIS, lyrx for ArcGIS Pro)
@@ -303,8 +305,13 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          'application/xml': string;
-          'application/json': string;
+          'application/json':
+            | {
+                [key: string]: unknown;
+              }
+            | string
+            | Record<string, never>;
+          'application/xml': string | Record<string, never>;
         };
       };
       /** @description Unauthorized - No valid token */
@@ -316,8 +323,8 @@ export interface operations {
           'application/json': components['schemas']['error'];
         };
       };
-      /** @description Not Found - QLR file not available */
-      404: {
+      /** @description Forbidden - User is banned */
+      403: {
         headers: {
           [name: string]: unknown;
         };

diff --git a/packages/token-kiosk/openapi3.yaml b/packages/token-kiosk/openapi3.yaml
@@ -230,6 +230,7 @@ components:
       required:
         - qgis
         - arcgis
+        - enabled
       type: object
       properties:
         qgis:
@@ -238,6 +239,9 @@ components:
         arcgis:
           type: string
           description: Link to ArcGIS Pro documentation
+        enabled:
+          type: boolean
+          description: Whether the guides are enabled
     fileTypes:
       type: string
       enum: [qlr, lyrx]

diff --git a/packages/token-kiosk/package.json b/packages/token-kiosk/package.json
@@ -38,7 +38,7 @@
     "@map-colonies/js-logger": "^2.0.0",
     "@map-colonies/openapi-express-viewer": "^4.0.0",
     "@map-colonies/read-pkg": "^1.0.0",
-    "@map-colonies/schemas": "^1.12.1",
+    "@map-colonies/schemas": "^1.12.2",
     "@map-colonies/telemetry": "^10.0.1",
     "@opentelemetry/api": "^1.9.0",
     "async-cache-dedupe": "^2.2.0",

diff --git a/packages/token-kiosk/src/openapi.d.ts b/packages/token-kiosk/src/openapi.d.ts
@@ -124,6 +124,8 @@ export type components = {
       qgis: string;
       /** @description Link to ArcGIS Pro documentation */
       arcgis: string;
+      /** @description Whether the guides are enabled */
+      enabled: boolean;
     };
     /**
      * @description Type of file to retrieve (qlr for QGIS, lyrx for ArcGIS Pro)
@@ -300,8 +302,13 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          'application/xml': string;
-          'application/json': string;
+          'application/json':
+            | {
+                [key: string]: unknown;
+              }
+            | string
+            | Record<string, never>;
+          'application/xml': string | Record<string, never>;
         };
       };
       /** @description Unauthorized - No valid token */
@@ -313,8 +320,8 @@ export interface operations {
           'application/json': components['schemas']['error'];
         };
       };
-      /** @description Not Found - QLR file not available */
-      404: {
+      /** @description Forbidden - User is banned */
+      403: {
         headers: {
           [name: string]: unknown;
         };

diff --git a/packages/token-kiosk/tests/guides/guides.spec.ts b/packages/token-kiosk/tests/guides/guides.spec.ts
@@ -56,6 +56,7 @@ describe('guides', function () {
       expect(res.body).toEqual({
         qgis: 'https://example.com/qgis-guide',
         arcgis: 'https://example.com/arcgis-guide',
+        enabled: true,
       });
     });
   });