@wasto/sdk 1.0.3 → 1.0.5

package/src/dashboard-apps.ts

@@ -1,350 +1,367 @@
-/**
- * Catalogue des sections Wast-O.
- * @deprecated Préférer WASTO_SECTIONS pour les libellés UI ; DASHBOARD_APPS reste pour l'API permissions.
- */
-export enum DashboardAppSlug {
-  WORKSPACE = 'WORKSPACE',
-  WASTO = 'WASTO',
-  APPSO = 'APPSO',
-  CALENDO = 'CALENDO',
-  ACTO = 'ACTO',
-  ASSISTO = 'ASSISTO',
-  PLAYO = 'PLAYO',
-  MAPSO = 'MAPSO',
-  IAGO = 'IAGO',
-  PEDAGO = 'PEDAGO',
-  MARKETO = 'MARKETO',
-}
-
-export type DashboardAppDefinition = {
-  slug: DashboardAppSlug;
-  /** Clé utilisée dans les URLs (ex. `wasto`, `appso`) */
-  key: string;
-  label: string;
-  dashboardPath: string;
-  isDevOnly?: boolean;
-};
-
-export type WastoSectionDefinition = {
-  slug: DashboardAppSlug;
-  key: string;
-  label: string;
-  sectionLabel: string;
-  dashboardPath: string;
-  isDevOnly?: boolean;
-};
-
-export const WASTO_SECTIONS: WastoSectionDefinition[] = [
-  {
-    slug: DashboardAppSlug.WORKSPACE,
-    key: 'workspace',
-    label: 'WORKSPACE',
-    sectionLabel: 'Tableau de bord',
-    dashboardPath: '/dashboard',
-  },
-  {
-    slug: DashboardAppSlug.WASTO,
-    key: 'wasto',
-    label: "WAST'O",
-    sectionLabel: 'Référentiel & collecte',
-    dashboardPath: '/referentiel',
-  },
-  {
-    slug: DashboardAppSlug.PLAYO,
-    key: 'playo',
-    label: "PLAY'O",
-    sectionLabel: 'Engagement',
-    dashboardPath: '/engagement',
-  },
-  {
-    slug: DashboardAppSlug.ACTO,
-    key: 'acto',
-    label: "ACT'O",
-    sectionLabel: 'Animation terrain',
-    dashboardPath: '/terrain/enquetes',
-  },
-  {
-    slug: DashboardAppSlug.IAGO,
-    key: 'iago',
-    label: "AGENT'O",
-    sectionLabel: 'Scan & IA',
-    dashboardPath: '/scan',
-    isDevOnly: true,
-  },
-  {
-    slug: DashboardAppSlug.MAPSO,
-    key: 'mapso',
-    label: "MAPS'O",
-    sectionLabel: 'Cartographie',
-    dashboardPath: '/cartographie/infrastructures',
-  },
-  {
-    slug: DashboardAppSlug.CALENDO,
-    key: 'calendo',
-    label: "CALEND'O",
-    sectionLabel: 'Événements',
-    dashboardPath: '/evenements',
-  },
-  {
-    slug: DashboardAppSlug.APPSO,
-    key: 'appso',
-    label: "APP'O",
-    sectionLabel: 'Studio app',
-    dashboardPath: '/studio-app/apps',
-  },
-  {
-    slug: DashboardAppSlug.PEDAGO,
-    key: 'pedago',
-    label: "PEDAG'O",
-    sectionLabel: 'Analyses & ROI',
-    dashboardPath: '/analyses',
-    isDevOnly: true,
-  },
-  {
-    slug: DashboardAppSlug.ASSISTO,
-    key: 'assisto',
-    label: "ASSIST'O",
-    sectionLabel: 'Support',
-    dashboardPath: '/support',
-  },
-];
-
-export const DASHBOARD_APPS: DashboardAppDefinition[] = [
-  {
-    slug: DashboardAppSlug.WORKSPACE,
-    key: 'workspace',
-    label: 'WORKSPACE',
-    dashboardPath: '/dashboard',
-  },
-  {
-    slug: DashboardAppSlug.WASTO,
-    key: 'wasto',
-    label: "WAST'O",
-    dashboardPath: '/referentiel',
-  },
-  {
-    slug: DashboardAppSlug.APPSO,
-    key: 'appso',
-    label: "APP'O",
-    dashboardPath: '/studio-app/apps',
-  },
-  {
-    slug: DashboardAppSlug.CALENDO,
-    key: 'calendo',
-    label: "CALEND'O",
-    dashboardPath: '/evenements',
-  },
-  {
-    slug: DashboardAppSlug.ACTO,
-    key: 'acto',
-    label: "ACT'O",
-    dashboardPath: '/terrain/enquetes',
-  },
-  {
-    slug: DashboardAppSlug.ASSISTO,
-    key: 'assisto',
-    label: "ASSIST'O",
-    dashboardPath: '/support',
-  },
-  {
-    slug: DashboardAppSlug.PLAYO,
-    key: 'playo',
-    label: "PLAY'O",
-    dashboardPath: '/engagement',
-  },
-  {
-    slug: DashboardAppSlug.MAPSO,
-    key: 'mapso',
-    label: "MAPS'O",
-    dashboardPath: '/cartographie/infrastructures',
-  },
-  {
-    slug: DashboardAppSlug.IAGO,
-    key: 'iago',
-    label: "AGENT'O",
-    dashboardPath: '/scan',
-    isDevOnly: true,
-  },
-  {
-    slug: DashboardAppSlug.PEDAGO,
-    key: 'pedago',
-    label: "PEDAG'O",
-    dashboardPath: '/analyses',
-    isDevOnly: true,
-  },
-  {
-    slug: DashboardAppSlug.MARKETO,
-    key: 'marketo',
-    label: "MARKET'O",
-    dashboardPath: '/analyses',
-    isDevOnly: true,
-  },
-];
-
-export const WASTO_SECTION_BY_KEY = Object.fromEntries(
-  WASTO_SECTIONS.map((s) => [s.key, s]),
-) as Record<string, WastoSectionDefinition>;
-
-export const DASHBOARD_APP_BY_SLUG = Object.fromEntries(
-  DASHBOARD_APPS.map((a) => [a.slug, a]),
-) as Record<DashboardAppSlug, DashboardAppDefinition>;
-
-export const DASHBOARD_APP_BY_KEY = Object.fromEntries(
-  DASHBOARD_APPS.map((a) => [a.key, a]),
-) as Record<string, DashboardAppDefinition>;
-
-/** Apps activées par défaut si le groupement n'a aucune configuration explicite. */
-export const DEFAULT_ENABLED_DASHBOARD_APP_SLUGS: DashboardAppSlug[] = DASHBOARD_APPS.filter(
-  (a) => !a.isDevOnly,
-).map((a) => a.slug);
-
-/**
- * Preset self-serve / compte gratuit (mode restreint).
- * WORKSPACE + WASTO (référentiel, calendriers, planche) + APPSO (PWA light tri+calendrier).
- * Hors scope / hors nav : Analyses & ROI, Annonces, Centres de tri, Points de collecte,
- * Engagement (PLAYO), ACTO, IAGO, PEDAGO, MAPSO, CALENDO, invite membres.
- */
-export const FREE_SELF_SERVE_DASHBOARD_APP_SLUGS: DashboardAppSlug[] = [
-  DashboardAppSlug.WORKSPACE,
-  DashboardAppSlug.WASTO,
-  DashboardAppSlug.APPSO,
-];
-
-/**
- * Apps encore présentes sur d’anciens comptes free (désactivées au sync).
- * Conservées pour la détection `isFreeSelfServeAppAccess` jusqu’à resync.
- */
-const FREE_SELF_SERVE_LEGACY_EXTRA_SLUGS: DashboardAppSlug[] = [
-  DashboardAppSlug.PLAYO,
-];
-
-/** Normalise slug API (`WORKSPACE`) ou clé URL (`workspace`) vers DashboardAppSlug. */
-export function normalizeDashboardAppSlug(
-  value: string,
-): DashboardAppSlug | null {
-  const upper = value.toUpperCase();
-  if (DASHBOARD_APP_BY_SLUG[upper as DashboardAppSlug]) {
-    return upper as DashboardAppSlug;
-  }
-  return dashboardAppKeyToSlug(value.toLowerCase());
-}
-
-/**
- * True si la whitelist explicite du groupement est limitée au preset free
- * (aucune app hors FREE_SELF_SERVE, hors extras legacy). Aucune ligne / defaults plein → false.
- * Accepte slugs (`WORKSPACE`) ou clés (`workspace`).
- */
-export function isFreeSelfServeAppAccess(
-  enabledSlugs: ReadonlyArray<string>,
-): boolean {
-  if (enabledSlugs.length === 0) return false;
-  const free = new Set<string>([
-    ...FREE_SELF_SERVE_DASHBOARD_APP_SLUGS,
-    ...FREE_SELF_SERVE_LEGACY_EXTRA_SLUGS,
-  ]);
-  return enabledSlugs.every((slug) => {
-    const normalized = normalizeDashboardAppSlug(slug);
-    return normalized != null && free.has(normalized);
-  });
-}
-
-/**
- * Résout les apps actives à partir des lignes `city_group_app_access`.
- * - Aucune ligne → defaults « plein » (compat collectivités existantes).
- * - Au moins une ligne → **whitelist stricte** des `enabled: true` (mode restreint possible).
- */
-export function resolveEnabledDashboardAppSlugs(
-  rows: ReadonlyArray<{ appSlug: string; enabled: boolean }>,
-): DashboardAppSlug[] {
-  if (rows.length === 0) {
-    return [...DEFAULT_ENABLED_DASHBOARD_APP_SLUGS];
-  }
-  const enabled = rows
-    .filter((r) => r.enabled)
-    .map((r) => r.appSlug as DashboardAppSlug)
-    .filter((slug) => DASHBOARD_APPS.some((a) => a.slug === slug));
-  return [...new Set(enabled)];
-}
-
-export function dashboardAppSlugToKey(slug: DashboardAppSlug): string {
-  return DASHBOARD_APP_BY_SLUG[slug]?.key ?? slug.toLowerCase();
-}
-
-export function dashboardAppKeyToSlug(key: string): DashboardAppSlug | null {
-  return DASHBOARD_APP_BY_KEY[key]?.slug ?? null;
-}
-
-/** Domaine racine des landings Wast-O (ex. `wasto.localhost` en dev). */
-export const WASTO_LANDINGS_DOMAIN = 'wasto.localhost';
-
-/** Hôte de l’index des landings (catalogue de toutes les apps). */
-export const WASTO_LANDINGS_INDEX_HOST = `apps.${WASTO_LANDINGS_DOMAIN}`;
-
-/** Hôtes Traefik déjà réservés sous `*.wasto.localhost` (hors landings par module). */
-export const WASTO_RESERVED_SUBDOMAINS = new Set([
-  'api',
-  'admin',
-  'dashboard',
-  'docs',
-  'field-survey',
-  'apps',
-]);
-
-export function isDashboardAppLandingHost(host: string): boolean {
-  const normalized = host.split(':')[0]?.toLowerCase() ?? '';
-  if (normalized === WASTO_LANDINGS_INDEX_HOST) {
-    return true;
-  }
-  const match = normalized.match(/^([a-z]+)\.wasto\.localhost$/);
-  if (!match) {
-    return false;
-  }
-  const subdomain = match[1];
-  if (WASTO_RESERVED_SUBDOMAINS.has(subdomain)) {
-    return false;
-  }
-  return Boolean(DASHBOARD_APP_BY_KEY[subdomain]);
-}
-
-export function dashboardAppKeyFromLandingHost(host: string): string | null {
-  const normalized = host.split(':')[0]?.toLowerCase() ?? '';
-  if (normalized === WASTO_LANDINGS_INDEX_HOST) {
-    return null;
-  }
-  const match = normalized.match(/^([a-z]+)\.wasto\.localhost$/);
-  if (!match) {
-    return null;
-  }
-  const key = match[1];
-  if (WASTO_RESERVED_SUBDOMAINS.has(key) || !DASHBOARD_APP_BY_KEY[key]) {
-    return null;
-  }
-  return key;
-}
-
-type ResolveLandingUrlOptions = {
-  /** Domaine racine (défaut : `wasto.localhost`). */
-  domain?: string;
-  /** Protocole (défaut : `http` en dev, `https` si `NODE_ENV=production`). */
-  protocol?: string;
-};
-
-/** URL publique de la landing d’un module (ex. `http://acto.wasto.localhost`). */
-export function resolveDashboardAppLandingUrl(
-  key: string,
-  options?: ResolveLandingUrlOptions,
-): string | null {
-  if (!DASHBOARD_APP_BY_KEY[key]) {
-    return null;
-  }
-  const domain = options?.domain ?? WASTO_LANDINGS_DOMAIN;
-  const protocol = options?.protocol ?? 'http';
-  return `${protocol}://${key}.${domain}`;
-}
-
-/** URL de l’index des landings Wast-O (ex. `http://apps.wasto.localhost`). */
-export function resolveWastoLandingsIndexUrl(options?: ResolveLandingUrlOptions): string {
-  const domain = options?.domain ?? WASTO_LANDINGS_DOMAIN;
-  const protocol = options?.protocol ?? 'http';
-  return `${protocol}://apps.${domain}`;
-}
+/**
+ * Catalogue des sections Wast-O.
+ * @deprecated Préférer WASTO_SECTIONS pour les libellés UI ; DASHBOARD_APPS reste pour l'API permissions.
+ */
+export enum DashboardAppSlug {
+  WORKSPACE = 'WORKSPACE',
+  WASTO = 'WASTO',
+  APPSO = 'APPSO',
+  CALENDO = 'CALENDO',
+  ACTO = 'ACTO',
+  ASSISTO = 'ASSISTO',
+  PLAYO = 'PLAYO',
+  MAPSO = 'MAPSO',
+  IAGO = 'IAGO',
+  PEDAGO = 'PEDAGO',
+  MARKETO = 'MARKETO',
+  /** Connect'O — API agents / MCP (hors free self-serve) */
+  CONNECTO = 'CONNECTO',
+}
+
+export type DashboardAppDefinition = {
+  slug: DashboardAppSlug;
+  /** Clé utilisée dans les URLs (ex. `wasto`, `appso`) */
+  key: string;
+  label: string;
+  dashboardPath: string;
+  isDevOnly?: boolean;
+};
+
+export type WastoSectionDefinition = {
+  slug: DashboardAppSlug;
+  key: string;
+  label: string;
+  sectionLabel: string;
+  dashboardPath: string;
+  isDevOnly?: boolean;
+};
+
+export const WASTO_SECTIONS: WastoSectionDefinition[] = [
+  {
+    slug: DashboardAppSlug.WORKSPACE,
+    key: 'workspace',
+    label: 'WORKSPACE',
+    sectionLabel: 'Tableau de bord',
+    dashboardPath: '/dashboard',
+  },
+  {
+    slug: DashboardAppSlug.WASTO,
+    key: 'wasto',
+    label: "WAST'O",
+    sectionLabel: 'Référentiel & collecte',
+    dashboardPath: '/referentiel',
+  },
+  {
+    slug: DashboardAppSlug.PLAYO,
+    key: 'playo',
+    label: "PLAY'O",
+    sectionLabel: 'Engagement',
+    dashboardPath: '/engagement',
+  },
+  {
+    slug: DashboardAppSlug.ACTO,
+    key: 'acto',
+    label: "ACT'O",
+    sectionLabel: 'Animation terrain',
+    dashboardPath: '/terrain/enquetes',
+  },
+  {
+    slug: DashboardAppSlug.IAGO,
+    key: 'iago',
+    label: "AGENT'O",
+    sectionLabel: 'Scan & IA',
+    dashboardPath: '/scan',
+    isDevOnly: true,
+  },
+  {
+    slug: DashboardAppSlug.MAPSO,
+    key: 'mapso',
+    label: "MAPS'O",
+    sectionLabel: 'Cartographie',
+    dashboardPath: '/cartographie/infrastructures',
+  },
+  {
+    slug: DashboardAppSlug.CALENDO,
+    key: 'calendo',
+    label: "CALEND'O",
+    sectionLabel: 'Événements',
+    dashboardPath: '/evenements',
+  },
+  {
+    slug: DashboardAppSlug.APPSO,
+    key: 'appso',
+    label: "APP'O",
+    sectionLabel: 'Studio app',
+    dashboardPath: '/studio-app/apps',
+  },
+  {
+    slug: DashboardAppSlug.PEDAGO,
+    key: 'pedago',
+    label: "PEDAG'O",
+    sectionLabel: 'Analyses & ROI',
+    dashboardPath: '/analyses',
+    isDevOnly: true,
+  },
+  {
+    slug: DashboardAppSlug.ASSISTO,
+    key: 'assisto',
+    label: "ASSIST'O",
+    sectionLabel: 'Support',
+    dashboardPath: '/support',
+  },
+  {
+    slug: DashboardAppSlug.CONNECTO,
+    key: 'connecto',
+    label: "CONNECT'O",
+    sectionLabel: 'API & agents',
+    dashboardPath: '/integrations',
+    isDevOnly: true,
+  },
+];
+
+export const DASHBOARD_APPS: DashboardAppDefinition[] = [
+  {
+    slug: DashboardAppSlug.WORKSPACE,
+    key: 'workspace',
+    label: 'WORKSPACE',
+    dashboardPath: '/dashboard',
+  },
+  {
+    slug: DashboardAppSlug.WASTO,
+    key: 'wasto',
+    label: "WAST'O",
+    dashboardPath: '/referentiel',
+  },
+  {
+    slug: DashboardAppSlug.APPSO,
+    key: 'appso',
+    label: "APP'O",
+    dashboardPath: '/studio-app/apps',
+  },
+  {
+    slug: DashboardAppSlug.CALENDO,
+    key: 'calendo',
+    label: "CALEND'O",
+    dashboardPath: '/evenements',
+  },
+  {
+    slug: DashboardAppSlug.ACTO,
+    key: 'acto',
+    label: "ACT'O",
+    dashboardPath: '/terrain/enquetes',
+  },
+  {
+    slug: DashboardAppSlug.ASSISTO,
+    key: 'assisto',
+    label: "ASSIST'O",
+    dashboardPath: '/support',
+  },
+  {
+    slug: DashboardAppSlug.PLAYO,
+    key: 'playo',
+    label: "PLAY'O",
+    dashboardPath: '/engagement',
+  },
+  {
+    slug: DashboardAppSlug.MAPSO,
+    key: 'mapso',
+    label: "MAPS'O",
+    dashboardPath: '/cartographie/infrastructures',
+  },
+  {
+    slug: DashboardAppSlug.IAGO,
+    key: 'iago',
+    label: "AGENT'O",
+    dashboardPath: '/scan',
+    isDevOnly: true,
+  },
+  {
+    slug: DashboardAppSlug.PEDAGO,
+    key: 'pedago',
+    label: "PEDAG'O",
+    dashboardPath: '/analyses',
+    isDevOnly: true,
+  },
+  {
+    slug: DashboardAppSlug.MARKETO,
+    key: 'marketo',
+    label: "MARKET'O",
+    dashboardPath: '/analyses',
+    isDevOnly: true,
+  },
+  {
+    slug: DashboardAppSlug.CONNECTO,
+    key: 'connecto',
+    label: "CONNECT'O",
+    dashboardPath: '/integrations',
+    isDevOnly: true,
+  },
+];
+
+export const WASTO_SECTION_BY_KEY = Object.fromEntries(
+  WASTO_SECTIONS.map((s) => [s.key, s]),
+) as Record<string, WastoSectionDefinition>;
+
+export const DASHBOARD_APP_BY_SLUG = Object.fromEntries(
+  DASHBOARD_APPS.map((a) => [a.slug, a]),
+) as Record<DashboardAppSlug, DashboardAppDefinition>;
+
+export const DASHBOARD_APP_BY_KEY = Object.fromEntries(
+  DASHBOARD_APPS.map((a) => [a.key, a]),
+) as Record<string, DashboardAppDefinition>;
+
+/** Apps activées par défaut si le groupement n'a aucune configuration explicite. */
+export const DEFAULT_ENABLED_DASHBOARD_APP_SLUGS: DashboardAppSlug[] = DASHBOARD_APPS.filter(
+  (a) => !a.isDevOnly,
+).map((a) => a.slug);
+
+/**
+ * Preset self-serve / compte gratuit (mode restreint).
+ * WORKSPACE + WASTO (référentiel, calendriers, planche) + APPSO (PWA light tri+calendrier).
+ * Hors scope / hors nav : Analyses & ROI, Annonces, Centres de tri, Points de collecte,
+ * Engagement (PLAYO), ACTO, IAGO, PEDAGO, MAPSO, CALENDO, invite membres.
+ */
+export const FREE_SELF_SERVE_DASHBOARD_APP_SLUGS: DashboardAppSlug[] = [
+  DashboardAppSlug.WORKSPACE,
+  DashboardAppSlug.WASTO,
+  DashboardAppSlug.APPSO,
+];
+
+/**
+ * Apps encore présentes sur d’anciens comptes free (désactivées au sync).
+ * Conservées pour la détection `isFreeSelfServeAppAccess` jusqu’à resync.
+ */
+const FREE_SELF_SERVE_LEGACY_EXTRA_SLUGS: DashboardAppSlug[] = [
+  DashboardAppSlug.PLAYO,
+];
+
+/** Normalise slug API (`WORKSPACE`) ou clé URL (`workspace`) vers DashboardAppSlug. */
+export function normalizeDashboardAppSlug(
+  value: string,
+): DashboardAppSlug | null {
+  const upper = value.toUpperCase();
+  if (DASHBOARD_APP_BY_SLUG[upper as DashboardAppSlug]) {
+    return upper as DashboardAppSlug;
+  }
+  return dashboardAppKeyToSlug(value.toLowerCase());
+}
+
+/**
+ * True si la whitelist explicite du groupement est limitée au preset free
+ * (aucune app hors FREE_SELF_SERVE, hors extras legacy). Aucune ligne / defaults plein → false.
+ * Accepte slugs (`WORKSPACE`) ou clés (`workspace`).
+ */
+export function isFreeSelfServeAppAccess(
+  enabledSlugs: ReadonlyArray<string>,
+): boolean {
+  if (enabledSlugs.length === 0) return false;
+  const free = new Set<string>([
+    ...FREE_SELF_SERVE_DASHBOARD_APP_SLUGS,
+    ...FREE_SELF_SERVE_LEGACY_EXTRA_SLUGS,
+  ]);
+  return enabledSlugs.every((slug) => {
+    const normalized = normalizeDashboardAppSlug(slug);
+    return normalized != null && free.has(normalized);
+  });
+}
+
+/**
+ * Résout les apps actives à partir des lignes `city_group_app_access`.
+ * - Aucune ligne → defaults « plein » (compat collectivités existantes).
+ * - Au moins une ligne → **whitelist stricte** des `enabled: true` (mode restreint possible).
+ */
+export function resolveEnabledDashboardAppSlugs(
+  rows: ReadonlyArray<{ appSlug: string; enabled: boolean }>,
+): DashboardAppSlug[] {
+  if (rows.length === 0) {
+    return [...DEFAULT_ENABLED_DASHBOARD_APP_SLUGS];
+  }
+  const enabled = rows
+    .filter((r) => r.enabled)
+    .map((r) => r.appSlug as DashboardAppSlug)
+    .filter((slug) => DASHBOARD_APPS.some((a) => a.slug === slug));
+  return [...new Set(enabled)];
+}
+
+export function dashboardAppSlugToKey(slug: DashboardAppSlug): string {
+  return DASHBOARD_APP_BY_SLUG[slug]?.key ?? slug.toLowerCase();
+}
+
+export function dashboardAppKeyToSlug(key: string): DashboardAppSlug | null {
+  return DASHBOARD_APP_BY_KEY[key]?.slug ?? null;
+}
+
+/** Domaine racine des landings Wast-O (ex. `wasto.localhost` en dev). */
+export const WASTO_LANDINGS_DOMAIN = 'wasto.localhost';
+
+/** Hôte de l’index des landings (catalogue de toutes les apps). */
+export const WASTO_LANDINGS_INDEX_HOST = `apps.${WASTO_LANDINGS_DOMAIN}`;
+
+/** Hôtes Traefik déjà réservés sous `*.wasto.localhost` (hors landings par module). */
+export const WASTO_RESERVED_SUBDOMAINS = new Set([
+  'api',
+  'admin',
+  'dashboard',
+  'docs',
+  'field-survey',
+  'apps',
+]);
+
+export function isDashboardAppLandingHost(host: string): boolean {
+  const normalized = host.split(':')[0]?.toLowerCase() ?? '';
+  if (normalized === WASTO_LANDINGS_INDEX_HOST) {
+    return true;
+  }
+  const match = normalized.match(/^([a-z]+)\.wasto\.localhost$/);
+  if (!match) {
+    return false;
+  }
+  const subdomain = match[1];
+  if (WASTO_RESERVED_SUBDOMAINS.has(subdomain)) {
+    return false;
+  }
+  return Boolean(DASHBOARD_APP_BY_KEY[subdomain]);
+}
+
+export function dashboardAppKeyFromLandingHost(host: string): string | null {
+  const normalized = host.split(':')[0]?.toLowerCase() ?? '';
+  if (normalized === WASTO_LANDINGS_INDEX_HOST) {
+    return null;
+  }
+  const match = normalized.match(/^([a-z]+)\.wasto\.localhost$/);
+  if (!match) {
+    return null;
+  }
+  const key = match[1];
+  if (WASTO_RESERVED_SUBDOMAINS.has(key) || !DASHBOARD_APP_BY_KEY[key]) {
+    return null;
+  }
+  return key;
+}
+
+type ResolveLandingUrlOptions = {
+  /** Domaine racine (défaut : `wasto.localhost`). */
+  domain?: string;
+  /** Protocole (défaut : `http` en dev, `https` si `NODE_ENV=production`). */
+  protocol?: string;
+};
+
+/** URL publique de la landing d’un module (ex. `http://acto.wasto.localhost`). */
+export function resolveDashboardAppLandingUrl(
+  key: string,
+  options?: ResolveLandingUrlOptions,
+): string | null {
+  if (!DASHBOARD_APP_BY_KEY[key]) {
+    return null;
+  }
+  const domain = options?.domain ?? WASTO_LANDINGS_DOMAIN;
+  const protocol = options?.protocol ?? 'http';
+  return `${protocol}://${key}.${domain}`;
+}
+
+/** URL de l’index des landings Wast-O (ex. `http://apps.wasto.localhost`). */
+export function resolveWastoLandingsIndexUrl(options?: ResolveLandingUrlOptions): string {
+  const domain = options?.domain ?? WASTO_LANDINGS_DOMAIN;
+  const protocol = options?.protocol ?? 'http';
+  return `${protocol}://apps.${domain}`;
+}