@wasto/sdk 1.0.3

package/dist/index.d.mts

@@ -0,0 +1,2562 @@
+/**
+ * Enums aligned with Prisma schema (no @prisma/client dependency).
+ * Use these in DTOs and types so the SDK can be used from browser/frontend.
+ */
+declare enum UserRole {
+    ADMIN = "ADMIN",
+    GESTIONNAIRE_COLLECTIVITE = "GESTIONNAIRE_COLLECTIVITE",
+    USER = "USER"
+}
+declare enum CityGroupType {
+    AGGLOMERATION = "AGGLOMERATION",
+    COMMUNAUTE = "COMMUNAUTE",
+    METROPOLE = "METROPOLE",
+    SYNDICAT = "SYNDICAT",
+    AUTRE = "AUTRE"
+}
+declare enum CityStatus {
+    NON_ACTIF = "NON_ACTIF",
+    INCOMPLET = "INCOMPLET",
+    ACTIF = "ACTIF",
+    MAINTENANCE = "MAINTENANCE"
+}
+declare enum RecipientGroupType {
+    CITY = "CITY",
+    CITY_GROUP = "CITY_GROUP",
+    ZONE = "ZONE"
+}
+declare enum NotificationStatus {
+    DRAFT = "DRAFT",
+    SCHEDULED = "SCHEDULED",
+    SENT = "SENT",
+    ARCHIVED = "ARCHIVED"
+}
+declare enum NotificationDeliveryStatus {
+    PENDING = "PENDING",
+    SENT = "SENT",
+    FAILED = "FAILED"
+}
+declare enum CmsSiteType {
+    SITE = "SITE",
+    APP = "APP"
+}
+declare enum CmsMenuLinkType {
+    PAGE = "PAGE",
+    EXTERNAL = "EXTERNAL",
+    COMPONENT = "COMPONENT"
+}
+declare enum ChatMessageRole {
+    USER = "USER",
+    ASSISTANT = "ASSISTANT",
+    AGENT = "AGENT"
+}
+declare enum ChatStatus {
+    OPEN = "OPEN",
+    WAITING_AGENT = "WAITING_AGENT",
+    RESOLVED = "RESOLVED",
+    CLOSED = "CLOSED"
+}
+declare enum PermissionAction {
+    READ = "READ",
+    WRITE = "WRITE"
+}
+declare enum PermissionResource {
+    USERS = "USERS",
+    CITIES = "CITIES",
+    CITY_GROUPS = "CITY_GROUPS",
+    BLOG_POSTS = "BLOG_POSTS",
+    CHALLENGES = "CHALLENGES",
+    SERIES = "SERIES",
+    BADGES = "BADGES",
+    NOTIFICATIONS = "NOTIFICATIONS",
+    RECIPIENT_GROUPS = "RECIPIENT_GROUPS",
+    WASTE_TYPES = "WASTE_TYPES",
+    WASTE_COLLECTION_PLACES = "WASTE_COLLECTION_PLACES",
+    RECYCLING_POINTS = "RECYCLING_POINTS",
+    QUIZ_QUESTIONS = "QUIZ_QUESTIONS",
+    CHAT_CONVERSATIONS = "CHAT_CONVERSATIONS",
+    ANALYTICS = "ANALYTICS",
+    ASSETS = "ASSETS",
+    IOT_DEVICES = "IOT_DEVICES",
+    SURVEYS = "SURVEYS",
+    TICKETS = "TICKETS",
+    TICKET_FORMS = "TICKET_FORMS",
+    PROVIDERS = "PROVIDERS",
+    CMS_SITES = "CMS_SITES",
+    CMS_PAGES = "CMS_PAGES",
+    CMS_MEDIA = "CMS_MEDIA",
+    CALENDO_EVENTS = "CALENDO_EVENTS",
+    MAPSO_EVENTS = "MAPSO_EVENTS",
+    FIELD_REPORTS = "FIELD_REPORTS"
+}
+declare enum TerritoryActionType {
+    AWARENESS = "AWARENESS",
+    CONTROLS = "CONTROLS",
+    EQUIPMENT = "EQUIPMENT",
+    WASTO_APP = "WASTO_APP",
+    TRAINING = "TRAINING",
+    OTHER = "OTHER"
+}
+declare enum TerritoryActionStatus {
+    PLANNED = "PLANNED",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    CANCELLED = "CANCELLED"
+}
+declare enum AssetType {
+    BENNE = "BENNE",
+    BORNE_VERRE = "BORNE_VERRE",
+    BORNE_TEMPORAIRE = "BORNE_TEMPORAIRE",
+    EPHEMERE = "EPHEMERE",
+    LOCATION = "LOCATION",
+    VEHICULE = "VEHICULE",
+    CAMION = "CAMION"
+}
+declare enum AssetStatus {
+    DISPONIBLE = "DISPONIBLE",
+    EN_LOCATION = "EN_LOCATION",
+    EN_MAINTENANCE = "EN_MAINTENANCE",
+    HORS_SERVICE = "HORS_SERVICE"
+}
+declare enum BookingStatus {
+    PENDING = "PENDING",
+    CONFIRMED = "CONFIRMED",
+    CANCELLED = "CANCELLED"
+}
+declare enum SurveyStatus {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    ARCHIVED = "ARCHIVED"
+}
+declare enum SurveyMode {
+    FIELD = "FIELD",
+    ONLINE = "ONLINE",
+    PHONE = "PHONE"
+}
+declare enum QuestionType {
+    TEXT = "TEXT",
+    NUMBER = "NUMBER",
+    CHOICE = "CHOICE",
+    MULTIPLE_CHOICE = "MULTIPLE_CHOICE",
+    RATING = "RATING",
+    DATE = "DATE",
+    LOCATION = "LOCATION",
+    PHOTO = "PHOTO",
+    YES_NO = "YES_NO"
+}
+declare enum ResponseStatus {
+    DRAFT = "DRAFT",
+    SUBMITTED = "SUBMITTED",
+    SYNCED = "SYNCED"
+}
+declare enum TicketFormStatus {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    ARCHIVED = "ARCHIVED"
+}
+declare enum TicketStatus {
+    OUVERT = "OUVERT",
+    EN_COURS = "EN_COURS",
+    RESOLU = "RESOLU",
+    FERME = "FERME"
+}
+declare enum FieldReportFormStatus {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    ARCHIVED = "ARCHIVED"
+}
+declare enum FieldReportStatus {
+    OUVERT = "OUVERT",
+    EN_COURS = "EN_COURS",
+    RESOLU = "RESOLU",
+    FERME = "FERME"
+}
+declare enum ProviderType {
+    LOCATION_ASSETS = "LOCATION_ASSETS",
+    ANIMATION_CHALLENGE = "ANIMATION_CHALLENGE",
+    MAINTENANCE = "MAINTENANCE",
+    AUTRE = "AUTRE"
+}
+declare enum InterventionType {
+    MAINTENANCE = "MAINTENANCE",
+    INDISPO = "INDISPO",
+    CONTROLE = "CONTROLE",
+    OTHER = "OTHER"
+}
+declare enum InterventionStatus {
+    PLANNED = "PLANNED",
+    IN_PROGRESS = "IN_PROGRESS",
+    DONE = "DONE",
+    CANCELLED = "CANCELLED"
+}
+declare enum AssetEventType {
+    LOCATION_CHANGE = "LOCATION_CHANGE",
+    STATUS_CHANGE = "STATUS_CHANGE",
+    MAINTENANCE = "MAINTENANCE",
+    INSPECTION = "INSPECTION",
+    OTHER = "OTHER"
+}
+declare enum CalendoEventType {
+    CONCERT = "CONCERT",
+    ANIMATION = "ANIMATION",
+    EXPOSITION = "EXPOSITION",
+    OTHER = "OTHER"
+}
+declare enum CalendoEventStatus {
+    DRAFT = "DRAFT",
+    PUBLISHED = "PUBLISHED",
+    CANCELLED = "CANCELLED",
+    SOLD_OUT = "SOLD_OUT"
+}
+declare enum CalendoTicketSaleStatus {
+    CONFIRMED = "CONFIRMED",
+    CANCELLED = "CANCELLED",
+    REFUNDED = "REFUNDED"
+}
+declare enum MapEventType {
+    FAIR = "FAIR",
+    MARKET = "MARKET",
+    FESTIVAL = "FESTIVAL",
+    PERMANENT = "PERMANENT",
+    OTHER = "OTHER"
+}
+declare enum MapEventStatus {
+    DRAFT = "DRAFT",
+    PUBLISHED = "PUBLISHED",
+    ARCHIVED = "ARCHIVED"
+}
+declare enum MapPoiCategory {
+    ATTRACTION_STAND = "ATTRACTION_STAND",
+    TOILET = "TOILET",
+    SECURITY = "SECURITY",
+    FOOD = "FOOD",
+    WATER_FOUNTAIN = "WATER_FOUNTAIN",
+    WASTO_RECYCLING = "WASTO_RECYCLING",
+    WASTO_BIOWASTE = "WASTO_BIOWASTE",
+    WASTO_RETURN = "WASTO_RETURN",
+    TRAVAUX = "TRAVAUX"
+}
+declare enum MapZoneType {
+    PARKING_PROVISOIRE = "PARKING_PROVISOIRE",
+    ZONE_INTERDITE = "ZONE_INTERDITE",
+    AUTRE = "AUTRE"
+}
+declare enum MapPoiStatus {
+    ACTIVE = "ACTIVE",
+    MAINTENANCE = "MAINTENANCE",
+    CLOSED = "CLOSED"
+}
+declare enum OperationalZoneType {
+    TRAVAUX = "TRAVAUX",
+    PARKING_PROVISOIRE = "PARKING_PROVISOIRE",
+    ZONE_INTERDITE = "ZONE_INTERDITE",
+    AUTRE = "AUTRE"
+}
+declare enum OperationalZoneStatus {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    ARCHIVED = "ARCHIVED"
+}
+
+/**
+ * Catalogue des sections Wast-O.
+ * @deprecated Préférer WASTO_SECTIONS pour les libellés UI ; DASHBOARD_APPS reste pour l'API permissions.
+ */
+declare enum DashboardAppSlug {
+    WORKSPACE = "WORKSPACE",
+    WASTO = "WASTO",
+    APPSO = "APPSO",
+    CALENDO = "CALENDO",
+    ACTO = "ACTO",
+    ASSISTO = "ASSISTO",
+    PLAYO = "PLAYO",
+    MAPSO = "MAPSO",
+    IAGO = "IAGO",
+    PEDAGO = "PEDAGO",
+    MARKETO = "MARKETO"
+}
+type DashboardAppDefinition = {
+    slug: DashboardAppSlug;
+    /** Clé utilisée dans les URLs (ex. `wasto`, `appso`) */
+    key: string;
+    label: string;
+    dashboardPath: string;
+    isDevOnly?: boolean;
+};
+type WastoSectionDefinition = {
+    slug: DashboardAppSlug;
+    key: string;
+    label: string;
+    sectionLabel: string;
+    dashboardPath: string;
+    isDevOnly?: boolean;
+};
+declare const WASTO_SECTIONS: WastoSectionDefinition[];
+declare const DASHBOARD_APPS: DashboardAppDefinition[];
+declare const WASTO_SECTION_BY_KEY: Record<string, WastoSectionDefinition>;
+declare const DASHBOARD_APP_BY_SLUG: Record<DashboardAppSlug, DashboardAppDefinition>;
+declare const DASHBOARD_APP_BY_KEY: Record<string, DashboardAppDefinition>;
+/** Apps activées par défaut si le groupement n'a aucune configuration explicite. */
+declare const DEFAULT_ENABLED_DASHBOARD_APP_SLUGS: DashboardAppSlug[];
+/**
+ * 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.
+ */
+declare const FREE_SELF_SERVE_DASHBOARD_APP_SLUGS: DashboardAppSlug[];
+/** Normalise slug API (`WORKSPACE`) ou clé URL (`workspace`) vers DashboardAppSlug. */
+declare function normalizeDashboardAppSlug(value: string): DashboardAppSlug | null;
+/**
+ * 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`).
+ */
+declare function isFreeSelfServeAppAccess(enabledSlugs: ReadonlyArray<string>): boolean;
+/**
+ * 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).
+ */
+declare function resolveEnabledDashboardAppSlugs(rows: ReadonlyArray<{
+    appSlug: string;
+    enabled: boolean;
+}>): DashboardAppSlug[];
+declare function dashboardAppSlugToKey(slug: DashboardAppSlug): string;
+declare function dashboardAppKeyToSlug(key: string): DashboardAppSlug | null;
+/** Domaine racine des landings Wast-O (ex. `wasto.localhost` en dev). */
+declare const WASTO_LANDINGS_DOMAIN = "wasto.localhost";
+/** Hôte de l’index des landings (catalogue de toutes les apps). */
+declare const WASTO_LANDINGS_INDEX_HOST = "apps.wasto.localhost";
+/** Hôtes Traefik déjà réservés sous `*.wasto.localhost` (hors landings par module). */
+declare const WASTO_RESERVED_SUBDOMAINS: Set<string>;
+declare function isDashboardAppLandingHost(host: string): boolean;
+declare function dashboardAppKeyFromLandingHost(host: string): string | null;
+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`). */
+declare function resolveDashboardAppLandingUrl(key: string, options?: ResolveLandingUrlOptions): string | null;
+/** URL de l’index des landings Wast-O (ex. `http://apps.wasto.localhost`). */
+declare function resolveWastoLandingsIndexUrl(options?: ResolveLandingUrlOptions): string;
+
+/** Ressources soumises à un quota numérique en offre gratuite. */
+type FreeTierResource = 'cmsApps' | 'cmsPages' | 'blogPosts' | 'cmsMedia' | 'wasteTypes' | 'collectionPlaces' | 'printCalendarTemplates';
+/** Fonctionnalités désactivées en offre gratuite (feature gate). */
+type FreeTierFeature = 'challenges' | 'roi' | 'notifications' | 'recyclingPoints' | 'assets' | 'nativeStorePublication' | 'inviteMembers';
+type FreeTierErrorCode = 'FREE_TIER_LIMIT' | 'FREE_TIER_FEATURE';
+type FreeTierUsageItem = {
+    resource: FreeTierResource;
+    used: number;
+    /** `null` = illimité (compte payant). */
+    limit: number | null;
+    canCreate: boolean;
+    /** Octets utilisés (cmsMedia uniquement). */
+    usedBytes?: number;
+    /** Limite en octets (cmsMedia uniquement). */
+    limitBytes?: number | null;
+};
+type FreeTierFeatureItem = {
+    feature: FreeTierFeature;
+    enabled: boolean;
+};
+type FreeTierUsageSnapshot = {
+    cityGroupId: string;
+    freeTier: boolean;
+    resources: FreeTierUsageItem[];
+    features: FreeTierFeatureItem[];
+};
+type FreeTierErrorPayload = {
+    code: FreeTierErrorCode;
+    resource?: FreeTierResource;
+    feature?: FreeTierFeature;
+    used?: number;
+    limit?: number;
+    message: string;
+};
+
+/** Quotas numériques offre gratuite — valeurs ajustables sans changer la logique. */
+declare const FREE_TIER_LIMITS: {
+    readonly cmsApps: 1;
+    readonly cmsPages: 5;
+    readonly blogPosts: 10;
+    readonly cmsMedia: 50;
+    readonly cmsMediaBytesMb: 50;
+    readonly wasteTypes: 15;
+    readonly collectionPlaces: 10;
+    readonly printCalendarTemplates: 3;
+};
+/** Feature gates offre gratuite — `false` = bloqué. */
+declare const FREE_TIER_FEATURES: Record<FreeTierFeature, boolean>;
+declare const FREE_TIER_RESOURCES: readonly FreeTierResource[];
+declare const FREE_TIER_FEATURE_KEYS: readonly FreeTierFeature[];
+declare function getFreeTierLimit(resource: FreeTierResource): number;
+declare function getFreeTierMediaBytesLimit(): number;
+declare function isFreeTierFeatureEnabled(feature: FreeTierFeature): boolean;
+
+declare const DEFAULT_PAGE = 1;
+declare const DEFAULT_PAGE_SIZE = 20;
+declare const MAX_PAGE_SIZE = 100;
+interface PaginationQuery {
+    page?: number;
+    pageSize?: number;
+}
+interface PaginationMeta {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    meta: PaginationMeta;
+}
+declare function buildPaginationMeta(page: number, pageSize: number, total: number): PaginationMeta;
+
+interface LoginRequest {
+    email: string;
+    password: string;
+}
+interface RegisterRequest {
+    email: string;
+    password: string;
+    firstName?: string;
+    lastName?: string;
+}
+interface ForgotPasswordRequest {
+    email: string;
+}
+interface ResetPasswordRequest {
+    token: string;
+    password: string;
+}
+interface AcceptInviteRequest {
+    token: string;
+    password: string;
+    firstName?: string;
+    lastName?: string;
+}
+interface LoginResponse {
+    access_token: string;
+    user?: unknown;
+}
+interface LoginTwoFactorChallenge {
+    requiresTwoFactor: true;
+    pendingToken: string;
+}
+
+interface CreateUserRequest {
+    email: string;
+    password: string;
+    firstName?: string;
+    lastName?: string;
+    role?: UserRole;
+    cityId?: string;
+    cityGroupId?: string;
+}
+interface InviteUserRequest {
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    role?: UserRole;
+    cityId?: string;
+    cityGroupId?: string;
+}
+interface UpdateUserRequest {
+    email?: string;
+    password?: string;
+    firstName?: string;
+    lastName?: string;
+    role?: UserRole;
+    cityId?: string;
+    cityGroupId?: string;
+}
+
+interface CreateCityRequest {
+    name: string;
+    country: string;
+    population?: number;
+    status?: CityStatus;
+    outOfTheBins?: string;
+    presentationOfBins?: string;
+    returnOfBins?: string;
+    respectOfCalendar?: string;
+    holidays?: string;
+    logoMediaId?: string | null;
+}
+interface UpdateCityRequest {
+    name?: string;
+    country?: string;
+    population?: number;
+    status?: CityStatus;
+    outOfTheBins?: string;
+    presentationOfBins?: string;
+    returnOfBins?: string;
+    respectOfCalendar?: string;
+    holidays?: string;
+    logoMediaId?: string | null;
+}
+
+interface CreateCityGroupRequest {
+    name: string;
+    type: CityGroupType;
+    code?: string;
+    siren?: string;
+    cityIds?: string[];
+}
+interface UpdateCityGroupRequest {
+    name?: string;
+    type?: CityGroupType;
+    code?: string;
+    siren?: string;
+    cityIds?: string[];
+}
+interface CityGroupDashboardAppAccessItem {
+    slug: DashboardAppSlug;
+    key: string;
+    label: string;
+    dashboardPath: string;
+    isDevOnly?: boolean;
+    enabled: boolean;
+}
+interface CityGroupDashboardAppsResponse {
+    cityGroupId: string;
+    apps: CityGroupDashboardAppAccessItem[];
+    /** Slugs activés (clés Prisma) — vide si configuration explicite absente côté API */
+    enabledSlugs: DashboardAppSlug[];
+}
+interface SetCityGroupDashboardAppsRequest {
+    enabledSlugs: DashboardAppSlug[];
+}
+interface AccessibleCityGroup {
+    id: string;
+    name: string;
+    type: CityGroupType;
+    code?: string | null;
+    enabledDashboardAppSlugs?: DashboardAppSlug[];
+}
+
+interface CreateWasteTypeDetailRequest {
+    material: string;
+    description?: string;
+    instructions?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+}
+interface CreateWasteTypeRequest {
+    name: string;
+    description?: string;
+    instructions?: string;
+    color?: string;
+    colorLight?: string;
+    icon?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    details?: CreateWasteTypeDetailRequest[];
+    rules?: string[];
+    cityIds?: string[];
+}
+
+interface CreateAttachedLocationRequest {
+    name: string;
+    reference?: string;
+    latitude?: number;
+    longitude?: number;
+    /** Optional link to a city street (secteur / calendrier). */
+    streetId?: string;
+}
+interface CreateWasteCollectionDayRequest {
+    wasteTypeId: string;
+    name: string;
+    description?: string;
+    biweekly?: boolean;
+    startDate?: string;
+}
+interface CreateWasteCollectionExceptionRequest {
+    wasteTypeId: string;
+    dateFrom: string;
+    dateTo: string;
+    name: string;
+    description?: string;
+}
+interface CreateWasteCollectionPlaceRequest {
+    cityId: string;
+    name: string;
+    reference?: string;
+    attachedLocations?: CreateAttachedLocationRequest[];
+    wasteCollectionDays?: CreateWasteCollectionDayRequest[];
+    wasteCollectionExceptions?: CreateWasteCollectionExceptionRequest[];
+}
+
+interface LocateWasteCollectionPlacesQuery {
+    lat: number;
+    lon: number;
+}
+
+declare const WEEKDAYS: readonly ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"];
+type Weekday = (typeof WEEKDAYS)[number];
+type TimeSlot = {
+    open: string;
+    close: string;
+};
+type OpeningHoursRule = {
+    days: Weekday[];
+    slots: TimeSlot[];
+};
+type OpeningHoursExceptionClosed = {
+    date: string;
+    closed: true;
+    label?: string;
+};
+type OpeningHoursExceptionOpen = {
+    date: string;
+    closed: false;
+    slots: TimeSlot[];
+    label?: string;
+};
+type OpeningHoursException = OpeningHoursExceptionClosed | OpeningHoursExceptionOpen;
+/** Horaires structurés persistés en UTC+0 */
+type OpeningHours = {
+    version: 1;
+    storage: 'utc';
+    rules: OpeningHoursRule[];
+    exceptions?: OpeningHoursException[];
+};
+type HoursInputMode = 'structured' | 'text';
+type WeeklyHoursRow = {
+    day: Weekday;
+    label: string;
+    closed: boolean;
+    slots: TimeSlot[];
+};
+type OpeningHoursValidationResult = {
+    ok: true;
+    value: OpeningHours;
+} | {
+    ok: false;
+    errors: string[];
+};
+
+interface CreateRecyclingPointRequest {
+    cityId: string;
+    name: string;
+    type: string;
+    acceptedWasteTypes: string[];
+    latitude?: number;
+    longitude?: number;
+    /** @deprecated Prefer longitude (alias X = longitude). */
+    coordinateX?: number;
+    /** @deprecated Prefer latitude (alias Y = latitude). */
+    coordinateY?: number;
+    address?: string;
+    hours?: string;
+    phone?: string;
+    details?: RecyclingPointDetails;
+}
+
+type RecyclingPointDetails = {
+    address?: string;
+    hours?: string;
+    phone?: string;
+    hoursMode?: HoursInputMode;
+    openingHours?: OpeningHours;
+    [key: string]: unknown;
+};
+interface RecyclingPoint {
+    id: string;
+    cityId?: string | null;
+    name: string;
+    type: string;
+    acceptedWasteTypes: string[];
+    latitude?: number | null;
+    longitude?: number | null;
+    /** @deprecated Prefer longitude. */
+    coordinateX?: number | null;
+    /** @deprecated Prefer latitude. */
+    coordinateY?: number | null;
+    address?: string | null;
+    hours?: string | null;
+    phone?: string | null;
+    details?: RecyclingPointDetails | null;
+}
+
+type QuizQuestionKind = 'waste_bin' | 'ab_image' | 'mcq';
+type QuizAbImageChoice = {
+    id: string;
+    imageUrl: string;
+    label?: string;
+};
+type QuizAbImageOptions = {
+    choices: [QuizAbImageChoice, QuizAbImageChoice];
+    correctChoiceId: string;
+};
+type QuizMcqChoice = {
+    id: string;
+    text: string;
+};
+type QuizMcqOptions = {
+    choices: QuizMcqChoice[];
+    correctChoiceId: string;
+};
+type QuizQuestionOptions = QuizAbImageOptions | QuizMcqOptions;
+/** Détail référentiel lié à une explication (WasteTypeDetail). */
+type QuizExplanationDetail = {
+    id: string;
+    material: string;
+    description?: string | null;
+    instructions?: string | null;
+    imageUrl?: string | null;
+    wasteType?: {
+        id: string;
+        name: string;
+    } | null;
+};
+interface CreateQuizQuestionRequest {
+    /** @deprecated Ignored — city is taken from `serie.challenge.cityId`. */
+    cityId?: string;
+    /** Required for `waste_bin`; optional for `ab_image`. */
+    wasteTypeId?: string;
+    materialId?: string;
+    material: string;
+    question: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    /** Required for `waste_bin`; optional for `ab_image`. */
+    correctWasteTypeId?: string;
+    /** Required: question belongs to a series (city = that series' challenge city). */
+    serieId: string;
+    order?: number;
+    /** Defaults to `waste_bin` (legacy). */
+    kind?: QuizQuestionKind;
+    /** Typed payload for non-waste_bin kinds. */
+    options?: QuizQuestionOptions;
+    /** Free-text explanation shown after answering (takes priority over detail). */
+    explanationText?: string | null;
+    /** Link to a référentiel WasteTypeDetail for explanation. */
+    explanationDetailId?: string | null;
+}
+
+interface CreateCmsSiteRequest {
+    name: string;
+    slug: string;
+    type?: CmsSiteType;
+    domain?: string;
+    cityGroupId?: string;
+    settings?: Record<string, unknown>;
+}
+interface UpdateCmsSiteRequest {
+    name?: string;
+    slug?: string;
+    type?: CmsSiteType;
+    domain?: string;
+    cityGroupId?: string;
+    settings?: Record<string, unknown>;
+}
+interface CreateCmsPageRequest {
+    siteId: string;
+    title: string;
+    slug: string;
+    path: string;
+    content: Record<string, unknown>;
+    published?: boolean;
+    publishedAt?: string;
+    seoMetadata?: Record<string, unknown>;
+    layoutId?: string;
+}
+interface UpdateCmsPageRequest {
+    siteId?: string;
+    title?: string;
+    slug?: string;
+    path?: string;
+    content?: Record<string, unknown>;
+    published?: boolean;
+    publishedAt?: string;
+    seoMetadata?: Record<string, unknown>;
+    layoutId?: string;
+}
+interface CreateCmsLayoutRequest {
+    siteId: string;
+    name: string;
+    description?: string;
+    type: CmsSiteType;
+    structure: Record<string, unknown>;
+    isDefault?: boolean;
+}
+interface UpdateCmsLayoutRequest {
+    siteId?: string;
+    name?: string;
+    description?: string;
+    type?: CmsSiteType;
+    structure?: Record<string, unknown>;
+    isDefault?: boolean;
+}
+interface CreateCmsMenuItemRequest {
+    label: string;
+    icon?: string;
+    order: number;
+    linkType: CmsMenuLinkType;
+    pageId?: string;
+    externalUrl?: string;
+    componentId?: string;
+    parentId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CreateCmsMenuRequest {
+    siteId: string;
+    name: string;
+    location?: string;
+    items?: CreateCmsMenuItemRequest[];
+}
+interface UpdateCmsMenuRequest {
+    siteId?: string;
+    name?: string;
+    location?: string;
+    items?: CreateCmsMenuItemRequest[];
+}
+
+interface CreateAssetRequest {
+    uniqueIdentifier: string;
+    type: AssetType;
+    status?: AssetStatus;
+    name: string;
+    description?: string;
+    capacity?: number;
+    dimensions?: {
+        length?: number;
+        width?: number;
+        height?: number;
+    };
+    cityId?: string;
+    cityGroupId?: string;
+    locationStartDate?: string;
+    locationEndDate?: string;
+    wasteTypeIds?: string[];
+    fuelType?: string;
+    consumptionRate?: number;
+    consumptionUnit?: string;
+    color?: string;
+    ownedById?: string;
+    isBookable?: boolean;
+}
+interface UpdateAssetRequest {
+    uniqueIdentifier?: string;
+    type?: AssetType;
+    status?: AssetStatus;
+    name?: string;
+    description?: string;
+    capacity?: number;
+    dimensions?: {
+        length?: number;
+        width?: number;
+        height?: number;
+    };
+    cityId?: string;
+    cityGroupId?: string;
+    locationStartDate?: string;
+    locationEndDate?: string;
+    wasteTypeIds?: string[];
+    fuelType?: string;
+    consumptionRate?: number;
+    consumptionUnit?: string;
+    color?: string;
+    ownedById?: string;
+    isBookable?: boolean;
+}
+interface CreateAssetEventRequest {
+    eventType: AssetEventType;
+    title: string;
+    description?: string;
+    latitude?: number;
+    longitude?: number;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateAssetStatusRequest {
+    status: AssetStatus;
+    latitude?: number;
+    longitude?: number;
+    notes?: string;
+}
+interface CreateAssetConsumptionRecordRequest {
+    periodStart: string;
+    periodEnd: string;
+    value: number;
+    unit: string;
+    source: 'IOT' | 'MANUAL';
+    metadata?: Record<string, unknown>;
+}
+
+interface CreateAssetBookingRequest {
+    assetId: string;
+    startDate: string;
+    endDate?: string;
+    notes?: string;
+}
+interface UpdateAssetBookingRequest {
+    startDate?: string;
+    endDate?: string;
+    status?: BookingStatus;
+    notes?: string;
+}
+interface CancelAssetBookingRequest {
+    reason?: string;
+}
+
+interface CreateAssetInterventionRequest {
+    assetId?: string;
+    type: InterventionType;
+    plannedStart: string;
+    plannedEnd: string;
+    title?: string;
+    description?: string;
+    assigneeId?: string;
+    notes?: string;
+}
+interface UpdateAssetInterventionRequest {
+    assetId?: string;
+    type?: InterventionType;
+    status?: InterventionStatus;
+    plannedStart?: string;
+    plannedEnd?: string;
+    title?: string;
+    description?: string;
+    assigneeId?: string;
+    notes?: string;
+}
+
+interface CreateChallengeRequest {
+    name: string;
+    description?: string;
+    cityId?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    enabled?: boolean;
+    startDate?: string;
+    endDate?: string;
+    order?: number;
+    requiredChallengeId?: string;
+}
+interface CreateSerieRequest {
+    challengeId: string;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    order?: number;
+}
+interface CreateBadgeRequest {
+    challengeId: string;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    icon?: string;
+}
+
+interface CreateBlogPostRequest {
+    cityGroupId: string;
+    title: string;
+    content: string;
+    published?: boolean;
+    publishedAt?: string;
+    /** ID d’un média CMS (image de couverture) */
+    coverMediaId?: string | null;
+}
+interface UpdateBlogPostRequest {
+    cityGroupId?: string;
+    title?: string;
+    content?: string;
+    published?: boolean;
+    publishedAt?: string;
+    /** ID d’un média CMS (image de couverture). `null` pour retirer. */
+    coverMediaId?: string | null;
+}
+
+interface CreateNotificationRequest {
+    title: string;
+    body: string;
+    data?: Record<string, unknown>;
+    recipientGroupId: string;
+    scheduledAt?: string;
+    /** Envoyer une notification push (défaut: true) */
+    sendPush?: boolean;
+    /** Afficher en modale dans l'app (défaut: false) */
+    showAsModal?: boolean;
+    /** Média CMS affiché dans la modale */
+    imageMediaId?: string | null;
+}
+interface UpdateNotificationRequest {
+    title?: string;
+    body?: string;
+    data?: Record<string, unknown>;
+    recipientGroupId?: string;
+    scheduledAt?: string;
+    sendPush?: boolean;
+    showAsModal?: boolean;
+    imageMediaId?: string | null;
+}
+interface CreateRecipientGroupRequest {
+    name: string;
+    description?: string;
+    type: RecipientGroupType;
+    /** Requis pour CITY_GROUP (tout le groupement) */
+    cityGroupId?: string;
+    /** Requis non vide pour CITY */
+    cityIds?: string[];
+    /** Requis non vide pour ZONE (lieux de collecte) */
+    wasteCollectionPlaceIds?: string[];
+    /** @deprecated Prefer cityIds */
+    cityId?: string;
+    /** @deprecated Prefer wasteCollectionPlaceIds */
+    wasteCollectionPlaceId?: string;
+    /** @deprecated Legacy operational zone targeting */
+    operationalZoneId?: string;
+}
+interface UpdateRecipientGroupRequest {
+    name?: string;
+    description?: string;
+    type?: RecipientGroupType;
+    cityGroupId?: string;
+    cityIds?: string[];
+    wasteCollectionPlaceIds?: string[];
+    /** @deprecated Prefer cityIds */
+    cityId?: string;
+    /** @deprecated Prefer wasteCollectionPlaceIds */
+    wasteCollectionPlaceId?: string;
+    /** @deprecated Legacy operational zone targeting */
+    operationalZoneId?: string;
+}
+/** Annonce modale active pour l'app mobile */
+interface PublicAnnouncement {
+    id: string;
+    title: string;
+    body: string;
+    imageUrl?: string | null;
+    sentAt?: string | null;
+}
+
+interface CreateProviderRequest {
+    name: string;
+    description?: string;
+    type?: ProviderType;
+    email?: string;
+    phone?: string;
+    address?: string;
+    siret?: string;
+    siren?: string;
+    website?: string;
+    cityGroupIds?: string[];
+    cityIds?: string[];
+}
+interface UpdateProviderRequest {
+    name?: string;
+    description?: string;
+    type?: ProviderType;
+    email?: string;
+    phone?: string;
+    address?: string;
+    siret?: string;
+    siren?: string;
+    website?: string;
+    cityGroupIds?: string[];
+    cityIds?: string[];
+}
+
+interface CreateSurveySubCohortRequest {
+    name: string;
+    description?: string;
+    order?: number;
+    responsibleUserIds?: string[];
+    attachedLocationIds?: string[];
+}
+interface CreateSurveyCohortRequest {
+    name: string;
+    description?: string;
+    order?: number;
+    subCohorts?: CreateSurveySubCohortRequest[];
+}
+interface UpdateSurveySubCohortRequest {
+    name?: string;
+    description?: string;
+    order?: number;
+    responsibleUserIds?: string[];
+    attachedLocationIds?: string[];
+}
+interface UpdateSurveyCohortRequest {
+    name?: string;
+    description?: string;
+    order?: number;
+    subCohorts?: UpdateSurveySubCohortRequest[];
+}
+interface CreateSurveyQuestionRequest {
+    type: QuestionType;
+    question: string;
+    description?: string;
+    required?: boolean;
+    order?: number;
+    options?: unknown;
+    minValue?: number;
+    maxValue?: number;
+}
+interface UpdateSurveyQuestionRequest {
+    type?: QuestionType;
+    question?: string;
+    description?: string;
+    required?: boolean;
+    order?: number;
+    options?: unknown;
+    minValue?: number;
+    maxValue?: number;
+}
+interface CreateSurveyAnswerRequest {
+    questionId: string;
+    value: unknown;
+    photoUrl?: string;
+}
+interface CreateSurveyResponseRequest {
+    answers: CreateSurveyAnswerRequest[];
+    latitude?: number;
+    longitude?: number;
+    metadata?: Record<string, unknown>;
+    subCohortId?: string;
+    attachedLocationId?: string;
+    /**
+     * Client-generated UUID for offline / multi-tab idempotent submit.
+     */
+    clientSubmissionId?: string;
+}
+interface UpdateSurveyResponseRequest {
+    answers?: CreateSurveyAnswerRequest[];
+    latitude?: number;
+    longitude?: number;
+    metadata?: Record<string, unknown>;
+}
+interface CreateSurveyRequest {
+    title: string;
+    description?: string;
+    status?: SurveyStatus;
+    mode?: SurveyMode;
+    cityId?: string;
+    cityGroupId?: string;
+    campaignTag?: string;
+    questions?: CreateSurveyQuestionRequest[];
+    cohorts?: CreateSurveyCohortRequest[];
+}
+interface UpdateSurveyRequest {
+    title?: string;
+    description?: string;
+    status?: SurveyStatus;
+    mode?: SurveyMode;
+    cityId?: string;
+    cityGroupId?: string;
+    campaignTag?: string;
+    questions?: CreateSurveyQuestionRequest[];
+    cohorts?: UpdateSurveyCohortRequest[];
+}
+
+interface TicketValueRequest {
+    fieldId: string;
+    value: unknown;
+    photoUrl?: string;
+}
+interface CreateTicketRequest {
+    ticketFormId: string;
+    values: TicketValueRequest[];
+    deviceId?: string;
+    conversationId?: string;
+}
+interface UpdateTicketRequest {
+    status?: TicketStatus;
+    assignedToId?: string;
+    values?: TicketValueRequest[];
+}
+interface CreateTicketFieldRequest {
+    type: QuestionType;
+    label: string;
+    description?: string;
+    required?: boolean;
+    order?: number;
+    options?: unknown;
+    minValue?: number;
+    maxValue?: number;
+}
+interface CreateTicketFormRequest {
+    title: string;
+    description?: string;
+    status?: TicketFormStatus;
+    isPublic?: boolean;
+    cityId?: string;
+    cityGroupId?: string;
+    fields?: CreateTicketFieldRequest[];
+}
+interface UpdateTicketFormRequest {
+    title?: string;
+    description?: string;
+    status?: TicketFormStatus;
+    isPublic?: boolean;
+    cityId?: string;
+    cityGroupId?: string;
+    fields?: CreateTicketFieldRequest[];
+}
+interface AssignTicketRequest {
+    assignedToId: string;
+}
+interface UpdateTicketStatusRequest {
+    status: TicketStatus;
+}
+interface CreateTicketFromChatRequest {
+    conversationId: string;
+    ticketFormId: string;
+    values?: TicketValueRequest[];
+}
+
+interface FieldReportValueRequest {
+    fieldId: string;
+    value: unknown;
+    photoUrl?: string;
+}
+interface CreateFieldReportRequest {
+    formId: string;
+    values: FieldReportValueRequest[];
+    latitude?: number;
+    longitude?: number;
+    cityId?: string;
+    cityGroupId?: string;
+}
+interface UpdateFieldReportRequest {
+    status?: FieldReportStatus;
+    assignedToId?: string | null;
+    values?: FieldReportValueRequest[];
+    latitude?: number;
+    longitude?: number;
+}
+interface UpdateFieldReportStatusRequest {
+    status: FieldReportStatus;
+}
+interface CreateFieldReportFieldRequest {
+    type: QuestionType;
+    label: string;
+    description?: string;
+    required?: boolean;
+    order?: number;
+    options?: unknown;
+    minValue?: number;
+    maxValue?: number;
+}
+interface UpdateFieldReportFieldRequest extends CreateFieldReportFieldRequest {
+    id?: string;
+}
+interface CreateFieldReportFormRequest {
+    title: string;
+    description?: string;
+    status?: FieldReportFormStatus;
+    cityId?: string;
+    cityGroupId?: string;
+    fields?: CreateFieldReportFieldRequest[];
+}
+interface UpdateFieldReportFormRequest {
+    title?: string;
+    description?: string;
+    status?: FieldReportFormStatus;
+    cityId?: string;
+    cityGroupId?: string;
+    fields?: UpdateFieldReportFieldRequest[];
+}
+
+interface CreateCalendoEventRequest {
+    title: string;
+    description?: string;
+    type?: CalendoEventType;
+    status?: CalendoEventStatus;
+    venue: string;
+    startDate: string;
+    endDate?: string;
+    cityId?: string;
+    cityGroupId?: string;
+    ticketingEnabled?: boolean;
+    capacity?: number;
+    priceCents?: number;
+}
+interface UpdateCalendoEventRequest {
+    title?: string;
+    description?: string;
+    type?: CalendoEventType;
+    status?: CalendoEventStatus;
+    venue?: string;
+    startDate?: string;
+    endDate?: string | null;
+    cityId?: string | null;
+    cityGroupId?: string | null;
+    ticketingEnabled?: boolean;
+    capacity?: number | null;
+    priceCents?: number | null;
+}
+interface CreateCalendoTicketSaleRequest {
+    quantity?: number;
+    purchaserName?: string;
+    purchaserEmail?: string;
+    notes?: string;
+}
+interface UpdateCalendoTicketSaleRequest {
+    status?: CalendoTicketSaleStatus;
+    notes?: string;
+}
+interface CalendoTicketingOverview {
+    eventsOnSale: number;
+    totalSold: number;
+    totalRevenueCents: number;
+    events: Array<{
+        id: string;
+        title: string;
+        venue: string;
+        startDate: string;
+        status: CalendoEventStatus;
+        capacity: number | null;
+        soldCount: number;
+        priceCents: number | null;
+        revenueCents: number;
+    }>;
+}
+
+interface CreateMapEventRequest {
+    title: string;
+    description?: string;
+    type?: MapEventType;
+    status?: MapEventStatus;
+    startDate?: string;
+    endDate?: string;
+    centerLatitude?: number;
+    centerLongitude?: number;
+    defaultZoom?: number;
+    perimeterGeoJson?: Record<string, unknown> | null;
+    cityId?: string;
+    cityGroupId?: string;
+}
+interface UpdateMapEventRequest {
+    title?: string;
+    description?: string;
+    type?: MapEventType;
+    status?: MapEventStatus;
+    startDate?: string | null;
+    endDate?: string | null;
+    centerLatitude?: number | null;
+    centerLongitude?: number | null;
+    defaultZoom?: number | null;
+    perimeterGeoJson?: Record<string, unknown> | null;
+    cityId?: string | null;
+    cityGroupId?: string | null;
+}
+interface CreateMapPoiRequest {
+    name: string;
+    description?: string;
+    category: MapPoiCategory;
+    status?: MapPoiStatus;
+    latitude: number;
+    longitude: number;
+    openingHours?: string;
+    tags?: string[];
+    sortOrder?: number;
+    dateFrom?: string;
+    dateTo?: string;
+    streetIds?: string[];
+}
+interface UpdateMapPoiRequest {
+    name?: string;
+    description?: string;
+    category?: MapPoiCategory;
+    status?: MapPoiStatus;
+    latitude?: number;
+    longitude?: number;
+    openingHours?: string | null;
+    tags?: string[];
+    sortOrder?: number;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    streetIds?: string[];
+}
+interface CreateMapZoneRequest {
+    name: string;
+    type: MapZoneType;
+    geoJson: Record<string, unknown>;
+    color?: string;
+    description?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    streetIds?: string[];
+}
+interface UpdateMapZoneRequest {
+    name?: string;
+    type?: MapZoneType;
+    geoJson?: Record<string, unknown>;
+    color?: string;
+    description?: string;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    streetIds?: string[];
+}
+interface MapZoneSummary {
+    id: string;
+    mapEventId: string;
+    name: string;
+    type: MapZoneType;
+    geoJson: Record<string, unknown>;
+    color?: string | null;
+    description?: string | null;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    streets?: Array<{
+        street: {
+            id: string;
+            name: string;
+        };
+    }>;
+    createdAt: string;
+    updatedAt: string;
+}
+interface MapPoiSummary {
+    id: string;
+    mapEventId: string;
+    name: string;
+    description?: string | null;
+    category: MapPoiCategory;
+    status: MapPoiStatus;
+    latitude: number;
+    longitude: number;
+    openingHours?: string | null;
+    tags: string[];
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    streets?: Array<{
+        street: {
+            id: string;
+            name: string;
+        };
+    }>;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface MapEventSummary {
+    id: string;
+    title: string;
+    description?: string | null;
+    type: MapEventType;
+    status: MapEventStatus;
+    startDate?: string | null;
+    endDate?: string | null;
+    centerLatitude?: number | null;
+    centerLongitude?: number | null;
+    defaultZoom?: number | null;
+    perimeterGeoJson?: Record<string, unknown> | null;
+    cityId?: string | null;
+    cityGroupId?: string | null;
+    city?: {
+        id: string;
+        name: string;
+    } | null;
+    cityGroup?: {
+        id: string;
+        name: string;
+    } | null;
+    pois?: MapPoiSummary[];
+    zones?: MapZoneSummary[];
+    _count?: {
+        pois: number;
+        zones?: number;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+
+interface OperationalZoneStreetLink {
+    street: {
+        id: string;
+        name: string;
+        latitude?: number | null;
+        longitude?: number | null;
+    };
+}
+interface OperationalZone {
+    id: string;
+    name: string;
+    type: OperationalZoneType;
+    status: OperationalZoneStatus;
+    geoJson: Record<string, unknown>;
+    color?: string | null;
+    description?: string | null;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    cityId: string;
+    city?: {
+        id: string;
+        name: string;
+    };
+    wasteCollectionPlaceId?: string | null;
+    wasteCollectionPlace?: {
+        id: string;
+        name: string;
+        reference?: string | null;
+    } | null;
+    wasteTypeId?: string | null;
+    wasteType?: {
+        id: string;
+        name: string;
+        color?: string | null;
+    } | null;
+    syncCalendarException?: boolean;
+    collectionExceptionId?: string | null;
+    collectionException?: {
+        id: string;
+        name: string;
+        dateFrom: string;
+        dateTo: string;
+    } | null;
+    streets?: OperationalZoneStreetLink[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface CreateOperationalZoneRequest {
+    name: string;
+    type: OperationalZoneType;
+    status?: OperationalZoneStatus;
+    geoJson: Record<string, unknown>;
+    color?: string;
+    description?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    cityId: string;
+    streetIds?: string[];
+    wasteCollectionPlaceId?: string;
+    wasteTypeId?: string;
+    syncCalendarException?: boolean;
+}
+interface UpdateOperationalZoneRequest {
+    name?: string;
+    type?: OperationalZoneType;
+    status?: OperationalZoneStatus;
+    geoJson?: Record<string, unknown>;
+    color?: string;
+    description?: string;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    streetIds?: string[];
+    wasteCollectionPlaceId?: string | null;
+    wasteTypeId?: string | null;
+    syncCalendarException?: boolean;
+}
+
+interface CreateMaintenanceTypeRequest {
+    name: string;
+    description?: string;
+    downtimeHours: number;
+    recommendedFrequency?: number;
+    estimatedCost?: number;
+    instructions?: string;
+    isActive?: boolean;
+}
+interface UpdateMaintenanceTypeRequest {
+    name?: string;
+    description?: string;
+    downtimeHours?: number;
+    recommendedFrequency?: number;
+    estimatedCost?: number;
+    instructions?: string;
+    isActive?: boolean;
+}
+interface MaintenanceProgramItemRequest {
+    maintenanceTypeId: string;
+    frequencyDays: number;
+    order?: number;
+}
+interface CreateMaintenanceProgramRequest {
+    name: string;
+    description?: string;
+    items: MaintenanceProgramItemRequest[];
+    isActive?: boolean;
+}
+interface UpdateMaintenanceProgramRequest {
+    name?: string;
+    description?: string;
+    items?: MaintenanceProgramItemRequest[];
+    isActive?: boolean;
+}
+interface AssignProgramRequest {
+    programId: string;
+    startDate: string;
+}
+
+interface CreateIotDeviceRequest {
+    name: string;
+    deviceId: string;
+    assetId?: string;
+    clientCert: string;
+    clientKey: string;
+    enabled?: boolean;
+}
+interface UpdateIotDeviceRequest {
+    name?: string;
+    deviceId?: string;
+    assetId?: string;
+    clientCert?: string;
+    clientKey?: string;
+    enabled?: boolean;
+}
+interface IotWebhookPayloadRequest {
+    deviceId: string;
+    eventType: 'position' | 'consumption' | 'alert';
+    latitude?: number;
+    longitude?: number;
+    value?: number;
+    unit?: string;
+    periodStart?: string;
+    periodEnd?: string;
+    title?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+
+interface CreateConversationRequest {
+    deviceId: string;
+    cityId?: string;
+    /** Scope collectivité entière (sans picker ville). */
+    cityGroupId?: string;
+}
+interface SetConversationLocationRequest {
+    cityId: string;
+    placeId?: string;
+}
+interface AssignConversationRequest {
+    agentId: string;
+}
+interface UpdateConversationStatusRequest {
+    status: ChatStatus;
+}
+interface SendMessageRequest {
+    content: string;
+    actionOptionId?: string;
+    /** Lieu / secteur sélectionné (filtre calendrier RAG). */
+    placeId?: string;
+}
+/** Détail matériau d’une fiche type de déchet (référentiel). */
+interface ChatWasteTypeDetail {
+    id: string;
+    material: string;
+    description?: string | null;
+    instructions?: string | null;
+    imageUrl?: string | null;
+}
+/** Fiche WasteType renvoyée par le chat (même source que console / app). */
+interface ChatWasteTypeFiche {
+    id: string;
+    name: string;
+    description?: string | null;
+    instructions?: string | null;
+    color?: string | null;
+    colorLight?: string | null;
+    icon?: string | null;
+    imageUrl?: string | null;
+    rules: string[];
+    details: ChatWasteTypeDetail[];
+    matchedMaterial?: string;
+}
+interface ChatLink {
+    id: string;
+    label: string;
+    url: string;
+}
+interface ChatActionOption {
+    id: string;
+    label: string;
+    nextStep?: string;
+}
+interface ChatAction {
+    type: 'action';
+    id: string;
+    message: string;
+    options: ChatActionOption[];
+}
+interface ChatTextResponse {
+    type: 'text';
+    content: string;
+    links?: ChatLink[];
+    /** Fiches types de déchets du référentiel (affichage card UI). */
+    wasteTypes?: ChatWasteTypeFiche[];
+}
+type ChatResponse = ChatTextResponse | ChatAction;
+
+interface UpsertTerritoryEconomicsRequest {
+    cityId?: string;
+    cityGroupId?: string;
+    fiscalYear?: number;
+    annualTonnageOmr: number;
+    errorRatePercent: number;
+    costPerBadTonne?: number;
+    tgapEurPerTonne?: number;
+    householdCount?: number | null;
+    population?: number | null;
+    wastoAnnualCostEur?: number;
+    citeoSupportGainEur?: number;
+    notes?: string | null;
+    /** Si true, fige la baseline (avant) sur les valeurs courantes. */
+    lockBaseline?: boolean;
+    annualBilanConfirmed?: boolean;
+    dataSource?: 'MANUAL' | 'SINOE' | 'IMPORT';
+}
+interface ImportTerritoryYearRequest {
+    fiscalYear: number;
+    annualTonnageOmr: number;
+    errorRatePercent?: number;
+    costPerBadTonne?: number;
+    citeoSupportGainEur?: number;
+    population?: number | null;
+    householdCount?: number | null;
+    notes?: string | null;
+}
+interface ImportTerritoryHistoryRequest {
+    cityGroupId: string;
+    years: ImportTerritoryYearRequest[];
+    /** Si true, marque dataSource=SINOE. */
+    fromSinoe?: boolean;
+}
+interface CreateTerritoryActionRequest {
+    name: string;
+    description?: string;
+    type?: TerritoryActionType;
+    status?: TerritoryActionStatus;
+    zoneLabel?: string;
+    startDate?: string;
+    endDate?: string;
+    budgetCapexEur?: number;
+    budgetOpexEur?: number;
+    expectedErrorReductionPercent?: number;
+    measuredErrorReductionPercent?: number | null;
+    challengeId?: string | null;
+    surveyId?: string | null;
+    order?: number;
+}
+interface UpdateTerritoryActionRequest extends Partial<CreateTerritoryActionRequest> {
+}
+
+interface CalendarPdfSector {
+    id: string;
+    name: string;
+    label: string | null;
+    cityId: string;
+    cityName: string;
+}
+interface StreetSectorMatch {
+    streetId: string;
+    streetName: string;
+    cityId: string;
+    cityName: string;
+    sectors: CalendarPdfSector[];
+}
+interface SearchStreetSectorsQuery {
+    q: string;
+    cityGroupId?: string;
+}
+interface SearchStreetSectorsResponse {
+    data: StreetSectorMatch[];
+}
+
+/**
+ * Contrats API onboarding self-serve (compte gratuit → collectivité → mode restreint → PWA light).
+ * Routes : `POST /onboarding/bootstrap-city-group`, `POST /onboarding/request-join`,
+ * `GET /onboarding/search-city-groups`, `GET /onboarding/search-sinoe`,
+ * `POST /onboarding/bootstrap-pwa-light`, `POST /onboarding/sync-restricted-access`.
+ */
+/** Étapes du parcours post-inscription (console). */
+type OnboardingStepId = 'account' | 'collectivite' | 'restricted' | 'pwa_light' | 'done';
+type BootstrapCityGroupRequest = {
+    /** Nom du groupement (ex. « CA du Pays de … »). */
+    name: string;
+    type?: CityGroupType;
+    /** Code / SIREN optionnels pour dédoublonnage. */
+    code?: string | null;
+    siren?: string | null;
+    /** Première commune rattachée (minimale). */
+    city?: {
+        name: string;
+        country?: string;
+        codeInsee?: string | null;
+    };
+};
+type BootstrapCityGroupResponse = {
+    cityGroupId: string;
+    cityId?: string | null;
+    /** Apps activées (= preset free / restreint). */
+    enabledDashboardAppSlugs: DashboardAppSlug[];
+    /** Membership créateur : GESTIONNAIRE + authorizations. */
+    membershipId: string;
+    /** Prochaine étape console recommandée. */
+    nextStep: OnboardingStepId;
+};
+type OnboardingCityGroupSearchHit = {
+    id: string;
+    name: string;
+    type: CityGroupType;
+    code?: string | null;
+    siren?: string | null;
+    citiesCount: number;
+};
+/**
+ * Hit ADEME / SINOE (Data Fair flux collecte) pour le sélecteur onboarding.
+ * `codeActeur` = `c_acteur` SINOE (pas un SIREN légal) — stocké en `CityGroup.code` au create.
+ */
+type OnboardingSinoeSearchHit = {
+    id: string;
+    name: string;
+    codeActeur: string;
+    departement?: string | null;
+    codeDepartement?: string | null;
+    region?: string | null;
+    population?: number | null;
+    year: number;
+    typologie?: string | null;
+    /** CityGroup Wasto déjà présent (match code/siren = codeActeur). */
+    existingCityGroup?: OnboardingCityGroupSearchHit | null;
+};
+type RequestJoinCityGroupRequest = {
+    cityGroupId: string;
+};
+type RequestJoinCityGroupResponse = {
+    membershipId: string;
+    cityGroupId: string;
+    /** MVP : false — en attente d’acceptation par un gestionnaire. */
+    isAccepted: boolean;
+    nextStep: OnboardingStepId;
+    /** TODO produit : workflow d’approbation / notification gestionnaire. */
+    note?: string;
+};
+type PwaLightBootstrapRequest = {
+    cityGroupId: string;
+    /** Slug public PWA (unique). */
+    slug: string;
+    name?: string;
+    /** Publier immédiatement (`pwaPublished`). Défaut true. */
+    publish?: boolean;
+};
+type PwaLightBootstrapResponse = {
+    cmsAppId: string;
+    slug: string;
+    /** Écrans light : tri + calendrier (hors carte / défis sur free). */
+    screens: ReadonlyArray<'tri' | 'calendrier' | 'carte' | 'defis'>;
+    previewPath: string;
+    pwaPublished: boolean;
+};
+type SyncRestrictedAccessRequest = {
+    cityGroupId: string;
+};
+type SyncRestrictedAccessResponse = {
+    cityGroupId: string;
+    enabledDashboardAppSlugs: DashboardAppSlug[];
+    membershipAuthorizations: string[];
+};
+/** Preset appliqué au bootstrap self-serve. */
+declare const ONBOARDING_RESTRICTED_APP_SLUGS: readonly DashboardAppSlug[];
+
+/**
+ * Moteur ROI déchets — partagé simulateur landing / API / console.
+ * Ordres de grandeur pédagogiques (non contractuels).
+ */
+declare const ROI_DEFAULTS: {
+    readonly annualTonnage: 12000;
+    readonly errorRatePercent: 25;
+    readonly costPerBadTonne: 300;
+    /** Habitants par foyer (proxy si householdCount absent). */
+    readonly peoplePerHousehold: 2.2;
+};
+/** Coefficients Citeo outre-mer (barème pédagogique MVP). */
+declare const CITEO_DOM_MULTIPLIERS: {
+    readonly lightPackaging: 2.3;
+    readonly glass: 1.9;
+    readonly paper: 4.3;
+    readonly communication: 1.25;
+    readonly ambassadors: 1.25;
+    /** Facteur composite simplifié pour majorer un soutien Citeo agrégé saisi. */
+    readonly compositeSupport: 2.3;
+};
+/** Départements / préfixes INSEE DOM-COM (métropole exclue). */
+declare const DOM_INSEE_PREFIXES: readonly ["971", "972", "973", "974", "976"];
+/**
+ * Trajectoire TGAP enfouissement (€/t) — barème pédagogique MVP.
+ * 2025: 65, 2026: 69, puis +4 €/an jusqu'à 85 €/t en 2030.
+ */
+declare const TGAP_LANDFILL_EUR_PER_TONNE: Readonly<Record<number, number>>;
+declare function currentFiscalYear(now?: Date): number;
+declare function getTgapEurPerTonne(fiscalYear: number): number;
+/**
+ * Ajuste le coût / t mal orientée quand la TGAP change d'année.
+ * On conserve le « reste » (traitement hors TGAP) et on y ajoute la nouvelle TGAP.
+ */
+declare function adjustCostPerBadTonneForTgap(opts: {
+    previousCostPerBadTonne: number;
+    previousTgapEurPerTonne: number;
+    nextTgapEurPerTonne: number;
+}): number;
+type AnnualRoiPoint = {
+    fiscalYear: number;
+    tonnageOmr: number;
+    errorRatePercent: number;
+    costPerBadTonne: number;
+    tgapEurPerTonne: number;
+    /** GEC réel (snapshot / actions de l'année). */
+    realGecEur: number;
+    /** GEC BAU : même tonnage/erreur de référence, TGAP/coût de l'année, sans réduction d'erreur. */
+    bauGecEur: number;
+    cenEur: number | null;
+    hasSnapshot: boolean;
+    annualBilanConfirmed: boolean;
+};
+/**
+ * Série BAU vs réel pour le graphique pluriannuel.
+ * `reference` = première année connue (baseline historique).
+ */
+declare function buildBauVsRealSeries(opts: {
+    fromYear: number;
+    toYear: number;
+    reference: {
+        tonnageOmr: number;
+        errorRatePercent: number;
+        costPerBadTonne: number;
+        tgapEurPerTonne: number;
+    };
+    years: Array<{
+        fiscalYear: number;
+        tonnageOmr: number;
+        errorRatePercent: number;
+        costPerBadTonne: number;
+        tgapEurPerTonne: number;
+        gecEur: number;
+        cenEur: number | null;
+        annualBilanConfirmed?: boolean;
+    }>;
+}): AnnualRoiPoint[];
+/** Scénarios pédagogiques alignés lead magnet landing. */
+declare const ROI_SCENARIO_DEFS: ({
+    id: "awareness";
+    label: string;
+    errorReductionFactor: number;
+    costBase: number;
+    costPerTonne: number;
+} | {
+    id: "controls";
+    label: string;
+    errorReductionFactor: number;
+    costBase: number;
+    costPerTonne: number;
+} | {
+    id: "wasto";
+    label: string;
+    errorReductionFactor: number;
+    costBase: number;
+    costPerTonne: number;
+})[];
+type ImpactConfidenceLevel = 1 | 2 | 3;
+type ImpactConfidence = {
+    level: ImpactConfidenceLevel;
+    label: string;
+    tone: 'low' | 'medium' | 'high';
+    message: string;
+    /** Facteur 0–1 appliqué à la réduction d'erreur pour le calcul. */
+    impactFactor: number;
+};
+type RoiActionInput = {
+    budgetCapexEur: number;
+    budgetOpexEur: number;
+    /** Réduction relative 0–100 (ex. 12 = −12 %). */
+    errorReductionPercent: number;
+    status?: string;
+    name?: string;
+    id?: string;
+    type?: string;
+};
+type RoiEconomicsInput = {
+    annualTonnageOmr: number;
+    errorRatePercent: number;
+    costPerBadTonne: number;
+    citeoSupportGainEur?: number;
+    wastoAnnualCostEur?: number;
+    /** Taux d'erreur baseline figé (sinon = errorRatePercent courant). */
+    baselineErrorRatePercent?: number | null;
+    baselineAnnualTonnageOmr?: number | null;
+    /** Si true, majore les soutiens Citeo (DOM). */
+    isDomTerritory?: boolean;
+    fiscalYear?: number;
+    tgapEurPerTonne?: number;
+    /** Bilan annuel consolidé → peut monter l'ICI global à N3. */
+    annualBilanConfirmed?: boolean;
+};
+type RoiLiveSignals = {
+    penetrationRatePercent: number;
+    activeDevices30d: number;
+    validatedVisionScans: number;
+    challengeCompletions: number;
+    terrainResponses: number;
+    annualBilanConfirmed?: boolean;
+};
+type RoiIndicators = {
+    /** Gisement Économique Capturable (pertes avant). */
+    gecEur: number;
+    baselineBadTonnes: number;
+    baselineErrorRatePercent: number;
+    afterErrorRatePercent: number;
+    /** Réduction combinée effective en points de % d'erreur (ex. 5.6). */
+    combinedErrorReductionPoints: number;
+    /** Réduction relative combinée (ex. 22.4 pour −22,4 %). */
+    combinedErrorReductionPercent: number;
+    stackingFormula: string;
+    afterAnnualLossEur: number;
+    afterBadTonnes: number;
+    /** Économies brutes = pertes avant − pertes après. */
+    grossSavingsEur: number;
+    /** Budgets des seules actions (hors abonnement). */
+    actionsBudgetEur: number;
+    /** Ligne abonnement / contrat Wast-O. */
+    wastoAnnualCostEur: number;
+    totalActionBudgetsEur: number;
+    citeoSupportGainEur: number;
+    citeoSupportBaseEur: number;
+    citeoDomMultiplier: number;
+    isDomTerritory: boolean;
+    /**
+     * CEN = économies brutes + Citeo − budgets cumulés
+     * (aligné avec le numérateur du ROI).
+     */
+    cenEur: number;
+    /** ROI = (économies + Citeo) / budgets ; null si budget 0. */
+    roiMultiple: number | null;
+    overallConfidence: ImpactConfidence;
+    disclaimer: string;
+};
+declare const ROI_DISCLAIMER = "Ordres de grandeur p\u00E9dagogiques fond\u00E9s sur des hypoth\u00E8ses d\u00E9claratives (tonnages, taux d\u2019erreur, budgets). Non contractuels \u2014 \u00E0 affiner avec les donn\u00E9es exploitant / SITOM / TGAP.";
+declare function roundEuro(n: number): number;
+declare function isDomInseeCode(codeInsee: string | null | undefined): boolean;
+declare function detectDomTerritory(opts: {
+    cityInseeCodes?: Array<string | null | undefined>;
+    cityGroupCode?: string | null;
+    cityGroupName?: string | null;
+}): boolean;
+declare function applyCiteoDomMultiplier(baseCiteoEur: number, isDom: boolean): {
+    baseEur: number;
+    multiplier: number;
+    effectiveEur: number;
+};
+/** GEC = tonnage × (taux erreur / 100) × €/t */
+declare function computeGec(annualTonnage: number, errorRatePercent: number, costPerBadTonne: number): {
+    gecEur: number;
+    badTonnes: number;
+};
+/**
+ * Empilement multiplicatif des réductions relatives d'actions actives.
+ * newRate = baseline × Π(1 − r_i/100)
+ */
+declare function applyStackedErrorReductions(baselineErrorRatePercent: number, reductionsPercent: number[]): number;
+declare function isActionCountedInRoi(status?: string): boolean;
+/**
+ * ICI — Indice de Confiance de l'Impact.
+ * 1 = déclaratif, 2 = proxy live, 3 = mesuré / représentatif.
+ */
+declare function computeActionImpactConfidence(action: RoiActionInput, live: RoiLiveSignals): ImpactConfidence;
+declare function computeOverallConfidence(actionConfidences: ImpactConfidence[], opts?: {
+    annualBilanConfirmed?: boolean;
+}): ImpactConfidence;
+declare function computeRoiIndicators(economics: RoiEconomicsInput, actions: RoiActionInput[], live?: RoiLiveSignals): RoiIndicators;
+type ActionContribution = {
+    id?: string;
+    name?: string;
+    type?: string;
+    shareEur: number;
+    budgetEur: number;
+    confidence: ImpactConfidence;
+    effectiveReductionPercent: number;
+};
+/** Contribution approximative au prorata de la réduction effective (après ICI). */
+declare function allocateSavingsByAction(grossSavingsEur: number, actions: RoiActionInput[], live?: RoiLiveSignals): ActionContribution[];
+declare function estimateHouseholds(householdCount: number | null | undefined, population: number | null | undefined): number;
+declare function computePenetrationRate(activeHouseholdsProxy: number, householdCount: number): number;
+/** Simulation pédagogique territoire 100k hab. (validation formules). */
+declare function simulateTerritory100kExample(): {
+    population: number;
+    households: number;
+    economics: RoiEconomicsInput;
+    actions: RoiActionInput[];
+    indicators: RoiIndicators;
+    contributions: ActionContribution[];
+};
+
+/** Dates de référence (semaine du 2024-01-01, lundi) pour conversions TZ */
+declare const WEEKDAY_REF_DATES: Record<Weekday, string>;
+declare const WEEKDAY_LABELS_FR: Record<Weekday, string>;
+declare const WEEKDAY_LABELS_FR_SHORT: Record<Weekday, string>;
+declare const WEEKDAY_INDEX: Record<Weekday, number>;
+declare const PRESET_SLOTS: {
+    readonly morning: {
+        readonly open: "08:00";
+        readonly close: "12:00";
+    };
+    readonly afternoon: {
+        readonly open: "14:00";
+        readonly close: "18:00";
+    };
+    readonly fullDay: {
+        readonly open: "08:00";
+        readonly close: "18:00";
+    };
+};
+
+declare function parseTimeMinutes(value: string): number | null;
+declare function formatTimeMinutes(totalMinutes: number): string;
+declare function formatTimeDisplay(value: string): string;
+declare function slotsOverlap(a: TimeSlot, b: TimeSlot): boolean;
+declare function sortSlots(slots: TimeSlot[]): TimeSlot[];
+declare function nextWeekday(day: Weekday): Weekday;
+declare function addDaysToIsoDate(isoDate: string, days: number): string;
+declare function weekdayFromUtcDate(date: Date): Weekday;
+declare function utcHhmmFromDate(date: Date): string;
+declare function refDateForWeekday(day: Weekday): string;
+
+/** Offset du fuseau IANA en minutes (positif = en avance sur UTC) à un instant donné. */
+declare function getTimezoneOffsetMinutes(timeZone: string, at: Date): number;
+/** Convertit une date/heure locale (dans timeZone) en instant UTC. */
+declare function localDateTimeToUtc(dateIso: string, time: string, timeZone: string): Date;
+declare function getBrowserTimeZone(): string;
+declare function utcDateIso(at: Date): string;
+
+declare function validateOpeningHours(input: unknown): OpeningHoursValidationResult;
+/** Valide des horaires saisis en heure locale (même structure, sans storage/version). */
+declare function validateLocalOpeningHours(input: {
+    rules: OpeningHoursRule[];
+    exceptions?: OpeningHoursException[];
+}): OpeningHoursValidationResult;
+declare function createEmptyOpeningHours(): OpeningHours;
+declare function createEmptyLocalRules(): OpeningHoursRule[];
+
+type LocalOpeningHoursInput = {
+    rules: OpeningHoursRule[];
+    exceptions?: OpeningHoursException[];
+};
+declare function convertLocalToUtc(local: LocalOpeningHoursInput, timeZone: string): OpeningHours;
+declare function convertUtcToLocal(utc: OpeningHours, timeZone: string): LocalOpeningHoursInput;
+declare function localRulesFromRange(fromDay: Weekday, toDay: Weekday, slots: TimeSlot[], exceptDays?: Weekday[]): OpeningHoursRule;
+
+/** Formate un résumé court à partir d'horaires (UTC ou locaux selon le contenu passé). */
+declare function formatOpeningHoursSummary(hours: OpeningHours | {
+    rules: OpeningHoursRule[];
+}, timeZone?: string): string;
+declare function formatOpeningHoursWeekly(hours: OpeningHours, timeZone?: string): WeeklyHoursRow[];
+declare function formatWeeklyRow(row: WeeklyHoursRow): string;
+
+type RecyclingPointHoursSource = {
+    hours?: string | null;
+    details?: Record<string, unknown> | null;
+};
+declare function resolveHoursMode(details?: Record<string, unknown> | null): HoursInputMode;
+declare function resolveOpeningHoursUtc(point: RecyclingPointHoursSource): OpeningHours | null;
+declare function resolveOpeningHoursLocal(point: RecyclingPointHoursSource, timeZone?: string): {
+    rules: OpeningHours['rules'];
+    exceptions?: OpeningHours['exceptions'];
+} | null;
+declare function resolveHoursText(point: RecyclingPointHoursSource): string | null;
+/** Texte d'affichage des horaires (structuré converti ou texte libre). */
+declare function resolveHoursDisplay(point: RecyclingPointHoursSource, timeZone?: string): string | null;
+declare function resolveHoursModeFromPoint(point: RecyclingPointHoursSource): HoursInputMode;
+
+declare function isOpenNow(hours: OpeningHours, at?: Date): boolean;
+declare function openNowLabel(hours: OpeningHours, at?: Date): 'Ouvert' | 'Fermé';
+
+/**
+ * Typed shape of CmsSite.settings when type === 'APP'.
+ * Used for splash, icon and theme configuration (Expo-compatible).
+ */
+/** Splash screen config (expo-splash-screen compatible) */
+interface AppSplashSettings {
+    /** Image URL or media id */
+    image?: string;
+    backgroundColor?: string;
+    imageWidth?: number;
+    resizeMode?: 'contain' | 'cover';
+    dark?: {
+        backgroundColor?: string;
+    };
+}
+/** Adaptive icon for Android (Expo format) */
+interface AppAdaptiveIconSettings {
+    foregroundImage?: string;
+    backgroundImage?: string;
+    monochromeImage?: string;
+    backgroundColor?: string;
+}
+/** App icon config (Expo format, 1024x1024 main icon) */
+interface AppIconSettings {
+    /** Main icon URL (1024x1024) */
+    image?: string;
+    adaptiveIcon?: AppAdaptiveIconSettings;
+}
+/** Gradient definition */
+interface AppThemeGradient {
+    from?: string;
+    to?: string;
+    stops?: string[];
+}
+/** Style template: colors, gradient, border radius */
+interface AppThemeSettings {
+    primary?: string;
+    /** Text / icons on `primary` background */
+    onPrimary?: string;
+    secondary?: string;
+    tertiary?: string;
+    gradient?: AppThemeGradient;
+    success?: string;
+    error?: string;
+    dark?: string;
+    grey?: string;
+    /** e.g. "none" | "sm" | "md" | "lg" or number in px */
+    borderRadius?: string | number;
+}
+/** Tab item for app navigation (expo-router Tabs) */
+interface AppTabConfig {
+    id: string;
+    title: string;
+    /** Icon name (e.g. lucide: Home, MapPin, Calendar, Info) */
+    icon?: string;
+    screenId: string;
+    route: string;
+}
+/** Stack screen for app navigation (expo-router Stack, outside tabs) */
+interface AppStackScreenConfig {
+    id: string;
+    screenId: string;
+    route: string;
+    options?: Record<string, unknown>;
+}
+/** Layout config: tabs + stack screens, consumed by clone script to generate _layout.tsx */
+interface AppLayoutsConfig {
+    tabs?: AppTabConfig[];
+    stackScreens?: AppStackScreenConfig[];
+    /** Route or id of the initial tab (default first tab) */
+    initialTab?: string;
+}
+/** Full app settings stored in CmsSite.settings when type === 'APP' */
+interface AppSettings {
+    /** If set, app uses this URL for API client instead of env */
+    apiBaseUrl?: string;
+    splash?: AppSplashSettings;
+    icon?: AppIconSettings;
+    theme?: AppThemeSettings;
+    /** Tabs and stack screens; used by clone script to generate layout files */
+    layouts?: AppLayoutsConfig;
+}
+
+interface WastoClientConfig {
+    baseUrl: string;
+    getToken?: () => string | null;
+    /** Headers added to every request (e.g. X-Wasto-Client). */
+    defaultHeaders?: Record<string, string>;
+    /**
+     * Optional hook when a request fails (HTTP error or network).
+     * Called before the error is rethrown. Host apps (e.g. via cms-components)
+     * wire Sentry here — wasto-sdk stays vendor-agnostic.
+     */
+    onRequestError?: (error: Error, context: WastoRequestErrorContext) => void;
+}
+type WastoRequestErrorContext = {
+    method: string;
+    url: string;
+    path: string;
+    status?: number;
+};
+declare class WastoApiError extends Error {
+    status: number;
+    body?: unknown | undefined;
+    constructor(message: string, status: number, body?: unknown | undefined);
+}
+declare function createWastoClient(config: WastoClientConfig): {
+    request: <T>(path: string, options?: RequestInit) => Promise<T>;
+    auth: {
+        login: (email: string, password: string) => Promise<{
+            access_token: string;
+            user?: unknown;
+        } | {
+            requiresTwoFactor: true;
+            pendingToken: string;
+        }>;
+        register: (data: {
+            email: string;
+            password: string;
+            firstName?: string;
+            lastName?: string;
+        }) => Promise<{
+            access_token?: string;
+            user?: unknown;
+        }>;
+        forgotPassword: (email: string) => Promise<{
+            ok: boolean;
+        }>;
+        resetPassword: (token: string, password: string) => Promise<{
+            ok: boolean;
+        }>;
+        acceptInvite: (data: {
+            token: string;
+            password: string;
+            firstName?: string;
+            lastName?: string;
+        }) => Promise<{
+            access_token: string;
+            user?: unknown;
+        }>;
+        verify2fa: (pendingToken: string, code: string) => Promise<{
+            access_token: string;
+            user?: unknown;
+        }>;
+    };
+    users: {
+        findAll: (params?: {
+            page?: number;
+            pageSize?: number;
+        }) => Promise<PaginatedResponse<unknown>>;
+        getById: (id: string) => Promise<unknown>;
+        getMe: () => Promise<unknown>;
+        create: (data: unknown) => Promise<unknown>;
+        invite: (data: unknown) => Promise<unknown>;
+        update: (id: string, data: unknown) => Promise<unknown>;
+        updateMe: (data: unknown) => Promise<unknown>;
+        remove: (id: string) => Promise<void>;
+    };
+    assets: {
+        findAll: (params?: {
+            page?: number;
+            pageSize?: number;
+            cityId?: string;
+            cityGroupId?: string;
+            type?: string;
+            status?: string;
+        }) => Promise<PaginatedResponse<unknown>>;
+        getMapLocations: (params?: {
+            page?: number;
+            pageSize?: number;
+            cityId?: string;
+            cityGroupId?: string;
+            type?: string;
+            status?: string;
+        }) => Promise<PaginatedResponse<unknown>>;
+        getById: (id: string) => Promise<unknown>;
+        create: (data: unknown) => Promise<unknown>;
+        update: (id: string, data: unknown) => Promise<unknown>;
+        remove: (id: string) => Promise<void>;
+    };
+    cities: {
+        findAll: (params?: {
+            page?: number;
+            pageSize?: number;
+        }) => Promise<PaginatedResponse<unknown>>;
+        getById: (id: string) => Promise<unknown>;
+        create: (data: unknown) => Promise<unknown>;
+        update: (id: string, data: unknown) => Promise<unknown>;
+        remove: (id: string) => Promise<void>;
+        wasteTypes: (cityId: string) => {
+            /** @deprecated Préférez cityGroups.wasteTypes pour la gestion du catalogue. */
+            list: (params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            /** @deprecated Préférez cityGroups.wasteTypes.create */
+            create: (data: unknown) => Promise<unknown>;
+            getById: (id: string) => Promise<unknown>;
+            /** @deprecated Préférez cityGroups.wasteTypes.update */
+            update: (id: string, data: unknown) => Promise<unknown>;
+            /** @deprecated Délie la ville ; préférez cityGroups.wasteTypes.unlinkCity ou remove */
+            remove: (id: string) => Promise<void>;
+        };
+        wasteCollectionPlaces: (cityId: string) => {
+            list: (params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            create: (data: unknown) => Promise<unknown>;
+            getById: (id: string) => Promise<unknown>;
+            update: (id: string, data: unknown) => Promise<unknown>;
+            remove: (id: string) => Promise<void>;
+        };
+        quizQuestions: (cityId: string) => {
+            list: (params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            create: (data: unknown) => Promise<unknown>;
+            getById: (id: string) => Promise<unknown>;
+            update: (id: string, data: unknown) => Promise<unknown>;
+            remove: (id: string) => Promise<void>;
+        };
+        recyclingPoints: (cityId: string) => {
+            list: (params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            create: (data: unknown) => Promise<unknown>;
+            getById: (id: string) => Promise<unknown>;
+            update: (id: string, data: unknown) => Promise<unknown>;
+            remove: (id: string) => Promise<void>;
+        };
+    };
+    wasteTypeDetails: (wasteTypeId: string) => {
+        list: (params?: {
+            page?: number;
+            pageSize?: number;
+        }) => Promise<PaginatedResponse<unknown>>;
+        create: (data: unknown) => Promise<unknown>;
+        update: (id: string, data: unknown) => Promise<unknown>;
+        remove: (id: string) => Promise<void>;
+    };
+    cityGroups: {
+        findAll: (params?: {
+            page?: number;
+            pageSize?: number;
+        }) => Promise<PaginatedResponse<unknown>>;
+        getById: (id: string) => Promise<unknown>;
+        create: (data: unknown) => Promise<unknown>;
+        update: (id: string, data: unknown) => Promise<unknown>;
+        remove: (id: string) => Promise<void>;
+        wasteTypes: (cityGroupId: string) => {
+            list: (params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getById: (id: string) => Promise<unknown>;
+            create: (data: unknown) => Promise<unknown>;
+            update: (id: string, data: unknown) => Promise<unknown>;
+            remove: (id: string) => Promise<void>;
+            linkCity: (wasteTypeId: string, cityId: string) => Promise<unknown>;
+            unlinkCity: (wasteTypeId: string, cityId: string) => Promise<void>;
+        };
+    };
+    public: {
+        cities: {
+            findAll: (params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getById: (id: string) => Promise<unknown>;
+            getWasteTypes: (cityId: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getWasteCollectionPlaces: (cityId: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getRecyclingPoints: (cityId: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getChallenges: (cityId: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getBadges: (cityId: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getOperationalZones: (cityId: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            searchStreetSectors: (cityId: string, params: SearchStreetSectorsQuery) => Promise<SearchStreetSectorsResponse>;
+            getCalendarPdfUrl: (cityId: string, placeId: string, year?: number) => string;
+            getCalendarPrintUrl: (cityId: string, placeId: string, year?: number, preview?: boolean) => string;
+        };
+        challenges: {
+            list: (cityId?: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getById: (id: string) => Promise<unknown>;
+            getSeries: (id: string) => Promise<unknown>;
+            complete: (id: string, body: {
+                deviceId: string;
+                score: number;
+                seriesId: string;
+            }) => Promise<unknown>;
+            getProgress: (deviceId: string) => Promise<unknown[]>;
+        };
+        blogPosts: {
+            list: (cityGroupId?: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getById: (id: string) => Promise<unknown>;
+        };
+        announcements: {
+            listForCity: (cityId: string) => Promise<{
+                id: string;
+                title: string;
+                body: string;
+                imageUrl?: string | null;
+                sentAt?: string | null;
+            }[]>;
+        };
+        cityGroups: {
+            searchStreetSectors: (cityGroupId: string, params: {
+                q: string;
+            }) => Promise<SearchStreetSectorsResponse>;
+        };
+        tickets: {
+            getForms: (params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getForm: (id: string) => Promise<unknown>;
+            create: (data: unknown) => Promise<unknown>;
+            getByAccessKey: (accessKey: string) => Promise<unknown>;
+        };
+        chat: {
+            getAvailability: (params: string | {
+                cityId?: string;
+                cityGroupId?: string;
+            }) => Promise<{
+                enabled: boolean;
+                cityGroupId: string | null;
+                reason?: string;
+            }>;
+            createConversation: (body: {
+                deviceId: string;
+                cityId?: string;
+                cityGroupId?: string;
+            }) => Promise<unknown>;
+            setConversationLocation: (conversationId: string, body: {
+                cityId: string;
+                placeId?: string;
+            }) => Promise<unknown>;
+            getConversations: (deviceId: string, params?: {
+                page?: number;
+                pageSize?: number;
+            }) => Promise<PaginatedResponse<unknown>>;
+            getMessages: (conversationId: string) => Promise<unknown>;
+            sendMessage: (conversationId: string, body: {
+                content: string;
+                actionOptionId?: string;
+                placeId?: string;
+            }) => Promise<unknown>;
+        };
+        devices: {
+            registerPushToken: (deviceId: string, body: {
+                token: string;
+            }) => Promise<void>;
+        };
+        analytics: {
+            track: (payload: unknown) => Promise<void>;
+            delete: (deviceId: string) => Promise<void>;
+        };
+        cms: {
+            getPageById: (id: string) => Promise<unknown>;
+            getSiteBySlug: (slug: string) => Promise<unknown>;
+            getAppBySlug: (slug: string) => Promise<unknown>;
+            getAppMenuById: (appSlug: string, menuId: string) => Promise<unknown>;
+        };
+    };
+};
+type WastoClient = ReturnType<typeof createWastoClient>;
+
+export { type AcceptInviteRequest, type AccessibleCityGroup, type ActionContribution, type AnnualRoiPoint, type AppAdaptiveIconSettings, type AppIconSettings, type AppLayoutsConfig, type AppSettings, type AppSplashSettings, type AppStackScreenConfig, type AppTabConfig, type AppThemeGradient, type AppThemeSettings, AssetEventType, AssetStatus, AssetType, type AssignConversationRequest, type AssignProgramRequest, type AssignTicketRequest, BookingStatus, type BootstrapCityGroupRequest, type BootstrapCityGroupResponse, CITEO_DOM_MULTIPLIERS, type CalendarPdfSector, CalendoEventStatus, CalendoEventType, CalendoTicketSaleStatus, type CalendoTicketingOverview, type CancelAssetBookingRequest, type ChatAction, type ChatActionOption, type ChatLink, ChatMessageRole, type ChatResponse, ChatStatus, type ChatTextResponse, type ChatWasteTypeDetail, type ChatWasteTypeFiche, type CityGroupDashboardAppAccessItem, type CityGroupDashboardAppsResponse, CityGroupType, CityStatus, CmsMenuLinkType, CmsSiteType, type CreateAssetBookingRequest, type CreateAssetConsumptionRecordRequest, type CreateAssetEventRequest, type CreateAssetInterventionRequest, type CreateAssetRequest, type CreateAttachedLocationRequest, type CreateBadgeRequest, type CreateBlogPostRequest, type CreateCalendoEventRequest, type CreateCalendoTicketSaleRequest, type CreateChallengeRequest, type CreateCityGroupRequest, type CreateCityRequest, type CreateCmsLayoutRequest, type CreateCmsMenuItemRequest, type CreateCmsMenuRequest, type CreateCmsPageRequest, type CreateCmsSiteRequest, type CreateConversationRequest, type CreateFieldReportFieldRequest, type CreateFieldReportFormRequest, type CreateFieldReportRequest, type CreateIotDeviceRequest, type CreateMaintenanceProgramRequest, type CreateMaintenanceTypeRequest, type CreateMapEventRequest, type CreateMapPoiRequest, type CreateMapZoneRequest, type CreateNotificationRequest, type CreateOperationalZoneRequest, type CreateProviderRequest, type CreateQuizQuestionRequest, type CreateRecipientGroupRequest, type CreateRecyclingPointRequest, type CreateSerieRequest, type CreateSurveyAnswerRequest, type CreateSurveyCohortRequest, type CreateSurveyQuestionRequest, type CreateSurveyRequest, type CreateSurveyResponseRequest, type CreateSurveySubCohortRequest, type CreateTerritoryActionRequest, type CreateTicketFieldRequest, type CreateTicketFormRequest, type CreateTicketFromChatRequest, type CreateTicketRequest, type CreateUserRequest, type CreateWasteCollectionDayRequest, type CreateWasteCollectionExceptionRequest, type CreateWasteCollectionPlaceRequest, type CreateWasteTypeDetailRequest, type CreateWasteTypeRequest, DASHBOARD_APPS, DASHBOARD_APP_BY_KEY, DASHBOARD_APP_BY_SLUG, DEFAULT_ENABLED_DASHBOARD_APP_SLUGS, DEFAULT_PAGE, DEFAULT_PAGE_SIZE, DOM_INSEE_PREFIXES, type DashboardAppDefinition, DashboardAppSlug, FREE_SELF_SERVE_DASHBOARD_APP_SLUGS, FREE_TIER_FEATURES, FREE_TIER_FEATURE_KEYS, FREE_TIER_LIMITS, FREE_TIER_RESOURCES, FieldReportFormStatus, FieldReportStatus, type FieldReportValueRequest, type ForgotPasswordRequest, type FreeTierErrorCode, type FreeTierErrorPayload, type FreeTierFeature, type FreeTierFeatureItem, type FreeTierResource, type FreeTierUsageItem, type FreeTierUsageSnapshot, type HoursInputMode, type ImpactConfidence, type ImpactConfidenceLevel, type ImportTerritoryHistoryRequest, type ImportTerritoryYearRequest, InterventionStatus, InterventionType, type InviteUserRequest, type IotWebhookPayloadRequest, type LocateWasteCollectionPlacesQuery, type LoginRequest, type LoginResponse, type LoginTwoFactorChallenge, MAX_PAGE_SIZE, type MaintenanceProgramItemRequest, MapEventStatus, type MapEventSummary, MapEventType, MapPoiCategory, MapPoiStatus, type MapPoiSummary, type MapZoneSummary, MapZoneType, NotificationDeliveryStatus, NotificationStatus, ONBOARDING_RESTRICTED_APP_SLUGS, type OnboardingCityGroupSearchHit, type OnboardingSinoeSearchHit, type OnboardingStepId, type OpeningHours, type OpeningHoursException, type OpeningHoursExceptionClosed, type OpeningHoursExceptionOpen, type OpeningHoursRule, type OpeningHoursValidationResult, type OperationalZone, OperationalZoneStatus, type OperationalZoneStreetLink, OperationalZoneType, PRESET_SLOTS, type PaginatedResponse, type PaginationMeta, type PaginationQuery, PermissionAction, PermissionResource, ProviderType, type PublicAnnouncement, type PwaLightBootstrapRequest, type PwaLightBootstrapResponse, QuestionType, type QuizAbImageChoice, type QuizAbImageOptions, type QuizExplanationDetail, type QuizMcqChoice, type QuizMcqOptions, type QuizQuestionKind, type QuizQuestionOptions, ROI_DEFAULTS, ROI_DISCLAIMER, ROI_SCENARIO_DEFS, RecipientGroupType, type RecyclingPoint, type RecyclingPointDetails, type RecyclingPointHoursSource, type RegisterRequest, type RequestJoinCityGroupRequest, type RequestJoinCityGroupResponse, type ResetPasswordRequest, ResponseStatus, type RoiActionInput, type RoiEconomicsInput, type RoiIndicators, type RoiLiveSignals, type SearchStreetSectorsQuery, type SearchStreetSectorsResponse, type SendMessageRequest, type SetCityGroupDashboardAppsRequest, type SetConversationLocationRequest, type StreetSectorMatch, SurveyMode, SurveyStatus, type SyncRestrictedAccessRequest, type SyncRestrictedAccessResponse, TGAP_LANDFILL_EUR_PER_TONNE, TerritoryActionStatus, TerritoryActionType, TicketFormStatus, TicketStatus, type TicketValueRequest, type TimeSlot, type UpdateAssetBookingRequest, type UpdateAssetInterventionRequest, type UpdateAssetRequest, type UpdateAssetStatusRequest, type UpdateBlogPostRequest, type UpdateCalendoEventRequest, type UpdateCalendoTicketSaleRequest, type UpdateCityGroupRequest, type UpdateCityRequest, type UpdateCmsLayoutRequest, type UpdateCmsMenuRequest, type UpdateCmsPageRequest, type UpdateCmsSiteRequest, type UpdateConversationStatusRequest, type UpdateFieldReportFieldRequest, type UpdateFieldReportFormRequest, type UpdateFieldReportRequest, type UpdateFieldReportStatusRequest, type UpdateIotDeviceRequest, type UpdateMaintenanceProgramRequest, type UpdateMaintenanceTypeRequest, type UpdateMapEventRequest, type UpdateMapPoiRequest, type UpdateMapZoneRequest, type UpdateNotificationRequest, type UpdateOperationalZoneRequest, type UpdateProviderRequest, type UpdateRecipientGroupRequest, type UpdateSurveyCohortRequest, type UpdateSurveyQuestionRequest, type UpdateSurveyRequest, type UpdateSurveyResponseRequest, type UpdateSurveySubCohortRequest, type UpdateTerritoryActionRequest, type UpdateTicketFormRequest, type UpdateTicketRequest, type UpdateTicketStatusRequest, type UpdateUserRequest, type UpsertTerritoryEconomicsRequest, UserRole, WASTO_LANDINGS_DOMAIN, WASTO_LANDINGS_INDEX_HOST, WASTO_RESERVED_SUBDOMAINS, WASTO_SECTIONS, WASTO_SECTION_BY_KEY, WEEKDAYS, WEEKDAY_INDEX, WEEKDAY_LABELS_FR, WEEKDAY_LABELS_FR_SHORT, WEEKDAY_REF_DATES, WastoApiError, type WastoClient, type WastoClientConfig, type WastoRequestErrorContext, type WastoSectionDefinition, type Weekday, type WeeklyHoursRow, addDaysToIsoDate, adjustCostPerBadTonneForTgap, allocateSavingsByAction, applyCiteoDomMultiplier, applyStackedErrorReductions, buildBauVsRealSeries, buildPaginationMeta, computeActionImpactConfidence, computeGec, computeOverallConfidence, computePenetrationRate, computeRoiIndicators, convertLocalToUtc, convertUtcToLocal, createEmptyLocalRules, createEmptyOpeningHours, createWastoClient, currentFiscalYear, dashboardAppKeyFromLandingHost, dashboardAppKeyToSlug, dashboardAppSlugToKey, detectDomTerritory, estimateHouseholds, formatOpeningHoursSummary, formatOpeningHoursWeekly, formatTimeDisplay, formatTimeMinutes, formatWeeklyRow, getBrowserTimeZone, getFreeTierLimit, getFreeTierMediaBytesLimit, getTgapEurPerTonne, getTimezoneOffsetMinutes, isActionCountedInRoi, isDashboardAppLandingHost, isDomInseeCode, isFreeSelfServeAppAccess, isFreeTierFeatureEnabled, isOpenNow, localDateTimeToUtc, localRulesFromRange, nextWeekday, normalizeDashboardAppSlug, openNowLabel, parseTimeMinutes, refDateForWeekday, resolveDashboardAppLandingUrl, resolveEnabledDashboardAppSlugs, resolveHoursDisplay, resolveHoursMode, resolveHoursModeFromPoint, resolveHoursText, resolveOpeningHoursLocal, resolveOpeningHoursUtc, resolveWastoLandingsIndexUrl, roundEuro, simulateTerritory100kExample, slotsOverlap, sortSlots, utcDateIso, utcHhmmFromDate, validateLocalOpeningHours, validateOpeningHours, weekdayFromUtcDate };