@gera-services/mcp-gera-clinic 0.1.0 → 1.0.0

package/dist/cqc.js

@@ -0,0 +1,102 @@
+/**
+ * Real Care Quality Commission (CQC) provider dataset, bundled as JSON.
+ *
+ * Source: Care Quality Commission www.cqc.org.uk, crawled into GeraClinic's
+ * `crawled_listings` (vertical='geraclinic', country_code='GB') and snapshotted
+ * from apps/gera-clinic-web/src/data/cqc-cluster.generated.ts. Every record
+ * traces to a real registered provider. Public sector information licensed
+ * under the Open Government Licence v3.0.
+ *
+ * CQC publishes a CATEGORICAL rating scheme
+ * (Outstanding / Good / Requires improvement / Inadequate), never a 0–5 numeric
+ * scale, so this dataset carries NO numeric ratings. The `lastInspected` date
+ * is the real last-checked date for the provider record.
+ */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+// JSON is bundled into dist via the package "files" list; resolve relative to
+// this module so it works whether running from src (tsx) or dist (node).
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const dataset = require('./data/cqc-cluster.json');
+export const CQC_META = dataset.meta;
+export const CQC_AUTHORITIES = dataset.authorities;
+export const CQC_ATTRIBUTION = CQC_META.attribution;
+/** Every distinct provider record across authorities + their localities. */
+function buildProviderIndex() {
+    const byId = new Map();
+    for (const auth of CQC_AUTHORITIES) {
+        for (const p of auth.providers)
+            byId.set(p.cqcLocationId, p);
+        for (const loc of auth.localities) {
+            for (const p of loc.providers)
+                byId.set(p.cqcLocationId, p);
+        }
+    }
+    return [...byId.values()];
+}
+export const ALL_PROVIDERS = buildProviderIndex();
+/** All distinct service-type labels present in the dataset, sorted. */
+export const SERVICE_TYPES = [
+    ...new Set(ALL_PROVIDERS.flatMap((p) => p.serviceTypes)),
+].sort((a, b) => a.localeCompare(b));
+function norm(s) {
+    return s.toLowerCase().replace(/\s+/g, ' ').trim();
+}
+/** Normalised outward postcode, e.g. "TN12 6AX" -> "TN12". */
+function outwardOf(postcode) {
+    if (!postcode)
+        return null;
+    const m = postcode.trim().toUpperCase().match(/^([A-Z]{1,2}\d[A-Z\d]?)/);
+    return m ? m[1] : null;
+}
+/**
+ * Search the real CQC dataset. All filters are AND-combined; any omitted.
+ * Matching is case-insensitive substring for name/serviceType, and outward- or
+ * full-postcode prefix for postcode.
+ */
+export function searchProviders(params) {
+    const q = params.query ? norm(params.query) : null;
+    const st = params.serviceType ? norm(params.serviceType) : null;
+    const authSlug = params.authority ? norm(params.authority) : null;
+    const pcRaw = params.postcode ? params.postcode.trim().toUpperCase().replace(/\s+/g, '') : null;
+    const pcOutward = params.postcode ? outwardOf(params.postcode) : null;
+    const results = [];
+    for (const auth of CQC_AUTHORITIES) {
+        if (authSlug && norm(auth.slug) !== authSlug && norm(auth.name) !== authSlug)
+            continue;
+        for (const p of auth.providers) {
+            if (q && !norm(p.name).includes(q) && !(p.providerName && norm(p.providerName).includes(q)))
+                continue;
+            if (st && !p.serviceTypes.some((t) => norm(t).includes(st)))
+                continue;
+            if (pcRaw) {
+                const provPc = (p.postcode ?? '').toUpperCase().replace(/\s+/g, '');
+                const provOut = outwardOf(p.postcode);
+                if (!provPc.startsWith(pcRaw) && provOut !== pcOutward)
+                    continue;
+            }
+            results.push({
+                provider: p,
+                authoritySlug: auth.slug,
+                authorityName: auth.name,
+                region: auth.region,
+            });
+            if (results.length >= params.limit)
+                return results;
+        }
+    }
+    return results;
+}
+/** Look up one authority or locality area by slug or name. */
+export function findArea(slugOrName) {
+    const want = norm(slugOrName);
+    for (const auth of CQC_AUTHORITIES) {
+        if (norm(auth.slug) === want || norm(auth.name) === want)
+            return { kind: 'authority', area: auth, authorityName: auth.name };
+        for (const loc of auth.localities) {
+            if (norm(loc.slug) === want)
+                return { kind: 'locality', area: loc, authorityName: auth.name };
+        }
+    }
+    return null;
+}