kschema-fs-api-gen-post-actions 1.10.4 → 1.11.3

package/bin/v11/tasks/actions/InsertGenPk/steps/createActionFolder.js

@@ -0,0 +1,31 @@
+import { createFolder } from "../../../../core/createFolder.js";
+import { showLog } from "./showLog.js";
+
+export const createActionFolder = ({
+    source,
+    destination,
+    isAnnounce,
+    checkBeforeCreate,
+    showLog: isShowLog
+}) => {
+    showLog({
+        enabled: isShowLog,
+        message: "Copying WithMail template.",
+        data: { source, destination }
+    });
+
+    const response = createFolder({
+        source,
+        destination,
+        isAnnounce,
+        checkBeforeCreate
+    });
+
+    showLog({
+        enabled: isShowLog,
+        message: response.KTF ? "Template copy completed." : "Template copy skipped.",
+        data: response
+    });
+
+    return response;
+};

package/bin/v11/tasks/actions/InsertGenPk/steps/generateRestIfRequested.js

@@ -0,0 +1,44 @@
+import path from "path";
+import generateRest from "kschema-fs-api-gen-rest";
+import { showLog } from "./showLog.js";
+
+export const generateRestIfRequested = ({
+    inGenerateRest,
+    toConfigPath,
+    inTargetPath,
+    toPath,
+    resolvedFolderName,
+    isShowLog, inPort
+}) => {
+    if (!inGenerateRest) {
+        showLog({
+            enabled: isShowLog,
+            message: "REST generation not requested."
+        });
+
+        return;
+    };
+
+    const restTargetPath = path.join(toPath, resolvedFolderName);
+
+    showLog({
+        enabled: isShowLog,
+        message: "Generating REST files.",
+        data: { toConfigPath, inTargetPath, toPath: restTargetPath }
+    });
+
+    const response = generateRest({
+        toConfigPath,
+        inTargetPath,
+        toPath: restTargetPath,
+        inPort
+    });
+
+    showLog({
+        enabled: isShowLog,
+        message: "REST generation completed.",
+        data: response
+    });
+
+    return response;
+};

package/bin/{v9/tasks/actions/WithMail → v11/tasks/actions/InsertGenPk}/steps/resolveFolderName.js

@@ -1,6 +1,6 @@
 import fs from "fs";
 
-export default function resolveFolderName({ name, inDefaultFolderName = "WithMail" }) {
+export default function resolveFolderName({ name, inDefaultFolderName = "InsertGenPk" }) {
     const defaultFolderName = inDefaultFolderName;
 
     // case 1: force new → timestamp

package/bin/v11/tasks/actions/InsertGenPk/steps/showLog.js

@@ -0,0 +1,9 @@
+export const showLog = ({ enabled, message, data }) => {
+    if (!enabled) return;
+
+    console.log(`[withMail] ${message}`);
+
+    if (data === undefined) return;
+
+    console.log(data);
+};

package/bin/v11/tasks/actions/InsertGenPk/steps/updateEndPointsJs.js

@@ -0,0 +1,34 @@
+import path from "path";
+import fixEndpointsJs from "express-fix-endpoints-post-js";
+import { showLog } from "./showLog.js";
+
+export const updateEndPointsJs = async ({
+    toPath,
+    cmd,
+    inFolderName,
+    showLog: isShowLog
+}) => {
+    const endPointsJsPath = path.join(toPath, "end-points.js");
+
+    showLog({
+        enabled: isShowLog,
+        message: "Updating end-points.js for body parsing.",
+        data: { endPointsJsPath, cmd, inFolderName }
+    });
+
+    const response = await fixEndpointsJs({
+        endPointsJsPath,
+        showLog: isShowLog,
+        inActionName: cmd,
+        inFolderName,
+        inGetType: "bodyParse"
+    });
+
+    showLog({
+        enabled: isShowLog,
+        message: "end-points.js update completed.",
+        data: response
+    });
+
+    return response;
+};

package/bin/v11/tasks/actions/InsertGenPk/template/v1/insertGenPk.js

@@ -0,0 +1,31 @@
+import insertBase from "./insertBase.js";
+import getData from "./helpers/getData.js";
+import getSchema from "./helpers/getSchema.js";
+import { getPrimaryKey, attachPrimaryKey } from "./helpers/pkHelper.js";
+
+const validateInput = ({ record }) => {
+    if (!record || typeof record !== "object") throw new Error("record must be object");
+};
+
+const insertGenPk = async ({ inRequestBody, inTablePath, inConfigPath }) => {
+    validateInput({ record: inRequestBody });
+
+    const schema = await getSchema({ inConfigPath });
+    const pk = getPrimaryKey(schema.columnsConfig);
+
+    if (inRequestBody[pk] !== undefined) {
+        return insertBase({ inRequestBody, inTablePath });
+    };
+
+    const data = await getData({ inTablePath });
+    const newRecord = attachPrimaryKey(inRequestBody, pk, data);
+
+    await insertBase({
+        inRequestBody: newRecord,
+        inTablePath
+    });
+
+    return newRecord[pk];
+};
+
+export default insertGenPk;

package/bin/v11/tasks/actions/InsertGenPk/template/v1/rest.http

@@ -0,0 +1,8 @@
+POST http://localhost:3000/api/v1/StockItems/withMail
+Content-Type: application/json
+
+{
+  "StockItemName": "Item1",
+  "StockGstApplicable": "",
+  "StockBaseUnits": ""
+}

package/bin/v11/tasks/actions/InsertGenPk/template/v1/service.js

@@ -0,0 +1,9 @@
+import insertGenPk from "./insertGenPk.js";
+
+const startFunc = async ({ inRequestBody, inTablePath, inConfigPath }) => {
+    const insertedPk = await insertGenPk({ inRequestBody, inTablePath, inConfigPath });
+
+    return insertedPk;
+};
+
+export { startFunc };

package/bin/{v9/tasks/actions/WithMail/template/v4 → v11/tasks/actions/InsertGenPk-/template/v2}/insertGenPk.js

@@ -1,6 +1,6 @@
 import insertBase from "./insertBase.js";
-import getData from "./getData.js";
-import getSchema from "./getSchema.js";
+import getData from "./helpers/getData.js";
+import getSchema from "./helpers/getSchema.js";
 import { getPrimaryKey, attachPrimaryKey } from "./helpers/pkHelper.js";
 
 const validateInput = ({ record }) => {

package/bin/v11/tasks/actions/InsertGenPk-/template/v2/rest.http

@@ -0,0 +1,8 @@
+POST http://localhost:3000/api/v1/StockItems/withMail
+Content-Type: application/json
+
+{
+  "StockItemName": "Item1",
+  "StockGstApplicable": "",
+  "StockBaseUnits": ""
+}

package/bin/{v9/tasks/actions/WithMail/template/v4 → v11/tasks/actions/InsertGenPk-/template/v2}/service.js

@@ -1,16 +1,9 @@
 import insertGenPk from "./insertGenPk.js";
-import sendMail from "./Mail/sendMailCC.js";
 
 const startFunc = async ({ inRequestBody, inTablePath, inConfigPath }) => {
     const insertedPk = await insertGenPk({ inRequestBody, inTablePath, inConfigPath });
 
-    const info = await sendMail();
-
-    return await {
-        insertedPk,
-        isMailSent: info.accepted.length > 0 &&
-            info.rejected.length === 0
-    };
+    return insertedPk;
 };
 
 export { startFunc };

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/common/readFile.js

@@ -0,0 +1,8 @@
+import fs from "fs";
+
+const readFile = (inAppJsPath) => {
+    const localPath = inAppJsPath;
+    return fs.readFileSync(localPath, "utf-8");
+};
+
+export default readFile;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/common/writeFile.js

@@ -0,0 +1,10 @@
+import fs from "fs";
+
+const writeFile = (inAppJsPath, inContent) => {
+    const localPath = inAppJsPath;
+    const localContent = inContent;
+
+    fs.writeFileSync(localPath, localContent);
+};
+
+export default writeFile;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateImports/buildImport.js

@@ -0,0 +1,9 @@
+const buildImport = ({ inFuncName, inEndpoint }) => {
+    const localEndpoint = inEndpoint;
+
+    const safeName = localEndpoint.replace(/[^a-zA-Z0-9]/g, "_");
+
+    return `import { ${inFuncName} } from "./${localEndpoint}/controller.js";`;
+};
+
+export default buildImport;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateImports/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkUseDuplicate = ({ inContent, inFuncName }) => {
+    const localContent = inContent;
+    const toCheckLine = `import { ${inFuncName} } from`;
+
+    return localContent.includes(toCheckLine);
+};
+
+export default checkUseDuplicate;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateImports/findInsertIndex.js

@@ -0,0 +1,10 @@
+const findInsertIndex = (inContent) => {
+    const localContent = inContent;
+
+    const matches = [...localContent.matchAll(/^\s*import.*$/gm)];
+    const last = matches.at(-1);
+
+    return last ? last.index + last[0].length : 0;
+};
+
+export default findInsertIndex;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateImports/index.js

@@ -0,0 +1,47 @@
+import readFile from "../common/readFile.js";
+import buildImport from "./buildImport.js";
+import checkDuplicate from "./checkDuplicate.js";
+import findInsertIndex from "./findInsertIndex.js";
+import writeFile from "../common/writeFile.js";
+
+const updateImports = ({ appJsPath, endpoint, showLog, inFuncName }) => {
+    const summary = {
+        import: { added: false, line: null },
+    };
+
+    const content = readFile(appJsPath);
+
+    const importLine = buildImport({
+        inEndpoint: endpoint,
+        inFuncName
+    });
+
+    const fromCheckDuplicate = checkDuplicate({ inContent: content, inFuncName });
+
+    if (fromCheckDuplicate) {
+        summary.import.skipped = true;
+
+        if (showLog) console.log(summary);
+
+        return summary;
+    };
+
+    const index = findInsertIndex(content);
+
+    const before = content.slice(0, index);
+    const lineNumber = before.split("\n").length + 1;
+
+    const updated =
+        before + "\n" + importLine + content.slice(index);
+
+    writeFile(appJsPath, updated);
+
+    summary.import.added = true;
+    summary.import.line = lineNumber;
+
+    if (showLog) console.log(summary);
+
+    return summary;
+};
+
+export default updateImports;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateUse/buildUseLine.js

@@ -0,0 +1,5 @@
+const buildUseLine = ({ inAppOrRouter, inEndpoint, inFuncName }) => {
+    return `${inAppOrRouter}.get('/${inEndpoint}', (req, res) => ${inFuncName}({ res, inTableName : tableName}));`;
+};
+
+export default buildUseLine;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateUse/checkDuplicate.js

@@ -0,0 +1,9 @@
+const checkDuplicate = ({ inContent, inEndpoint, inAppOrRouter }) => {
+    const localContent = inContent;
+    const localEndpoint = inEndpoint;
+    const stringToSearch = `${inAppOrRouter}.get('/${localEndpoint}'`;
+
+    return localContent.includes(stringToSearch);
+};
+
+export default checkDuplicate;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateUse/findInsertIndex.js

@@ -0,0 +1,10 @@
+const findUseInsertIndex = (inContent) => {
+    const localContent = inContent;
+
+    const matches = [...localContent.matchAll(/const\s+router\s*=\s*express\.Router\(\)/g)];
+    const match = matches.at(0);
+
+    return match ? match.index + match[0].length : localContent.length;
+};
+
+export default findUseInsertIndex;

package/bin/v11/tasks/actions/WithMail/steps/UpdateRoutesJs/updateUse/index.js

@@ -0,0 +1,56 @@
+import readFile from "../common/readFile.js";
+import writeFile from "../common/writeFile.js";
+
+import buildUseLine from "./buildUseLine.js";
+import checkDuplicate from "./checkDuplicate.js";
+import findUseInsertIndex from "./findInsertIndex.js";
+
+const appOrRouter = "router";
+
+const updateAppUse = ({ appJsPath, endpoint, showLog, inFuncName }) => {
+    const summary = {
+        use: { added: false, skipped: false, line: null }
+    };
+
+    const content = readFile(appJsPath);
+
+    const useLine = buildUseLine({
+        inAppOrRouter: appOrRouter,
+        inEndpoint: endpoint,
+        inFuncName
+    });
+
+    const fromCheckDuplicate = checkDuplicate({
+        inContent: content,
+        inEndpoint: endpoint,
+        inAppOrRouter: appOrRouter
+    });
+    console.log("fromCheckDuplicate : ", fromCheckDuplicate);
+
+    if (fromCheckDuplicate) {
+        summary.use.skipped = true;
+
+        if (showLog) console.log(summary);
+
+        return summary;
+    };
+
+    const index = findUseInsertIndex(content);
+
+    const before = content.slice(0, index);
+    const lineNumber = before.split("\n").length + 1;
+
+    const updated =
+        before + "\n" + useLine + content.slice(index);
+
+    writeFile(appJsPath, updated);
+
+    summary.use.added = true;
+    summary.use.line = lineNumber;
+
+    if (showLog) console.log(summary);
+
+    return summary;
+};
+
+export default updateAppUse;

package/bin/v11/tasks/actions/WithMail/steps/announce.js

@@ -0,0 +1,9 @@
+export const announce = ({ inResolvedFolderName }) => {
+    console.log(`[keshavsoft] Folder created: ${inResolvedFolderName}`);
+
+    console.log("");
+    console.log("Next:");
+    console.log("");
+    console.log(`cd ${inResolvedFolderName}`);
+    console.log(`npx kschema-api-gen AddSubRoute`);
+};

package/bin/v11/tasks/actions/WithMail/steps/createActionFolder.js

@@ -0,0 +1,31 @@
+import { createFolder } from "../../../../core/createFolder.js";
+import { showLog } from "./showLog.js";
+
+export const createActionFolder = ({
+    source,
+    destination,
+    isAnnounce,
+    checkBeforeCreate,
+    showLog: isShowLog
+}) => {
+    showLog({
+        enabled: isShowLog,
+        message: "Copying WithMail template.",
+        data: { source, destination }
+    });
+
+    const response = createFolder({
+        source,
+        destination,
+        isAnnounce,
+        checkBeforeCreate
+    });
+
+    showLog({
+        enabled: isShowLog,
+        message: response.KTF ? "Template copy completed." : "Template copy skipped.",
+        data: response
+    });
+
+    return response;
+};

package/bin/v11/tasks/actions/WithMail/steps/createFolder.js

@@ -0,0 +1,7 @@
+import fs from "fs";
+
+export const createFolder = ({ source, destination }) => {
+    fs.mkdirSync(destination, { recursive: true });
+
+    fs.cpSync(source, destination, { recursive: true });
+};

package/bin/v11/tasks/actions/WithMail/steps/decideTemplate.js

@@ -0,0 +1,3 @@
+export const decideTemplate = ({ inTemplate }) => {
+    return inTemplate || "basic";
+};

package/bin/v11/tasks/actions/WithMail/steps/generateRestIfRequested.js

@@ -0,0 +1,43 @@
+import path from "path";
+import generateRest from "kschema-fs-api-gen-rest";
+import { showLog } from "./showLog.js";
+
+export const generateRestIfRequested = ({
+    inGenerateRest,
+    toConfigPath,
+    inTargetPath,
+    toPath,
+    resolvedFolderName,
+    isShowLog
+}) => {
+    if (!inGenerateRest) {
+        showLog({
+            enabled: isShowLog,
+            message: "REST generation not requested."
+        });
+
+        return;
+    };
+
+    const restTargetPath = path.join(toPath, resolvedFolderName);
+
+    showLog({
+        enabled: isShowLog,
+        message: "Generating REST files.",
+        data: { toConfigPath, inTargetPath, toPath: restTargetPath }
+    });
+
+    const response = generateRest({
+        toConfigPath,
+        inTargetPath,
+        toPath: restTargetPath
+    });
+
+    showLog({
+        enabled: isShowLog,
+        message: "REST generation completed.",
+        data: response
+    });
+
+    return response;
+};

package/bin/v11/tasks/actions/WithMail/steps/locateDestination.js

@@ -0,0 +1,7 @@
+import path from "path";
+
+export const locateDestination = ({ inResolvedFolderName, toPath }) => {
+    const localToPath = toPath;
+
+    return path.join(localToPath, inResolvedFolderName);
+};

package/bin/v11/tasks/actions/WithMail/steps/locateSource.js

@@ -0,0 +1,18 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const locateSource = () => {
+    const templatePath = path.join(__dirname, "..", "template");
+
+    const versions = fs.readdirSync(templatePath);
+
+    const maxVersion = Math.max(
+        ...versions.map(v => Number(v.replace("v", "")))
+    );
+
+    return path.join(templatePath, `v${maxVersion}`);
+};

package/bin/v11/tasks/actions/WithMail/steps/resolveFolderName.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+
+export default function resolveFolderName({ name, inDefaultFolderName = "InsertGenPk" }) {
+    const defaultFolderName = inDefaultFolderName;
+
+    // case 1: force new → timestamp
+    if (name === null) {
+        name = defaultFolderName;
+    };
+
+    // case 2: user provided → strict
+    if (fs.existsSync(name)) {
+        return {
+            KTF: false,
+            KReason: `Folder already exists : ${name}`
+        };
+    };
+
+    return name;
+};

package/bin/v11/tasks/actions/WithMail/steps/showLog.js

@@ -0,0 +1,9 @@
+export const showLog = ({ enabled, message, data }) => {
+    if (!enabled) return;
+
+    console.log(`[withMail] ${message}`);
+
+    if (data === undefined) return;
+
+    console.log(data);
+};

package/bin/v11/tasks/actions/WithMail/steps/updateAppJs.js

@@ -0,0 +1,7 @@
+import updateImports from "./UpdateRoutesJs/updateImports/index.js";
+import updateAppUse from "./UpdateRoutesJs/updateUse/index.js";
+
+export default ({ appJsPath, endpoint }) => {
+    updateImports({ appJsPath, endpoint });
+    updateAppUse({ appJsPath, endpoint });
+};

package/bin/v11/tasks/actions/WithMail/steps/updateEndPointsFile.js

@@ -0,0 +1,30 @@
+import fs from 'fs';
+
+function updateEndPointsFile({ filePath, inTableName }) {
+    try {
+        let content = readFile(filePath);
+
+        content = content.replace("<TABLE_NAME>", inTableName);
+
+        writeFile(filePath, content);
+    } catch (e) {
+        handleError(e);
+    };
+};
+
+// read
+function readFile(filePath) {
+    return fs.readFileSync(filePath, "utf-8");
+};
+
+// write
+function writeFile(filePath, content) {
+    fs.writeFileSync(filePath, content);
+};
+
+// error handler
+function handleError(e) {
+    console.error("ROUTE USE ERROR:", e.message);
+};
+
+export { updateEndPointsFile };

package/bin/v11/tasks/actions/WithMail/steps/updateEndPointsJs.js

@@ -0,0 +1,34 @@
+import path from "path";
+import fixEndpointsJs from "express-fix-endpoints-post-js";
+import { showLog } from "./showLog.js";
+
+export const updateEndPointsJs = async ({
+    toPath,
+    cmd,
+    inFolderName,
+    showLog: isShowLog
+}) => {
+    const endPointsJsPath = path.join(toPath, "end-points.js");
+
+    showLog({
+        enabled: isShowLog,
+        message: "Updating end-points.js for body parsing.",
+        data: { endPointsJsPath, cmd, inFolderName }
+    });
+
+    const response = await fixEndpointsJs({
+        endPointsJsPath,
+        showLog: isShowLog,
+        inActionName: cmd,
+        inFolderName,
+        inGetType: "bodyParse"
+    });
+
+    showLog({
+        enabled: isShowLog,
+        message: "end-points.js update completed.",
+        data: response
+    });
+
+    return response;
+};

package/bin/v11/tasks/actions/WithMail/template/v1/config/getSchema.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+import path from "path";
+import { getConfig } from "../../core/configStore.js";
+
+export const getSchema = (table) => {
+    const config = getConfig();
+
+    const schemaPath = path.join(config.SchemaPath, `${table}.json`);
+
+    if (!fs.existsSync(schemaPath)) {
+        throw new Error(`Schema not found for table "${table}" at ${schemaPath}`);
+    }
+
+    try {
+        const schema = fs.readFileSync(schemaPath, "utf-8");
+        return JSON.parse(schema);
+    } catch (err) {
+        throw new Error(`Invalid schema JSON for "${table}": ${err.message}`);
+    };
+};