@revealui/core 0.0.1-pre.0

package/dist/core/targets/url/urlToFile.ts

@@ -0,0 +1,47 @@
+export { baseServer, urlToFile };
+
+import { assert } from "../../gaurds/assertions/assert/index.js";
+import { slice } from "../../utils/array/slice.js";
+import { parseUrl } from "./parseUrl.js";
+
+// - When doing a `.pageContext.json` HTTP request, the base URL should be preserved. (The server-side will handle the base URL.)
+// - While pre-rendering there is no base URL
+const baseServer = "/";
+
+function urlToFile(
+  url: string,
+  fileExtension: ".pageContext.json" | ".html",
+  doNotCreateExtraDirectory: boolean,
+) {
+  const { pathnameOriginal, searchOriginal, hashOriginal } = parseUrl(
+    url,
+    baseServer,
+  );
+  if (url.startsWith("/")) {
+    assert(
+      url === `${pathnameOriginal}${searchOriginal || ""}${hashOriginal || ""}`,
+      url,
+    );
+  }
+
+  const hasTrailingSlash = pathnameOriginal.endsWith("/");
+  let pathnameModified: string;
+  if (doNotCreateExtraDirectory && pathnameOriginal !== "/") {
+    if (hasTrailingSlash) {
+      pathnameModified = slice(pathnameOriginal, 0, -1);
+    } else {
+      pathnameModified = pathnameOriginal;
+    }
+    assert(!pathnameModified.endsWith("/"), url);
+    assert(pathnameModified !== "");
+  } else {
+    pathnameModified =
+      pathnameOriginal + (hasTrailingSlash ? "" : "/") + "index";
+  }
+  assert(pathnameModified);
+
+  pathnameModified = pathnameModified + fileExtension;
+
+  const fileUrl = `${pathnameModified}${searchOriginal || ""}${hashOriginal || ""}`;
+  return fileUrl;
+}

package/dist/core/types/UnifiedTypes.ts

@@ -0,0 +1,493 @@
+/**
+ * Unified Type System
+ *
+ * Consolidates all type definitions into a single system.
+ * Eliminates duplicate type definitions across 200+ files.
+ */
+
+// ======
+// CORE BASE TYPES
+// ======
+
+export interface BaseEntity {
+  id: string;
+  createdAt: Date;
+  updatedAt: Date;
+  version?: number;
+}
+
+export interface BaseUser extends BaseEntity {
+  email: string;
+  username?: string;
+  name?: string;
+  role: UserRole;
+  status: UserStatus;
+  avatar?: string;
+  bio?: string;
+  preferences?: UserPreferences;
+  twoFactorEnabled?: boolean;
+  lastPasswordChange?: Date;
+  loginAttempts?: number;
+  lockUntil?: Date;
+  activity?: UserActivity;
+}
+
+export interface BasePost extends BaseEntity {
+  title: string;
+  slug: string;
+  content: string;
+  excerpt?: string;
+  status: PostStatus;
+  publishedAt?: Date;
+  authorId: string;
+  categoryIds: string[];
+  tagIds: string[];
+  featuredImage?: string;
+  seoTitle?: string;
+  seoDescription?: string;
+  viewCount?: number;
+  likeCount?: number;
+  commentCount?: number;
+}
+
+// ======
+// ENUMS
+// ======
+
+export enum UserRole {
+  ADMIN = 'admin',
+  MODERATOR = 'moderator',
+  USER = 'user',
+  GUEST = 'guest',
+}
+
+export enum UserStatus {
+  ACTIVE = 'active',
+  INACTIVE = 'inactive',
+  SUSPENDED = 'suspended',
+  BANNED = 'banned',
+  PENDING = 'pending',
+}
+
+export enum PostStatus {
+  DRAFT = 'draft',
+  PUBLISHED = 'published',
+  ARCHIVED = 'archived',
+  DELETED = 'deleted',
+}
+
+export enum OrderStatus {
+  PENDING = 'pending',
+  CONFIRMED = 'confirmed',
+  PROCESSING = 'processing',
+  SHIPPED = 'shipped',
+  DELIVERED = 'delivered',
+  CANCELLED = 'cancelled',
+  REFUNDED = 'refunded',
+  PARTIALLY_REFUNDED = 'partially_refunded',
+}
+
+export enum PaymentStatus {
+  PENDING = 'pending',
+  PROCESSING = 'processing',
+  COMPLETED = 'completed',
+  FAILED = 'failed',
+  REFUNDED = 'refunded',
+}
+
+// ======
+// USER TYPES
+// ======
+
+export interface UserPreferences {
+  theme: 'light' | 'dark' | 'auto';
+  language: string;
+  timezone: string;
+  notifications: NotificationSettings;
+  privacy: PrivacySettings;
+}
+
+export interface NotificationSettings {
+  email: boolean;
+  push: boolean;
+  sms: boolean;
+  marketing: boolean;
+  security: boolean;
+  updates: boolean;
+}
+
+export interface PrivacySettings {
+  profileVisibility: 'public' | 'private' | 'friends';
+  showEmail: boolean;
+  showActivity: boolean;
+  allowMessages: boolean;
+}
+
+export interface UserActivity {
+  lastLogin?: Date;
+  lastActive?: Date;
+  loginCount: number;
+  sessionCount: number;
+  deviceCount: number;
+  location?: UserLocation;
+}
+
+export interface UserLocation {
+  country: string;
+  region: string;
+  city: string;
+  timezone: string;
+  coordinates?: {
+    latitude: number;
+    longitude: number;
+  };
+}
+
+// ======
+// POST TYPES
+// ======
+
+export interface PostMetadata {
+  wordCount: number;
+  readingTime: number;
+  tags: string[];
+  categories: string[];
+  featured: boolean;
+  sticky: boolean;
+  commentsEnabled: boolean;
+  trackbacksEnabled: boolean;
+}
+
+export interface PostSeo {
+  title?: string;
+  description?: string;
+  keywords?: string[];
+  canonicalUrl?: string;
+  ogImage?: string;
+  twitterCard?: string;
+}
+
+// ======
+// ECOMMERCE TYPES
+// ======
+
+export interface Product {
+  id: string;
+  name: string;
+  description: string;
+  sku: string;
+  price: number;
+  compareAtPrice?: number;
+  cost?: number;
+  status: ProductStatus;
+  inventory: Inventory;
+  images: ProductImage[];
+  variants: ProductVariant[];
+  categories: string[];
+  tags: string[];
+  seo: ProductSeo;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export enum ProductStatus {
+  ACTIVE = 'active',
+  DRAFT = 'draft',
+  ARCHIVED = 'archived',
+}
+
+export interface Inventory {
+  trackQuantity: boolean;
+  quantity: number;
+  allowBackorder: boolean;
+  sku: string;
+  barcode?: string;
+}
+
+export interface ProductImage {
+  id: string;
+  url: string;
+  alt?: string;
+  position: number;
+  featured: boolean;
+}
+
+export interface ProductVariant {
+  id: string;
+  name: string;
+  sku: string;
+  price: number;
+  compareAtPrice?: number;
+  cost?: number;
+  inventory: Inventory;
+  options: VariantOption[];
+}
+
+export interface VariantOption {
+  name: string;
+  value: string;
+}
+
+export interface ProductSeo {
+  title?: string;
+  description?: string;
+  keywords?: string[];
+}
+
+// ======
+// ORDER TYPES
+// ======
+
+export interface Order {
+  id: string;
+  orderNumber: string;
+  status: OrderStatus;
+  customer: Customer;
+  items: OrderItem[];
+  totals: OrderTotals;
+  shipping: ShippingInfo;
+  billing: BillingInfo;
+  payment: PaymentInfo;
+  notes?: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface Customer {
+  id: string;
+  email: string;
+  firstName: string;
+  lastName: string;
+  phone?: string;
+  company?: string;
+}
+
+export interface OrderItem {
+  id: string;
+  productId: string;
+  variantId?: string;
+  name: string;
+  sku: string;
+  quantity: number;
+  price: number;
+  total: number;
+  image?: string;
+}
+
+export interface OrderTotals {
+  subtotal: number;
+  tax: number;
+  shipping: number;
+  discount: number;
+  total: number;
+  currency: string;
+}
+
+export interface ShippingInfo {
+  firstName: string;
+  lastName: string;
+  company?: string;
+  address1: string;
+  address2?: string;
+  city: string;
+  state: string;
+  zip: string;
+  country: string;
+  phone?: string;
+}
+
+export interface BillingInfo {
+  firstName: string;
+  lastName: string;
+  company?: string;
+  address1: string;
+  address2?: string;
+  city: string;
+  state: string;
+  zip: string;
+  country: string;
+  phone?: string;
+}
+
+export interface PaymentInfo {
+  method: PaymentMethod;
+  status: PaymentStatus;
+  transactionId?: string;
+  gateway?: string;
+  amount: number;
+  currency: string;
+  processedAt?: Date;
+}
+
+export enum PaymentMethod {
+  CREDIT_CARD = 'credit_card',
+  DEBIT_CARD = 'debit_card',
+  PAYPAL = 'paypal',
+  STRIPE = 'stripe',
+  BANK_TRANSFER = 'bank_transfer',
+  CASH = 'cash',
+  CHECK = 'check',
+}
+
+// ======
+// CART TYPES
+// ======
+
+export interface Cart {
+  id: string;
+  userId?: string;
+  sessionId?: string;
+  items: CartItem[];
+  totals: CartTotals;
+  discounts: AppliedDiscount[];
+  shipping?: ShippingOption;
+  status: CartStatus;
+  expiresAt?: Date;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface CartItem {
+  id: string;
+  productId: string;
+  variantId?: string;
+  name: string;
+  sku: string;
+  quantity: number;
+  price: number;
+  total: number;
+  image?: string;
+  options?: Record<string, string>;
+}
+
+export interface CartTotals {
+  subtotal: number;
+  tax: number;
+  shipping: number;
+  discount: number;
+  total: number;
+  currency: string;
+}
+
+export interface AppliedDiscount {
+  id: string;
+  code: string;
+  type: DiscountType;
+  value: number;
+  description: string;
+  expiresAt?: Date;
+}
+
+export enum DiscountType {
+  PERCENTAGE = 'percentage',
+  FIXED = 'fixed',
+  FREE_SHIPPING = 'free_shipping',
+}
+
+export interface ShippingOption {
+  id: string;
+  name: string;
+  price: number;
+  estimatedDays: number;
+  description?: string;
+}
+
+export enum CartStatus {
+  ACTIVE = 'active',
+  CONVERTED = 'converted',
+  ABANDONED = 'abandoned',
+}
+
+// ======
+// API TYPES
+// ======
+
+export interface ApiResponse<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  message?: string;
+  meta?: ApiMeta;
+}
+
+export interface ApiMeta {
+  page?: number;
+  limit?: number;
+  total?: number;
+  totalPages?: number;
+  hasNext?: boolean;
+  hasPrev?: boolean;
+}
+
+export interface PaginationParams {
+  page?: number;
+  limit?: number;
+  sort?: string;
+  order?: 'asc' | 'desc';
+  search?: string;
+}
+
+// ======
+// TYPE GUARDS
+// ======
+
+export function isUserRole(value: unknown): value is UserRole {
+  return typeof value === 'string' && Object.values(UserRole).includes(value as UserRole);
+}
+
+export function isUserStatus(value: unknown): value is UserStatus {
+  return typeof value === 'string' && Object.values(UserStatus).includes(value as UserStatus);
+}
+
+export function isPostStatus(value: unknown): value is PostStatus {
+  return typeof value === 'string' && Object.values(PostStatus).includes(value as PostStatus);
+}
+
+export function isOrderStatus(value: unknown): value is OrderStatus {
+  return typeof value === 'string' && Object.values(OrderStatus).includes(value as OrderStatus);
+}
+
+export function isPaymentStatus(value: unknown): value is PaymentStatus {
+  return typeof value === 'string' && Object.values(PaymentStatus).includes(value as PaymentStatus);
+}
+
+export function isProductStatus(value: unknown): value is ProductStatus {
+  return typeof value === 'string' && Object.values(ProductStatus).includes(value as ProductStatus);
+}
+
+export function isCartStatus(value: unknown): value is CartStatus {
+  return typeof value === 'string' && Object.values(CartStatus).includes(value as CartStatus);
+}
+
+export function isPaymentMethod(value: unknown): value is PaymentMethod {
+  return typeof value === 'string' && Object.values(PaymentMethod).includes(value as PaymentMethod);
+}
+
+export function isDiscountType(value: unknown): value is DiscountType {
+  return typeof value === 'string' && Object.values(DiscountType).includes(value as DiscountType);
+}
+
+// ======
+// UTILITY TYPES
+// ======
+
+export type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+
+export type Required<T, K extends keyof T> = T & { [P in K]-?: T[P] };
+
+export type PartialExcept<T, K extends keyof T> = Partial<T> & Pick<T, K>;
+
+export type DeepPartial<T> = {
+  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+export type NonNullable<T> = T extends null | undefined ? never : T;
+
+export type ValueOf<T> = T[keyof T];
+
+export type KeysOfType<T, U> = {
+  [K in keyof T]: T[K] extends U ? K : never;
+}[keyof T];
+
+// All types, interfaces, enums, and functions are exported directly above - no re-export needed
+

package/dist/core/types/contracts.ts

@@ -0,0 +1,61 @@
+/**
+ * Local type definitions for contract types
+ * These are minimal definitions to avoid hard dependencies on application contracts
+ */
+
+// Error types
+export interface ErrorContext {
+  userId?: string;
+  requestId?: string;
+  [key: string]: unknown;
+}
+
+export interface ErrorDetails {
+  code?: string;
+  context?: ErrorContext;
+  metadata?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+// Logging types
+export interface BaseLogContext {
+  service?: string;
+  operation?: string;
+  userId?: string;
+  requestId?: string;
+  [key: string]: unknown;
+}
+
+export interface LogContext extends BaseLogContext {
+  [key: string]: unknown;
+}
+
+export interface LogMetadata {
+  level?: string;
+  timestamp?: string;
+  service?: string;
+  [key: string]: unknown;
+}
+
+// Service result types
+export interface ServiceResult<T> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  metadata?: Record<string, unknown>;
+}
+
+// Service types
+export interface ServiceConfig {
+  name: string;
+  [key: string]: unknown;
+}
+
+// API response types
+export interface ApiResponse<T> {
+  data?: T;
+  error?: string;
+  status?: number;
+  [key: string]: unknown;
+}
+