@wasto/sdk 1.0.3

package/src/roi/index.ts

@@ -0,0 +1 @@
+export * from './calculations'

package/src/types/asset-bookings.types.ts

@@ -0,0 +1,19 @@
+import type { BookingStatus } from '../enums';
+
+export interface CreateAssetBookingRequest {
+  assetId: string;
+  startDate: string;
+  endDate?: string;
+  notes?: string;
+}
+
+export interface UpdateAssetBookingRequest {
+  startDate?: string;
+  endDate?: string;
+  status?: BookingStatus;
+  notes?: string;
+}
+
+export interface CancelAssetBookingRequest {
+  reason?: string;
+}

package/src/types/asset-interventions.types.ts

@@ -0,0 +1,24 @@
+import type { InterventionStatus, InterventionType } from '../enums';
+
+export interface CreateAssetInterventionRequest {
+  assetId?: string;
+  type: InterventionType;
+  plannedStart: string;
+  plannedEnd: string;
+  title?: string;
+  description?: string;
+  assigneeId?: string;
+  notes?: string;
+}
+
+export interface UpdateAssetInterventionRequest {
+  assetId?: string;
+  type?: InterventionType;
+  status?: InterventionStatus;
+  plannedStart?: string;
+  plannedEnd?: string;
+  title?: string;
+  description?: string;
+  assigneeId?: string;
+  notes?: string;
+}

package/src/types/assets.types.ts

@@ -0,0 +1,68 @@
+import type { AssetEventType, AssetStatus, AssetType } from '../enums';
+
+export 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;
+}
+
+export 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;
+}
+
+export interface CreateAssetEventRequest {
+  eventType: AssetEventType;
+  title: string;
+  description?: string;
+  latitude?: number;
+  longitude?: number;
+  metadata?: Record<string, unknown>;
+}
+
+export interface UpdateAssetStatusRequest {
+  status: AssetStatus;
+  latitude?: number;
+  longitude?: number;
+  notes?: string;
+}
+
+export interface CreateAssetConsumptionRecordRequest {
+  periodStart: string;
+  periodEnd: string;
+  value: number;
+  unit: string;
+  source: 'IOT' | 'MANUAL';
+  metadata?: Record<string, unknown>;
+}

package/src/types/auth.types.ts

@@ -0,0 +1,37 @@
+export interface LoginRequest {
+  email: string;
+  password: string;
+}
+
+export interface RegisterRequest {
+  email: string;
+  password: string;
+  firstName?: string;
+  lastName?: string;
+}
+
+export interface ForgotPasswordRequest {
+  email: string;
+}
+
+export interface ResetPasswordRequest {
+  token: string;
+  password: string;
+}
+
+export interface AcceptInviteRequest {
+  token: string;
+  password: string;
+  firstName?: string;
+  lastName?: string;
+}
+
+export interface LoginResponse {
+  access_token: string;
+  user?: unknown;
+}
+
+export interface LoginTwoFactorChallenge {
+  requiresTwoFactor: true;
+  pendingToken: string;
+}

package/src/types/blog-posts.types.ts

@@ -0,0 +1,19 @@
+export interface CreateBlogPostRequest {
+  cityGroupId: string;
+  title: string;
+  content: string;
+  published?: boolean;
+  publishedAt?: string;
+  /** ID d’un média CMS (image de couverture) */
+  coverMediaId?: string | null;
+}
+
+export 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;
+}

package/src/types/calendar-pdf.types.ts

@@ -0,0 +1,24 @@
+export interface CalendarPdfSector {
+  id: string;
+  name: string;
+  label: string | null;
+  cityId: string;
+  cityName: string;
+}
+
+export interface StreetSectorMatch {
+  streetId: string;
+  streetName: string;
+  cityId: string;
+  cityName: string;
+  sectors: CalendarPdfSector[];
+}
+
+export interface SearchStreetSectorsQuery {
+  q: string;
+  cityGroupId?: string;
+}
+
+export interface SearchStreetSectorsResponse {
+  data: StreetSectorMatch[];
+}

package/src/types/calendo-events.types.ts

@@ -0,0 +1,64 @@
+import type {
+  CalendoEventStatus,
+  CalendoEventType,
+  CalendoTicketSaleStatus,
+} from '../enums';
+
+export 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;
+}
+
+export 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;
+}
+
+export interface CreateCalendoTicketSaleRequest {
+  quantity?: number;
+  purchaserName?: string;
+  purchaserEmail?: string;
+  notes?: string;
+}
+
+export interface UpdateCalendoTicketSaleRequest {
+  status?: CalendoTicketSaleStatus;
+  notes?: string;
+}
+
+export 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;
+  }>;
+}

package/src/types/challenges.types.ts

@@ -0,0 +1,30 @@
+export interface CreateChallengeRequest {
+  name: string;
+  description?: string;
+  cityId?: string;
+  imageUrl?: string;
+  imageBase64?: string;
+  enabled?: boolean;
+  startDate?: string;
+  endDate?: string;
+  order?: number;
+  requiredChallengeId?: string;
+}
+
+export interface CreateSerieRequest {
+  challengeId: string;
+  name: string;
+  description?: string;
+  imageUrl?: string;
+  imageBase64?: string;
+  order?: number;
+}
+
+export interface CreateBadgeRequest {
+  challengeId: string;
+  name: string;
+  description?: string;
+  imageUrl?: string;
+  imageBase64?: string;
+  icon?: string;
+}

package/src/types/chatbot.types.ts

@@ -0,0 +1,82 @@
+import type { ChatStatus } from '../enums';
+
+export interface CreateConversationRequest {
+  deviceId: string;
+  cityId?: string;
+  /** Scope collectivité entière (sans picker ville). */
+  cityGroupId?: string;
+}
+
+export interface SetConversationLocationRequest {
+  cityId: string;
+  placeId?: string;
+}
+
+export interface AssignConversationRequest {
+  agentId: string;
+}
+
+export interface UpdateConversationStatusRequest {
+  status: ChatStatus;
+}
+
+export 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). */
+export 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). */
+export 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;
+}
+
+export interface ChatLink {
+  id: string;
+  label: string;
+  url: string;
+}
+
+export interface ChatActionOption {
+  id: string;
+  label: string;
+  nextStep?: string;
+}
+
+export interface ChatAction {
+  type: 'action';
+  id: string;
+  message: string;
+  options: ChatActionOption[];
+}
+
+export interface ChatTextResponse {
+  type: 'text';
+  content: string;
+  links?: ChatLink[];
+  /** Fiches types de déchets du référentiel (affichage card UI). */
+  wasteTypes?: ChatWasteTypeFiche[];
+}
+
+export type ChatResponse = ChatTextResponse | ChatAction;
+

package/src/types/cities.types.ts

@@ -0,0 +1,27 @@
+import type { CityStatus } from '../enums';
+
+export interface CreateCityRequest {
+  name: string;
+  country: string;
+  population?: number;
+  status?: CityStatus;
+  outOfTheBins?: string;
+  presentationOfBins?: string;
+  returnOfBins?: string;
+  respectOfCalendar?: string;
+  holidays?: string;
+  logoMediaId?: string | null;
+}
+
+export interface UpdateCityRequest {
+  name?: string;
+  country?: string;
+  population?: number;
+  status?: CityStatus;
+  outOfTheBins?: string;
+  presentationOfBins?: string;
+  returnOfBins?: string;
+  respectOfCalendar?: string;
+  holidays?: string;
+  logoMediaId?: string | null;
+}

package/src/types/city-groups.types.ts

@@ -0,0 +1,46 @@
+import type { CityGroupType } from '../enums';
+import type { DashboardAppSlug } from '../dashboard-apps';
+
+export interface CreateCityGroupRequest {
+  name: string;
+  type: CityGroupType;
+  code?: string;
+  siren?: string;
+  cityIds?: string[];
+}
+
+export interface UpdateCityGroupRequest {
+  name?: string;
+  type?: CityGroupType;
+  code?: string;
+  siren?: string;
+  cityIds?: string[];
+}
+
+export interface CityGroupDashboardAppAccessItem {
+  slug: DashboardAppSlug;
+  key: string;
+  label: string;
+  dashboardPath: string;
+  isDevOnly?: boolean;
+  enabled: boolean;
+}
+
+export interface CityGroupDashboardAppsResponse {
+  cityGroupId: string;
+  apps: CityGroupDashboardAppAccessItem[];
+  /** Slugs activés (clés Prisma) — vide si configuration explicite absente côté API */
+  enabledSlugs: DashboardAppSlug[];
+}
+
+export interface SetCityGroupDashboardAppsRequest {
+  enabledSlugs: DashboardAppSlug[];
+}
+
+export interface AccessibleCityGroup {
+  id: string;
+  name: string;
+  type: CityGroupType;
+  code?: string | null;
+  enabledDashboardAppSlugs?: DashboardAppSlug[];
+}

package/src/types/cms.types.ts

@@ -0,0 +1,87 @@
+import type { CmsMenuLinkType, CmsSiteType } from '../enums';
+
+export interface CreateCmsSiteRequest {
+  name: string;
+  slug: string;
+  type?: CmsSiteType;
+  domain?: string;
+  cityGroupId?: string;
+  settings?: Record<string, unknown>;
+}
+
+export interface UpdateCmsSiteRequest {
+  name?: string;
+  slug?: string;
+  type?: CmsSiteType;
+  domain?: string;
+  cityGroupId?: string;
+  settings?: Record<string, unknown>;
+}
+
+export interface CreateCmsPageRequest {
+  siteId: string;
+  title: string;
+  slug: string;
+  path: string;
+  content: Record<string, unknown>;
+  published?: boolean;
+  publishedAt?: string;
+  seoMetadata?: Record<string, unknown>;
+  layoutId?: string;
+}
+
+export interface UpdateCmsPageRequest {
+  siteId?: string;
+  title?: string;
+  slug?: string;
+  path?: string;
+  content?: Record<string, unknown>;
+  published?: boolean;
+  publishedAt?: string;
+  seoMetadata?: Record<string, unknown>;
+  layoutId?: string;
+}
+
+export interface CreateCmsLayoutRequest {
+  siteId: string;
+  name: string;
+  description?: string;
+  type: CmsSiteType;
+  structure: Record<string, unknown>;
+  isDefault?: boolean;
+}
+
+export interface UpdateCmsLayoutRequest {
+  siteId?: string;
+  name?: string;
+  description?: string;
+  type?: CmsSiteType;
+  structure?: Record<string, unknown>;
+  isDefault?: boolean;
+}
+
+export interface CreateCmsMenuItemRequest {
+  label: string;
+  icon?: string;
+  order: number;
+  linkType: CmsMenuLinkType;
+  pageId?: string;
+  externalUrl?: string;
+  componentId?: string;
+  parentId?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface CreateCmsMenuRequest {
+  siteId: string;
+  name: string;
+  location?: string;
+  items?: CreateCmsMenuItemRequest[];
+}
+
+export interface UpdateCmsMenuRequest {
+  siteId?: string;
+  name?: string;
+  location?: string;
+  items?: CreateCmsMenuItemRequest[];
+}

package/src/types/field-reports.types.ts

@@ -0,0 +1,66 @@
+import type {
+  FieldReportFormStatus,
+  FieldReportStatus,
+  QuestionType,
+} from '../enums';
+
+export interface FieldReportValueRequest {
+  fieldId: string;
+  value: unknown;
+  photoUrl?: string;
+}
+
+export interface CreateFieldReportRequest {
+  formId: string;
+  values: FieldReportValueRequest[];
+  latitude?: number;
+  longitude?: number;
+  cityId?: string;
+  cityGroupId?: string;
+}
+
+export interface UpdateFieldReportRequest {
+  status?: FieldReportStatus;
+  assignedToId?: string | null;
+  values?: FieldReportValueRequest[];
+  latitude?: number;
+  longitude?: number;
+}
+
+export interface UpdateFieldReportStatusRequest {
+  status: FieldReportStatus;
+}
+
+export interface CreateFieldReportFieldRequest {
+  type: QuestionType;
+  label: string;
+  description?: string;
+  required?: boolean;
+  order?: number;
+  options?: unknown;
+  minValue?: number;
+  maxValue?: number;
+}
+
+export interface UpdateFieldReportFieldRequest
+  extends CreateFieldReportFieldRequest {
+  id?: string;
+}
+
+export interface CreateFieldReportFormRequest {
+  title: string;
+  description?: string;
+  status?: FieldReportFormStatus;
+  cityId?: string;
+  cityGroupId?: string;
+  fields?: CreateFieldReportFieldRequest[];
+}
+
+export interface UpdateFieldReportFormRequest {
+  title?: string;
+  description?: string;
+  status?: FieldReportFormStatus;
+  cityId?: string;
+  cityGroupId?: string;
+  fields?: UpdateFieldReportFieldRequest[];
+}

package/src/types/free-tier.types.ts

@@ -0,0 +1,54 @@
+/** Ressources soumises à un quota numérique en offre gratuite. */
+export type FreeTierResource =
+  | 'cmsApps'
+  | 'cmsPages'
+  | 'blogPosts'
+  | 'cmsMedia'
+  | 'wasteTypes'
+  | 'collectionPlaces'
+  | 'printCalendarTemplates';
+
+/** Fonctionnalités désactivées en offre gratuite (feature gate). */
+export type FreeTierFeature =
+  | 'challenges'
+  | 'roi'
+  | 'notifications'
+  | 'recyclingPoints'
+  | 'assets'
+  | 'nativeStorePublication'
+  | 'inviteMembers';
+
+export type FreeTierErrorCode = 'FREE_TIER_LIMIT' | 'FREE_TIER_FEATURE';
+
+export 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;
+};
+
+export type FreeTierFeatureItem = {
+  feature: FreeTierFeature;
+  enabled: boolean;
+};
+
+export type FreeTierUsageSnapshot = {
+  cityGroupId: string;
+  freeTier: boolean;
+  resources: FreeTierUsageItem[];
+  features: FreeTierFeatureItem[];
+};
+
+export type FreeTierErrorPayload = {
+  code: FreeTierErrorCode;
+  resource?: FreeTierResource;
+  feature?: FreeTierFeature;
+  used?: number;
+  limit?: number;
+  message: string;
+};

package/src/types/index.ts

@@ -0,0 +1,32 @@
+export * from './pagination.types';
+export * from './auth.types';
+export * from './users.types';
+export * from './cities.types';
+export * from './city-groups.types';
+export * from './waste-types.types';
+export * from './waste-collection-places.types';
+export * from './waste-collection-places-query.types';
+export * from './recycling-points.types';
+export * from './quiz-questions.types';
+export * from './cms.types';
+export * from './assets.types';
+export * from './asset-bookings.types';
+export * from './asset-interventions.types';
+export * from './challenges.types';
+export * from './blog-posts.types';
+export * from './notifications.types';
+export * from './providers.types';
+export * from './surveys.types';
+export * from './tickets.types';
+export * from './field-reports.types';
+export * from './calendo-events.types';
+
+export * from './mapso.types';
+export * from './operational-zones.types';
+export * from './maintenance.types';
+export * from './iot.types';
+export * from './chatbot.types';
+export * from './roi.types';
+export * from './calendar-pdf.types';
+export * from './onboarding.types';
+export * from './free-tier.types';