ridho-arachman-portfolio 0.1.21 → 0.1.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ridho-arachman-portfolio",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "Personal portfolio web app (Next.js). Published automatically on every push to main.",
   "homepage": "https://ridho-arachman.vercel.app",
   "repository": {

package/src/app/api/admin/auto-translate.test.ts

@@ -0,0 +1,273 @@
+// auto-translate.test.ts
+// Auto-translate wiring at the route boundary, for every entity that has an
+// Indonesian override column: projects, experience, certificates, categories.
+//
+// Three guarantees, checked for all eight handlers (POST + PUT each):
+//   1. blank `id` override + working translator  -> filled from the English base
+//   2. blank `id` override + broken translator    -> stays blank, save still
+//                                                   succeeds (never a 500), so
+//                                                   the resolver inherits English
+//   3. non-blank `id` override                    -> kept verbatim, translator
+//                                                   never asked for that field
+//
+// One table instead of four per-entity suites: the contract is identical for
+// every entity, so testing it eight times in one place is what keeps the five
+// sibling route files from drifting apart.
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { writes } = vi.hoisted(() => ({
+  writes: [] as Array<Record<string, unknown>>,
+}));
+
+vi.mock("next/cache", () => ({
+  revalidatePath: vi.fn(),
+  revalidateTag: vi.fn(),
+}));
+
+vi.mock("@/lib/session", () => ({
+  requireAdminSession: vi.fn(),
+}));
+
+vi.mock("@/lib/rate-limit", () => ({
+  applyRateLimit: vi.fn(),
+}));
+
+vi.mock("@/lib/translate", () => ({
+  translateTexts: vi.fn(async (texts: string[]) =>
+    texts.map((text) => `AUTO:${text}`),
+  ),
+}));
+
+vi.mock("@/lib/prisma", () => {
+  const model = () => ({
+    findMany: vi.fn(async () => []),
+    count: vi.fn(async () => 0),
+    findUnique: vi.fn(async () => ({ id: "row-1", slug: "stable-slug" })),
+    create: vi.fn(async (args: { data: Record<string, unknown> }) => {
+      writes.push(args.data);
+      return { id: "new-1", slug: "stable-slug" };
+    }),
+    update: vi.fn(async (args: { data: Record<string, unknown> }) => {
+      writes.push(args.data);
+      return { id: "row-1", slug: "stable-slug" };
+    }),
+  });
+
+  return {
+    default: {
+      project: model(),
+      experience: model(),
+      certificate: model(),
+      category: model(),
+      rateLimit: { findUnique: vi.fn(), create: vi.fn(), update: vi.fn() },
+    },
+  };
+});
+
+import { applyRateLimit } from "@/lib/rate-limit";
+import { requireAdminSession } from "@/lib/session";
+import { translateTexts } from "@/lib/translate";
+import { POST as postProject } from "./projects/route";
+import { PUT as putProject } from "./projects/[id]/route";
+import { POST as postExperience } from "./experience/route";
+import { PUT as putExperience } from "./experience/[id]/route";
+import { POST as postCertificate } from "./certificates/route";
+import { PUT as putCertificate } from "./certificates/[id]/route";
+import { POST as postCategory } from "./categories/route";
+import { PUT as putCategory } from "./categories/[id]/route";
+
+type Body = Record<string, unknown>;
+
+interface Entity {
+  name: string;
+  /** One translatable field, used as the override target in every scenario. */
+  field: string;
+  /** English base value written by the admin form. */
+  english: string;
+  create: Body;
+  update: Body;
+  post: (body: Body) => Promise<Response>;
+  put: (body: Body) => Promise<Response>;
+}
+
+function request(url: string, body: Body): Request {
+  return new Request(url, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(body),
+  }) as Request;
+}
+
+const putCtx = { params: Promise.resolve({ id: "row-1" }) };
+
+const entities: Entity[] = [
+  {
+    name: "project",
+    field: "title",
+    english: "English Project Title",
+    create: {
+      title: "English Project Title",
+      description: "English project description long enough.",
+      thumbnail: "https://example.com/thumb.png",
+      technologies: [],
+      gallery: [],
+      highlights: [],
+      isPublished: true,
+      order: 0,
+    },
+    update: {
+      title: "English Project Title",
+      description: "English project description long enough.",
+    },
+    post: (body) => postProject(request("http://x/api/admin/projects", body)),
+    put: (body) =>
+      putProject(request("http://x/api/admin/projects/row-1", body), putCtx),
+  },
+  {
+    name: "experience",
+    field: "title",
+    english: "English Role Title",
+    create: {
+      title: "English Role Title",
+      company: "Acme",
+      type: "WORK",
+      location: "Jakarta",
+      startDate: "2020-01-01",
+      isCurrent: false,
+      description: ["English achievement bullet"],
+      gallery: [],
+      isPublished: true,
+      order: 0,
+    },
+    update: {
+      title: "English Role Title",
+      description: ["English achievement bullet"],
+    },
+    post: (body) =>
+      postExperience(request("http://x/api/admin/experience", body)),
+    put: (body) =>
+      putExperience(request("http://x/api/admin/experience/row-1", body), putCtx),
+  },
+  {
+    name: "certificate",
+    field: "title",
+    english: "English Certificate Title",
+    create: {
+      title: "English Certificate Title",
+      issuer: "Issuer Inc",
+      issueDate: "2024-01-01",
+      skills: [],
+      summary: ["English summary point"],
+      isPublished: true,
+      order: 0,
+    },
+    update: {
+      title: "English Certificate Title",
+      summary: ["English summary point"],
+    },
+    post: (body) =>
+      postCertificate(request("http://x/api/admin/certificates", body)),
+    put: (body) =>
+      putCertificate(
+        request("http://x/api/admin/certificates/row-1", body),
+        putCtx,
+      ),
+  },
+  {
+    name: "category",
+    field: "name",
+    english: "English Category",
+    create: {
+      name: "English Category",
+      description: "English category description",
+      order: 0,
+    },
+    update: {
+      name: "English Category",
+      description: "English category description",
+    },
+    post: (body) => postCategory(request("http://x/api/admin/categories", body)),
+    put: (body) =>
+      putCategory(request("http://x/api/admin/categories/row-1", body), putCtx),
+  },
+];
+
+function storedIdOverride(field: string): string {
+  const translations = writes.at(-1)?.translations as
+    | { id?: Record<string, string> }
+    | undefined;
+  return translations?.id?.[field] ?? "";
+}
+
+function translateCalls(): string[] {
+  return vi.mocked(translateTexts).mock.calls.flatMap(([texts]) => texts);
+}
+
+describe.each(entities)("$name auto-translate", (entity) => {
+  const cases = [
+    { verb: "POST", run: entity.post, base: entity.create, ok: 201 },
+    { verb: "PUT", run: entity.put, base: entity.update, ok: 200 },
+  ] as const;
+
+  beforeEach(() => {
+    writes.length = 0;
+    vi.mocked(translateTexts).mockClear();
+    vi.mocked(translateTexts).mockImplementation(async (texts) =>
+      texts.map((text) => `AUTO:${text}`),
+    );
+    vi.mocked(requireAdminSession).mockResolvedValue({
+      user: { id: "admin-1" },
+    } as Awaited<ReturnType<typeof requireAdminSession>>);
+    vi.mocked(applyRateLimit).mockResolvedValue({
+      allowed: true,
+      headers: {},
+    } as Awaited<ReturnType<typeof applyRateLimit>>);
+  });
+
+  it.each(cases)(
+    "$verb fills a blank id override from the English base",
+    async ({ run, base, ok }) => {
+      const res = await run({
+        ...base,
+        translations: { id: { [entity.field]: "" } },
+      });
+
+      expect(res.status).toBe(ok);
+      expect(storedIdOverride(entity.field)).toBe(`AUTO:${entity.english}`);
+    },
+  );
+
+  it.each(cases)(
+    "$verb saves successfully with a blank id override when the translator fails",
+    async ({ run, base, ok }) => {
+      // translateOne swallows network errors, timeouts and MyMemory error
+      // statuses alike and resolves to "", so this one mock covers them all.
+      vi.mocked(translateTexts).mockImplementation(async (texts) =>
+        texts.map(() => ""),
+      );
+
+      const res = await run({
+        ...base,
+        translations: { id: { [entity.field]: "" } },
+      });
+
+      expect(res.status).toBe(ok);
+      expect(writes).toHaveLength(1);
+      expect(storedIdOverride(entity.field)).toBe("");
+    },
+  );
+
+  it.each(cases)(
+    "$verb never overwrites a manual id override",
+    async ({ run, base, ok }) => {
+      const res = await run({
+        ...base,
+        translations: { id: { [entity.field]: "Judul Manual" } },
+      });
+
+      expect(res.status).toBe(ok);
+      expect(storedIdOverride(entity.field)).toBe("Judul Manual");
+      expect(translateCalls()).not.toContain("Judul Manual");
+    },
+  );
+});

package/src/app/api/admin/categories/[id]/route.ts

@@ -4,6 +4,11 @@ import prisma from "@/lib/prisma";
 import { notDeleted, slugReserved } from "@/lib/soft-delete";
 import { slugify } from "@/utils/slug";
 import { categoryUpdateSchema } from "@/schema/category";
+import { CATEGORY_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 import { requireAdminSession } from "@/lib/session";
 import { applyRateLimit } from "@/lib/rate-limit";
 import {successResponse, errorResponse, errorResponseFrom } from "@/lib/api-helpers";
@@ -58,6 +63,21 @@ export async function PUT(
     const slug =
       data.slug || (data.name ? slugify(data.name) : undefined);
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    // Only when the translations key is present: an absent key leaves the
+    // stored column untouched so existing manual overrides are never lost.
+    const translations =
+      data.translations !== undefined
+        ? await withAutoIdTranslations(
+            translatableBase(
+              { ...existing, ...data },
+              CATEGORY_TRANSLATABLE_FIELDS,
+            ),
+            data.translations,
+            CATEGORY_TRANSLATABLE_FIELDS,
+          )
+        : undefined;
+
     const category = await prisma.category.update({
       where: { id },
       data: {
@@ -69,7 +89,7 @@ export async function PUT(
         ...(data.order !== undefined && { order: data.order }),
         // Spread seperti di POST: aman terhadap client yang belum di-generate ulang.
         ...(data.translations !== undefined && {
-          translations: data.translations ?? Prisma.DbNull,
+          translations: translations ?? Prisma.DbNull,
         }),
       },
     });

package/src/app/api/admin/categories/route.ts

@@ -10,6 +10,11 @@ import {successResponse,
   paginatedResponse,
   parsePagination, errorResponseFrom } from "@/lib/api-helpers";
 import { categoryCreateSchema } from "@/schema/category";
+import { CATEGORY_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 
 export const dynamic = "force-dynamic";
 
@@ -62,6 +67,13 @@ export async function POST(req: Request) {
     const data = parsed.data;
     const slug = data.slug || slugify(data.name);
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    const translations = await withAutoIdTranslations(
+      translatableBase({ ...data }, CATEGORY_TRANSLATABLE_FIELDS),
+      data.translations,
+      CATEGORY_TRANSLATABLE_FIELDS,
+    );
+
     const category = await prisma.category.create({
       data: {
         name: data.name,
@@ -73,7 +85,7 @@ export async function POST(req: Request) {
         // kena excess-property check, jadi baris ini kompilasi sebelum
         // maupun sesudah generate. Pola kondisinya sama dengan PUT project.
         ...(data.translations !== undefined && {
-          translations: data.translations ?? Prisma.DbNull,
+          translations: translations ?? Prisma.DbNull,
         }),
       },
     });

package/src/app/api/admin/certificates/[id]/route.ts

@@ -4,6 +4,11 @@ import prisma from "@/lib/prisma";
 import { notDeleted, slugReserved } from "@/lib/soft-delete";
 import { slugify } from "@/utils/slug";
 import { certificateUpdateSchema } from "@/schema/certificate";
+import { CERTIFICATE_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 import { requireAdminSession } from "@/lib/session";
 import { applyRateLimit } from "@/lib/rate-limit";
 import {successResponse, errorResponse, errorResponseFrom } from "@/lib/api-helpers";
@@ -58,6 +63,21 @@ export async function PUT(
     const slug =
       data.slug || (data.title ? slugify(data.title) : undefined);
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    // Only when the translations key is present: an absent key leaves the
+    // stored column untouched so existing manual overrides are never lost.
+    const translations =
+      data.translations !== undefined
+        ? await withAutoIdTranslations(
+            translatableBase(
+              { ...existing, ...data },
+              CERTIFICATE_TRANSLATABLE_FIELDS,
+            ),
+            data.translations,
+            CERTIFICATE_TRANSLATABLE_FIELDS,
+          )
+        : undefined;
+
     const certificate = await prisma.certificate.update({
       where: { id },
       data: {
@@ -87,7 +107,7 @@ export async function PUT(
         }),
         ...(data.order !== undefined && { order: data.order }),
         ...(data.translations !== undefined && {
-          translations: data.translations ?? Prisma.DbNull,
+          translations: translations ?? Prisma.DbNull,
         }),
       },
     });

package/src/app/api/admin/certificates/route.ts

@@ -10,6 +10,11 @@ import {successResponse,
   paginatedResponse,
   parsePagination, errorResponseFrom } from "@/lib/api-helpers";
 import { certificateCreateSchema } from "@/schema/certificate";
+import { CERTIFICATE_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 
 export const dynamic = "force-dynamic";
 
@@ -67,6 +72,13 @@ export async function POST(req: Request) {
     const data = parsed.data;
     const slug = data.slug || slugify(data.title);
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    const translations = await withAutoIdTranslations(
+      translatableBase({ ...data }, CERTIFICATE_TRANSLATABLE_FIELDS),
+      data.translations,
+      CERTIFICATE_TRANSLATABLE_FIELDS,
+    );
+
     const certificate = await prisma.certificate.create({
       data: {
         slug,
@@ -82,7 +94,7 @@ export async function POST(req: Request) {
         summary: data.summary,
         isPublished: data.isPublished,
         order: data.order,
-        translations: data.translations ?? Prisma.DbNull,
+        translations: translations ?? Prisma.DbNull,
       },
     });
 

package/src/app/api/admin/experience/[id]/route.ts

@@ -3,6 +3,11 @@ import { Prisma } from "@/generated/prisma/client";
 import prisma from "@/lib/prisma";
 import { notDeleted, slugReserved } from "@/lib/soft-delete";
 import { experienceUpdateSchema } from "@/schema/experience";
+import { EXPERIENCE_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 import { requireAdminSession } from "@/lib/session";
 import { applyRateLimit } from "@/lib/rate-limit";
 import {successResponse, errorResponse, errorResponseFrom } from "@/lib/api-helpers";
@@ -55,6 +60,21 @@ export async function PUT(
       return errorResponse("Experience not found", 404);
     }
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    // Only when the translations key is present: an absent key leaves the
+    // stored column untouched so existing manual overrides are never lost.
+    const translations =
+      data.translations !== undefined
+        ? await withAutoIdTranslations(
+            translatableBase(
+              { ...existing, ...data },
+              EXPERIENCE_TRANSLATABLE_FIELDS,
+            ),
+            data.translations,
+            EXPERIENCE_TRANSLATABLE_FIELDS,
+          )
+        : undefined;
+
     const experience = await prisma.experience.update({
       where: { id },
       data: {
@@ -80,7 +100,7 @@ export async function PUT(
         ...(data.gallery !== undefined && { gallery: data.gallery }),
         ...(data.order !== undefined && { order: data.order }),
         ...(data.translations !== undefined && {
-          translations: data.translations ?? Prisma.DbNull,
+          translations: translations ?? Prisma.DbNull,
         }),
       },
     });

package/src/app/api/admin/experience/route.ts

@@ -9,6 +9,11 @@ import {successResponse,
   paginatedResponse,
   parsePagination, errorResponseFrom } from "@/lib/api-helpers";
 import { experienceCreateSchema } from "@/schema/experience";
+import { EXPERIENCE_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 
 export const dynamic = "force-dynamic";
 
@@ -67,6 +72,13 @@ export async function POST(req: Request) {
     const data = parsed.data;
     const slug = data.slug ?? slugify(data.title);
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    const translations = await withAutoIdTranslations(
+      translatableBase({ ...data }, EXPERIENCE_TRANSLATABLE_FIELDS),
+      data.translations,
+      EXPERIENCE_TRANSLATABLE_FIELDS,
+    );
+
     const experience = await prisma.experience.create({
       data: {
         ...data,
@@ -75,6 +87,7 @@ export async function POST(req: Request) {
         endDate: data.endDate ? new Date(data.endDate) : null,
         description: data.description ?? [],
         gallery: data.gallery ?? [],
+        translations: translations ?? undefined,
       },
     });
 

package/src/app/api/admin/projects/[id]/route.ts

@@ -7,6 +7,11 @@ import { requireAdminSession } from "@/lib/session";
 import { applyRateLimit } from "@/lib/rate-limit";
 import {successResponse, errorResponse, errorResponseFrom } from "@/lib/api-helpers";
 import { projectUpdateSchema } from "@/schema/project";
+import { PROJECT_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 
 export const dynamic = "force-dynamic";
 
@@ -74,6 +79,22 @@ export async function PUT(
     const slug =
       data.slug || (data.title ? slugify(data.title) : undefined);
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    // Only when the translations key is present: an absent key leaves the
+    // stored column untouched so existing manual overrides are never lost.
+    // Base falls back to the stored row for fields missing in partial updates.
+    const translations =
+      data.translations !== undefined
+        ? await withAutoIdTranslations(
+            translatableBase(
+              { ...existing, ...data },
+              PROJECT_TRANSLATABLE_FIELDS,
+            ),
+            data.translations,
+            PROJECT_TRANSLATABLE_FIELDS,
+          )
+        : undefined;
+
     const project = await prisma.project.update({
       where: { id },
       data: {
@@ -101,7 +122,7 @@ export async function PUT(
           categoryId: data.categoryId || null,
         }),
         ...(data.translations !== undefined && {
-          translations: data.translations ?? Prisma.DbNull,
+          translations: translations ?? Prisma.DbNull,
         }),
       },
     });

package/src/app/api/admin/projects/route.test.ts

@@ -31,6 +31,12 @@ vi.mock("@/lib/prisma", () => ({
   },
 }));
 
+// POST auto-fills blank Indonesian overrides, which reaches MyMemory unless the
+// translator is stubbed. Keep this suite off the network.
+vi.mock("@/lib/translate", () => ({
+  translateTexts: vi.fn(async (texts: string[]) => texts.map(() => "")),
+}));
+
 import { revalidatePath, revalidateTag } from "next/cache";
 import prisma from "@/lib/prisma";
 import { requireAdminSession } from "@/lib/session";

package/src/app/api/admin/projects/route.ts

@@ -4,6 +4,11 @@ import prisma from "@/lib/prisma";
 import { notDeleted, trashedOnly, slugReserved } from "@/lib/soft-delete";
 import { slugify } from "@/utils/slug";
 import { projectCreateSchema } from "@/schema/project";
+import { PROJECT_TRANSLATABLE_FIELDS } from "@/schema/content-translations";
+import {
+  translatableBase,
+  withAutoIdTranslations,
+} from "@/lib/content-i18n";
 import { requireAdminSession } from "@/lib/session";
 import { applyRateLimit } from "@/lib/rate-limit";
 import {successResponse,
@@ -62,6 +67,13 @@ export async function POST(req: Request) {
     const data = parsed.data;
     const slug = data.slug || slugify(data.title);
 
+    // Auto-fill blank Indonesian overrides; translator failure keeps blanks.
+    const translations = await withAutoIdTranslations(
+      translatableBase({ ...data }, PROJECT_TRANSLATABLE_FIELDS),
+      data.translations,
+      PROJECT_TRANSLATABLE_FIELDS,
+    );
+
     const project = await prisma.project.create({
       data: {
         title: data.title,
@@ -79,7 +91,7 @@ export async function POST(req: Request) {
         isPublished: data.isPublished,
         order: data.order,
         categoryId: data.categoryId || null,
-        translations: data.translations ?? Prisma.DbNull,
+        translations: translations ?? Prisma.DbNull,
       },
     });
 

package/src/components/sections/admin-categories/constants.ts

@@ -39,7 +39,7 @@ export const ADMIN_CATEGORIES = {
   fieldOrder: "Order",
   fieldOrderHint: "Lower values appear first.",
   idSectionLabel: "Bahasa Indonesia (opsional)",
-  idSectionNote: "Kosongkan field yang tidak perlu diterjemahkan — otomatis pakai versi Inggris.",
+  idSectionNote: "Leave blank to auto-translate from English.",
   fieldIdName: "Name (ID)",
   fieldIdNamePlaceholder: "e.g. Pengembangan Web",
   fieldIdDescription: "Description (ID)",

package/src/components/sections/admin-certificates/constants.ts

@@ -50,7 +50,7 @@ export const ADMIN_CERTIFICATES = {
   fieldOrder: "Order",
   fieldOrderHint: "Lower values appear first.",
   idSectionLabel: "Bahasa Indonesia (opsional)",
-  idSectionNote: "Kosongkan field yang tidak perlu diterjemahkan — otomatis pakai versi Inggris.",
+  idSectionNote: "Leave blank to auto-translate from English.",
   fieldIdTitle: "Title (ID)",
   fieldIdTitlePlaceholder: "e.g. AWS Certified Cloud Practitioner",
   fieldIdSummary: "Summary (ID, satu poin per baris)",

package/src/components/sections/admin-experience/constants.ts

@@ -73,7 +73,7 @@ export const ADMIN_EXPERIENCE = {
     orderLabel: "Display Order",
     orderPlaceholder: "0",
     idSectionLabel: "Bahasa Indonesia (opsional)",
-    idSectionNote: "Kosongkan field yang tidak perlu diterjemahkan — otomatis pakai versi Inggris.",
+    idSectionNote: "Leave blank to auto-translate from English.",
     idTitleLabel: "Role (ID)",
     idTitlePlaceholder: "e.g. Frontend Developer",
     idDescriptionLabel: "Description (ID, satu poin per baris)",

package/src/components/sections/admin-projects/constants.ts

@@ -47,7 +47,7 @@ export const ADMIN_PROJECTS = {
   fieldOrder: "Order",
   fieldOrderHint: "Lower values appear first.",
   idSectionLabel: "Bahasa Indonesia (opsional)",
-  idSectionNote: "Kosongkan field yang tidak perlu diterjemahkan — otomatis pakai versi Inggris.",
+  idSectionNote: "Leave blank to auto-translate from English.",
   fieldIdTitle: "Title (ID)",
   fieldIdTitlePlaceholder: "e.g. Platform Portfolio Web3",
   fieldIdDescription: "Description (ID)",