ffc-pay-schemes 1.0.3 → 1.0.5

package/README.md

@@ -18,13 +18,16 @@ const {
   createSplitInvoiceNumber,
   getAccountCodeMap,
   getSchemeBatchProperties,
-  getSchemeName,
+  getSchemeIdFromSourceSystem,
+  getSchemeIds,
+  getSchemeNameFromSchemeId,
+  getSchemeNames,
   getSchemeProperties,
   getSchemes,
-  getSourceSystem,
+  getSourceSystemFromSchemeId,
+  getSourceSystems,
   schemeDoesNotRequirePPAs,
-  schemeProvidesAccountingValues,
-  schemeIds
+  schemeProvidesAccountingValues
 } = require('ffc-pay-schemes')
 ```
 
@@ -32,13 +35,16 @@ const {
 - `createSplitInvoiceNumber(paymentRequest)` creates a split invoice number for a given `paymentRequest`.
 - `getAccountCodeMap(schemeId)` returns the account code mapping used for a given `schemeId`.
 - `getSchemeBatchProperties(schemeId)` returns the batch processing properties for a given `schemeId`.
-- `getSchemeName(schemeId)` returns the scheme name for a given `schemeId`.
+- `getSchemeIdFromSourceSystem(sourceSystem)` returns the scheme ID for a given `sourceSystem`.
+- `getSchemeIds()` returns all supported scheme IDs.
+- `getSchemeNameFromSchemeId(schemeId)` returns the scheme name for a given `schemeId`.
+- `getSchemeNames()` returns all supported scheme names.
 - `getSchemeProperties(schemeId, sourceSystem, pillar)` returns the default payment properties for a scheme. A scheme can be identified by its ID or source system. The optional `pillar` can be used for manual payments.
 - `getSchemes()` returns all supported schemes as an array of objects containing `schemeId`, `schemeName` and `sourceSystem`.
-- `getSourceSystem(schemeId)` returns the source system name for a given `schemeId`.
+- `getSourceSystemFromSchemeId(schemeId)` returns the source system name for a given `schemeId`.
+- `getSourceSystems()` returns all supported source systems.
 - `schemeDoesNotRequirePPAs(schemeId)` returns `true` if Payment Hub does not support Post Payment Adjustments (PPAs) for a given `schemeId`; otherwise, it returns `false`.
 - `schemeProvidesAccountingValues(schemeId)` returns `true` if a given `schemeId` provides accounting values within its payment requests; otherwise, it returns `false`.
-- `schemeIds` provides the constants for all supported scheme IDs.
 
 ### Examples
 

package/app/get-scheme-id-from-source-system.js

@@ -0,0 +1,10 @@
+const { getSchemes } = require('./get-schemes')
+
+const getSchemeIdFromSourceSystem = (sourceSystem) => {
+  const matchingScheme = getSchemes().find((scheme) => scheme.sourceSystem === sourceSystem)
+  return matchingScheme?.schemeId
+}
+
+module.exports = {
+  getSchemeIdFromSourceSystem
+}

package/app/get-scheme-ids.js

@@ -0,0 +1,9 @@
+const schemeIds = require('./constants/scheme-ids')
+
+const getSchemeIds = () => {
+  return schemeIds
+}
+
+module.exports = {
+  getSchemeIds
+}

package/app/{get-scheme-name.js → get-scheme-name-from-scheme-id.js}

@@ -1,10 +1,10 @@
 const { getSchemes } = require('./get-schemes')
 
-const getSchemeName = (schemeId) => {
+const getSchemeNameFromSchemeId = (schemeId) => {
   const matchingScheme = getSchemes().find((scheme) => scheme.schemeId === schemeId)
   return matchingScheme?.schemeName
 }
 
 module.exports = {
-  getSchemeName
+  getSchemeNameFromSchemeId
 }

package/app/get-scheme-names.js

@@ -0,0 +1,9 @@
+const schemeNames = require('./constants/scheme-names')
+
+const getSchemeNames = () => {
+  return schemeNames
+}
+
+module.exports = {
+  getSchemeNames
+}

package/app/{get-source-system.js → get-source-system-from-scheme-id.js}

@@ -1,10 +1,10 @@
 const { getSchemes } = require('./get-schemes')
 
-const getSourceSystem = (schemeId) => {
+const getSourceSystemFromSchemeId = (schemeId) => {
   const matchingScheme = getSchemes().find((scheme) => scheme.schemeId === schemeId)
   return matchingScheme?.sourceSystem
 }
 
 module.exports = {
-  getSourceSystem
+  getSourceSystemFromSchemeId
 }

package/app/get-source-systems.js

@@ -0,0 +1,9 @@
+const sourceSystems = require('./constants/source-systems')
+
+const getSourceSystems = () => {
+  return sourceSystems
+}
+
+module.exports = {
+  getSourceSystems
+}

package/index.js

@@ -2,24 +2,30 @@ const { createInvoiceNumber } = require('./app/create-invoice-number')
 const { createSplitInvoiceNumber } = require('./app/create-split-invoice-number')
 const { getAccountCodeMap } = require('./app/get-account-code-map')
 const { getSchemeBatchProperties } = require('./app/get-scheme-batch-properties')
-const { getSchemeName } = require('./app/get-scheme-name')
+const { getSchemeIdFromSourceSystem } = require('./app/get-scheme-id-from-source-system')
+const { getSchemeIds } = require('./app/get-scheme-ids')
+const { getSchemeNameFromSchemeId } = require('./app/get-scheme-name-from-scheme-id')
+const { getSchemeNames } = require('./app/get-scheme-names')
 const { getSchemeProperties } = require('./app/get-scheme-properties')
 const { getSchemes } = require('./app/get-schemes')
-const { getSourceSystem } = require('./app/get-source-system')
+const { getSourceSystemFromSchemeId } = require('./app/get-source-system-from-scheme-id')
+const { getSourceSystems } = require('./app/get-source-systems')
 const { schemeDoesNotRequirePPAs } = require('./app/scheme-does-not-require-ppas')
 const { schemeProvidesAccountingValues } = require('./app/scheme-provides-accounting-values')
-const schemeIds = require('./app/constants/scheme-ids')
 
 module.exports = {
   createInvoiceNumber,
   createSplitInvoiceNumber,
   getAccountCodeMap,
   getSchemeBatchProperties,
-  getSchemeName,
+  getSchemeIdFromSourceSystem,
+  getSchemeIds,
+  getSchemeNameFromSchemeId,
+  getSchemeNames,
   getSchemeProperties,
   getSchemes,
-  getSourceSystem,
+  getSourceSystemFromSchemeId,
+  getSourceSystems,
   schemeDoesNotRequirePPAs,
-  schemeProvidesAccountingValues,
-  schemeIds
+  schemeProvidesAccountingValues
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ffc-pay-schemes",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Module for defining and providing details for the payment schemes supported by the Payment Hub.",
   "main": "index.js",
   "scripts": {

package/test/unit/get-scheme-id-from-source-system.test.js

@@ -0,0 +1,50 @@
+jest.mock('../../app/get-schemes', () => ({
+  getSchemes: jest.fn()
+}))
+
+const { getSchemes } = require('../../app/get-schemes')
+const { getSchemeIdFromSourceSystem } = require('../../app/get-scheme-id-from-source-system')
+
+describe('getSchemeIdFromSourceSystem', () => {
+  beforeEach(() => {
+    jest.clearAllMocks()
+  })
+
+  test('returns the schemeId for a matching source system', () => {
+    getSchemes.mockReturnValue([
+      {
+        schemeId: 1,
+        schemeName: 'Example Scheme',
+        sourceSystem: 'Example Source'
+      }
+    ])
+
+    expect(getSchemeIdFromSourceSystem('Example Source')).toBe(1)
+  })
+
+  test('returns undefined when the source system is not found', () => {
+    getSchemes.mockReturnValue([
+      {
+        schemeId: 1,
+        schemeName: 'Example Scheme',
+        sourceSystem: 'Example Source'
+      }
+    ])
+
+    expect(getSchemeIdFromSourceSystem('Not a real source')).toBeUndefined()
+  })
+
+  test('returns undefined when no schemes are available', () => {
+    getSchemes.mockReturnValue([])
+
+    expect(getSchemeIdFromSourceSystem('Not a real source')).toBeUndefined()
+  })
+
+  test('gets schemes before searching for the source system', () => {
+    getSchemes.mockReturnValue([])
+
+    getSchemeIdFromSourceSystem('Not a real source')
+
+    expect(getSchemes).toHaveBeenCalledTimes(1)
+  })
+})

package/test/unit/get-scheme-ids.test.js

@@ -0,0 +1,8 @@
+const { getSchemeIds } = require('../../app/get-scheme-ids')
+const schemeIds = require('../../app/constants/scheme-ids')
+
+describe('getSchemeIds', () => {
+  test('returns all scheme IDs', () => {
+    expect(getSchemeIds()).toEqual(schemeIds)
+  })
+})

package/test/unit/{get-scheme-name.test.js → get-scheme-name-from-scheme-id.test.js}

@@ -3,9 +3,9 @@ jest.mock('../../app/get-schemes', () => ({
 }))
 
 const { getSchemes } = require('../../app/get-schemes')
-const { getSchemeName } = require('../../app/get-scheme-name')
+const { getSchemeNameFromSchemeId } = require('../../app/get-scheme-name-from-scheme-id')
 
-describe('getSchemeName', () => {
+describe('getSchemeNameFromSchemeId', () => {
   beforeEach(() => {
     jest.clearAllMocks()
   })
@@ -19,7 +19,7 @@ describe('getSchemeName', () => {
       }
     ])
 
-    expect(getSchemeName(1)).toBe('Example Scheme')
+    expect(getSchemeNameFromSchemeId(1)).toBe('Example Scheme')
   })
 
   test('returns undefined when the scheme ID is not found', () => {
@@ -31,19 +31,19 @@ describe('getSchemeName', () => {
       }
     ])
 
-    expect(getSchemeName(2)).toBeUndefined()
+    expect(getSchemeNameFromSchemeId(2)).toBeUndefined()
   })
 
   test('returns undefined when no schemes are available', () => {
     getSchemes.mockReturnValue([])
 
-    expect(getSchemeName(2)).toBeUndefined()
+    expect(getSchemeNameFromSchemeId(2)).toBeUndefined()
   })
 
   test('gets schemes before searching for the source system', () => {
     getSchemes.mockReturnValue([])
 
-    getSchemeName(2)
+    getSchemeNameFromSchemeId(2)
 
     expect(getSchemes).toHaveBeenCalledTimes(1)
   })

package/test/unit/get-scheme-names.test.js

@@ -0,0 +1,8 @@
+const { getSchemeNames } = require('../../app/get-scheme-names')
+const schemeNames = require('../../app/constants/scheme-names')
+
+describe('getSchemeNames', () => {
+  test('returns all scheme names', () => {
+    expect(getSchemeNames()).toEqual(schemeNames)
+  })
+})

package/test/unit/{get-source-system.test.js → get-source-system-from-scheme-id.test.js}

@@ -3,9 +3,9 @@ jest.mock('../../app/get-schemes', () => ({
 }))
 
 const { getSchemes } = require('../../app/get-schemes')
-const { getSourceSystem } = require('../../app/get-source-system')
+const { getSourceSystemFromSchemeId } = require('../../app/get-source-system-from-scheme-id')
 
-describe('getSourceSystem', () => {
+describe('getSourceSystemFromSchemeId', () => {
   beforeEach(() => {
     jest.clearAllMocks()
   })
@@ -19,7 +19,7 @@ describe('getSourceSystem', () => {
       }
     ])
 
-    expect(getSourceSystem(1)).toBe('Example Source')
+    expect(getSourceSystemFromSchemeId(1)).toBe('Example Source')
   })
 
   test('returns undefined when the scheme ID is not found', () => {
@@ -31,19 +31,19 @@ describe('getSourceSystem', () => {
       }
     ])
 
-    expect(getSourceSystem(2)).toBeUndefined()
+    expect(getSourceSystemFromSchemeId(2)).toBeUndefined()
   })
 
   test('returns undefined when no schemes are available', () => {
     getSchemes.mockReturnValue([])
 
-    expect(getSourceSystem(2)).toBeUndefined()
+    expect(getSourceSystemFromSchemeId(2)).toBeUndefined()
   })
 
   test('gets schemes before searching for the source system', () => {
     getSchemes.mockReturnValue([])
 
-    getSourceSystem(2)
+    getSourceSystemFromSchemeId(2)
 
     expect(getSchemes).toHaveBeenCalledTimes(1)
   })

package/test/unit/get-source-systems.test.js

@@ -0,0 +1,8 @@
+const { getSourceSystems } = require('../../app/get-source-systems')
+const sourceSystems = require('../../app/constants/source-systems')
+
+describe('getSourceSystems', () => {
+  test('returns all source systems', () => {
+    expect(getSourceSystems()).toEqual(sourceSystems)
+  })
+})

package/test-output/cobertura-coverage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd">
-<coverage lines-valid="203" lines-covered="191" line-rate="0.9408" branches-valid="50" branches-covered="50" branch-rate="1" timestamp="1787761759725" complexity="0" version="0.1">
+<coverage lines-valid="234" lines-covered="219" line-rate="0.9358" branches-valid="50" branches-covered="50" branch-rate="1" timestamp="1787827130090" complexity="0" version="0.1">
   <sources>
     <source>/home/samplackett/ffc-pay-schemes</source>
   </sources>
@@ -22,7 +22,10 @@
             <line number="9" hits="0" branch="false"/>
             <line number="10" hits="0" branch="false"/>
             <line number="11" hits="0" branch="false"/>
+            <line number="12" hits="0" branch="false"/>
             <line number="13" hits="0" branch="false"/>
+            <line number="14" hits="0" branch="false"/>
+            <line number="16" hits="0" branch="false"/>
           </lines>
         </class>
       </classes>
@@ -49,6 +52,78 @@
             <line number="7" hits="1" branch="false"/>
           </lines>
         </class>
+        <class name="get-scheme-id-from-source-system.js" filename="app/get-scheme-id-from-source-system.js" line-rate="1" branch-rate="1">
+          <methods>
+            <method name="(anonymous_0)" hits="4" signature="()V">
+              <lines>
+                <line number="3" hits="4"/>
+              </lines>
+            </method>
+            <method name="(anonymous_1)" hits="2" signature="()V">
+              <lines>
+                <line number="4" hits="2"/>
+              </lines>
+            </method>
+          </methods>
+          <lines>
+            <line number="1" hits="1" branch="false"/>
+            <line number="3" hits="1" branch="false"/>
+            <line number="4" hits="4" branch="false"/>
+            <line number="5" hits="4" branch="false"/>
+            <line number="8" hits="1" branch="false"/>
+          </lines>
+        </class>
+        <class name="get-scheme-ids.js" filename="app/get-scheme-ids.js" line-rate="1" branch-rate="1">
+          <methods>
+            <method name="(anonymous_0)" hits="1" signature="()V">
+              <lines>
+                <line number="3" hits="1"/>
+              </lines>
+            </method>
+          </methods>
+          <lines>
+            <line number="1" hits="1" branch="false"/>
+            <line number="3" hits="1" branch="false"/>
+            <line number="4" hits="1" branch="false"/>
+            <line number="7" hits="1" branch="false"/>
+          </lines>
+        </class>
+        <class name="get-scheme-name-from-scheme-id.js" filename="app/get-scheme-name-from-scheme-id.js" line-rate="1" branch-rate="1">
+          <methods>
+            <method name="(anonymous_0)" hits="4" signature="()V">
+              <lines>
+                <line number="3" hits="4"/>
+              </lines>
+            </method>
+            <method name="(anonymous_1)" hits="2" signature="()V">
+              <lines>
+                <line number="4" hits="2"/>
+              </lines>
+            </method>
+          </methods>
+          <lines>
+            <line number="1" hits="1" branch="false"/>
+            <line number="3" hits="1" branch="false"/>
+            <line number="4" hits="4" branch="false"/>
+            <line number="5" hits="4" branch="false"/>
+            <line number="8" hits="1" branch="false"/>
+          </lines>
+        </class>
+        <class name="get-scheme-names.js" filename="app/get-scheme-names.js" line-rate="1" branch-rate="1">
+          <methods>
+            <method name="(anonymous_0)" hits="1" signature="()V">
+              <lines>
+                <line number="3" hits="1"/>
+              </lines>
+            </method>
+          </methods>
+          <lines>
+            <line number="1" hits="1" branch="false"/>
+            <line number="3" hits="1" branch="false"/>
+            <line number="4" hits="1" branch="false"/>
+            <line number="7" hits="1" branch="false"/>
+          </lines>
+        </class>
         <class name="get-scheme-properties.js" filename="app/get-scheme-properties.js" line-rate="1" branch-rate="1">
           <methods>
             <method name="(anonymous_0)" hits="54" signature="()V">
@@ -93,21 +168,58 @@
           <methods>
             <method name="(anonymous_0)" hits="18" signature="()V">
               <lines>
-                <line number="4" hits="18"/>
+                <line number="5" hits="18"/>
               </lines>
             </method>
             <method name="(anonymous_1)" hits="306" signature="()V">
               <lines>
-                <line number="5" hits="306"/>
+                <line number="6" hits="306"/>
               </lines>
             </method>
           </methods>
           <lines>
             <line number="1" hits="1" branch="false"/>
             <line number="2" hits="1" branch="false"/>
+            <line number="3" hits="1" branch="false"/>
+            <line number="5" hits="1" branch="false"/>
+            <line number="6" hits="306" branch="false"/>
+            <line number="12" hits="1" branch="false"/>
+          </lines>
+        </class>
+        <class name="get-source-system-from-scheme-id.js" filename="app/get-source-system-from-scheme-id.js" line-rate="1" branch-rate="1">
+          <methods>
+            <method name="(anonymous_0)" hits="4" signature="()V">
+              <lines>
+                <line number="3" hits="4"/>
+              </lines>
+            </method>
+            <method name="(anonymous_1)" hits="2" signature="()V">
+              <lines>
+                <line number="4" hits="2"/>
+              </lines>
+            </method>
+          </methods>
+          <lines>
+            <line number="1" hits="1" branch="false"/>
+            <line number="3" hits="1" branch="false"/>
+            <line number="4" hits="4" branch="false"/>
+            <line number="5" hits="4" branch="false"/>
+            <line number="8" hits="1" branch="false"/>
+          </lines>
+        </class>
+        <class name="get-source-systems.js" filename="app/get-source-systems.js" line-rate="1" branch-rate="1">
+          <methods>
+            <method name="(anonymous_0)" hits="1" signature="()V">
+              <lines>
+                <line number="3" hits="1"/>
+              </lines>
+            </method>
+          </methods>
+          <lines>
+            <line number="1" hits="1" branch="false"/>
+            <line number="3" hits="1" branch="false"/>
             <line number="4" hits="1" branch="false"/>
-            <line number="5" hits="306" branch="false"/>
-            <line number="10" hits="1" branch="false"/>
+            <line number="7" hits="1" branch="false"/>
           </lines>
         </class>
         <class name="scheme-does-not-require-ppas.js" filename="app/scheme-does-not-require-ppas.js" line-rate="1" branch-rate="1">
@@ -184,14 +296,14 @@
           <methods>
           </methods>
           <lines>
-            <line number="1" hits="8" branch="false"/>
+            <line number="1" hits="9" branch="false"/>
           </lines>
         </class>
         <class name="scheme-names.js" filename="app/constants/scheme-names.js" line-rate="1" branch-rate="1">
           <methods>
           </methods>
           <lines>
-            <line number="1" hits="1" branch="false"/>
+            <line number="1" hits="2" branch="false"/>
           </lines>
         </class>
         <class name="schemes-not-requiring-ppas.js" filename="app/constants/schemes-not-requiring-ppas.js" line-rate="1" branch-rate="1">
@@ -226,7 +338,7 @@
           <methods>
           </methods>
           <lines>
-            <line number="1" hits="2" branch="false"/>
+            <line number="1" hits="4" branch="false"/>
           </lines>
         </class>
       </classes>