@aidc-toolkit/app-extension 1.0.49 → 1.0.50-beta

package/dist/app-extension-options.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Application extension options. Never instantiated; used only as extension point for custom application extension
+ * options to define types.
+ */
+export interface AppExtensionOptions {
+    /**
+     * If true, errors are reported through the throw/catch mechanism.
+     */
+    ThrowError: boolean;
+    /**
+     * Application error.
+     */
+    ApplicationError: object;
+    /**
+     * Invocation context.
+     */
+    InvocationContext: unknown;
+    /**
+     * Streaming context.
+     */
+    StreamingContext: unknown;
+    /**
+     * Big integer representation.
+     */
+    BigInteger: number | bigint;
+}
+/**
+ * Custom application extension options.
+ */
+export interface CustomAppExtensionOptions extends AppExtensionOptions {
+}
+/**
+ * If true, errors are reported through the throw/catch mechanism.
+ */
+export type ThrowError = CustomAppExtensionOptions["ThrowError"];
+/**
+ * Application error type.
+ */
+export type ApplicationError = CustomAppExtensionOptions["ApplicationError"];
+/**
+ * Invocation context type.
+ */
+export type InvocationContext = CustomAppExtensionOptions["InvocationContext"];
+/**
+ * Streaming context type.
+ */
+export type StreamingContext = CustomAppExtensionOptions["StreamingContext"];
+/**
+ * Big integer representation type.
+ */
+export type BigInteger = CustomAppExtensionOptions["BigInteger"];
+//# sourceMappingURL=app-extension-options.d.ts.map

package/dist/app-extension-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-extension-options.d.ts","sourceRoot":"","sources":["../src/app-extension-options.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;CACrE;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC"}

package/dist/app-extension-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-extension-options.js.map

package/dist/app-extension-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-extension-options.js","sourceRoot":"","sources":["../src/app-extension-options.ts"],"names":[],"mappings":""}

package/dist/app-extension.d.ts

@@ -0,0 +1,194 @@
+import { type AppDataStorage, type HTTPFetch, type Hyperlink, MemoryTransport, type Promisable } from "@aidc-toolkit/core";
+import type { Logger } from "tslog";
+import type { ApplicationError, BigInteger, InvocationContext, StreamingContext, ThrowError } from "./app-extension-options.js";
+import type { LibProxy } from "./lib-proxy.js";
+import type { StreamingCancelledCallback, StreamingConsumerCallback } from "./streaming.js";
+import type { MatrixResult, SheetAddress, SheetRange, SingletonResult } from "./type.js";
+/**
+ * Application extension.
+ */
+export declare abstract class AppExtension {
+    #private;
+    /**
+     * Application name.
+     */
+    static readonly APPLICATION_NAME = "AIDCToolkit";
+    /**
+     * Version property name.
+     */
+    static readonly VERSION_NAME: string;
+    /**
+     * Constructor.
+     *
+     * @param version
+     * Application version.
+     *
+     * @param maximumSequenceCount
+     * Maximum sequence count supported by application.
+     *
+     * @param throwError
+     * If true, errors are reported through the throw/catch mechanism.
+     */
+    protected constructor(version: string, maximumSequenceCount: number, throwError: ThrowError);
+    /**
+     * Initialize the application extension.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the version.
+     *
+     * @returns
+     * Version.
+     */
+    get version(): string;
+    /**
+     * Determine if errors are reported through the throw/catch mechanism.
+     */
+    get throwError(): ThrowError;
+    /**
+     * Get the logger.
+     */
+    get logger(): Logger<object>;
+    /**
+     * Get the logger memory transport.
+     */
+    get memoryTransport(): MemoryTransport<object>;
+    /**
+     * Get the maximum width supported by the application.
+     */
+    abstract get maximumWidth(): number;
+    /**
+     * Get the maximum height supported by the application.
+     */
+    abstract get maximumHeight(): number;
+    /**
+     * Get a proxy instance. The use of a weak map ensures that proxies are loaded only as needed and may be garbage
+     * collected if required.
+     *
+     * @param ProxyConstructor
+     * Proxy constructor.
+     *
+     * @returns
+     * Proxy instance.
+     */
+    getProxy<T extends LibProxy>(ProxyConstructor: new (appExtension: AppExtension) => T): T;
+    /**
+     * Get the sheet address from an invocation context.
+     *
+     * @param invocationContext
+     * Invocation context.
+     *
+     * @returns
+     * Sheet address.
+     */
+    abstract getSheetAddress(invocationContext: InvocationContext): Promisable<SheetAddress>;
+    /**
+     * Get a parameter range from an invocation context.
+     *
+     * @param invocationContext
+     * Invocation context.
+     *
+     * @param parameterNumber
+     * Parameter number.
+     *
+     * @returns
+     * Sheet range or null if parameter is not a range.
+     */
+    abstract getParameterSheetRange(invocationContext: InvocationContext, parameterNumber: number): Promisable<SheetRange | null>;
+    /**
+     * Install a streaming function.
+     *
+     * @param streamingContext
+     * Streaming context.
+     *
+     * @param streamingCancelledCallback
+     * Streaming cancelled callback, called when streaming is cancelled.
+     *
+     * @returns
+     * Streaming consumer callback, called when stream contents updated.
+     */
+    abstract installStreaming<TResult>(streamingContext: StreamingContext, streamingCancelledCallback: StreamingCancelledCallback): StreamingConsumerCallback<TResult>;
+    /**
+     * Get a property stored within the active document.
+     *
+     * @param name
+     * Property name.
+     *
+     * @returns
+     * Property value or undefined if no value is stored under the given name.
+     */
+    abstract getDocumentProperty(name: string): Promisable<string | undefined>;
+    /**
+     * Set a property to be stored within the active document.
+     *
+     * @param name
+     * Property name.
+     *
+     * @param value
+     * Property value.
+     */
+    abstract setDocumentProperty(name: string, value: string): Promisable<void>;
+    /**
+     * Delete a property from the active document.
+     *
+     * @param name
+     * Property name.
+     */
+    abstract deleteDocumentProperty(name: string): Promisable<void>;
+    /**
+     * Get application data storage for the current document.
+     */
+    abstract get documentAppDataStorage(): AppDataStorage<boolean>;
+    /**
+     * Get application data storage shared across multiple documents.
+     */
+    abstract get sharedAppDataStorage(): AppDataStorage<boolean>;
+    /**
+     * Get HTTP fetch function.
+     */
+    abstract get httpFetch(): HTTPFetch;
+    /**
+     * Validate a sequence count against the maximum supported by application.
+     *
+     * @param sequenceCount
+     * Sequence count.
+     */
+    validateSequenceCount(sequenceCount: number): void;
+    /**
+     * Map a big integer to its representation type.
+     *
+     * @param value
+     * Big integer value to map.
+     *
+     * @returns
+     * Mapped big integer value.
+     */
+    abstract mapBigInt(value: bigint): SingletonResult<BigInteger>;
+    /**
+     * Map hyperlink results to a form suitable for the application.
+     *
+     * @param matrixHyperlinkResults
+     * Matrix of hyperlink results from function call.
+     *
+     * @returns
+     * Matrix of results in a form suitable for the application.
+     */
+    abstract mapHyperlinkResults(matrixHyperlinkResults: MatrixResult<Hyperlink>): Promisable<MatrixResult<unknown>>;
+    /**
+     * Map a range error (thrown by the library) to an application-specific error. If errors are reported through the
+     * throw/catch mechanism, the implementation may return the range error unmodified if that is supported.
+     *
+     * @param rangeError
+     * Range error.
+     */
+    abstract mapRangeError(rangeError: RangeError): ApplicationError;
+    /**
+     * Handle an error with a message; called when an exception occurs outside the control of the AIDC Toolkit library.
+     * Implementation must not return, most likely by throwing the message wrapped in an error type.
+     *
+     * @param message
+     * Message to include in the error.
+     */
+    abstract handleError(message: string): never;
+}
+//# sourceMappingURL=app-extension.d.ts.map

package/dist/app-extension.d.ts.map

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

package/dist/app-extension.js

@@ -0,0 +1,141 @@
+import { getLogger, LogLevels, MemoryTransport } from "@aidc-toolkit/core";
+import { i18nextAppExtension } from "./locale/i18n.js";
+/**
+ * Application extension.
+ */
+export class AppExtension {
+    /**
+     * Application name.
+     */
+    static APPLICATION_NAME = "AIDCToolkit";
+    /**
+     * Version property name.
+     */
+    static VERSION_NAME = `${AppExtension.APPLICATION_NAME}.version`;
+    /**
+     * Maximum logger messages length.
+     */
+    static #MAXIMUM_LOGGER_MESSAGES_LENGTH = 120;
+    /**
+     * Truncate logger messages length.
+     */
+    static #TRUNCATE_LOGGER_MESSAGES_LENGTH = 100;
+    /**
+     * Application version.
+     */
+    #version;
+    /**
+     * Maximum sequence count supported by application.
+     */
+    #maximumSequenceCount;
+    /**
+     * If true, errors are reported through the throw/catch mechanism.
+     */
+    #throwError;
+    /**
+     * Logger.
+     */
+    #logger;
+    /**
+     * Logger memory transport.
+     */
+    #memoryTransport;
+    /**
+     * Proxies map for lazy loading and memory management.
+     */
+    #proxiesMap = new WeakMap();
+    /**
+     * Constructor.
+     *
+     * @param version
+     * Application version.
+     *
+     * @param maximumSequenceCount
+     * Maximum sequence count supported by application.
+     *
+     * @param throwError
+     * If true, errors are reported through the throw/catch mechanism.
+     */
+    constructor(version, maximumSequenceCount, throwError) {
+        this.#version = version;
+        this.#maximumSequenceCount = maximumSequenceCount;
+        this.#throwError = throwError;
+        // Running in production if version doesn't include a pre-release identifier.
+        const isProduction = !version.includes("-");
+        this.#logger = getLogger(isProduction ? LogLevels.Info : LogLevels.Debug, {
+            type: isProduction ? "hidden" : "pretty"
+        });
+        this.#memoryTransport = new MemoryTransport(this.#logger, AppExtension.#MAXIMUM_LOGGER_MESSAGES_LENGTH, AppExtension.#TRUNCATE_LOGGER_MESSAGES_LENGTH);
+    }
+    /**
+     * Initialize the application extension.
+     */
+    async initialize() {
+        const fileVersion = await this.getDocumentProperty(AppExtension.VERSION_NAME);
+        if (fileVersion !== this.#version) {
+            await this.setDocumentProperty(AppExtension.VERSION_NAME, this.#version);
+        }
+    }
+    /**
+     * Get the version.
+     *
+     * @returns
+     * Version.
+     */
+    get version() {
+        return this.#version;
+    }
+    /**
+     * Determine if errors are reported through the throw/catch mechanism.
+     */
+    get throwError() {
+        return this.#throwError;
+    }
+    /**
+     * Get the logger.
+     */
+    get logger() {
+        return this.#logger;
+    }
+    /**
+     * Get the logger memory transport.
+     */
+    get memoryTransport() {
+        return this.#memoryTransport;
+    }
+    /**
+     * Get a proxy instance. The use of a weak map ensures that proxies are loaded only as needed and may be garbage
+     * collected if required.
+     *
+     * @param ProxyConstructor
+     * Proxy constructor.
+     *
+     * @returns
+     * Proxy instance.
+     */
+    getProxy(ProxyConstructor) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type is managed in this method.
+        let proxy = this.#proxiesMap.get(ProxyConstructor);
+        if (proxy === undefined) {
+            proxy = new ProxyConstructor(this);
+            this.#proxiesMap.set(ProxyConstructor, proxy);
+        }
+        return proxy;
+    }
+    /**
+     * Validate a sequence count against the maximum supported by application.
+     *
+     * @param sequenceCount
+     * Sequence count.
+     */
+    validateSequenceCount(sequenceCount) {
+        const absoluteSequenceCount = Math.abs(sequenceCount);
+        if (absoluteSequenceCount > this.#maximumSequenceCount) {
+            throw new RangeError(i18nextAppExtension.t("AppExtension.sequenceCountMustBeLessThanOrEqualTo", {
+                sequenceCount: absoluteSequenceCount,
+                maximumSequenceCount: this.#maximumSequenceCount
+            }));
+        }
+    }
+}
+//# sourceMappingURL=app-extension.js.map

package/dist/app-extension.js.map

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

package/dist/app-helper-proxy.d.ts

@@ -0,0 +1,57 @@
+import { type Nullishable } from "@aidc-toolkit/core";
+import type { InvocationContext, StreamingContext } from "./app-extension-options.js";
+import { LibProxy } from "./lib-proxy.js";
+import type { Matrix, MatrixResult } from "./type.js";
+/**
+ * Application helper.
+ */
+export declare class AppHelperProxy extends LibProxy {
+    #private;
+    /**
+     * Get the version.
+     *
+     * @returns
+     * Version.
+     */
+    version(): string;
+    /**
+     * Spill a one-dimensional matrix to fit a rectangle within a given maximum height and width.
+     *
+     * @param arrayValues
+     * Matrix values. Matrix is length 1 or contains arrays of length 1 with the values.
+     *
+     * @param maximumHeight
+     * Maximum height.
+     *
+     * @param maximumWidth
+     * Maximum width.
+     *
+     * @param invocationContext
+     * Invocation context.
+     *
+     * @returns
+     * Matrix spilled within maximum height and maximum width.
+     */
+    spill(arrayValues: Matrix<unknown>, maximumHeight: Nullishable<number>, maximumWidth: Nullishable<number>, invocationContext: Nullishable<InvocationContext>): Promise<MatrixResult<unknown>>;
+    /**
+     * Get the logger messages. This is a snapshot, with the option to change the log level for the next call.
+     *
+     * @param logLevelString
+     * Log level as string.
+     *
+     * @returns
+     * Logger messages.
+     */
+    loggerMessages(logLevelString: Nullishable<string>): MatrixResult<string>;
+    /**
+     * Get the logger messages as a stream.
+     *
+     * @param logLevelString
+     * Log level as string.
+     *
+     * @param streamingContext
+     * Streaming context.
+     */
+    loggerStream(logLevelString: Nullishable<string>, streamingContext: Nullishable<StreamingContext>): void;
+}
+//# sourceMappingURL=app-helper-proxy.d.ts.map

package/dist/app-helper-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-helper-proxy.d.ts","sourceRoot":"","sources":["../src/app-helper-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAkDtD;;GAEG;AACH,qBAGa,cAAe,SAAQ,QAAQ;;IAGxC;;;;;OAKG;IAMH,OAAO,IAAI,MAAM;IA6CjB;;;;;;;;;;;;;;;;;OAiBG;IAQG,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IA4GnM;;;;;;;;OAQG;IAOH,cAAc,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;IAqBzE;;;;;;;;OAQG;IAQH,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,GAAG,IAAI;CA8C3G"}