@aidc-toolkit/app-extension 1.0.52 → 1.0.53-beta

package/dist/generator/functions-generator.js

@@ -0,0 +1,179 @@
+import { Types } from "../descriptor.js";
+import { Generator } from "./generator.js";
+/**
+ * Generator with helpers for writing TypeScript functions file.
+ */
+export class FunctionsGenerator extends Generator {
+    /**
+     * Mapping of descriptor types to JavaScript types.
+     */
+    static #DESCRIPTOR_TYPE_STRINGS = {
+        [Types.String]: "string",
+        [Types.Number]: "number",
+        [Types.Boolean]: "boolean",
+        [Types.Any]: "any"
+    };
+    /**
+     * Dummy value passed to invocation context and streaming context parameters if context is not supported.
+     */
+    static #DUMMY_VALUE = "0";
+    static BASE_IMPORTS = [
+        "import * as AppExtension from \"@aidc-toolkit/app-extension\";",
+        "import { appExtension } from \"./app-extension.js\";"
+    ];
+    /**
+     * If true, functions are declared inline rather than using `function`.
+     */
+    #inline;
+    /**
+     * If true, application extension supports context.
+     */
+    #supportsContext;
+    /**
+     * Current class type alias.
+     */
+    #classTypeAlias;
+    /**
+     * Constructor.
+     *
+     * @param version
+     * Package version.
+     *
+     * @param inline
+     * If true, functions are declared inline rather than using `function`.
+     *
+     * @param supportsContext
+     * If true, application extension supports context.
+     */
+    constructor(version, inline, supportsContext) {
+        super(version, true);
+        this.#inline = inline;
+        this.#supportsContext = supportsContext;
+    }
+    /**
+     * Get the class type alias.
+     */
+    get classTypeAlias() {
+        return this.#classTypeAlias;
+    }
+    /**
+     * Get the import statement for a namespace.
+     *
+     * @param namespace
+     * Namespace.
+     *
+     * @returns
+     * Import statement.
+     */
+    getNamespaceImport(namespace) {
+        return `import * as AppExtension${namespace} from "@aidc-toolkit/app-extension/${namespace.toLowerCase()}";`;
+    }
+    /**
+     * @inheritDoc
+     */
+    createClassProxy(classDescriptor) {
+        const classDescriptorNamespace = classDescriptor.namespace ?? "";
+        const name = `${classDescriptorNamespace}${classDescriptor.name}`;
+        const getter = `get${name}()`;
+        const implementation = `AppExtension${classDescriptorNamespace}.${classDescriptor.name}`;
+        this.#classTypeAlias = {
+            name,
+            getter,
+            declaration: [
+                "",
+                "/**",
+                " * Class type alias name.",
+                " */",
+                `type ${name} = ${implementation};`,
+                "",
+                "/**",
+                " * Getter function to get an instance of the class.",
+                " *",
+                " * @returns",
+                " * Class instance.",
+                " */",
+                `function ${getter}: ${name} {`,
+                `    return appExtension.getProxy(${implementation});`,
+                "}"
+            ]
+        };
+    }
+    /**
+     * Get a function implementation.
+     *
+     * @param methodDescriptor
+     * Method descriptor.
+     *
+     * @param functionNamePrefix
+     * Function name prefix.
+     *
+     * @param functionLocalization
+     * Function localization. May be undefined for hidden functions, in which case generated
+     *
+     * @param parameterCallback
+     * Callback to modify parameter in implementation function call.
+     *
+     * @returns
+     * Function implementation.
+     */
+    getFunctionImplementation(methodDescriptor, functionNamePrefix, functionLocalization, parameterCallback) {
+        const methodType = `${this.classTypeAlias.name}["${methodDescriptor.name}"]`;
+        const parameterDescriptors = methodDescriptor.parameterDescriptors;
+        const parameterLocalizations = parameterDescriptors.map((parameterDescriptor) => {
+            const parameterLocalization = functionLocalization?.parametersMap.get(parameterDescriptor.name) ?? {
+                name: parameterDescriptor.name,
+                description: "*** NO LOCALIZATION ***"
+            };
+            return {
+                ...parameterLocalization,
+                javaScriptType: FunctionsGenerator.#DESCRIPTOR_TYPE_STRINGS[parameterDescriptor.type],
+                parameterDescriptor
+            };
+        });
+        const dummyParameters = [];
+        if (this.#supportsContext) {
+            if (methodDescriptor.requiresContext === true) {
+                parameterLocalizations.push({
+                    name: "invocationContext",
+                    description: "Invocation context.",
+                    javaScriptType: "InvocationContext"
+                });
+            }
+            if (methodDescriptor.isStream === true) {
+                parameterLocalizations.push({
+                    name: "streamingContext",
+                    description: "Streaming context.",
+                    javaScriptType: "StreamingContext"
+                });
+            }
+        }
+        else {
+            if (methodDescriptor.requiresContext === true) {
+                // Invocation context type name represents a literal dummy value.
+                dummyParameters.push(FunctionsGenerator.#DUMMY_VALUE);
+            }
+            if (methodDescriptor.isStream === true) {
+                // Streaming context type name represents a literal dummy value.
+                dummyParameters.push(FunctionsGenerator.#DUMMY_VALUE);
+            }
+        }
+        const asyncQualifier = methodDescriptor.isAsync === true ? "async " : "";
+        const functionName = functionNamePrefix === "" ?
+            functionLocalization?.name ?? methodDescriptor.name :
+            `${functionNamePrefix}${functionLocalization?.titleCaseName ?? methodDescriptor.name.replace(/^[a-z]/u, c => c.toUpperCase())}`;
+        return {
+            functionName,
+            parameterLocalizations,
+            declaration: [
+                `${!this.#inline ?
+                    `export ${asyncQualifier}function ${functionName}` :
+                    asyncQualifier}(${parameterLocalizations.map((parameterLocalization, index) => `${parameterLocalization.name}: Parameters<${methodType}>[${index}]`).join(", ")}): ReturnType<${methodType}> ${!this.#inline ? "{" : "=>"}`,
+                `    ${!this.#inline ? "return " : ""}${(this.classTypeAlias.getter)}.${methodDescriptor.name}(${[...parameterLocalizations.map(parameterLocalization => parameterCallback === undefined || parameterLocalization.parameterDescriptor === undefined ?
+                        parameterLocalization.name :
+                        parameterCallback(parameterLocalization.name, parameterLocalization.parameterDescriptor)), ...dummyParameters].join(", ")})${(!this.#inline ? ";" : "")}`,
+                ...!this.#inline ? ["}"] : []
+            ]
+        };
+    }
+}
+//# sourceMappingURL=functions-generator.js.map

package/dist/generator/functions-generator.js.map

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

package/dist/generator/generator.d.ts

@@ -0,0 +1,121 @@
+import { type Promisable } from "@aidc-toolkit/core";
+import type { Logger } from "tslog";
+import type { ClassDescriptor, MethodDescriptor } from "../descriptor.js";
+/**
+ * Localization.
+ */
+export interface Localization {
+    /**
+     * Name.
+     */
+    readonly name: string;
+    /**
+     * Description.
+     */
+    readonly description: string;
+}
+/**
+ * Function localization.
+ */
+export interface FunctionLocalization extends Localization {
+    /**
+     * Name in title case.
+     */
+    readonly titleCaseName: string;
+    /**
+     * Documentation URL.
+     */
+    readonly documentationURL: string;
+    /**
+     * Parameters map.
+     */
+    readonly parametersMap: ReadonlyMap<string, Localization>;
+}
+/**
+ * Abstract generator.
+ */
+export declare abstract class Generator {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param version
+     * Package version.
+     *
+     * @param includeLocalizations
+     * Include localizations if true.
+     */
+    constructor(version: string, includeLocalizations?: boolean);
+    /**
+     * Get the logger.
+     */
+    get logger(): Logger<object>;
+    /**
+     * Get the package version.
+     */
+    get version(): string;
+    /**
+     * Get the locales.
+     */
+    protected get locales(): readonly string[];
+    /**
+     * Get the default locale.
+     */
+    protected get defaultLocale(): string;
+    /**
+     * Initialize the generation of the output.
+     */
+    protected abstract initialize(): Promisable<void>;
+    /**
+     * Create a namespace.
+     *
+     * @param namespace
+     * Namespace.
+     */
+    protected abstract createNamespace(namespace: string | undefined): void;
+    /**
+     * Create a category.
+     *
+     * @param namespace
+     * Namespace.
+     *
+     * @param category
+     * Category.
+     *
+     * @param categoryLocalizationsMap
+     * Category localizations map.
+     */
+    protected abstract createCategory(namespace: string | undefined, category: string, categoryLocalizationsMap: ReadonlyMap<string, string>): void;
+    /**
+     * Create a proxy for a class.
+     *
+     * @param classDescriptor
+     * Class descriptor.
+     */
+    protected abstract createClassProxy(classDescriptor: ClassDescriptor): void;
+    /**
+     * Create a proxy for a method.
+     *
+     * @param classDescriptor
+     * Class descriptor.
+     *
+     * @param methodDescriptor
+     * Method descriptor.
+     *
+     * @param functionLocalizationsMap
+     * Function localizations map.
+     */
+    protected abstract createMethodProxy(classDescriptor: ClassDescriptor, methodDescriptor: MethodDescriptor, functionLocalizationsMap: ReadonlyMap<string, FunctionLocalization>): void;
+    /**
+     * Finalize the generation of the output.
+     *
+     * @param success
+     * True if successful.
+     */
+    protected abstract finalize(success: boolean): Promisable<void>;
+    /**
+     * Generate by processing individual imports.
+     */
+    generate(): Promise<void>;
+}
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,KAAK,UAAU,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAiB1E;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACtD;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,8BAAsB,SAAS;;IA0B3B;;;;;;;;OAQG;gBACS,OAAO,EAAE,MAAM,EAAE,oBAAoB,UAAO;IAOxD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAE3B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,SAAS,MAAM,EAAE,CAEzC;IAED;;OAEG;IACH,SAAS,KAAK,aAAa,IAAI,MAAM,CAEpC;IAED;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC;IAEjD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAEvE;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,wBAAwB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAE/I;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI;IAE3E;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAErL;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC;IAkC/D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAyGlC"}

package/dist/generator/generator.js

@@ -0,0 +1,186 @@
+import { ALPHA_URL, getLogger, I18nLanguageDetectors, isI18nParseKey, websiteURL } from "@aidc-toolkit/core";
+import { AppHelperProxy } from "../app-helper-proxy.js";
+import * as GS1 from "../gs1/index.js";
+import { appExtensionResourceBundle, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n.js";
+import { proxy } from "../proxy.js";
+import * as Utility from "../utility/index.js";
+/**
+ * Dummy method to force proxies to register their decorators.
+ *
+ * @param _proxies
+ * Proxies.
+ */
+function registerProxies(..._proxies) {
+}
+registerProxies(AppHelperProxy, Utility, GS1);
+/**
+ * Abstract generator.
+ */
+export class Generator {
+    /**
+     * Documentation path, optionally preceded by locale.
+     */
+    static #DOCUMENTATION_PATH = "app-extension/";
+    /**
+     * Logger.
+     */
+    #logger = getLogger();
+    /**
+     * Package version.
+     */
+    #version;
+    /**
+     * Locales.
+     */
+    #locales;
+    /**
+     * Default locale.
+     */
+    #defaultLocale;
+    /**
+     * Constructor.
+     *
+     * @param version
+     * Package version.
+     *
+     * @param includeLocalizations
+     * Include localizations if true.
+     */
+    constructor(version, includeLocalizations = true) {
+        this.#version = version;
+        this.#locales = includeLocalizations ? Object.keys(appExtensionResourceBundle) : [];
+        this.#defaultLocale = this.#locales[0] ?? "";
+    }
+    /**
+     * Get the logger.
+     */
+    get logger() {
+        return this.#logger;
+    }
+    /**
+     * Get the package version.
+     */
+    get version() {
+        return this.#version;
+    }
+    /**
+     * Get the locales.
+     */
+    get locales() {
+        return this.#locales;
+    }
+    /**
+     * Get the default locale.
+     */
+    get defaultLocale() {
+        return this.#defaultLocale;
+    }
+    /**
+     * Get a localization.
+     *
+     * @template TLocalization
+     * Localization type.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @param key
+     * Key.
+     *
+     * @param localizationCallback
+     * Callback to finalize localization.
+     *
+     * @returns
+     * Localization.
+     */
+    static #getLocalization(locale, key, localizationCallback) {
+        const lngReturnObjectsOption = {
+            lng: locale,
+            returnObjects: true
+        };
+        if (!isI18nParseKey(i18nextAppExtension, key, lngReturnObjectsOption)) {
+            throw new Error(`Missing localization for ${key} in ${locale}`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Return type is Localization & Partial<TLocalization>.
+        return localizationCallback(locale, i18nextAppExtension.t(key, lngReturnObjectsOption));
+    }
+    /**
+     * Generate by processing individual imports.
+     */
+    async generate() {
+        let success = false;
+        await i18nAppExtensionInit(I18nLanguageDetectors.CLI);
+        const documentationBaseURL = websiteURL(this.version, true, await ALPHA_URL);
+        await this.initialize();
+        const namespaceHierarchy = new Map();
+        // Organize class descriptors by namespace and category.
+        for (const classDescriptor of proxy.classDescriptors) {
+            const namespace = classDescriptor.namespace;
+            const category = classDescriptor.category;
+            let categoryHierarchy = namespaceHierarchy.get(namespace);
+            if (categoryHierarchy === undefined) {
+                categoryHierarchy = new Map();
+                namespaceHierarchy.set(namespace, categoryHierarchy);
+            }
+            let classDescriptors = categoryHierarchy.get(category);
+            if (classDescriptors === undefined) {
+                classDescriptors = [];
+                categoryHierarchy.set(category, classDescriptors);
+            }
+            classDescriptors.push(classDescriptor);
+        }
+        try {
+            for (const [namespace, categoryHierarchy] of namespaceHierarchy) {
+                const namespacePrefix = namespace === undefined ? "" : `${namespace}.`;
+                const namespacePath = namespace === undefined ? "" : `${namespace}/`;
+                this.createNamespace(namespace);
+                for (const [category, classDescriptors] of categoryHierarchy) {
+                    const categoryKey = `Categories.${category}`;
+                    const namespaceCategoryKey = `Categories.${namespacePrefix}${category}`;
+                    const categoryLocalizationsMap = new Map(this.locales.map((locale) => {
+                        const lngOption = {
+                            lng: locale
+                        };
+                        let key = namespaceCategoryKey;
+                        if (!isI18nParseKey(i18nextAppExtension, key)) {
+                            key = categoryKey;
+                            if (!isI18nParseKey(i18nextAppExtension, key, lngOption)) {
+                                throw new Error(`Missing localization for ${key} in ${locale}`);
+                            }
+                        }
+                        return [locale, i18nextAppExtension.t(key, lngOption)];
+                    }));
+                    this.createCategory(namespace, category, categoryLocalizationsMap);
+                    const namespaceClassNamesSet = new Set();
+                    for (const classDescriptor of classDescriptors) {
+                        const namespaceClassName = `${namespacePrefix}${classDescriptor.name}`;
+                        if (namespaceClassNamesSet.has(namespaceClassName)) {
+                            throw new Error(`Duplicate class ${namespaceClassName}`);
+                        }
+                        namespaceClassNamesSet.add(namespaceClassName);
+                        this.createClassProxy(classDescriptor);
+                        for (const methodDescriptor of classDescriptor.methodDescriptors) {
+                            const functionLocalizationsMap = new Map(methodDescriptor.isHidden !== true ?
+                                this.locales.map(locale => [locale, Generator.#getLocalization(locale, `Functions.${namespacePrefix}${methodDescriptor.functionName}`, (locale, localization) => ({
+                                        ...localization,
+                                        titleCaseName: localization.titleCaseName ?? localization.name.replace(/^[a-z]/u, c => c.toUpperCase()),
+                                        documentationURL: `${documentationBaseURL}/${locale === this.defaultLocale ? "" : `${locale}/`}${Generator.#DOCUMENTATION_PATH}${namespacePath}${localization.name}.html`,
+                                        parametersMap: new Map(methodDescriptor.parameterDescriptors.map(parameterDescriptor => 
+                                        // eslint-disable-next-line max-nested-callbacks -- Callback is empty.
+                                        [parameterDescriptor.name, Generator.#getLocalization(locale, `Parameters.${parameterDescriptor.name}`, (_locale, localization) => localization)]))
+                                    }))]) :
+                                // Hidden methods are not localized.
+                                []);
+                            this.createMethodProxy(classDescriptor, methodDescriptor, functionLocalizationsMap);
+                        }
+                    }
+                }
+            }
+            success = true;
+        }
+        finally {
+            await this.finalize(success);
+        }
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator/generator.js.map

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