Updating and Archiving Products

Products API: Updating and Archiving Products

Welcome back! 👋 Now that you can fetch a single product by ID, it’s time to make that product change over time —updating its fields and archiving it when it should no longer be sold. In this lesson, you’ll focus on the single-product route at src/app/api/products/[id]/route.ts, specifically the PATCH and DELETE handlers. You’ll see how the route validates the path param, safely parses JSON, validates partial updates, and then delegates to the service layer to actually perform the update or archive. Previously\dots In the previous lesson, you implemented GET /api/products/:id, validating the UUID path parameter and distinguishing a 400 invalid ID from a 404 product not found . That same “be precise about outcomes” mindset carries forward here—except now we’re handling writes, so we add body parsing and patch validation too.

Two write operations on a single product

When working with /api/products/:id, we now support two common “write” actions: PATCH /api/products/:id : apply a partial update (only the fields you send change). DELETE /api/products/:id : archive the product (this project treats “delete” as an archive operation and returns the updated product). Just like the GET-by-id endpoint, both routes clearly separate: Invalid input (400 validation errors) Missing product (404 not found) Successful operation (200 with the updated product)

Route file: src/app/api/products/[id]/route.ts

This file defines the dynamic [id] route and implements GET, PATCH, and DELETE . In this lesson we’ll focus on PATCH and DELETE, since they introduce the most new patterns. Shared setup: imports and route context: This top portion establishes the shared tools the route uses: response helpers, JSON parsing, service functions, and UUID validation. TypeScript import { NextRequest } from "next/server"; import { success, error, parseJson } from "@/lib/http/response"; import {getProductService, updateProductService, archiveProductService, validateUpdateProduct,} from "@/lib/services/productsService"; import { isUUID } from "@/lib/http/validation"; type RouteContext = { params: Promise<{ id: string }> }; import { NextRequest } from "next/server"; import { success, error, parseJson } from "@/lib/http/response"; import {getProductService, updateProductService, archiveProductService, validateUpdateProduct,} from "@/lib/services/productsService"; import { isUUID } from "@/lib/http/validation"; type RouteContext = { params: Promise<{ id: string }> }; parseJson is a key difference from earlier routes. Instead of calling req.json() directly (and risking exceptions on malformed JSON), this helper returns a safe result object you can branch on. validateUpdateProduct lives in the service file and is designed specifically for PATCH semantics: it accepts partial input and returns only the validated fields. The RouteContext type matches how this project models dynamic params: context.params is a Promise, so every handler await s it to access { id } . isUUID is used consistently across GET/PATCH/DELETE so invalid path params always produce a predictable 400 .

Join the 1M+ learners on CodeSignal

Be a part of our community of 1M+ users who develop and demonstrate their skills on CodeSignal

TypeScript

import { NextRequest } from "next/server";
import { success, error, parseJson } from "@/lib/http/response";
import {
  getProductService,
  updateProductService,
  archiveProductService,
  validateUpdateProduct,
} from "@/lib/services/productsService";
import { isUUID } from "@/lib/http/validation";

type RouteContext = { params: Promise<{ id: string }> };

TypeScript

export async function PATCH(req: NextRequest, context: RouteContext) {
  try {
    const { id } = await context.params;

    if (!isUUID(id))
      return error("VALIDATION_ERROR", "Invalid id", undefined, 400);

    const bodyResult = await parseJson(req);
    if (!bodyResult.ok)
      return error(bodyResult.code, bodyResult.message, undefined, 400);

export async function PATCH(req: NextRequest, context: RouteContext) {
  try {
    const { id } = await context.params;

    if (!isUUID(id))
      return error("VALIDATION_ERROR", "Invalid id", undefined, 400);

    const bodyResult = await parseJson(req);
    if (!bodyResult.ok)
      return error(bodyResult.code, bodyResult.message, undefined, 400);

TypeScript

    const valid = validateUpdateProduct(bodyResult.value);
    if (!valid.ok)
      return error("VALIDATION_ERROR", valid.message, undefined, 400);

    const updated = await updateProductService(id, valid.value);
    if (!updated.ok)
      return error(
        updated.error.code,
        updated.error.message,
        updated.error.details,
        updated.error.httpStatus,
      );

    return success(updated.value);
  } catch (e: unknown) {
    return error("INTERNAL_ERROR", (e as Error).message, undefined, 500);
  }
}

    const valid = validateUpdateProduct(bodyResult.value);
    if (!valid.ok)
      return error("VALIDATION_ERROR", valid.message, undefined, 400);

    const updated = await updateProductService(id, valid.value);
    if (!updated.ok)
      return error(
        updated.error.code,
        updated.error.message,
        updated.error.details,
        updated.error.httpStatus,
      );

    return success(updated.value);
  } catch (e: unknown) {
    return error("INTERNAL_ERROR", (e as Error).message, undefined, 500);
  }
}

TypeScript

export async function DELETE(_req: NextRequest, context: RouteContext) {
  try {
    const { id } = await context.params;

    if (!isUUID(id))
      return error("VALIDATION_ERROR", "Invalid id", undefined, 400);

    const archived = await archiveProductService(id);
    if (!archived.ok)
      return error(
        archived.error.code,
        archived.error.message,
        archived.error.details,
        archived.error.httpStatus,
      );

    return success(archived.value);
  } catch (e: unknown) {
    return error("INTERNAL_ERROR", (e as Error).message, undefined, 500);
  }
}

export async function DELETE(_req: NextRequest, context: RouteContext) {
  try {
    const { id } = await context.params;

    if (!isUUID(id))
      return error("VALIDATION_ERROR", "Invalid id", undefined, 400);

    const archived = await archiveProductService(id);
    if (!archived.ok)
      return error(
        archived.error.code,
        archived.error.message,
        archived.error.details,
        archived.error.httpStatus,
      );

    return success(archived.value);
  } catch (e: unknown) {
    return error("INTERNAL_ERROR", (e as Error).message, undefined, 500);
  }
}

TypeScript

export function validateUpdateProduct(
  input: unknown,
): { ok: true; value: UpdateProductInput } | { ok: false; message: string } {
  const v = input as Partial<UpdateProductInput>;
  const out: UpdateProductInput = {};
  // ...field-by-field validation...
  return { ok: true, value: out };
}

export function validateUpdateProduct(
  input: unknown,
): { ok: true; value: UpdateProductInput } | { ok: false; message: string } {
  const v = input as Partial<UpdateProductInput>;
  const out: UpdateProductInput = {};
  // ...field-by-field validation...
  return { ok: true, value: out };
}

TypeScript

export async function updateProductService(id: string, patch: UpdateProductInput): Promise<ServiceResult<Product>> {
  const updated = await repoUpdate(id, patch);
  if (!updated) return fail({ code: "NOT_FOUND", message: "Product not found", httpStatus: 404 });
  return ok(updated);
}

export async function archiveProductService(id: string): Promise<ServiceResult<Product>> {
  const archived = await archiveProduct(id);
  if (!archived) return fail({ code: "NOT_FOUND", message: "Product not found", httpStatus: 404 });
  return ok(archived);
}

export async function updateProductService(id: string, patch: UpdateProductInput): Promise<ServiceResult<Product>> {
  const updated = await repoUpdate(id, patch);
  if (!updated) return fail({ code: "NOT_FOUND", message: "Product not found", httpStatus: 404 });
  return ok(updated);
}

export async function archiveProductService(id: string): Promise<ServiceResult<Product>> {
  const archived = await archiveProduct(id);
  if (!archived) return fail({ code: "NOT_FOUND", message: "Product not found", httpStatus: 404 });
  return ok(archived);
}

TypeScript

export async function PATCH(req: NextRequest, context: RouteContext) {
  try {
    const { id } = await context.params;

    if (!isUUID(id))
      return error("VALIDATION_ERROR", "Invalid id", undefined, 400);

    const bodyResult = await parseJson(req);
    if (!bodyResult.ok)
      return error(bodyResult.code, bodyResult.message, undefined, 400);

TypeScript

    const valid = validateUpdateProduct(bodyResult.value);
    if (!valid.ok)
      return error("VALIDATION_ERROR", valid.message, undefined, 400);

    const updated = await updateProductService(id, valid.value);
    if (!updated.ok)
      return error(
        updated.error.code,
        updated.error.message,
        updated.error.details,
        updated.error.httpStatus,
      );

    return success(updated.value);
  } catch (e: unknown) {
    return error("INTERNAL_ERROR", (e as Error).message, undefined, 500);
  }
}

TypeScript

export async function DELETE(_req: NextRequest, context: RouteContext) {
  try {
    const { id } = await context.params;

    if (!isUUID(id))
      return error("VALIDATION_ERROR", "Invalid id", undefined, 400);

    const archived = await archiveProductService(id);
    if (!archived.ok)
      return error(
        archived.error.code,
        archived.error.message,
        archived.error.details,
        archived.error.httpStatus,
      );

    return success(archived.value);
  } catch (e: unknown) {
    return error("INTERNAL_ERROR", (e as Error).message, undefined, 500);
  }
}

TypeScript

export function validateUpdateProduct(
  input: unknown,
): { ok: true; value: UpdateProductInput } | { ok: false; message: string } {
  const v = input as Partial<UpdateProductInput>;
  const out: UpdateProductInput = {};
  // ...field-by-field validation...
  return { ok: true, value: out };
}

TypeScript

export async function updateProductService(id: string, patch: UpdateProductInput): Promise<ServiceResult<Product>> {
  const updated = await repoUpdate(id, patch);
  if (!updated) return fail({ code: "NOT_FOUND", message: "Product not found", httpStatus: 404 });
  return ok(updated);
}

export async function archiveProductService(id: string): Promise<ServiceResult<Product>> {
  const archived = await archiveProduct(id);
  if (!archived) return fail({ code: "NOT_FOUND", message: "Product not found", httpStatus: 404 });
  return ok(archived);
}

Products API: Updating and Archiving Products

Two write operations on a single product

Route file: src/app/api/products/[id]/route.ts

Join the 1M+ learners on CodeSignal

Updating a product: PATCH /api/products/:id

Validating the patch and applying the update

Archiving a product: DELETE /api/products/:id

Service functions: the quick mental model

updateProductService(id, patch) and archiveProductService(id)

Recap