@postxl/generators 0.2.2

package/LICENSE

@@ -0,0 +1,50 @@
+PostXL Non-Commercial License
+
+Copyright (c) 2025 PostXL GmbH
+
+NON-COMMERCIAL USE
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, and distribute the Software for non-commercial purposes only,
+subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in
+   all copies or substantial portions of the Software.
+
+2. The Software may not be used for commercial purposes without obtaining a
+   commercial license from PostXL GmbH.
+
+DEFINITION OF NON-COMMERCIAL USE
+
+"Non-commercial use" means personal, educational, research, or evaluation use
+where the primary purpose is not to generate revenue or commercial advantage.
+
+Non-commercial use includes:
+
+- Personal projects and learning
+- Academic research and education
+- Open source projects that are not commercially monetized
+- Evaluation and testing of the Software
+
+COMMERCIAL USE
+
+For commercial use of this Software, including but not limited to:
+
+- Use in products or services sold or licensed to third parties
+- Use in internal business operations that generate revenue
+- Use by for-profit organizations in production environments
+
+You must obtain a commercial license from PostXL GmbH.
+
+Contact: licensing@postxl.com
+
+DISCLAIMER
+
+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/dist/backend-actions/actions-provider.mock.d.ts

@@ -0,0 +1,7 @@
+import * as Generator from '@postxl/generator';
+/**
+ * A generator that registers a small mock action provider.
+ * Using this prevents the action generator to thrown an error
+ * that no action providers are registered.
+ */
+export declare const mockActionProviderGenerator: Generator.GeneratorInterface;

package/dist/backend-actions/actions-provider.mock.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockActionProviderGenerator = void 0;
+const Generator = __importStar(require("@postxl/generator"));
+/**
+ * A generator that registers a small mock action provider.
+ * Using this prevents the action generator to thrown an error
+ * that no action providers are registered.
+ */
+exports.mockActionProviderGenerator = {
+    id: Generator.toGeneratorInterfaceId('mockActionProviderGenerator'),
+    register: (ctx) => {
+        ctx.actions.providers.push({
+            module: {
+                name: Generator.toBackendModuleName('mockActionProviderGenerator'),
+            },
+            service: {
+                name: Generator.toClassName('MockActionProvider'),
+                location: Generator.toBackendModuleLocation('@mockActionProviderGenerator'),
+                variableName: Generator.toVariableName('mockActionProvider'),
+            },
+            scopes: new Set(),
+            actions: {
+                summary: {
+                    action: {
+                        name: Generator.toTypeName('Action_MockActionProvider'),
+                        location: Generator.toBackendModuleLocation('@mockActionProviderGenerator'),
+                    },
+                    result: {
+                        name: Generator.toTypeName('ActionResult_MockActionProvider'),
+                        location: Generator.toBackendModuleLocation('@mockActionProviderGenerator'),
+                    },
+                },
+            },
+        });
+        return ctx;
+    },
+    generate: (ctx) => {
+        return ctx;
+    },
+};
+//# sourceMappingURL=actions-provider.mock.js.map

package/dist/backend-actions/actions-provider.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-provider.mock.js","sourceRoot":"","sources":["../../src/backend-actions/actions-provider.mock.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA8C;AAI9C;;;;GAIG;AACU,QAAA,2BAA2B,GAAiC;IACvE,EAAE,EAAE,SAAS,CAAC,sBAAsB,CAAC,6BAA6B,CAAC;IACnE,QAAQ,EAAE,CAAC,GAAmC,EAAE,EAAE;QAChD,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;YACzB,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS,CAAC,mBAAmB,CAAC,6BAA6B,CAAC;aACnE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,oBAAoB,CAAC;gBACjD,QAAQ,EAAE,SAAS,CAAC,uBAAuB,CAAC,8BAA8B,CAAC;gBAC3E,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,oBAAoB,CAAC;aAC7D;YACD,MAAM,EAAE,IAAI,GAAG,EAAE;YACjB,OAAO,EAAE;gBACP,OAAO,EAAE;oBACP,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAAC;wBACvD,QAAQ,EAAE,SAAS,CAAC,uBAAuB,CAAC,8BAA8B,CAAC;qBAC5E;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,iCAAiC,CAAC;wBAC7D,QAAQ,EAAE,SAAS,CAAC,uBAAuB,CAAC,8BAA8B,CAAC;qBAC5E;iBACF;aACF;SACF,CAAC,CAAA;QACF,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;QAChB,OAAO,GAAG,CAAA;IACZ,CAAC;CACF,CAAA"}

package/dist/backend-actions/actions.generator.d.ts

@@ -0,0 +1,130 @@
+import z from 'zod';
+import * as Generator from '@postxl/generator';
+import { NestJSModule, WithBackend } from '../backend-core';
+import { WithDatabase } from '../backend-database-prisma';
+import { WithBase } from '../base';
+import { WithTypes } from '../types';
+type ContextRequirements = WithBackend<WithDatabase<WithTypes<WithBase<Generator.Context>>>>;
+export type ContextResult = WithActions<ContextRequirements>;
+export type WithActions<Context> = Generator.ExtendContext<Context, {
+    actions: ActionsContext;
+}>;
+export type ActionsContext = {
+    module: Generator.ImportableItem;
+    config: Generator.ImportableClass & {
+        /**
+         * Type describing the options to construct the config
+         */
+        options: Generator.ImportableType;
+    };
+    /**
+     * Dispatcher service
+     */
+    readonly dispatcher: Generator.ImportableClass;
+    /**
+     * Authorization service used before dispatching actions
+     */
+    readonly authorization: {
+        readonly service: Generator.ImportableClass;
+    };
+    /**
+     * The class that executes the actions
+     */
+    readonly execution: {
+        /**
+         * Interface for the action execution
+         */
+        readonly interface: Generator.ImportableType & {
+            actionOperationId: Generator.ImportableType;
+            toBrandedActionOperationId: Generator.ImportableFunction;
+        };
+        /**
+         * The class that executes the actions
+         */
+        readonly class: Generator.ImportableClass;
+        /**
+         * Internal name of the execution class.
+         */
+        _internalName: Generator.ClassName;
+        /**
+         * Name of the mutation start and finish functions
+         */
+        mutations: {
+            create: MutationFunctions;
+            createMany: MutationFunctions;
+            update: MutationFunctions;
+            updateMany: MutationFunctions;
+            delete: MutationFunctions;
+            deleteMany: MutationFunctions;
+            clone: MutationFunctions;
+        };
+        /**
+         * Name of the transformation start and finish function
+         */
+        transformation: MutationFunctions & {
+            executeSingle: Generator.FunctionName;
+            executeMultiple: Generator.FunctionName;
+        };
+        errorOperation: Generator.FunctionName;
+    };
+    /**
+     * The individual providers from other modules that provide actions.
+     * This will be populated by other backend modules during the registration
+     *
+     * This is used to generate the action types and results in actions.types.ts
+     */
+    providers: ActionProvider<any>[];
+    /**
+     * The combined action type that includes all actions provided by the providers
+     */
+    readonly summary: ActionProviderTypes & {
+        /**
+         * Helper type to extract the result based on the action type
+         */
+        readonly resultOfActionHelper: Generator.ImportableType;
+    };
+};
+type MutationFunctions = {
+    start: Generator.FunctionName;
+    finish: Generator.FunctionName;
+};
+/**
+ * Other backend modules can provide actions. These need to be registered as providers in the actions module.
+ */
+export type ActionProvider<Actions extends Record<string, ActionProviderTypes>> = {
+    module: NestJSModule;
+    service: Generator.ImportableClass & {
+        /**
+         * Name of the service variable in the dispatcher service
+         */
+        variableName: Generator.VariableName;
+    };
+    scopes: Set<ScopeName>;
+    actions: {
+        summary: ActionProviderTypes;
+    } & Actions;
+};
+declare const zScopeName: z.ZodBranded<z.ZodString, "PXL.ScopeName">;
+/**
+ * A scope name that is used to refer to the scope of actions (e.g. `Seed`, `User`, `Aggregation`)
+ */
+export type ScopeName = z.infer<typeof zScopeName>;
+export declare const toScopeName: (input: string) => string & z.BRAND<"PXL.ScopeName">;
+/**
+ * Relevant information to aggregate the action types and results
+ */
+export type ActionProviderTypes = {
+    /**
+     * Type that defines all actions provided, e.g. `Action_BusinessLogic`, `Action_Seed`, `Action_Import`
+     *
+     * This type is usually a union of all actions provided by the module.
+     */
+    readonly action: Generator.ImportableType;
+    /**
+     * Type that defines the action results of the provided actions, e.g. `ActionResult_BusinessLogic`, `ActionResult_Seed`, `ActionResult_Import`
+     */
+    readonly result: Generator.ImportableType;
+};
+export declare const generatorId: string & z.BRAND<"PXL.GeneratorInterfaceId">;
+export declare const generator: Generator.GeneratorInterface;
+export {};

package/dist/backend-actions/actions.generator.js

@@ -0,0 +1,204 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generator = exports.generatorId = exports.toScopeName = void 0;
+const node_path_1 = require("node:path");
+const zod_1 = __importDefault(require("zod"));
+const Generator = __importStar(require("@postxl/generator"));
+const Schema = __importStar(require("@postxl/schema"));
+const backend_core_1 = require("../backend-core");
+const backend_database_prisma_1 = require("../backend-database-prisma");
+const base_1 = require("../base");
+const types_1 = require("../types");
+const action_types_generator_1 = require("./generators/action-types.generator");
+const actions_config_class_generator_1 = require("./generators/actions-config-class.generator");
+const actions_module_generator_1 = require("./generators/actions-module.generator");
+const authorization_service_generator_1 = require("./generators/authorization-service.generator");
+const dispatcher_service_generator_1 = require("./generators/dispatcher-service.generator");
+const execution_class_generator_1 = require("./generators/execution-class.generator");
+const execution_interface_generator_1 = require("./generators/execution-interface.generator");
+const zScopeName = zod_1.default.string().brand('PXL.ScopeName');
+const toScopeName = (input) => zScopeName.parse(input);
+exports.toScopeName = toScopeName;
+exports.generatorId = Generator.toGeneratorInterfaceId('backend-actions');
+exports.generator = {
+    id: exports.generatorId,
+    requires: [backend_core_1.backendGeneratorId, base_1.baseGeneratorId, types_1.typesGeneratorId, backend_database_prisma_1.databaseGeneratorId],
+    register: (context) => {
+        verifyContext(context);
+        const module = {
+            name: Generator.toClassName('ActionsModule'),
+            location: Generator.toBackendModuleLocation(`@actions/actions.module`),
+        };
+        const configLocation = Generator.toBackendModuleLocation(`@actions/actions-config.class`);
+        const config = {
+            name: Generator.toClassName('ActionsConfig'),
+            location: configLocation,
+            options: {
+                name: Generator.toTypeName('ActionsModuleOptions'),
+                location: configLocation,
+            },
+        };
+        const actionsModule = {
+            name: Generator.toBackendModuleName('actions'),
+            moduleClass: module,
+            apiModuleRegistration: {
+                code: Generator.ts('ActionsModule.forRoot(config.actions)'),
+            },
+            envConfig: {
+                transformer: Generator.ts('actions: { useInMemory: !val.STATEFUL }'),
+                //Stateful is already defined as an app wide setting by the backend core generator
+                dotEnvExample: ``,
+                decoder: Generator.ts(``),
+            },
+        };
+        context.backend.modules.push(actionsModule);
+        const actions = {
+            module,
+            config,
+            dispatcher: {
+                name: Generator.toClassName('DispatcherService'),
+                location: Generator.toBackendModuleLocation(`@actions/dispatcher.service`),
+            },
+            authorization: {
+                service: {
+                    name: Generator.toClassName('AuthorizationService'),
+                    location: Generator.toBackendModuleLocation(`@actions/authorization/authorization.service`),
+                },
+            },
+            execution: {
+                interface: {
+                    name: Generator.toTypeName('IActionExecution'),
+                    location: Generator.toBackendModuleLocation(`@actions/execution/execution.interface`),
+                    actionOperationId: {
+                        name: Generator.toTypeName('ActionOperationId'),
+                        location: Generator.toBackendModuleLocation(`@actions/execution/execution.interface`),
+                    },
+                    toBrandedActionOperationId: {
+                        name: Generator.toFunctionName('toActionOperationId'),
+                        location: Generator.toBackendModuleLocation(`@actions/execution/execution.interface`),
+                    },
+                },
+                class: {
+                    name: Generator.toClassName('ActionExecutionFactory'),
+                    location: Generator.toBackendModuleLocation(`@actions/execution/execution.class`),
+                },
+                _internalName: Generator.toClassName('ActionExecution'),
+                mutations: {
+                    create: {
+                        start: Generator.toFunctionName('startCreateMutation'),
+                        finish: Generator.toFunctionName('finishCreateMutation'),
+                    },
+                    createMany: {
+                        start: Generator.toFunctionName('startCreateManyMutation'),
+                        finish: Generator.toFunctionName('finishCreateManyMutation'),
+                    },
+                    update: {
+                        start: Generator.toFunctionName('startUpdateMutation'),
+                        finish: Generator.toFunctionName('finishUpdateMutation'),
+                    },
+                    updateMany: {
+                        start: Generator.toFunctionName('startUpdateManyMutation'),
+                        finish: Generator.toFunctionName('finishUpdateManyMutation'),
+                    },
+                    delete: {
+                        start: Generator.toFunctionName('startDeleteMutation'),
+                        finish: Generator.toFunctionName('finishDeleteMutation'),
+                    },
+                    deleteMany: {
+                        start: Generator.toFunctionName('startDeleteManyMutation'),
+                        finish: Generator.toFunctionName('finishDeleteManyMutation'),
+                    },
+                    clone: {
+                        start: Generator.toFunctionName('startCloneMutation'),
+                        finish: Generator.toFunctionName('finishCloneMutation'),
+                    },
+                },
+                transformation: {
+                    executeMultiple: Generator.toFunctionName('executeTransformations'),
+                    executeSingle: Generator.toFunctionName('executeTransformation'),
+                    start: Generator.toFunctionName('startTransformation'),
+                    finish: Generator.toFunctionName('finishTransformation'),
+                },
+                errorOperation: Generator.toFunctionName('errorActionOperation'),
+            },
+            providers: [],
+            summary: {
+                action: {
+                    name: Generator.toTypeName('Action'),
+                    location: Generator.toBackendModuleLocation(`@actions/actions.types`),
+                },
+                result: {
+                    name: Generator.toTypeName('ActionResult'),
+                    location: Generator.toBackendModuleLocation(`@actions/actions.types`),
+                },
+                resultOfActionHelper: {
+                    name: Generator.toTypeName('ResultOfAction'),
+                    location: Generator.toBackendModuleLocation(`@actions/actions.types`),
+                },
+            },
+        };
+        return { ...context, actions };
+    },
+    generate: async (context) => {
+        const { actions } = context;
+        const srcVfs = new Generator.VirtualFileSystem();
+        srcVfs.write(Generator.toLocalFile(actions.dispatcher), (0, dispatcher_service_generator_1.generateDispatcher)(context));
+        srcVfs.write(Generator.toLocalFile(actions.authorization.service), (0, authorization_service_generator_1.generateAuthorizationService)(context));
+        srcVfs.write(Generator.toLocalFile(actions.execution.class), (0, execution_class_generator_1.generateActionExecutionClass)(context));
+        srcVfs.write(Generator.toLocalFile(actions.execution.interface), (0, execution_interface_generator_1.generateActionExecutionInterface)(context));
+        srcVfs.write(Generator.toLocalFile(actions.summary.action), (0, action_types_generator_1.generateActionTypes)(actions));
+        srcVfs.write(Generator.toLocalFile(actions.config), (0, actions_config_class_generator_1.generateActionsConfig)(context));
+        srcVfs.write(Generator.toLocalFile(actions.module), (0, actions_module_generator_1.generateActionsModule)(context));
+        const vfs = new Generator.VirtualFileSystem();
+        vfs.insertFromVfs({ targetPath: 'src', vfs: srcVfs });
+        vfs.write('/tsconfig.lib.json', Generator.generateTsConfig('types'));
+        await vfs.loadFolder({ diskPath: (0, node_path_1.resolve)(__dirname, './template') });
+        context.vfs.insertFromVfs({ targetPath: 'backend/libs/actions', vfs: vfs });
+        return context;
+    },
+};
+function verifyContext(context) {
+    Generator.verifyModelExists(Schema.defaultModelNames.action, context);
+    Generator.verifyModelExists(Schema.defaultModelNames.mutation, context);
+    Generator.verifyModelExists(Schema.defaultModelNames.user, context);
+    Generator.verifyEnumExists(Schema.defaultEnumNames.actionStatus, context);
+    Generator.verifyEnumExists(Schema.defaultEnumNames.mutationStatus, context);
+    Generator.verifyEnumExists(Schema.defaultEnumNames.mutationKind, context);
+}
+//# sourceMappingURL=actions.generator.js.map

package/dist/backend-actions/actions.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.generator.js","sourceRoot":"","sources":["../../src/backend-actions/actions.generator.ts"],"names":[],"mappings":"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"}

package/dist/backend-actions/generators/action-types.generator.d.ts

@@ -0,0 +1,2 @@
+import { ActionsContext } from '../actions.generator';
+export declare function generateActionTypes({ providers, summary }: ActionsContext): string;

package/dist/backend-actions/generators/action-types.generator.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateActionTypes = generateActionTypes;
+const generator_1 = require("@postxl/generator");
+function generateActionTypes({ providers, summary }) {
+    const imports = generator_1.ImportGenerator.from(summary.action.location);
+    if (providers.length === 0) {
+        throw new Error('No action providers registered. At least one action provider is required!');
+    }
+    const actionType = [];
+    const resultType = [];
+    for (const { actions } of providers) {
+        imports.addType(actions.summary.action);
+        actionType.push(actions.summary.action.name);
+        imports.addType(actions.summary.result);
+        resultType.push(actions.summary.result.name);
+    }
+    if (providers.length === 0) {
+        actionType.push(`{ scope:'NoOp', type:'NoOp', payload: undefined }`);
+        resultType.push('any');
+    }
+    return /* ts */ `
+${imports.generate()}
+
+/**
+ * A union of all action definitions.
+ */
+export type ${summary.action.name} = ${actionType.join(' | ')}
+
+/**
+ * A dictionary of all possible action results.
+ */
+export type ${summary.result.name} = ${resultType.join(' & ')}
+
+/**
+ * Extracts the result type of an action based on the inferred scope and type.
+ */
+export type ResultOfAction<Action, ResultMap = ${summary.result.name}> = Action extends { scope: infer Scope; type: infer Type }
+  ? Scope extends keyof ResultMap
+    ? Type extends keyof ResultMap[Scope]
+      ? ResultMap[Scope][Type]
+      : never
+    : never
+  : never
+`;
+}
+//# sourceMappingURL=action-types.generator.js.map

package/dist/backend-actions/generators/action-types.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types.generator.js","sourceRoot":"","sources":["../../../src/backend-actions/generators/action-types.generator.ts"],"names":[],"mappings":";;AAIA,kDA8CC;AAlDD,iDAAmD;AAInD,SAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAkB;IACxE,MAAM,OAAO,GAAG,2BAAe,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;IAC9F,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,UAAU,GAAa,EAAE,CAAA;IAE/B,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;QACpC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACvC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAE5C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACvC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,UAAU,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;QACpE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC;EAChB,OAAO,CAAC,QAAQ,EAAE;;;;;cAKN,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;;;;;cAK/C,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;;;;;iDAKZ,OAAO,CAAC,MAAM,CAAC,IAAI;;;;;;;CAOnE,CAAA;AACD,CAAC"}

package/dist/backend-actions/generators/actions-config-class.generator.d.ts

@@ -0,0 +1,2 @@
+import { ContextResult } from '../actions.generator';
+export declare function generateActionsConfig({ actions }: ContextResult): string;

package/dist/backend-actions/generators/actions-config-class.generator.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateActionsConfig = generateActionsConfig;
+function generateActionsConfig({ actions }) {
+    return /* ts */ `
+import { Injectable } from '@nestjs/common'
+
+export type ${actions.config.options.name} = {
+  /**
+   * Configures if all repositories should be in memory.
+   * This is useful for testing and development.
+   */
+  useInMemory: boolean
+}
+
+@Injectable()
+export class ${actions.config.name} {
+  public get useInMemory(): boolean {
+    return this.options.useInMemory
+  }
+
+  constructor(private readonly options: ${actions.config.options.name}) {}
+}`;
+}
+//# sourceMappingURL=actions-config-class.generator.js.map

package/dist/backend-actions/generators/actions-config-class.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-config-class.generator.js","sourceRoot":"","sources":["../../../src/backend-actions/generators/actions-config-class.generator.ts"],"names":[],"mappings":";;AAEA,sDAoBC;AApBD,SAAgB,qBAAqB,CAAC,EAAE,OAAO,EAAiB;IAC9D,OAAO,QAAQ,CAAC;;;cAGJ,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI;;;;;;;;;eAS1B,OAAO,CAAC,MAAM,CAAC,IAAI;;;;;0CAKQ,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI;EACnE,CAAA;AACF,CAAC"}

package/dist/backend-actions/generators/actions-module.generator.d.ts

@@ -0,0 +1,2 @@
+import { ContextResult } from '../actions.generator';
+export declare function generateActionsModule({ actions, database }: ContextResult): string;

package/dist/backend-actions/generators/actions-module.generator.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateActionsModule = generateActionsModule;
+const generator_1 = require("@postxl/generator");
+function generateActionsModule({ actions, database }) {
+    const imports = generator_1.ImportGenerator
+        //
+        .from(actions.module.location)
+        .add(actions.execution.class)
+        .add(actions.dispatcher)
+        .add(actions.authorization.service)
+        .add(actions.config)
+        .addType(actions.config.options)
+        .add(database.module.moduleClass); // NOSONAR
+    const moduleImports = [];
+    for (const { module: { moduleClass }, } of actions.providers) {
+        if (!moduleClass) {
+            continue;
+        }
+        imports.add(moduleClass);
+        moduleImports.push(`forwardRef(() => ${moduleClass.name})`);
+    }
+    return /* ts */ `
+import { DynamicModule, forwardRef, Provider } from '@nestjs/common'
+
+${imports.generate()}
+
+export class ${actions.module.name} {
+  public static forRoot(options: ${actions.config.options.name}): DynamicModule {
+    const configProvider: Provider = {
+      provide: ${actions.config.name},
+      useValue: new ${actions.config.name}(options)
+    }
+    return {
+      module: ${actions.module.name},
+      imports: [
+        ${database.module.moduleClass.name},
+        ${moduleImports.join(',\n')}
+      ],
+      providers: [${actions.dispatcher.name}, ${actions.execution.class.name}, ${actions.authorization.service.name}, configProvider],
+      exports: [${actions.dispatcher.name}, ${actions.execution.class.name}, ${actions.authorization.service.name}],
+      global: true
+    }
+  }
+}`;
+}
+//# sourceMappingURL=actions-module.generator.js.map

package/dist/backend-actions/generators/actions-module.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-module.generator.js","sourceRoot":"","sources":["../../../src/backend-actions/generators/actions-module.generator.ts"],"names":[],"mappings":";;AAIA,sDA6CC;AAjDD,iDAAmD;AAInD,SAAgB,qBAAqB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAiB;IACxE,MAAM,OAAO,GAAG,2BAAe;QAC7B,EAAE;SACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC7B,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;SACvB,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC;SAClC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;SACnB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;SAC/B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAY,CAAC,CAAA,CAAC,UAAU;IAE/C,MAAM,aAAa,GAAa,EAAE,CAAA;IAClC,KAAK,MAAM,EACT,MAAM,EAAE,EAAE,WAAW,EAAE,GACxB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxB,aAAa,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,IAAI,GAAG,CAAC,CAAA;IAC7D,CAAC;IAED,OAAO,QAAQ,CAAC;;;EAGhB,OAAO,CAAC,QAAQ,EAAE;;eAEL,OAAO,CAAC,MAAM,CAAC,IAAI;mCACC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI;;iBAE7C,OAAO,CAAC,MAAM,CAAC,IAAI;sBACd,OAAO,CAAC,MAAM,CAAC,IAAI;;;gBAGzB,OAAO,CAAC,MAAM,CAAC,IAAI;;UAEzB,QAAQ,CAAC,MAAM,CAAC,WAAY,CAAC,IAAI;UACjC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;;oBAEf,OAAO,CAAC,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI;kBACjG,OAAO,CAAC,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI;;;;EAI/G,CAAA;AACF,CAAC"}

package/dist/backend-actions/generators/authorization-service.generator.d.ts

@@ -0,0 +1,2 @@
+import { ContextResult } from '../actions.generator';
+export declare function generateAuthorizationService({ actions, database, types }: ContextResult): string;