@apso/cli 0.0.45 → 0.1.4

package/README.md

@@ -47,6 +47,8 @@ Then navigate to the newly created service and update the apsorc file according
 
 Sample of apsorc files for both v1 and v2 are given in apso-cli code at "test/apsorc-json" so you can check it out in order to make sure that your apsorc file follows the right pattern.
 
+For detailed examples of configuring complex relationships, especially ManyToMany and self-referencing patterns, see the [Relationship Configuration Use Cases](./UseCases.md).
+
 You can also provide the key "apiType" in the apsorc file e.g (Rest, Graphql) incase you want to generate the GraphQL backend by default it would be REST.
 
 Install the npm modules before continuing further.

package/dist/commands/server/scaffold.d.ts

@@ -8,7 +8,7 @@ export default class Scaffold extends BaseCommand {
     };
     static args: {};
     scaffoldServer(dir: string, entity: Entity, relationshipMap: RelationshipMap, apiType: string): Promise<void>;
-    setupRestFiles(dir: string, entity: Entity, relationshipMap: RelationshipMap): Promise<void>;
+    setupRestFiles(dir: string, entity: Entity, relationshipMap: RelationshipMap, apiType: string): Promise<void>;
     setupGraphqlFiles(dir: string, entity: Entity, relationshipMap: RelationshipMap): Promise<void>;
     run(): Promise<void>;
 }

package/dist/commands/server/scaffold.js

@@ -18,18 +18,17 @@ class Scaffold extends base_command_1.default {
                 await this.setupGraphqlFiles(dir, entity, relationshipMap);
                 break;
             case apsorc_parser_1.ApiType.Rest:
-                await this.setupRestFiles(dir, entity, relationshipMap);
+                await this.setupRestFiles(dir, entity, relationshipMap, apiType);
                 break;
             default:
                 break;
         }
-        await (0, lib_1.createModule)(filePath, entityName, apiType);
+        await (0, lib_1.createModule)(filePath, entity, { apiType });
     }
-    async setupRestFiles(dir, entity, relationshipMap) {
+    async setupRestFiles(dir, entity, relationshipMap, apiType) {
         const filePath = path.join(dir, entity.name);
-        const entityRelationships = relationshipMap[entity.name] || [];
-        await (0, lib_1.createDto)(filePath, entity, entityRelationships);
-        await (0, lib_1.createService)(filePath, entity.name);
+        await (0, lib_1.createDto)(filePath, entity, { apiType });
+        await (0, lib_1.createService)(filePath, entity);
         await (0, lib_1.createController)(filePath, entity, relationshipMap);
     }
     async setupGraphqlFiles(dir, entity, relationshipMap) {

package/dist/lib/apsorc-parser.d.ts

@@ -1,4 +1,5 @@
-import { ApsorcRelationship, Entity, RelationshipMap } from "./types";
+import { Entity } from "./types/entity";
+import { ApsorcRelationship, RelationshipMap } from "./types/relationship";
 export declare enum ApiType {
     Graphql = "graphql",
     Rest = "rest"
@@ -23,4 +24,29 @@ type ParsedApsorc = {
 export declare const parseApsorcV1: (apsorc: ApsorcType) => ParsedApsorcData;
 export declare const parseApsorcV2: (apsorc: ApsorcType) => ParsedApsorcData;
 export declare const parseApsorc: () => ParsedApsorc;
+/**
+ * Represents the unified configuration structure after parsing and potential migration.
+ */
+interface UnifiedConfig {
+    entities: Entity[];
+    relationships: ApsorcRelationship[];
+    rootFolder: string;
+}
+/**
+ * Finds the .apsorc configuration file path.
+ * Searches upwards from the current working directory.
+ * @returns The absolute path to the .apsorc file, or null if not found.
+ */
+export declare const findConfigPath: () => string | null;
+/**
+ * Loads, validates, and potentially migrates the .apsorc configuration.
+ * Uses the `rc` library to find and load the .apsorc file.
+ * Detects config version (V1 or V2) and migrates V1 to V2 if necessary.
+ * Performs basic validation on the final V2 structure.
+ * @param appName The name of the application (used by `rc`). Defaults to 'apso'.
+ * @param defaults Default configuration values (used by `rc`).
+ * @returns The unified configuration (entities, relationships, rootFolder).
+ * @throws Error if the config file cannot be found, is invalid, or migration fails.
+ */
+export declare const loadConfig: (appName?: string, defaults?: {}) => UnifiedConfig;
 export {};

package/dist/lib/apsorc-parser.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseApsorc = exports.parseApsorcV2 = exports.parseApsorcV1 = exports.ApiType = void 0;
-const rc = require("rc");
+exports.loadConfig = exports.findConfigPath = exports.parseApsorc = exports.parseApsorcV2 = exports.parseApsorcV1 = exports.ApiType = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const rc_1 = tslib_1.__importDefault(require("rc"));
 const relationships_1 = require("./utils/relationships");
 var ApiType;
 (function (ApiType) {
@@ -24,7 +27,7 @@ const parseApsorcV2 = (apsorc) => {
 };
 exports.parseApsorcV2 = parseApsorcV2;
 const parseRc = () => {
-    const apsoConfig = rc("apso");
+    const apsoConfig = (0, rc_1.default)("apso");
     const rootFolder = apsoConfig.rootFolder || "src";
     const apiType = apsoConfig.apiType || "Rest";
     const version = apsoConfig.version || 1;
@@ -63,3 +66,94 @@ const parseApsorc = () => {
     }
 };
 exports.parseApsorc = parseApsorc;
+/**
+ * Finds the .apsorc configuration file path.
+ * Searches upwards from the current working directory.
+ * @returns The absolute path to the .apsorc file, or null if not found.
+ */
+const findConfigPath = () => {
+    let currentDir = process.cwd();
+    // Search upwards
+    while (currentDir !== path.parse(currentDir).root) {
+        const configPath = path.join(currentDir, ".apsorc");
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    // Check root directory as well
+    const rootConfigPath = path.join(currentDir, ".apsorc");
+    if (fs.existsSync(rootConfigPath)) {
+        return rootConfigPath;
+    }
+    return null; // Not found
+};
+exports.findConfigPath = findConfigPath;
+/**
+ * Loads, validates, and potentially migrates the .apsorc configuration.
+ * Uses the `rc` library to find and load the .apsorc file.
+ * Detects config version (V1 or V2) and migrates V1 to V2 if necessary.
+ * Performs basic validation on the final V2 structure.
+ * @param appName The name of the application (used by `rc`). Defaults to 'apso'.
+ * @param defaults Default configuration values (used by `rc`).
+ * @returns The unified configuration (entities, relationships, rootFolder).
+ * @throws Error if the config file cannot be found, is invalid, or migration fails.
+ */
+const loadConfig = (appName = "apso", defaults = {}) => {
+    // Use rc to find and load the configuration file (.apsorc)
+    const configData = (0, rc_1.default)(appName, defaults);
+    const rootFolder = configData.rootFolder || "src"; // Get rootFolder early
+    // Check if rc found and loaded the config
+    // rc returns an object with default keys if nothing is found, 
+    // so check for more than just default keys or if configData.config exists
+    const hasMeaningfulConfig = configData &&
+        Object.keys(configData).some(key => !Object.prototype.hasOwnProperty.call(defaults, key) && key !== '_') &&
+        configData.configs && configData.configs.length > 0;
+    if (!hasMeaningfulConfig) {
+        // If rc didn't find it, try our manual search as a fallback
+        const foundPath = (0, exports.findConfigPath)();
+        // Use ternary to satisfy unicorn/prefer-ternary rule
+        throw foundPath
+            ? new Error(`Configuration file found at: ${foundPath}, but failed to parse. Ensure it is valid JSON or INI.`)
+            : new Error(".apsorc configuration file not found in the current directory or any parent directory.");
+    }
+    // Determine version and parse accordingly using existing functions
+    const version = configData.version || 1; // Default to 1 if undefined
+    let parsedData;
+    // Create an object matching ApsorcType structure from rc data
+    const apsorcInput = {
+        version: version,
+        rootFolder: rootFolder,
+        entities: configData.entities || [],
+        apiType: configData.apiType || ApiType.Rest,
+        relationships: configData.relationships || []
+    };
+    if (version === 1) {
+        // Pass the correctly structured object
+        parsedData = (0, exports.parseApsorcV1)(apsorcInput);
+    }
+    else if (version === 2 && Array.isArray(configData.relationships)) {
+        // Pass the correctly structured object
+        parsedData = (0, exports.parseApsorcV2)(apsorcInput);
+    }
+    else {
+        throw new Error("Invalid .apsorc format. Could not determine configuration version or structure.");
+    }
+    // Basic validation on the result of parsing
+    if (!parsedData.entities || !Array.isArray(parsedData.entities)) {
+        throw new Error("Invalid config: 'entities' array is missing or invalid after parsing.");
+    }
+    if (!rootFolder || typeof rootFolder !== 'string') {
+        throw new Error("Invalid config: 'rootFolder' string is missing or invalid.");
+    }
+    // Relationships are implicitly validated by parseRelationships/parseV1Relationships
+    return {
+        entities: parsedData.entities,
+        // Extract relationships from the relationshipMap keys/values if needed,
+        // or adjust UnifiedConfig. For now, returning empty array as placeholder.
+        // The relationshipMap is the primary output needed by downstream code.
+        relationships: [],
+        rootFolder: rootFolder
+    };
+};
+exports.loadConfig = loadConfig;

package/dist/lib/controller.d.ts

@@ -1,2 +1,10 @@
 import { Entity, RelationshipMap } from "./types";
+/**
+ * Generates NestJS controller and spec files for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param relationshipMap The complete RelationshipMap generated from parsing all relationships.
+ * @returns {Promise<void>} A promise that resolves when the controller and spec files are created.
+ */
 export declare const createController: (apiBaseDir: string, entity: Entity, relationshipMap: RelationshipMap) => Promise<void>;

package/dist/lib/controller.js

@@ -6,31 +6,46 @@ const Eta = tslib_1.__importStar(require("eta"));
 const path = tslib_1.__importStar(require("path"));
 const file_system_1 = require("./utils/file-system");
 const relationships_1 = require("./utils/relationships");
+const pluralize_1 = tslib_1.__importDefault(require("pluralize"));
+/**
+ * Generates NestJS controller and spec files for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param relationshipMap The complete RelationshipMap generated from parsing all relationships.
+ * @returns {Promise<void>} A promise that resolves when the controller and spec files are created.
+ */
 const createController = async (apiBaseDir, entity, relationshipMap) => {
     const { name: entityName } = entity;
-    const File = path.join(apiBaseDir, `${entityName}.controller.ts`);
-    const testFile = path.join(apiBaseDir, `${entityName}.controller.spec.ts`);
-    // Dependencies
+    const controllerFileName = path.join(apiBaseDir, `${entityName}.controller.ts`);
+    const specFileName = path.join(apiBaseDir, `${entityName}.controller.spec.ts`);
+    // Dependencies and names needed by the template
     const svcName = `${entityName}Service`;
     const ctrlName = `${entityName}Controller`;
-    const pluralEntityName = `${entityName}s`;
+    const pluralEntityName = (0, pluralize_1.default)(entityName);
+    // Get processed relationships specific to this entity
     const relationships = (0, relationships_1.getRelationshipForTemplate)(entityName, relationshipMap[entityName]);
+    // Get nested relationship paths for the @Crud join configuration
     const nestedRelationships = (0, relationships_1.getNestedRelationships)(entityName, relationshipMap);
+    // Data object for the Eta template
     const data = {
         svcName,
         ctrlName,
         entityName,
         pluralEntityName,
-        // ensure uniqueness
+        // Ensure uniqueness in associations (though getRelationshipForTemplate might handle this)
         associations: [...new Set(relationships)],
         nestedAssociations: [...new Set(nestedRelationships)],
     };
+    // Configure Eta
     Eta.configure({
         views: path.join(__dirname, "templates"),
     });
-    const content = await Eta.renderFileAsync("./rest/controller-rest", data);
-    (0, file_system_1.createFile)(File, content);
-    const testContent = await Eta.renderFileAsync("./rest/controller-rest-spec", data);
-    (0, file_system_1.createFile)(testFile, testContent);
+    // Render controller template
+    const controllerContent = await Eta.renderFileAsync("./rest/controller-rest", data);
+    (0, file_system_1.createFile)(controllerFileName, controllerContent);
+    // Render spec template
+    const specContent = await Eta.renderFileAsync("./rest/controller-rest-spec", data);
+    (0, file_system_1.createFile)(specFileName, specContent);
 };
 exports.createController = createController;

package/dist/lib/dto.d.ts

@@ -1,7 +1,13 @@
-import { Entity, Relationship } from "./types";
-export interface ComputedField {
-    name: string;
-    primary?: boolean;
-    dataType: string;
-}
-export declare const createDto: (apiBaseDir: string, entity: Entity, relationships: Relationship[]) => Promise<void>;
+import { Entity } from "./types/entity";
+/**
+ * Generates Data Transfer Object (DTO) files (create and update) for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param options Optional configuration flags.
+ * @param options.apiType The type of API being generated (default: "rest").
+ * @returns {Promise<void>} A promise that resolves when the DTO files are created.
+ */
+export declare const createDto: (apiBaseDir: string, entity: Entity, options?: {
+    apiType?: string;
+}) => Promise<void>;

package/dist/lib/dto.js

@@ -7,43 +7,51 @@ const path = tslib_1.__importStar(require("path"));
 const file_system_1 = require("./utils/file-system");
 const field_1 = require("./utils/field");
 const relationships_1 = require("./utils/relationships");
-const createDto = async (apiBaseDir, entity, relationships) => {
-    const { name, fields = [] } = entity;
-    const Dir = path.join(apiBaseDir, "dtos");
-    const File = path.join(Dir, `${name}.dto.ts`);
-    const relationshipFields = relationships
-        .filter((relationship) => relationship.type === "ManyToOne")
-        .map((relationship) => (0, relationships_1.getRelationshipIdField)(relationship));
-    const columns = [
-        ...fields.map((field) => ({
-            name: field.name,
-            type: field.type,
-            primary: field.primary,
-            dataType: field.type === "enum"
-                ? (0, field_1.fieldToEnumType)(field.name, name)
-                : (0, field_1.getJsTypeFromFieldType)(field.type),
-        })),
-        ...relationshipFields.map((fieldName) => ({
-            name: fieldName,
-            dataType: "number",
-        })),
-    ];
+const casing_1 = require("./utils/casing");
+/**
+ * Generates Data Transfer Object (DTO) files (create and update) for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param options Optional configuration flags.
+ * @param options.apiType The type of API being generated (default: "rest").
+ * @returns {Promise<void>} A promise that resolves when the DTO files are created.
+ */
+const createDto = async (apiBaseDir, entity, options) => {
+    var _a;
+    const { name: entityName, fields = [], associations } = entity;
+    const dtoDir = path.join(apiBaseDir, "dto");
+    const dtoFile = path.join(dtoDir, `${entityName}.dto.ts`);
+    const columns = (0, field_1.getFieldForTemplate)(fields, entityName);
+    const relationshipsTemplate = (0, relationships_1.getRelationshipForTemplate)(entityName, associations || []);
     const primaryKeyColumns = columns.filter((column) => column.primary === true);
     const addDefaultPKProperty = primaryKeyColumns.length === 0;
     const createdAt = entity.created_at;
     const updatedAt = entity.updated_at;
+    // Filter columns: remove id, createdAt, updatedAt
+    const dtoColumns = columns.filter((col) => !["id", "createdAt", "updatedAt"].includes(col.name));
+    // Class names
+    const createDtoName = `Create${(0, casing_1.camelCase)(entityName, true)}Dto`;
+    const updateDtoName = `Update${(0, casing_1.camelCase)(entityName, true)}Dto`;
     const data = {
-        name: entity.name,
+        entityName,
         addDefaultPKProperty,
         createdAt,
         updatedAt,
-        columns,
+        columns: dtoColumns,
+        associations: relationshipsTemplate,
+        createDtoName,
+        updateDtoName,
+        apiType: (_a = options === null || options === void 0 ? void 0 : options.apiType) !== null && _a !== void 0 ? _a : "rest",
         importEnums: (0, field_1.typeExistsInEntity)(entity, "enum") !== -1,
     };
+    // Configure Eta
     Eta.configure({
         views: path.join(__dirname, "templates"),
     });
-    const content = await Eta.renderFileAsync("./rest/dto-rest", data);
-    (0, file_system_1.createFile)(File, content);
+    // Render the unified template only once
+    const dtoContent = await Eta.renderFileAsync("./rest/dto-rest", data);
+    // Create only one DTO file
+    (0, file_system_1.createFile)(dtoFile, dtoContent);
 };
 exports.createDto = createDto;

package/dist/lib/entity.d.ts

@@ -1,2 +1,11 @@
 import { Entity, Relationship } from "./types";
+/**
+ * Generates a TypeORM entity file based on the entity definition and relationships.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param relationshipsNew An array of processed Relationship objects for this entity.
+ * @param apiType The type of API being generated (e.g., "rest", "graphql").
+ * @returns {Promise<void>} A promise that resolves when the entity file is created.
+ */
 export declare const createEntity: (apiBaseDir: string, entity: Entity, relationshipsNew: Relationship[], apiType: string) => Promise<void>;

package/dist/lib/entity.js

@@ -4,11 +4,20 @@ exports.createEntity = void 0;
 const tslib_1 = require("tslib");
 const Eta = tslib_1.__importStar(require("eta"));
 const path = tslib_1.__importStar(require("path"));
-const pluralize_1 = tslib_1.__importDefault(require("pluralize"));
 const file_system_1 = require("./utils/file-system");
-const casing_1 = require("./utils/casing");
 const field_1 = require("./utils/field");
 const relationships_1 = require("./utils/relationships");
+const casing_1 = require("./utils/casing");
+const pluralize_1 = tslib_1.__importDefault(require("pluralize"));
+/**
+ * Generates a TypeORM entity file based on the entity definition and relationships.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param relationshipsNew An array of processed Relationship objects for this entity.
+ * @param apiType The type of API being generated (e.g., "rest", "graphql").
+ * @returns {Promise<void>} A promise that resolves when the entity file is created.
+ */
 const createEntity = async (apiBaseDir, entity, relationshipsNew, apiType) => {
     const { name, fields = [], indexes, uniques } = entity;
     const File = path.join(apiBaseDir, `${name}.entity.ts`);
@@ -37,7 +46,8 @@ const createEntity = async (apiBaseDir, entity, relationshipsNew, apiType) => {
     Eta.configure({
         views: path.join(__dirname, "templates"),
     });
-    const content = await Eta.renderFileAsync("./entities/entity", data);
+    const templatePath = apiType === "graphql" ? "./graphql/gql-entity-graphql" : "./entities/entity";
+    const content = await Eta.renderFileAsync(templatePath, data);
     (0, file_system_1.createFile)(File, content);
 };
 exports.createEntity = createEntity;

package/dist/lib/index-module.d.ts

@@ -1,2 +1,13 @@
 import { Entity } from "./types";
+/**
+ * Generates an index file (e.g., index.ts) that exports all generated entity modules.
+ *
+ * This file serves as a central point for importing and managing the generated modules
+ * within the application, tailored to the specified API type (REST or GraphQL).
+ *
+ * @param apiBaseDir The base directory where the generated API modules reside (e.g., 'src/autogen').
+ * @param entities An array of Entity definition objects, used to determine which modules to export.
+ * @param apiType The type of API being generated ('rest' or 'graphql'), which determines the template used.
+ * @returns {Promise<void>} A promise that resolves when the index file is created.
+ */
 export declare const createIndexAppModule: (apiBaseDir: string, entities: Entity[], apiType: string) => Promise<void>;

package/dist/lib/index-module.js

@@ -5,6 +5,17 @@ const tslib_1 = require("tslib");
 const file_system_1 = require("./utils/file-system");
 const Eta = tslib_1.__importStar(require("eta"));
 const path = tslib_1.__importStar(require("path"));
+/**
+ * Generates an index file (e.g., index.ts) that exports all generated entity modules.
+ *
+ * This file serves as a central point for importing and managing the generated modules
+ * within the application, tailored to the specified API type (REST or GraphQL).
+ *
+ * @param apiBaseDir The base directory where the generated API modules reside (e.g., 'src/autogen').
+ * @param entities An array of Entity definition objects, used to determine which modules to export.
+ * @param apiType The type of API being generated ('rest' or 'graphql'), which determines the template used.
+ * @returns {Promise<void>} A promise that resolves when the index file is created.
+ */
 const createIndexAppModule = async (apiBaseDir, entities, apiType) => {
     const File = path.join(apiBaseDir, `index.ts`);
     Eta.configure({

package/dist/lib/module.d.ts

@@ -1 +1,13 @@
-export declare const createModule: (apiBaseDir: string, entityName: string, apiType: string) => Promise<void>;
+import { Entity } from "./types";
+/**
+ * Generates a NestJS module file for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param options Optional configuration flags.
+ * @param options.apiType The type of API being generated (default: "rest").
+ * @returns {Promise<void>} A promise that resolves when the module file is created.
+ */
+export declare const createModule: (apiBaseDir: string, entity: Entity, options?: {
+    apiType?: string;
+}) => Promise<void>;

package/dist/lib/module.js

@@ -5,24 +5,40 @@ const tslib_1 = require("tslib");
 const Eta = tslib_1.__importStar(require("eta"));
 const path = tslib_1.__importStar(require("path"));
 const file_system_1 = require("./utils/file-system");
-const createModule = async (apiBaseDir, entityName, apiType) => {
-    const File = path.join(apiBaseDir, `${entityName}.module.ts`);
-    // Dependencies
+/**
+ * Generates a NestJS module file for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @param options Optional configuration flags.
+ * @param options.apiType The type of API being generated (default: "rest").
+ * @returns {Promise<void>} A promise that resolves when the module file is created.
+ */
+const createModule = async (apiBaseDir, entity, options) => {
+    const { name: entityName } = entity;
+    const moduleFileName = path.join(apiBaseDir, `${entityName}.module.ts`);
+    // Names needed by the templates
+    const moduleName = `${entityName}Module`;
     const svcName = `${entityName}Service`;
-    const ctrlName = `${entityName}Controller`;
-    const modName = `${entityName}Module`;
-    const pluralEntityName = `${entityName}s`;
+    const ctrlName = `${entityName}Controller`; // Used by REST template
+    const resolverName = `${entityName}Resolver`; // Used by GQL template
+    // Data for the Eta templates
     const data = {
+        moduleName,
         svcName,
         ctrlName,
-        modName,
+        resolverName,
         entityName,
-        pluralEntityName,
     };
+    // Configure Eta
     Eta.configure({
         views: path.join(__dirname, "templates"),
     });
-    const content = await Eta.renderFileAsync(`./${apiType}/module-${apiType}`, data);
-    (0, file_system_1.createFile)(File, content);
+    // Determine template based on API type
+    const templatePath = (options === null || options === void 0 ? void 0 : options.apiType) === "graphql" ? "./graphql/gql-module-graphql" : "./rest/module-rest";
+    // Render the template
+    const content = await Eta.renderFileAsync(templatePath, data);
+    // Create the module file
+    (0, file_system_1.createFile)(moduleFileName, content);
 };
 exports.createModule = createModule;

package/dist/lib/service.d.ts

@@ -1 +1,9 @@
-export declare const createService: (apiBaseDir: string, entityName: string) => Promise<void>;
+import { Entity } from "./types";
+/**
+ * Generates NestJS service and spec files for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @returns {Promise<void>} A promise that resolves when the service and spec files are created.
+ */
+export declare const createService: (apiBaseDir: string, entity: Entity) => Promise<void>;

package/dist/lib/service.js

@@ -5,20 +5,35 @@ const tslib_1 = require("tslib");
 const file_system_1 = require("./utils/file-system");
 const Eta = tslib_1.__importStar(require("eta"));
 const path = tslib_1.__importStar(require("path"));
-const createService = async (apiBaseDir, entityName) => {
-    const File = path.join(apiBaseDir, `${entityName}.service.ts`);
-    // Dependencies
+/**
+ * Generates NestJS service and spec files for a given entity.
+ *
+ * @param apiBaseDir The base directory for the generated API module (e.g., 'src/autogen/users').
+ * @param entity The entity definition object from the parsed .apsorc.
+ * @returns {Promise<void>} A promise that resolves when the service and spec files are created.
+ */
+const createService = async (apiBaseDir, entity) => {
+    const { name: entityName } = entity;
+    const serviceFileName = path.join(apiBaseDir, `${entityName}.service.ts`);
+    const specFileName = path.join(apiBaseDir, `${entityName}.service.spec.ts`);
+    // Names needed by the templates
     const svcName = `${entityName}Service`;
-    const pluralEntityName = `${entityName}s`;
+    const repoName = `${entityName}Repository`; // Assuming convention
+    // Data for the Eta templates
     const data = {
         svcName,
+        repoName,
         entityName,
-        pluralEntityName,
     };
+    // Configure Eta
     Eta.configure({
         views: path.join(__dirname, "templates"),
     });
-    const content = await Eta.renderFileAsync("./rest/service-rest", data);
-    (0, file_system_1.createFile)(File, content);
+    // Render service template
+    const serviceContent = await Eta.renderFileAsync("./rest/service-rest", data);
+    (0, file_system_1.createFile)(serviceFileName, serviceContent);
+    // Render spec template
+    const specContent = await Eta.renderFileAsync("./rest/service-rest-spec", data);
+    (0, file_system_1.createFile)(specFileName, specContent);
 };
 exports.createService = createService;