@unifiedcommerce/plugin-giftcards 0.0.1 → 0.2.1

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 export type { PluginDb as Db } from "@unifiedcommerce/core";
-import type { giftCards, giftCardTransactions } from "./schema";
+import type { giftCards, giftCardTransactions } from "./schema.js";
 export type GiftCard = typeof giftCards.$inferSelect;
 export type GiftCardInsert = typeof giftCards.$inferInsert;
 export type GiftCardTransaction = typeof giftCardTransactions.$inferSelect;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhE,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,CAAC,YAAY,CAAC;AAC3E,MAAM,MAAM,yBAAyB,GAAG,OAAO,oBAAoB,CAAC,YAAY,CAAC;AAEjF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,qBAAqB,CAO3D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,CAAC,YAAY,CAAC;AAC3E,MAAM,MAAM,yBAAyB,GAAG,OAAO,oBAAoB,CAAC,YAAY,CAAC;AAEjF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,qBAAqB,CAO3D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -1,6 +1,6 @@
 export const DEFAULT_OPTIONS = {
     codeFormat: "XXXX-XXXX-XXXX-XXXX",
-    defaultExpiryDays: null,
+    defaultExpiryDays: 0,
     maxBalancePerCard: 10_000_00,
     emailTemplate: "gift-card-delivery",
     allowPartialRedemption: true,

package/package.json

@@ -1,11 +1,18 @@
 {
   "name": "@unifiedcommerce/plugin-giftcards",
-  "version": "0.0.1",
+  "version": "0.2.1",
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./src/index.ts"
+    },
+    "./schema": {
+      "bun": "./src/schema.ts",
+      "import": "./dist/schema.js",
+      "require": "./dist/schema.js",
+      "types": "./src/schema.ts"
     }
   },
   "scripts": {
@@ -32,8 +39,11 @@
     "access": "public"
   },
   "files": [
-    "dist",
     "src",
+    "dist",
     "README.md"
-  ]
+  ],
+  "peerDependencies": {
+    "zod": ">=4.0.0"
+  }
 }

package/src/hooks/checkout-deduction.ts

@@ -1,7 +1,7 @@
 import { resolveOrgId } from "@unifiedcommerce/core";
 import type { PluginHookRegistration } from "@unifiedcommerce/core";
-import type { GiftCardService } from "../services/gift-card-service";
-import type { GiftCardDeduction } from "../types";
+import type { GiftCardService } from "../services/gift-card-service.js";
+import type { GiftCardDeduction } from "../types.js";
 
 interface HookContextLike {
   actor: { organizationId?: string | null; [key: string]: unknown } | null;

package/src/hooks/checkout-issuance.ts

@@ -1,7 +1,7 @@
 import { resolveOrgId } from "@unifiedcommerce/core";
 import type { PluginHookRegistration } from "@unifiedcommerce/core";
-import type { GiftCardService } from "../services/gift-card-service";
-import type { GiftCardPluginOptions } from "../types";
+import type { GiftCardService } from "../services/gift-card-service.js";
+import type { GiftCardPluginOptions } from "../types.js";
 
 interface OrderLineItem {
   entityId: string;

package/src/hooks/refund-credit.ts

@@ -1,7 +1,7 @@
 import { resolveOrgId } from "@unifiedcommerce/core";
 import type { PluginHookRegistration } from "@unifiedcommerce/core";
-import type { GiftCardService } from "../services/gift-card-service";
-import type { GiftCardDeduction } from "../types";
+import type { GiftCardService } from "../services/gift-card-service.js";
+import type { GiftCardDeduction } from "../types.js";
 
 interface HookContextLike {
   actor: { organizationId?: string | null; [key: string]: unknown } | null;

package/src/index.ts

@@ -1,20 +1,21 @@
-import { defineCommercePlugin } from "@unifiedcommerce/core";
-import { giftCards, giftCardTransactions } from "./schema";
-import { GiftCardService } from "./services/gift-card-service";
+import { defineCommercePlugin, toolBuilder } from "@unifiedcommerce/core";
+import { z } from "zod";
+import { giftCards, giftCardTransactions } from "./schema.js";
+import { GiftCardService } from "./services/gift-card-service.js";
 import {
   buildCheckoutDeductionHook,
   buildCheckoutCompensationHook,
-} from "./hooks/checkout-deduction";
-import { buildGiftCardIssuanceHook } from "./hooks/checkout-issuance";
-import { buildRefundCreditHook } from "./hooks/refund-credit";
-import { buildAdminRoutes } from "./routes/admin";
-import { buildPublicRoutes } from "./routes/public";
-import { buildCustomerRoutes } from "./routes/customer";
-import type { GiftCardPluginOptions, Db } from "./types";
-import { DEFAULT_OPTIONS } from "./types";
-
-export type { GiftCardPluginOptions } from "./types";
-export { GiftCardService } from "./services/gift-card-service";
+} from "./hooks/checkout-deduction.js";
+import { buildGiftCardIssuanceHook } from "./hooks/checkout-issuance.js";
+import { buildRefundCreditHook } from "./hooks/refund-credit.js";
+import { buildAdminRoutes } from "./routes/admin.js";
+import { buildPublicRoutes } from "./routes/public.js";
+import { buildCustomerRoutes } from "./routes/customer.js";
+import type { GiftCardPluginOptions } from "./types.js";
+import { DEFAULT_OPTIONS } from "./types.js";
+
+export type { GiftCardPluginOptions } from "./types.js";
+export { GiftCardService } from "./services/gift-card-service.js";
 
 export function giftCardPlugin(userOptions: GiftCardPluginOptions = {}) {
   const options: Required<GiftCardPluginOptions> = {
@@ -48,13 +49,83 @@ export function giftCardPlugin(userOptions: GiftCardPluginOptions = {}) {
       return [];
     },
 
+    mcpTools: (ctx) => {
+      const db = ctx.database.db;
+      if (!db) return [];
+      const service = new GiftCardService(
+        db,
+        ctx.database.transaction,
+        options,
+      );
+
+      const t = toolBuilder("giftcards", "Manage gift cards. Use when checking balances, issuing new cards, looking up card details, or viewing transaction history.");
+
+      t.action("check_balance", "look up balance by code")
+        .input(z.object({
+          orgId: z.string().describe("Organization ID"),
+          code: z.string().describe("Gift card code"),
+        }))
+        .handler(async (args) => service.checkBalance(args.orgId, args.code));
+
+      t.action("issue", "create new card with amount/currency")
+        .input(z.object({
+          orgId: z.string().describe("Organization ID"),
+          amount: z.number().describe("Initial balance in minor units/cents"),
+          currency: z.string().describe("Currency code e.g. USD"),
+          purchaserId: z.string().describe("Customer who purchased the card").optional(),
+          recipientEmail: z.string().describe("Email to deliver the card to").optional(),
+          senderName: z.string().describe("Name of the sender").optional(),
+          personalMessage: z.string().describe("Personal message for recipient").optional(),
+        }))
+        .handler(async (args) => {
+          const input: { amount: number; currency: string; purchaserId?: string; recipientEmail?: string; senderName?: string; personalMessage?: string } = {
+            amount: args.amount,
+            currency: args.currency,
+          };
+          if (args.purchaserId != null) input.purchaserId = args.purchaserId;
+          if (args.recipientEmail != null) input.recipientEmail = args.recipientEmail;
+          if (args.senderName != null) input.senderName = args.senderName;
+          if (args.personalMessage != null) input.personalMessage = args.personalMessage;
+          return service.create(args.orgId, input);
+        });
+
+      t.action("get", "card details by ID")
+        .input(z.object({
+          orgId: z.string().describe("Organization ID"),
+          id: z.string().describe("Gift card ID"),
+        }))
+        .handler(async (args) => service.getById(args.orgId, args.id));
+
+      t.action("list", "all cards with optional filters")
+        .input(z.object({
+          orgId: z.string().describe("Organization ID"),
+          status: z.string().describe("Filter by status: active, exhausted, or disabled").optional(),
+          purchaserId: z.string().describe("Filter by purchaser ID").optional(),
+        }))
+        .handler(async (args) => {
+          const filters: { status?: "active" | "exhausted" | "disabled"; purchaserId?: string } = {};
+          if (args.status != null) filters.status = args.status as "active" | "exhausted" | "disabled";
+          if (args.purchaserId != null) filters.purchaserId = args.purchaserId;
+          return service.list(args.orgId, filters);
+        });
+
+      t.action("transactions", "credit/debit history for a card")
+        .input(z.object({
+          orgId: z.string().describe("Organization ID"),
+          giftCardId: z.string().describe("Gift card ID"),
+        }))
+        .handler(async (args) => service.getTransactions(args.orgId, args.giftCardId));
+
+      return t.build(ctx);
+    },
+
     routes: (ctx) => {
-      const db = ctx.database.db as unknown as Db;
+      const db = ctx.database.db;
       if (!db) return [];
 
       const service = new GiftCardService(
         db,
-        ctx.database.transaction as unknown as (fn: (tx: Db) => Promise<unknown>) => Promise<unknown>,
+        ctx.database.transaction,
         options,
       );
 
@@ -104,15 +175,16 @@ export function giftCardPluginWithHooks(
     }),
 
     hooks: () => {
-      // Create a lazy proxy service that defers to serviceRef.current
+      // Lazy proxy: defers to serviceRef.current once routes() initializes it.
+      // Uses Reflect.get for type-safe dynamic property access (no index signature needed).
       const lazyService = new Proxy({} as GiftCardService, {
-        get(_target, prop) {
+        get(_target, prop, receiver) {
           if (!serviceRef.current) {
             throw new Error(
               "Gift card service not initialized — hooks ran before routes()",
             );
           }
-          return (serviceRef.current as unknown as Record<string, unknown>)[prop as string];
+          return Reflect.get(serviceRef.current, prop, receiver);
         },
       });
 
@@ -125,12 +197,12 @@ export function giftCardPluginWithHooks(
     },
 
     routes: (ctx) => {
-      const db = ctx.database.db as unknown as Db;
+      const db = ctx.database.db;
       if (!db) return [];
 
       const service = new GiftCardService(
         db,
-        ctx.database.transaction as unknown as (fn: (tx: Db) => Promise<unknown>) => Promise<unknown>,
+        ctx.database.transaction,
         options,
       );
 

package/src/routes/admin.ts

@@ -1,8 +1,8 @@
 import { router } from "@unifiedcommerce/core";
 import { z } from "@hono/zod-openapi";
-import type { GiftCardService } from "../services/gift-card-service";
+import type { GiftCardService } from "../services/gift-card-service.js";
 import type { PluginRouteRegistration } from "@unifiedcommerce/core";
-import { formatCode } from "../code-generator";
+import { formatCode } from "../code-generator.js";
 
 export function buildAdminRoutes(
   service: GiftCardService,

package/src/routes/customer.ts

@@ -1,7 +1,7 @@
 import { router } from "@unifiedcommerce/core";
-import type { GiftCardService } from "../services/gift-card-service";
+import type { GiftCardService } from "../services/gift-card-service.js";
 import type { PluginRouteRegistration } from "@unifiedcommerce/core";
-import { formatCode } from "../code-generator";
+import { formatCode } from "../code-generator.js";
 
 export function buildCustomerRoutes(
   service: GiftCardService,

package/src/routes/public.ts

@@ -1,6 +1,6 @@
 import { router } from "@unifiedcommerce/core";
 import { z } from "@hono/zod-openapi";
-import type { GiftCardService } from "../services/gift-card-service";
+import type { GiftCardService } from "../services/gift-card-service.js";
 import type { PluginRouteRegistration } from "@unifiedcommerce/core";
 
 export function buildPublicRoutes(

package/src/services/gift-card-repository.ts

@@ -1,6 +1,6 @@
 import { eq, desc, and } from "drizzle-orm";
-import { giftCards, giftCardTransactions } from "../schema";
-import type { Db, GiftCard, GiftCardInsert, GiftCardTransaction, GiftCardStatus, TransactionType } from "../types";
+import { giftCards, giftCardTransactions } from "../schema.js";
+import type { Db, GiftCard, GiftCardInsert, GiftCardTransaction, GiftCardStatus, TransactionType } from "../types.js";
 
 export class GiftCardRepository {
   constructor(private db: Db) {}

package/src/services/gift-card-service.ts

@@ -1,7 +1,7 @@
 import { Ok, Err } from "@unifiedcommerce/core";
 import type { PluginResult } from "@unifiedcommerce/core";
-import { generateGiftCardCode, normalizeCode } from "../code-generator";
-import { GiftCardRepository } from "./gift-card-repository";
+import { generateGiftCardCode, normalizeCode } from "../code-generator.js";
+import { GiftCardRepository } from "./gift-card-repository.js";
 import type {
   Db,
   GiftCard,
@@ -10,7 +10,7 @@ import type {
   GiftCardTransaction,
   GiftCardStatus,
   TransactionType,
-} from "../types";
+} from "../types.js";
 
 export class GiftCardService {
   private repo: GiftCardRepository;

package/src/types.ts

@@ -1,5 +1,5 @@
 export type { PluginDb as Db } from "@unifiedcommerce/core";
-import type { giftCards, giftCardTransactions } from "./schema";
+import type { giftCards, giftCardTransactions } from "./schema.js";
 
 export type GiftCard = typeof giftCards.$inferSelect;
 export type GiftCardInsert = typeof giftCards.$inferInsert;
@@ -26,7 +26,7 @@ export interface GiftCardPluginOptions {
 
 export const DEFAULT_OPTIONS: Required<GiftCardPluginOptions> = {
   codeFormat: "XXXX-XXXX-XXXX-XXXX",
-  defaultExpiryDays: null as unknown as number,
+  defaultExpiryDays: 0 as number,
   maxBalancePerCard: 10_000_00,
   emailTemplate: "gift-card-delivery",
   allowPartialRedemption: true,