@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/core/server/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @rovela/sdk/core/server
+ *
+ * Server-only exports: configuration and database.
+ * Import from '@rovela/sdk/core/server' in API routes and server components.
+ *
+ * Usage:
+ * ```typescript
+ * import { getBlueprint, getStoreConfig } from '@rovela/sdk/core/server';
+ * import { db, findProducts, findOrders } from '@rovela/sdk/core/server';
+ * ```
+ */
+export { getBlueprint, getStoreConfig, loadBlueprint, getTheme, } from '../config';
+export type { Blueprint, BlueprintStore, BlueprintTheme, BlueprintBrand, BlueprintHomepage, BlueprintModules, BlueprintSEO, BlueprintMetadata, ColorScale, SemanticColors, ColorGradient, FontConfig, ProductType, BusinessStage, HomepageHero, HomepageFeature, HomepageTestimonial, HomepagePricingTier, HomepageFAQ, } from '../config';
+export { db, getDb, getSql, checkConnection, getConnectionInfo, schema, findProducts, findProductBySlug, findProductById, findProductVariants, countProducts, createProduct, updateProduct, deleteProduct, hardDeleteProduct, createProductVariant, updateProductVariant, deleteProductVariant, updateVariantInventory, findVariantById, findCategories, findCategoryBySlug, findCategoryById, countCategories, createCategory, updateCategory, deleteCategory, findOrders, findOrderById, findOrderItems, findOrderByPaymentIntent, countOrders, getRevenueByPeriod, getOrdersByStatus, createOrder, createOrderItems, updateOrderStatus, updateOrderReturnRequest, clearOrderReturnRequest, findCustomerByEmail, findCustomerById, findCustomers, countCustomers, findCustomerOrders, findAdminByEmail, getStoreStats, getLowStockProducts, getRecentOrders, findSettings, upsertSettings, ensureOnboardingColumn, getOnboardingState, setOnboardingFlag, getSetupGuideSignals, } from '../db';
+export type { OnboardingState } from '../db';
+export type { Product as DbProduct, NewProduct, ProductVariant as DbProductVariant, NewProductVariant, Category as DbCategory, NewCategory, Order as DbOrder, NewOrder, OrderItem as DbOrderItem, NewOrderItem, Customer as DbCustomer, NewCustomer, StoreAdmin as DbStoreAdmin, NewStoreAdmin, FindProductsOptions, FindOrdersOptions, } from '../db';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,QAAQ,GACT,MAAM,WAAW,CAAA;AAGlB,YAAY,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EAEjB,UAAU,EACV,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EAEb,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,GACZ,MAAM,WAAW,CAAA;AAGlB,OAAO,EAEL,EAAE,EACF,KAAK,EACL,MAAM,EAEN,eAAe,EACf,iBAAiB,EAEjB,MAAM,EAEN,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,aAAa,EAEb,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EAEjB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EAEf,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAEf,cAAc,EACd,cAAc,EACd,cAAc,EAEd,UAAU,EACV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EAEjB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EAEvB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,kBAAkB,EAElB,gBAAgB,EAEhB,aAAa,EACb,mBAAmB,EACnB,eAAe,EAEf,YAAY,EACZ,cAAc,EAEd,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,OAAO,CAAA;AAEd,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAG5C,YAAY,EACV,OAAO,IAAI,SAAS,EACpB,UAAU,EACV,cAAc,IAAI,gBAAgB,EAClC,iBAAiB,EACjB,QAAQ,IAAI,UAAU,EACtB,WAAW,EACX,KAAK,IAAI,OAAO,EAChB,QAAQ,EACR,SAAS,IAAI,WAAW,EACxB,YAAY,EACZ,QAAQ,IAAI,UAAU,EACtB,WAAW,EACX,UAAU,IAAI,YAAY,EAC1B,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,OAAO,CAAA"}

package/dist/core/server/index.js

@@ -0,0 +1,47 @@
+/**
+ * @rovela/sdk/core/server
+ *
+ * Server-only exports: configuration and database.
+ * Import from '@rovela/sdk/core/server' in API routes and server components.
+ *
+ * Usage:
+ * ```typescript
+ * import { getBlueprint, getStoreConfig } from '@rovela/sdk/core/server';
+ * import { db, findProducts, findOrders } from '@rovela/sdk/core/server';
+ * ```
+ */
+// Configuration - blueprint loading
+export { getBlueprint, getStoreConfig, loadBlueprint, getTheme, } from '../config';
+// Database - Neon client (each store has its own database via Neon branches)
+export { 
+// Client
+db, getDb, getSql, 
+// Health
+checkConnection, getConnectionInfo, 
+// Schema
+schema, 
+// Products (queries)
+findProducts, findProductBySlug, findProductById, findProductVariants, countProducts, 
+// Products (mutations)
+createProduct, updateProduct, deleteProduct, hardDeleteProduct, 
+// Product Variants (mutations)
+createProductVariant, updateProductVariant, deleteProductVariant, updateVariantInventory, findVariantById, 
+// Categories (queries)
+findCategories, findCategoryBySlug, findCategoryById, countCategories, 
+// Categories (mutations)
+createCategory, updateCategory, deleteCategory, 
+// Orders (queries)
+findOrders, findOrderById, findOrderItems, findOrderByPaymentIntent, countOrders, getRevenueByPeriod, getOrdersByStatus, 
+// Orders (mutations)
+createOrder, createOrderItems, updateOrderStatus, updateOrderReturnRequest, clearOrderReturnRequest, 
+// Customers (queries)
+findCustomerByEmail, findCustomerById, findCustomers, countCustomers, findCustomerOrders, 
+// Admins
+findAdminByEmail, 
+// Stats
+getStoreStats, getLowStockProducts, getRecentOrders, 
+// Store settings
+findSettings, upsertSettings, 
+// Setup guide — admin onboarding state
+ensureOnboardingColumn, getOnboardingState, setOnboardingFlag, getSetupGuideSignals, } from '../db';
+//# sourceMappingURL=index.js.map

package/dist/core/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oCAAoC;AACpC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,QAAQ,GACT,MAAM,WAAW,CAAA;AA2BlB,6EAA6E;AAC7E,OAAO;AACL,SAAS;AACT,EAAE,EACF,KAAK,EACL,MAAM;AACN,SAAS;AACT,eAAe,EACf,iBAAiB;AACjB,SAAS;AACT,MAAM;AACN,qBAAqB;AACrB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,aAAa;AACb,uBAAuB;AACvB,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB;AACjB,+BAA+B;AAC/B,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe;AACf,uBAAuB;AACvB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,eAAe;AACf,yBAAyB;AACzB,cAAc,EACd,cAAc,EACd,cAAc;AACd,mBAAmB;AACnB,UAAU,EACV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,kBAAkB,EAClB,iBAAiB;AACjB,qBAAqB;AACrB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB;AACvB,sBAAsB;AACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,kBAAkB;AAClB,SAAS;AACT,gBAAgB;AAChB,QAAQ;AACR,aAAa,EACb,mBAAmB,EACnB,eAAe;AACf,iBAAiB;AACjB,YAAY,EACZ,cAAc;AACd,uCAAuC;AACvC,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,OAAO,CAAA"}

package/dist/core/types.d.ts

@@ -0,0 +1,246 @@
+/**
+ * @rovela/sdk/core/types
+ *
+ * Shared type definitions for all SDK modules.
+ * These types represent the core e-commerce domain model.
+ */
+/**
+ * Store represents a tenant's e-commerce store.
+ */
+export type Store = {
+    id: string;
+    name: string;
+    slug: string;
+    ownerId: string;
+    stripeAccountId: string;
+    status: 'draft' | 'generating' | 'active' | 'paused';
+    deploymentUrl: string;
+    createdAt: Date;
+};
+/**
+ * Product with SEO fields for catalog display and search optimization.
+ */
+export type Product = {
+    id: string;
+    name: string;
+    slug: string;
+    description: string;
+    price: number;
+    comparePrice?: number;
+    images: string[];
+    videos: string[];
+    status: 'draft' | 'active' | 'archived';
+    categoryId?: string;
+    hasVariants: boolean;
+    sku?: string;
+    inventory?: number;
+    trackInventory?: boolean;
+    continueSellingWhenOutOfStock?: boolean;
+    productType?: string;
+    vendor?: string;
+    tags?: string[];
+    metaTitle?: string;
+    metaDescription?: string;
+    metaKeywords?: string[];
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type ProductStatus = Product['status'];
+/**
+ * ProductVariant with JSONB attributes for flexible customization.
+ * Attributes support dynamic variant types (color, size, material, etc.)
+ */
+export type ProductVariant = {
+    id: string;
+    productId: string;
+    sku: string;
+    name: string;
+    price?: number;
+    inventory: number;
+    attributes: Record<string, string>;
+    image?: string;
+    video?: string;
+    createdAt: Date;
+};
+/**
+ * Category for product organization with optional hierarchy.
+ */
+export type Category = {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    image?: string;
+    parentId?: string;
+    order: number;
+};
+/**
+ * Order status represents the lifecycle of an order.
+ */
+export type OrderStatus = 'pending' | 'paid' | 'shipped' | 'delivered' | 'cancelled' | 'refunded';
+/**
+ * Order represents a customer purchase.
+ */
+export type Order = {
+    id: string;
+    customerId?: string;
+    email: string;
+    status: OrderStatus;
+    subtotal: number;
+    tax: number;
+    shipping: number;
+    total: number;
+    shippingAddress: Address;
+    billingAddress?: Address;
+    stripePaymentIntentId: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * OrderItem represents a single line item in an order.
+ */
+export type OrderItem = {
+    id: string;
+    orderId: string;
+    productId: string;
+    variantId?: string;
+    name: string;
+    price: number;
+    quantity: number;
+    attributes?: Record<string, string>;
+};
+/**
+ * Customer represents a registered store customer.
+ */
+export type Customer = {
+    id: string;
+    email: string;
+    name?: string;
+    passwordHash: string;
+    stripeCustomerId?: string;
+    createdAt: Date;
+};
+/**
+ * StoreAdmin represents an admin user (separate from customers).
+ *
+ * Roles: 'owner' | 'administrator' | 'manager' | 'user'
+ *
+ * Status: 'active' | 'invited' | 'deactivated'
+ *   - 'invited' admins have no passwordHash until they claim their invite.
+ *   - 'deactivated' admins are blocked from signing in on their next request.
+ */
+export type StoreAdmin = {
+    id: string;
+    email: string;
+    name: string;
+    /** Null while the admin is in 'invited' status and hasn't set a password yet. */
+    passwordHash: string | null;
+    role: AdminRole;
+    status: AdminStatus;
+    /** UUID of the admin who invited this one. Null for the bootstrap owner. */
+    createdBy: string | null;
+    createdAt: Date;
+    lastLoginAt: Date | null;
+    deactivatedAt: Date | null;
+    deactivatedBy: string | null;
+};
+export type AdminRole = 'owner' | 'administrator' | 'manager' | 'user';
+export type AdminStatus = 'active' | 'invited' | 'deactivated';
+/**
+ * Address for shipping and billing.
+ */
+export type Address = {
+    firstName: string;
+    lastName: string;
+    line1: string;
+    line2?: string;
+    city: string;
+    state: string;
+    postalCode: string;
+    country: string;
+    phone?: string;
+    email?: string;
+};
+/**
+ * CartItem represents an item in the shopping cart.
+ */
+export type CartItem = {
+    id: string;
+    productId: string;
+    variantId?: string;
+    name: string;
+    price: number;
+    quantity: number;
+    image?: string;
+    attributes?: Record<string, string>;
+};
+/**
+ * StoreConfig loaded from blueprint.json at runtime.
+ */
+export type StoreConfig = {
+    name: string;
+    slug: string;
+    currency: string;
+    locale: string;
+    ownerEmail: string;
+};
+/**
+ * Paginated response wrapper for list endpoints.
+ */
+export type PaginatedResponse<T> = {
+    data: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+};
+/**
+ * Standard API error response.
+ */
+export type ApiError = {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+};
+/**
+ * ShippingZone represents a geographical region for shipping.
+ * Zones can target specific countries or use '*' for international catch-all.
+ */
+export type ShippingZone = {
+    id: string;
+    name: string;
+    countries: string[];
+    isActive: boolean;
+    sortOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * ShippingRate represents a shipping method within a zone.
+ * Rates can have min/max order amount constraints.
+ */
+export type ShippingRate = {
+    id: string;
+    zoneId: string;
+    name: string;
+    description?: string;
+    price: number;
+    minOrderAmount?: number;
+    maxOrderAmount?: number;
+    estimatedDays?: string;
+    isActive: boolean;
+    sortOrder: number;
+    createdAt: Date;
+};
+/**
+ * Shipping option returned from shipping calculation.
+ * Used during checkout to display available shipping methods.
+ */
+export type ShippingOption = {
+    id: string;
+    name: string;
+    description?: string;
+    price: number;
+    estimatedDays?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,8 @@
+/**
+ * @rovela/sdk/core/types
+ *
+ * Shared type definitions for all SDK modules.
+ * These types represent the core e-commerce domain model.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/utils.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @rovela/sdk/core/utils
+ *
+ * Utility functions for e-commerce stores
+ */
+import { type ClassValue } from 'clsx';
+/**
+ * Merge Tailwind CSS classes with clsx
+ * Handles conflicting classes intelligently
+ *
+ * @example
+ * cn('px-4 py-2', 'px-6') // => 'py-2 px-6'
+ * cn('bg-red-500', { 'bg-blue-500': isBlue }) // => 'bg-blue-500' if isBlue
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+export interface FormatPriceOptions {
+    currency?: string;
+    locale?: string;
+    showCents?: boolean;
+}
+/**
+ * Format a price for display with proper currency formatting
+ *
+ * @param price - Price in cents or as decimal (e.g., 1999 or 19.99)
+ * @param options - Formatting options
+ * @returns Formatted price string (e.g., "$19.99")
+ *
+ * @example
+ * formatPrice(1999) // => "$19.99"
+ * formatPrice(19.99, { currency: 'EUR', locale: 'de-DE' }) // => "19,99 €"
+ */
+export declare function formatPrice(price: number | string, options?: FormatPriceOptions): string;
+/**
+ * Parse a formatted price string back to a number
+ *
+ * @param priceString - Formatted price (e.g., "$19.99")
+ * @returns Price as a number (e.g., 19.99)
+ */
+export declare function parsePrice(priceString: string): number;
+/**
+ * Get the currency symbol for a given currency code
+ *
+ * @param currency - Currency code (e.g., 'USD', 'EUR', 'GBP')
+ * @param locale - Locale for formatting (e.g., 'en-US', 'de-DE')
+ * @returns Currency symbol (e.g., '$', '€', '£')
+ *
+ * @example
+ * getCurrencySymbol('USD') // => "$"
+ * getCurrencySymbol('EUR', 'de-DE') // => "€"
+ * getCurrencySymbol('GBP', 'en-GB') // => "£"
+ * getCurrencySymbol('JPY', 'ja-JP') // => "¥"
+ */
+export declare function getCurrencySymbol(currency?: string, locale?: string): string;
+/**
+ * Generate a URL-safe slug from a string
+ *
+ * @param text - Text to convert to slug
+ * @returns URL-safe slug
+ *
+ * @example
+ * generateSlug('Hello World!') // => 'hello-world'
+ * generateSlug('Product Name (2024)') // => 'product-name-2024'
+ */
+export declare function generateSlug(text: string): string;
+/**
+ * Generate a SKU (Stock Keeping Unit) from product details
+ *
+ * @param productName - Product name
+ * @param variant - Optional variant attributes
+ * @returns Generated SKU
+ *
+ * @example
+ * generateSKU('Blue T-Shirt') // => 'BLU-TSH-XXXX'
+ * generateSKU('Blue T-Shirt', { size: 'L', color: 'Blue' }) // => 'BLU-TSH-L-BLU-XXXX'
+ */
+export declare function generateSKU(productName: string, variant?: Record<string, string>): string;
+/**
+ * Format a date for display
+ *
+ * @param date - Date to format
+ * @param options - Intl.DateTimeFormat options
+ * @returns Formatted date string
+ */
+export declare function formatDate(date: Date | string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Format a date as relative time (e.g., "2 hours ago")
+ *
+ * @param date - Date to format
+ * @returns Relative time string
+ */
+export declare function formatRelativeTime(date: Date | string): string;
+/**
+ * Truncate text to a maximum length with ellipsis
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum length (default 100)
+ * @returns Truncated text with ellipsis if needed
+ */
+export declare function truncate(text: string, maxLength?: number): string;
+/**
+ * Capitalize the first letter of a string
+ */
+export declare function capitalize(text: string): string;
+/**
+ * Convert a string to title case
+ */
+export declare function titleCase(text: string): string;
+/**
+ * Clamp a number between min and max values
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Calculate percentage
+ */
+export declare function percentage(value: number, total: number): number;
+/**
+ * Validate an email address
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Validate a phone number (basic validation)
+ */
+export declare function isValidPhone(phone: string): boolean;
+/**
+ * Remove undefined and null values from an object
+ */
+export declare function compact<T extends Record<string, unknown>>(obj: T): Partial<T>;
+/**
+ * Pick specific keys from an object
+ */
+export declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Omit specific keys from an object
+ */
+export declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    delayMs?: number;
+}): Promise<T>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"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"}