@unifiedcommerce/core 0.2.0 → 0.2.1

package/src/types/commerce-types.ts

@@ -0,0 +1,34 @@
+import type { sellableEntities } from "../modules/catalog/schema.js";
+import type { orders } from "../modules/orders/schema.js";
+import type { carts } from "../modules/cart/schema.js";
+import type { customers } from "../modules/customers/schema.js";
+import type { inventoryLevels } from "../modules/inventory/schema.js";
+
+/**
+ * Central type map for all commerce entities.
+ *
+ * Plugins can augment this interface via TypeScript module augmentation:
+ *
+ * ```typescript
+ * declare module "@unifiedcommerce/core" {
+ *   interface CommerceModuleTypes {
+ *     LoyaltyPoints: {
+ *       id: string;
+ *       customerId: string;
+ *       points: number;
+ *       tier: "bronze" | "silver" | "gold";
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * This enables plugin types to be referenced without importing
+ * internal schema modules.
+ */
+export interface CommerceModuleTypes {
+  Product: typeof sellableEntities.$inferSelect;
+  Order: typeof orders.$inferSelect;
+  Cart: typeof carts.$inferSelect;
+  Customer: typeof customers.$inferSelect;
+  InventoryLevel: typeof inventoryLevels.$inferSelect;
+}

package/src/utils/id.ts

@@ -0,0 +1,3 @@
+export function makeId(): string {
+  return crypto.randomUUID();
+}

package/src/utils/logger.ts

@@ -0,0 +1,18 @@
+import type { Logger } from "../kernel/hooks/types.js";
+
+export function createLogger(scope: string): Logger {
+  return {
+    info(message: string, data?: unknown) {
+      // eslint-disable-next-line no-console
+      console.info(`[${scope}] ${message}`, data ?? "");
+    },
+    warn(message: string, data?: unknown) {
+      // eslint-disable-next-line no-console
+      console.warn(`[${scope}] ${message}`, data ?? "");
+    },
+    error(message: string, data?: unknown) {
+      // eslint-disable-next-line no-console
+      console.error(`[${scope}] ${message}`, data ?? "");
+    },
+  };
+}

package/src/utils/pagination.ts

@@ -0,0 +1,22 @@
+export interface Pagination {
+  page: number;
+  limit: number;
+  total: number;
+  totalPages: number;
+}
+
+export function paginate<T>(items: T[], page: number, limit: number): { items: T[]; pagination: Pagination } {
+  const safeLimit = Math.max(1, limit);
+  const safePage = Math.max(1, page);
+  const start = (safePage - 1) * safeLimit;
+  const sliced = items.slice(start, start + safeLimit);
+  return {
+    items: sliced,
+    pagination: {
+      page: safePage,
+      limit: safeLimit,
+      total: items.length,
+      totalPages: Math.max(1, Math.ceil(items.length / safeLimit)),
+    },
+  };
+}