@lodashventure/medusa-campaign 1.0.0 → 1.1.1

package/src/api/store/campaigns/[id]/route.ts

@@ -0,0 +1,133 @@
+import { MedusaRequest, MedusaResponse, container } from "@medusajs/framework";
+import {
+  MedusaError,
+  ContainerRegistrationKeys,
+  Modules,
+} from "@medusajs/framework/utils";
+import { CampaignTypeEnum } from "../../../../modules/custom-campaigns/types/campaign-type.enum";
+import { CustomCampaign } from "../../../admin/flash-sales/route";
+
+export const GET = async (
+  req: MedusaRequest<{ id: string }>,
+  res: MedusaResponse
+) => {
+  const { id } = req.params;
+
+  if (!id) {
+    throw new MedusaError(
+      MedusaError.Types.INVALID_DATA,
+      "Campaign ID is required"
+    );
+  }
+
+  const query = container.resolve(ContainerRegistrationKeys.QUERY);
+  const productService = container.resolve(Modules.PRODUCT);
+
+  try {
+    // First, find the custom campaign type by campaign ID
+    const {
+      data: [customCampaignTypes],
+    } = await query.graph({
+      entity: "custom_campaign_type",
+      fields: [
+        "id",
+        "campaign.*",
+        "campaign.promotions.*",
+        "campaign.promotions.application_method.*",
+        "campaign.promotions.application_method.target_rules.*",
+      ],
+      filters: {
+        type: CampaignTypeEnum.FlashSale,
+        campaign_id: id,
+      },
+    });
+
+    const campaign = customCampaignTypes.campaign;
+
+    if (!campaign) {
+      throw new MedusaError(
+        MedusaError.Types.NOT_FOUND,
+        `Flash sale with ID ${id} not found`
+      );
+    }
+
+    // Fetch promotion usage limits for the campaign
+    const { data: promotionUsageLimits } = await query.graph({
+      entity: "promotion_usage_limit",
+      fields: ["id", "promotion_id", "product_id", "limit", "used"],
+      filters: {
+        campaign_id: id,
+      },
+    });
+
+    // Create a map of promotion usage limits by promotion ID
+    const promotionLimitsMap = new Map();
+    promotionUsageLimits.forEach((limit) => {
+      promotionLimitsMap.set(limit.promotion_id, limit);
+    });
+
+    // Process promotions to extract product information
+    const products: CustomCampaign["products"] = [];
+    for await (const promotion of campaign.promotions ?? []) {
+      if (!promotion.application_method?.target_rules?.length) {
+        continue;
+      }
+
+      const productRule = promotion.application_method.target_rules.find(
+        (rule) =>
+          rule.attribute === "items.product.id" && rule.operator === "eq"
+      );
+      const promotionLimit = promotionLimitsMap.get(promotion.id);
+
+      const product = await productService.retrieveProduct(
+        promotionLimit?.product_id
+      );
+
+      if (productRule && promotion.application_method.value) {
+        products.push({
+          product: {
+            id: product.id,
+            title: product.title,
+          },
+          discountType: promotion.application_method?.type,
+          discountValue: promotion.application_method?.value,
+          maxQty: promotion.application_method?.max_quantity,
+          limit: promotionLimitsMap.get(promotion.id)?.limit,
+        });
+      }
+    }
+
+    const campaignData = {
+      id: campaign.id,
+      name: campaign.name,
+      description: campaign.description,
+      type: campaign.type,
+      startsAt: campaign.starts_at,
+      endsAt: campaign.ends_at,
+    };
+
+    const productData = products.map((product) => ({
+      id: product.product.id,
+      title: product.product.title,
+      discountType: product.discountType,
+      discountValue: product.discountValue,
+      maxQty: product.maxQty,
+      limit: product.limit,
+    }));
+
+    res.status(200).json({
+      ...campaignData,
+      products: productData,
+    });
+  } catch (error) {
+    if (error instanceof MedusaError) {
+      throw error;
+    }
+
+    console.error("Error fetching flash sale:", error);
+    throw new MedusaError(
+      MedusaError.Types.UNEXPECTED_STATE,
+      "An error occurred while fetching the flash sale"
+    );
+  }
+};

package/src/api/store/campaigns/route.ts

@@ -0,0 +1,36 @@
+import { container, MedusaRequest, MedusaResponse } from "@medusajs/framework";
+import { ContainerRegistrationKeys } from "@medusajs/framework/utils";
+import { CampaignTypeEnum } from "../../../modules/custom-campaigns/types/campaign-type.enum";
+
+export const GET = async (req: MedusaRequest, res: MedusaResponse) => {
+  const query = container.resolve(ContainerRegistrationKeys.QUERY);
+  const {
+    data: customCampaigns,
+    metadata: { count, take, skip } = {
+      count: 0,
+      take: 20,
+      skip: 0,
+    },
+  } = await query.graph({
+    entity: "custom_campaign_type",
+    ...req.queryConfig,
+    fields: [
+      "id",
+      "campaign.name",
+      "campaign.description",
+      "campaign.type",
+      "campaign.starts_at",
+      "campaign.ends_at",
+    ],
+    filters: { type: CampaignTypeEnum.FlashSale },
+  });
+
+  const campaigns = customCampaigns.map((campaign) => campaign.campaign);
+
+  res.status(200).json({
+    campaigns,
+    count,
+    limit: take,
+    offset: skip,
+  });
+};

package/src/jobs/README.md

@@ -0,0 +1,36 @@
+# Custom scheduled jobs
+
+A scheduled job is a function executed at a specified interval of time in the background of your Medusa application.
+
+A scheduled job is created in a TypeScript or JavaScript file under the `src/jobs` directory.
+
+For example, create the file `src/jobs/hello-world.ts` with the following content:
+
+```ts
+import {
+  MedusaContainer
+} from "@medusajs/framework/types";
+
+export default async function myCustomJob(container: MedusaContainer) {
+  const productService = container.resolve("product")
+
+  const products = await productService.listAndCountProducts();
+
+  // Do something with the products
+}
+
+export const config = {
+  name: "daily-product-report",
+  schedule: "0 0 * * *", // Every day at midnight
+};
+```
+
+A scheduled job file must export:
+
+- The function to be executed whenever it’s time to run the scheduled job.
+- A configuration object defining the job. It has three properties:
+  - `name`: a unique name for the job.
+  - `schedule`: a [cron expression](https://crontab.guru/).
+  - `numberOfExecutions`: an optional integer, specifying how many times the job will execute before being removed
+
+The `handler` is a function that accepts one parameter, `container`, which is a `MedusaContainer` instance used to resolve services.

package/src/links/README.md

@@ -0,0 +1,26 @@
+# Module Links
+
+A module link forms an association between two data models of different modules, while maintaining module isolation.
+
+Learn more about links in [this documentation](https://docs.medusajs.com/learn/fundamentals/module-links)
+
+For example:
+
+```ts
+import BlogModule from "../modules/blog"
+import ProductModule from "@medusajs/medusa/product"
+import { defineLink } from "@medusajs/framework/utils"
+
+export default defineLink(
+  ProductModule.linkable.product,
+  BlogModule.linkable.post
+)
+```
+
+This defines a link between the Product Module's `product` data model and the Blog Module (custom module)'s `post` data model.
+
+Then, in the Medusa application using this plugin, run the following command to sync the links to the database:
+
+```bash
+npx medusa db:migrate
+```

package/src/links/campaign-type.ts

@@ -0,0 +1,8 @@
+import { defineLink } from "@medusajs/framework/utils";
+import PromotionModule from "@medusajs/medusa/promotion";
+import CustomCampaignModule from "../modules/custom-campaigns";
+
+export default defineLink(PromotionModule.linkable.campaign, {
+  linkable: CustomCampaignModule.linkable.customCampaignType,
+  deleteCascade: true,
+});

package/src/modules/README.md

@@ -0,0 +1,116 @@
+# Custom Module
+
+A module is a package of reusable functionalities. It can be integrated into your Medusa application without affecting the overall system. You can create a module as part of a plugin.
+
+Learn more about modules in [this documentation](https://docs.medusajs.com/learn/fundamentals/modules).
+
+To create a module:
+
+## 1. Create a Data Model
+
+A data model represents a table in the database. You create a data model in a TypeScript or JavaScript file under the `models` directory of a module.
+
+For example, create the file `src/modules/blog/models/post.ts` with the following content:
+
+```ts
+import { model } from "@medusajs/framework/utils"
+
+const Post = model.define("post", {
+  id: model.id().primaryKey(),
+  title: model.text(),
+})
+
+export default Post
+```
+
+## 2. Create a Service
+
+A module must define a service. A service is a TypeScript or JavaScript class holding methods related to a business logic or commerce functionality.
+
+For example, create the file `src/modules/blog/service.ts` with the following content:
+
+```ts
+import { MedusaService } from "@medusajs/framework/utils"
+import Post from "./models/post"
+
+class BlogModuleService extends MedusaService({
+  Post,
+}){
+}
+
+export default BlogModuleService
+```
+
+## 3. Export Module Definition
+
+A module must have an `index.ts` file in its root directory that exports its definition. The definition specifies the main service of the module.
+
+For example, create the file `src/modules/blog/index.ts` with the following content:
+
+```ts
+import BlogModuleService from "./service"
+import { Module } from "@medusajs/framework/utils"
+
+export const BLOG_MODULE = "blog"
+
+export default Module(BLOG_MODULE, {
+  service: BlogModuleService,
+})
+```
+
+## 4. Generate Migrations
+
+To generate migrations for your module, run the following command in the plugin's directory:
+
+```bash
+npx medusa plugin:db:genreate
+```
+
+## Use Module
+
+You can use the module in customizations within the plugin or within the Medusa application using this plugin. When the plugin is added to a Medusa application, all its modules are registered as well.
+
+For example, to use the module in an API route:
+
+```ts
+import { MedusaRequest, MedusaResponse } from "@medusajs/framework"
+import BlogModuleService from "../../../modules/blog/service"
+import { BLOG_MODULE } from "../../../modules/blog"
+
+export async function GET(
+  req: MedusaRequest,
+  res: MedusaResponse
+): Promise<void> {
+  const blogModuleService: BlogModuleService = req.scope.resolve(
+    BLOG_MODULE
+  )
+
+  const posts = await blogModuleService.listPosts()
+
+  res.json({
+    posts
+  })
+}
+```
+
+## Module Options
+
+When you register the plugin in the Medusa application, it can accept options. These options are passed to the modules within the plugin:
+
+```ts
+import { defineConfig } from "@medusajs/framework/utils"
+
+module.exports = defineConfig({
+  // ...
+  plugins: [
+    {
+      resolve: "@myorg/plugin-name",
+      options: {
+        apiKey: process.env.API_KEY,
+      },
+    },
+  ],
+})
+```
+
+Learn more about module options in [this documentation](https://docs.medusajs.com/learn/fundamentals/modules/options).

package/src/modules/custom-campaigns/index.ts

@@ -0,0 +1,8 @@
+import { Module } from "@medusajs/framework/utils";
+import CustomCampaignModuleService from "./service";
+
+export const CUSTOM_CAMPAIGN_MODULE = "customCampaign";
+
+export default Module(CUSTOM_CAMPAIGN_MODULE, {
+  service: CustomCampaignModuleService,
+});

package/src/modules/custom-campaigns/migrations/.snapshot-medusa-custom-campaign.json

@@ -0,0 +1,235 @@
+{
+  "namespaces": [
+    "public"
+  ],
+  "name": "public",
+  "tables": [
+    {
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "text"
+        },
+        "campaign_id": {
+          "name": "campaign_id",
+          "type": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "text"
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "enumItems": [
+            "flash-sale"
+          ],
+          "mappedType": "enum"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamptz",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": 6,
+          "default": "now()",
+          "mappedType": "datetime"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamptz",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": 6,
+          "default": "now()",
+          "mappedType": "datetime"
+        },
+        "deleted_at": {
+          "name": "deleted_at",
+          "type": "timestamptz",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": 6,
+          "mappedType": "datetime"
+        }
+      },
+      "name": "custom_campaign_type",
+      "schema": "public",
+      "indexes": [
+        {
+          "keyName": "IDX_custom_campaign_type_campaign_id_unique",
+          "columnNames": [],
+          "composite": false,
+          "constraint": false,
+          "primary": false,
+          "unique": false,
+          "expression": "CREATE UNIQUE INDEX IF NOT EXISTS \"IDX_custom_campaign_type_campaign_id_unique\" ON \"custom_campaign_type\" (campaign_id) WHERE deleted_at IS NULL"
+        },
+        {
+          "keyName": "IDX_custom_campaign_type_deleted_at",
+          "columnNames": [],
+          "composite": false,
+          "constraint": false,
+          "primary": false,
+          "unique": false,
+          "expression": "CREATE INDEX IF NOT EXISTS \"IDX_custom_campaign_type_deleted_at\" ON \"custom_campaign_type\" (deleted_at) WHERE deleted_at IS NULL"
+        },
+        {
+          "keyName": "custom_campaign_type_pkey",
+          "columnNames": [
+            "id"
+          ],
+          "composite": false,
+          "constraint": true,
+          "primary": true,
+          "unique": true
+        }
+      ],
+      "checks": [],
+      "foreignKeys": {},
+      "nativeEnums": {}
+    },
+    {
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "text"
+        },
+        "campaign_id": {
+          "name": "campaign_id",
+          "type": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "text"
+        },
+        "promotion_id": {
+          "name": "promotion_id",
+          "type": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "text"
+        },
+        "product_id": {
+          "name": "product_id",
+          "type": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "text"
+        },
+        "limit": {
+          "name": "limit",
+          "type": "integer",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "integer"
+        },
+        "used": {
+          "name": "used",
+          "type": "integer",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "mappedType": "integer"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamptz",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": 6,
+          "default": "now()",
+          "mappedType": "datetime"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamptz",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": 6,
+          "default": "now()",
+          "mappedType": "datetime"
+        },
+        "deleted_at": {
+          "name": "deleted_at",
+          "type": "timestamptz",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": 6,
+          "mappedType": "datetime"
+        }
+      },
+      "name": "promotion_usage_limit",
+      "schema": "public",
+      "indexes": [
+        {
+          "keyName": "IDX_promotion_usage_limit_deleted_at",
+          "columnNames": [],
+          "composite": false,
+          "constraint": false,
+          "primary": false,
+          "unique": false,
+          "expression": "CREATE INDEX IF NOT EXISTS \"IDX_promotion_usage_limit_deleted_at\" ON \"promotion_usage_limit\" (deleted_at) WHERE deleted_at IS NULL"
+        },
+        {
+          "keyName": "IDX_promotion_usage_limit_campaign_id_promotion_id_unique",
+          "columnNames": [],
+          "composite": false,
+          "constraint": false,
+          "primary": false,
+          "unique": false,
+          "expression": "CREATE UNIQUE INDEX IF NOT EXISTS \"IDX_promotion_usage_limit_campaign_id_promotion_id_unique\" ON \"promotion_usage_limit\" (campaign_id, promotion_id) WHERE deleted_at IS NULL"
+        },
+        {
+          "keyName": "promotion_usage_limit_pkey",
+          "columnNames": [
+            "id"
+          ],
+          "composite": false,
+          "constraint": true,
+          "primary": true,
+          "unique": true
+        }
+      ],
+      "checks": [],
+      "foreignKeys": {},
+      "nativeEnums": {}
+    }
+  ],
+  "nativeEnums": {}
+}

package/src/modules/custom-campaigns/migrations/Migration20250524150901.ts

@@ -0,0 +1,23 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20250524150901 extends Migration {
+
+  override async up(): Promise<void> {
+    this.addSql(`alter table if exists "promotion_usage_limit" drop constraint if exists "promotion_usage_limit_promotion_id_unique";`);
+    this.addSql(`alter table if exists "custom_campaign_type" drop constraint if exists "custom_campaign_type_campaign_id_unique";`);
+    this.addSql(`create table if not exists "custom_campaign_type" ("id" text not null, "campaign_id" text not null, "type" text check ("type" in ('flash-sale')) not null, "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), "deleted_at" timestamptz null, constraint "custom_campaign_type_pkey" primary key ("id"));`);
+    this.addSql(`CREATE UNIQUE INDEX IF NOT EXISTS "IDX_custom_campaign_type_campaign_id_unique" ON "custom_campaign_type" (campaign_id) WHERE deleted_at IS NULL;`);
+    this.addSql(`CREATE INDEX IF NOT EXISTS "IDX_custom_campaign_type_deleted_at" ON "custom_campaign_type" (deleted_at) WHERE deleted_at IS NULL;`);
+
+    this.addSql(`create table if not exists "promotion_usage_limit" ("id" text not null, "promotion_id" text not null, "limit" integer not null, "used" integer not null, "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), "deleted_at" timestamptz null, constraint "promotion_usage_limit_pkey" primary key ("id"));`);
+    this.addSql(`CREATE UNIQUE INDEX IF NOT EXISTS "IDX_promotion_usage_limit_promotion_id_unique" ON "promotion_usage_limit" (promotion_id) WHERE deleted_at IS NULL;`);
+    this.addSql(`CREATE INDEX IF NOT EXISTS "IDX_promotion_usage_limit_deleted_at" ON "promotion_usage_limit" (deleted_at) WHERE deleted_at IS NULL;`);
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`drop table if exists "custom_campaign_type" cascade;`);
+
+    this.addSql(`drop table if exists "promotion_usage_limit" cascade;`);
+  }
+
+}

package/src/modules/custom-campaigns/migrations/Migration20250526010310.ts

@@ -0,0 +1,20 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20250526010310 extends Migration {
+
+  override async up(): Promise<void> {
+    this.addSql(`alter table if exists "promotion_usage_limit" drop constraint if exists "promotion_usage_limit_campaign_id_promotion_id_unique";`);
+    this.addSql(`drop index if exists "IDX_promotion_usage_limit_promotion_id_unique";`);
+
+    this.addSql(`alter table if exists "promotion_usage_limit" add column if not exists "campaign_id" text not null;`);
+    this.addSql(`CREATE UNIQUE INDEX IF NOT EXISTS "IDX_promotion_usage_limit_campaign_id_promotion_id_unique" ON "promotion_usage_limit" (campaign_id, promotion_id) WHERE deleted_at IS NULL;`);
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`drop index if exists "IDX_promotion_usage_limit_campaign_id_promotion_id_unique";`);
+    this.addSql(`alter table if exists "promotion_usage_limit" drop column if exists "campaign_id";`);
+
+    this.addSql(`CREATE UNIQUE INDEX IF NOT EXISTS "IDX_promotion_usage_limit_promotion_id_unique" ON "promotion_usage_limit" (promotion_id) WHERE deleted_at IS NULL;`);
+  }
+
+}

package/src/modules/custom-campaigns/migrations/Migration20250529011904.ts

@@ -0,0 +1,13 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20250529011904 extends Migration {
+
+  override async up(): Promise<void> {
+    this.addSql(`alter table if exists "promotion_usage_limit" add column if not exists "product_id" text not null;`);
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`alter table if exists "promotion_usage_limit" drop column if exists "product_id";`);
+  }
+
+}

package/src/modules/custom-campaigns/models/custom-campaign-type.ts

@@ -0,0 +1,10 @@
+import { model } from "@medusajs/framework/utils";
+import { CampaignTypeEnum } from "../types/campaign-type.enum";
+
+const CustomCampaignType = model.define("custom_campaign_type", {
+  id: model.id().primaryKey(),
+  campaign_id: model.text().unique(),
+  type: model.enum(CampaignTypeEnum),
+});
+
+export default CustomCampaignType;