docs: remove usages of ts-ignore in examples (medusajs#12839)

Author: shahednasser

www/apps/book/app/learn/customization/integrate-systems/handle-event/page.mdx

@@ -157,10 +157,10 @@ Learn more about compensation functions in [this chapter](../../../fundamentals/
 You can now create the workflow that uses the above step. Add the workflow to the same `src/workflows/sync-brands-to-cms.ts` file:
 
 export const syncWorkflowHighlights = [
-  ["19", "useQueryGraphStep", "Retrieve the brand's details."],
-  ["23", "id", "Filter by the brand's ID."],
-  ["26", "throwIfKeyNotFound", "Throw an error if a brand with the specified ID doesn't exist."],
-  ["30", "syncBrandToCmsStep", "Create the brand in the third-party CMS."]
+  ["18", "useQueryGraphStep", "Retrieve the brand's details."],
+  ["22", "id", "Filter by the brand's ID."],
+  ["25", "throwIfKeyNotFound", "Throw an error if a brand with the specified ID doesn't exist."],
+  ["29", "syncBrandToCmsStep", "Create the brand in the third-party CMS."]
 ]
 
 ```ts title="src/workflows/sync-brands-to-cms.ts" highlights={syncWorkflowHighlights}
@@ -181,7 +181,6 @@ type SyncBrandToCmsWorkflowInput = {
 export const syncBrandToCmsWorkflow = createWorkflow(
   "sync-brand-to-cms",
   (input: SyncBrandToCmsWorkflowInput) => {
-    // @ts-ignore
     const { data: brands } = useQueryGraphStep({
       entity: "brand",
       fields: ["*"],

www/apps/book/app/learn/fundamentals/framework/page.mdx

@@ -903,7 +903,6 @@ type WorkflowInput = {
 export const sendOrderConfirmationWorkflow = createWorkflow(
   "send-order-confirmation",
   ({ id }: WorkflowInput) => {
-    // @ts-ignore
     const { data: orders } = useQueryGraphStep({
       entity: "order",
       fields: [

www/apps/book/generated/edit-dates.mjs

@@ -84,7 +84,7 @@ export const generatedEditDates = {
   "app/learn/customization/extend-features/define-link/page.mdx": "2025-04-17T08:50:17.036Z",
   "app/learn/customization/extend-features/page.mdx": "2024-12-09T11:02:39.244Z",
   "app/learn/customization/extend-features/query-linked-records/page.mdx": "2025-04-18T07:41:05.912Z",
-  "app/learn/customization/integrate-systems/handle-event/page.mdx": "2024-12-24T15:09:24.653Z",
+  "app/learn/customization/integrate-systems/handle-event/page.mdx": "2025-06-26T14:26:15.310Z",
   "app/learn/customization/integrate-systems/page.mdx": "2024-12-09T10:40:08.528Z",
   "app/learn/customization/integrate-systems/schedule-task/page.mdx": "2025-01-28T16:42:42.071Z",
   "app/learn/customization/integrate-systems/service/page.mdx": "2024-12-09T11:02:39.594Z",
@@ -117,7 +117,7 @@ export const generatedEditDates = {
   "app/learn/production/worker-mode/page.mdx": "2025-03-11T15:21:50.906Z",
   "app/learn/fundamentals/module-links/read-only/page.mdx": "2025-05-13T15:04:12.107Z",
   "app/learn/fundamentals/data-models/properties/page.mdx": "2025-03-18T07:57:17.826Z",
-  "app/learn/fundamentals/framework/page.mdx": "2025-04-25T14:26:25.000Z",
+  "app/learn/fundamentals/framework/page.mdx": "2025-06-26T14:26:22.120Z",
   "app/learn/fundamentals/api-routes/retrieve-custom-links/page.mdx": "2025-04-25T14:26:25.000Z",
   "app/learn/fundamentals/workflows/errors/page.mdx": "2025-04-25T14:26:25.000Z",
   "app/learn/fundamentals/api-routes/override/page.mdx": "2025-05-09T08:01:24.493Z",

www/apps/book/public/llms-full.txt

@@ -284,6 +284,9 @@ async function main() {
         },
         allowedFilesPatterns: [/^(?!.*\/(colors|icons|hooks)\/).*$/],
       },
+      {
+        dir: path.join(process.cwd(), "..", "resources", "app", "recipes"),
+      },
     ],
   })
 }

www/apps/book/scripts/prepare.mjs

@@ -518,8 +518,8 @@ Create the file `src/workflows/add-custom-to-cart.ts` with the following content
 ![The directory structure after adding the workflow file.](https://res.cloudinary.com/dza7lstvk/image/upload/v1738251380/Medusa%20Resources/custom-item-price-5_zorahv.jpg)
 
 export const workflowHighlights = [
-  ["18", "useQueryGraphStep", "Retrieve the cart's details."],
-  ["24", "useQueryGraphStep", "Retrieve the variant's details."],
+  ["17", "useQueryGraphStep", "Retrieve the cart's details."],
+  ["23", "useQueryGraphStep", "Retrieve the variant's details."],
 ]
 
 ```ts title="src/workflows/add-custom-to-cart.ts" highlights={workflowHighlights}
@@ -539,7 +539,6 @@ type AddCustomToCartWorkflowInput = {
 export const addCustomToCartWorkflow = createWorkflow(
   "add-custom-to-cart",
   ({ cart_id, item }: AddCustomToCartWorkflowInput) => {
-    // @ts-ignore
     const { data: carts } = useQueryGraphStep({
       entity: "cart",
       filters: { id: cart_id },
@@ -651,7 +650,6 @@ import { WorkflowResponse } from "@medusajs/framework/workflows-sdk"
 And replace the last `TODO` in the workflow with the following:
 
 ```ts title="src/workflows/add-custom-to-cart.ts"
-// @ts-ignore
 const { data: updatedCarts } = useQueryGraphStep({
   entity: "cart",
   filters: { id: cart_id },

www/apps/resources/app/examples/guides/custom-item-price/page.mdx

@@ -635,8 +635,8 @@ You can now create the workflow using the steps provided by Medusa and your cust
 To create the workflow, create the file `src/workflows/create-request-for-quote.ts` with the following content:
 
 export const createRequestForQuoteHighlights = [
-  ["25", "useQueryGraphStep", "Retrieve the cart's details."],
-  ["46", "useQueryGraphStep", "Retrieve the customer's details."]
+  ["24", "useQueryGraphStep", "Retrieve the cart's details."],
+  ["45", "useQueryGraphStep", "Retrieve the customer's details."]
 ]
 
 ```ts title="src/workflows/create-request-for-quote.ts" highlights={createRequestForQuoteHighlights} collapsibleLines="1-20" expandButtonLabel="Show Imports"
@@ -663,7 +663,6 @@ type WorkflowInput = {
 export const createRequestForQuoteWorkflow = createWorkflow(
   "create-request-for-quote",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: carts } = useQueryGraphStep({
       entity: "cart",
       fields: [
@@ -2584,9 +2583,9 @@ You can now implement the merchant-rejection workflow. Create the file `src/work
 ![Diagram showcasing the directory structure after adding the merchant reject quote workflow file](https://res.cloudinary.com/dza7lstvk/image/upload/v1741159969/Medusa%20Resources/quote-36_l1ffxm.jpg)
 
 export const merchantRejectionWorkflowHighlights = [
-  ["15", "useQueryGraphStep", "Retrieve the quote's details."],
-  ["24", "validateQuoteNotAccepted", "Validate that the quote isn't already accepted by the customer."],
-  ["29", "updateQuotesStep", "Update the quote's status to `merchant_rejected`."]
+  ["14", "useQueryGraphStep", "Retrieve the quote's details."],
+  ["23", "validateQuoteNotAccepted", "Validate that the quote isn't already accepted by the customer."],
+  ["28", "updateQuotesStep", "Update the quote's status to `merchant_rejected`."]
 ]
 
 ```ts title="src/workflows/merchant-reject-quote.ts" highlights={merchantRejectionWorkflowHighlights}
@@ -2603,7 +2602,6 @@ type WorkflowInput = {
 export const merchantRejectQuoteWorkflow = createWorkflow(
   "merchant-reject-quote-workflow",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: quotes } = useQueryGraphStep({
       entity: "quote",
       fields: ["id", "status"],
@@ -2905,7 +2903,6 @@ type WorkflowInput = {
 export const merchantSendQuoteWorkflow = createWorkflow(
   "merchant-send-quote-workflow",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: quotes } = useQueryGraphStep({
       entity: "quote",
       fields: ["id", "status"],
@@ -3282,9 +3279,9 @@ Create the file `src/workflows/customer-reject-quote.ts` with the following cont
 ![Directory structure after adding the customer reject quote workflow file](https://res.cloudinary.com/dza7lstvk/image/upload/v1741164371/Medusa%20Resources/quote-41_fgpqhz.jpg)
 
 export const customerRejectQuoteHighlights = [
-  ["16", "useQueryGraphStep", "Retrieve the quote's details."],
-  ["25", "validateQuoteNotAccepted", "Validate that the quote isn't already accepted by the customer."],
-  ["30", "updateQuotesStep", "Update the quote's status to `customer_rejected`."]
+  ["15", "useQueryGraphStep", "Retrieve the quote's details."],
+  ["24", "validateQuoteNotAccepted", "Validate that the quote isn't already accepted by the customer."],
+  ["29", "updateQuotesStep", "Update the quote's status to `customer_rejected`."]
 ]
 
 ```ts title="src/workflows/customer-reject-quote.ts" highlights={customerRejectQuoteHighlights}
@@ -3302,7 +3299,6 @@ type WorkflowInput = {
 export const customerRejectQuoteWorkflow = createWorkflow(
   "customer-reject-quote-workflow",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: quotes } = useQueryGraphStep({
       entity: "quote",
       fields: ["id", "status"],
@@ -3511,11 +3507,11 @@ You can now implement the workflow that accepts a quote for a customer. Create t
 ![Directory structure after adding the customer accept quote workflow file](https://res.cloudinary.com/dza7lstvk/image/upload/v1741166025/Medusa%20Resources/quote-44_c09ts9.jpg)
 
 export const customerAcceptQuoteHighlights = [
-  ["21", "useQueryGraphStep", "Retrieve the quote's details."],
-  ["30", "validateQuoteCanAcceptStep", "Validate that the quote can be accepted."],
-  ["35", "updateQuotesStep", "Update the quote's status to `accepted`."],
-  ["40", "confirmOrderEditRequestWorkflow", "Confirm the changes made on the draft order, such as changes to item quantities and prices."],
-  ["47", "updateOrderWorkflow", "Update the draft order to change its status and convert it into an order."]
+  ["20", "useQueryGraphStep", "Retrieve the quote's details."],
+  ["29", "validateQuoteCanAcceptStep", "Validate that the quote can be accepted."],
+  ["34", "updateQuotesStep", "Update the quote's status to `accepted`."],
+  ["39", "confirmOrderEditRequestWorkflow", "Confirm the changes made on the draft order, such as changes to item quantities and prices."],
+  ["46", "updateOrderWorkflow", "Update the draft order to change its status and convert it into an order."]
 ]
 
 ```ts title="src/workflows/customer-accept-quote.ts" highlights={customerAcceptQuoteHighlights}
@@ -3538,7 +3534,6 @@ type WorkflowInput = {
 export const customerAcceptQuoteWorkflow = createWorkflow(
   "customer-accept-quote-workflow",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: quotes } = useQueryGraphStep({
       entity: "quote",
       fields: ["id", "draft_order_id", "status"],

www/apps/resources/app/examples/guides/quote-management/page.mdx

@@ -558,11 +558,9 @@ const {
     updated_at: {
       $lt: oneDayAgo,
     },
-    // @ts-ignore
     email: {
       $ne: null,
     },
-    // @ts-ignore
     completed_at: null,
   },
   pagination: {

www/apps/resources/app/how-to-tutorials/tutorials/abandoned-cart/page.mdx

@@ -202,12 +202,12 @@ To create the workflow, create the file `src/workflows/apply-first-purchase-prom
 
 export const workflowHighlights = [
   ["7", "cart_id", "Receive cart ID as input."],
-  ["14", "carts", "Retrieve the cart's details."],
-  ["23", "promotions", "Retrieve the first-purchase promotion's details."],
-  ["32", "when", "Check if the first-purchase promotion can be applied."],
-  ["42", "updateCartPromotionsStep", "Add the first-purchase promotion to the cart."],
-  ["51", "updatedCarts", "Retrieve the updated cart's details."],
-  ["59", "WorkflowResponse", "Return the updated cart's details."]
+  ["13", "carts", "Retrieve the cart's details."],
+  ["21", "promotions", "Retrieve the first-purchase promotion's details."],
+  ["29", "when", "Check if the first-purchase promotion can be applied."],
+  ["39", "updateCartPromotionsStep", "Add the first-purchase promotion to the cart."],
+  ["47", "updatedCarts", "Retrieve the updated cart's details."],
+  ["55", "WorkflowResponse", "Return the updated cart's details."]
 ]
 
 ```ts title="src/workflows/apply-first-purchase-promo.ts" highlights={workflowHighlights}
@@ -223,7 +223,6 @@ type WorkflowInput = {
 export const applyFirstPurchasePromoWorkflow = createWorkflow(
   "apply-first-purchase-promo",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: carts } = useQueryGraphStep({
       entity: "cart",
       fields: ["promotions.*", "customer.*", "customer.orders.*"],
@@ -232,12 +231,10 @@ export const applyFirstPurchasePromoWorkflow = createWorkflow(
       }
     })
 
-    // @ts-ignore
     const { data: promotions } = useQueryGraphStep({
       entity: "promotion",
       fields: ["code"],
       filters: {
-        // @ts-ignore
         code: FIRST_PURCHASE_PROMOTION_CODE
       }
     }).config({ name: "retrieve-promotions" })
@@ -260,7 +257,6 @@ export const applyFirstPurchasePromoWorkflow = createWorkflow(
     })
 
     // retrieve updated cart
-    // @ts-ignore
     const { data: updatedCarts } = useQueryGraphStep({
       entity: "cart",
       fields: ["*", "promotions.*"],

www/apps/resources/app/how-to-tutorials/tutorials/first-purchase-discounts/page.mdx

@@ -835,14 +835,14 @@ Now that you have all the steps, you can create the workflow that uses them.
 To create the workflow, create the file `src/workflows/handle-order-points.ts` with the following content:
 
 export const handleOrderPointsHighlights = [
-  ["18", "useQueryGraphStep", "Retrieve the order's details."],
-  ["38", "validateCustomerExistsStep", "Validate that the customer is registered."],
-  ["42", "getCartLoyaltyPromoStep", "Retrieve the cart's loyalty promotion."],
-  ["46", "when", "Check whether the order's cart has a loyalty promotion."],
-  ["51", "deductPurchasePointsStep", "Deduct points from the customer's loyalty points."],
-  ["56", "updatePromotionsStep", "Deactivate the cart's loyalty promotion."],
-  ["65", "when", "Check whether the order's cart doesn't have a loyalty promotion."],
-  ["70", "addPurchaseAsPointsStep", "Add points to the customer's loyalty points."],
+  ["17", "useQueryGraphStep", "Retrieve the order's details."],
+  ["37", "validateCustomerExistsStep", "Validate that the customer is registered."],
+  ["41", "getCartLoyaltyPromoStep", "Retrieve the cart's loyalty promotion."],
+  ["45", "when", "Check whether the order's cart has a loyalty promotion."],
+  ["50", "deductPurchasePointsStep", "Deduct points from the customer's loyalty points."],
+  ["55", "updatePromotionsStep", "Deactivate the cart's loyalty promotion."],
+  ["64", "when", "Check whether the order's cart doesn't have a loyalty promotion."],
+  ["69", "addPurchaseAsPointsStep", "Add points to the customer's loyalty points."],
 ]
 
 ```ts title="src/workflows/handle-order-points.ts" highlights={handleOrderPointsHighlights} collapsibleLines="1-9" expandButtonLabel="Show Imports"
@@ -862,7 +862,6 @@ type WorkflowInput = {
 export const handleOrderPointsWorkflow = createWorkflow(
   "handle-order-points",
   ({ order_id }: WorkflowInput) => {
-    // @ts-ignore
     const { data: orders } = useQueryGraphStep({
       entity: "order",
       fields: [
@@ -1394,10 +1393,10 @@ You can now create the workflow that applies a loyalty promotion to the cart.
 To create the workflow, create the file `src/workflows/apply-loyalty-on-cart.ts` with the following content:
 
 export const applyLoyaltyOnCartWorkflowHighlights = [
-  ["45", "useQueryGraphStep", "Retrieve the cart's details."],
-  ["56", "validateCustomerExistsStep", "Validate that the customer is registered."],
-  ["60", "getCartLoyaltyPromoStep", "Retrieve the cart's loyalty promotion."],
-  ["65", "getCartLoyaltyPromoAmountStep", "Get the amount to be discounted based on the loyalty points."],
+  ["44", "useQueryGraphStep", "Retrieve the cart's details."],
+  ["55", "validateCustomerExistsStep", "Validate that the customer is registered."],
+  ["59", "getCartLoyaltyPromoStep", "Retrieve the cart's loyalty promotion."],
+  ["64", "getCartLoyaltyPromoAmountStep", "Get the amount to be discounted based on the loyalty points."],
 ]
 
 ```ts title="src/workflows/apply-loyalty-on-cart.ts" highlights={applyLoyaltyOnCartWorkflowHighlights} collapsibleLines="1-24" expandButtonLabel="Show Imports"
@@ -1444,7 +1443,6 @@ const fields = [
 export const applyLoyaltyOnCartWorkflow = createWorkflow(
   "apply-loyalty-on-cart",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: carts } = useQueryGraphStep({
       entity: "cart",
       fields,
@@ -1559,7 +1557,7 @@ export const createLoyaltyPromoStepHighlights = [
   ["5", "transform", "Prepare the data to update the cart's promotions."],
   ["25", "updateCartPromotionsWorkflow", "Update the cart's promotions with the new loyalty promotion."],
   ["29", "updateCartsStep", "Update the cart to store the ID of the loyalty promotion in the metadata."],
-  ["38", "useQueryGraphStep", "Retrieve the cart's details again."],
+  ["37", "useQueryGraphStep", "Retrieve the cart's details again."],
 ]
 
 ```ts title="src/workflows/apply-loyalty-on-cart.ts" highlights={createLoyaltyPromoStepHighlights}
@@ -1599,7 +1597,6 @@ updateCartsStep([
 ])
 
 // retrieve cart with updated promotions
-// @ts-ignore
 const { data: updatedCarts } = useQueryGraphStep({
   entity: "cart",
   fields,
@@ -1800,13 +1797,13 @@ Since you already have all the steps, you can create the workflow.
 To create the workflow, create the file `src/workflows/remove-loyalty-from-cart.ts` with the following content:
 
 export const removeLoyaltyFromCartWorkflowHighlights = [
-  ["36", "useQueryGraphStep", "Retrieve the cart's details."],
-  ["44", "getCartLoyaltyPromoStep", "Retrieve the cart's loyalty promotion."],
-  ["49", "updateCartPromotionsWorkflow", "Update the cart's promotions to remove the loyalty promotion."],
-  ["57", "transform", "Prepare the new metadata to remove the loyalty promotion ID."],
-  ["68", "updateCartsStep", "Update the cart to remove the loyalty promotion ID from the metadata."],
-  ["75", "updatePromotionsStep", "Deactivate the loyalty promotion."],
-  ["84", "useQueryGraphStep", "Retrieve the cart's details again."],
+  ["35", "useQueryGraphStep", "Retrieve the cart's details."],
+  ["43", "getCartLoyaltyPromoStep", "Retrieve the cart's loyalty promotion."],
+  ["48", "updateCartPromotionsWorkflow", "Update the cart's promotions to remove the loyalty promotion."],
+  ["56", "transform", "Prepare the new metadata to remove the loyalty promotion ID."],
+  ["67", "updateCartsStep", "Update the cart to remove the loyalty promotion ID from the metadata."],
+  ["74", "updatePromotionsStep", "Deactivate the loyalty promotion."],
+  ["82", "useQueryGraphStep", "Retrieve the cart's details again."],
 ]
 
 ```ts title="src/workflows/remove-loyalty-from-cart.ts" collapsibleLines="1-15" expandButtonLabel="Show Imports" highlights={removeLoyaltyFromCartWorkflowHighlights}
@@ -1844,7 +1841,6 @@ const fields = [
 export const removeLoyaltyFromCartWorkflow = createWorkflow(
   "remove-loyalty-from-cart",
   (input: WorkflowInput) => {
-    // @ts-ignore
     const { data: carts } = useQueryGraphStep({
       entity: "cart",
       fields,
@@ -1892,7 +1888,6 @@ export const removeLoyaltyFromCartWorkflow = createWorkflow(
     ])
 
     // retrieve cart with updated promotions
-    // @ts-ignore
     const { data: updatedCarts } = useQueryGraphStep({
       entity: "cart",
       fields,