@communecter/cocolight-api-client 1.0.150 → 1.0.152

package/src/costum/runtime.ts

@@ -19,6 +19,7 @@ import { COSTUM_RUNTIME } from "./runtime-map.js";
 
 import type { CostumExtensionModule, CostumExtensionField, KnownCostumSlug, Collection } from "./types.js";
 import type { BaseEntity } from "../api/BaseEntity.js";
+import type { GetElementsKeyResponse } from "../types/api-responses.js";
 
 /**
  * Contexte costum résolu, attaché à une instance d'entité via `config.costumCtx`.
@@ -99,13 +100,13 @@ type ScopeCollection = "poi" | "organizations" | "projects" | "events";
  * et n'altère jamais l'état partagé — chaque entité reçoit son propre `_costumCtx`.
  */
 export class CostumScope {
-  readonly slug: KnownCostumSlug;
+  readonly slug: KnownCostumSlug | (string & {});
   private readonly user: BaseEntity;
   private readonly module: CostumExtensionModule;
   private readonly costumId: string;
   private readonly costumType: string;
 
-  constructor(user: BaseEntity, slug: KnownCostumSlug, module: CostumExtensionModule, costumId: string, costumType: string) {
+  constructor(user: BaseEntity, slug: KnownCostumSlug | (string & {}), module: CostumExtensionModule, costumId: string, costumType: string) {
     this.user = user;
     this.slug = slug;
     this.module = module;
@@ -191,8 +192,23 @@ export class CostumScope {
 export function resolveCostumCtxFromSource(sourceKey: string | undefined | null, collection: Collection): CostumRuntimeContext | null {
   if (!sourceKey) return null;
   const entry = COSTUM_RUNTIME[sourceKey]?.[collection];
-  if (!entry) return null;
   const meta = COSTUM_META[sourceKey as KnownCostumSlug];
+  if (!entry) {
+    // Pas d'overlay de champs pour (sourceKey, collection). Si le costum est CONNU (meta présent), on
+    // reconnaît quand même le scope (source.key = identité) via un ctx NU (fields:[]) — l'élément est
+    // rattaché au costum sans champ spécifique. Costum hors registry → null (résolution live = inc1b).
+    if (!meta) return null;
+    return {
+      slug: sourceKey,
+      costumId: meta.costumId,
+      costumType: meta.costumType,
+      collection,
+      schema: { type: "object", additionalProperties: true, properties: {} },
+      fields: [],
+      presets: {},
+      hidden: [],
+    };
+  }
   const props = (entry.schema as { properties?: Record<string, unknown> }).properties ?? {};
   return {
     slug: sourceKey,
@@ -206,16 +222,53 @@ export function resolveCostumCtxFromSource(sourceKey: string | undefined | null,
   };
 }
 
+/** Module costum « nu » (scope d'IDENTITÉ sans overlay de champs) : `collections` vide → `create()` no-op. */
+function fieldlessModule(slug: string): CostumExtensionModule {
+  return { slug, collections: {} };
+}
+
+/**
+ * Ouvre un scope costum FIELDLESS depuis une entité DÉJÀ CHARGÉE (zéro fetch) : `costumSlug` = slug de
+ * l'entité (= `source.key` posé par le backend), `costumId/costumType` = l'entité porteuse. Pendant runtime
+ * exact de `_withCostumContext` (BaseEntity), pour la voie « entité tenue » (un site nu sans form). Le
+ * backend re-gate `found` sur l'existence d'un costum sur l'entité → un site sans costum n'estampille rien.
+ */
+export function costumScopeFromEntity(user: BaseEntity, entity: BaseEntity): CostumScope {
+  const sd = entity.serverData as { slug?: string | null; id?: string | null } | undefined;
+  const slug = sd?.slug;
+  const id = sd?.id;
+  if (typeof slug !== "string" || slug.trim() === "") {
+    throw new ApiError("me.costum(entity) : l'entité n'a pas de slug (charge-la d'abord).", 400);
+  }
+  if (typeof id !== "string" || !id) {
+    throw new ApiError("me.costum(entity) : l'entité n'a pas d'id.", 400);
+  }
+  return new CostumScope(user, slug, fieldlessModule(slug), id, entity.getEntityType());
+}
+
 /**
- * Résout un `CostumScope` pour un user connecté. Known-only (inc1) : charge le module généré
- * (code-split via dynamic import) + le meta du registry. Slug inconnu => erreur explicite.
+ * Résout un `CostumScope` par SLUG pour un user connecté.
+ *  - slug à champs (meta + loader) → charge le module généré (code-split via dynamic import).
+ *  - slug CONNU sans loader (fieldless) → scope d'identité nu (`collections:{}`).
+ *  - slug HORS registry → résolution LIVE via `slug/getinfo` (contextId/contextType) → scope nu (tier 3b).
  */
-export async function resolveCostumScope(user: BaseEntity, slug: KnownCostumSlug): Promise<CostumScope> {
-  const meta = COSTUM_META[slug];
-  const loader = COSTUM_SCHEMAS[slug];
-  if (!meta || !loader) {
-    throw new ApiError(`Costum inconnu : "${slug}". (Le live-fetch d'un costum hors registry n'est pas encore supporté.)`, 404);
+export async function resolveCostumScope(user: BaseEntity, slug: KnownCostumSlug | (string & {})): Promise<CostumScope> {
+  const meta = COSTUM_META[slug as KnownCostumSlug];
+  const loader = COSTUM_SCHEMAS[slug as KnownCostumSlug];
+  if (meta && loader) {
+    const { default: module } = await loader();
+    return new CostumScope(user, slug, module, meta.costumId, meta.costumType);
+  }
+  if (meta) {
+    // Connu mais sans overlay de champs : scope d'identité pur (estampille source.key, aucun champ costum).
+    return new CostumScope(user, slug, fieldlessModule(slug), meta.costumId, meta.costumType);
+  }
+  // Tier 3b — slug HORS registry : résolution LIVE slug → {contextId, contextType} via la route `slug/getinfo`
+  // (GET_ELEMENTS_KEY, « none »). Couvre les sites fieldless/cold/futurs sans rien bundler. costumSlug = le slug
+  // demandé (slug ENTITÉ) ; le backend re-gate `found` sur l'existence d'un costum sur l'entité résolue.
+  const info = await user.endpointApi.getElementsKey({ pathParams: { slug } }) as GetElementsKeyResponse;
+  if (info?.contextId && info?.contextType) {
+    return new CostumScope(user, slug, fieldlessModule(slug), String(info.contextId), String(info.contextType));
   }
-  const { default: module } = await loader();
-  return new CostumScope(user, slug, module, meta.costumId, meta.costumType);
+  throw new ApiError(`Costum inconnu : "${slug}" — slug introuvable (résolution live slug/getinfo).`, 404);
 }