@communecter/cocolight-api-client 1.0.154 → 1.0.156

package/src/api/serverDataType/Comment.ts

@@ -1,88 +0,0 @@
-import type {
-  IdObject,
-  DateValue
-} from "./common.js";
-import type EJSONType from "../../EJSONType.js";
-import type { Organization } from "../Organization.js";
-import type { User } from "../User.js";
-
-type ObjectIDCtor = typeof EJSONType["ObjectID"];
-type ObjectID = InstanceType<ObjectIDCtor>;
-
-/**
- * Auteur d'un commentaire (version brute de l'API)
- */
-export interface CommentAuthorJson {
-  id: string;
-  name: string;
-  username?: string;
-  email?: string;
-  profilImageUrl?: string;
-  profilThumbImageUrl?: string;
-  typeSig?: string;
-  [k: string]: unknown;
-}
-
-/**
- * Auteur d'un commentaire (version normalisée côté client)
- */
-export interface CommentAuthor extends CommentAuthorJson {
-  type?: string;
-}
-
-/**
- * Vues d'un commentaire (qui a vu et quand)
- */
-export interface CommentViews {
-  [userId: string]: {
-    date: DateValue;
-    [k: string]: unknown;
-  };
-}
-
-/**
- * Structure JSON brute retournée par l'API
- */
-export interface CommentItemJson {
-  _id: IdObject;
-  collection: "comments";
-  contextId: string;
-  contextType: string;
-  parentId: string;
-  text: string;
-  created: DateValue;
-  author: CommentAuthorJson;
-  tags?: string[] | null;
-  status: string;
-  views?: CommentViews;
-  postedDate: number;
-  markdownActive: boolean;
-  argval?: string;
-  replies?: CommentItemJson[];
-  [key: string]: unknown;
-}
-
-/**
- * Structure normalisée utilisée côté client
- * Les dates sont converties en objets Date
- * Le champ author peut être une instance d'entité (User ou Organization)
- */
-export interface CommentItemNormalized {
-  id: string;
-  _id: ObjectID;
-  collection: "comments";
-  contextId: string;
-  contextType: string;
-  parentId: string;
-  text: string;
-  created: Date;
-  author: CommentAuthor | User | Organization;
-  tags?: string[] | null;
-  status: string;
-  views?: Record<string, { date: Date; [k: string]: unknown }>;
-  postedDate: number;
-  markdownActive: boolean;
-  argval?: string;
-  replies?: CommentItemNormalized[];
-  [key: string]: unknown;
-}

package/src/api/serverDataType/Country.ts

@@ -1 +0,0 @@
-export type { ZoneItemNormalized as CountryItem } from "./Zone.js";

package/src/api/serverDataType/Event.ts

@@ -1,112 +0,0 @@
-import type {
-  GeoCoordinates,
-  GeoPosition,
-  IdObject,
-  LinkAttendeesRef,
-  LinkOrganizerRef,
-  ParentsMap,
-  OrganizerMap,
-  PostalAddress,
-  DateValue
-} from "./common.js";
-import type EJSONType from "../../EJSONType.js";
-
-type ObjectIDCtor = typeof EJSONType["ObjectID"];
-type ObjectID = InstanceType<ObjectIDCtor>;
-
-export interface EventLinksBlock {
-  attendees?: Record<string, LinkAttendeesRef>;
-  organizer?: Record<string, LinkOrganizerRef>;
-  [k: string]: unknown;
-}
-
-/**
- * Types d'événements supportés
- */
-export const EVENT_TYPES = [
-  "workshop",
-  "competition",
-  "concert",
-  "contest",
-  "conference",
-  "debate",
-  "exhibition",
-  "festival",
-  "crowdfunding",
-  "fair",
-  "course",
-  "protest",
-  "market",
-  "film",
-  "getTogether",
-  "meeting",
-  "spectacle",
-  "internship",
-  "stand",
-  "others",
-] as const;
-
-export type EventType = (typeof EVENT_TYPES)[number];
-
-export interface EventItemJson {
-  _id: IdObject;
-  collection: "events";
-  name: string;
-  type: EventType;
-  startDate: DateValue;
-  endDate: DateValue;
-  created?: DateValue;
-  updated?: DateValue;
-  modified?: DateValue;
-  parent?: ParentsMap;
-  description?: string;
-  shortDescription?: string;
-  slug?: string;
-  address?: PostalAddress;
-  geo?: GeoCoordinates;
-  geoPosition?: GeoPosition;
-  tags?: string[];
-  links?: EventLinksBlock;
-  organizer?: OrganizerMap;
-  creator?: string;
-  profilImageUrl?: string;
-  profilMediumImageUrl?: string;
-  profilThumbImageUrl?: string;
-  profilMarkerImageUrl?: string;
-  timeZone?: string;
-  email?: string;
-  url?: string;
-  [key: string]: unknown;
-}
-
-export interface EventItemNormalized {
-  id: string;
-  _id: ObjectID;
-  collection: "events";
-  name: string;
-  type: EventType;
-  startDate: Date;
-  endDate: Date;
-  created?: Date;
-  updated?: Date;
-  modified?: Date;
-  parent?: ParentsMap;
-  description?: string;
-  shortDescription?: string;
-  slug?: string;
-  address?: PostalAddress;
-  geo?: GeoCoordinates;
-  geoPosition?: GeoPosition;
-  tags?: string[];
-  links?: EventLinksBlock;
-  organizer?: OrganizerMap;
-  creator?: string;
-  profilImageUrl?: string;
-  profilMediumImageUrl?: string;
-  profilThumbImageUrl?: string;
-  profilMarkerImageUrl?: string;
-  timeZone?: string;
-  email?: string;
-  url?: string;
-  [key: string]: unknown;
-}

package/src/api/serverDataType/Form.ts

@@ -1,157 +0,0 @@
-import { DateValue, IdObject, ParentsMap } from "./common.js";
-
-import type EJSONType from "../../EJSONType.js";
-
-type ObjectIDCtor = typeof EJSONType["ObjectID"];
-type ObjectID = InstanceType<ObjectIDCtor>;
-
-export interface FormSubFormInputField {
-    label?: string;
-    placeholder?: string;
-    info?: string;
-    type?: string;
-    position?: string;
-    positions?: Record<string, string>;
-    width?: string;
-    markdown?: boolean;
-    uploader?: Record<string, any>;
-    rules?: {
-        width?: { min: number; max: number };
-        syntaxe?: { regexp: string; errormsg: string };
-        [key: string]: unknown;
-    };
-    [key: string]: unknown;
-}
-
-export interface FormSubFormInputs {
-    name: string;
-    info?: string;
-    id: string;
-    formParent: string;
-    hasMultiEval?: boolean;
-    inputs: Record<string, FormSubFormInputField>;
-    [key: string]: unknown;
-}
-
-/**
- * Bloc d'accès au Form — décrit qui peut répondre, quand, comment.
- * Renvoyé par `GET_COFORM_BY_ID` (cf. /survey/coform/getformbyid).
- */
-export interface FormAccess {
-    /** Si l'utilisateur courant peut répondre maintenant. */
-    canAnswer: boolean;
-    /** Raison si `canAnswer` est false (ex: "not_logged_in", "form_closed"). */
-    reason?: string;
-    /** État global du form (ex: "open", "closed", "pending"). */
-    formStatus?: string;
-    /** Id de la réponse existante de l'user courant (s'il en a une). */
-    existingAnswerId?: string | null;
-    /** Doc de la réponse existante (peut être enrichi). */
-    existingAnswer?: Record<string, unknown> | null;
-    /** Si le form requiert d'être connecté. */
-    requiresLogin?: boolean;
-    /** Réponse temporaire (brouillon) autorisée. */
-    allowTemporary?: boolean;
-    /** Réponse nécessite confirmation. */
-    withConfirmation?: boolean;
-    /** Réservé aux membres uniquement. */
-    isOnlyMember?: boolean;
-    /** Une seule réponse par personne. */
-    isOneAnswerPerPers?: boolean;
-    /** Form actif (vs désactivé). */
-    isActive?: boolean;
-    /** Fenêtres de dates (ouverture/fermeture, avec/sans confirmation). */
-    dates?: {
-        start?: string | null;
-        end?: string | null;
-        startNoConfirmation?: string | null;
-        endNoConfirmation?: string | null;
-    };
-    /** Liste des champs restreints (non visibles selon le rôle). */
-    restrictedFields?: string[];
-    [key: string]: unknown;
-}
-
-/**
- * Forme JSON brute du Form telle que renvoyée par `GET_COFORM_BY_ID`.
- *
- * ⚠️ Le champ `collection` n'est PAS présent dans le payload backend natif
- * (PHDB::find renvoie le doc brut sans nom de table). Il doit être injecté
- * côté SDK par `Form.get()` pour cohérence avec les autres entités.
- */
-export interface FormItemJson {
-    _id: IdObject;
-    id?: string;
-    /** Injecté côté SDK (le backend ne le renvoie pas). */
-    collection?: "forms";
-    /** Nom du Form (ex: "Coworking", "Hébergement"). */
-    name?: string;
-    /** Type du Form (ex: "coformgeneric", "template"). */
-    type: string;
-    config?: Record<string, unknown> | null;
-    parent?: ParentsMap | null;
-    subForms?: string[] | null;
-    created?: DateValue;
-    creator?: string;
-    params?: Record<string, unknown> | null;
-    updated?: DateValue;
-    inputs?: Record<string, FormSubFormInputs> | null;
-    /** Logique d'accès calculée côté backend pour l'user courant. */
-    access?: FormAccess;
-    /** Champs réservés aux admins du lieu/projet. */
-    placeAdminOnlyFields?: string[];
-    /** Champs réservés aux membres du lieu/projet. */
-    placeMemberOnlyFields?: string[];
-    /** Si le grand public peut éditer une réponse partagée. */
-    publicCanEditSharedAnswer?: boolean;
-    /** Path vers une question partagée (legacy / advanced usage). */
-    sharedQuestionPath?: Record<string, unknown> | null;
-    /** Utilise une image de bannière (présent surtout sur `type=template`). */
-    useBannerImg?: boolean;
-    [key: string]: unknown;
-}
-
-export interface FormItemNormalized {
-    id: string;
-    _id: ObjectID;
-    /** Injecté côté SDK (le backend ne le renvoie pas). */
-    collection?: "forms";
-    name?: string;
-    type: string;
-    config?: Record<string, unknown> | null;
-    parent?: ParentsMap | null;
-    subForms?: string[] | null;
-    created?: Date;
-    creator?: string;
-    params?: Record<string, unknown> | null;
-    updated?: Date;
-    inputs?: Record<string, FormSubFormInputs> | null;
-    access?: FormAccess;
-    placeAdminOnlyFields?: string[];
-    placeMemberOnlyFields?: string[];
-    publicCanEditSharedAnswer?: boolean;
-    sharedQuestionPath?: Record<string, unknown> | null;
-    useBannerImg?: boolean;
-    [key: string]: unknown;
-}
-
-/**
- * Une contribution individuelle à une table commune (commonTable) d'un coform.
- * Retournée par `Form.getCommonTableContributors()` (endpoint GET_COFORM_COMMONTABLE_CONTRIBUTORS).
- * Plusieurs entrées possibles pour un même `userId` (plusieurs solutions au même usage).
- */
-export interface CoformCommonTableContributor {
-  userId: string;
-  userName?: string;
-  userSlug?: string;
-  criteriaId: string;
-  /** Nom de la solution saisie. */
-  criteria: string;
-  /** love | happySmile | neutral | sad | cry | "" */
-  happiness?: string;
-  /** Note de 0 à 5. */
-  note?: number;
-  comment?: string;
-  fromAnswerId?: string;
-  [k: string]: unknown;
-}

package/src/api/serverDataType/News.ts

@@ -1,138 +0,0 @@
-import type {
-  IdObject,
-  DateValue,
-} from "./common.js";
-import type EJSONType from "../../EJSONType.js";
-import type { Organization } from "../Organization.js";
-import type { Project } from "../Project.js";
-import type { User } from "../User.js";
-
-type ObjectIDCtor = typeof EJSONType["ObjectID"];
-type ObjectID = InstanceType<ObjectIDCtor>;
-
-/**
- * Auteur d'une actualité
- */
-export interface NewsAuthor {
-  id: string;
-  name: string;
-  type: string;
-  profilThumbImageUrl?: string;
-  [k: string]: unknown;
-}
-
-/**
- * Personne ayant partagé l'actualité
- */
-export interface NewsSharedBy {
-  id: string;
-  name: string;
-  type: string;
-  updated: DateValue;
-  comment: string | null;
-  profilThumbImageUrl?: string;
-  [k: string]: unknown;
-}
-
-/**
- * Cible de l'actualité
- */
-export interface NewsTarget {
-  id: string;
-  name: string;
-  type: string;
-  profilThumbImageUrl?: string;
-  [k: string]: unknown;
-}
-
-/**
- * Mention dans une actualité
- */
-export interface NewsMention {
-  id: string;
-  slug: string;
-  type: string;
-  name: string;
-  value: string;
-  count: string; // API returns as string
-  [k: string]: unknown;
-}
-
-/**
- * Médias fichiers
- */
-export interface NewsMediaFile {
-  countFiles: string; // API returns as string
-  files: any[];
-}
-
-/**
- * Médias images
- */
-export interface NewsMediaImg {
-  countImages: string; // API returns as string
-  images: any[];
-}
-
-/**
- * Scope de l'actualité
- */
-export interface NewsScope {
-  type: string;
-  [k: string]: unknown;
-}
-
-/**
- * Structure JSON brute retournée par l'API
- */
-export interface NewsItemJson {
-  _id: IdObject;
-  id: string;
-  type: "news";
-  collection: "news";
-  text: string;
-  date: DateValue;
-  created: DateValue;
-  updated: DateValue;
-  markdownActive: boolean;
-  scope: NewsScope;
-  comment: string | null;
-  typeSig: "news";
-  author: NewsAuthor;
-  sharedBy: NewsSharedBy[];
-  lastAuthorShare: NewsSharedBy;
-  target: NewsTarget;
-  mediaFile: NewsMediaFile;
-  mediaImg: NewsMediaImg;
-  mentions?: NewsMention[];
-  [key: string]: unknown;
-}
-
-/**
- * Structure normalisée utilisée côté client
- * Les dates sont converties en objets Date
- * Les counts sont convertis en numbers
- * Les champs author, target, sharedBy peuvent être des instances d'entités
- */
-export interface NewsItemNormalized {
-  _id: ObjectID;
-  id: string;
-  type: "news";
-  collection: "news";
-  text: string;
-  date: Date;
-  created: Date;
-  updated: Date;
-  markdownActive: boolean;
-  scope: NewsScope;
-  comment: string | null;
-  typeSig: "news";
-  author: NewsAuthor | User | Organization;
-  sharedBy: Array<(Omit<NewsSharedBy, "updated"> & { updated: Date }) | User | Organization>;
-  lastAuthorShare: (Omit<NewsSharedBy, "updated"> & { updated: Date }) | User | Organization;
-  target: NewsTarget | User | Organization | Project;
-  mediaFile: NewsMediaFile;
-  mediaImg: NewsMediaImg;
-  mentions?: NewsMention[];
-  [key: string]: unknown;
-}

package/src/api/serverDataType/Notification.ts

@@ -1,81 +0,0 @@
-import type { DateValue, IdObject } from "./common.js";
-import type EJSONType from "../../EJSONType.js";
-
-// L'_id peut arriver sous 3 formes selon le chemin d'appel :
-//  - instance ObjectID (transform + _fromJSONValue actif — cas observé sur User.getNotifications)
-//  - { $id } (forme normalisée non-revivée)
-//  - string hex (24)
-type ObjectIDInstance = InstanceType<typeof EJSONType["ObjectID"]>;
-export type NotificationId = ObjectIDInstance | IdObject | string;
-
-/** Auteur APRÈS aplatissement par _transformData (la map oid->objet devient un objet). */
-export interface NotificationAuthor {
-  id?: string;
-  type?: string;
-  name: string;
-  profilThumbImageUrl?: string; // complété en URL absolue par la normalisation image
-  [k: string]: unknown;
-}
-
-export interface NotificationTarget {
-  type: string;
-  id: string;
-  parent?: { id: string; type: string };
-}
-
-/** État lu/vu, par destinataire. Un champ ABSENT (clé unset côté serveur) = état "faux". */
-export interface NotificationReadState {
-  isUnread?: boolean;
-  isUnseen?: boolean;
-}
-
-export interface NotificationNotify {
-  objectType?: string;
-  /** keyé par oid de destinataire -> état lu/vu de CE destinataire. */
-  id: Record<string, NotificationReadState>;
-  displayName?: string;
-  icon?: string;
-  url?: string;
-  label?: string;
-  labelArray?: Record<string, string[]>;
-  labelAuthorObject?: string;
-  repeat?: boolean;
-  [k: string]: unknown;
-}
-
-/** Un élément du tableau `notif` (forme transformée). created/updated : Date instance OU {sec,usec}. */
-export interface NotificationItemData {
-  id: string;                 // injecté depuis la clé de la map notif (= oid hex)
-  _id: NotificationId;
-  type: string;
-  verb: string;
-  author: NotificationAuthor;
-  created: Date | DateValue;
-  updated: Date | DateValue;
-  target: NotificationTarget;
-  notify: NotificationNotify;
-  timestamp?: number;         // ajouté serveur (= updated.sec)
-  timeAgo?: string;           // présent en brut, retiré au transform
-  [k: string]: unknown;
-}
-
-/**
- * Réponse de GET_NOTIFICATIONS (mode liste, body indexMin) APRÈS transform :
- * `notif` est un tableau (la map oid->item est convertie). Vide => [].
- */
-export interface GetNotificationsResult {
-  notif: NotificationItemData[];
-  [k: string]: unknown;
-}
-
-/**
- * Réponse de GET_NOTIFICATIONS_COUNT (mode badge, body refreshTimestamp non-nul) :
- * `notif` = notifications mises à jour APRÈS le timestamp (souvent [] si timestamp = maintenant),
- * `countNotif` = nombre TOTAL de notifications NON VUES (isUnseen) — indépendant du timestamp.
- * countNotif n'est présent QUE si refreshTimestamp est fourni et non-nul (sinon mode liste).
- */
-export interface GetNotificationsCountResult {
-  notif: NotificationItemData[];
-  countNotif?: number;
-  [k: string]: unknown;
-}

package/src/api/serverDataType/Organization.ts

@@ -1,111 +0,0 @@
-import type { AnswerDocsByFormId, AnswersByFormId } from "./Answer.js";
-import type {
-  GeoCoordinates,
-  GeoPosition,
-  IdObject,
-  LinkMemberOfRef,
-  LinkMemberRef,
-  LinkProjectRef,
-  LinkEventsRef,
-  OpeningHoursEntry,
-  ParentsMap,
-  PostalAddress,
-  DateValue,
-  SocialNetwork
-} from "./common.js";
-import type EJSONType from "../../EJSONType.js";
-
-type ObjectIDCtor = typeof EJSONType["ObjectID"];
-type ObjectID = InstanceType<ObjectIDCtor>;
-
-export interface OrganizationLinksBlock {
-  members?: Record<string, LinkMemberRef>;
-  projects?: Record<string, LinkProjectRef>;
-  memberOf?: Record<string, LinkMemberOfRef>;
-  events?: Record<string, LinkEventsRef>;
-  [k: string]: unknown;
-}
-
-/**
- * Types d'organisations supportés
- */
-export const ORGANIZATION_TYPES = [
-  "NGO",
-  "LocalBusiness",
-  "Group",
-  "GovernmentOrganization",
-  "Cooperative",
-] as const;
-
-export type OrganizationType = (typeof ORGANIZATION_TYPES)[number];
-
-export interface OrganizationItemJson {
-  _id: IdObject;
-  collection: "organizations";
-  name: string;
-  created?: DateValue;
-  updated?: DateValue;
-  modified?: DateValue;
-  parent?: ParentsMap;
-  description?: string;
-  shortDescription?: string;
-  slug?: string;
-  type?: OrganizationType;
-  address?: PostalAddress;
-  geo?: GeoCoordinates;
-  geoPosition?: GeoPosition;
-  tags?: string[];
-  links?: OrganizationLinksBlock;
-  creator?: string;
-  openingHours?: OpeningHoursEntry[];
-  profilImageUrl?: string;
-  profilMediumImageUrl?: string;
-  profilThumbImageUrl?: string;
-  profilMarkerImageUrl?: string;
-  email?: string;
-  url?: string;
-  socialNetwork?: SocialNetwork;
-  /**
-   * Enrichissement par les Answers liées au résultat — renvoyé uniquement par
-   * `/costum/navigator/gettl` (variant `navigator-tl` de `searchCostum`).
-   * Forme JSON brute (avant linkage par `_transformServerData`).
-   */
-  answers?: AnswerDocsByFormId;
-  [key: string]: unknown;
-}
-
-export interface OrganizationItemNormalized {
-  id: string;
-  _id: ObjectID;
-  collection: "organizations";
-  name: string;
-  created?: Date;
-  updated?: Date;
-  modified?: Date;
-  parent?: ParentsMap;
-  description?: string;
-  shortDescription?: string;
-  slug?: string;
-  type?: OrganizationType;
-  address?: PostalAddress;
-  geo?: GeoCoordinates;
-  geoPosition?: GeoPosition;
-  tags?: string[];
-  links?: OrganizationLinksBlock;
-  creator?: string;
-  openingHours?: OpeningHoursEntry[];
-  profilImageUrl?: string;
-  profilMediumImageUrl?: string;
-  profilThumbImageUrl?: string;
-  profilMarkerImageUrl?: string;
-  email?: string;
-  url?: string;
-  socialNetwork?: SocialNetwork;
-  /**
-   * Enrichissement par les Answers liées au résultat — renvoyé uniquement par
-   * `/costum/navigator/gettl` (variant `navigator-tl` de `searchCostum`).
-   * Forme normalisée (après linkage par `Organization._transformServerData`) : `Answer[]` par formId.
-   */
-  answers?: AnswersByFormId;
-  [key: string]: unknown;
-}