@fayz-ai/plugin-reputation 0.2.2 → 0.2.4

package/dist/public/index.js

@@ -0,0 +1,187 @@
+import { createContext, useContext, useState, useEffect, createElement } from 'react';
+import { createSafeDataProvider } from '@fayz-ai/core';
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { Star } from 'lucide-react';
+
+// src/public/index.tsx
+
+// src/data/mock.ts
+var FALLBACK_REVIEWS = [
+  { id: "r1", author: "Camila R.", source: "Google", rating: 5, text: "Excelente atendimento, recomendo!", date: "Jun 2025" },
+  { id: "r2", author: "Tom B.", source: "Facebook", rating: 5, text: "Processo simples e resultado \xF3timo.", date: "Jun 2025" },
+  { id: "r3", author: "Aisha K.", source: "Google", rating: 4, text: "Muito bom no geral.", date: "Jun 2025" }
+];
+function computeSummary(reviews) {
+  const count = reviews.length;
+  const average = count === 0 ? 0 : Math.round(reviews.reduce((s, r) => s + r.rating, 0) / count * 10) / 10;
+  const distribution = [5, 4, 3, 2, 1].map((stars) => ({
+    stars,
+    count: reviews.filter((r) => Math.round(r.rating) === stars).length
+  }));
+  return { average, count, distribution };
+}
+function createMockReputationProvider(options) {
+  const reviews = options?.seed?.reviews ?? FALLBACK_REVIEWS;
+  const summary = options?.seed?.summary ?? computeSummary(reviews);
+  return {
+    async listReviews(query) {
+      let result = reviews;
+      if (query?.minRating != null) result = result.filter((r) => r.rating >= query.minRating);
+      if (query?.limit != null) result = result.slice(0, query.limit);
+      return result;
+    },
+    async getSummary() {
+      return summary;
+    }
+  };
+}
+
+// src/data/supabase.ts
+function createSupabaseReputationProvider() {
+  const notImplemented = () => {
+    throw new Error(
+      "[plugin-reputation] Supabase provider not implemented yet \u2014 deferred to Phase 2. Run on the mock/seed provider (no Supabase client configured) for now."
+    );
+  };
+  return {
+    listReviews: (_query) => notImplemented(),
+    getSummary: () => notImplemented()
+  };
+}
+var ReputationContext = createContext(null);
+function ReputationProvider({ value, children }) {
+  return /* @__PURE__ */ jsx(ReputationContext.Provider, { value, children });
+}
+function useReputationContext() {
+  const ctx = useContext(ReputationContext);
+  if (!ctx) {
+    throw new Error("[plugin-reputation] useReputationContext must be used within <ReputationProvider>.");
+  }
+  return ctx;
+}
+function useReviews(query) {
+  const { provider } = useReputationContext();
+  const [reviews, setReviews] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const limit = query?.limit;
+  const minRating = query?.minRating;
+  useEffect(() => {
+    let active = true;
+    setLoading(true);
+    provider.listReviews({ limit, minRating }).then((result) => {
+      if (!active) return;
+      setReviews(result);
+      setError(null);
+    }).catch((err) => {
+      if (!active) return;
+      setError(err instanceof Error ? err : new Error(String(err)));
+    }).finally(() => {
+      if (active) setLoading(false);
+    });
+    return () => {
+      active = false;
+    };
+  }, [provider, limit, minRating]);
+  return { reviews, loading, error };
+}
+function useReviewSummary() {
+  const { provider } = useReputationContext();
+  const [summary, setSummary] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    let active = true;
+    setLoading(true);
+    provider.getSummary().then((result) => {
+      if (!active) return;
+      setSummary(result);
+      setError(null);
+    }).catch((err) => {
+      if (!active) return;
+      setError(err instanceof Error ? err : new Error(String(err)));
+    }).finally(() => {
+      if (active) setLoading(false);
+    });
+    return () => {
+      active = false;
+    };
+  }, [provider]);
+  return { summary, loading, error };
+}
+function Stars({ rating }) {
+  return /* @__PURE__ */ jsx("div", { className: "flex items-center gap-0.5", children: [1, 2, 3, 4, 5].map((i) => /* @__PURE__ */ jsx(
+    Star,
+    {
+      className: `h-4 w-4 ${i <= rating ? "fill-primary text-primary" : "text-muted-foreground/30"}`
+    },
+    i
+  )) });
+}
+function ReviewsList({ limit, heading }) {
+  const { reviews, loading } = useReviews({ limit });
+  const { summary } = useReviewSummary();
+  return /* @__PURE__ */ jsx("section", { className: "py-16 bg-background", children: /* @__PURE__ */ jsxs("div", { className: "container mx-auto px-6", children: [
+    /* @__PURE__ */ jsxs("div", { className: "text-center mb-12", children: [
+      heading ? /* @__PURE__ */ jsx("h1", { className: "font-heading text-4xl md:text-5xl font-bold text-foreground mb-3", children: heading }) : null,
+      summary ? /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-center gap-2", children: [
+        /* @__PURE__ */ jsx(Stars, { rating: Math.round(summary.average) }),
+        /* @__PURE__ */ jsx("span", { className: "text-foreground font-semibold text-lg", children: summary.average }),
+        /* @__PURE__ */ jsxs("span", { className: "text-muted-foreground text-sm", children: [
+          "\xB7 ",
+          summary.count,
+          " avalia\xE7\xF5es"
+        ] })
+      ] }) : null
+    ] }),
+    loading ? /* @__PURE__ */ jsx("p", { className: "text-center text-muted-foreground", children: "Carregando avalia\xE7\xF5es\u2026" }) : /* @__PURE__ */ jsx("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-6", children: reviews.map((review) => /* @__PURE__ */ jsxs("div", { className: "rounded-2xl bg-card border border-border p-6 shadow-sm", children: [
+      /* @__PURE__ */ jsx("div", { className: "mb-3", children: /* @__PURE__ */ jsx(Stars, { rating: review.rating }) }),
+      /* @__PURE__ */ jsxs("p", { className: "text-foreground text-sm leading-relaxed mb-4", children: [
+        '"',
+        review.text,
+        '"'
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between", children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+          /* @__PURE__ */ jsx("div", { className: "h-8 w-8 rounded-full bg-accent flex items-center justify-center text-primary font-semibold text-sm", children: review.author[0] }),
+          /* @__PURE__ */ jsx("span", { className: "text-sm font-medium text-foreground", children: review.author })
+        ] }),
+        /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: review.date })
+      ] })
+    ] }, review.id)) })
+  ] }) });
+}
+
+// src/public/index.tsx
+function createReputationWebsite(options) {
+  const basePath = options?.basePath ?? "/reviews";
+  const heading = options?.heading ?? "O que os pacientes dizem";
+  const provider = options?.dataProvider ?? createSafeDataProvider(
+    () => createSupabaseReputationProvider(),
+    () => createMockReputationProvider({ seed: options?.seed })
+  );
+  const value = { provider };
+  const Provider = ({ children }) => createElement(ReputationProvider, { value, children });
+  Provider.displayName = "ReputationWebsiteProvider";
+  const ReviewsScreen = () => createElement(ReviewsList, { heading });
+  ReviewsScreen.displayName = "ReviewsScreen";
+  const manifest = {
+    id: "reputation",
+    name: "Reviews",
+    icon: "Star",
+    version: "0.1.0",
+    scope: options?.scope ?? "universal",
+    verticalId: options?.verticalId,
+    scaffolds: ["website", "landing_page"],
+    defaultEnabled: true,
+    dependencies: [],
+    navigation: [],
+    routes: [{ path: basePath, component: ReviewsScreen, guard: "public" }],
+    widgets: []
+  };
+  return { manifest, Provider, dataProvider: provider };
+}
+
+export { ReputationProvider, ReviewsList, createMockReputationProvider, createReputationWebsite, createSupabaseReputationProvider, useReputationContext, useReviewSummary, useReviews };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/public/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data/mock.ts","../../src/data/supabase.ts","../../src/context.tsx","../../src/hooks/useReviews.ts","../../src/hooks/useReviewSummary.ts","../../src/components/ReviewsList.tsx","../../src/public/index.tsx"],"names":["useState","useEffect","jsx"],"mappings":"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","file":"index.js","sourcesContent":["import type { ReputationDataProvider } from './types'\nimport type { Review, ReviewSummary, ReviewListQuery } from '../types'\n\nexport interface ReputationSeed {\n  reviews: Review[]\n  /** Explicit aggregate. If omitted, it is computed from `reviews`. */\n  summary?: ReviewSummary\n}\n\nexport interface MockReputationProviderOptions {\n  seed?: ReputationSeed\n}\n\nconst FALLBACK_REVIEWS: Review[] = [\n  { id: 'r1', author: 'Camila R.', source: 'Google', rating: 5, text: 'Excelente atendimento, recomendo!', date: 'Jun 2025' },\n  { id: 'r2', author: 'Tom B.', source: 'Facebook', rating: 5, text: 'Processo simples e resultado ótimo.', date: 'Jun 2025' },\n  { id: 'r3', author: 'Aisha K.', source: 'Google', rating: 4, text: 'Muito bom no geral.', date: 'Jun 2025' },\n]\n\nfunction computeSummary(reviews: Review[]): ReviewSummary {\n  const count = reviews.length\n  const average = count === 0 ? 0 : Math.round((reviews.reduce((s, r) => s + r.rating, 0) / count) * 10) / 10\n  const distribution = [5, 4, 3, 2, 1].map((stars) => ({\n    stars,\n    count: reviews.filter((r) => Math.round(r.rating) === stars).length,\n  }))\n  return { average, count, distribution }\n}\n\nexport function createMockReputationProvider(options?: MockReputationProviderOptions): ReputationDataProvider {\n  const reviews: Review[] = options?.seed?.reviews ?? FALLBACK_REVIEWS\n  const summary: ReviewSummary = options?.seed?.summary ?? computeSummary(reviews)\n\n  return {\n    async listReviews(query?: ReviewListQuery): Promise<Review[]> {\n      let result = reviews\n      if (query?.minRating != null) result = result.filter((r) => r.rating >= query.minRating!)\n      if (query?.limit != null) result = result.slice(0, query.limit)\n      return result\n    },\n    async getSummary(): Promise<ReviewSummary> {\n      return summary\n    },\n  }\n}\n","import type { ReputationDataProvider } from './types'\nimport type { Review, ReviewSummary, ReviewListQuery } from '../types'\n\n// ---------------------------------------------------------------------------\n// Supabase-backed reputation provider — STUB (deferred to Phase 2).\n//\n// Later: read a `reviews` table (tenant-scoped, RLS) and/or synced Google/\n// Facebook reviews. Swapping this in is a pure provider change — hooks and\n// components are untouched. Throws until then so createSafeDataProvider falls\n// back to the mock/seed provider whenever no Supabase client is configured.\n// ---------------------------------------------------------------------------\n\nexport function createSupabaseReputationProvider(): ReputationDataProvider {\n  const notImplemented = (): never => {\n    throw new Error(\n      '[plugin-reputation] Supabase provider not implemented yet — deferred to Phase 2. ' +\n        'Run on the mock/seed provider (no Supabase client configured) for now.',\n    )\n  }\n  return {\n    listReviews: (_query?: ReviewListQuery): Promise<Review[]> => notImplemented(),\n    getSummary: (): Promise<ReviewSummary> => notImplemented(),\n  }\n}\n","import { createContext, useContext, type ReactNode } from 'react'\nimport type { ReputationDataProvider } from './data/types'\n\nexport interface ReputationContextValue {\n  provider: ReputationDataProvider\n}\n\nconst ReputationContext = createContext<ReputationContextValue | null>(null)\n\nexport function ReputationProvider({ value, children }: { value: ReputationContextValue; children: ReactNode }) {\n  return <ReputationContext.Provider value={value}>{children}</ReputationContext.Provider>\n}\n\nexport function useReputationContext(): ReputationContextValue {\n  const ctx = useContext(ReputationContext)\n  if (!ctx) {\n    throw new Error('[plugin-reputation] useReputationContext must be used within <ReputationProvider>.')\n  }\n  return ctx\n}\n","import { useEffect, useState } from 'react'\nimport { useReputationContext } from '../context'\nimport type { Review, ReviewListQuery } from '../types'\n\nexport interface UseReviewsResult {\n  reviews: Review[]\n  loading: boolean\n  error: Error | null\n}\n\n/** Fetch the review list from the active reputation provider. */\nexport function useReviews(query?: ReviewListQuery): UseReviewsResult {\n  const { provider } = useReputationContext()\n  const [reviews, setReviews] = useState<Review[]>([])\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState<Error | null>(null)\n\n  const limit = query?.limit\n  const minRating = query?.minRating\n\n  useEffect(() => {\n    let active = true\n    setLoading(true)\n    provider\n      .listReviews({ limit, minRating })\n      .then((result) => {\n        if (!active) return\n        setReviews(result)\n        setError(null)\n      })\n      .catch((err) => {\n        if (!active) return\n        setError(err instanceof Error ? err : new Error(String(err)))\n      })\n      .finally(() => {\n        if (active) setLoading(false)\n      })\n    return () => {\n      active = false\n    }\n  }, [provider, limit, minRating])\n\n  return { reviews, loading, error }\n}\n","import { useEffect, useState } from 'react'\nimport { useReputationContext } from '../context'\nimport type { ReviewSummary } from '../types'\n\nexport interface UseReviewSummaryResult {\n  summary: ReviewSummary | null\n  loading: boolean\n  error: Error | null\n}\n\n/** Fetch the aggregate rating summary (average + count + distribution). */\nexport function useReviewSummary(): UseReviewSummaryResult {\n  const { provider } = useReputationContext()\n  const [summary, setSummary] = useState<ReviewSummary | null>(null)\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState<Error | null>(null)\n\n  useEffect(() => {\n    let active = true\n    setLoading(true)\n    provider\n      .getSummary()\n      .then((result) => {\n        if (!active) return\n        setSummary(result)\n        setError(null)\n      })\n      .catch((err) => {\n        if (!active) return\n        setError(err instanceof Error ? err : new Error(String(err)))\n      })\n      .finally(() => {\n        if (active) setLoading(false)\n      })\n    return () => {\n      active = false\n    }\n  }, [provider])\n\n  return { summary, loading, error }\n}\n","import { Star } from 'lucide-react'\nimport { useReviews } from '../hooks/useReviews'\nimport { useReviewSummary } from '../hooks/useReviewSummary'\n\nfunction Stars({ rating }: { rating: number }) {\n  return (\n    <div className=\"flex items-center gap-0.5\">\n      {[1, 2, 3, 4, 5].map((i) => (\n        <Star\n          key={i}\n          className={`h-4 w-4 ${i <= rating ? 'fill-primary text-primary' : 'text-muted-foreground/30'}`}\n        />\n      ))}\n    </div>\n  )\n}\n\n/**\n * Default reviews list with an aggregate header — token-only so it inherits the\n * host theme. Optional: a host with bespoke review cards can ignore this and map\n * `useReviews()` / `useReviewSummary()` itself (as hempdent does on its home).\n */\nexport function ReviewsList({ limit, heading }: { limit?: number; heading?: string }) {\n  const { reviews, loading } = useReviews({ limit })\n  const { summary } = useReviewSummary()\n\n  return (\n    <section className=\"py-16 bg-background\">\n      <div className=\"container mx-auto px-6\">\n        <div className=\"text-center mb-12\">\n          {heading ? (\n            <h1 className=\"font-heading text-4xl md:text-5xl font-bold text-foreground mb-3\">{heading}</h1>\n          ) : null}\n          {summary ? (\n            <div className=\"flex items-center justify-center gap-2\">\n              <Stars rating={Math.round(summary.average)} />\n              <span className=\"text-foreground font-semibold text-lg\">{summary.average}</span>\n              <span className=\"text-muted-foreground text-sm\">· {summary.count} avaliações</span>\n            </div>\n          ) : null}\n        </div>\n\n        {loading ? (\n          <p className=\"text-center text-muted-foreground\">Carregando avaliações…</p>\n        ) : (\n          <div className=\"grid grid-cols-1 md:grid-cols-3 gap-6\">\n            {reviews.map((review) => (\n              <div key={review.id} className=\"rounded-2xl bg-card border border-border p-6 shadow-sm\">\n                <div className=\"mb-3\">\n                  <Stars rating={review.rating} />\n                </div>\n                <p className=\"text-foreground text-sm leading-relaxed mb-4\">\"{review.text}\"</p>\n                <div className=\"flex items-center justify-between\">\n                  <div className=\"flex items-center gap-2\">\n                    <div className=\"h-8 w-8 rounded-full bg-accent flex items-center justify-center text-primary font-semibold text-sm\">\n                      {review.author[0]}\n                    </div>\n                    <span className=\"text-sm font-medium text-foreground\">{review.author}</span>\n                  </div>\n                  <span className=\"text-xs text-muted-foreground\">{review.date}</span>\n                </div>\n              </div>\n            ))}\n          </div>\n        )}\n      </div>\n    </section>\n  )\n}\n","import { createElement, type FC, type ReactNode } from 'react'\nimport type { PluginManifest, PluginScope, VerticalId } from '@fayz-ai/core'\nimport { createSafeDataProvider } from '@fayz-ai/core'\nimport { createMockReputationProvider, type ReputationSeed } from '../data/mock'\nimport { createSupabaseReputationProvider } from '../data/supabase'\nimport { ReputationProvider, type ReputationContextValue } from '../context'\nimport { ReviewsList } from '../components/ReviewsList'\nimport type { ReputationDataProvider } from '../data/types'\n\n// ---------------------------------------------------------------------------\n// @fayz-ai/plugin-reputation/public — website reviews surface.\n//\n// Lean entry (no admin ReputationHome / @fayz-ai/ui). Returns a { manifest,\n// Provider } bundle the host reads uniformly: the Provider wraps the app root so\n// useReviews()/useReviewSummary() power the host's own review markup, and\n// manifest.routes ships an optional /reviews page.\n// ---------------------------------------------------------------------------\n\nexport interface ReputationWebsiteOptions {\n  /** Base path for the optional public \"all reviews\" page. Default '/reviews'. */\n  basePath?: string\n  /** Seed reviews + summary for the mock provider (used until a real backend is wired). */\n  seed?: ReputationSeed\n  /** Inject a custom provider. Overrides the safe mock/Supabase resolver. */\n  dataProvider?: ReputationDataProvider\n  /** Heading for the optional /reviews screen. */\n  heading?: string\n  scope?: PluginScope\n  verticalId?: VerticalId\n}\n\nexport interface ReputationWebsitePlugin {\n  manifest: PluginManifest\n  Provider: FC<{ children: ReactNode }>\n  dataProvider: ReputationDataProvider\n}\n\nexport function createReputationWebsite(options?: ReputationWebsiteOptions): ReputationWebsitePlugin {\n  const basePath = options?.basePath ?? '/reviews'\n  const heading = options?.heading ?? 'O que os pacientes dizem'\n  const provider =\n    options?.dataProvider ??\n    createSafeDataProvider(\n      () => createSupabaseReputationProvider(),\n      () => createMockReputationProvider({ seed: options?.seed }),\n    )\n\n  const value: ReputationContextValue = { provider }\n  const Provider: FC<{ children: ReactNode }> = ({ children }) =>\n    createElement(ReputationProvider, { value, children })\n  Provider.displayName = 'ReputationWebsiteProvider'\n\n  const ReviewsScreen: FC<unknown> = () => createElement(ReviewsList, { heading })\n  ReviewsScreen.displayName = 'ReviewsScreen'\n\n  const manifest: PluginManifest = {\n    id: 'reputation',\n    name: 'Reviews',\n    icon: 'Star',\n    version: '0.1.0',\n    scope: options?.scope ?? 'universal',\n    verticalId: options?.verticalId,\n    scaffolds: ['website', 'landing_page'],\n    defaultEnabled: true,\n    dependencies: [],\n    navigation: [],\n    routes: [{ path: basePath, component: ReviewsScreen, guard: 'public' }],\n    widgets: [],\n  }\n\n  return { manifest, Provider, dataProvider: provider }\n}\n\n// Public API — website surface\nexport type { Review, ReviewSummary, ReviewSource, ReviewListQuery } from '../types'\nexport type { ReputationDataProvider } from '../data/types'\nexport { createMockReputationProvider, createSupabaseReputationProvider } from '../data'\nexport type { ReputationSeed } from '../data/mock'\nexport { ReputationProvider, useReputationContext } from '../context'\nexport type { ReputationContextValue } from '../context'\nexport { useReviews, useReviewSummary } from '../hooks'\nexport { ReviewsList } from '../components/ReviewsList'\n"]}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export type ReviewSource = 'Google' | 'Facebook' | 'Instagram' | 'Website' | (string & {});
+export interface Review {
+    id: string;
+    /** Reviewer display name. */
+    author: string;
+    rating: number;
+    text: string;
+    /** Human-readable date (e.g. "Janeiro 2025"). */
+    date: string;
+    source?: ReviewSource;
+    /** Whether the business has replied (admin surface). */
+    replied?: boolean;
+}
+export interface ReviewSummary {
+    /** Average rating, e.g. 4.8. */
+    average: number;
+    /** Total number of ratings, e.g. 123. */
+    count: number;
+    /** Optional star distribution (5→1). */
+    distribution?: Array<{
+        stars: number;
+        count: number;
+    }>;
+}
+export interface ReviewListQuery {
+    limit?: number;
+    /** Minimum rating to include. */
+    minRating?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE1F,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fayz-ai/plugin-reputation",
-  "version": "0.2.2",
-  "description": "Fayz SDK — reviews & reputation management plugin",
+  "version": "0.2.4",
+  "description": "[experimental] Fayz SDK — reviews & reputation management plugin",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -12,6 +12,12 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./public": {
+      "source": "./src/public/index.tsx",
+      "types": "./dist/public/index.d.ts",
+      "import": "./dist/public/index.js",
+      "require": "./dist/public/index.cjs"
     }
   },
   "files": [
@@ -24,8 +30,8 @@
   },
   "dependencies": {
     "lucide-react": "^0.400.0",
-    "@fayz-ai/core": "^0.6.0",
-    "@fayz-ai/ui": "^0.6.0"
+    "@fayz-ai/core": "^0.7.1",
+    "@fayz-ai/ui": "^0.7.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",
@@ -40,9 +46,6 @@
     "fayz-plugin",
     "fayz-sdk"
   ],
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
     "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
     "dev": "tsup --watch",

package/src/components/ReviewsList.tsx

@@ -0,0 +1,69 @@
+import { Star } from 'lucide-react'
+import { useReviews } from '../hooks/useReviews'
+import { useReviewSummary } from '../hooks/useReviewSummary'
+
+function Stars({ rating }: { rating: number }) {
+  return (
+    <div className="flex items-center gap-0.5">
+      {[1, 2, 3, 4, 5].map((i) => (
+        <Star
+          key={i}
+          className={`h-4 w-4 ${i <= rating ? 'fill-primary text-primary' : 'text-muted-foreground/30'}`}
+        />
+      ))}
+    </div>
+  )
+}
+
+/**
+ * Default reviews list with an aggregate header — token-only so it inherits the
+ * host theme. Optional: a host with bespoke review cards can ignore this and map
+ * `useReviews()` / `useReviewSummary()` itself (as hempdent does on its home).
+ */
+export function ReviewsList({ limit, heading }: { limit?: number; heading?: string }) {
+  const { reviews, loading } = useReviews({ limit })
+  const { summary } = useReviewSummary()
+
+  return (
+    <section className="py-16 bg-background">
+      <div className="container mx-auto px-6">
+        <div className="text-center mb-12">
+          {heading ? (
+            <h1 className="font-heading text-4xl md:text-5xl font-bold text-foreground mb-3">{heading}</h1>
+          ) : null}
+          {summary ? (
+            <div className="flex items-center justify-center gap-2">
+              <Stars rating={Math.round(summary.average)} />
+              <span className="text-foreground font-semibold text-lg">{summary.average}</span>
+              <span className="text-muted-foreground text-sm">· {summary.count} avaliações</span>
+            </div>
+          ) : null}
+        </div>
+
+        {loading ? (
+          <p className="text-center text-muted-foreground">Carregando avaliações…</p>
+        ) : (
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+            {reviews.map((review) => (
+              <div key={review.id} className="rounded-2xl bg-card border border-border p-6 shadow-sm">
+                <div className="mb-3">
+                  <Stars rating={review.rating} />
+                </div>
+                <p className="text-foreground text-sm leading-relaxed mb-4">"{review.text}"</p>
+                <div className="flex items-center justify-between">
+                  <div className="flex items-center gap-2">
+                    <div className="h-8 w-8 rounded-full bg-accent flex items-center justify-center text-primary font-semibold text-sm">
+                      {review.author[0]}
+                    </div>
+                    <span className="text-sm font-medium text-foreground">{review.author}</span>
+                  </div>
+                  <span className="text-xs text-muted-foreground">{review.date}</span>
+                </div>
+              </div>
+            ))}
+          </div>
+        )}
+      </div>
+    </section>
+  )
+}

package/src/context.tsx

@@ -0,0 +1,20 @@
+import { createContext, useContext, type ReactNode } from 'react'
+import type { ReputationDataProvider } from './data/types'
+
+export interface ReputationContextValue {
+  provider: ReputationDataProvider
+}
+
+const ReputationContext = createContext<ReputationContextValue | null>(null)
+
+export function ReputationProvider({ value, children }: { value: ReputationContextValue; children: ReactNode }) {
+  return <ReputationContext.Provider value={value}>{children}</ReputationContext.Provider>
+}
+
+export function useReputationContext(): ReputationContextValue {
+  const ctx = useContext(ReputationContext)
+  if (!ctx) {
+    throw new Error('[plugin-reputation] useReputationContext must be used within <ReputationProvider>.')
+  }
+  return ctx
+}

package/src/data/index.ts

@@ -0,0 +1,4 @@
+export type { ReputationDataProvider } from './types'
+export { createMockReputationProvider } from './mock'
+export type { ReputationSeed, MockReputationProviderOptions } from './mock'
+export { createSupabaseReputationProvider } from './supabase'

package/src/data/mock.ts

@@ -0,0 +1,45 @@
+import type { ReputationDataProvider } from './types'
+import type { Review, ReviewSummary, ReviewListQuery } from '../types'
+
+export interface ReputationSeed {
+  reviews: Review[]
+  /** Explicit aggregate. If omitted, it is computed from `reviews`. */
+  summary?: ReviewSummary
+}
+
+export interface MockReputationProviderOptions {
+  seed?: ReputationSeed
+}
+
+const FALLBACK_REVIEWS: Review[] = [
+  { id: 'r1', author: 'Camila R.', source: 'Google', rating: 5, text: 'Excelente atendimento, recomendo!', date: 'Jun 2025' },
+  { id: 'r2', author: 'Tom B.', source: 'Facebook', rating: 5, text: 'Processo simples e resultado ótimo.', date: 'Jun 2025' },
+  { id: 'r3', author: 'Aisha K.', source: 'Google', rating: 4, text: 'Muito bom no geral.', date: 'Jun 2025' },
+]
+
+function computeSummary(reviews: Review[]): ReviewSummary {
+  const count = reviews.length
+  const average = count === 0 ? 0 : Math.round((reviews.reduce((s, r) => s + r.rating, 0) / count) * 10) / 10
+  const distribution = [5, 4, 3, 2, 1].map((stars) => ({
+    stars,
+    count: reviews.filter((r) => Math.round(r.rating) === stars).length,
+  }))
+  return { average, count, distribution }
+}
+
+export function createMockReputationProvider(options?: MockReputationProviderOptions): ReputationDataProvider {
+  const reviews: Review[] = options?.seed?.reviews ?? FALLBACK_REVIEWS
+  const summary: ReviewSummary = options?.seed?.summary ?? computeSummary(reviews)
+
+  return {
+    async listReviews(query?: ReviewListQuery): Promise<Review[]> {
+      let result = reviews
+      if (query?.minRating != null) result = result.filter((r) => r.rating >= query.minRating!)
+      if (query?.limit != null) result = result.slice(0, query.limit)
+      return result
+    },
+    async getSummary(): Promise<ReviewSummary> {
+      return summary
+    },
+  }
+}

package/src/data/supabase.ts

@@ -0,0 +1,24 @@
+import type { ReputationDataProvider } from './types'
+import type { Review, ReviewSummary, ReviewListQuery } from '../types'
+
+// ---------------------------------------------------------------------------
+// Supabase-backed reputation provider — STUB (deferred to Phase 2).
+//
+// Later: read a `reviews` table (tenant-scoped, RLS) and/or synced Google/
+// Facebook reviews. Swapping this in is a pure provider change — hooks and
+// components are untouched. Throws until then so createSafeDataProvider falls
+// back to the mock/seed provider whenever no Supabase client is configured.
+// ---------------------------------------------------------------------------
+
+export function createSupabaseReputationProvider(): ReputationDataProvider {
+  const notImplemented = (): never => {
+    throw new Error(
+      '[plugin-reputation] Supabase provider not implemented yet — deferred to Phase 2. ' +
+        'Run on the mock/seed provider (no Supabase client configured) for now.',
+    )
+  }
+  return {
+    listReviews: (_query?: ReviewListQuery): Promise<Review[]> => notImplemented(),
+    getSummary: (): Promise<ReviewSummary> => notImplemented(),
+  }
+}

package/src/data/types.ts

@@ -0,0 +1,10 @@
+import type { Review, ReviewSummary, ReviewListQuery } from '../types'
+
+/**
+ * Data seam for reputation. Mock/seed powers the POC; a Supabase (or
+ * Google/Facebook sync) implementation swaps in later with no component change.
+ */
+export interface ReputationDataProvider {
+  listReviews(query?: ReviewListQuery): Promise<Review[]>
+  getSummary(): Promise<ReviewSummary>
+}

package/src/hooks/index.ts

@@ -0,0 +1,4 @@
+export { useReviews } from './useReviews'
+export type { UseReviewsResult } from './useReviews'
+export { useReviewSummary } from './useReviewSummary'
+export type { UseReviewSummaryResult } from './useReviewSummary'

package/src/hooks/useReviewSummary.ts

@@ -0,0 +1,41 @@
+import { useEffect, useState } from 'react'
+import { useReputationContext } from '../context'
+import type { ReviewSummary } from '../types'
+
+export interface UseReviewSummaryResult {
+  summary: ReviewSummary | null
+  loading: boolean
+  error: Error | null
+}
+
+/** Fetch the aggregate rating summary (average + count + distribution). */
+export function useReviewSummary(): UseReviewSummaryResult {
+  const { provider } = useReputationContext()
+  const [summary, setSummary] = useState<ReviewSummary | null>(null)
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<Error | null>(null)
+
+  useEffect(() => {
+    let active = true
+    setLoading(true)
+    provider
+      .getSummary()
+      .then((result) => {
+        if (!active) return
+        setSummary(result)
+        setError(null)
+      })
+      .catch((err) => {
+        if (!active) return
+        setError(err instanceof Error ? err : new Error(String(err)))
+      })
+      .finally(() => {
+        if (active) setLoading(false)
+      })
+    return () => {
+      active = false
+    }
+  }, [provider])
+
+  return { summary, loading, error }
+}

package/src/hooks/useReviews.ts

@@ -0,0 +1,44 @@
+import { useEffect, useState } from 'react'
+import { useReputationContext } from '../context'
+import type { Review, ReviewListQuery } from '../types'
+
+export interface UseReviewsResult {
+  reviews: Review[]
+  loading: boolean
+  error: Error | null
+}
+
+/** Fetch the review list from the active reputation provider. */
+export function useReviews(query?: ReviewListQuery): UseReviewsResult {
+  const { provider } = useReputationContext()
+  const [reviews, setReviews] = useState<Review[]>([])
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<Error | null>(null)
+
+  const limit = query?.limit
+  const minRating = query?.minRating
+
+  useEffect(() => {
+    let active = true
+    setLoading(true)
+    provider
+      .listReviews({ limit, minRating })
+      .then((result) => {
+        if (!active) return
+        setReviews(result)
+        setError(null)
+      })
+      .catch((err) => {
+        if (!active) return
+        setError(err instanceof Error ? err : new Error(String(err)))
+      })
+      .finally(() => {
+        if (active) setLoading(false)
+      })
+    return () => {
+      active = false
+    }
+  }, [provider, limit, minRating])
+
+  return { reviews, loading, error }
+}

package/src/index.ts

@@ -6,6 +6,10 @@ import { ReputationHome } from './views/ReputationHome'
 // @fayz-ai/plugin-reputation — reviews & reputation (GoHighLevel "Reputation").
 // Universal plugin. M1 ships a rich mock home; Google/Facebook review sync +
 // automated review requests (over connectors + automations) come later.
+//
+// The public/website surface (createReputationWebsite + hooks + ReviewsList)
+// lives in the lean './public' subpath so a marketing-site host imports it
+// WITHOUT pulling the admin view's @fayz-ai/ui graph.
 // ---------------------------------------------------------------------------
 
 export interface ReputationPluginOptions {