@vida-global/core 2.0.0 → 2.0.1

package/lib/server/serverController.js

@@ -574,6 +574,13 @@ class VidaServerController {
     }
 
 
+    coerceString(value, { fallback = '' } = {}) {
+        if (typeof value !== 'string') return fallback;
+        const trimmed = value.trim();
+        return trimmed || fallback;
+    }
+
+
     coerceBoolean(value, { fallback } = {}) {
         if (typeof value === 'boolean') return value;
         if (typeof value !== 'string')  return fallback;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vida-global/core",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Core libraries for supporting Vida development",
     "author": "",
     "license": "ISC",

package/test/server/serverController.test.js

@@ -156,6 +156,52 @@ describe('VidaServerController', () => {
     });
 
 
+    describe('#coerceString', () => {
+        const controller = new FooController({}, {});
+
+        it ('returns the string when passed a non-empty string', () => {
+            const value = TestHelpers.Faker.Text.randomString();
+            expect(controller.coerceString(value)).toBe(value);
+        });
+
+        it ('trims surrounding whitespace', () => {
+            const value = TestHelpers.Faker.Text.randomString();
+            expect(controller.coerceString(`  ${value}  `)).toBe(value);
+        });
+
+        it ('returns the fallback for an empty string', () => {
+            const fallback = TestHelpers.Faker.Text.randomString();
+            expect(controller.coerceString('', {fallback})).toBe(fallback);
+        });
+
+        it ('returns the fallback for a whitespace-only string', () => {
+            const fallback = TestHelpers.Faker.Text.randomString();
+            expect(controller.coerceString('   ', {fallback})).toBe(fallback);
+        });
+
+        it.each([
+            [null],
+            [undefined],
+            [123],
+            [true],
+            [false],
+            [{}],
+            [[]],
+        ])('returns the fallback for non-string input (%p)', (input) => {
+            const fallback = TestHelpers.Faker.Text.randomString();
+            expect(controller.coerceString(input, {fallback})).toBe(fallback);
+        });
+
+        it ('defaults the fallback to an empty string when no options are given', () => {
+            expect(controller.coerceString(null)).toBe('');
+        });
+
+        it ('defaults the fallback to an empty string for empty input when no options are given', () => {
+            expect(controller.coerceString('   ')).toBe('');
+        });
+    });
+
+
     describe('#coerceBoolean', () => {
         const controller = new FooController({}, {});