@communecter/cocolight-api-client 1.0.150 → 1.0.152

package/src/api/EndpointApi.types.ts

@@ -2782,7 +2782,7 @@ export interface AddOrganizationData {
    * Rôle principal de l’organisation
    */
   role: "admin" | "member";
-  tags?: string[];
+  tags?: "" | string[];
   /**
    * Email de l’organisation
    */
@@ -2806,35 +2806,33 @@ export interface AddOrganizationData {
     isOpenEdition: boolean;
     [k: string]: unknown;
   };
-  /**
-   * Coordonnées géographiques
-   */
-  geo?: {
-    "@type"?: "GeoCoordinates";
-    latitude: string | number;
-    longitude: string | number;
-  };
-  /**
-   * Position géographique GeoJSON
-   */
-  geoPosition?: {
-    /**
-     * Type GeoJSON (doit être 'Point')
-     */
-    type: "Point";
-    /**
-     * Tableau contenant [longitude, latitude]
-     *
-     * @minItems 2
-     * @maxItems 2
-     */
-    coordinates: [number, number];
-    /**
-     * Indicateur pour forcer la conversion en float côté serveur
-     */
-    float: true;
-    [k: string]: unknown;
-  };
+  geo?:
+    | ""
+    | {
+        "@type"?: "GeoCoordinates";
+        latitude: string | number;
+        longitude: string | number;
+      };
+  geoPosition?:
+    | ""
+    | {
+        /**
+         * Type GeoJSON (doit être 'Point')
+         */
+        type: "Point";
+        /**
+         * Tableau contenant [longitude, latitude]
+         *
+         * @minItems 2
+         * @maxItems 2
+         */
+        coordinates: [number, number];
+        /**
+         * Indicateur pour forcer la conversion en float côté serveur
+         */
+        float?: true;
+        [k: string]: unknown;
+      };
   /**
    * Thématiques de l’organisation
    */
@@ -2849,33 +2847,35 @@ export interface AddOrganizationData {
       tags: string[];
     };
   };
-  address?: {
-    "@type": "PostalAddress";
-    addressCountry: string;
-    codeInsee: string;
-    addressLocality: string;
-    localityId: string;
-    level1: string;
-    level1Name: string;
-    /**
-     * ID du département. Peut être vide pour les pays étrangers.
-     */
-    level3?: string;
-    /**
-     * Nom du département. Peut être vide pour les pays étrangers.
-     */
-    level3Name?: string;
-    /**
-     * ID de la commune. Peut être vide pour les pays étrangers.
-     */
-    level4?: string;
-    /**
-     * Nom de la commune. Peut être vide pour les pays étrangers.
-     */
-    level4Name?: string;
-    postalCode?: string;
-    streetAddress?: string;
-  };
+  address?:
+    | ""
+    | {
+        "@type": "PostalAddress";
+        addressCountry: string;
+        codeInsee: string;
+        addressLocality: string;
+        localityId: string;
+        level1: string;
+        level1Name: string;
+        /**
+         * ID du département. Peut être vide pour les pays étrangers.
+         */
+        level3?: string;
+        /**
+         * Nom du département. Peut être vide pour les pays étrangers.
+         */
+        level3Name?: string;
+        /**
+         * ID de la commune. Peut être vide pour les pays étrangers.
+         */
+        level4?: string;
+        /**
+         * Nom de la commune. Peut être vide pour les pays étrangers.
+         */
+        level4Name?: string;
+        postalCode?: string;
+        streetAddress?: string;
+      };
   scope: "";
   /**
    * Horaires d'ouverture (7 entrées, une par jour de la semaine ; "" pour un jour fermé). Doit rester synchronisé avec VIRTUAL_OPENING_HOURS dans Organization.ts.
@@ -3102,7 +3102,7 @@ export interface AddProjectData {
    * Visibilité (true/false)
    */
   public: boolean;
-  tags?: string[];
+  tags?: "" | string[];
   /**
    * Description courte
    */
@@ -3126,62 +3126,62 @@ export interface AddProjectData {
     crowdfunding?: boolean;
     [k: string]: unknown;
   };
-  /**
-   * Coordonnées géographiques
-   */
-  geo?: {
-    "@type"?: "GeoCoordinates";
-    latitude: string | number;
-    longitude: string | number;
-  };
-  /**
-   * Position géographique GeoJSON
-   */
-  geoPosition?: {
-    /**
-     * Type GeoJSON (doit être 'Point')
-     */
-    type: "Point";
-    /**
-     * Tableau contenant [longitude, latitude]
-     *
-     * @minItems 2
-     * @maxItems 2
-     */
-    coordinates: [number, number];
-    /**
-     * Indicateur pour forcer la conversion en float côté serveur
-     */
-    float: true;
-    [k: string]: unknown;
-  };
-  address?: {
-    "@type": "PostalAddress";
-    addressCountry: string;
-    codeInsee: string;
-    addressLocality: string;
-    localityId: string;
-    level1: string;
-    level1Name: string;
-    /**
-     * ID du département. Peut être vide pour les pays étrangers.
-     */
-    level3?: string;
-    /**
-     * Nom du département. Peut être vide pour les pays étrangers.
-     */
-    level3Name?: string;
-    /**
-     * ID de la commune. Peut être vide pour les pays étrangers.
-     */
-    level4?: string;
-    /**
-     * Nom de la commune. Peut être vide pour les pays étrangers.
-     */
-    level4Name?: string;
-    postalCode?: string;
-    streetAddress?: string;
-  };
+  geo?:
+    | ""
+    | {
+        "@type"?: "GeoCoordinates";
+        latitude: string | number;
+        longitude: string | number;
+      };
+  geoPosition?:
+    | ""
+    | {
+        /**
+         * Type GeoJSON (doit être 'Point')
+         */
+        type: "Point";
+        /**
+         * Tableau contenant [longitude, latitude]
+         *
+         * @minItems 2
+         * @maxItems 2
+         */
+        coordinates: [number, number];
+        /**
+         * Indicateur pour forcer la conversion en float côté serveur
+         */
+        float?: true;
+        [k: string]: unknown;
+      };
+  address?:
+    | ""
+    | {
+        "@type": "PostalAddress";
+        addressCountry: string;
+        codeInsee: string;
+        addressLocality: string;
+        localityId: string;
+        level1: string;
+        level1Name: string;
+        /**
+         * ID du département. Peut être vide pour les pays étrangers.
+         */
+        level3?: string;
+        /**
+         * Nom du département. Peut être vide pour les pays étrangers.
+         */
+        level3Name?: string;
+        /**
+         * ID de la commune. Peut être vide pour les pays étrangers.
+         */
+        level4?: string;
+        /**
+         * Nom de la commune. Peut être vide pour les pays étrangers.
+         */
+        level4Name?: string;
+        postalCode?: string;
+        streetAddress?: string;
+      };
   scope: "";
   [k: string]: unknown;
 }
@@ -3261,67 +3261,67 @@ export interface AddPoiData {
    * Description
    */
   description?: string;
-  tags?: string[];
+  tags?: "" | string[];
   /**
    * URLs externes associées
    */
   urls?: string[];
-  /**
-   * Coordonnées géographiques
-   */
-  geo?: {
-    "@type"?: "GeoCoordinates";
-    latitude: string | number;
-    longitude: string | number;
-  };
-  /**
-   * Position géographique GeoJSON
-   */
-  geoPosition?: {
-    /**
-     * Type GeoJSON (doit être 'Point')
-     */
-    type: "Point";
-    /**
-     * Tableau contenant [longitude, latitude]
-     *
-     * @minItems 2
-     * @maxItems 2
-     */
-    coordinates: [number, number];
-    /**
-     * Indicateur pour forcer la conversion en float côté serveur
-     */
-    float: true;
-    [k: string]: unknown;
-  };
-  address?: {
-    "@type": "PostalAddress";
-    addressCountry: string;
-    codeInsee: string;
-    addressLocality: string;
-    localityId: string;
-    level1: string;
-    level1Name: string;
-    /**
-     * ID du département. Peut être vide pour les pays étrangers.
-     */
-    level3?: string;
-    /**
-     * Nom du département. Peut être vide pour les pays étrangers.
-     */
-    level3Name?: string;
-    /**
-     * ID de la commune. Peut être vide pour les pays étrangers.
-     */
-    level4?: string;
-    /**
-     * Nom de la commune. Peut être vide pour les pays étrangers.
-     */
-    level4Name?: string;
-    postalCode?: string;
-    streetAddress?: string;
-  };
+  geo?:
+    | ""
+    | {
+        "@type"?: "GeoCoordinates";
+        latitude: string | number;
+        longitude: string | number;
+      };
+  geoPosition?:
+    | ""
+    | {
+        /**
+         * Type GeoJSON (doit être 'Point')
+         */
+        type: "Point";
+        /**
+         * Tableau contenant [longitude, latitude]
+         *
+         * @minItems 2
+         * @maxItems 2
+         */
+        coordinates: [number, number];
+        /**
+         * Indicateur pour forcer la conversion en float côté serveur
+         */
+        float?: true;
+        [k: string]: unknown;
+      };
+  address?:
+    | ""
+    | {
+        "@type": "PostalAddress";
+        addressCountry: string;
+        codeInsee: string;
+        addressLocality: string;
+        localityId: string;
+        level1: string;
+        level1Name: string;
+        /**
+         * ID du département. Peut être vide pour les pays étrangers.
+         */
+        level3?: string;
+        /**
+         * Nom du département. Peut être vide pour les pays étrangers.
+         */
+        level3Name?: string;
+        /**
+         * ID de la commune. Peut être vide pour les pays étrangers.
+         */
+        level4?: string;
+        /**
+         * Nom de la commune. Peut être vide pour les pays étrangers.
+         */
+        level4Name?: string;
+        postalCode?: string;
+        streetAddress?: string;
+      };
   scope?: "";
   [k: string]: unknown;
 }
@@ -3611,35 +3611,33 @@ export interface AddEventData {
         }
     )
   ];
-  /**
-   * Coordonnées géographiques
-   */
-  geo?: {
-    "@type"?: "GeoCoordinates";
-    latitude: string | number;
-    longitude: string | number;
-  };
-  /**
-   * Position géographique GeoJSON
-   */
-  geoPosition?: {
-    /**
-     * Type GeoJSON (doit être 'Point')
-     */
-    type: "Point";
-    /**
-     * Tableau contenant [longitude, latitude]
-     *
-     * @minItems 2
-     * @maxItems 2
-     */
-    coordinates: [number, number];
-    /**
-     * Indicateur pour forcer la conversion en float côté serveur
-     */
-    float: true;
-    [k: string]: unknown;
-  };
+  geo?:
+    | ""
+    | {
+        "@type"?: "GeoCoordinates";
+        latitude: string | number;
+        longitude: string | number;
+      };
+  geoPosition?:
+    | ""
+    | {
+        /**
+         * Type GeoJSON (doit être 'Point')
+         */
+        type: "Point";
+        /**
+         * Tableau contenant [longitude, latitude]
+         *
+         * @minItems 2
+         * @maxItems 2
+         */
+        coordinates: [number, number];
+        /**
+         * Indicateur pour forcer la conversion en float côté serveur
+         */
+        float?: true;
+        [k: string]: unknown;
+      };
   address?:
     | ""
     | {
@@ -4094,9 +4092,9 @@ export interface GetEventsData {
   countType?: unknown[];
   fediverse: boolean;
   /**
-   * Filtrer les événements récurrents (true/false)
+   * GARDE PARITÉ legacy (identique à SEARCH_EVENTS_COSTUM) : seule valeur autorisée `false` (= exclure les récurrents) OU champ omis (= inclure, défaut). NE JAMAIS envoyer `true` — le legacy teste STRICTEMENT $recurrency === true (AgendaAction.php:65) qui échoue sur la string POST → exclut les récurrents, alors que notre backend les inclurait (divergence assumée). En interdisant `true`, omis→inclus et false→exclus se comportent pareil sur les 2 serveurs.
    */
-  recurrency?: boolean;
+  recurrency?: false;
   filters?: {
     $or?: Record<string, unknown>;
     /**
@@ -4109,6 +4107,99 @@ export interface GetEventsData {
 }
 
 
+export interface SearchEventsCostumData {
+  searchType: "events"[];
+  indexMin: number;
+  indexStep: number;
+  /**
+   * Date de début (UTC)
+   */
+  startDateUTC?: string;
+  /**
+   * Date de fin (UTC)
+   */
+  endDateUTC?: string;
+  /**
+   * Nom ou terme
+   */
+  name?: string;
+  /**
+   * Type d’événement
+   */
+  type?:
+    | "workshop"
+    | "competition"
+    | "concert"
+    | "contest"
+    | "conference"
+    | "debate"
+    | "exhibition"
+    | "festival"
+    | "crowdfunding"
+    | "fair"
+    | "course"
+    | "protest"
+    | "market"
+    | "film"
+    | "getTogether"
+    | "meeting"
+    | "spectacle"
+    | "internship"
+    | "stand"
+    | "others";
+  /**
+   * Liste des localités ciblées
+   */
+  locality?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^[^\s]+$".
+     */
+    [k: string]: {
+      [k: string]: unknown;
+    };
+  };
+  count?: boolean;
+  countType?: unknown[];
+  fediverse: boolean;
+  /**
+   * GARDE PARITÉ legacy : seule valeur autorisée `false` (= exclure les récurrents) OU champ omis (= inclure, défaut). NE JAMAIS envoyer `true` — le legacy teste STRICTEMENT $recurrency === true (AgendaAction.php:65) qui échoue sur la string POST → exclut les récurrents, alors que notre backend les inclurait (divergence assumée). En interdisant `true`, omis→inclus et false→exclus se comportent pareil sur les 2 serveurs.
+   */
+  recurrency?: false;
+  /**
+   * Filtres Mongo additionnels (buildFilters).
+   */
+  filters?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Scope costum : events dont source.keys/reference.costum ∈ sourceKey (agenda multi-sites/réseau). Auto-injecté = [slug de l’entité] si absent.
+   */
+  sourceKey?: string[];
+  /**
+   * Filtre par tags ($in, ou $all via options.tags.verb).
+   */
+  searchTags?: string[];
+  /**
+   * Events liés (links.<type>.<id>).
+   */
+  links?: {
+    type: string;
+    id: string;
+    [k: string]: unknown;
+  }[];
+  subType?: string;
+  category?: string;
+  section?: string | string[];
+  contextId?: string;
+  contextType?: string;
+  costumSlug?: string;
+  costumId?: string;
+  costumType?: string;
+  [k: string]: unknown;
+}
+
+
 export interface ShareEventsData {
   /**
    * ID de l’événement à partager

package/src/api/User.ts

@@ -1,7 +1,7 @@
 import { ApiError } from "../error.js";
 import { BaseEntity } from "./BaseEntity.js";
 import { Notifications } from "./Notifications.js";
-import { resolveCostumScope, type CostumScope } from "../costum/runtime.js";
+import { resolveCostumScope, costumScopeFromEntity, type CostumScope } from "../costum/runtime.js";
 import { UserMixin } from "../mixin/UserMixin.js";
 import { createSocialTransform } from "../types/transforms.js";
 
@@ -733,10 +733,19 @@ export class User extends BaseEntity<UserItemNormalized> {
    * const org = await tl.organization({ name: "Mon TL", manageModel: "Association", buildingSurfaceArea: "120" });
    * await org.save();
    *
-   * @param slug - slug d'un costum connu (registry généré). Slug hors registry => erreur (live-fetch = inc2).
+   * Deux formes :
+   *  - `me.costum(slug)` : slug d'un costum du registry (autocomplété) OU n'importe quel slug (`string`) —
+   *    le backend reste l'autorité de validité (`found`). Slug hors registry sans champ → inc1b (résolution live).
+   *  - `me.costum(entity)` : ouvre un scope FIELDLESS depuis une entité DÉJÀ CHARGÉE (org/projet/event qui porte
+   *    un costum), zéro fetch — `source.key` = slug de l'entité. Cas « créer sous ce site nu ».
+   *
+   * @param arg - slug (`KnownCostumSlug | string`) OU une entité chargée porteuse d'un costum.
    */
-  async costum(slug: KnownCostumSlug): Promise<CostumScope> {
-    return resolveCostumScope(this, slug);
+  async costum(slug: KnownCostumSlug | (string & {})): Promise<CostumScope>;
+  async costum(entity: BaseEntity): Promise<CostumScope>;
+  async costum(arg: KnownCostumSlug | (string & {}) | BaseEntity): Promise<CostumScope> {
+    if (typeof arg === "string") return resolveCostumScope(this, arg);
+    return costumScopeFromEntity(this, arg);
   }
 
   /**

package/src/api/UserApi.ts

@@ -1,5 +1,4 @@
 import ApiClient from "../ApiClient.js";
-import { ApiError, ApiResponseError } from "../error.js";
 import { Action } from "./Action.js";
 import { Answer } from "./Answer.js";
 import { Badge } from "./Badge.js";
@@ -12,6 +11,8 @@ import { Organization } from "./Organization.js";
 import { Poi } from "./Poi.js";
 import { Project } from "./Project.js";
 import { User } from "./User.js";
+import { COSTUM_REQUEST_ENVELOPE } from "../costum/symbol.js";
+import { ApiError, ApiResponseError } from "../error.js";
 
 type AxiosResponse = import("axios").AxiosResponse;
 
@@ -105,14 +106,24 @@ export class UserApi {
    * @param params.username - Nom d'utilisateur.
    * @param params.email - Adresse email.
    * @param params.pwd - Mot de passe.
+   * @param params.costumSlug - (option) slug du costum de déploiement → estampille `source.key` du citoyen
+   *   côté backend (port Person::insert). `costumId`/`costumType` = entité porteuse (requis si le slug n'est
+   *   pas un doc `costum`, ex. un site porté par une org).
    * @returns Réponse brute de l'API.
    * @throws {ApiResponseError} Si l'API retourne un échec (`result === false`).
    */
-  async register({ name, username, email, pwd }: { name: string; username: string; email: string; pwd: string }): Promise<any> {
+  async register({ name, username, email, pwd, costumSlug, costumId, costumType }: { name: string; username: string; email: string; pwd: string; costumSlug?: string; costumId?: string; costumType?: string }): Promise<any> {
     return this.client.safeCall(async () => {
-      const response = await this.client.callEndpoint("PERSON_REGISTER", {
-        name, username, email, pwd
-      });
+      const data: Record<string, unknown> = { name, username, email, pwd };
+      // Contexte costum (déploiement) injecté via l'enveloppe (cf. element/save) : `callEndpoint` fusionne le
+      // `context` dans le body + relâche l'AJV. Le backend lit costumSlug/Id/Type → estampille `source` (origin/key/keys).
+      if (costumSlug) {
+        (data as Record<symbol, unknown>)[COSTUM_REQUEST_ENVELOPE] = {
+          properties: {},
+          context: { costumSlug, ...(costumId ? { costumId } : {}), ...(costumType ? { costumType } : {}) },
+        };
+      }
+      const response = await this.client.callEndpoint("PERSON_REGISTER", data);
 
       if (!isAxiosResponse(response)) {
         throw new ApiError("Requête mise en file (offline/circuit breaker)", 503, response);