@burdenoff/microfe-store 2026.714.7 → 2026.715.1

package/dist/types/index.d.ts

@@ -0,0 +1,575 @@
+/**
+ * Navigation item for shell integration
+ */
+export interface NavItem {
+    id: string;
+    label: string;
+    path: string;
+    icon?: React.ReactNode;
+    order?: number;
+    group?: string;
+    badge?: number;
+    children?: NavItem[];
+    visible?: boolean;
+}
+/**
+ * Footer item for shell integration
+ */
+export interface FooterItem {
+    id: string;
+    label: string;
+    path?: string;
+    onClick?: () => void;
+}
+/**
+ * Current user type
+ */
+export interface User {
+    id: string;
+    email: string;
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+    role?: string;
+    roles?: string[];
+    workspaceId?: string;
+    organizationId?: string;
+}
+/**
+ * Props for the StoreRoot component
+ */
+export interface StoreRootProps {
+    /**
+     * Base path for routing within the store microfrontend
+     */
+    basePath?: string;
+    /**
+     * Navigation function from the shell
+     */
+    navigate?: (path: string) => void;
+    /**
+     * Current authenticated user
+     */
+    currentUser?: User;
+    /**
+     * Alias for currentUser
+     */
+    user?: User;
+    /**
+     * Current workspace ID
+     */
+    workspaceId?: string;
+    /**
+     * Current organization ID
+     */
+    organizationId?: string;
+    /**
+     * API Gateway URL for GraphQL requests
+     */
+    apiGatewayUrl?: string;
+    /**
+     * Authentication token for GraphQL requests
+     */
+    authToken?: string;
+    /**
+     * Optional callback when a product is purchased
+     */
+    onProductPurchase?: (product: ProductSummary) => void;
+    /**
+     * Optional callback when an app is installed
+     */
+    onAppInstall?: (installation: InstallationSummary) => void;
+    /**
+     * Optional callback when a product is submitted (for publishers)
+     */
+    onProductSubmit?: (submission: SubmissionSummary) => void;
+    /**
+     * Optional function to register navigation items with the shell
+     * Injected by the shell app
+     */
+    registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+    /**
+     * Optional function to register footer items with the shell
+     * Injected by the shell app
+     */
+    registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+    /**
+     * Optional initial cart items
+     */
+    initialCartItems?: CartItem[];
+    /**
+     * Optional feature flags
+     */
+    features?: {
+        enablePhysicalProducts?: boolean;
+        enablePublisherPortal?: boolean;
+        enableReviews?: boolean;
+        enableSubscriptions?: boolean;
+    };
+    /**
+     * Host product identifier (e.g., "bigconsole", "workspaces", "fluidgrids").
+     * Used to scope the store experience to the host product.
+     */
+    productId?: string;
+    /**
+     * Product name for display purposes (e.g., "BigConsole", "Burdenoff Workspaces").
+     */
+    productName?: string;
+    /**
+     * Default compatibleWith filter applied to all store queries.
+     * When set, only products compatible with this value are shown.
+     * Example: "bigconsole" to show only BigConsole-compatible items.
+     */
+    defaultCompatibleWith?: string;
+    /**
+     * Current tenant ID
+     */
+    tenantId?: string;
+}
+/**
+ * Props for the StoreAdminRoot component (admin shell only).
+ *
+ * Subset of StoreRootProps — omits user-flow concerns like cart,
+ * purchase callbacks, and feature flags.
+ */
+export interface StoreAdminRootProps {
+    basePath?: string;
+    navigate?: (path: string) => void;
+    currentUser?: User;
+    user?: User;
+    workspaceId?: string;
+    organizationId?: string;
+    apiGatewayUrl?: string;
+    authToken?: string;
+    registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+    registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+}
+/**
+ * Product item types
+ */
+export type ItemType = 'APP' | 'WORKFLOW' | 'TEMPLATE' | 'INTEGRATION' | 'EXTENSION' | 'THEME' | 'PHYSICAL' | 'BUNDLE';
+/**
+ * Product types for apps
+ */
+export type ProductType = 'WORKSPACE_MODULE' | 'TENANT_MODULE' | 'STANDALONE_APP' | 'BROWSER_EXTENSION' | 'CODE_EXTENSION' | 'CLI_TOOL' | 'API_INTEGRATION' | 'WORKFLOW_TEMPLATE' | 'UI_THEME' | 'PHYSICAL_GOODS';
+/**
+ * Pricing models
+ */
+export type PricingModel = 'FREE' | 'ONE_TIME' | 'SUBSCRIPTION' | 'USAGE_BASED' | 'FREEMIUM' | 'PAY_WHAT_YOU_WANT';
+/**
+ * Product status
+ */
+export type ProductStatus = 'DRAFT' | 'PENDING_REVIEW' | 'APPROVED' | 'PUBLISHED' | 'REJECTED' | 'DEPRECATED' | 'UNLISTED';
+/**
+ * Subscription status
+ */
+export type SubscriptionStatus = 'ACTIVE' | 'PAST_DUE' | 'CANCELED' | 'UNPAID' | 'TRIALING';
+/**
+ * Installation status
+ */
+export type InstallationStatus = 'PENDING' | 'INSTALLING' | 'CONFIGURING' | 'ACTIVE' | 'INACTIVE' | 'FAILED' | 'UNINSTALLING';
+/**
+ * License types
+ */
+export type LicenseType = 'PERPETUAL' | 'SUBSCRIPTION' | 'TRIAL' | 'SITE' | 'FLOATING' | 'CONCURRENT';
+/**
+ * License status
+ */
+export type LicenseStatus = 'ACTIVE' | 'EXPIRED' | 'REVOKED' | 'SUSPENDED' | 'PENDING_ACTIVATION';
+/**
+ * Order status
+ */
+export type OrderStatus = 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REFUNDED' | 'PARTIALLY_REFUNDED';
+/**
+ * Shipment status
+ */
+export type ShipmentStatus = 'PENDING' | 'PROCESSING' | 'SHIPPED' | 'IN_TRANSIT' | 'DELIVERED' | 'FAILED' | 'RETURNED';
+/**
+ * Review status
+ */
+export type ReviewStatus = 'PENDING' | 'APPROVED' | 'REJECTED' | 'FLAGGED';
+/**
+ * Submission status
+ */
+export type SubmissionStatus = 'DRAFT' | 'PENDING' | 'UNDER_REVIEW' | 'APPROVED' | 'REJECTED' | 'CHANGES_REQUESTED';
+/**
+ * Payment gateway types
+ */
+export type PaymentGateway = 'STRIPE' | 'RAZORPAY' | 'PAYPAL' | 'UPI';
+/**
+ * View modes
+ */
+export type ViewMode = 'grid' | 'list';
+/**
+ * Sort options
+ */
+export type SortBy = 'relevance' | 'rating' | 'price-asc' | 'price-desc' | 'downloads' | 'newest' | 'popular';
+/**
+ * Product category
+ */
+export interface Category {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    iconUrl?: string;
+    parentId?: string;
+    order: number;
+}
+/**
+ * Publisher
+ */
+export interface Publisher {
+    id: string;
+    name: string;
+    displayName: string;
+    website?: string;
+    email: string;
+    verified: boolean;
+    description?: string;
+    logoUrl?: string;
+    totalProducts: number;
+    totalDownloads: number;
+    averageRating: number;
+    joinedAt: string;
+}
+/**
+ * Product variant (version)
+ */
+export interface ProductVariant {
+    id: string;
+    name: string;
+    sku: string;
+    version: string;
+    changelog?: string;
+    releaseNotes?: string;
+    downloadUrl?: string;
+    fileSize?: number;
+    price: number;
+    compareAtPrice?: number;
+    available: boolean;
+    stockQuantity?: number;
+    releasedAt: string;
+}
+/**
+ * Product
+ */
+export interface Product {
+    id: string;
+    publisherId: string;
+    publisher: Publisher;
+    name: string;
+    slug: string;
+    displayName: string;
+    description: string;
+    shortDescription: string;
+    iconUrl?: string;
+    screenshotUrls: string[];
+    videoUrls: string[];
+    itemType: ItemType;
+    type: ProductType;
+    manifest?: Record<string, unknown>;
+    manifestVersion?: string;
+    manifestCapabilities?: string[];
+    manifestPermissions?: string[];
+    manifestPlatforms?: string[];
+    category?: Category;
+    tags: string[];
+    pricingModel: PricingModel;
+    basePrice: number;
+    currency: string;
+    variants: ProductVariant[];
+    status: ProductStatus;
+    featured: boolean;
+    verified: boolean;
+    websiteUrl?: string;
+    supportUrl?: string;
+    privacyPolicyUrl?: string;
+    termsOfServiceUrl?: string;
+    downloadCount: number;
+    installCount: number;
+    orderCount: number;
+    averageRating: number;
+    reviewCount: number;
+    createdAt: string;
+    updatedAt: string;
+    publishedAt?: string;
+}
+/**
+ * Product summary for callbacks
+ */
+export interface ProductSummary {
+    id: string;
+    name: string;
+    price: number;
+    itemType: ItemType;
+}
+/**
+ * Cart item
+ */
+export interface CartItem {
+    id: string;
+    productId: string;
+    product?: Product;
+    variantId?: string;
+    variant?: ProductVariant;
+    quantity: number;
+    unitPrice: number;
+    totalPrice: number;
+    itemType: 'digital' | 'physical' | 'bundle';
+}
+/**
+ * Shopping cart
+ */
+export interface Cart {
+    id: string;
+    userId: string;
+    items: CartItem[];
+    subtotal: number;
+    tax: number;
+    total: number;
+    itemCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Address
+ */
+export interface Address {
+    line1: string;
+    line2?: string;
+    city: string;
+    state: string;
+    postalCode: string;
+    country: string;
+}
+/**
+ * Shipping method
+ */
+export interface ShippingMethod {
+    id: string;
+    name: string;
+    description?: string;
+    price: number;
+    estimatedDays: number;
+}
+/**
+ * Checkout session
+ */
+export interface Checkout {
+    id: string;
+    cartId: string;
+    cart?: Cart;
+    shippingAddress?: Address;
+    billingAddress?: Address;
+    shippingMethod?: ShippingMethod;
+    subtotal: number;
+    shippingCost: number;
+    tax: number;
+    total: number;
+    status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED';
+}
+/**
+ * Order
+ */
+export interface Order {
+    id: string;
+    orderNumber: string;
+    userId: string;
+    cartId: string;
+    items: CartItem[];
+    subtotal: number;
+    shippingCost: number;
+    tax: number;
+    total: number;
+    status: OrderStatus;
+    paymentGateway: PaymentGateway;
+    paymentId?: string;
+    shippingAddress?: Address;
+    billingAddress?: Address;
+    trackingNumber?: string;
+    shipmentStatus?: ShipmentStatus;
+    completedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Installation
+ */
+export interface Installation {
+    id: string;
+    productId: string;
+    product?: Product;
+    workspaceId: string;
+    userId: string;
+    status: InstallationStatus;
+    installedVersion: string;
+    latestVersion?: string;
+    configData?: Record<string, unknown>;
+    permissions: string[];
+    credentials?: Record<string, string>;
+    usageMetrics?: {
+        apiCalls: number;
+        storage: number;
+        users: number;
+    };
+    lastUsedAt?: string;
+    installedAt: string;
+    updatedAt: string;
+}
+/**
+ * Installation summary for callbacks
+ */
+export interface InstallationSummary {
+    id: string;
+    productId: string;
+    productName: string;
+    status: InstallationStatus;
+}
+/**
+ * License
+ */
+export interface License {
+    id: string;
+    productId: string;
+    product?: Product;
+    userId: string;
+    licenseKey: string;
+    type: LicenseType;
+    status: LicenseStatus;
+    maxActivations: number;
+    activeActivations: number;
+    expiresAt?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * License activation (device)
+ */
+export interface LicenseActivation {
+    id: string;
+    licenseId: string;
+    deviceId: string;
+    deviceName: string;
+    platform?: string;
+    activatedAt: string;
+    lastSeenAt?: string;
+}
+/**
+ * Review
+ */
+export interface Review {
+    id: string;
+    productId: string;
+    userId: string;
+    userName?: string;
+    rating: number;
+    comment?: string;
+    screenshots?: string[];
+    status: ReviewStatus;
+    helpful: number;
+    notHelpful: number;
+    verified: boolean;
+    publisherResponse?: string;
+    publisherResponseAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Product submission
+ */
+export interface Submission {
+    id: string;
+    productId: string;
+    product?: Product;
+    publisherId: string;
+    version: string;
+    manifest: Record<string, unknown>;
+    status: SubmissionStatus;
+    reviewerNotes?: string;
+    submittedAt: string;
+    reviewedAt?: string;
+    approvedAt?: string;
+}
+/**
+ * Submission summary for callbacks
+ */
+export interface SubmissionSummary {
+    id: string;
+    productId: string;
+    productName: string;
+    status: SubmissionStatus;
+}
+/**
+ * Revenue metrics
+ */
+export interface RevenueMetrics {
+    totalRevenue: number;
+    periodRevenue: number;
+    totalDownloads: number;
+    periodDownloads: number;
+    averageRating: number;
+    totalReviews: number;
+    currency: string;
+    period: 'day' | 'week' | 'month' | 'year';
+}
+/**
+ * Product filter input
+ */
+export interface ProductFilter {
+    itemType?: ItemType[];
+    category?: string;
+    priceRange?: {
+        min: number;
+        max: number;
+    };
+    rating?: number;
+    capabilities?: string[];
+    platforms?: string[];
+    pricingModel?: PricingModel[];
+    verified?: boolean;
+    featured?: boolean;
+    search?: string;
+}
+/**
+ * Product sort input
+ */
+export interface ProductSort {
+    field: 'RELEVANCE' | 'RATING' | 'PRICE' | 'DOWNLOADS' | 'CREATED_AT';
+    direction: 'ASC' | 'DESC';
+}
+/**
+ * Pagination info
+ */
+export interface PageInfo {
+    hasNextPage: boolean;
+    hasPreviousPage?: boolean;
+    totalCount: number;
+}
+/**
+ * Paginated products
+ */
+export interface ProductConnection {
+    edges: Array<{
+        node: Product;
+        cursor?: string;
+    }>;
+    pageInfo: PageInfo;
+}
+/**
+ * GraphQL error
+ */
+export interface GraphQLError {
+    field?: string;
+    message: string;
+    code?: string;
+}
+/**
+ * Mutation result
+ */
+export interface MutationResult<T> {
+    data?: T;
+    errors?: GraphQLError[];
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Format price with currency
+ */
+export declare function formatPrice(price: number, currency?: string): string;
+/**
+ * Format price honoring a pricing model. Returns "Free" for FREE model.
+ */
+export declare function formatPriceForModel(price: number, currency: string, model: string): string;
+/**
+ * Format number with abbreviation (1.2K, 3.4M, etc.)
+ */
+export declare function formatNumber(num: number): string;
+/**
+ * Calculate cart totals
+ */
+export declare function calculateCartTotals(items: Array<{
+    quantity: number;
+    unitPrice: number;
+}>, taxRate?: number): {
+    subtotal: number;
+    tax: number;
+    total: number;
+};
+/**
+ * Generate rating stars array
+ */
+export declare function getRatingStars(rating: number): Array<'full' | 'half' | 'empty'>;
+/**
+ * Get item type display name
+ */
+export declare function getItemTypeName(itemType: string): string;
+/**
+ * Get pricing model display name
+ */
+export declare function getPricingModelName(model: string): string;
+/**
+ * Get status color variant
+ */
+export declare function getStatusColor(status: string): 'default' | 'success' | 'warning' | 'error' | 'info';
+/**
+ * Validate license key format
+ */
+export declare function validateLicenseKey(key: string): boolean;
+/**
+ * Mask license key for display
+ */
+export declare function maskLicenseKey(key: string): string;
+/**
+ * Calculate days until expiry
+ */
+export declare function getDaysUntilExpiry(expiryDate: string): number;
+/**
+ * Check if license is expiring soon (within 30 days)
+ */
+export declare function isLicenseExpiringSoon(expiryDate: string): boolean;
+/**
+ * Format file size
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Generate unique cart item ID
+ */
+export declare function generateCartItemId(productId: string, variantId?: string): string;
+/**
+ * Debounce function
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Truncate text with ellipsis
+ */
+export declare function truncate(text: string, maxLength: number): string;

package/dist/utils/nativeBridge.d.ts

@@ -0,0 +1,2 @@
+export { getPlatform, isNative, isIOS, isAndroid, isWeb, nativeImpact, nativeNotify, nativeToast, nativeConfirm, nativeCopyText, nativeShare, nativeOpenUrl, useNativePlatform, useSafeArea, useNativeKeyboard, useAppState, useDeviceInfo, useHaptics, useStatusBar, } from '@burdenoff/fe-libs/shared/native';
+export type { BurdenoffNativePlatform, BurdenoffNativeBridge, SafeAreaInsets, DeviceInfo, HapticImpactStyle, HapticNotificationType, ToastDuration, ConfirmOptions, ShareOptions, AppState, StatusBarTheme, } from '@burdenoff/fe-libs/shared/native';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-store",
-  "version": "2026.714.7",
+  "version": "2026.715.1",
   "description": "Store microfrontend for Burdenoff products",
   "type": "module",
   "files": [
@@ -22,7 +22,7 @@
   "types": "./dist/index.d.ts",
   "scripts": {
     "dev": "vite",
-    "build": "tsc && vite build",
+    "build": "tsc && MFE_DTS=1 vite build",
     "lint": "eslint .",
     "lint:sanity": "if [ \"${CI:-}\" = \"true\" ]; then bun run lint; else bun run lint -- --cache --cache-location .eslintcache; fi",
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",