@apso/cli 0.1.0 → 0.1.4

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;

package/dist/lib/templates/rest/service-rest-spec.eta

@@ -0,0 +1,38 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { <%= it.svcName %> } from './<%= it.entityName %>.service';
+import { getRepositoryToken } from '@nestjs/typeorm';
+import { <%= it.entityName %> } from './<%= it.entityName %>.entity';
+
+describe('<%= it.svcName %>', () => {
+  let service: <%= it.svcName %>;
+  let mockRepository: any;
+
+  beforeEach(async () => {
+    mockRepository = {
+      find: jest.fn().mockResolvedValue([]),
+      findOne: jest.fn().mockResolvedValue({}),
+      save: jest.fn().mockResolvedValue({}),
+      create: jest.fn().mockReturnValue({}),
+      update: jest.fn().mockResolvedValue({}),
+      delete: jest.fn().mockResolvedValue({}),
+    };
+
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [
+        <%= it.svcName %>,
+        {
+          provide: getRepositoryToken(<%= it.entityName %>),
+          useValue: mockRepository,
+        },
+      ],
+    }).compile();
+
+    service = module.get<<%= it.svcName %>>(<%= it.svcName %>);
+  });
+
+  it('should be defined', () => {
+    expect(service).toBeDefined();
+  });
+
+  // Add more tests as needed
+});