@unifiedcommerce/plugin-giftcards 0.0.1

package/dist/code-generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Generate a cryptographically secure gift card code.
+ *
+ * Format: XXXX-XXXX-XXXX-XXXX (16 alphanumeric chars)
+ * Uses crypto.randomBytes for uniform distribution.
+ *
+ * @param format - Pattern where X is replaced with a random char. Default: "XXXX-XXXX-XXXX-XXXX"
+ */
+export declare function generateGiftCardCode(format?: string): string;
+/**
+ * Normalize a gift card code for database lookup.
+ * Strips hyphens/spaces and uppercases.
+ */
+export declare function normalizeCode(code: string): string;
+/**
+ * Format a raw code string into the display format.
+ */
+export declare function formatCode(raw: string, format?: string): string;
+/** The character set used for code generation (for validation/testing) */
+export declare const CODE_CHARSET = "ABCDEFGHJKMNPQRSTUVWXYZ23456789";
+//# sourceMappingURL=code-generator.d.ts.map

package/dist/code-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../src/code-generator.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,SAAwB,GAAG,MAAM,CA+B3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAwB,GAAG,MAAM,CAc9E;AAED,0EAA0E;AAC1E,eAAO,MAAM,YAAY,oCAAU,CAAC"}

package/dist/code-generator.js

@@ -0,0 +1,70 @@
+import { randomBytes } from "node:crypto";
+/**
+ * Allowed characters for gift card codes.
+ * Excludes visually ambiguous characters: 0, O, 1, I, L
+ * Charset size: 30 → 30^16 ≈ 7.2 × 10^23 possible codes
+ */
+const CHARSET = "ABCDEFGHJKMNPQRSTUVWXYZ23456789";
+/**
+ * Generate a cryptographically secure gift card code.
+ *
+ * Format: XXXX-XXXX-XXXX-XXXX (16 alphanumeric chars)
+ * Uses crypto.randomBytes for uniform distribution.
+ *
+ * @param format - Pattern where X is replaced with a random char. Default: "XXXX-XXXX-XXXX-XXXX"
+ */
+export function generateGiftCardCode(format = "XXXX-XXXX-XXXX-XXXX") {
+    const charCount = (format.match(/X/g) ?? []).length;
+    // Request extra bytes to handle modulo bias rejection
+    const bytes = randomBytes(charCount * 2);
+    let byteIdx = 0;
+    let result = "";
+    for (const ch of format) {
+        if (ch === "X") {
+            // Rejection sampling to avoid modulo bias
+            // CHARSET.length = 30, so we reject values >= 240 (240 = 30 * 8)
+            let value;
+            do {
+                if (byteIdx >= bytes.length) {
+                    // Extremely unlikely — generate more bytes
+                    const extra = randomBytes(charCount);
+                    for (let i = 0; i < extra.length; i++) {
+                        bytes[byteIdx + i] = extra[i];
+                    }
+                }
+                value = bytes[byteIdx++];
+            } while (value >= 240); // 240 = 30 * 8, ensures uniform distribution
+            result += CHARSET[value % CHARSET.length];
+        }
+        else {
+            result += ch;
+        }
+    }
+    return result;
+}
+/**
+ * Normalize a gift card code for database lookup.
+ * Strips hyphens/spaces and uppercases.
+ */
+export function normalizeCode(code) {
+    return code.replace(/[-\s]/g, "").toUpperCase();
+}
+/**
+ * Format a raw code string into the display format.
+ */
+export function formatCode(raw, format = "XXXX-XXXX-XXXX-XXXX") {
+    const chars = raw.replace(/[-\s]/g, "").toUpperCase();
+    let charIdx = 0;
+    let result = "";
+    for (const ch of format) {
+        if (ch === "X" && charIdx < chars.length) {
+            result += chars[charIdx++];
+        }
+        else if (ch !== "X") {
+            result += ch;
+        }
+    }
+    return result;
+}
+/** The character set used for code generation (for validation/testing) */
+export const CODE_CHARSET = CHARSET;

package/dist/hooks/checkout-deduction.d.ts

@@ -0,0 +1,12 @@
+import type { PluginHookRegistration } from "@unifiedcommerce/core";
+import type { GiftCardService } from "../services/gift-card-service";
+/**
+ * checkout.beforePayment hook — deducts gift card balances before the
+ * payment adapter authorizes the remaining amount.
+ */
+export declare function buildCheckoutDeductionHook(service: GiftCardService): PluginHookRegistration;
+/**
+ * checkout.afterCreate hook — compensates gift card deductions if checkout fails.
+ */
+export declare function buildCheckoutCompensationHook(service: GiftCardService): PluginHookRegistration;
+//# sourceMappingURL=checkout-deduction.d.ts.map

package/dist/hooks/checkout-deduction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-deduction.d.ts","sourceRoot":"","sources":["../../src/hooks/checkout-deduction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAwBrE;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,GACvB,sBAAsB,CAkDxB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,GACvB,sBAAsB,CAyBxB"}

package/dist/hooks/checkout-deduction.js

@@ -0,0 +1,64 @@
+import { resolveOrgId } from "@unifiedcommerce/core";
+/**
+ * checkout.beforePayment hook — deducts gift card balances before the
+ * payment adapter authorizes the remaining amount.
+ */
+export function buildCheckoutDeductionHook(service) {
+    const handler = async (args) => {
+        const { data, context } = args;
+        const orgId = resolveOrgId(context.actor);
+        const codes = data.metadata?.giftCardCodes;
+        if (!codes?.length)
+            return data;
+        let remaining = data.total;
+        const deductions = [];
+        for (const code of codes) {
+            if (remaining <= 0)
+                break;
+            const balanceResult = await service.checkBalance(orgId, code);
+            if (!balanceResult.ok)
+                continue;
+            const deductAmount = Math.min(remaining, balanceResult.value.balance);
+            if (deductAmount <= 0)
+                continue;
+            const result = await service.debitWithLock(orgId, code, deductAmount, data.checkoutId, data.currency);
+            if (result.ok) {
+                deductions.push(result.value);
+                remaining -= deductAmount;
+            }
+        }
+        const giftCardTotal = deductions.reduce((sum, d) => sum + d.amount, 0);
+        return {
+            ...data,
+            total: Math.max(0, remaining),
+            metadata: {
+                ...data.metadata,
+                giftCardDeductions: deductions,
+                giftCardTotal,
+            },
+        };
+    };
+    return {
+        key: "checkout.beforePayment",
+        handler: handler,
+    };
+}
+/**
+ * checkout.afterCreate hook — compensates gift card deductions if checkout fails.
+ */
+export function buildCheckoutCompensationHook(service) {
+    const handler = async (args) => {
+        const { data, result, context } = args;
+        const orgId = resolveOrgId(context.actor);
+        if (!result) {
+            const deductions = data.metadata?.giftCardDeductions;
+            for (const d of deductions ?? []) {
+                await service.creditWithLock(orgId, d.code, d.amount, data.checkoutId, "Checkout failed — balance restored");
+            }
+        }
+    };
+    return {
+        key: "checkout.afterCreate",
+        handler: handler,
+    };
+}

package/dist/hooks/checkout-issuance.d.ts

@@ -0,0 +1,8 @@
+import type { PluginHookRegistration } from "@unifiedcommerce/core";
+import type { GiftCardService } from "../services/gift-card-service";
+import type { GiftCardPluginOptions } from "../types";
+/**
+ * checkout.afterCreate hook — issues gift cards when a gift card product is purchased.
+ */
+export declare function buildGiftCardIssuanceHook(service: GiftCardService, options: Required<GiftCardPluginOptions>, enqueueJob?: (slug: string, input: Record<string, unknown>) => Promise<string>): PluginHookRegistration;
+//# sourceMappingURL=checkout-issuance.d.ts.map

package/dist/hooks/checkout-issuance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-issuance.d.ts","sourceRoot":"","sources":["../../src/hooks/checkout-issuance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AA6BtD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACxC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAC7E,sBAAsB,CAqDxB"}

package/dist/hooks/checkout-issuance.js

@@ -0,0 +1,58 @@
+import { resolveOrgId } from "@unifiedcommerce/core";
+/**
+ * checkout.afterCreate hook — issues gift cards when a gift card product is purchased.
+ */
+export function buildGiftCardIssuanceHook(service, options, enqueueJob) {
+    const handler = async (args) => {
+        const { result, context } = args;
+        if (!result?.lineItems)
+            return;
+        const orgId = resolveOrgId(context.actor);
+        for (const item of result.lineItems) {
+            if (item.entityType !== options.productType)
+                continue;
+            const amount = item.totalPrice ?? (item.unitPrice ?? 0) * item.quantity;
+            if (amount <= 0)
+                continue;
+            const orderMeta = result.metadata;
+            const recipientEmail = orderMeta?.giftCardRecipientEmail ?? undefined;
+            const senderName = orderMeta?.giftCardSenderName ?? undefined;
+            const personalMessage = orderMeta?.giftCardPersonalMessage ?? undefined;
+            const createInput = {
+                amount,
+                currency: result.currency,
+                sourceOrderId: result.id,
+            };
+            if (result.customerId)
+                createInput.purchaserId = result.customerId;
+            if (recipientEmail)
+                createInput.recipientEmail = recipientEmail;
+            if (senderName)
+                createInput.senderName = senderName;
+            if (personalMessage)
+                createInput.personalMessage = personalMessage;
+            const cardResult = await service.create(orgId, createInput);
+            if (cardResult.ok && enqueueJob && recipientEmail) {
+                try {
+                    await enqueueJob("gift-card.deliver", {
+                        giftCardId: cardResult.value.id,
+                        code: cardResult.value.code,
+                        amount,
+                        currency: result.currency,
+                        recipientEmail,
+                        senderName: senderName ?? "",
+                        personalMessage: personalMessage ?? "",
+                        template: options.emailTemplate,
+                    });
+                }
+                catch {
+                    // Email delivery failure should not break checkout
+                }
+            }
+        }
+    };
+    return {
+        key: "checkout.afterCreate",
+        handler: handler,
+    };
+}

package/dist/hooks/refund-credit.d.ts

@@ -0,0 +1,7 @@
+import type { PluginHookRegistration } from "@unifiedcommerce/core";
+import type { GiftCardService } from "../services/gift-card-service";
+/**
+ * order.afterUpdate hook — restores gift card balances when an order is refunded.
+ */
+export declare function buildRefundCreditHook(service: GiftCardService): PluginHookRegistration;
+//# sourceMappingURL=refund-credit.d.ts.map

package/dist/hooks/refund-credit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refund-credit.d.ts","sourceRoot":"","sources":["../../src/hooks/refund-credit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAkBrE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,GACvB,sBAAsB,CA8BxB"}

package/dist/hooks/refund-credit.js

@@ -0,0 +1,25 @@
+import { resolveOrgId } from "@unifiedcommerce/core";
+/**
+ * order.afterUpdate hook — restores gift card balances when an order is refunded.
+ */
+export function buildRefundCreditHook(service) {
+    const handler = async (args) => {
+        const { result, context } = args;
+        if (!result)
+            return;
+        const status = result.status;
+        if (status !== "refunded" && status !== "cancelled")
+            return;
+        const deductions = result.metadata?.giftCardDeductions;
+        if (!deductions?.length)
+            return;
+        const orgId = resolveOrgId(context.actor);
+        for (const d of deductions) {
+            await service.creditWithLock(orgId, d.code, d.amount, result.id, `Order ${status} — balance restored`);
+        }
+    };
+    return {
+        key: "order.afterUpdate",
+        handler: handler,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { GiftCardPluginOptions } from "./types";
+export type { GiftCardPluginOptions } from "./types";
+export { GiftCardService } from "./services/gift-card-service";
+export declare function giftCardPlugin(userOptions?: GiftCardPluginOptions): import("@unifiedcommerce/core").CommercePlugin;
+/**
+ * Standalone factory for the plugin with hooks wired.
+ *
+ * Since hooks() runs before routes() (no DB context), we use a deferred
+ * service pattern: hooks capture a shared reference that gets populated
+ * when routes() runs with the real DB.
+ */
+export declare function giftCardPluginWithHooks(userOptions?: GiftCardPluginOptions): import("@unifiedcommerce/core").CommercePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAM,MAAM,SAAS,CAAC;AAGzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,wBAAgB,cAAc,CAAC,WAAW,GAAE,qBAA0B,kDAiDrE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,GAAE,qBAA0B,kDAqExC"}

package/dist/index.js

@@ -0,0 +1,110 @@
+import { defineCommercePlugin } from "@unifiedcommerce/core";
+import { giftCards, giftCardTransactions } from "./schema";
+import { GiftCardService } from "./services/gift-card-service";
+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 { DEFAULT_OPTIONS } from "./types";
+export { GiftCardService } from "./services/gift-card-service";
+export function giftCardPlugin(userOptions = {}) {
+    const options = {
+        ...DEFAULT_OPTIONS,
+        ...userOptions,
+        // Preserve null for defaultExpiryDays when user doesn't set it
+        defaultExpiryDays: userOptions.defaultExpiryDays ?? DEFAULT_OPTIONS.defaultExpiryDays,
+    };
+    return defineCommercePlugin({
+        id: "gift-cards",
+        version: "1.0.0",
+        permissions: [
+            {
+                scope: "gift-cards:admin",
+                description: "Create, list, disable, and adjust gift cards. Required for all admin routes.",
+            },
+        ],
+        schema: () => ({
+            giftCards,
+            giftCardTransactions,
+        }),
+        hooks: () => {
+            // Hooks are registered before the service is available (no DB context).
+            // They will be populated with the real service in routes() where ctx is available.
+            // For now, return empty — we'll wire them up via a shared reference.
+            return [];
+        },
+        routes: (ctx) => {
+            const db = ctx.database.db;
+            if (!db)
+                return [];
+            const service = new GiftCardService(db, ctx.database.transaction, options);
+            return [
+                ...buildAdminRoutes(service, ctx),
+                ...buildPublicRoutes(service, ctx),
+                ...buildCustomerRoutes(service, ctx),
+            ];
+        },
+    });
+}
+/**
+ * Standalone factory for the plugin with hooks wired.
+ *
+ * Since hooks() runs before routes() (no DB context), we use a deferred
+ * service pattern: hooks capture a shared reference that gets populated
+ * when routes() runs with the real DB.
+ */
+export function giftCardPluginWithHooks(userOptions = {}) {
+    const options = {
+        ...DEFAULT_OPTIONS,
+        ...userOptions,
+        defaultExpiryDays: userOptions.defaultExpiryDays ?? DEFAULT_OPTIONS.defaultExpiryDays,
+    };
+    // Shared mutable reference — populated when routes() runs
+    const serviceRef = { current: null };
+    return defineCommercePlugin({
+        id: "gift-cards",
+        version: "1.0.0",
+        permissions: [
+            {
+                scope: "gift-cards:admin",
+                description: "Create, list, disable, and adjust gift cards. Required for all admin routes.",
+            },
+        ],
+        schema: () => ({
+            giftCards,
+            giftCardTransactions,
+        }),
+        hooks: () => {
+            // Create a lazy proxy service that defers to serviceRef.current
+            const lazyService = new Proxy({}, {
+                get(_target, prop) {
+                    if (!serviceRef.current) {
+                        throw new Error("Gift card service not initialized — hooks ran before routes()");
+                    }
+                    return serviceRef.current[prop];
+                },
+            });
+            return [
+                buildCheckoutDeductionHook(lazyService),
+                buildCheckoutCompensationHook(lazyService),
+                buildGiftCardIssuanceHook(lazyService, options),
+                buildRefundCreditHook(lazyService),
+            ];
+        },
+        routes: (ctx) => {
+            const db = ctx.database.db;
+            if (!db)
+                return [];
+            const service = new GiftCardService(db, ctx.database.transaction, options);
+            // Wire up the shared reference so hooks can access the service
+            serviceRef.current = service;
+            return [
+                ...buildAdminRoutes(service, ctx),
+                ...buildPublicRoutes(service, ctx),
+                ...buildCustomerRoutes(service, ctx),
+            ];
+        },
+    });
+}

package/dist/routes/admin.d.ts

@@ -0,0 +1,9 @@
+import type { GiftCardService } from "../services/gift-card-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildAdminRoutes(service: GiftCardService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=admin.d.ts.map

package/dist/routes/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/routes/admin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CAyG3B"}

package/dist/routes/admin.js

@@ -0,0 +1,90 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+import { formatCode } from "../code-generator";
+export function buildAdminRoutes(service, ctx) {
+    const r = router("Gift Cards (Admin)", "/gift-cards", ctx);
+    // ─── Create Gift Card ─────────────────────────────────────────────
+    r.post("/")
+        .summary("Create gift card")
+        .permission("gift-cards:admin")
+        .input(z.object({
+        amount: z.number().int().positive().describe("Amount in minor units (cents)"),
+        currency: z.string().min(3).max(3).describe("ISO 4217 currency code"),
+        recipientEmail: z.string().email().optional(),
+        senderName: z.string().optional(),
+        personalMessage: z.string().max(500).optional(),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+    }))
+        .handler(async ({ input, orgId }) => {
+        const body = input;
+        const result = await service.create(orgId, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return {
+            ...result.value,
+            displayCode: formatCode(result.value.code),
+        };
+    });
+    // ─── List Gift Cards ──────────────────────────────────────────────
+    r.get("/")
+        .summary("List gift cards")
+        .permission("gift-cards:admin")
+        .query(z.object({
+        status: z.enum(["active", "disabled", "exhausted"]).optional(),
+        purchaserId: z.string().optional(),
+    }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const filters = {};
+        if (q.status === "active" || q.status === "disabled" || q.status === "exhausted") {
+            filters.status = q.status;
+        }
+        if (q.purchaserId)
+            filters.purchaserId = q.purchaserId;
+        const result = await service.list(orgId, filters);
+        if (!result.ok)
+            throw new Error("Failed to list gift cards");
+        return result.value;
+    });
+    // ─── Get Gift Card by ID ──────────────────────────────────────────
+    r.get("/{id}")
+        .summary("Get gift card details")
+        .permission("gift-cards:admin")
+        .handler(async ({ params, orgId }) => {
+        const cardResult = await service.getById(orgId, params.id);
+        if (!cardResult.ok)
+            throw new Error(cardResult.error);
+        const txnResult = await service.getTransactions(orgId, cardResult.value.id);
+        return {
+            ...cardResult.value,
+            displayCode: formatCode(cardResult.value.code),
+            transactions: txnResult.ok ? txnResult.value : [],
+        };
+    });
+    // ─── Disable Gift Card ────────────────────────────────────────────
+    r.post("/{id}/disable")
+        .summary("Disable gift card")
+        .permission("gift-cards:admin")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.disable(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    // ─── Manual Balance Adjustment ────────────────────────────────────
+    r.post("/{id}/adjust")
+        .summary("Adjust gift card balance")
+        .permission("gift-cards:admin")
+        .input(z.object({
+        delta: z.number().int().describe("Adjustment amount in minor units (positive=credit, negative=debit)"),
+        note: z.string().min(1).max(500).describe("Reason for adjustment"),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.adjust(orgId, params.id, body.delta, body.note);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/customer.d.ts

@@ -0,0 +1,9 @@
+import type { GiftCardService } from "../services/gift-card-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildCustomerRoutes(service: GiftCardService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=customer.d.ts.map

package/dist/routes/customer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.d.ts","sourceRoot":"","sources":["../../src/routes/customer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CAqB3B"}

package/dist/routes/customer.js

@@ -0,0 +1,23 @@
+import { router } from "@unifiedcommerce/core";
+import { formatCode } from "../code-generator";
+export function buildCustomerRoutes(service, ctx) {
+    const r = router("Gift Cards (Customer)", "/me/gift-cards", ctx);
+    // ─── List Customer's Gift Cards ───────────────────────────────────
+    r.get("/")
+        .summary("List my gift cards")
+        .auth()
+        .handler(async ({ actor, orgId }) => {
+        if (!actor)
+            throw new Error("Unauthorized");
+        const result = await service.list(orgId, { purchaserId: actor.userId });
+        if (!result.ok)
+            throw new Error("Failed to list gift cards");
+        return result.value.map((card) => ({
+            ...card,
+            displayCode: formatCode(card.code),
+            // Mask the full code for security — show only last 4 chars
+            maskedCode: `****-****-****-${card.code.slice(-4)}`,
+        }));
+    });
+    return r.routes();
+}

package/dist/routes/public.d.ts

@@ -0,0 +1,9 @@
+import type { GiftCardService } from "../services/gift-card-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildPublicRoutes(service: GiftCardService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=public.d.ts.map

package/dist/routes/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/routes/public.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CAsB3B"}

package/dist/routes/public.js

@@ -0,0 +1,21 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildPublicRoutes(service, ctx) {
+    const r = router("Gift Cards", "/gift-cards", ctx);
+    // ─── Check Balance (Public) ───────────────────────────────────────
+    r.post("/check-balance")
+        .summary("Check gift card balance")
+        .description("Public endpoint — no authentication required. Rate-limited.")
+        .input(z.object({
+        code: z.string().min(4).max(30).describe("Gift card code (hyphens optional)"),
+    }))
+        .handler(async ({ input }) => {
+        const body = input;
+        // Public endpoint: codes are globally unique, no org scoping needed
+        const result = await service.checkBalance("_any", body.code);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}