@geoalgeria/sante 1.0.0

package/index.js

@@ -0,0 +1,12 @@
+// @geoalgeria/sante — lightweight loaders for Algeria's public health establishments.
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const DATA = join(dirname(fileURLToPath(import.meta.url)), "data");
+const load = (p) => JSON.parse(readFileSync(join(DATA, p), "utf-8"));
+
+export const sante = () => load("sante.json"); // public health establishments (MSP registry, geocoded)
+export const metadata = () => load("metadata.json");
+
+export default { sante, metadata };

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@geoalgeria/sante",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Public health establishments of Algeria — hospitals (EPH), proximity health (EPSP), specialized hospitals (EHS) and university hospitals (CHU) from the Ministère de la Santé, bilingual FR/AR, geocoded via OpenStreetMap & Wikidata, with commune/wilaya linkage. JSON, CSV, GeoJSON, TypeScript.",
+  "main": "index.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./index.js"
+    },
+    "./data/*": "./data/*"
+  },
+  "files": [
+    "data/**/*.json",
+    "data/**/*.csv",
+    "data/**/*.geojson",
+    "types/",
+    "index.js"
+  ],
+  "scripts": {
+    "fetch": "node scripts/fetch.mjs",
+    "test": "node ../../scripts/validate-packages.mjs sante"
+  },
+  "keywords": [
+    "algeria",
+    "sante",
+    "health",
+    "hospital",
+    "hopital",
+    "eph",
+    "epsp",
+    "ehs",
+    "chu",
+    "healthcare",
+    "ministry-of-health",
+    "openstreetmap",
+    "wikidata",
+    "geojson",
+    "geoalgeria",
+    "dz"
+  ],
+  "author": "Yasser's Studio (https://yasser.studio)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/yasserstudio/geoalgeria/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yasserstudio/geoalgeria.git",
+    "directory": "packages/sante"
+  },
+  "homepage": "https://geoalgeria.com",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,98 @@
+// Type definitions for @geoalgeria/sante
+// Public health establishments of Algeria — the Ministère de la Santé (MSP)
+// registry, geocoded via OpenStreetMap (ODbL) and Wikidata (CC0).
+
+/** Establishment category. */
+export type HealthType = "eph" | "epsp" | "ehs" | "chu" | "clinique" | "hopital";
+
+/** Ownership sector. The MSP registry is public; private clinics carry "private". */
+export type HealthSector = "public" | "private";
+
+/** Where the record's identity came from, plus which geo sources contributed a precise point. */
+export type HealthSource =
+  | "msp"
+  | "msp+osm"
+  | "msp+wikidata"
+  | "msp+osm+wikidata";
+
+/** How the coordinates were obtained. */
+export type GeoPrecision =
+  | "osm_point"
+  | "wikidata_point"
+  | "commune_centroid"
+  | "none";
+
+/** A public health establishment. */
+export interface HealthEstablishment {
+  /** Stable id, `{wilaya_code}-{type}-{seq}` (e.g. "22-eph-01"). */
+  id: string;
+  /** Best available display name (French preferred, else Arabic). */
+  name: string;
+  /** Arabic name, or null. */
+  name_ar: string | null;
+  /** French name, or null. */
+  name_fr: string | null;
+  /** Establishment category. */
+  type: HealthType;
+  /** Canonical French label for the type. */
+  type_label_fr: string;
+  /** Canonical Arabic label for the type. */
+  type_label_ar: string;
+  /** Ownership sector ("public" for the MSP registry). */
+  sector: HealthSector;
+  /** Wilaya name (French). */
+  wilaya: string;
+  /** Wilaya name (Arabic). */
+  wilaya_ar: string;
+  /** Wilaya code as a zero-padded string ("01".."69"). */
+  wilaya_code: string;
+  /** Commune name (French), best-effort from the establishment locality. Null when unresolved. */
+  commune: string | null;
+  /** Commune code (geoalgeria code_commune), best-effort. Null when unresolved. */
+  commune_code: number | null;
+  /** Latitude, or null when the establishment could not be geocoded. */
+  lat: number | null;
+  /** Longitude, or null when the establishment could not be geocoded. */
+  lng: number | null;
+  /** Provenance: MSP registry, plus OSM/Wikidata where a precise point matched. */
+  source: HealthSource;
+  /** How `lat`/`lng` were obtained. */
+  geo_precision: GeoPrecision;
+  /** Wikidata QID when a Wikidata facility matched, else null. */
+  wikidata: string | null;
+  /** OSM element id (e.g. "node/123") when an OSM facility matched, else null. */
+  osm_id: string | null;
+  /** Source post id on sante.gov.dz (French post preferred). */
+  msp_id: number;
+  /** URL slug of the source post (French post preferred). */
+  slug: string;
+}
+
+/** Dataset metadata (data/metadata.json). */
+export interface Metadata {
+  source: string;
+  origin: string;
+  license: string;
+  sante: number;
+  by_type: Record<HealthType, number>;
+  by_sector: Record<HealthSector, number>;
+  by_geo_precision: Record<GeoPrecision, number>;
+  wilayas_covered: number;
+  geocoded: number;
+  bilingual: number;
+  linkage_note: string;
+  coverage_note: string;
+  /** ISO date (YYYY-MM-DD) the snapshot was generated. */
+  generated_at: string;
+}
+
+/** All public health establishments. */
+export function sante(): HealthEstablishment[];
+/** Dataset metadata. */
+export function metadata(): Metadata;
+
+declare const _default: {
+  sante: typeof sante;
+  metadata: typeof metadata;
+};
+export default _default;