@bash-app/bash-common 30.293.0 → 30.297.0

package/src/utils/trustScoreUtils.ts

@@ -0,0 +1,136 @@
+import { bayesianAverage } from "./reputationUtils.js";
+
+export type TrustScoreActorType = "host" | "service";
+
+export interface TrustScoreInputs {
+  bayesianReviewScore: number | null;
+  completedVolume: number;
+  cancellationRate: number;
+  responseRate: number;
+  identityVerified: boolean;
+  verifiedAttendanceRate?: number;
+  verifiedCompletionRate?: number;
+  accountAgeDays: number;
+  disputeRate: number;
+  repeatCustomerRate: number;
+}
+
+export interface TrustScoreBreakdown {
+  score: number | null;
+  components: Record<string, number>;
+  weights: Record<string, number>;
+}
+
+const HOST_WEIGHTS: Record<string, number> = {
+  reviews: 0.35,
+  volume: 0.15,
+  cancellation: 0.1,
+  response: 0.1,
+  identity: 0.1,
+  attendance: 0.05,
+  accountAge: 0.05,
+  disputes: 0.05,
+  repeat: 0.05,
+};
+
+const SERVICE_WEIGHTS: Record<string, number> = {
+  reviews: 0.4,
+  volume: 0.15,
+  cancellation: 0.1,
+  response: 0.1,
+  identity: 0.1,
+  completion: 0.1,
+  accountAge: 0.05,
+  disputes: 0.05,
+  repeat: 0.05,
+};
+
+function clamp01(n: number): number {
+  if (n < 0) return 0;
+  if (n > 1) return 1;
+  return n;
+}
+
+function logScaledVolume(count: number, cap = 100): number {
+  if (count <= 0) return 0;
+  return clamp01(Math.log10(count + 1) / Math.log10(cap + 1));
+}
+
+function accountAgeScore(days: number): number {
+  return clamp01(Math.log10(Math.max(days, 1) + 1) / Math.log10(365 * 3 + 1));
+}
+
+function inverseRate(rate: number): number {
+  return clamp01(1 - clamp01(rate));
+}
+
+/**
+ * Compute a 0–100 trust score from normalized component signals (0–1 each).
+ */
+export function computeTrustScoreFromInputs(
+  actorType: TrustScoreActorType,
+  inputs: TrustScoreInputs
+): TrustScoreBreakdown {
+  const weights = actorType === "host" ? HOST_WEIGHTS : SERVICE_WEIGHTS;
+
+  const reviewComponent =
+    inputs.bayesianReviewScore != null
+      ? clamp01(inputs.bayesianReviewScore / 5)
+      : 0.5;
+
+  const components: Record<string, number> = {
+    reviews: reviewComponent,
+    volume: logScaledVolume(inputs.completedVolume),
+    cancellation: inverseRate(inputs.cancellationRate),
+    response: clamp01(inputs.responseRate),
+    identity: inputs.identityVerified ? 1 : 0,
+    accountAge: accountAgeScore(inputs.accountAgeDays),
+    disputes: inverseRate(inputs.disputeRate),
+    repeat: clamp01(inputs.repeatCustomerRate),
+  };
+
+  if (actorType === "host") {
+    components.attendance = clamp01(inputs.verifiedAttendanceRate ?? 0);
+  } else {
+    components.completion = clamp01(inputs.verifiedCompletionRate ?? 0);
+  }
+
+  let weighted = 0;
+  let weightSum = 0;
+  for (const [key, weight] of Object.entries(weights)) {
+    const val = components[key];
+    if (val == null) continue;
+    weighted += val * weight;
+    weightSum += weight;
+  }
+
+  if (weightSum === 0) {
+    return { score: null, components, weights };
+  }
+
+  const normalized = weighted / weightSum;
+  const score = Math.round(normalized * 100);
+  return { score, components, weights };
+}
+
+/** Convenience when only review stats are available (early bootstrap). */
+export function trustScoreFromReviewAverage(
+  actorType: TrustScoreActorType,
+  averageRating: number | null | undefined,
+  totalRatings: number | null | undefined
+): number | null {
+  const bayesian = bayesianAverage(averageRating, totalRatings);
+  const result = computeTrustScoreFromInputs(actorType, {
+    bayesianReviewScore: bayesian,
+    completedVolume: totalRatings ?? 0,
+    cancellationRate: 0,
+    responseRate: 1,
+    identityVerified: false,
+    accountAgeDays: 30,
+    disputeRate: 0,
+    repeatCustomerRate: 0,
+    verifiedAttendanceRate: 0,
+    verifiedCompletionRate: 0,
+  });
+  return result.score;
+}