@soapjs/cli 1.0.0

package/build/commands/add/repository-plan.js

@@ -0,0 +1,252 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRepositoryFiles = void 0;
+const path_1 = __importDefault(require("path"));
+const naming_1 = require("../../templates/naming");
+function createRepositoryFiles(plan) {
+    const repositoryNames = (0, naming_1.createNameVariants)(plan.name);
+    const featureNames = (0, naming_1.createNameVariants)(plan.feature);
+    const root = path_1.default.posix.join(plan.featuresRoot, featureNames.kebabName);
+    const commonFiles = [
+        {
+            path: `${root}/application/ports/${repositoryNames.kebabName}-repository.port.ts`,
+            type: "repository",
+            owner: featureNames.kebabName,
+            content: createRepositoryPortTs(repositoryNames.pascalName),
+        },
+        {
+            path: `${root}/data/${repositoryNames.kebabName}.mapper.ts`,
+            type: "repository",
+            owner: featureNames.kebabName,
+            content: createMapperTs(repositoryNames, plan.db),
+        },
+    ];
+    if (plan.db === "mongo") {
+        return [
+            ...commonFiles,
+            {
+                path: `${root}/data/${repositoryNames.kebabName}.model.ts`,
+                type: "repository",
+                owner: featureNames.kebabName,
+                content: createMongoModelTs(repositoryNames.pascalName),
+            },
+            {
+                path: `${root}/data/${repositoryNames.kebabName}.repository.mongo.ts`,
+                type: "repository",
+                owner: featureNames.kebabName,
+                content: createMongoRepositoryTs(repositoryNames),
+            },
+        ];
+    }
+    return [
+        ...commonFiles,
+        {
+            path: `${root}/data/${repositoryNames.kebabName}.row.ts`,
+            type: "repository",
+            owner: featureNames.kebabName,
+            content: createSqlRowTs(repositoryNames.pascalName),
+        },
+        {
+            path: `${root}/data/${repositoryNames.pluralName}.schema.ts`,
+            type: "repository",
+            owner: featureNames.kebabName,
+            content: createSqlSchemaTs(repositoryNames, plan.db),
+        },
+        {
+            path: `${root}/data/${repositoryNames.kebabName}.repository.sql.ts`,
+            type: "repository",
+            owner: featureNames.kebabName,
+            content: createSqlRepositoryTs(repositoryNames),
+        },
+    ];
+}
+exports.createRepositoryFiles = createRepositoryFiles;
+function createRepositoryPortTs(className) {
+    return `import { ReadWriteRepository } from '@soapjs/soap';
+
+export interface ${className}Record {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  [key: string]: unknown;
+}
+
+export type ${className}Repository = ReadWriteRepository<${className}Record, unknown>;
+`;
+}
+function createMongoModelTs(className) {
+    return `import { Document } from 'mongodb';
+
+export interface ${className}Model extends Document {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  [key: string]: unknown;
+}
+`;
+}
+function createSqlRowTs(className) {
+    return `export interface ${className}Row {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  [key: string]: unknown;
+}
+`;
+}
+function createMapperTs(names, db) {
+    const persistenceName = db === "mongo" ? `${names.pascalName}Model` : `${names.pascalName}Row`;
+    const persistenceImport = db === "mongo"
+        ? `import { ${names.pascalName}Model } from './${names.kebabName}.model';`
+        : `import { ${names.pascalName}Row } from './${names.kebabName}.row';`;
+    return `import { Mapper } from '@soapjs/soap';
+import { ${names.pascalName}Record } from '../application/ports/${names.kebabName}-repository.port';
+${persistenceImport}
+
+export const ${names.camelName}Mapper: Mapper<${names.pascalName}Record, ${persistenceName}> = {
+  toEntity(model) {
+    const { _id, ...record } = model as ${persistenceName} & { _id?: unknown };
+
+    return {
+      ...record,
+      id: record.id || (_id ? String(_id) : ''),
+    };
+  },
+
+  toModel(entity) {
+    return {
+      ...entity,
+    } as ${persistenceName};
+  },
+};
+`;
+}
+function createMongoRepositoryTs(names) {
+    return `import { randomUUID } from 'crypto';
+import {
+  DatabaseContext,
+  DatabaseSession,
+  DatabaseSessionRegistry,
+  ReadWriteRepository,
+  TransactionScope,
+} from '@soapjs/soap';
+import { MongoSource } from '@soapjs/soap-node-mongo';
+import { ${names.pascalName}Record } from '../application/ports/${names.kebabName}-repository.port';
+import { ${names.camelName}Mapper } from './${names.kebabName}.mapper';
+import { ${names.pascalName}Model } from './${names.kebabName}.model';
+
+export class Mongo${names.pascalName}Repository extends ReadWriteRepository<${names.pascalName}Record, ${names.pascalName}Model> {
+  constructor(source: MongoSource<${names.pascalName}Model>) {
+    super(new DatabaseContext(source, ${names.camelName}Mapper, createRepositorySessions()));
+  }
+}
+
+function createRepositorySessions(): DatabaseSessionRegistry {
+  const sessions = new Map<string, DatabaseSession>();
+
+  return {
+    transactionScope: TransactionScope.getInstance(),
+    createSession() {
+      const session = createNoopSession();
+      sessions.set(session.id, session);
+      return session;
+    },
+    deleteSession(id: string) {
+      sessions.delete(id);
+    },
+    getSession(id: string) {
+      return sessions.get(id);
+    },
+    hasSession(id: string) {
+      return sessions.has(id);
+    },
+  };
+}
+
+function createNoopSession(): DatabaseSession {
+  return {
+    id: randomUUID(),
+    async end() {},
+    async startTransaction() {},
+    async commitTransaction() {},
+    async rollbackTransaction() {},
+  };
+}
+`;
+}
+function createSqlSchemaTs(names, db) {
+    const tableName = names.pluralName.replace(/-/g, "_");
+    const createdAtColumn = db === "mysql" ? "`createdAt`" : "\"createdAt\"";
+    const updatedAtColumn = db === "mysql" ? "`updatedAt`" : "\"updatedAt\"";
+    return `import { SqlDataSource } from '@soapjs/soap-node-sql';
+import { ${names.pascalName}Row } from './${names.kebabName}.row';
+
+export const ${names.constantName}_TABLE = '${tableName}';
+
+export async function ensure${names.pascalName}Schema(source: SqlDataSource<${names.pascalName}Row>): Promise<void> {
+  await source.query(\`
+    CREATE TABLE IF NOT EXISTS ${tableName} (
+      id TEXT PRIMARY KEY,
+      ${createdAtColumn} TEXT NOT NULL,
+      ${updatedAtColumn} TEXT NOT NULL
+    )
+  \`);
+}
+`;
+}
+function createSqlRepositoryTs(names) {
+    return `import { randomUUID } from 'crypto';
+import {
+  DatabaseContext,
+  DatabaseSession,
+  DatabaseSessionRegistry,
+  ReadWriteRepository,
+  TransactionScope,
+} from '@soapjs/soap';
+import { SqlDataSource } from '@soapjs/soap-node-sql';
+import { ${names.pascalName}Record } from '../application/ports/${names.kebabName}-repository.port';
+import { ${names.camelName}Mapper } from './${names.kebabName}.mapper';
+import { ${names.pascalName}Row } from './${names.kebabName}.row';
+
+export class Sql${names.pascalName}Repository extends ReadWriteRepository<${names.pascalName}Record, ${names.pascalName}Row> {
+  constructor(source: SqlDataSource<${names.pascalName}Row>) {
+    super(new DatabaseContext(source, ${names.camelName}Mapper, createRepositorySessions()));
+  }
+}
+
+function createRepositorySessions(): DatabaseSessionRegistry {
+  const sessions = new Map<string, DatabaseSession>();
+
+  return {
+    transactionScope: TransactionScope.getInstance(),
+    createSession() {
+      const session = createNoopSession();
+      sessions.set(session.id, session);
+      return session;
+    },
+    deleteSession(id: string) {
+      sessions.delete(id);
+    },
+    getSession(id: string) {
+      return sessions.get(id);
+    },
+    hasSession(id: string) {
+      return sessions.has(id);
+    },
+  };
+}
+
+function createNoopSession(): DatabaseSession {
+  return {
+    id: randomUUID(),
+    async end() {},
+    async startTransaction() {},
+    async commitTransaction() {},
+    async rollbackTransaction() {},
+  };
+}
+`;
+}

package/build/commands/add/resource-plan.d.ts

@@ -0,0 +1,52 @@
+import { ApiZone, AuthPolicy, AuthCapability, DatabaseCapability, ResourceFieldDefinition, ResourceRegistryEntry } from "../../config/schemas/types";
+import { PlannedFile } from "../../io/file-writer";
+export interface AddResourcePlan {
+    name: string;
+    crud: boolean;
+    db: "none" | DatabaseCapability;
+    auth: "none" | AuthCapability;
+    zone: ApiZone;
+    featuresRoot: string;
+    architecture?: "regular" | "cqrs";
+    contracts?: "plain" | "zod";
+    fields?: ResourceFieldDefinition[];
+    crudRoutes?: CrudRouteMatrix;
+    policy?: AuthPolicy;
+}
+export type CrudOperation = "list" | "get" | "create" | "update" | "delete";
+export interface CrudRouteConfig {
+    method?: "get" | "post" | "put" | "patch" | "delete";
+    path?: string;
+    auth?: "none" | AuthCapability;
+    zone?: ApiZone;
+    bruno?: boolean;
+    policy?: AuthPolicy;
+}
+export type CrudRouteMatrix = Partial<Record<CrudOperation, CrudRouteConfig>>;
+export interface ResourceAddPlanningOptions extends AddResourcePlan {
+    architecture: "regular" | "cqrs";
+}
+export interface ResourceAddPlanningStep {
+    type: "entity" | "repository" | "use-case" | "command" | "query" | "route" | "contract" | "bruno";
+    name: string;
+}
+export interface ResourceAddPlanningSummary {
+    resource: string;
+    architecture: "regular" | "cqrs";
+    steps: ResourceAddPlanningStep[];
+}
+export declare function createResourceEntry(plan: AddResourcePlan): ResourceRegistryEntry;
+export declare function createResourceAddPlanningSummary(plan: ResourceAddPlanningOptions): ResourceAddPlanningSummary;
+export declare function formatResourceAddPlanningSummary(summary: ResourceAddPlanningSummary): string;
+export declare function createResourceFiles(plan: AddResourcePlan): PlannedFile[];
+export declare function createResourcesFile(resources: ResourceRegistryEntry[], featuresRoot: string): PlannedFile;
+export declare function createFeaturesIndexFile(resources: ResourceRegistryEntry[], authCapabilities?: AuthCapability[]): PlannedFile;
+export declare function createControllersFile(resources: ResourceRegistryEntry[], featuresRoot: string, authCapabilities?: AuthCapability[], routeControllerIndexes?: string[], mainControllerResources?: string[]): PlannedFile;
+export declare function parseCrudRouteMatrix(values: string[] | undefined): CrudRouteMatrix;
+export declare function parseResourceFieldDefinitions(values: string[] | undefined): ResourceFieldDefinition[];
+export declare function createAuthDecorator(auth: "none" | AuthCapability, zone: ApiZone, policy?: AuthPolicy): string | undefined;
+export declare function createRouteApiDocOptions(input: {
+    summary: string;
+    operationId: string;
+    auth: "none" | AuthCapability;
+}): string;