brickwise 0.1.1 → 0.1.7

package/src/lib/types.ts

@@ -105,6 +105,10 @@ export interface AnalysisRow {
   asking_yield: number | null;
   median_rent: number | null;
   median_sale_price: number | null;
+  rent_p25: number | null;
+  rent_p75: number | null;
+  sale_p25: number | null;
+  sale_p75: number | null;
   rent_n: number;
   buy_n: number;
   gym_distance_m: number | null;
@@ -117,6 +121,10 @@ export interface YieldResult {
   asking_yield: number | null;
   median_rent: number | null;
   median_sale_price: number | null;
+  rent_p25: number | null;
+  rent_p75: number | null;
+  sale_p25: number | null;
+  sale_p75: number | null;
   rent_n: number;
   buy_n: number;
 }

package/src/lib/yield.ts

@@ -5,16 +5,21 @@ const WINDOW_MS = 24 * 30.44 * 24 * 3600 * 1000; // ~24 months
 const MIN_SAMPLES = 3;
 const SIZE_TOLERANCE = 0.2;
 
-function median(xs: number[]): number | null {
+function percentile(xs: number[], p: number): number | null {
   if (xs.length === 0) return null;
   const s = [...xs].sort((a, b) => a - b);
-  const m = Math.floor(s.length / 2);
-  return s.length % 2 ? s[m] : (s[m - 1] + s[m]) / 2;
+  const idx = (s.length - 1) * p;
+  const lo = Math.floor(idx);
+  const hi = Math.ceil(idx);
+  return lo === hi ? s[lo] : s[lo] + (s[hi] - s[lo]) * (idx - lo);
 }
 
+const median = (xs: number[]) => percentile(xs, 0.5);
+
 /**
- * Comparable units only: same bedrooms + similar size when possible, relaxing to
- * same bedrooms, then similar size. Never falls back to "every transaction in the
+ * Comparable units: SIMILAR SIZE (±20%) is the primary criterion, refined by same
+ * bedroom count when that still leaves a usable sample. Bedrooms-only is a last
+ * resort for listings with no size. Never falls back to "every transaction in the
  * building" — mixing unit types is what produces bogus yields.
  */
 function pickSample(txs: TxRow[], bedrooms: number | null, sizeSqft: number | null): TxRow[] {
@@ -24,16 +29,14 @@ function pickSample(txs: TxRow[], bedrooms: number | null, sizeSqft: number | nu
   const sameSize = (t: TxRow) =>
     sizeSqft != null && t.size_sqft != null && Math.abs(t.size_sqft - sizeSqft) / sizeSqft <= SIZE_TOLERANCE;
 
-  const byBoth = recent.filter((t) => sameBdr(t) && sameSize(t));
-  if (byBoth.length >= MIN_SAMPLES) return byBoth;
-  const byBdr = recent.filter(sameBdr);
-  if (byBdr.length >= MIN_SAMPLES) return byBdr;
+  const bySizeAndBdr = recent.filter((t) => sameSize(t) && sameBdr(t));
+  if (bySizeAndBdr.length >= MIN_SAMPLES) return bySizeAndBdr;
   const bySize = recent.filter(sameSize);
   if (bySize.length >= MIN_SAMPLES) return bySize;
-  // Below MIN_SAMPLES everywhere: use the best comparable set we have, even if tiny.
-  if (byBoth.length) return byBoth;
-  if (byBdr.length) return byBdr;
-  return bySize;
+  // Below MIN_SAMPLES everywhere: best comparable set we have, even if tiny.
+  if (bySizeAndBdr.length) return bySizeAndBdr;
+  if (bySize.length) return bySize;
+  return recent.filter(sameBdr); // only reachable when the listing has no size
 }
 
 /**
@@ -52,14 +55,22 @@ export function computeYield(
   const buySample = pickSample(buyTxs, bedrooms, sizeSqft);
   const rentSample = pickSample(rentTxs, bedrooms, sizeSqft);
 
-  const medianRent = median(rentSample.map((t) => t.amount));
-  const medianSalePrice = median(buySample.map((t) => t.amount));
+  const rents = rentSample.map((t) => t.amount);
+  const sales = buySample.map((t) => t.amount);
+  const medianRent = median(rents);
+  const medianSalePrice = median(sales);
 
   return {
     gross_yield: medianRent != null && medianSalePrice ? medianRent / medianSalePrice : null,
     asking_yield: medianRent != null && price > 0 ? medianRent / price : null,
     median_rent: medianRent,
     median_sale_price: medianSalePrice,
+    // Spread of comparable rents/sales: within one building + size band the location
+    // is fixed, so the P25→P75 range mostly reflects interior condition/furnishing.
+    rent_p25: percentile(rents, 0.25),
+    rent_p75: percentile(rents, 0.75),
+    sale_p25: percentile(sales, 0.25),
+    sale_p75: percentile(sales, 0.75),
     rent_n: rentSample.length,
     buy_n: buySample.length,
   };

package/src/app/api/search/route.ts

@@ -1,26 +0,0 @@
-import { NextRequest, NextResponse } from "next/server";
-import { scrapeSearch } from "@/lib/pf/search";
-import { getAnalysis, upsertListing } from "@/lib/store";
-import { dedupeListings } from "@/lib/dedupe";
-import { SearchFilters } from "@/lib/types";
-
-export async function POST(req: NextRequest) {
-  try {
-    const filters = (await req.json()) as SearchFilters;
-    const { properties, totalCount } = await scrapeSearch(filters);
-    const rows = properties.map((p) => upsertListing(p));
-    // Collapse the same physical unit listed by several agents.
-    const { unique, removed } = dedupeListings(rows);
-    const results = unique.map((row) => ({
-      ...row,
-      images: JSON.parse(row.images_json),
-      amenities: JSON.parse(row.amenities_json),
-      // Cached analysis only — nothing is scraped here; the user analyzes on demand.
-      analysis: getAnalysis(row.id),
-    }));
-    return NextResponse.json({ totalCount, count: results.length, duplicatesRemoved: removed, results });
-  } catch (e) {
-    console.error("search failed:", e);
-    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
-  }
-}

package/src/components/FiltersForm.tsx

@@ -1,240 +0,0 @@
-"use client";
-
-import { useEffect, useRef, useState } from "react";
-import { SearchFilters } from "@/lib/types";
-
-const AMENITIES = [
-  { value: "SY", label: "Gimnasio compartido" },
-  { value: "PY", label: "Gimnasio privado" },
-  { value: "CP", label: "Parking cubierto" },
-  { value: "SP", label: "Piscina compartida" },
-  { value: "PP", label: "Piscina privada" },
-  { value: "BA", label: "Balcón" },
-  { value: "AC", label: "A/C central" },
-  { value: "MR", label: "Cuarto de servicio" },
-  { value: "BW", label: "Armarios empotrados" },
-  { value: "ST", label: "Estudio/despacho" },
-  { value: "VW", label: "Vistas al agua" },
-  { value: "PA", label: "Mascotas" },
-];
-
-const PROPERTY_TYPES = [
-  { value: "", label: "Cualquiera" },
-  { value: "1", label: "Apartamento" },
-  { value: "35", label: "Villa" },
-  { value: "22", label: "Townhouse" },
-  { value: "20", label: "Penthouse" },
-  { value: "24", label: "Dúplex" },
-];
-
-const BEDROOM_OPTS = ["0", "1", "2", "3", "4", "5"];
-
-interface LocOption {
-  id: string;
-  name: string;
-  path_name: string;
-}
-
-export default function FiltersForm({
-  onSearch,
-  searching,
-}: {
-  onSearch: (f: SearchFilters) => void;
-  searching: boolean;
-}) {
-  const [locQuery, setLocQuery] = useState("");
-  const [locOptions, setLocOptions] = useState<LocOption[]>([]);
-  const [location, setLocation] = useState<LocOption | null>(null);
-  const [showDropdown, setShowDropdown] = useState(false);
-  const [minPrice, setMinPrice] = useState("");
-  const [maxPrice, setMaxPrice] = useState("");
-  const [minArea, setMinArea] = useState("");
-  const [maxArea, setMaxArea] = useState("");
-  const [bedrooms, setBedrooms] = useState<string[]>([]);
-  const [propertyTypeId, setPropertyTypeId] = useState("");
-  const [amenities, setAmenities] = useState<string[]>([]);
-  const [maxGymKm, setMaxGymKm] = useState("");
-  const [maxPages, setMaxPages] = useState("2");
-  const debounce = useRef<ReturnType<typeof setTimeout> | null>(null);
-
-  useEffect(() => {
-    if (debounce.current) clearTimeout(debounce.current);
-    debounce.current = setTimeout(() => {
-      if (locQuery.trim().length < 2 || locQuery === location?.name) {
-        setLocOptions([]);
-        return;
-      }
-      fetch(`/api/locations?q=${encodeURIComponent(locQuery)}`)
-        .then((r) => r.json())
-        .then((j) => setLocOptions(j.locations || []))
-        .catch(() => {});
-    }, 250);
-  }, [locQuery, location]);
-
-  const toggle = (arr: string[], v: string, set: (x: string[]) => void) =>
-    set(arr.includes(v) ? arr.filter((x) => x !== v) : [...arr, v]);
-
-  const submit = (e: React.FormEvent) => {
-    e.preventDefault();
-    onSearch({
-      locationId: location?.id,
-      locationLabel: location ? `${location.name} (${location.path_name})` : "Dubai",
-      minPrice: minPrice ? Number(minPrice) : undefined,
-      maxPrice: maxPrice ? Number(maxPrice) : undefined,
-      minArea: minArea ? Number(minArea) : undefined,
-      maxArea: maxArea ? Number(maxArea) : undefined,
-      bedrooms: bedrooms.length ? bedrooms : undefined,
-      propertyTypeId: propertyTypeId || undefined,
-      amenities: amenities.length ? amenities : undefined,
-      maxGymDistanceM: maxGymKm ? Number(maxGymKm) * 1000 : undefined,
-      maxPages: Number(maxPages) || 2,
-    });
-  };
-
-  const inputCls =
-    "w-full rounded-lg border border-neutral-300 bg-white px-3 py-2 text-sm outline-none focus:border-neutral-500 dark:border-neutral-700 dark:bg-neutral-900";
-
-  return (
-    <form onSubmit={submit} className="rounded-xl border border-neutral-200 bg-white p-4 shadow-sm dark:border-neutral-800 dark:bg-neutral-900">
-      <div className="grid gap-3 md:grid-cols-4">
-        <div className="relative md:col-span-2">
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Ubicación</label>
-          <input
-            className={inputCls}
-            placeholder="Ciudad, zona o edificio (p. ej. Dubai Marina)"
-            value={locQuery}
-            onChange={(e) => {
-              setLocQuery(e.target.value);
-              setLocation(null);
-              setShowDropdown(true);
-            }}
-            onFocus={() => setShowDropdown(true)}
-          />
-          {showDropdown && locOptions.length > 0 && (
-            <ul className="absolute z-30 mt-1 max-h-64 w-full overflow-auto rounded-lg border border-neutral-200 bg-white shadow-lg dark:border-neutral-700 dark:bg-neutral-900">
-              {locOptions.map((o) => (
-                <li key={o.id}>
-                  <button
-                    type="button"
-                    className="w-full px-3 py-2 text-left text-sm hover:bg-neutral-100 dark:hover:bg-neutral-800"
-                    onClick={() => {
-                      setLocation(o);
-                      setLocQuery(o.name);
-                      setShowDropdown(false);
-                    }}
-                  >
-                    <span className="font-medium">{o.name}</span>
-                    <span className="ml-2 text-xs text-neutral-500">{o.path_name}</span>
-                  </button>
-                </li>
-              ))}
-            </ul>
-          )}
-        </div>
-
-        <div>
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Tipo</label>
-          <select className={inputCls} value={propertyTypeId} onChange={(e) => setPropertyTypeId(e.target.value)}>
-            {PROPERTY_TYPES.map((t) => (
-              <option key={t.value} value={t.value}>
-                {t.label}
-              </option>
-            ))}
-          </select>
-        </div>
-
-        <div>
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Páginas a scrapear (×25)</label>
-          <select className={inputCls} value={maxPages} onChange={(e) => setMaxPages(e.target.value)}>
-            {["1", "2", "3", "4", "5"].map((p) => (
-              <option key={p} value={p}>
-                {p}
-              </option>
-            ))}
-          </select>
-        </div>
-
-        <div>
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Precio mín. (AED)</label>
-          <input className={inputCls} type="number" min="0" placeholder="500000" value={minPrice} onChange={(e) => setMinPrice(e.target.value)} />
-        </div>
-        <div>
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Precio máx. (AED)</label>
-          <input className={inputCls} type="number" min="0" placeholder="2000000" value={maxPrice} onChange={(e) => setMaxPrice(e.target.value)} />
-        </div>
-        <div>
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Superficie mín. (sqft)</label>
-          <input className={inputCls} type="number" min="0" placeholder="800" value={minArea} onChange={(e) => setMinArea(e.target.value)} />
-        </div>
-        <div>
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Superficie máx. (sqft)</label>
-          <input className={inputCls} type="number" min="0" placeholder="1500" value={maxArea} onChange={(e) => setMaxArea(e.target.value)} />
-        </div>
-      </div>
-
-      <div className="mt-3">
-        <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Habitaciones</label>
-        <div className="flex flex-wrap gap-2">
-          {BEDROOM_OPTS.map((b) => (
-            <button
-              key={b}
-              type="button"
-              onClick={() => toggle(bedrooms, b, setBedrooms)}
-              className={`rounded-full border px-3 py-1 text-sm ${
-                bedrooms.includes(b)
-                  ? "border-neutral-900 bg-neutral-900 text-white dark:border-white dark:bg-white dark:text-neutral-900"
-                  : "border-neutral-300 dark:border-neutral-700"
-              }`}
-            >
-              {b === "0" ? "Studio" : b === "5" ? "5+" : b}
-            </button>
-          ))}
-        </div>
-      </div>
-
-      <div className="mt-3">
-        <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">Características</label>
-        <div className="flex flex-wrap gap-2">
-          {AMENITIES.map((a) => (
-            <button
-              key={a.value}
-              type="button"
-              onClick={() => toggle(amenities, a.value, setAmenities)}
-              className={`rounded-full border px-3 py-1 text-xs ${
-                amenities.includes(a.value)
-                  ? "border-neutral-900 bg-neutral-900 text-white dark:border-white dark:bg-white dark:text-neutral-900"
-                  : "border-neutral-300 dark:border-neutral-700"
-              }`}
-            >
-              {a.label}
-            </button>
-          ))}
-        </div>
-      </div>
-
-      <div className="mt-3 flex flex-wrap items-end gap-3">
-        <div>
-          <label className="mb-1 block text-xs font-semibold text-neutral-600 dark:text-neutral-400">
-            Dist. máx. a gimnasio externo (km, opcional)
-          </label>
-          <input
-            className={inputCls}
-            type="number"
-            step="0.1"
-            min="0"
-            placeholder="p. ej. 0.5"
-            value={maxGymKm}
-            onChange={(e) => setMaxGymKm(e.target.value)}
-          />
-        </div>
-        <button
-          type="submit"
-          disabled={searching}
-          className="ml-auto rounded-lg bg-blue-600 px-6 py-2.5 text-sm font-bold text-white hover:bg-blue-500 disabled:opacity-50"
-        >
-          {searching ? "Scrapeando…" : "Buscar en Property Finder"}
-        </button>
-      </div>
-    </form>
-  );
-}

package/src/components/ListingCard.tsx

@@ -1,145 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import Link from "next/link";
-import YieldBadge from "./YieldBadge";
-import { fmtAED, fmtDist, fmtSqft } from "@/lib/format";
-import { AnalysisRow } from "@/lib/types";
-
-export interface CardListing {
-  id: string;
-  url: string;
-  title: string;
-  price: number;
-  size_sqft: number | null;
-  bedrooms: number | null;
-  bathrooms: number | null;
-  property_type: string;
-  tower_name: string | null;
-  images: { small: string; medium: string }[];
-  amenities: string[];
-}
-
-export default function ListingCard({
-  listing,
-  analysis: initialAnalysis,
-  onAnalyzed,
-}: {
-  listing: CardListing;
-  analysis?: AnalysisRow | null;
-  onAnalyzed?: (id: string, a: AnalysisRow) => void;
-}) {
-  const [analysis, setAnalysis] = useState<AnalysisRow | null>(initialAnalysis ?? null);
-  const [loading, setLoading] = useState(false);
-  const [imgIdx, setImgIdx] = useState(0);
-  const images = listing.images || [];
-
-  const analyze = () => {
-    if (loading || analysis) return;
-    setLoading(true);
-    fetch(`/api/listing/${listing.id}?url=${encodeURIComponent(listing.url)}`)
-      .then(async (r) => {
-        const j = await r.json();
-        if (!r.ok) throw new Error(j.error || `HTTP ${r.status}`);
-        setAnalysis(j.analysis);
-        onAnalyzed?.(listing.id, j.analysis);
-      })
-      .catch(() => {})
-      .finally(() => setLoading(false));
-  };
-
-  return (
-    <div className="group flex flex-col overflow-hidden rounded-xl border border-neutral-200 bg-white shadow-sm transition hover:shadow-md dark:border-neutral-800 dark:bg-neutral-900">
-      <div className="relative aspect-[3/2] bg-neutral-100 dark:bg-neutral-800">
-        {images.length > 0 && (
-          // eslint-disable-next-line @next/next/no-img-element
-          <img
-            src={images[imgIdx]?.medium || images[imgIdx]?.small}
-            alt={listing.title}
-            className="h-full w-full object-cover"
-            loading="lazy"
-          />
-        )}
-        {images.length > 1 && (
-          <div className="absolute inset-x-0 bottom-0 flex items-center justify-between p-2 opacity-0 transition group-hover:opacity-100">
-            <button
-              onClick={() => setImgIdx((imgIdx - 1 + images.length) % images.length)}
-              className="rounded-full bg-black/50 px-2.5 py-1 text-sm text-white"
-            >
-              ‹
-            </button>
-            <span className="rounded-full bg-black/50 px-2 py-0.5 text-xs text-white">
-              {imgIdx + 1}/{images.length}
-            </span>
-            <button
-              onClick={() => setImgIdx((imgIdx + 1) % images.length)}
-              className="rounded-full bg-black/50 px-2.5 py-1 text-sm text-white"
-            >
-              ›
-            </button>
-          </div>
-        )}
-        <div className="absolute left-2 top-2">
-          {loading ? (
-            <span className="inline-flex items-center rounded-full bg-black/60 px-2 py-0.5 text-xs font-medium text-white">
-              analizando…
-            </span>
-          ) : analysis ? (
-            <YieldBadge value={analysis.gross_yield} n={analysis.rent_n} />
-          ) : null}
-        </div>
-      </div>
-
-      <div className="flex flex-1 flex-col gap-1.5 p-3">
-        <div className="flex items-baseline justify-between gap-2">
-          <span className="text-lg font-bold">{fmtAED(listing.price)}</span>
-          <span className="shrink-0 text-xs text-neutral-500">{listing.property_type}</span>
-        </div>
-        <Link href={`/listing/${listing.id}`} className="line-clamp-2 text-sm font-medium hover:underline">
-          {listing.title}
-        </Link>
-        <div className="text-xs text-neutral-500">
-          {listing.bedrooms === 0 ? "Studio" : `${listing.bedrooms ?? "?"} hab`} · {listing.bathrooms ?? "?"} baños ·{" "}
-          {fmtSqft(listing.size_sqft)}
-        </div>
-        {listing.tower_name && (
-          <div className="truncate text-xs text-neutral-500">📍 {listing.tower_name}</div>
-        )}
-        {analysis && (
-          <div className="mt-1 grid grid-cols-2 gap-x-3 gap-y-0.5 text-xs text-neutral-600 dark:text-neutral-400">
-            <span>Alquiler/año: {fmtAED(analysis.median_rent)}</span>
-            <span>🏋️ {fmtDist(analysis.gym_distance_m)}</span>
-            <span>Venta med.: {fmtAED(analysis.median_sale_price)}</span>
-            <span>s/ anuncio: {analysis.asking_yield != null ? (analysis.asking_yield * 100).toFixed(1) + " %" : "—"}</span>
-          </div>
-        )}
-        <div className="mt-auto flex items-center gap-3 pt-2">
-          {analysis ? (
-            <Link
-              href={`/listing/${listing.id}`}
-              className="rounded-lg bg-neutral-900 px-3 py-1.5 text-xs font-semibold text-white hover:bg-neutral-700 dark:bg-white dark:text-neutral-900 dark:hover:bg-neutral-200"
-            >
-              Ver análisis
-            </Link>
-          ) : (
-            <button
-              onClick={analyze}
-              disabled={loading}
-              className="rounded-lg bg-blue-600 px-3 py-1.5 text-xs font-semibold text-white hover:bg-blue-500 disabled:opacity-60"
-            >
-              {loading ? "Analizando…" : "⚡ Analizar"}
-            </button>
-          )}
-          <a
-            href={listing.url}
-            target="_blank"
-            rel="noopener noreferrer"
-            className="text-xs font-medium text-blue-600 hover:underline dark:text-blue-400"
-          >
-            Ver en Property Finder ↗
-          </a>
-        </div>
-      </div>
-    </div>
-  );
-}

package/src/lib/dedupe.ts

@@ -1,34 +0,0 @@
-interface UnitLike {
-  id: string;
-  tower_slug: string | null;
-  bedrooms: number | null;
-  size_sqft: number | null;
-  price: number;
-}
-
-/**
- * The same physical apartment is often listed by several agents under different
- * Property Finder ids. Those share the building, bedroom count, size and asking
- * price (agents copy the same DLD figures), so collapse them to one card.
- *
- * When any of those fields is missing we cannot be confident two rows are the
- * same unit, so we key on the id and never merge.
- */
-function unitSignature(r: UnitLike): string {
-  if (!r.tower_slug || r.size_sqft == null || !r.price) return `id:${r.id}`;
-  const bd = r.bedrooms == null ? "?" : r.bedrooms;
-  return `${r.tower_slug}|${bd}|${Math.round(r.size_sqft)}|${r.price}`;
-}
-
-/** Keep the first occurrence of each physical unit (newest first with ob=mr). */
-export function dedupeListings<T extends UnitLike>(rows: T[]): { unique: T[]; removed: number } {
-  const seen = new Set<string>();
-  const unique: T[] = [];
-  for (const r of rows) {
-    const sig = unitSignature(r);
-    if (seen.has(sig)) continue;
-    seen.add(sig);
-    unique.push(r);
-  }
-  return { unique, removed: rows.length - unique.length };
-}