docs: updates to digital product recipe

[shahednasser]

• Create workflow for fulfilling digital products that sends a notification + create a shipment to mark the fulfillment as fulfilled / shipped.
• Update the subscriber handling the digital_product_order.created event to use the workflow
• Add section on using the local notification module provider for testing purposes.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
api-reference	🔄 Building (Inspect)	Visit Preview	💬 Add feedback	Sep 20, 2024 6:48am
api-reference-v2	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 20, 2024 6:48am
docs-ui	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 20, 2024 6:48am
docs-v2	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 20, 2024 6:48am
medusa-dashboard	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 20, 2024 6:48am
resources-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 20, 2024 6:48am

1 Skipped Deployment

Name	Status	Preview	Comments	Updated (UTC)
medusa-docs	⬜️ Ignored (Inspect)	Visit Preview		Sep 20, 2024 6:48am

[changeset-bot]

⚠️ No Changeset found

Latest commit: fbc9bbd

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[420coupe]

Was the recipe changed otherwise?

Was having an issue when uploading, had to add multer on the api path for upload. Now i'm having an issue with req.validatedBody coming back as undefined. specifically this piece of the code below.

type CreateRequestBody = z.infer<typeof createDigitalProductsSchema>;

export const POST = async (
  req: AuthenticatedMedusaRequest<CreateRequestBody>,
  res: MedusaResponse
) => {
  const { result } = await createDigitalProductWorkflow(req.scope).run({
    input: {
      digital_product: {
        name: req.validatedBody.name,
        medias: req.validatedBody.medias.map((media) => ({
          fileId: media.file_id,
          mimeType: media.mime_type,
          ...media,
        })) as Omit<CreateDigitalProductMediaInput, "digital_product_id">[],
      },
      product: req.validatedBody.product,
    },
  });

  res.json({
    digital_product: result.digital_product,
  });
};

Not sure why middleware.ts wasn't applying the multer, but Modified api to use multer, now uploads work, but it dies on verificationBody as mentioned above

import multer from "multer";
import { AuthenticatedMedusaRequest, MedusaResponse } from "@medusajs/medusa";
import { uploadFilesWorkflow } from "@medusajs/core-flows";
import { MedusaError } from "@medusajs/utils";

const upload = multer({ storage: multer.memoryStorage() });

export const uploadMiddleware = upload.array("files");

export const POST = async (
  req: AuthenticatedMedusaRequest,
  res: MedusaResponse
) => {
  uploadMiddleware(req as any, res as any, async (err: any) => {
    if (err) {
      console.error("Error handling file upload:", err);
      return res.status(500).json({ error: "File upload failed" });
    }

    const access = req.params.type === "main" ? "private" : "public";
    const input = req.files as Express.Multer.File[];

    if (!input?.length) {
      throw new MedusaError(
        MedusaError.Types.INVALID_DATA,
        "No files were uploaded"
      );
    }

    const { result } = await uploadFilesWorkflow(req.scope).run({
      input: {
        files: input?.map((f) => ({
          filename: f.originalname,
          mimeType: f.mimetype,
          content: f.buffer.toString("binary"),
          access,
        })),
      },
    });

    res.status(200).json({ files: result });
  });
};

[shahednasser]

Was having an issue when uploading, had to add multer on the api path for upload.

@420coupe This is already part of the recipe.

Not sure why middleware.ts wasn't applying the multer, but Modified api to use multer, now uploads work, but it dies on verificationBody as mentioned above

there was an issue with middlewares in a preview version we released yesterday. Can you update and try again?

[420coupe]

Was having an issue when uploading, had to add multer on the api path for upload.

@420coupe This is already part of the recipe.

Not sure why middleware.ts wasn't applying the multer, but Modified api to use multer, now uploads work, but it dies on verificationBody as mentioned above

there was an issue with middlewares in a preview version we released yesterday. Can you update and try again?

Tyvm, been chasing my tail all day trying to figure out why.

found another small bug, when deleting a digital product from the product section, it doesn't delete the digital product and then causes an error when going to digital products on adminui

[420coupe]

also you never attach the digital product in the notification.

[shahednasser]

also you never attach the digital product in the notification.

@420coupe We instead retrieve the URLs of all digital products and pass them in the notification's payload. You're free to do it differently if that's your use case.

[olivermrbl]

LGTM, nice!