@carlonicora/nextjs-jsonapi 3.12.0 → 3.13.0

package/src/features/how-to/components/index.ts

@@ -7,5 +7,6 @@ export { default as HowToDetails } from "./details/HowToDetails";
 export { default as HowToDeleter } from "./forms/HowToDeleter";
 export { default as HowToEditor } from "./forms/HowToEditor";
 export { default as HowToMultiSelector } from "./forms/HowToMultiSelector";
+export { default as HowToReindexButton } from "./forms/HowToReindexButton";
 export { default as HowToSelector } from "./forms/HowToSelector";
 export { default as HowToList } from "./lists/HowToList";

package/src/features/how-to/components/lists/HowToList.tsx

@@ -10,6 +10,7 @@ import { HowToInterface } from "../../data/HowToInterface";
 import { HowToService } from "../../data/HowToService";
 import "../../hooks/useHowToTableStructure";
 import HowToEditor from "../forms/HowToEditor";
+import HowToReindexButton from "../forms/HowToReindexButton";
 
 type HowToListProps = {
   fullWidth?: boolean;
@@ -24,7 +25,10 @@ export default function HowToList({ fullWidth }: HowToListProps) {
     retrieverParams: {},
   });
 
-  const functions: ReactNode[] = [<HowToEditor key="create-how-to" />];
+  const functions: ReactNode[] = [
+    <HowToReindexButton key="reindex-how-tos" refresh={data.refresh} />,
+    <HowToEditor key="create-how-to" />,
+  ];
 
   return (
     <ContentListTable

package/src/features/how-to/data/HowTo.spec.ts

@@ -11,16 +11,34 @@ const howToModule: ApiRequestDataTypeInterface = {
   model: HowTo,
 } as any;
 
+const userModule: ApiRequestDataTypeInterface = {
+  name: "users",
+  model: HowTo,
+} as any;
+
 beforeAll(() => {
   ModuleRegistry.register("HowTo", howToModule);
+  ModuleRegistry.register("User", userModule);
 });
 
+/** Collect every `id` value at any depth of a serialised payload. */
+function collectIds(value: any, ids: string[] = []): string[] {
+  if (Array.isArray(value)) {
+    for (const item of value) collectIds(item, ids);
+  } else if (value && typeof value === "object") {
+    for (const [key, child] of Object.entries(value)) {
+      if (key === "id") ids.push(child as string);
+      else collectIds(child, ids);
+    }
+  }
+  return ids;
+}
+
 describe("HowTo.createJsonApi", () => {
   it("serialises the new attributes", () => {
     const res = new HowTo().createJsonApi({
       id: "11111111-1111-4111-8111-111111111111",
       name: "Add an NPC",
-      authorId: "",
       description: [{ type: "paragraph", content: [] }],
       howToType: "how-to",
       slug: "add-an-npc",
@@ -40,4 +58,46 @@ describe("HowTo.createJsonApi", () => {
     expect(a.draft).toBe(false);
     expect(typeof a.description).toBe("string"); // existing: BlockNote JSON stringified
   });
+
+  it("emits no author relationship when the how-to has no author", () => {
+    // The backend HowTo descriptor declares `relationships: {}` — a how-to has no
+    // author on the wire, so the editor must not invent one.
+    const res = new HowTo().createJsonApi({
+      id: "11111111-1111-4111-8111-111111111111",
+      name: "Add an NPC",
+      description: [{ type: "paragraph", content: [] }],
+    });
+
+    expect(res.data.relationships).toEqual({});
+    expect(res.data.relationships.author).toBeUndefined();
+    expect("author" in res.data.relationships).toBe(false);
+  });
+
+  it("emits no empty-string id anywhere in the payload", () => {
+    const res = new HowTo().createJsonApi({
+      id: "11111111-1111-4111-8111-111111111111",
+      name: "Add an NPC",
+      description: [{ type: "paragraph", content: [] }],
+    });
+
+    const ids = collectIds(res);
+    expect(ids).toEqual(["11111111-1111-4111-8111-111111111111"]);
+    expect(ids).not.toContain("");
+    expect(JSON.stringify(res)).not.toContain('"id":""');
+  });
+
+  it("still emits the author relationship when a real author id is supplied", () => {
+    // Guards the ContentInput widening: content types that DO carry an author
+    // keep serialising it through Content.addContentInput.
+    const res = new HowTo().createJsonApi({
+      id: "11111111-1111-4111-8111-111111111111",
+      name: "Add an NPC",
+      authorId: "22222222-2222-4222-8222-222222222222",
+      description: [{ type: "paragraph", content: [] }],
+    });
+
+    expect(res.data.relationships.author).toEqual({
+      data: { type: "users", id: "22222222-2222-4222-8222-222222222222" },
+    });
+  });
 });

package/src/features/how-to/data/HowToService.ts

@@ -59,6 +59,19 @@ export class HowToService extends AbstractService {
     });
   }
 
+  /**
+   * POST /howtos/reindex — re-queues every guide for chunking. Replies 204.
+   * Chunking otherwise only happens on create and update, so a guide that was
+   * never chunked stays invisible to help-mode retrieval with no way back.
+   */
+  static async reindex(): Promise<void> {
+    await this.callApi({
+      type: Modules.HowTo,
+      method: HttpMethod.POST,
+      endpoint: new EndpointCreator({ endpoint: Modules.HowTo, id: "reindex" }).generate(),
+    });
+  }
+
   static async findPublished(params: { howToType?: string } = {}): Promise<HowToInterface[]> {
     const endpoint = new EndpointCreator({ endpoint: `public/${Modules.HowTo.name}` });
     if (params.howToType) endpoint.addAdditionalParam("type", params.howToType);