@geoalgeria/agriculture 1.0.0

package/data/metadata.json

@@ -0,0 +1,29 @@
+{
+  "source": "Ministry of Agriculture, Rural Development and Fisheries (MADR) institutional directory (madr.gov.dz / fr.madr.gov.dz), geocoded against the geoalgeria commune set",
+  "origin": "https://madr.gov.dz/contact/دليل-الهاتف/, https://fr.madr.gov.dz/contact/annuaire/",
+  "license": "MADR directory: factual public-sector listing. See README for attribution.",
+  "agriculture": 196,
+  "by_type": {
+    "centre_formation": 11,
+    "chambre_agriculture": 49,
+    "conservation_forets": 48,
+    "dsa": 58,
+    "groupe_public": 10,
+    "institut_recherche": 16,
+    "office_public": 4
+  },
+  "by_sector": {
+    "public": 196
+  },
+  "by_geo_precision": {
+    "wikidata_point": 0,
+    "commune_centroid": 89,
+    "wilaya_centroid": 107,
+    "none": 0
+  },
+  "wilayas_covered": 58,
+  "geocoded": 196,
+  "linkage_note": "Names + wilaya + address + phone/fax are from the MADR directory, which carries no coordinates. Commune is matched from the address against the geoalgeria commune set within the wilaya; coordinates are that commune's centroid, or the wilaya chief-town centroid when the address has no recognizable commune (see geo_precision).",
+  "coverage_note": "196 agriculture-sector institutions across 7 MADR networks (DSA, Conservations des Forêts, technical/research institutes, training centres, Chambres d'Agriculture, public offices, public groups). DSA covers all 58 wilayas; Conservations des Forêts and Chambres use the pre-2019 48-wilaya division. Names + wilaya are official; coordinates are best-effort (mostly commune/wilaya centroid).",
+  "generated_at": "2026-06-30"
+}

package/index.js

@@ -0,0 +1,22 @@
+// @geoalgeria/agriculture — lightweight loaders for Algeria's agriculture-sector institutions.
+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 agriculture = () => load("agriculture.json"); // MADR institutional directory, geocoded
+export const institutionById = (id) =>
+  agriculture().find((r) => r.id === String(id)) ?? null;
+export const institutionsByWilaya = (code) => {
+  const w = String(code).padStart(2, "0");
+  return agriculture().filter((r) => r.wilaya_code === w);
+};
+export const institutionsByType = (type) => {
+  const t = String(type).toLowerCase();
+  return agriculture().filter((r) => r.type === t);
+};
+export const metadata = () => load("metadata.json");
+
+export default { agriculture, institutionById, institutionsByWilaya, institutionsByType, metadata };

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@geoalgeria/agriculture",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Agriculture-sector institutions of Algeria — agricultural-services directorates (DSA), forest conservations, technical & research institutes, training centres, chambers of agriculture, public offices and groups from the Ministry of Agriculture (MADR), bilingual FR/AR, geocoded against the geoalgeria commune set with wilaya/commune 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": {
+    "test": "node ../../scripts/validate-packages.mjs agriculture"
+  },
+  "keywords": [
+    "algeria",
+    "agriculture",
+    "madr",
+    "dsa",
+    "forets",
+    "chambre-agriculture",
+    "inraa",
+    "itgc",
+    "ministry-of-agriculture",
+    "rural-development",
+    "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/agriculture"
+  },
+  "homepage": "https://geoalgeria.com",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,116 @@
+// Type definitions for @geoalgeria/agriculture
+// Agriculture-sector institutions of Algeria — the Ministry of Agriculture,
+// Rural Development and Fisheries (MADR) institutional directory, geocoded
+// against the geoalgeria commune set.
+
+/** Institution network / category. */
+export type AgricultureType =
+  | "dsa"
+  | "conservation_forets"
+  | "institut_recherche"
+  | "centre_formation"
+  | "chambre_agriculture"
+  | "office_public"
+  | "groupe_public";
+
+/** Ownership sector (the MADR directory is entirely public-sector). */
+export type AgricultureSector = "public";
+
+/** Where the record's identity came from, plus which geo sources contributed a precise point. */
+export type AgricultureSource = "madr" | "madr+wikidata";
+
+/** How the coordinates were obtained. */
+export type GeoPrecision =
+  | "wikidata_point"
+  | "commune_centroid"
+  | "wilaya_centroid"
+  | "none";
+
+/** An agriculture-sector institution. */
+export interface AgricultureInstitution {
+  /** Stable id, `{wilaya_code}-{type}-{seq}` (e.g. "16-office_public-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 (most named entities are Arabic-only at source). */
+  name_fr: string | null;
+  /** Institution network / category. */
+  type: AgricultureType;
+  /** Canonical French label for the type. */
+  type_label_fr: string;
+  /** Canonical Arabic label for the type. */
+  type_label_ar: string;
+  /** Ownership sector (always "public" for the MADR directory). */
+  sector: AgricultureSector;
+  /** Latin abbreviation (e.g. "INRAA", "OAIC", "ITMAS Alger"), or null. */
+  abbreviation: string | null;
+  /** Wilaya name (French). */
+  wilaya: string;
+  /** Wilaya name (Arabic). */
+  wilaya_ar: string;
+  /** Wilaya code as a zero-padded string ("01".."58"). */
+  wilaya_code: string;
+  /** Commune name (French), best-effort from the address. Null when unresolved. */
+  commune: string | null;
+  /** Commune code (geoalgeria code_commune), best-effort. Null when unresolved. */
+  commune_code: number | null;
+  /** Latitude (commune/wilaya centroid, or a precise point). */
+  lat: number | null;
+  /** Longitude (commune/wilaya centroid, or a precise point). */
+  lng: number | null;
+  /** Street address (Arabic) as listed in the directory, or null. */
+  address: string | null;
+  /** Phone number (digits), or null. */
+  phone: string | null;
+  /** Fax number (digits), or null. */
+  fax: string | null;
+  /** Provenance: MADR directory, plus Wikidata where a precise point matched. */
+  source: AgricultureSource;
+  /** How `lat`/`lng` were obtained. */
+  geo_precision: GeoPrecision;
+  /** Wikidata QID when a Wikidata entity matched, else null. */
+  wikidata: string | null;
+  /** OSM element id (e.g. "node/123") when an OSM entity matched, else null. */
+  osm_id: string | null;
+  /** URL slug. */
+  slug: string;
+}
+
+/** Dataset metadata (data/metadata.json). */
+export interface Metadata {
+  source: string;
+  origin: string;
+  license: string;
+  agriculture: number;
+  by_type: Record<AgricultureType, number>;
+  by_sector: Record<AgricultureSector, number>;
+  by_geo_precision: Record<GeoPrecision, number>;
+  wilayas_covered: number;
+  geocoded: number;
+  linkage_note: string;
+  coverage_note: string;
+  /** ISO date (YYYY-MM-DD) the snapshot was generated. */
+  generated_at: string;
+}
+
+/** All agriculture-sector institutions. */
+export function agriculture(): AgricultureInstitution[];
+/** A single institution by id, or null. */
+export function institutionById(id: string): AgricultureInstitution | null;
+/** Institutions in a wilaya (accepts numeric or zero-padded code). */
+export function institutionsByWilaya(code: string | number): AgricultureInstitution[];
+/** Institutions of a given type. */
+export function institutionsByType(type: AgricultureType | string): AgricultureInstitution[];
+/** Dataset metadata. */
+export function metadata(): Metadata;
+
+declare const _default: {
+  agriculture: typeof agriculture;
+  institutionById: typeof institutionById;
+  institutionsByWilaya: typeof institutionsByWilaya;
+  institutionsByType: typeof institutionsByType;
+  metadata: typeof metadata;
+};
+export default _default;