feat: create shortname aliases for factories

src/controllers/controllers.ts

@@ -46,3 +46,5 @@ export function createController<
     },
   };
 }
+
+export const controller = createController;

src/factory-aliases.test.ts

@@ -0,0 +1,83 @@
+import { describe, test, TestContext } from "node:test";
+import {
+  adapter,
+  controller,
+  createApp,
+  hooks,
+  installer,
+  mod,
+  provider,
+} from "./index";
+
+describe("factory aliases", () => {
+  test("compose modules using shorthand helpers", async (t: TestContext) => {
+    const users = provider({
+      name: "alias-users",
+      expose: async () => ({
+        find: () => "Jean",
+      }),
+    });
+
+    const versionAdapter = adapter({
+      name: "alias-version",
+      expose: async ({ fastify }) => fastify.version,
+    });
+
+    const httpHooks = hooks({
+      type: "http",
+      deps: { users },
+      adaps: { version: versionAdapter },
+      build: async ({ builder, deps, adaps }) => {
+        builder.addHook("onRequest", async (_req, reply) => {
+          reply.header(
+            "x-alias-hooks",
+            `${deps.users.find()}@${adaps.version}`,
+          );
+        });
+      },
+    });
+
+    const decorators = installer({
+      deps: { users },
+      install: async ({ fastify, deps }) => {
+        fastify.decorate("aliasLookup", () => deps.users.find());
+      },
+    });
+
+    const aliasController = controller({
+      deps: { users },
+      build: ({ builder, deps }) => {
+        builder.addRoute({
+          url: "/",
+          method: "GET",
+          handler: async (req) => {
+            const lookup = req.server.getDecorator<() => string>("aliasLookup");
+            return {
+              viaController: deps.users.find(),
+              viaInstaller: lookup(),
+            };
+          },
+        });
+      },
+    });
+
+    const root = mod({
+      name: "alias-root",
+      hooks: [httpHooks],
+      installers: [decorators],
+      controllers: [aliasController],
+    });
+
+    const app = await createApp({ root });
+    const res = await app.inject({ method: "GET", url: "/" });
+    const json = res.json();
+
+    t.assert.deepStrictEqual(json, {
+      viaController: "Jean",
+      viaInstaller: "Jean",
+    });
+    t.assert.strictEqual(res.headers["x-alias-hooks"], `Jean@${app.version}`);
+
+    await app.close();
+  });
+});

src/fastify/adapters.ts

@@ -42,3 +42,5 @@ export async function resolveAdapterMap<AMap extends AdapterMap>(
 
   return out as AdapterValues<AMap>;
 }
+
+export const adapter = createAdapter;

src/fastify/installers.ts

@@ -28,3 +28,5 @@ export function createInstaller<Providers extends ProvidersMap>(
     },
   };
 }
+
+export const installer = createInstaller;

src/hooks/hooks.ts

@@ -72,3 +72,5 @@ export function createHooks<
     },
   };
 }
+
+export const hooks = createHooks;

src/modules/module.ts

@@ -97,3 +97,5 @@ export async function resolveProviderMap(
 
   return out;
 }
+
+export const mod = createModule;

src/providers/providers.ts

@@ -68,6 +68,8 @@ export function createProvider<
   return self;
 }
 
+export const provider = createProvider;
+
 export async function resolveDeps(
   container: Container,
   prov: ProviderAny,