opinionated-machine 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Igor Savin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+# opinionated-machine
+Very opinionated DI framework for fastify, built on top of awilix
+
+## Basic usage
+
+Define a module, or several modules, that will be used for resolving dependency graphs, using awilix:
+
+```ts
+import { AbstractModule, asSingletonClass, asMessageQueueHandlerClass, asJobWorkerClass, asJobQueueClass, asControllerClass } from 'opinionated-machine'
+
+export type ModuleDependencies = {
+    service: Service
+    messageQueueConsumer: MessageQueueConsumer
+    jobWorker: JobWorker
+    queueManager: QueueManager
+}
+
+export class MyModule extends AbstractModule<ModuleDependencies, ExternalDependencies> {
+    resolveDependencies(
+        diOptions: DependencyInjectionOptions,
+        _externalDependencies: ExternalDependencies,
+    ): MandatoryNameAndRegistrationPair<ModuleDependencies> {
+        return {
+            service: asSingletonClass(Service),
+
+            // by default init and disposal methods from `message-queue-toolkit` consumers
+            // will be assumed. If different values are necessary, pass second config object
+            // and specify "asyncInit" and "asyncDispose" fields
+            messageQueueConsumer: asMessageQueueHandlerClass(MessageQueueConsumer, {
+                queueName: MessageQueueConsumer.QUEUE_ID,
+                diOptions,
+            }),
+
+            // by default init and disposal methods from `background-jobs-commons` job workers
+            // will be assumed. If different values are necessary, pass second config object
+            // and specify "asyncInit" and "asyncDispose" fields
+            jobWorker: asJobWorkerClass(JobWorker, {
+                queueName: JobWorker.QUEUE_ID,
+                diOptions,
+            }),
+
+            // by default disposal methods from `background-jobs-commons` job queue manager
+            // will be assumed. If different values are necessary, specify "asyncDispose" fields 
+            // in the second config object
+            queueManager: asJobQueueClass(
+                QueueManager,
+                {
+                    diOptions,
+                },
+                {
+                    asyncInit: (manager) => manager.start(resolveJobQueuesEnabled(options)),
+                },
+            ),
+        }
+    }
+
+    // controllers will be automatically registered on fastify app
+    resolveControllers() {
+        return {
+            controller: asControllerClass(MyController),
+        }
+    }
+}
+```
+
+## Defining controllers
+
+Controllers require using fastify-api-contracts and allow to define application routes.
+
+```ts
+import { buildFastifyNoPayloadRoute } from '@lokalise/fastify-api-contracts'
+import { buildDeleteRoute } from '@lokalise/universal-ts-utils/api-contracts/apiContracts'
+import { z } from 'zod'
+import { AbstractController } from 'opinionated-machine'
+
+const BODY_SCHEMA = z.object({})
+const PATH_PARAMS_SCHEMA = z.object({
+  userId: z.string(),
+})
+
+const contract = buildDeleteRoute({
+  successResponseBodySchema: BODY_SCHEMA,
+  requestPathParamsSchema: PATH_PARAMS_SCHEMA,
+  pathResolver: (pathParams) => `/users/${pathParams.userId}`,
+})
+
+export class MyController extends AbstractController<typeof MyController.contracts> {
+  public static contracts = { deleteItem: contract } as const
+
+  public buildRoutes() {
+    return {
+      deleteItem: buildFastifyNoPayloadRoute(
+          MyController.contracts.deleteItem,
+        async (req, reply) => {
+          req.log.info(req.params.userId)
+          await reply.status(204).send()
+        },
+      ),
+    }
+  }
+}
+```
+
+## Putting it all together
+
+Typical usage with a fastify app looks like this:
+
+```ts
+import { serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod'
+import { createContainer } from 'awilix'
+import { fastify } from 'fastify'
+import { DIContext } from 'opinionated-machine'
+
+const module = new MyModule()
+const container = createContainer({
+    injectionMode: 'PROXY',
+})
+
+const context = new DIContext<ModuleDependencies>(container, {
+    messageQueueConsumersEnabled: [MessageQueueConsumer.QUEUE_ID],
+    jobQueuesEnabled: false,
+    jobWorkersEnabled: false,
+    periodicJobsEnabled: false,
+})
+
+context.registerDependencies({
+    modules: [module],
+    {} // dependency overrides if necessary, usually for testing purposes
+})
+
+const app = fastify()
+app.setValidatorCompiler(validatorCompiler)
+app.setSerializerCompiler(serializerCompiler)
+
+app.after(() => {
+    context.registerRoutes(app)
+})
+await app.ready()
+```

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DIContext, type DependencyInjectionOptions, type registerDependenciesParams, } from './lib/DIContext.js';
+export { AbstractModule } from './lib/AbstractModule.js';
+export { ENABLE_ALL, resolveJobQueuesEnabled, isJobQueueEnabled, isMessageQueueConsumerEnabled, isJobWorkersEnabled, } from './lib/diConfigUtils.js';
+export { AbstractController } from './lib/AbstractController.js';
+export { asJobQueueClass, asJobWorkerClass, asMessageQueueHandlerClass, asControllerClass, asSingletonClass, } from './lib/resolverFunctions.js';
+export type { JobQueueModuleOptions, MessageQueueConsumerModuleOptions, JobWorkerModuleOptions, } from './lib/resolverFunctions.js';
+export type { InferRequestFromContract } from './lib/typeUtils.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+export { DIContext, } from './lib/DIContext.js';
+export { AbstractModule } from './lib/AbstractModule.js';
+export { ENABLE_ALL, resolveJobQueuesEnabled, isJobQueueEnabled, isMessageQueueConsumerEnabled, isJobWorkersEnabled, } from './lib/diConfigUtils.js';
+export { AbstractController } from './lib/AbstractController.js';
+export { asJobQueueClass, asJobWorkerClass, asMessageQueueHandlerClass, asControllerClass, asSingletonClass, } from './lib/resolverFunctions.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GAGV,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EACL,UAAU,EACV,uBAAuB,EACvB,iBAAiB,EACjB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,4BAA4B,CAAA"}

package/dist/lib/AbstractController.d.ts

@@ -0,0 +1,5 @@
+import type { RouteType } from '@lokalise/fastify-api-contracts';
+import type { DeleteRouteDefinition, GetRouteDefinition, PayloadRouteDefinition } from '@lokalise/universal-ts-utils/api-contracts/apiContracts';
+export declare abstract class AbstractController<APIContracts extends Record<string, DeleteRouteDefinition<any, any, any> | GetRouteDefinition<any, any, any> | PayloadRouteDefinition<any, any, any>>> {
+    abstract buildRoutes(): Record<keyof APIContracts, RouteType>;
+}

package/dist/lib/AbstractController.js

@@ -0,0 +1,3 @@
+export class AbstractController {
+}
+//# sourceMappingURL=AbstractController.js.map

package/dist/lib/AbstractController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractController.js","sourceRoot":"","sources":["../../lib/AbstractController.ts"],"names":[],"mappings":"AAOA,MAAM,OAAgB,kBAAkB;CAYvC"}

package/dist/lib/AbstractModule.d.ts

@@ -0,0 +1,9 @@
+import type { Resolver } from 'awilix';
+import type { DependencyInjectionOptions } from './DIContext.js';
+export type MandatoryNameAndRegistrationPair<T> = {
+    [U in keyof T]: Resolver<T[U]>;
+};
+export declare abstract class AbstractModule<ModuleDependencies, ExternalDependencies = never> {
+    abstract resolveDependencies(diOptions?: DependencyInjectionOptions, externalDependencies?: ExternalDependencies): MandatoryNameAndRegistrationPair<ModuleDependencies>;
+    abstract resolveControllers(): MandatoryNameAndRegistrationPair<unknown>;
+}

package/dist/lib/AbstractModule.js

@@ -0,0 +1,3 @@
+export class AbstractModule {
+}
+//# sourceMappingURL=AbstractModule.js.map

package/dist/lib/AbstractModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractModule.js","sourceRoot":"","sources":["../../lib/AbstractModule.ts"],"names":[],"mappings":"AAOA,MAAM,OAAgB,cAAc;CAOnC"}

package/dist/lib/DIContext.d.ts

@@ -0,0 +1,26 @@
+import type { AwilixContainer, NameAndRegistrationPair } from 'awilix';
+import { AwilixManager } from 'awilix-manager';
+import type { FastifyInstance } from 'fastify';
+import type { AbstractModule } from './AbstractModule.js';
+import type { ENABLE_ALL } from './diConfigUtils.js';
+export type registerDependenciesParams<Dependencies, ExternalDependencies> = {
+    modules: readonly AbstractModule<unknown, ExternalDependencies>[];
+    dependencyOverrides?: NameAndRegistrationPair<Dependencies>;
+};
+export type DependencyInjectionOptions = {
+    jobQueuesEnabled?: false | typeof ENABLE_ALL | string[];
+    jobWorkersEnabled?: false | typeof ENABLE_ALL | string[];
+    messageQueueConsumersEnabled?: false | typeof ENABLE_ALL | string[];
+    periodicJobsEnabled?: false | typeof ENABLE_ALL;
+};
+export declare class DIContext<Dependencies extends object, ExternalDependencies = never> {
+    private readonly options;
+    readonly awilixManager: AwilixManager;
+    readonly diContainer: AwilixContainer<Dependencies>;
+    private readonly controllerResolvers;
+    constructor(diContainer: AwilixContainer, options: DependencyInjectionOptions);
+    registerDependencies(params: registerDependenciesParams<Dependencies, ExternalDependencies>, externalDependencies?: ExternalDependencies): void;
+    registerRoutes(app: FastifyInstance): void;
+    destroy(): Promise<void>;
+    init(): Promise<void>;
+}

package/dist/lib/DIContext.js

@@ -0,0 +1,62 @@
+import { AwilixManager } from 'awilix-manager';
+export class DIContext {
+    options;
+    awilixManager;
+    diContainer;
+    // biome-ignore lint/suspicious/noExplicitAny: all controllers are controllers
+    controllerResolvers;
+    constructor(diContainer, options) {
+        this.options = options;
+        this.diContainer = diContainer;
+        this.awilixManager = new AwilixManager({
+            asyncDispose: true,
+            asyncInit: true,
+            diContainer,
+            eagerInject: true,
+            strictBooleanEnforced: true,
+        });
+        this.controllerResolvers = [];
+    }
+    registerDependencies(params, externalDependencies) {
+        const _dependencyOverrides = params.dependencyOverrides ?? {};
+        const diConfig = {};
+        for (const module of params.modules) {
+            const resolvedDIConfig = module.resolveDependencies(this.options, externalDependencies);
+            for (const key in resolvedDIConfig) {
+                // @ts-expect-error we can't really ensure type-safety here
+                diConfig[key] = resolvedDIConfig[key];
+            }
+            this.controllerResolvers.push(...Object.values(module.resolveControllers()));
+        }
+        this.diContainer.register(diConfig);
+        for (const [dependencyKey, _dependencyValue] of Object.entries(_dependencyOverrides)) {
+            const dependencyValue = { ..._dependencyValue };
+            // preserve lifetime from original resolver
+            const originalResolver = this.diContainer.getRegistration(dependencyKey);
+            // @ts-ignore
+            if (dependencyValue.lifetime !== originalResolver.lifetime) {
+                // @ts-ignore
+                dependencyValue.lifetime = originalResolver.lifetime;
+            }
+            this.diContainer.register(dependencyKey, dependencyValue);
+        }
+    }
+    registerRoutes(app) {
+        for (const controllerResolver of this.controllerResolvers) {
+            // biome-ignore lint/suspicious/noExplicitAny: any controller works here
+            const controller = controllerResolver.resolve(this.diContainer);
+            const routes = controller.buildRoutes();
+            for (const route of Object.values(routes)) {
+                app.route(route);
+            }
+        }
+    }
+    async destroy() {
+        await this.awilixManager.executeDispose();
+        await this.diContainer.dispose();
+    }
+    async init() {
+        await this.awilixManager.executeInit();
+    }
+}
+//# sourceMappingURL=DIContext.js.map

package/dist/lib/DIContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DIContext.js","sourceRoot":"","sources":["../../lib/DIContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAkB9C,MAAM,OAAO,SAAS;IACH,OAAO,CAA4B;IACpC,aAAa,CAAe;IAC5B,WAAW,CAA+B;IAC1D,8EAA8E;IAC7D,mBAAmB,CAAiB;IAErD,YAAY,WAA4B,EAAE,OAAmC;QAC3E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC;YACrC,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,IAAI;YACf,WAAW;YACX,WAAW,EAAE,IAAI;YACjB,qBAAqB,EAAE,IAAI;SAC5B,CAAC,CAAA;QACF,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAA;IAC/B,CAAC;IAED,oBAAoB,CAClB,MAAsE,EACtE,oBAA2C;QAE3C,MAAM,oBAAoB,GAAG,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAA;QAC7D,MAAM,QAAQ,GAA0C,EAAE,CAAA;QAE1D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAA;YAEvF,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;gBACnC,2DAA2D;gBAC3D,QAAQ,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;YACvC,CAAC;YAED,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAC3B,GAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAyB,CACvE,CAAA;QACH,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAEnC,KAAK,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACrF,MAAM,eAAe,GAAG,EAAE,GAAI,gBAAsC,EAAE,CAAA;YAEtE,2CAA2C;YAC3C,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;YACxE,aAAa;YACb,IAAI,eAAe,CAAC,QAAQ,KAAK,gBAAgB,CAAC,QAAQ,EAAE,CAAC;gBAC3D,aAAa;gBACb,eAAe,CAAC,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAA;YACtD,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IAED,cAAc,CAAC,GAAoB;QACjC,KAAK,MAAM,kBAAkB,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1D,wEAAwE;YACxE,MAAM,UAAU,GAA4B,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACxF,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;YACvC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,CAAA;QACzC,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAA;IACxC,CAAC;CACF"}

package/dist/lib/diConfigUtils.d.ts

@@ -0,0 +1,6 @@
+import type { DependencyInjectionOptions } from './DIContext.js';
+export declare const ENABLE_ALL: unique symbol;
+export declare const resolveJobQueuesEnabled: (options: DependencyInjectionOptions) => boolean | string[];
+export declare const isJobWorkersEnabled: (enabled?: false | typeof ENABLE_ALL | string[], name?: string) => boolean;
+export declare const isJobQueueEnabled: (enabled?: false | typeof ENABLE_ALL | string[], name?: string) => boolean;
+export declare const isMessageQueueConsumerEnabled: (messageQueueConsumersEnabled?: false | typeof ENABLE_ALL | string[], name?: string) => boolean;

package/dist/lib/diConfigUtils.js

@@ -0,0 +1,41 @@
+export const ENABLE_ALL = Symbol.for('ENABLE_ALL');
+export const resolveJobQueuesEnabled = (options) => {
+    const { jobQueuesEnabled } = options;
+    if (!jobQueuesEnabled) {
+        return false;
+    }
+    if (jobQueuesEnabled === ENABLE_ALL) {
+        return true;
+    }
+    if (Array.isArray(jobQueuesEnabled)) {
+        return jobQueuesEnabled.length ? jobQueuesEnabled : false;
+    }
+    return false;
+};
+export const isJobWorkersEnabled = (enabled, name) => isEnabled(enabled, name);
+export const isJobQueueEnabled = (enabled, name) => {
+    if (!enabled) {
+        return false;
+    }
+    if (Array.isArray(enabled) && (!name || enabled.includes(name))) {
+        return true;
+    }
+    if (enabled === ENABLE_ALL) {
+        return true;
+    }
+    return false;
+};
+export const isMessageQueueConsumerEnabled = (messageQueueConsumersEnabled, name) => isEnabled(messageQueueConsumersEnabled, name);
+const isEnabled = (option, name) => {
+    if (!option) {
+        return false;
+    }
+    if (name && Array.isArray(option)) {
+        return option.includes(name);
+    }
+    if (option === ENABLE_ALL) {
+        return true;
+    }
+    return false;
+};
+//# sourceMappingURL=diConfigUtils.js.map

package/dist/lib/diConfigUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diConfigUtils.js","sourceRoot":"","sources":["../../lib/diConfigUtils.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;AAElD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,OAAmC,EACf,EAAE;IACtB,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAA;IACpC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAA;IAC3D,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAA8C,EAC9C,IAAa,EACJ,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AAEtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAA8C,EAC9C,IAAa,EACJ,EAAE;IACX,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,4BAAmE,EACnE,IAAa,EACJ,EAAE,CAAC,SAAS,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAA;AAE3D,MAAM,SAAS,GAAG,CAChB,MAAwD,EACxD,IAAa,EACJ,EAAE;IACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/lib/resolverFunctions.d.ts

@@ -0,0 +1,19 @@
+import type { BuildResolver, BuildResolverOptions, Constructor, DisposableResolver } from 'awilix';
+import type { DependencyInjectionOptions } from './DIContext.js';
+export declare function asSingletonClass<T = object>(Type: Constructor<T>, opts?: BuildResolverOptions<T>): BuildResolver<T> & DisposableResolver<T>;
+export declare function asControllerClass<T = object>(Type: Constructor<T>, opts?: BuildResolverOptions<T>): BuildResolver<T> & DisposableResolver<T>;
+export type MessageQueueConsumerModuleOptions = {
+    queueName: string;
+    diOptions: DependencyInjectionOptions;
+};
+export declare function asMessageQueueHandlerClass<T = object>(Type: Constructor<T>, mqOptions: MessageQueueConsumerModuleOptions, opts?: BuildResolverOptions<T>): BuildResolver<T> & DisposableResolver<T>;
+export type JobWorkerModuleOptions = {
+    queueName: string;
+    diOptions: DependencyInjectionOptions;
+};
+export declare function asJobWorkerClass<T = object>(Type: Constructor<T>, workerOptions: JobWorkerModuleOptions, opts?: BuildResolverOptions<T>): BuildResolver<T> & DisposableResolver<T>;
+export type JobQueueModuleOptions = {
+    queueName?: string;
+    diOptions: DependencyInjectionOptions;
+};
+export declare function asJobQueueClass<T = object>(Type: Constructor<T>, queueOptions: JobQueueModuleOptions, opts?: BuildResolverOptions<T>): BuildResolver<T> & DisposableResolver<T>;

package/dist/lib/resolverFunctions.js

@@ -0,0 +1,48 @@
+import { asClass } from 'awilix';
+import { isJobQueueEnabled, isJobWorkersEnabled, isMessageQueueConsumerEnabled, } from './diConfigUtils.js';
+export function asSingletonClass(Type, opts) {
+    return asClass(Type, {
+        ...opts,
+        lifetime: 'SINGLETON',
+    });
+}
+export function asControllerClass(Type, opts) {
+    return asClass(Type, {
+        ...opts,
+        lifetime: 'SINGLETON',
+    });
+}
+export function asMessageQueueHandlerClass(Type, mqOptions, opts) {
+    return asClass(Type, {
+        // these follow message-queue-toolkit conventions
+        asyncInit: 'start',
+        asyncDispose: 'close',
+        asyncDisposePriority: 10,
+        enabled: isMessageQueueConsumerEnabled(mqOptions.diOptions.messageQueueConsumersEnabled, mqOptions.queueName),
+        lifetime: 'SINGLETON',
+        ...opts,
+    });
+}
+export function asJobWorkerClass(Type, workerOptions, opts) {
+    return asClass(Type, {
+        // these follow background-jobs-common conventions
+        asyncInit: 'start',
+        asyncDispose: 'dispose',
+        asyncDisposePriority: 10,
+        enabled: isJobWorkersEnabled(workerOptions.diOptions.jobWorkersEnabled, workerOptions.queueName),
+        lifetime: 'SINGLETON',
+        ...opts,
+    });
+}
+export function asJobQueueClass(Type, queueOptions, opts) {
+    return asClass(Type, {
+        // these follow background-jobs-common conventions
+        asyncInit: 'start',
+        asyncDispose: 'dispose',
+        asyncDisposePriority: 20,
+        enabled: isJobQueueEnabled(queueOptions.diOptions.jobQueuesEnabled, queueOptions.queueName),
+        lifetime: 'SINGLETON',
+        ...opts,
+    });
+}
+//# sourceMappingURL=resolverFunctions.js.map

package/dist/lib/resolverFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolverFunctions.js","sourceRoot":"","sources":["../../lib/resolverFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAGhC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAA;AAE3B,MAAM,UAAU,gBAAgB,CAC9B,IAAoB,EACpB,IAA8B;IAE9B,OAAO,OAAO,CAAC,IAAI,EAAE;QACnB,GAAG,IAAI;QACP,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAoB,EACpB,IAA8B;IAE9B,OAAO,OAAO,CAAC,IAAI,EAAE;QACnB,GAAG,IAAI;QACP,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAA;AACJ,CAAC;AAOD,MAAM,UAAU,0BAA0B,CACxC,IAAoB,EACpB,SAA4C,EAC5C,IAA8B;IAE9B,OAAO,OAAO,CAAC,IAAI,EAAE;QACnB,iDAAiD;QACjD,SAAS,EAAE,OAAO;QAClB,YAAY,EAAE,OAAO;QACrB,oBAAoB,EAAE,EAAE;QAExB,OAAO,EAAE,6BAA6B,CACpC,SAAS,CAAC,SAAS,CAAC,4BAA4B,EAChD,SAAS,CAAC,SAAS,CACpB;QACD,QAAQ,EAAE,WAAW;QACrB,GAAG,IAAI;KACR,CAAC,CAAA;AACJ,CAAC;AAOD,MAAM,UAAU,gBAAgB,CAC9B,IAAoB,EACpB,aAAqC,EACrC,IAA8B;IAE9B,OAAO,OAAO,CAAC,IAAI,EAAE;QACnB,kDAAkD;QAClD,SAAS,EAAE,OAAO;QAClB,YAAY,EAAE,SAAS;QACvB,oBAAoB,EAAE,EAAE;QAExB,OAAO,EAAE,mBAAmB,CAC1B,aAAa,CAAC,SAAS,CAAC,iBAAiB,EACzC,aAAa,CAAC,SAAS,CACxB;QACD,QAAQ,EAAE,WAAW;QACrB,GAAG,IAAI;KACR,CAAC,CAAA;AACJ,CAAC;AAOD,MAAM,UAAU,eAAe,CAC7B,IAAoB,EACpB,YAAmC,EACnC,IAA8B;IAE9B,OAAO,OAAO,CAAC,IAAI,EAAE;QACnB,kDAAkD;QAClD,SAAS,EAAE,OAAO;QAClB,YAAY,EAAE,SAAS;QACvB,oBAAoB,EAAE,EAAE;QAExB,OAAO,EAAE,iBAAiB,CAAC,YAAY,CAAC,SAAS,CAAC,gBAAgB,EAAE,YAAY,CAAC,SAAS,CAAC;QAC3F,QAAQ,EAAE,WAAW;QACrB,GAAG,IAAI;KACR,CAAC,CAAA;AACJ,CAAC"}

package/dist/lib/typeUtils.d.ts

@@ -0,0 +1,19 @@
+import type { FastifyRequest } from 'fastify';
+import type { z } from 'zod';
+type InferredOptionalSchema<Schema> = Schema extends z.Schema ? z.infer<Schema> : never;
+/**
+ * Infer fastify request type from a contract
+ */
+export type InferRequestFromContract<Contract extends {
+    requestHeaderSchema?: z.Schema;
+    requestPathParamsSchema?: z.Schema;
+    requestQuerySchema?: z.Schema;
+    successResponseBodySchema: z.Schema;
+}> = FastifyRequest<{
+    Body: never;
+    Headers: InferredOptionalSchema<Contract['requestHeaderSchema']>;
+    Params: InferredOptionalSchema<Contract['requestPathParamsSchema']>;
+    Querystring: InferredOptionalSchema<Contract['requestQuerySchema']>;
+    Reply: InferredOptionalSchema<Contract['successResponseBodySchema']>;
+}>;
+export {};

package/dist/lib/typeUtils.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typeUtils.js.map

package/dist/lib/typeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeUtils.js","sourceRoot":"","sources":["../../lib/typeUtils.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "opinionated-machine",
+    "version": "1.0.0",
+    "description": "Very opinionated DI framework for fastify, built on top of awilix ",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "maintainers": [
+        {
+            "name": "Igor Savin",
+            "email": "kibertoad@gmail.com"
+        }
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json",
+        "lint": "biome check . && tsc",
+        "lint:fix": "biome check --write .",
+        "test": "vitest --coverage",
+        "prepublishOnly": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/kibertoad/opinionated-machine.git"
+    },
+    "peerDependencies": {
+        "@lokalise/fastify-api-contracts": ">=1.4.4",
+        "@lokalise/universal-ts-utils": ">=4.2.0",
+        "awilix": ">=12.0.0",
+        "awilix-manager": ">=6.0.0",
+        "fastify": ">=5.0.0",
+        "fastify-type-provider-zod": ">=4.0.2",
+        "zod": ">=3.24.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.13.13",
+        "@biomejs/biome": "1.9.4",
+        "@lokalise/biome-config": "^1.6.1",
+        "@lokalise/fastify-api-contracts": "^1.4.4",
+        "@lokalise/tsconfig": "^1.1.0",
+        "@lokalise/universal-ts-utils": "^4.2.3",
+        "@vitest/coverage-v8": "^3.0.9",
+        "awilix": "^12.0.5",
+        "awilix-manager": "^6.1.0",
+        "fastify": "^5.2.2",
+        "fastify-type-provider-zod": "^4.0.2",
+        "vitest": "^3.0.9",
+        "typescript": "^5.8.2",
+        "zod": "^3.24.2"
+    },
+    "private": false,
+    "publishConfig": {
+        "access": "public"
+    },
+    "keywords": ["dependency", "injection", "opinionated", "awilix", "di"],
+    "homepage": "https://github.com/kibertoad/opinionated-machine",
+    "files": ["README.md", "LICENSE", "dist/*"]
+}