@yosr-ai/template-next-fullstack 0.0.0-stage → 0.1.0-alpha.0

package/style/errors-result/files/src/features/notes/actions.ts

@@ -0,0 +1,18 @@
+"use server";
+
+import { revalidatePath } from "next/cache";
+
+import { createNote } from "./create-note";
+
+/** Server action for the note form. Returns an error message or null. */
+export async function createNoteAction(
+  _previous: string | null,
+  formData: FormData,
+): Promise<string | null> {
+  const result = await createNote({ title: formData.get("title") });
+  if (!result.ok) {
+    return result.error;
+  }
+  revalidatePath("/");
+  return null;
+}

package/style/errors-result/files/src/features/notes/create-note.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it, vi } from "vitest";
+
+import { createNote } from "@domain/notes/create-note";
+
+describe("createNote", () => {
+  it("stores a trimmed, valid note", async () => {
+    const insert = vi.fn(async (input: { title: string }) => ({
+      id: "1",
+      title: input.title,
+      createdAt: new Date(0),
+    }));
+
+    const result = await createNote({ title: "  Buy milk  " }, insert);
+
+    expect(insert).toHaveBeenCalledWith({ title: "Buy milk" });
+    expect(result).toEqual({
+      ok: true,
+      value: { id: "1", title: "Buy milk", createdAt: new Date(0) },
+    });
+  });
+
+  it("returns an error for an empty title", async () => {
+    const insert = vi.fn();
+
+    const result = await createNote({ title: " " }, insert);
+
+    expect(result.ok).toBe(false);
+    expect(insert).not.toHaveBeenCalled();
+  });
+});

package/style/errors-result/files/src/features/notes/create-note.ts

@@ -0,0 +1,16 @@
+import { err, ok, type Result } from "@shared/result";
+
+import { type Note, noteInputSchema } from "./note-schema";
+import { insertNote } from "./notes-store";
+
+/** Validates input and stores a note. Returns an error Result on bad input. */
+export async function createNote(
+  input: unknown,
+  insert: typeof insertNote = insertNote,
+): Promise<Result<Note>> {
+  const parsed = noteInputSchema.safeParse(input);
+  if (!parsed.success) {
+    return err(parsed.error.issues[0]?.message ?? "Invalid note");
+  }
+  return ok(await insert(parsed.data));
+}

package/style/errors-result/files/src/shared/result.ts

@@ -0,0 +1,12 @@
+/** Expected failures are returned, not thrown. Unexpected ones still throw. */
+export type Result<T, E = string> =
+  | { ok: true; value: T }
+  | { ok: false; error: E };
+
+export function ok<T>(value: T): Result<T, never> {
+  return { ok: true, value };
+}
+
+export function err<E>(error: E): Result<never, E> {
+  return { ok: false, error };
+}