@absolutejs/commerce 0.5.0-beta.0 → 0.6.0-beta.0

package/dist/core/analytics.d.ts

@@ -0,0 +1,41 @@
+export type AnalyticsOrderLine = {
+    product: string;
+    quantity: number;
+    amountTotal: number;
+};
+export type AnalyticsOrder = {
+    amount_total: number | null;
+    created_at: Date | string;
+    status: string;
+    customer_email?: string | null;
+    line_items?: AnalyticsOrderLine[] | null;
+};
+export type DayRevenue = {
+    date: string;
+    revenueCents: number;
+    orders: number;
+};
+export type ProductRevenue = {
+    product: string;
+    quantity: number;
+    revenueCents: number;
+};
+export type SalesSummary = {
+    paidOrders: number;
+    revenueCents: number;
+    averageOrderCents: number;
+    statusCounts: Record<string, number>;
+    revenueByDay: DayRevenue[];
+    topProducts: ProductRevenue[];
+};
+/** Aggregate revenue, AOV, status mix, revenue-by-day, and top products. */
+export declare const salesSummary: (orders: AnalyticsOrder[]) => SalesSummary;
+export type CustomerSummary = {
+    email: string;
+    orders: number;
+    totalSpentCents: number;
+    firstOrderAt: string;
+    lastOrderAt: string;
+};
+/** Per-customer rollup (realized-revenue orders), newest activity first. */
+export declare const customerSummaries: (orders: AnalyticsOrder[]) => CustomerSummary[];

package/dist/drizzle/index.d.ts

@@ -1148,6 +1148,102 @@ export declare const commerceAbandonedCarts: import("drizzle-orm/pg-core").PgTab
     };
     dialect: "pg";
 }>;
+export declare const commerceGiftCards: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "gift_cards";
+    schema: undefined;
+    columns: {
+        balance_cents: import("drizzle-orm/pg-core").PgColumn<{
+            name: "balance_cents";
+            tableName: "gift_cards";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        code: import("drizzle-orm/pg-core").PgColumn<{
+            name: "code";
+            tableName: "gift_cards";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 40;
+        }>;
+        created_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "gift_cards";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        initial_cents: import("drizzle-orm/pg-core").PgColumn<{
+            name: "initial_cents";
+            tableName: "gift_cards";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        recipient_email: import("drizzle-orm/pg-core").PgColumn<{
+            name: "recipient_email";
+            tableName: "gift_cards";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 320;
+        }>;
+    };
+    dialect: "pg";
+}>;
 export declare const commerceFavorites: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "favorites";
     schema: undefined;
@@ -2125,6 +2221,102 @@ export declare const commerceDrizzleSchema: {
         };
         dialect: "pg";
     }>;
+    giftCards: import("drizzle-orm/pg-core").PgTableWithColumns<{
+        name: "gift_cards";
+        schema: undefined;
+        columns: {
+            balance_cents: import("drizzle-orm/pg-core").PgColumn<{
+                name: "balance_cents";
+                tableName: "gift_cards";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            code: import("drizzle-orm/pg-core").PgColumn<{
+                name: "code";
+                tableName: "gift_cards";
+                dataType: "string";
+                columnType: "PgVarchar";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: true;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                length: 40;
+            }>;
+            created_at: import("drizzle-orm/pg-core").PgColumn<{
+                name: "created_at";
+                tableName: "gift_cards";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            initial_cents: import("drizzle-orm/pg-core").PgColumn<{
+                name: "initial_cents";
+                tableName: "gift_cards";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            recipient_email: import("drizzle-orm/pg-core").PgColumn<{
+                name: "recipient_email";
+                tableName: "gift_cards";
+                dataType: "string";
+                columnType: "PgVarchar";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                length: 320;
+            }>;
+        };
+        dialect: "pg";
+    }>;
     orders: import("drizzle-orm/pg-core").PgTableWithColumns<{
         name: "orders";
         schema: undefined;

package/dist/drizzle/index.js

@@ -57,6 +57,29 @@ var saveDesign = async (db, design) => {
   const [created] = await db.insert(commerceSavedDesigns).values(design).returning();
   return created;
 };
+var issueGiftCard = async (db, input) => {
+  const [created] = await db.insert(commerceGiftCards).values({
+    balance_cents: input.cents,
+    code: input.code.trim().toUpperCase(),
+    initial_cents: input.cents,
+    recipient_email: input.recipientEmail ?? null
+  }).returning();
+  return created;
+};
+var getGiftCard = async (db, code) => {
+  const [card] = await db.select().from(commerceGiftCards).where(eq(commerceGiftCards.code, code.trim().toUpperCase())).limit(1);
+  return card ?? null;
+};
+var redeemGiftCard = async (db, code, amountCents) => {
+  const card = await getGiftCard(db, code);
+  if (!card)
+    return null;
+  const applied = Math.max(0, Math.min(card.balance_cents, amountCents));
+  const balance = card.balance_cents - applied;
+  if (applied > 0)
+    await db.update(commerceGiftCards).set({ balance_cents: balance }).where(eq(commerceGiftCards.code, card.code));
+  return { appliedCents: applied, balanceCents: balance };
+};
 var createReturnRequest = async (db, request) => {
   const [created] = await db.insert(commerceReturnRequests).values(request).returning();
   return created;
@@ -164,6 +187,13 @@ var commerceAbandonedCarts = pgTable("abandoned_carts", {
   recovered: boolean().notNull().default(false),
   reminded: boolean().notNull().default(false)
 });
+var commerceGiftCards = pgTable("gift_cards", {
+  balance_cents: integer().notNull(),
+  code: varchar({ length: 40 }).primaryKey(),
+  created_at: timestamp().notNull().defaultNow(),
+  initial_cents: integer().notNull(),
+  recipient_email: varchar({ length: 320 })
+});
 var commerceFavorites = pgTable("favorites", {
   created_at: timestamp().notNull().defaultNow(),
   customer_email: varchar({ length: 320 }).notNull(),
@@ -207,6 +237,7 @@ var commerceDrizzleSchema = {
   designs: commerceDesigns,
   discounts: commerceDiscounts,
   favorites: commerceFavorites,
+  giftCards: commerceGiftCards,
   orders: commerceOrders,
   quotes: commerceQuotes,
   returnRequests: commerceReturnRequests,
@@ -220,6 +251,7 @@ export {
   setReviewStatus,
   setReturnStatus,
   saveDesign,
+  redeemGiftCard,
   recordAbandonedCart,
   ratingSummaries,
   markReminded,
@@ -230,6 +262,8 @@ export {
   listFavorites,
   listApprovedReviews,
   listAllReviews,
+  issueGiftCard,
+  getGiftCard,
   findOrderForTracking,
   dueForReminder,
   deleteSavedDesign,
@@ -241,6 +275,7 @@ export {
   commerceReturnRequests,
   commerceQuotes,
   commerceOrders,
+  commerceGiftCards,
   commerceFavorites,
   commerceDrizzleSchema,
   commerceDiscounts,

package/dist/drizzle/queries.d.ts

@@ -1,5 +1,5 @@
 import type { PgDatabase } from 'drizzle-orm/pg-core';
-import { commerceFavorites, commerceReturnRequests, commerceReviews, commerceSavedDesigns } from './index';
+import { commerceFavorites, commerceGiftCards, commerceReturnRequests, commerceReviews, commerceSavedDesigns } from './index';
 export type CommerceDb = PgDatabase<any, any, any>;
 export type Review = typeof commerceReviews.$inferSelect;
 export type NewReview = typeof commerceReviews.$inferInsert;
@@ -8,6 +8,11 @@ export type SavedDesign = typeof commerceSavedDesigns.$inferSelect;
 export type NewSavedDesign = typeof commerceSavedDesigns.$inferInsert;
 export type ReturnRequest = typeof commerceReturnRequests.$inferSelect;
 export type NewReturnRequest = typeof commerceReturnRequests.$inferInsert;
+export type GiftCard = typeof commerceGiftCards.$inferSelect;
+export type GiftCardRedemption = {
+    appliedCents: number;
+    balanceCents: number;
+};
 export type RatingSummary = {
     productId: string;
     count: number;
@@ -962,6 +967,25 @@ export declare const saveDesign: (db: CommerceDb, design: NewSavedDesign) => Pro
     label: string | null;
     snapshot: Record<string, unknown>;
 } | undefined>;
+export declare const issueGiftCard: (db: CommerceDb, input: {
+    code: string;
+    cents: number;
+    recipientEmail?: string | null;
+}) => Promise<{
+    created_at: Date;
+    balance_cents: number;
+    code: string;
+    initial_cents: number;
+    recipient_email: string | null;
+} | undefined>;
+export declare const getGiftCard: (db: CommerceDb, code: string) => Promise<{
+    balance_cents: number;
+    code: string;
+    created_at: Date;
+    initial_cents: number;
+    recipient_email: string | null;
+} | null>;
+export declare const redeemGiftCard: (db: CommerceDb, code: string, amountCents: number) => Promise<GiftCardRedemption | null>;
 export declare const createReturnRequest: (db: CommerceDb, request: NewReturnRequest) => Promise<{
     status: string;
     created_at: Date;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './core/analytics';
 export * from './core/cart';
 export * from './core/discounts';
 export * from './core/email';

package/dist/index.js

@@ -1,4 +1,72 @@
 // @bun
+// src/core/analytics.ts
+var REVENUE_STATES = new Set(["paid", "shipped"]);
+var isoDay = (value) => {
+  const text = typeof value === "string" ? value : value.toISOString();
+  return text.slice(0, 10);
+};
+var salesSummary = (orders) => {
+  const statusCounts = {};
+  const byDay = new Map;
+  const byProduct = new Map;
+  let revenueCents = 0;
+  let paidOrders = 0;
+  for (const order of orders) {
+    statusCounts[order.status] = (statusCounts[order.status] ?? 0) + 1;
+    if (!REVENUE_STATES.has(order.status))
+      continue;
+    const amount = order.amount_total ?? 0;
+    revenueCents += amount;
+    paidOrders += 1;
+    const day = isoDay(order.created_at);
+    const existing = byDay.get(day) ?? { date: day, orders: 0, revenueCents: 0 };
+    existing.orders += 1;
+    existing.revenueCents += amount;
+    byDay.set(day, existing);
+    for (const line of order.line_items ?? []) {
+      const row = byProduct.get(line.product) ?? {
+        product: line.product,
+        quantity: 0,
+        revenueCents: 0
+      };
+      row.quantity += line.quantity;
+      row.revenueCents += line.amountTotal;
+      byProduct.set(line.product, row);
+    }
+  }
+  return {
+    averageOrderCents: paidOrders ? Math.round(revenueCents / paidOrders) : 0,
+    paidOrders,
+    revenueByDay: [...byDay.values()].sort((left, right) => left.date < right.date ? -1 : 1),
+    revenueCents,
+    statusCounts,
+    topProducts: [...byProduct.values()].sort((left, right) => right.revenueCents - left.revenueCents).slice(0, 8)
+  };
+};
+var customerSummaries = (orders) => {
+  const byEmail = new Map;
+  for (const order of orders) {
+    if (!order.customer_email || !REVENUE_STATES.has(order.status))
+      continue;
+    const email = order.customer_email.toLowerCase();
+    const at = isoDay(order.created_at);
+    const existing = byEmail.get(email) ?? {
+      email,
+      firstOrderAt: at,
+      lastOrderAt: at,
+      orders: 0,
+      totalSpentCents: 0
+    };
+    existing.orders += 1;
+    existing.totalSpentCents += order.amount_total ?? 0;
+    if (at < existing.firstOrderAt)
+      existing.firstOrderAt = at;
+    if (at > existing.lastOrderAt)
+      existing.lastOrderAt = at;
+    byEmail.set(email, existing);
+  }
+  return [...byEmail.values()].sort((left, right) => left.lastOrderAt < right.lastOrderAt ? 1 : -1);
+};
 // src/core/cart.ts
 var cartCount = (lines) => lines.reduce((sum, line) => sum + line.quantity, 0);
 var lineTotal = (line) => line.setupFee + line.unitPrice * line.quantity;
@@ -127,6 +195,7 @@ var DEFAULT_APPAREL_PARCEL = {
 export {
   toProductionStage,
   toCents,
+  salesSummary,
   roundMoney,
   renderEmail,
   quantityDiscount,
@@ -143,6 +212,7 @@ export {
   emailButton,
   discountAmountCents,
   depositCents,
+  customerSummaries,
   cartSubtotal,
   cartSetupTotal,
   cartCount,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/commerce",
-	"version": "0.5.0-beta.0",
+	"version": "0.6.0-beta.0",
 	"description": "Provider-agnostic commerce primitives (cart, orders, fulfillment, shipping) for AbsoluteJS",
 	"repository": {
 		"type": "git",