feat: option to specify a fallback resolve value

README.md

@@ -302,6 +302,14 @@ boolean;
 
 When `true` if the dependency cannot be found or resolved, it will just return `undefined` rather than throwing an error.
 
+### default
+
+```ts
+any;
+```
+
+Provide a fallback value if the dependency cannot be found.
+
 #### jpex.resolveAsync
 
 ```ts

src/resolver/__tests__/default.test.ts

@@ -0,0 +1,44 @@
+import base from '../..';
+
+const setup = () => {
+  const jpex = base.extend();
+
+  return {
+    jpex,
+  };
+};
+
+test('if factory exists, it should be resolved', () => {
+  const { jpex } = setup();
+  type Foo = string;
+  jpex.constant<Foo>('foo');
+
+  const result = jpex.resolve<Foo>({ default: 'bar' });
+
+  expect(result).toBe('foo');
+});
+
+test('if factory does not exist, it should return the default', () => {
+  const { jpex } = setup();
+  type Foo = string;
+
+  const result = jpex.resolve<Foo>({ default: 'bar' });
+
+  expect(result).toBe('bar');
+});
+
+test('if factory does not exist and default not provided, it should throw an error', () => {
+  const { jpex } = setup();
+  type Foo = string;
+
+  expect(() => jpex.resolve<Foo>()).toThrow();
+});
+
+test('if factory does not exist and default is undefined, it should return undefined', () => {
+  const { jpex } = setup();
+  type Foo = string;
+
+  const result = jpex.resolve<Foo>({ default: undefined });
+
+  expect(result).toBe(undefined);
+});

src/resolver/utils.ts

@@ -95,7 +95,7 @@ export const getFactory = (
   jpex: JpexInstance,
   name: string,
   opts: ResolveOpts = {},
-) => {
+): Factory | undefined => {
   validateName(name);
   const fns = [
     getFromResolved,
@@ -115,6 +115,15 @@ export const getFactory = (
     return;
   }
 
+  if ('default' in opts) {
+    return {
+      fn: () => opts.default,
+      lifecycle: jpex.$$config.lifecycle,
+      resolved: true,
+      value: opts.default,
+    };
+  }
+
   throw new Error(`Unable to find required dependency [${name}]`);
 };
 

src/types/JpexInstance.ts

@@ -30,6 +30,7 @@ export interface ResolveOpts {
   optional?: boolean;
   with?: NamedParameters;
   async?: boolean;
+  default?: any;
 }
 
 export interface JpexInstance {