Feat/web api missing functions

src/api/getBaladiyaByCodeAndDairaCodeAndWilayaCode.js

@@ -0,0 +1,31 @@
+const projectBaladiya = require('../utils/projections/projectObject');
+
+const getBaladiyaByCodeAndDairaCodeAndWilayaCode = (data) =>
+/**
+   * Takes a wilaya mattricule ,a daira code , bladiya code and return the baladyia.
+   *
+   * @example Get a baladiya  by code, daira code, and wilaya mattricule(mattricule:1, code:101, bcode:101)
+   *
+   * //returns {name : "ADRAR"}
+   * getWilayaByBaladyiaName(1, 101,101)
+   *
+   * @param { integer } mattricule wilaya mattricule
+   * @param { integer } code daira code
+   * @param { integer } bcode baladiya code
+   * @param { String[] } projection a list of Baladyia object attributes to keep
+   * @returns { Object | null } Returns  a baldiya's object, or null
+   */
+  (mattricule, code, bcode, projection)=>{
+    const wilaya = data.find((w) => w.mattricule === mattricule);
+    if (wilaya) {
+      const daira = wilaya.dairats.find((d)=> d.code === code);
+      if( daira){
+        const baladiya = daira.baladyiats.find((b)=> b.code === bcode);
+        return projectBaladiya(baladiya, projection);
+      }
+
+    }
+    return null;
+  };
+
+module.exports = getBaladiyaByCodeAndDairaCodeAndWilayaCode;

src/api/getBaldiyaByCodeForWilaya.js

@@ -0,0 +1,38 @@
+const projectBaladiya = require('../utils/projections/projectObject');
+
+const getBaldiyaByCodeForWilaya = (data) =>
+/**
+   * Takes a wilaya code (mattricule) and a baladiya code  and return a baladiya
+   *
+   * @example Get the baladiya of adrar  in adrara(mattricule:1 ,code: 101)
+   *
+   *
+   * getBaldiyaByCodeForWilaya(1, 101)
+   *
+   * @param { Number } mattricule wilaya code (mattricule)
+   * @param { Number } code baladiya code (code)
+   * @param { String[] } projection a list of Baladyia object attributes to keep
+   * @returns { Object[] | null } get baladiya's object
+   */
+
+  (mattricule, code, projections) => {
+    const wilaya = data.find((w) => w.mattricule === mattricule);
+    if (wilaya) {
+      const baladyiats = wilaya.dairats.reduce(
+        (acc, daira) => [...acc, ...daira.baladyiats],
+        [],
+      );
+
+      const baladiya = baladyiats.find((w)=> w.code === code);
+      if (baladiya){
+        return projectBaladiya(baladiya, projections);
+      }
+
+
+    }
+
+
+    return null;
+  };
+
+module.exports = getBaldiyaByCodeForWilaya;

src/api/getBaldiyatsForDairaByCodeForWilayaByCode.js

@@ -0,0 +1,29 @@
+const getBaldiyatsForDairaByCodeForWilayaByCode = (data) =>
+/**
+   * Takes a wilaya code (mattricule), daira code (code) and returns array of Baladiyates of wilaya.
+   *
+   * @example Get Baladiyats list of adrar daira in  adrar wilaya (mattricule:1 ,code: 101)
+   *
+   *
+   * getBaldiyatsForDairaByCodeForWilayaByCode(1, 101)
+   *
+   * @param { Number } mattricule wilaya code (mattricule)
+   * @param { Number } code baladiya code (code)
+   * @param { String[] } projection a list of Baladyia object attributes to keep
+   * @returns { Object[] | null } list of all baladiyas for wilaya
+   */
+
+  (mattricule, code) => {
+    const wilaya = data.find((w) => w.mattricule === mattricule);
+    if (wilaya) {
+      const daira = wilaya.dairats.find((d) => d.code === code);
+
+      if(daira){
+        return daira.baladyiats;
+      }
+
+    }
+    return null;
+  };
+
+module.exports = getBaldiyatsForDairaByCodeForWilayaByCode;

src/api/getDairaByCodeAndWilayaCode.js

@@ -0,0 +1,26 @@
+const projectDaira = require('../utils/projections/projectObject');
+
+const getDairaByCodeAndWilayaCode = (data)=>
+/**
+   * Takes a wilaya mattricule and a daira code and return daira.
+   *
+   * @example Get a daira  by code and wilaya mattricule(mattricule:1, code:101)
+   *
+   * //returns {name : "ADRAR"}
+   * getWilayaByBaladyiaName(1, 101)
+   *
+   * @param { integer } mattricule wilaya mattricule
+   * @param { integer } code daira code
+   * @param { String[] } projection a list of Baladyia object attributes to keep
+   * @returns { Object | null } Returns daira's object, or null
+   */
+  (mattricule, code, projection)=>{
+    const wilaya = data.find((w) => w.mattricule === mattricule);
+    if (wilaya) {
+      const daira = wilaya.dairats.find((d)=> d.code === code);
+      return projectDaira(daira, projection);
+    }
+    return null;
+  };
+
+module.exports = getDairaByCodeAndWilayaCode;

src/index.js

@@ -16,7 +16,10 @@ const getBaladyiatsForWilaya = require('./api/getBaladyiatsForWilaya');
 const getBaladyiatsForDaira = require('./api/getBaladyiatsForDaira');
 const getWilayaByBaladyiaName = require('./api/getWilayaByBaladyiaName');
 const getDairaByBaladyiaName = require('./api/getDairaByBaladyiaName');
-
+const getDairaByCodeAndWilayaCode = require('./api/getDairaByCodeAndWilayaCode');
+const getBaladiyaByCodeAndDairaCodeAndWilayaCode = require('./api/getBaladiyaByCodeAndDairaCodeAndWilayaCode');
+const getBaldiyatsForDairaByCodeForWilayaByCode =  require('./api/getBaldiyatsForDairaByCodeForWilayaByCode');
+const getBaldiyaByCodeForWilaya = require('./api/getBaldiyaByCodeForWilaya');
 const data = require('../data/WilayaList.json');
 
 const _getData = () => [...data];
@@ -35,6 +38,10 @@ module.exports = {
   getBaladyiatsForDaira: getBaladyiatsForDaira(_getData()),
   getWilayaByBaladyiaName: getWilayaByBaladyiaName(_getData()),
   getDairaByBaladyiaName: getDairaByBaladyiaName(_getData()),
+  getDairaByCodeAndWilayaCode: getDairaByCodeAndWilayaCode(_getData()),
+  getBaladiyaByCodeAndDairaCodeAndWilayaCode: getBaladiyaByCodeAndDairaCodeAndWilayaCode(_getData()),
+  getBaldiyatsForDairaByCodeForWilayaByCode: getBaldiyatsForDairaByCodeForWilayaByCode(_getData()),
+  getBaldiyaByCodeForWilaya: getBaldiyaByCodeForWilaya(_getData()),
   utils: {
     projectObject,
     isValidWilayaCode,

tests/api/getBaladiyaByCodeAndDairaCodeAndWilayaCode.test.js

@@ -0,0 +1,72 @@
+describe('get matching daira  by code and wilaya mattricule', ()=>{
+  const mockData = [
+    {
+      mattricule: 47,
+      name: 'Ghardaïa',
+      dairats: [
+        {
+          code: 4701,
+          name: 'GHARDAIA',
+          name_ar: 'غرداية',
+          name_en: 'GHARDAIA',
+          baladyiats: [
+            {
+              code: 4701,
+              name: 'GHARDAIA',
+              name_en: 'GHARDAIA',
+              name_ar: 'غرداية',
+            },
+            {
+              code: 4702,
+              name: 'EL MENIAA',
+              name_en: 'EL MENIAA',
+              name_ar: 'المنيعة',
+            },
+          ],
+        },
+      ],
+    },
+  ];
+
+
+
+  let getBaladiyaByCodeAndDairaCodeAndWilayaCode;
+  beforeEach(()=>{
+    getBaladiyaByCodeAndDairaCodeAndWilayaCode = require('../../src/api/getBaladiyaByCodeAndDairaCodeAndWilayaCode');
+  });
+
+  it('should export a function', () => {
+    expect(typeof getBaladiyaByCodeAndDairaCodeAndWilayaCode).toBe('function');
+  });
+
+  it('should return a curried function that returns the data', () => {
+    const fn = getBaladiyaByCodeAndDairaCodeAndWilayaCode(mockData);
+
+    expect(typeof fn).toBe('function');
+  });
+
+  it('should return null for invalid wilaya mattricule and baladiya and daira code ', () => {
+    const result = getBaladiyaByCodeAndDairaCodeAndWilayaCode(mockData)(99, 1, 99);
+
+    expect(result).toBeNull();
+  });
+
+  it('should return null for invalid baladiya and daira code ', () => {
+    const result = getBaladiyaByCodeAndDairaCodeAndWilayaCode(mockData)(47, 88, 99);
+
+    expect(result).toBeNull();
+  });
+
+
+  it('should return null for invalid baladiya code ', () => {
+    const result = getBaladiyaByCodeAndDairaCodeAndWilayaCode(mockData)(47, 4701, 99);
+
+    expect(result).toBeNull();
+  });
+
+  it('should return a matching baldiya for valide wilaya mattricule,  baladiya and daira code ', () => {
+    const result = getBaladiyaByCodeAndDairaCodeAndWilayaCode(mockData)(47, 4701, 4702);
+    expect(result).toEqual(mockData[0].dairats[0].baladyiats[1]);
+  });
+
+});

tests/api/getBaldiyaByCodeForWilaya.test.js

@@ -0,0 +1,91 @@
+describe('get matching baldiyats  by  daira code and wilaya mattricule', ()=>{
+  const mockData = [
+    {
+      mattricule: 47,
+      name: 'Ghardaïa',
+      dairats: [
+        {
+          code: 4701,
+          name: 'GHARDAIA',
+          name_ar: 'غرداية',
+          name_en: 'GHARDAIA',
+          baladyiats: [
+            {
+              code: 4701,
+              name: 'GHARDAIA',
+              name_en: 'GHARDAIA',
+              name_ar: 'غرداية',
+            },
+            {
+              code: 4702,
+              name: 'EL MENIAA',
+              name_en: 'EL MENIAA',
+              name_ar: 'المنيعة',
+            },
+          ],
+        },
+      ],
+    },
+  ];
+
+  const mockDataNoBaladiyats = [
+    {
+      mattricule: 47,
+      name: 'Ghardaïa',
+      dairats: [
+        {
+          code: 4701,
+          name: 'GHARDAIA',
+          name_ar: 'غرداية',
+          name_en: 'GHARDAIA',
+          baladyiats: [
+
+          ],
+        },
+      ],
+    },
+  ];
+  let getBaldiyaByCodeForWilaya;
+
+  beforeEach(()=>{
+    getBaldiyaByCodeForWilaya = require('../../src/api/getBaldiyaByCodeForWilaya');
+  });
+
+
+
+  it('should export a function', () => {
+    expect(typeof getBaldiyaByCodeForWilaya).toBe('function');
+  });
+
+  it('should return a curried function that returns the data', () => {
+    const fn = getBaldiyaByCodeForWilaya(mockData);
+
+    expect(typeof fn).toBe('function');
+  });
+
+  it('should return null for invalid wilaya mattricule and baldiya code ', () => {
+    const result = getBaldiyaByCodeForWilaya(mockData)(99, 1);
+
+    expect(result).toBeNull();
+  });
+
+  it('should return null for invalid  baldiya code ', () => {
+    const result = getBaldiyaByCodeForWilaya(mockData)(47, 22);
+
+    expect(result).toBeNull();
+  });
+
+
+  it('should return a matching baldiya for a valide baladiya code and wilaya mattricule ', () => {
+    const result =getBaldiyaByCodeForWilaya(mockData)(47, 4702);
+
+    expect(result).toEqual(mockData[0].dairats[0].baladyiats[1]);
+  });
+
+  it('should return null for an empty data set', () => {
+    const result =getBaldiyaByCodeForWilaya(mockDataNoBaladiyats)(47, 4702);
+
+    expect(result).toBeNull();
+  });
+
+});

tests/api/getBaldiyatsForDairaByCodeForWilayaByCode.test.js

@@ -0,0 +1,69 @@
+describe('get matching baldiyats  by  daira code and wilaya mattricule', ()=>{
+  const mockData = [
+    {
+      mattricule: 47,
+      name: 'Ghardaïa',
+      dairats: [
+        {
+          code: 4701,
+          name: 'GHARDAIA',
+          name_ar: 'غرداية',
+          name_en: 'GHARDAIA',
+          baladyiats: [
+            {
+              code: 4701,
+              name: 'GHARDAIA',
+              name_en: 'GHARDAIA',
+              name_ar: 'غرداية',
+            },
+            {
+              code: 4702,
+              name: 'EL MENIAA',
+              name_en: 'EL MENIAA',
+              name_ar: 'المنيعة',
+            },
+          ],
+        },
+      ],
+    },
+  ];
+
+  let getBaldiyatsForDairaByCodeForWilayaByCode;
+
+  beforeEach(()=>{
+    getBaldiyatsForDairaByCodeForWilayaByCode = require('../../src/api/getBaldiyatsForDairaByCodeForWilayaByCode');
+  });
+
+
+
+  it('should export a function', () => {
+    expect(typeof getBaldiyatsForDairaByCodeForWilayaByCode).toBe('function');
+  });
+
+  it('should return a curried function that returns the data', () => {
+    const fn = getBaldiyatsForDairaByCodeForWilayaByCode(mockData);
+
+    expect(typeof fn).toBe('function');
+  });
+
+  it('should return null for invalid wilaya mattricule and daira code ', () => {
+    const result = getBaldiyatsForDairaByCodeForWilayaByCode(mockData)(99, 1);
+
+    expect(result).toBeNull();
+  });
+
+  it('should return null for invalid  daira code ', () => {
+    const result = getBaldiyatsForDairaByCodeForWilayaByCode(mockData)(47, 22);
+
+    expect(result).toBeNull();
+  });
+
+
+  it('should return null for invalid baladiya code ', () => {
+    const result = getBaldiyatsForDairaByCodeForWilayaByCode(mockData)(47, 4701);
+
+    expect(result).toEqual(mockData[0].dairats[0].baladyiats);
+  });
+
+
+});