Client for getDrivingLicenseDetailsByNumberL service of KED

Client to connect to getDrivingLicenseDetailsByNumberL service, useful for nextjs/nodejs projects.

Example:

import getDrivingLicenseDetailsByNumberL from '@digigov-oss/get-driving-license-details-by-number-l-client';

const test = async () => {
   const overrides = {
        prod:false,
        auditInit: {
            auditUnit: 'grnet.gr',
        },
        auditStoragePath: '/auditStorage',
    }

    try {
        return await getDrivingLicenseDetailsByNumberL("000152418", "username", "password", overrides);
    } catch (error) {
        console.log(error);
    }
}

test().then((r) => { console.log('getDrivingLicenseDetailsByNumberL', r); });

• you can use overrides to override the default values
• for your tests, you don't need to use the overrides mecahnism,in that case, the default storage path will be used ie /tmp
• look at KED standard guides for records you can use on auditInit" Also, you can use overrides to override the default storage engine.

import getDrivingLicenseDetailsByNumberL from '@digigov-oss/get-driving-license-details-by-number-l-client';
import {PostgreSqlEngine} from '@digigov-oss/gsis-audit-record-db'; 

const test = async () => {
    try {
        const overrides = {
        auditEngine: new PostgreSqlEngine('postgres://postgres:postgres@localhost:5432/postgres'),
        auditInit: {
            auditUnit: 'grnet.gr',
        },
        }
        return await getDrivingLicenseDetailsByNumberL("000152418", "username", "password", overrides);
    } catch (error) {
        console.log(error);
    }
}

test().then((r) => { console.log('getDrivingLicenseDetailsByNumberL', r); });

Look at module AuditRecordDB for more details on how to use the AuditEngine.

If you plan to use only the FileEngine, you can skip the installation of other engines by ignoring optional dependencies. i.e. yarn install --ignore-optional

Returns

an object like the following:

"getDrivingLicenseDetailsByNumberL"{
   "imerominiaOraApostolis":"2022-11-10T15:43:14.9375338+02:00",
   "kodikosKatastasis":"Successful",
   "minimaKatastasis":"OK",
   "driverLicenceInformation":{
      "driverDetails":[
         {
            "familyName":"ΕΠΩΝΥΜΟ0152418",
            "familyNameL":"LASTNAME0152418",
            "firstName":"ΟΝΟΜΑ0152418",
            "firstNameL":"FIRSTNAME0152418",
            "fatherName":"ΠΑΤ0152418",
            "fatherNameL":"FNA0152418",
            "dateOfBirth":"1933-04-13",
            "gender":"M",
            "placeOfBirth":"ΤΟΠΟΣ0152418 ΗΡΑΚΛΕΙΟΥ",
            "countryOfBirth":"GR",
            "personalNumber":"001636325",
            "identificationCardNumber":"Α0152418",
            "drivingLicenceDetails":{
               "licenceNumber":"000152418",
               "issueDate":"2019-11-06",
               "administrativeNumber":"0000000000000",
               "issuingAuthority":"46",
               "issuingAuthorityDescr":"ΗΡΑΚΛΕΙΟΥ",
               "modificationAuthority":"46",
               "status":"Valid",
               "expiryDate":"2021-10-22",
               "categoryDetails":{
                  "numberOfCategories":"2",
                  "remarks":"10702,11600,00200 AB,06400 050,06100,06200 030,00000,00000,00000,00000,00000,00000",
                  "categoryDetail":[
                     {
                        "code":"A",
                        "issueDate":"1962-12-17",
                        "expiryDate":"2021-10-22"
                     },
                     {
                        "code":"B",
                        "issueDate":"1955-09-05",
                        "expiryDate":"2021-10-22"
                     }
                  ]
               }
            }
         }
      ]
   }
}

or an message like the following if no such license number exists:

kodikosKatastasis: 'Successful',
minimaKatastasis: 'OK',
driverLicenceInformation: null,

Available data for testing:

000152418

* Notes

you have to ask KED for drivingLicense_KED_v0.91 documentation to get more info about the output and error fields.

* known issues

If KED advertises a wrong endpoint for the service on production WSDL, you can override the endpoint on the overrides object.

const overrides = {
    endpoint: 'my new endpoint here',
}