@carlonicora/nextjs-jsonapi 1.108.0 → 1.109.0

package/dist/{chunk-N3NVIPSU.mjs → chunk-MSNNAHDB.mjs}

@@ -5256,6 +5256,7 @@ var HowTo = class extends Content {
   }
   _description;
   _pages;
+  _helpContentSlug;
   /**
    * Parse pages from backend JSON string (handles legacy single string + JSON array)
    */
@@ -5281,10 +5282,25 @@ var HowTo = class extends Content {
   get pages() {
     return this._pages;
   }
+  get helpContentSlug() {
+    return this._helpContentSlug;
+  }
   rehydrate(data) {
     super.rehydrate(data);
-    this._description = data.jsonApi.attributes.description ? JSON.parse(data.jsonApi.attributes.description) : void 0;
+    const rawDescription = data.jsonApi.attributes.description;
+    if (rawDescription === void 0 || rawDescription === null || rawDescription === "") {
+      this._description = void 0;
+    } else if (typeof rawDescription === "string") {
+      try {
+        this._description = JSON.parse(rawDescription);
+      } catch {
+        this._description = rawDescription;
+      }
+    } else {
+      this._description = rawDescription;
+    }
     this._pages = data.jsonApi.attributes.pages;
+    this._helpContentSlug = data.jsonApi.attributes.helpContentSlug;
     return this;
   }
   createJsonApi(data) {
@@ -5314,7 +5330,7 @@ var HowToModule = /* @__PURE__ */ __name((factory) => factory({
   icon: LifeBuoyIcon,
   inclusions: {
     lists: {
-      fields: [createJsonApiInclusion("howtos", [`name`, `description`, `pages`])]
+      fields: [createJsonApiInclusion("howtos", [`name`, `description`, `pages`, `helpContentSlug`])]
     }
   }
 }), "HowToModule");
@@ -5410,7 +5426,9 @@ var Assistant = class extends AbstractApiData {
         type: Modules.Assistant.name,
         attributes: {
           content: data.firstMessage,
-          ...data.title !== void 0 ? { title: data.title } : {}
+          ...data.title !== void 0 ? { title: data.title } : {},
+          ...data.howToMode !== void 0 ? { howToMode: data.howToMode } : {},
+          ...data.limitToHowToId !== void 0 ? { limitToHowToId: data.limitToHowToId } : {}
         }
       },
       included: []
@@ -5433,83 +5451,8 @@ var AssistantModule = /* @__PURE__ */ __name((factory) => factory({
   }
 }), "AssistantModule");
 
-// src/features/assistant/data/AssistantService.ts
-var AssistantService = class extends AbstractService {
-  static {
-    __name(this, "AssistantService");
-  }
-  static async findOne(params) {
-    return this.callApi({
-      type: Modules.Assistant,
-      method: "GET" /* GET */,
-      endpoint: new EndpointCreator({ endpoint: Modules.Assistant, id: params.id }).generate()
-    });
-  }
-  static async findMany(params = {}) {
-    const endpoint = new EndpointCreator({ endpoint: Modules.Assistant });
-    if (params.fetchAll) endpoint.addAdditionalParam("fetchAll", "true");
-    return this.callApi({
-      type: Modules.Assistant,
-      method: "GET" /* GET */,
-      endpoint: endpoint.generate()
-    });
-  }
-  static async create(params) {
-    return this.callApi({
-      type: Modules.Assistant,
-      method: "POST" /* POST */,
-      endpoint: new EndpointCreator({ endpoint: Modules.Assistant }).generate(),
-      input: params
-    });
-  }
-  /**
-   * Sends a new user message to an existing assistant thread. The agent turn
-   * runs synchronously; the response is a two-element list: [user, assistant].
-   */
-  static async appendMessage(params) {
-    return this.callApi({
-      type: Modules.AssistantMessage,
-      method: "POST" /* POST */,
-      endpoint: new EndpointCreator({
-        endpoint: Modules.Assistant,
-        id: params.assistantId,
-        childEndpoint: Modules.AssistantMessage
-      }).generate(),
-      input: {
-        data: {
-          type: Modules.AssistantMessage.name,
-          attributes: { content: params.content }
-        }
-      },
-      overridesJsonApiCreation: true
-    });
-  }
-  static async rename(params) {
-    await this.callApi({
-      type: Modules.Assistant,
-      method: "PATCH" /* PATCH */,
-      endpoint: new EndpointCreator({ endpoint: Modules.Assistant, id: params.id }).generate(),
-      input: {
-        data: {
-          type: Modules.Assistant.name,
-          id: params.id,
-          attributes: { title: params.title }
-        }
-      },
-      overridesJsonApiCreation: true
-    });
-  }
-  static async delete(params) {
-    await this.callApi({
-      type: Modules.Assistant,
-      method: "DELETE" /* DELETE */,
-      endpoint: new EndpointCreator({ endpoint: Modules.Assistant, id: params.id }).generate()
-    });
-  }
-};
-
-// src/features/assistant-message/AssistantMessageModule.ts
-import { MessageSquareIcon } from "lucide-react";
+// src/features/assistant-message/data/AssistantMessage.ts
+import { v4 as uuidv4 } from "uuid";
 
 // src/features/assistant/utils/resolveReferenceableModules.ts
 function resolveReferenceableModules() {
@@ -5533,6 +5476,7 @@ var AssistantMessage = class _AssistantMessage extends AbstractApiData {
   _outputTokens;
   _references;
   _citations;
+  _isOptimistic = false;
   get role() {
     return this._role ?? "assistant";
   }
@@ -5557,6 +5501,9 @@ var AssistantMessage = class _AssistantMessage extends AbstractApiData {
   get citations() {
     return this._citations ?? [];
   }
+  get isOptimistic() {
+    return this._isOptimistic;
+  }
   rehydrate(data) {
     super.rehydrate(data);
     const attrs = data.jsonApi.attributes ?? {};
@@ -5599,10 +5546,28 @@ var AssistantMessage = class _AssistantMessage extends AbstractApiData {
       included: []
     };
   }
+  /**
+   * JSON:API envelope for POST /assistants/:id/assistant-messages.
+   * Different from `createJsonApi` (which expects a full message with role/position/assistant ref);
+   * the append-to-thread endpoint derives those server-side, so we only send `content` and
+   * the optional retrieval-mode flags.
+   */
+  createAppendMessageJsonApi(params) {
+    return {
+      data: {
+        type: Modules.AssistantMessage.name,
+        attributes: {
+          content: params.content,
+          ...params.howToMode !== void 0 ? { howToMode: params.howToMode } : {},
+          ...params.limitToHowToId !== void 0 ? { limitToHowToId: params.limitToHowToId } : {}
+        }
+      }
+    };
+  }
   static buildOptimistic(params) {
     const msg = new _AssistantMessage();
     const jsonApi = {
-      id: `tmp-${crypto.randomUUID()}`,
+      id: uuidv4(),
       type: Modules.AssistantMessage.name,
       attributes: {
         role: "user",
@@ -5616,11 +5581,92 @@ var AssistantMessage = class _AssistantMessage extends AbstractApiData {
       };
     }
     msg.rehydrate({ jsonApi, included: [] });
+    msg._isOptimistic = true;
     return msg;
   }
 };
 
+// src/features/assistant/data/AssistantService.ts
+var AssistantService = class extends AbstractService {
+  static {
+    __name(this, "AssistantService");
+  }
+  static async findOne(params) {
+    return this.callApi({
+      type: Modules.Assistant,
+      method: "GET" /* GET */,
+      endpoint: new EndpointCreator({ endpoint: Modules.Assistant, id: params.id }).generate()
+    });
+  }
+  static async findMany(params = {}) {
+    const endpoint = new EndpointCreator({ endpoint: Modules.Assistant });
+    if (params.fetchAll) endpoint.addAdditionalParam("fetchAll", "true");
+    return this.callApi({
+      type: Modules.Assistant,
+      method: "GET" /* GET */,
+      endpoint: endpoint.generate()
+    });
+  }
+  static async create(params) {
+    return this.callApi({
+      type: Modules.Assistant,
+      method: "POST" /* POST */,
+      endpoint: new EndpointCreator({ endpoint: Modules.Assistant }).generate(),
+      input: params
+    });
+  }
+  /**
+   * Sends a new user message to an existing assistant thread. The agent turn
+   * runs synchronously; the response is a two-element list: [user, assistant].
+   *
+   * Uses the dedicated AssistantMessage.createAppendMessageJsonApi method to
+   * build the JSON:API envelope; this is the architecture-compliant pairing
+   * with `overridesJsonApiCreation: true`.
+   */
+  static async appendMessage(params) {
+    const message = new AssistantMessage();
+    return this.callApi({
+      type: Modules.AssistantMessage,
+      method: "POST" /* POST */,
+      endpoint: new EndpointCreator({
+        endpoint: Modules.Assistant,
+        id: params.assistantId,
+        childEndpoint: Modules.AssistantMessage
+      }).generate(),
+      input: message.createAppendMessageJsonApi({
+        content: params.content,
+        howToMode: params.howToMode,
+        limitToHowToId: params.limitToHowToId
+      }),
+      overridesJsonApiCreation: true
+    });
+  }
+  static async rename(params) {
+    await this.callApi({
+      type: Modules.Assistant,
+      method: "PATCH" /* PATCH */,
+      endpoint: new EndpointCreator({ endpoint: Modules.Assistant, id: params.id }).generate(),
+      input: {
+        data: {
+          type: Modules.Assistant.name,
+          id: params.id,
+          attributes: { title: params.title }
+        }
+      },
+      overridesJsonApiCreation: true
+    });
+  }
+  static async delete(params) {
+    await this.callApi({
+      type: Modules.Assistant,
+      method: "DELETE" /* DELETE */,
+      endpoint: new EndpointCreator({ endpoint: Modules.Assistant, id: params.id }).generate()
+    });
+  }
+};
+
 // src/features/assistant-message/AssistantMessageModule.ts
+import { MessageSquareIcon } from "lucide-react";
 var AssistantMessageModule = /* @__PURE__ */ __name((factory) => factory({
   pageUrl: "/assistant-messages",
   name: "assistant-messages",
@@ -7564,8 +7610,8 @@ export {
   HowToService,
   Assistant,
   AssistantModule,
-  AssistantService,
   AssistantMessage,
+  AssistantService,
   AssistantMessageModule,
   AssistantMessageService,
   Chunk,
@@ -7619,4 +7665,4 @@ export {
   AuditLogService,
   AuditLogModule
 };
-//# sourceMappingURL=chunk-N3NVIPSU.mjs.map
+//# sourceMappingURL=chunk-MSNNAHDB.mjs.map