@burdenoff/microfe-store 2026.714.7 → 2026.715.1

package/dist/hooks/useStoreGraphQL.d.ts

@@ -0,0 +1,481 @@
+import { BrowseStoreInput, StoreProductDetailsInput } from '../generated/global-types';
+
+type ProductType = 'APP' | 'TEMPLATE' | 'THEME' | 'INTEGRATION' | 'WIDGET' | 'DATASET';
+type CreateReviewInput = {
+    productId: string;
+    rating: number;
+    title?: string;
+    comment?: string;
+};
+type UpdateReviewInput = {
+    rating?: number;
+    title?: string;
+    comment?: string;
+};
+interface StoreProduct {
+    id: string;
+    name: string;
+    slug: string;
+    type: string;
+    nature: string;
+    status: string;
+    description?: string;
+    pricingModel: string;
+    price: number;
+    currency: string;
+    icon?: string;
+    screenshots: string[];
+    rating?: number;
+    reviewCount: number;
+    downloads: number;
+    featured: boolean;
+    category?: string;
+    tags?: string[];
+    publishedAt?: string;
+    publisher?: {
+        id: string;
+        name: string;
+        isVerified: boolean;
+        logoUrl?: string;
+    };
+}
+interface BrowseStoreResult {
+    products: StoreProduct[];
+    totalCount: number;
+    hasMore: boolean;
+    nextCursor?: string;
+    facets?: {
+        types: {
+            value: string;
+            count: number;
+        }[];
+        subTypes: {
+            value: string;
+            count: number;
+        }[];
+        categories: {
+            value: string;
+            count: number;
+        }[];
+        pricingModels: {
+            value: string;
+            count: number;
+        }[];
+        licenses: {
+            value: string;
+            count: number;
+        }[];
+        priceRange?: {
+            min: number;
+            max: number;
+        };
+        ratingDistribution?: {
+            fiveStars: number;
+            fourStars: number;
+            threeStars: number;
+            twoStars: number;
+            oneStar: number;
+        };
+    };
+}
+interface ProductReview {
+    id: string;
+    productId: string;
+    userId: string;
+    rating: number;
+    title?: string;
+    comment?: string;
+    status: string;
+    helpful: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ProductCategory {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    icon?: string;
+    parentId?: string;
+}
+interface SearchSuggestion {
+    term: string;
+    type: string;
+    count: number;
+    highlight?: string;
+}
+interface GroupedProducts {
+    featured: StoreProduct[];
+    mostDownloaded: StoreProduct[];
+    recentlyAdded: StoreProduct[];
+    freeItems: StoreProduct[];
+}
+/**
+ * Hook to browse/search store products with filters
+ * Uses Apollo Client from context
+ */
+export declare function useBrowseStore(input?: BrowseStoreInput): {
+    products: StoreProduct[];
+    totalCount: number;
+    hasMore: boolean;
+    facets: {
+        types: {
+            value: string;
+            count: number;
+        }[];
+        subTypes: {
+            value: string;
+            count: number;
+        }[];
+        categories: {
+            value: string;
+            count: number;
+        }[];
+        pricingModels: {
+            value: string;
+            count: number;
+        }[];
+        licenses: {
+            value: string;
+            count: number;
+        }[];
+        priceRange?: {
+            min: number;
+            max: number;
+        };
+        ratingDistribution?: {
+            fiveStars: number;
+            fourStars: number;
+            threeStars: number;
+            twoStars: number;
+            oneStar: number;
+        };
+    } | undefined;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to browse/search store products with organization context.
+ * Uses organization-aware GraphQL client with automatic headers.
+ * Automatically applies defaultCompatibleWith from store context
+ * to the filter if not already specified in the input.
+ */
+export declare function useBrowseStoreWithContext(input?: BrowseStoreInput, options?: {
+    skip?: boolean;
+}): {
+    products: StoreProduct[];
+    totalCount: number;
+    hasMore: boolean;
+    facets: {
+        types: {
+            value: string;
+            count: number;
+        }[];
+        subTypes: {
+            value: string;
+            count: number;
+        }[];
+        categories: {
+            value: string;
+            count: number;
+        }[];
+        pricingModels: {
+            value: string;
+            count: number;
+        }[];
+        licenses: {
+            value: string;
+            count: number;
+        }[];
+        priceRange?: {
+            min: number;
+            max: number;
+        };
+        ratingDistribution?: {
+            fiveStars: number;
+            fourStars: number;
+            threeStars: number;
+            twoStars: number;
+            oneStar: number;
+        };
+    } | undefined;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    loadMore: () => void;
+};
+/**
+ * Lazy hook to browse store on demand
+ */
+export declare function useLazyBrowseStore(): {
+    browseStore: (input?: BrowseStoreInput) => Promise<BrowseStoreResult | null | undefined>;
+    products: StoreProduct[];
+    totalCount: number;
+    hasMore: boolean;
+    facets: {
+        types: {
+            value: string;
+            count: number;
+        }[];
+        subTypes: {
+            value: string;
+            count: number;
+        }[];
+        categories: {
+            value: string;
+            count: number;
+        }[];
+        pricingModels: {
+            value: string;
+            count: number;
+        }[];
+        licenses: {
+            value: string;
+            count: number;
+        }[];
+        priceRange?: {
+            min: number;
+            max: number;
+        };
+        ratingDistribution?: {
+            fiveStars: number;
+            fourStars: number;
+            threeStars: number;
+            twoStars: number;
+            oneStar: number;
+        };
+    } | undefined;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to fetch product details for product page
+ */
+export declare function useStoreProductDetails(input: StoreProductDetailsInput): {
+    data: unknown;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Lazy hook to fetch product details on demand
+ */
+export declare function useLazyStoreProductDetails(): {
+    getProductDetails: (input: StoreProductDetailsInput) => Promise<{
+        product: StoreProduct;
+        publisher?: {
+            id: string;
+            name: string;
+            isVerified: boolean;
+            logoUrl?: string;
+        };
+        relatedProducts?: StoreProduct[];
+        reviews?: ProductReview[];
+    } | null>;
+    data: unknown;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to fetch grouped products for homepage.
+ */
+export declare function useHomeGroupedProducts(options?: {
+    skip?: boolean;
+}): {
+    data: GroupedProducts | null;
+    featured: StoreProduct[];
+    mostDownloaded: StoreProduct[];
+    recentlyAdded: StoreProduct[];
+    freeItems: StoreProduct[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch featured products
+ */
+export declare function useFeaturedProducts(limit?: number): {
+    products: StoreProduct[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch search suggestions for autocomplete
+ */
+export declare function useSearchSuggestions(query: string, options?: {
+    limit?: number;
+    types?: string[];
+}): {
+    suggestions: SearchSuggestion[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Lazy hook to fetch search suggestions on demand
+ */
+export declare function useLazySearchSuggestions(): {
+    getSuggestions: (query: string, options?: {
+        limit?: number;
+        types?: string[];
+    }) => Promise<SearchSuggestion[]>;
+    suggestions: SearchSuggestion[];
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to fetch trending search terms
+ */
+export declare function useTrendingSearches(options?: {
+    limit?: number;
+    type?: ProductType;
+}): {
+    terms: string[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch filter options for dropdowns
+ */
+export declare function useFilterOptions(options?: {
+    type?: ProductType;
+    withProducts?: boolean;
+}): {
+    filterOptions: unknown;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch all categories
+ */
+export declare function useCategories(): {
+    categories: ProductCategory[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch reviews for a product
+ */
+export declare function useProductReviews(productId: string, options?: {
+    status?: string;
+}): {
+    reviews: ProductReview[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch current user's review for a product
+ */
+export declare function useUserReviewForProduct(productId: string): {
+    review: ProductReview | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to create a review
+ */
+export declare function useCreateReview(): {
+    createReview: (input: CreateReviewInput) => Promise<{
+        data: ProductReview | null;
+        errorMessage: null;
+    } | {
+        data: null;
+        errorMessage: string;
+    }>;
+    review: ProductReview | null;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to update a review
+ */
+export declare function useUpdateReview(): {
+    updateReview: (id: string, input: UpdateReviewInput) => Promise<ProductReview | null>;
+    review: ProductReview | null;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to delete a review
+ */
+export declare function useDeleteReview(): {
+    deleteReview: (id: string) => Promise<boolean>;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to mark review as helpful
+ */
+export declare function useMarkReviewHelpful(): {
+    markHelpful: (id: string) => Promise<{
+        id: string;
+        helpful: number;
+    } | null>;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to fetch current user's entitlements
+ */
+export declare function useMyEntitlements(): {
+    entitlements: unknown[];
+    hasMore: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    loadMore: () => void;
+};
+/**
+ * Hook to check entitlement for a product
+ */
+export declare function useCheckEntitlement(productId: string): {
+    entitlement: unknown;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch workspace store orders
+ */
+export declare function useWorkspaceStoreOrders(billingAccountId: string, page: number, limit: number, options?: {
+    status?: string;
+    search?: string;
+}): {
+    orders: unknown[];
+    total: number;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Hook to fetch publisher's products
+ */
+export declare function useMyPublishedProducts(): {
+    products: StoreProduct[];
+    hasMore: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    loadMore: () => void;
+};
+/**
+ * Hook to fetch developer earnings
+ */
+export declare function useDeveloperEarnings(options?: {
+    period?: string;
+    startDate?: string;
+    endDate?: string;
+}): {
+    earnings: unknown;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+export type { BrowseStoreInput, StoreProductDetailsInput, ProductType, CreateReviewInput, UpdateReviewInput, StoreProduct, ProductReview, ProductCategory, SearchSuggestion, GroupedProducts, BrowseStoreResult, };

package/dist/hooks/useStoreGraphQLWithContext.d.ts

@@ -0,0 +1,32 @@
+import { DocumentNode, OperationVariables, TypedDocumentNode } from '@apollo/client/core';
+
+type GraphQLDocument = DocumentNode | TypedDocumentNode<unknown, OperationVariables>;
+interface QueryWithContextOptions<TVariables extends OperationVariables = OperationVariables> {
+    query: GraphQLDocument;
+    variables?: TVariables;
+    fetchPolicy?: 'cache-first' | 'network-only' | 'cache-only' | 'no-cache';
+    context?: {
+        headers?: Record<string, string>;
+    };
+}
+interface MutationWithContextOptions<TVariables extends OperationVariables = OperationVariables> {
+    mutation: GraphQLDocument;
+    variables?: TVariables;
+    context?: {
+        headers?: Record<string, string>;
+    };
+}
+/**
+ * Enhanced GraphQL client hook that automatically includes organization context
+ * in all requests to ensure proper organization-scoped licensing.
+ */
+export declare function useStoreGraphQLWithContext(): {
+    query: <TVariables extends OperationVariables = OperationVariables>(options: QueryWithContextOptions<TVariables>) => Promise<{
+        data: unknown;
+        error?: import('@apollo/client').ErrorLike;
+    }>;
+    mutate: <TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: MutationWithContextOptions<TVariables>) => Promise<import("@apollo/client").ApolloClient.MutateResult<TData, undefined>>;
+    organizationId: string | undefined;
+    hasOrganizationContext: boolean;
+};
+export {};

package/dist/hooks/useStorePermissions.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Store permission constants matching RBAC resource:action format
+ */
+export declare const STORE_PERMISSIONS: {
+    readonly PRODUCT_READ: "store-product:read";
+    readonly PRODUCT_CREATE: "store-product:create";
+    readonly PRODUCT_UPDATE: "store-product:update";
+    readonly PRODUCT_DELETE: "store-product:delete";
+    readonly PRODUCT_PUBLISH: "store-product:publish";
+    readonly PRODUCT_ADMIN: "store-product:admin";
+    readonly CATEGORY_CREATE: "store-category:create";
+    readonly CATEGORY_UPDATE: "store-category:update";
+    readonly CATEGORY_DELETE: "store-category:delete";
+    readonly TAG_CREATE: "store-tag:create";
+    readonly TAG_DELETE: "store-tag:delete";
+    readonly REVIEW_CREATE: "store-review:create";
+    readonly REVIEW_UPDATE: "store-review:update";
+    readonly REVIEW_DELETE: "store-review:delete";
+    readonly REVIEW_ADMIN: "store-review:admin";
+    readonly ENTITLEMENT_READ: "store-entitlement:read";
+    readonly ENTITLEMENT_CREATE: "store-entitlement:create";
+    readonly ENTITLEMENT_UPDATE: "store-entitlement:update";
+    readonly ENTITLEMENT_DELETE: "store-entitlement:delete";
+    readonly ORDER_READ: "store-order:read";
+    readonly ORDER_CREATE: "store-order:create";
+    readonly ORDER_UPDATE: "store-order:update";
+    readonly ORDER_ADMIN: "store-order:admin";
+    readonly ORDER_EXPORT: "store-order:export";
+    readonly CART_READ: "store-cart:read";
+    readonly CART_CREATE: "store-cart:create";
+    readonly CART_UPDATE: "store-cart:update";
+    readonly CART_CHECKOUT: "store-cart:checkout";
+    readonly DOWNLOAD_READ: "store-download:read";
+    readonly DOWNLOAD_CREATE: "store-download:create";
+    readonly INSTALLATION_READ: "store-installation:read";
+    readonly INSTALLATION_CREATE: "store-installation:create";
+    readonly INSTALLATION_UPDATE: "store-installation:update";
+    readonly INSTALLATION_DELETE: "store-installation:delete";
+    readonly EARNINGS_READ: "store-earnings:read";
+};
+export type StorePermission = (typeof STORE_PERMISSIONS)[keyof typeof STORE_PERMISSIONS];
+export interface StorePermissions {
+    canBrowse: boolean;
+    canPurchase: boolean;
+    canInstall: boolean;
+    canManageLicenses: boolean;
+    canPublish: boolean;
+    canModerate: boolean;
+    isPublisher: boolean;
+    isPlatformAdmin: boolean;
+}
+/**
+ * Hook for store permissions
+ *
+ * Integrates with the platform PermissionProvider from @burdenoff/fe-libs.
+ * Falls back to role-based checks when permissions are still loading.
+ */
+export declare function useStorePermissions(): {
+    permissions: StorePermissions;
+    PERMISSIONS: typeof STORE_PERMISSIONS;
+    hasPermission: (permission: StorePermission) => boolean;
+    isLoading: boolean;
+};

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Store (App Marketplace) Microfrontend
+ *
+ * Provides a comprehensive UI for discovering, purchasing, installing, and managing
+ * both digital and physical products within the Burdenoff ecosystem.
+ *
+ * @example
+ * ```tsx
+ * import { StoreRoot, type StoreRootProps } from '@burdenoff/microfe-store';
+ *
+ * function App() {
+ *   const props: StoreRootProps = {
+ *     basePath: '/store',
+ *     navigate: (path) => router.push(path),
+ *     currentUser: { id: '1', email: 'user@example.com' },
+ *     workspaceId: 'ws-123',
+ *     organizationId: 'org-123',
+ *     apiGatewayUrl: 'https://api.example.com/tenant/graphql',
+ *     authToken: 'token',
+ *     features: {
+ *       enablePhysicalProducts: true,
+ *       enablePublisherPortal: true,
+ *       enableReviews: true,
+ *       enableSubscriptions: true,
+ *     },
+ *   };
+ *
+ *   return <StoreRoot {...props} />;
+ * }
+ * ```
+ */
+export { StoreRoot } from './StoreRoot';
+export { StoreAdminRoot } from './StoreAdminRoot';
+export type { StoreRootProps, StoreAdminRootProps, ProductSummary, InstallationSummary, SubmissionSummary, ItemType, ProductType, PricingModel, ProductStatus, SubscriptionStatus, InstallationStatus, LicenseType, LicenseStatus, OrderStatus, ShipmentStatus, ReviewStatus, SubmissionStatus, PaymentGateway, ViewMode, SortBy, Category, Publisher, ProductVariant, Product, CartItem, Cart, Address, ShippingMethod, Checkout, Order, Installation, License, LicenseActivation, Review, Submission, RevenueMetrics, ProductFilter, ProductSort, PageInfo, ProductConnection, GraphQLError, MutationResult, } from './types';
+export { useStore } from './providers/StoreProvider';
+export { useStoreStore } from './store/storeStore';
+export { useCart } from './hooks/useCart';
+export { useBackendCart } from './hooks/useBackendCart';
+export { useProductSearch } from './hooks/useProductSearch';
+export { useStorePermissions, STORE_PERMISSIONS, type StorePermission, type StorePermissions, } from './hooks/useStorePermissions';
+export * from './utils';
+export { useBrowseStore, useBrowseStoreWithContext, useLazyBrowseStore, useStoreProductDetails, useLazyStoreProductDetails, useHomeGroupedProducts, useFeaturedProducts, useSearchSuggestions, useLazySearchSuggestions, useTrendingSearches, useFilterOptions, useCategories, useProductReviews, useUserReviewForProduct, useCreateReview, useUpdateReview, useDeleteReview, useMarkReviewHelpful, useMyEntitlements, useCheckEntitlement, useWorkspaceStoreOrders, } from './hooks/useStoreGraphQL';
+export * from './generated/global-operations';
+export { enTranslations as storeTranslations } from './translations/en';

package/dist/pages/AdminDashboardPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const AdminDashboardPage: FC;

package/dist/pages/AdminReviewModerationPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const AdminReviewModerationPage: FC;

package/dist/pages/AdminStoresPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const AdminStoresPage: FC;

package/dist/pages/AdminSubmissionsQueuePage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const AdminSubmissionsQueuePage: FC;

package/dist/pages/AppDetailPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const AppDetailPage: FC;

package/dist/pages/AppSettingsPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const AppSettingsPage: FC;

package/dist/pages/CartPage.d.ts

@@ -0,0 +1,8 @@
+import { FC } from 'react';
+
+/**
+ * CartPage component
+ *
+ * Full page cart view with items, summary, and checkout
+ */
+export declare const CartPage: FC;

package/dist/pages/InstalledAppsPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const InstalledAppsPage: FC;

package/dist/pages/MarketplaceHomePage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const MarketplaceHomePage: FC;

package/dist/pages/MyLicensesPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const MyLicensesPage: FC;

package/dist/pages/OrderConfirmationPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const OrderConfirmationPage: FC;

package/dist/pages/OrdersPage.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+
+/**
+ * OrdersPage component
+ *
+ * Displays a table of all orders with expandable rows showing line items
+ * and Install App buttons for digital products.
+ */
+export declare const OrdersPage: FC;

package/dist/pages/ProductCategoryPage.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const ProductCategoryPage: FC;