@mxpicture/gcp-functions-generator 1.1.3 → 1.1.4

package/dist/common/file.common.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.common.js","sourceRoot":"","sources":["../../src/common/file.common.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,2CAA2C,CAAC;AAGnD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAW,EAAE,CAC1D,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;AAE5C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,IAAkB,EAAW,EAAE,CACxE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAAgB,EAChB,IAAmB,EACnB,GAAuB,EACd,EAAE;IACX,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAoB,EAAE;IACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,oCAAoC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,oBAAoB,KAAK,GAAG,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG;QACN,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,yBAAyB,IAAI,GAAG,CAAC,CAAC;IACzE,OAAO;QACL,QAAQ;QACR,IAAI;QACJ,GAAG;QACH,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;KAC5B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAuB,EAAU,EAAE,CACjE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;KACtE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;KAClB,IAAI,CAAC,GAAG,CAAC,CAAC;AAEf,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAK1B,EAAU,EAAE,CACX,eAAe,CAAC;IACd,GAAG,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;IACZ,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,iBAAiB,CAAC,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,SAAS;CACvB,CAAC,CAAC"}
+{"version":3,"file":"file.common.js","sourceRoot":"","sources":["../../src/common/file.common.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,2CAA2C,CAAC;AAGnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAW,EAAE,CAC1D,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,IAAkB,EAAW,EAAE,CACxE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAAgB,EAChB,IAAmB,EACnB,GAAuB,EACd,EAAE;IACX,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAoB,EAAE;IACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,oCAAoC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,oBAAoB,KAAK,GAAG,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG;QACN,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,yBAAyB,IAAI,GAAG,CAAC,CAAC;IACzE,OAAO;QACL,QAAQ;QACR,IAAI;QACJ,GAAG;QACH,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;KAC5B,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAuB,EAAU,EAAE,CACjE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;KACtE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;KAClB,IAAI,CAAC,GAAG,CAAC,CAAC;AAEf;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAK1B,EAAU,EAAE,CACX,eAAe,CAAC;IACd,GAAG,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;IACZ,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,iBAAiB,CAAC,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,SAAS;CACvB,CAAC,CAAC"}

package/dist/common/generator.common.d.ts

@@ -2,21 +2,79 @@ import { Generator, GeneratorResultFile } from "../generator/Generator.js";
 import { DirectoriesParams } from "./Directories.js";
 import { GeneratorEnv } from "./types.common.js";
 import { DecoFile } from "@mxpicture/gcp-functions-common/types";
+/** Resolved absolute path to the `generator/` directory. */
 export declare const generatorDirPath: string;
+/**
+ * Metadata about a generator source file on disk.
+ */
 export interface GeneratorFile {
     filename: string;
     filePath: string;
     filenameWoExt: string;
     fileExt: string;
 }
+/**
+ * A generator file paired with its instantiated {@link Generator}.
+ */
 export interface GeneratorEntry extends GeneratorFile {
     gen: Generator;
 }
+/**
+ * Reads and caches the list of generator files from the generator directory.
+ *
+ * @remarks
+ * Excludes the base `Generator.ts`/`.js` file and declaration files.
+ *
+ * @returns A promise resolving to an array of {@link GeneratorFile} objects.
+ */
 export declare const readGeneratorFiles: () => Promise<GeneratorFile[]>;
+/**
+ * Reads a specific generator file by filename.
+ *
+ * @param filename - The filename to look up.
+ * @returns The matching {@link GeneratorFile}, or `null` if not found.
+ */
 export declare const readGeneratorFile: (filename: string) => Promise<GeneratorFile | null>;
+/**
+ * Dynamically imports a generator file and returns a cached {@link GeneratorEntry}.
+ *
+ * @param file - The generator file to import.
+ * @returns The generator entry, or `null` if the default export is not a {@link Generator}.
+ */
 export declare const createGenerator: (file: GeneratorFile) => Promise<GeneratorEntry | null>;
+/**
+ * Discovers and instantiates all available generators.
+ *
+ * @returns A promise resolving to an array of valid {@link GeneratorEntry} objects.
+ */
 export declare const createGenerators: () => Promise<GeneratorEntry[]>;
+/**
+ * Orchestrates the full code generation pipeline.
+ *
+ * @remarks
+ * Sets up directories, extracts templates, runs all generators,
+ * writes output files, and creates barrel files with `package.json` exports.
+ *
+ * @param params - Directory configuration for templates and output.
+ * @param env - Environment variables (region, service account) for backend generation.
+ */
 export declare const runGeneration: (params: DirectoriesParams, env: GeneratorEnv) => Promise<void>;
+/**
+ * Runs a single generator against one decorator file and writes the result.
+ *
+ * @param file - The extracted decorator file to process.
+ * @param gen - The generator to run.
+ * @param env - Environment variables for the generation context.
+ * @returns The generated result file.
+ */
 export declare const runFile: (file: DecoFile, gen: Generator, env: GeneratorEnv) => Promise<GeneratorResultFile>;
+/**
+ * Runs a generator against multiple decorator files without writing to disk.
+ *
+ * @param files - The extracted decorator files to process.
+ * @param gen - The generator to run.
+ * @param env - Environment variables for the generation context.
+ * @returns A promise resolving to an array of generated result files.
+ */
 export declare const runFiles: (files: DecoFile[], gen: Generator, env: GeneratorEnv) => Promise<GeneratorResultFile[]>;
 //# sourceMappingURL=generator.common.d.ts.map

package/dist/common/generator.common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.common.d.ts","sourceRoot":"","sources":["../../src/common/generator.common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAe,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,QAA+C,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,GAAG,EAAE,SAAS,CAAC;CAChB;AAKD,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,aAAa,EAAE,CAyBlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,KACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAEzB,CAAC;AAEP,eAAO,MAAM,eAAe,GAC1B,MAAM,aAAa,KAClB,OAAO,CAAC,cAAc,GAAG,IAAI,CAY/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,cAAc,EAAE,CAKjE,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,QAAQ,iBAAiB,EACzB,KAAK,YAAY,kBA4BlB,CAAC;AAUF,eAAO,MAAM,OAAO,GAClB,MAAM,QAAQ,EACd,KAAK,SAAS,EACd,KAAK,YAAY,KAChB,OAAO,CAAC,mBAAmB,CAK7B,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,OAAO,QAAQ,EAAE,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,KAChB,OAAO,CAAC,mBAAmB,EAAE,CAC4B,CAAC"}
+{"version":3,"file":"generator.common.d.ts","sourceRoot":"","sources":["../../src/common/generator.common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAe,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAEjE,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,QAA+C,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,GAAG,EAAE,SAAS,CAAC;CAChB;AAKD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,aAAa,EAAE,CAyBlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,KACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAEzB,CAAC;AAEP;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,aAAa,KAClB,OAAO,CAAC,cAAc,GAAG,IAAI,CAY/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,cAAc,EAAE,CAKjE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,iBAAiB,EACzB,KAAK,YAAY,kBA4BlB,CAAC;AAUF;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAClB,MAAM,QAAQ,EACd,KAAK,SAAS,EACd,KAAK,YAAY,KAChB,OAAO,CAAC,mBAAmB,CAK7B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GACnB,OAAO,QAAQ,EAAE,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,KAChB,OAAO,CAAC,mBAAmB,EAAE,CAC4B,CAAC"}

package/dist/common/generator.common.js

@@ -4,9 +4,18 @@ import { readdir } from "node:fs/promises";
 import { directories } from "./Directories.js";
 import { runExtractors } from "./Extractor.js";
 import { Barrel } from "./Barrel.js";
+/** Resolved absolute path to the `generator/` directory. */
 export const generatorDirPath = resolve(import.meta.dirname, "../generator");
 const generators = [];
 let generatorFiles = null;
+/**
+ * Reads and caches the list of generator files from the generator directory.
+ *
+ * @remarks
+ * Excludes the base `Generator.ts`/`.js` file and declaration files.
+ *
+ * @returns A promise resolving to an array of {@link GeneratorFile} objects.
+ */
 export const readGeneratorFiles = async () => {
     if (!generatorFiles) {
         const filenames = (await readdir(generatorDirPath)).filter((filename) => filename !== "Generator.ts" &&
@@ -26,8 +35,20 @@ export const readGeneratorFiles = async () => {
     }
     return generatorFiles;
 };
+/**
+ * Reads a specific generator file by filename.
+ *
+ * @param filename - The filename to look up.
+ * @returns The matching {@link GeneratorFile}, or `null` if not found.
+ */
 export const readGeneratorFile = async (filename) => (await readGeneratorFiles()).find((file) => file.filename === filename) ??
     null;
+/**
+ * Dynamically imports a generator file and returns a cached {@link GeneratorEntry}.
+ *
+ * @param file - The generator file to import.
+ * @returns The generator entry, or `null` if the default export is not a {@link Generator}.
+ */
 export const createGenerator = async (file) => {
     let found = generators.find((generator) => generator.filePath === file.filePath);
     if (found)
@@ -39,12 +60,27 @@ export const createGenerator = async (file) => {
     generators.push(found);
     return found;
 };
+/**
+ * Discovers and instantiates all available generators.
+ *
+ * @returns A promise resolving to an array of valid {@link GeneratorEntry} objects.
+ */
 export const createGenerators = async () => {
     const files = await readGeneratorFiles();
     const promises = files.map(createGenerator);
     const entries = await Promise.all(promises);
     return entries.filter((entry) => !!entry);
 };
+/**
+ * Orchestrates the full code generation pipeline.
+ *
+ * @remarks
+ * Sets up directories, extracts templates, runs all generators,
+ * writes output files, and creates barrel files with `package.json` exports.
+ *
+ * @param params - Directory configuration for templates and output.
+ * @param env - Environment variables (region, service account) for backend generation.
+ */
 export const runGeneration = async (params, env) => {
     const { files, entries } = await prepareRunGeneration(params);
     console.log("using:");
@@ -74,11 +110,27 @@ const prepareRunGeneration = async (params) => {
     const entries = await createGenerators();
     return { files, entries };
 };
+/**
+ * Runs a single generator against one decorator file and writes the result.
+ *
+ * @param file - The extracted decorator file to process.
+ * @param gen - The generator to run.
+ * @param env - Environment variables for the generation context.
+ * @returns The generated result file.
+ */
 export const runFile = async (file, gen, env) => {
     console.log(`  - ${gen.type} (${gen.ext})`);
     const resultFile = await gen.run(file, env);
     await Generator.write(resultFile);
     return resultFile;
 };
+/**
+ * Runs a generator against multiple decorator files without writing to disk.
+ *
+ * @param files - The extracted decorator files to process.
+ * @param gen - The generator to run.
+ * @param env - Environment variables for the generation context.
+ * @returns A promise resolving to an array of generated result files.
+ */
 export const runFiles = async (files, gen, env) => Promise.all(files.map(async (file) => gen.run(file, env)));
 //# sourceMappingURL=generator.common.js.map

package/dist/common/generator.common.js.map

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

package/dist/common/string.common.d.ts

@@ -1,5 +1,29 @@
+/**
+ * Converts the first character of a string to lower case.
+ *
+ * @param val - The input string.
+ * @returns The string with its first character lower-cased.
+ */
 export declare const lowerFirstLetter: (val: string) => string;
+/**
+ * Converts the first character of a string to upper case.
+ *
+ * @param val - The input string.
+ * @returns The string with its first character upper-cased.
+ */
 export declare const upperFirstLetter: (val: string) => string;
+/**
+ * Async variant of {@link lowerFirstLetter}.
+ *
+ * @param val - The input string.
+ * @returns A promise resolving to the string with its first character lower-cased.
+ */
 export declare const lowerFirstLetterAsync: (val: string) => Promise<string>;
+/**
+ * Async variant of {@link upperFirstLetter}.
+ *
+ * @param val - The input string.
+ * @returns A promise resolving to the string with its first character upper-cased.
+ */
 export declare const upperFirstLetterAsync: (val: string) => Promise<string>;
 //# sourceMappingURL=string.common.d.ts.map

package/dist/common/string.common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string.common.d.ts","sourceRoot":"","sources":["../../src/common/string.common.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,WAGf,CAAC;AAE9B,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,WAGrB,CAAC;AAExB,eAAO,MAAM,qBAAqB,GAAU,KAAK,MAAM,oBACF,CAAC;AAEtD,eAAO,MAAM,qBAAqB,GAAU,KAAK,MAAM,oBACF,CAAC"}
+{"version":3,"file":"string.common.d.ts","sourceRoot":"","sources":["../../src/common/string.common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,WAGf,CAAC;AAE9B;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,WAGrB,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAU,KAAK,MAAM,oBACF,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAU,KAAK,MAAM,oBACF,CAAC"}

package/dist/common/string.common.js

@@ -1,9 +1,33 @@
+/**
+ * Converts the first character of a string to lower case.
+ *
+ * @param val - The input string.
+ * @returns The string with its first character lower-cased.
+ */
 export const lowerFirstLetter = (val) => val.length > 1
     ? val.charAt(0).toLocaleLowerCase() + val.slice(1)
     : val.toLocaleLowerCase();
+/**
+ * Converts the first character of a string to upper case.
+ *
+ * @param val - The input string.
+ * @returns The string with its first character upper-cased.
+ */
 export const upperFirstLetter = (val) => val.length > 1
     ? val.charAt(0).toUpperCase() + val.slice(1)
     : val.toUpperCase();
+/**
+ * Async variant of {@link lowerFirstLetter}.
+ *
+ * @param val - The input string.
+ * @returns A promise resolving to the string with its first character lower-cased.
+ */
 export const lowerFirstLetterAsync = async (val) => Promise.resolve().then(() => lowerFirstLetter(val));
+/**
+ * Async variant of {@link upperFirstLetter}.
+ *
+ * @param val - The input string.
+ * @returns A promise resolving to the string with its first character upper-cased.
+ */
 export const upperFirstLetterAsync = async (val) => Promise.resolve().then(() => upperFirstLetter(val));
 //# sourceMappingURL=string.common.js.map

package/dist/common/string.common.js.map

@@ -1 +1 @@
-{"version":3,"file":"string.common.js","sourceRoot":"","sources":["../../src/common/string.common.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE,CAC9C,GAAG,CAAC,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;AAE9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE,CAC9C,GAAG,CAAC,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE,CACzD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE,CACzD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC"}
+{"version":3,"file":"string.common.js","sourceRoot":"","sources":["../../src/common/string.common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE,CAC9C,GAAG,CAAC,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE,CAC9C,GAAG,CAAC,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE,CACzD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE,CACzD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/common/types.common.d.ts

@@ -1,19 +1,35 @@
 import { PackageJson } from "@mxpicture/build-api/types";
 import { DecoFileExtension, DecoFileType, DecoTargetType } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Decomposed parts of a dot-separated decorator filename.
+ */
 export interface ExtractFileParts {
+    /** The original full filename. */
     filename: string;
+    /** The decorator file type (first segment). */
     type: DecoFileType;
+    /** The file extension (last segment). */
     ext: DecoFileExtension;
+    /** The middle portion of the filename between type and extension. */
     middlePart: string;
+    /** Whether this file is a generated artifact. */
     generated?: boolean;
 }
+/**
+ * Represents a target package with its location and parsed `package.json`.
+ */
 export interface TargetPackage {
     targetType: DecoTargetType;
     filePath: string;
     pkg: PackageJson;
 }
+/**
+ * Environment variables required by generators that produce deployment-aware code.
+ */
 export interface GeneratorEnv {
+    /** The GCP region for Cloud Functions deployment. */
     region: string;
+    /** The GCP service account email used by Cloud Functions. */
     serviceAccount: string;
 }
 //# sourceMappingURL=types.common.d.ts.map

package/dist/common/types.common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.common.d.ts","sourceRoot":"","sources":["../../src/common/types.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACf,MAAM,2CAA2C,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,iBAAiB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"types.common.d.ts","sourceRoot":"","sources":["../../src/common/types.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACf,MAAM,2CAA2C,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,EAAE,YAAY,CAAC;IACnB,yCAAyC;IACzC,GAAG,EAAE,iBAAiB,CAAC;IACvB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/decorator/deco.imports.d.ts

@@ -1,5 +1,8 @@
 import ts from "typescript";
 import { DecoImport } from "@mxpicture/gcp-functions-common/types";
+/**
+ * Represents a single import declaration extracted from a TypeScript source file.
+ */
 export interface ExtractedImport {
     module: string;
     defaultImport?: string;
@@ -7,6 +10,22 @@ export interface ExtractedImport {
     namespaceImport?: string;
     isTypeOnly?: boolean;
 }
+/**
+ * Extracts named imports from a TypeScript source file or raw source string.
+ *
+ * @remarks
+ * Only imports with named bindings are included in the result; default and namespace
+ * imports are excluded.
+ *
+ * @param sourceFile - A TypeScript `SourceFile` AST node or raw source code string.
+ * @returns An array of {@link DecoImport} entries representing named imports.
+ */
 export declare const extractNamedImports: (sourceFile: ts.SourceFile | string) => DecoImport[];
+/**
+ * Extracts all import declarations from a TypeScript source file AST.
+ *
+ * @param sourceFile - The TypeScript `SourceFile` to traverse.
+ * @returns An array of {@link ExtractedImport} objects for every import declaration found.
+ */
 export declare const extractImports: (sourceFile: ts.SourceFile) => ExtractedImport[];
 //# sourceMappingURL=deco.imports.d.ts.map

package/dist/decorator/deco.imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deco.imports.d.ts","sourceRoot":"","sources":["../../src/decorator/deco.imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAGnE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,mBAAmB,GAC9B,YAAY,EAAE,CAAC,UAAU,GAAG,MAAM,KACjC,UAAU,EAmBZ,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,YAAY,EAAE,CAAC,UAAU,KACxB,eAAe,EAqCjB,CAAC"}
+{"version":3,"file":"deco.imports.d.ts","sourceRoot":"","sources":["../../src/decorator/deco.imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,EAAE,CAAC,UAAU,GAAG,MAAM,KACjC,UAAU,EAmBZ,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,EAAE,CAAC,UAAU,KACxB,eAAe,EAqCjB,CAAC"}

package/dist/decorator/deco.imports.js

@@ -1,5 +1,15 @@
 import ts from "typescript";
 import { createSourceFiles } from "@mxpicture/build-api/code";
+/**
+ * Extracts named imports from a TypeScript source file or raw source string.
+ *
+ * @remarks
+ * Only imports with named bindings are included in the result; default and namespace
+ * imports are excluded.
+ *
+ * @param sourceFile - A TypeScript `SourceFile` AST node or raw source code string.
+ * @returns An array of {@link DecoImport} entries representing named imports.
+ */
 export const extractNamedImports = (sourceFile) => {
     if (typeof sourceFile === "string") {
         const files = createSourceFiles([sourceFile]);
@@ -20,6 +30,12 @@ export const extractNamedImports = (sourceFile) => {
     }
     return results;
 };
+/**
+ * Extracts all import declarations from a TypeScript source file AST.
+ *
+ * @param sourceFile - The TypeScript `SourceFile` to traverse.
+ * @returns An array of {@link ExtractedImport} objects for every import declaration found.
+ */
 export const extractImports = (sourceFile) => {
     const imports = [];
     sourceFile.forEachChild((node) => {

package/dist/decorator/deco.imports.js.map

@@ -1 +1 @@
-{"version":3,"file":"deco.imports.js","sourceRoot":"","sources":["../../src/decorator/deco.imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAU9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAAkC,EACpB,EAAE;IAChB,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACnC,CAAC;IACD,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjE,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,GAAG,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,UAAU;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAAyB,EACN,EAAE;IACrB,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,UAAU,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/B,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzD,MAAM,UAAU,GAAI,IAAI,CAAC,eAAoC,CAAC,IAAI,CAAC;YAEnE,IAAI,aAAiC,CAAC;YACtC,IAAI,YAAY,GAAa,EAAE,CAAC;YAChC,IAAI,eAAmC,CAAC;YAExC,IAAI,CAAC,IAAI,CAAC,YAAY;gBAAE,OAAO;YAC/B,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI;gBAAE,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YACxE,MAAM,UAAU,GACd,IAAI,CAAC,YAAY,CAAC,aAAa,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAEhE,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;gBACpC,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;oBACvD,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CACzD,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CACrB,CAAC;gBACJ,CAAC;qBAAM,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;oBACjE,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9D,CAAC;YACH,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,UAAU;gBAClB,aAAa;gBACb,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;gBAC5D,eAAe;gBACf,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}
+{"version":3,"file":"deco.imports.js","sourceRoot":"","sources":["../../src/decorator/deco.imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAa9D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAAkC,EACpB,EAAE;IAChB,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACnC,CAAC;IACD,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjE,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,GAAG,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,UAAU;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAAyB,EACN,EAAE;IACrB,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,UAAU,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/B,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzD,MAAM,UAAU,GAAI,IAAI,CAAC,eAAoC,CAAC,IAAI,CAAC;YAEnE,IAAI,aAAiC,CAAC;YACtC,IAAI,YAAY,GAAa,EAAE,CAAC;YAChC,IAAI,eAAmC,CAAC;YAExC,IAAI,CAAC,IAAI,CAAC,YAAY;gBAAE,OAAO;YAC/B,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI;gBAAE,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YACxE,MAAM,UAAU,GACd,IAAI,CAAC,YAAY,CAAC,aAAa,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAEhE,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;gBACpC,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;oBACvD,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CACzD,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CACrB,CAAC;gBACJ,CAAC;qBAAM,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;oBACjE,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9D,CAAC;YACH,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,UAAU;gBAClB,aAAa;gBACb,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;gBAC5D,eAAe;gBACf,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/decorator/deco.names.d.ts

@@ -1,13 +1,98 @@
 import { DecoFileType, DecoNames, DecoTargetType } from "@mxpicture/gcp-functions-common/decorator";
+/**
+ * Renames a decorator base name by appending a capitalized type suffix.
+ *
+ * @param name - The original decorator name.
+ * @param type - The file type or arbitrary suffix to append.
+ * @returns The renamed string (e.g. `"Medication"` + `"doc"` → `"MedicationDoc"`).
+ */
 export declare const decoRename: (name: string, type: DecoFileType | string) => string;
+/**
+ * Async variant of {@link decoRename}.
+ *
+ * @param name - The original decorator name.
+ * @param type - The file type or arbitrary suffix to append.
+ * @returns A promise resolving to the renamed string.
+ */
 export declare const decoRenameAsync: (name: string, type: DecoFileType | string) => Promise<string>;
+/**
+ * Strips a known decorator file type suffix from a name to obtain the base name.
+ *
+ * @param name - The decorator name, possibly suffixed with a file type.
+ * @returns The base name without the type suffix.
+ */
 export declare const decoBasename: (name: string) => string;
+/**
+ * Async variant of {@link decoBasename}.
+ *
+ * @param name - The decorator name.
+ * @returns A promise resolving to the base name.
+ */
 export declare const decoBasenameAsync: (name: string) => Promise<string>;
+/**
+ * Checks whether a decorator name ends with the given file type suffix.
+ *
+ * @param name - The decorator name to test.
+ * @param type - The file type to check for.
+ * @returns `true` if `name` ends with the capitalized form of `type`.
+ */
 export declare const isDecoNameType: (name: string, type: DecoFileType) => boolean;
+/**
+ * Builds a full set of decorator names for code generation from a base name.
+ *
+ * @remarks
+ * Produces consistent naming for doc types, routes, stores, schemas, shapes,
+ * annotations, and Cloud Function names across all generators.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix for the function name.
+ * @param apiType - Optional API type suffix override.
+ * @param funcType - Optional function type suffix override.
+ * @param targetType - Target type; defaults to `DecoTargetType.common`.
+ * @returns A fully populated {@link DecoNames} object.
+ */
 export declare const decoNames: (basename: string, namespace?: string, apiType?: string, funcType?: string, targetType?: DecoTargetType) => DecoNames;
+/**
+ * Async variant of {@link decoNames}.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix for the function name.
+ * @param apiType - Optional API type suffix override.
+ * @param funcType - Optional function type suffix override.
+ * @param targetType - Target type; defaults to `DecoTargetType.common`.
+ * @returns A promise resolving to a fully populated {@link DecoNames} object.
+ */
 export declare const decoNamesAsync: (basename: string, namespace?: string, apiType?: string, funcType?: string, targetType?: DecoTargetType) => Promise<DecoNames>;
+/**
+ * Builds frontend-specific decorator names with `feApi`/`feFunction` suffixes.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A {@link DecoNames} object for the frontend target.
+ */
 export declare const decoFrontendNames: (basename: string, namespace?: string) => DecoNames;
+/**
+ * Async variant of {@link decoFrontendNames}.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A promise resolving to frontend-specific {@link DecoNames}.
+ */
 export declare const decoFrontendNamesAsync: (basename: string, namespace?: string) => Promise<DecoNames>;
+/**
+ * Builds backend-specific decorator names with `beApi`/`beFunction` suffixes.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A {@link DecoNames} object for the backend target.
+ */
 export declare const decoBackendNames: (basename: string, namespace?: string) => DecoNames;
+/**
+ * Async variant of {@link decoBackendNames}.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A promise resolving to backend-specific {@link DecoNames}.
+ */
 export declare const decoBackendNamesAsync: (basename: string, namespace?: string) => Promise<DecoNames>;
 //# sourceMappingURL=deco.names.d.ts.map

package/dist/decorator/deco.names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deco.names.d.ts","sourceRoot":"","sources":["../../src/decorator/deco.names.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,2CAA2C,CAAC;AAQnD,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,MAAM,YAAY,GAAG,MAAM,KAAG,MACrB,CAAC;AAEnD,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,EACZ,MAAM,YAAY,GAAG,MAAM,oBAO5B,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAM3C,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,MAAM,MAAM,oBACF,CAAC;AAEnD,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,MAAM,YAAY,KAAG,OAC3B,CAAC;AAExC,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,aAAa,cAAc,KAC1B,SAwBF,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,aAAa,cAAc,KAC1B,OAAO,CAAC,SAAS,CAkEnB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,cAOnE,CAAC;AAEJ,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,YAAY,MAAM,uBAQjB,CAAC;AAEJ,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,cACU,CAAC;AAEhF,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,EAChB,YAAY,MAAM,uBAQjB,CAAC"}
+{"version":3,"file":"deco.names.d.ts","sourceRoot":"","sources":["../../src/decorator/deco.names.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,2CAA2C,CAAC;AAQnD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,MAAM,YAAY,GAAG,MAAM,KAAG,MACrB,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,EACZ,MAAM,YAAY,GAAG,MAAM,oBAO5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAM3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAU,MAAM,MAAM,oBACF,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,MAAM,YAAY,KAAG,OAC3B,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,aAAa,cAAc,KAC1B,SAwBF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,aAAa,cAAc,KAC1B,OAAO,CAAC,SAAS,CAkEnB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,cAOnE,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,YAAY,MAAM,uBAQjB,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,cACU,CAAC;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,EAChB,YAAY,MAAM,uBAQjB,CAAC"}

package/dist/decorator/deco.names.js

@@ -1,6 +1,20 @@
 import { DecoFileType, DecoTargetType, } from "@mxpicture/gcp-functions-common/decorator";
 import { lowerFirstLetter, lowerFirstLetterAsync, upperFirstLetter, upperFirstLetterAsync, } from "../common/string.common.js";
+/**
+ * Renames a decorator base name by appending a capitalized type suffix.
+ *
+ * @param name - The original decorator name.
+ * @param type - The file type or arbitrary suffix to append.
+ * @returns The renamed string (e.g. `"Medication"` + `"doc"` → `"MedicationDoc"`).
+ */
 export const decoRename = (name, type) => `${decoBasename(name)}${upperFirstLetter(type)}`;
+/**
+ * Async variant of {@link decoRename}.
+ *
+ * @param name - The original decorator name.
+ * @param type - The file type or arbitrary suffix to append.
+ * @returns A promise resolving to the renamed string.
+ */
 export const decoRenameAsync = async (name, type) => {
     const [n, t] = await Promise.all([
         decoBasenameAsync(name),
@@ -8,6 +22,12 @@ export const decoRenameAsync = async (name, type) => {
     ]);
     return `${n}${t}`;
 };
+/**
+ * Strips a known decorator file type suffix from a name to obtain the base name.
+ *
+ * @param name - The decorator name, possibly suffixed with a file type.
+ * @returns The base name without the type suffix.
+ */
 export const decoBasename = (name) => {
     for (const type of Object.values(DecoFileType)) {
         if (isDecoNameType(name, type))
@@ -15,8 +35,35 @@ export const decoBasename = (name) => {
     }
     return name.substring(0);
 };
+/**
+ * Async variant of {@link decoBasename}.
+ *
+ * @param name - The decorator name.
+ * @returns A promise resolving to the base name.
+ */
 export const decoBasenameAsync = async (name) => Promise.resolve().then(() => decoBasename(name));
+/**
+ * Checks whether a decorator name ends with the given file type suffix.
+ *
+ * @param name - The decorator name to test.
+ * @param type - The file type to check for.
+ * @returns `true` if `name` ends with the capitalized form of `type`.
+ */
 export const isDecoNameType = (name, type) => name.endsWith(upperFirstLetter(type));
+/**
+ * Builds a full set of decorator names for code generation from a base name.
+ *
+ * @remarks
+ * Produces consistent naming for doc types, routes, stores, schemas, shapes,
+ * annotations, and Cloud Function names across all generators.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix for the function name.
+ * @param apiType - Optional API type suffix override.
+ * @param funcType - Optional function type suffix override.
+ * @param targetType - Target type; defaults to `DecoTargetType.common`.
+ * @returns A fully populated {@link DecoNames} object.
+ */
 export const decoNames = (basename, namespace, apiType, funcType, targetType) => {
     const basenameLower = lowerFirstLetter(basename);
     const basenameUpper = upperFirstLetter(basename);
@@ -42,6 +89,16 @@ export const decoNames = (basename, namespace, apiType, funcType, targetType) =>
             : basenameLower,
     };
 };
+/**
+ * Async variant of {@link decoNames}.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix for the function name.
+ * @param apiType - Optional API type suffix override.
+ * @param funcType - Optional function type suffix override.
+ * @param targetType - Target type; defaults to `DecoTargetType.common`.
+ * @returns A promise resolving to a fully populated {@link DecoNames} object.
+ */
 export const decoNamesAsync = async (basename, namespace, apiType, funcType, targetType) => {
     const [basenameLower, basenameUpper, 
     // template,
@@ -86,8 +143,36 @@ export const decoNamesAsync = async (basename, namespace, apiType, funcType, tar
         functionName,
     };
 };
+/**
+ * Builds frontend-specific decorator names with `feApi`/`feFunction` suffixes.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A {@link DecoNames} object for the frontend target.
+ */
 export const decoFrontendNames = (basename, namespace) => decoNames(basename, namespace, "feApi", "feFunction", DecoTargetType.frontend);
+/**
+ * Async variant of {@link decoFrontendNames}.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A promise resolving to frontend-specific {@link DecoNames}.
+ */
 export const decoFrontendNamesAsync = async (basename, namespace) => decoNamesAsync(basename, namespace, "feApi", "feFunction", DecoTargetType.frontend);
+/**
+ * Builds backend-specific decorator names with `beApi`/`beFunction` suffixes.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A {@link DecoNames} object for the backend target.
+ */
 export const decoBackendNames = (basename, namespace) => decoNames(basename, namespace, "beApi", "beFunction", DecoTargetType.backend);
+/**
+ * Async variant of {@link decoBackendNames}.
+ *
+ * @param basename - The base decorator name.
+ * @param namespace - Optional namespace prefix.
+ * @returns A promise resolving to backend-specific {@link DecoNames}.
+ */
 export const decoBackendNamesAsync = async (basename, namespace) => decoNamesAsync(basename, namespace, "beApi", "beFunction", DecoTargetType.backend);
 //# sourceMappingURL=deco.names.js.map