@memberjunction/excel-addin-server 0.0.0 → 6.2.0-edge.7

package/dist/operations.js

@@ -0,0 +1,160 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview Server bodies of the `ExcelAddin.*` Remote Operations.
+ *
+ * Each subclass extends the typed base from `@memberjunction/excel-addin` and registers under the
+ * same key, so a browser's `new ExcelAddinBuildWorkbookOperation().Execute(...)` or the Excel
+ * pane's `ExecuteRemoteOperation` GraphQL mutation lands here. All operations read
+ * {@link ExcelAddinRuntime}: on a host whose Server Extension isn't configured, status says the
+ * add-in is off and the other operations refuse.
+ *
+ * @module @memberjunction/excel-addin-server
+ */
+import { BaseRemotableOperation } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { EXCEL_WORKBOOK_CONTRACT_VERSION, ExcelAddinBuildWorkbookOperation, ExcelAddinCreateConnectionOperation, ExcelAddinGetCatalogOperation, ExcelAddinGetEntityViewsOperation, ExcelAddinGetStatusOperation, ExcelAddinResolveSourceOperation, } from '@memberjunction/excel-addin';
+import { BuildExcelCatalog, LoadExcelEntityViews } from './catalog.js';
+import { CreateExcelConnectionKey } from './connection.js';
+import { ExcelAddinRuntime } from './runtime.js';
+import { ResolveSingleWorkbookSource, ResolveWorkbookSources } from './sources.js';
+import { BuildConnectedWorkbook } from './workbook-builder.js';
+const MAX_FILE_NAME_LENGTH = 100;
+/** Reports whether this host serves the Excel add-in. */
+let ExcelAddinGetStatusServerOperation = class ExcelAddinGetStatusServerOperation extends ExcelAddinGetStatusOperation {
+    async InternalExecute(_input, _provider, _user) {
+        const runtime = ExcelAddinRuntime.Instance;
+        const settings = runtime.Settings;
+        if (!runtime.IsEnabled || !settings) {
+            return { Enabled: false, ServerName: '', ConnectedPageUrl: '', ManifestUrl: '', KeyLifetimeDays: 0 };
+        }
+        return {
+            Enabled: true,
+            ServerName: settings.ServerName,
+            ConnectedPageUrl: runtime.ConnectedPageUrl,
+            ManifestUrl: runtime.ManifestUrl,
+            KeyLifetimeDays: settings.KeyLifetimeDays,
+        };
+    }
+};
+ExcelAddinGetStatusServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'ExcelAddin.GetStatus')
+], ExcelAddinGetStatusServerOperation);
+export { ExcelAddinGetStatusServerOperation };
+/** Mints the caller's Excel connection key. */
+let ExcelAddinCreateConnectionServerOperation = class ExcelAddinCreateConnectionServerOperation extends ExcelAddinCreateConnectionOperation {
+    async Authorize(_input, _user) {
+        return ExcelAddinRuntime.Instance.IsEnabled;
+    }
+    async InternalExecute(_input, provider, user) {
+        const settings = ExcelAddinRuntime.Instance.RequireSettings();
+        const key = await CreateExcelConnectionKey(user, provider, settings.KeyLifetimeDays);
+        return { APIKey: key.APIKey, APIKeyID: key.APIKeyID, ExpiresAt: key.ExpiresAt.toISOString(), Label: key.Label };
+    }
+};
+ExcelAddinCreateConnectionServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'ExcelAddin.CreateConnection')
+], ExcelAddinCreateConnectionServerOperation);
+export { ExcelAddinCreateConnectionServerOperation };
+/** Builds a connected workbook (headings, no rows) for saved views, entities, and queries the caller can see. */
+let ExcelAddinBuildWorkbookServerOperation = class ExcelAddinBuildWorkbookServerOperation extends ExcelAddinBuildWorkbookOperation {
+    async Authorize(_input, _user) {
+        return ExcelAddinRuntime.Instance.IsEnabled;
+    }
+    async InternalExecute(input, provider, user) {
+        const runtime = ExcelAddinRuntime.Instance;
+        const settings = runtime.RequireSettings();
+        const sources = await ResolveWorkbookSources(input?.Sources ?? [], provider, user);
+        const manifest = {
+            ContractVersion: EXCEL_WORKBOOK_CONTRACT_VERSION,
+            ServerName: settings.ServerName,
+            AddinUrl: runtime.AddinUrl,
+            GeneratedAt: new Date().toISOString(),
+            Sources: sources,
+        };
+        const workbook = await BuildConnectedWorkbook(manifest, {
+            AddinId: settings.AddinId,
+            Version: settings.Version,
+            Store: settings.Store,
+            StoreType: settings.StoreType,
+        });
+        return { FileName: MakeWorkbookFileName(sources), ContentBase64: workbook.toString('base64') };
+    }
+};
+ExcelAddinBuildWorkbookServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'ExcelAddin.BuildWorkbook')
+], ExcelAddinBuildWorkbookServerOperation);
+export { ExcelAddinBuildWorkbookServerOperation };
+/** Lists the applications, readable entities, query categories, and runnable queries for the Excel picker. */
+let ExcelAddinGetCatalogServerOperation = class ExcelAddinGetCatalogServerOperation extends ExcelAddinGetCatalogOperation {
+    async Authorize(_input, _user) {
+        return ExcelAddinRuntime.Instance.IsEnabled;
+    }
+    async InternalExecute(_input, provider, user) {
+        ExcelAddinRuntime.Instance.RequireSettings();
+        return BuildExcelCatalog(provider, user);
+    }
+};
+ExcelAddinGetCatalogServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'ExcelAddin.GetCatalog')
+], ExcelAddinGetCatalogServerOperation);
+export { ExcelAddinGetCatalogServerOperation };
+/** Lists the accessible saved `MJ: User Views` records on a chosen entity for the Excel picker. */
+let ExcelAddinGetEntityViewsServerOperation = class ExcelAddinGetEntityViewsServerOperation extends ExcelAddinGetEntityViewsOperation {
+    async Authorize(_input, _user) {
+        return ExcelAddinRuntime.Instance.IsEnabled;
+    }
+    async InternalExecute(input, provider, user) {
+        ExcelAddinRuntime.Instance.RequireSettings();
+        return LoadExcelEntityViews(input?.EntityID ?? '', provider, user);
+    }
+};
+ExcelAddinGetEntityViewsServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'ExcelAddin.GetEntityViews')
+], ExcelAddinGetEntityViewsServerOperation);
+export { ExcelAddinGetEntityViewsServerOperation };
+/** Resolves a single chosen view, entity, or saved query into its canonical columns and checked parameters. */
+let ExcelAddinResolveSourceServerOperation = class ExcelAddinResolveSourceServerOperation extends ExcelAddinResolveSourceOperation {
+    async Authorize(_input, _user) {
+        return ExcelAddinRuntime.Instance.IsEnabled;
+    }
+    async InternalExecute(input, provider, user) {
+        ExcelAddinRuntime.Instance.RequireSettings();
+        const source = await ResolveSingleWorkbookSource(input?.Source, provider, user);
+        return { Source: source };
+    }
+};
+ExcelAddinResolveSourceServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'ExcelAddin.ResolveSource')
+], ExcelAddinResolveSourceServerOperation);
+export { ExcelAddinResolveSourceServerOperation };
+/** A file name safe on every desktop platform, from the first source's name. */
+export function MakeWorkbookFileName(sources) {
+    const first = sources[0]?.Name ?? '';
+    // Drop characters Windows, macOS or a browser download refuse, and control characters.
+    const collapsed = Array.from(first)
+        .filter(ch => ch.charCodeAt(0) >= 32 && !'\\/:*?"<>|'.includes(ch))
+        .join('')
+        .replace(/\s+/g, ' ');
+    const cleaned = trimDotsAndWhitespace(collapsed)
+        .slice(0, MAX_FILE_NAME_LENGTH)
+        .trim();
+    const base = cleaned || 'MemberJunction';
+    return sources.length > 1 ? `${base} and ${sources.length - 1} more.xlsx` : `${base}.xlsx`;
+}
+function trimDotsAndWhitespace(value) {
+    let start = 0;
+    let end = value.length;
+    while (start < end && (value[start] === '.' || value[start].trim() === '')) {
+        start++;
+    }
+    while (end > start && (value[end - 1] === '.' || value[end - 1].trim() === '')) {
+        end--;
+    }
+    return value.slice(start, end);
+}
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview The Excel add-in's process-wide state: whether this host serves it, with which
+ * settings, and at which public URL.
+ *
+ * The Server Extension configures it when it mounts; the Remote Operations read it. An operation
+ * running on a host that never configured the extension sees `IsEnabled === false` and reports the
+ * add-in as off, which is how a host with the package installed but not configured behaves.
+ *
+ * @module @memberjunction/excel-addin-server
+ */
+import { BaseSingleton } from '@memberjunction/global';
+import type { ExcelAddinSettings } from './settings.js';
+/** The Explorer route that runs the add-in's sign-in. */
+export declare const EXCEL_CONNECT_ROUTE = "/office/connect";
+/** The add-in's pages and files, relative to its base URL. */
+export declare const EXCEL_ADDIN_PATHS: {
+    readonly Manifest: "/manifest.xml";
+    readonly Config: "/config.json";
+    readonly Taskpane: "/taskpane.html";
+    readonly ConnectStart: "/connect.html";
+    readonly Connected: "/connected.html";
+    readonly Assets: "/assets";
+};
+/** Holds the add-in's settings and public URL once the Server Extension has mounted. */
+export declare class ExcelAddinRuntime extends BaseSingleton<ExcelAddinRuntime> {
+    private settings;
+    private addinUrl;
+    constructor();
+    static get Instance(): ExcelAddinRuntime;
+    /** Turns the add-in on with these settings, served at `addinUrl`. */
+    Configure(settings: ExcelAddinSettings, addinUrl: string): void;
+    /** Turns the add-in off. */
+    Reset(): void;
+    /** True once the Server Extension has mounted. */
+    get IsEnabled(): boolean;
+    /** The settings, or null when the add-in is off. */
+    get Settings(): ExcelAddinSettings | null;
+    /** The add-in's public base URL, or `''` when off. */
+    get AddinUrl(): string;
+    get ManifestUrl(): string;
+    get ConfigUrl(): string;
+    get TaskpaneUrl(): string;
+    /** The add-in page the sign-in window opens first. */
+    get ConnectStartUrl(): string;
+    /** The add-in page Explorer's connect page returns to. */
+    get ConnectedPageUrl(): string;
+    /** Explorer's connect page, or `''` when off. */
+    get ExplorerConnectUrl(): string;
+    /** The settings; throws when the add-in is off. */
+    RequireSettings(): ExcelAddinSettings;
+    private urlFor;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAuB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAEX,wFAAwF;AACxF,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAM;;IAOtB,WAAkB,QAAQ,IAAI,iBAAiB,CAE9C;IAED,qEAAqE;IAC9D,SAAS,CAAC,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKtE,4BAA4B;IACrB,KAAK,IAAI,IAAI;IAKpB,kDAAkD;IAClD,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,oDAAoD;IACpD,IAAW,QAAQ,IAAI,kBAAkB,GAAG,IAAI,CAE/C;IAED,sDAAsD;IACtD,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,sDAAsD;IACtD,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,0DAA0D;IAC1D,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,iDAAiD;IACjD,IAAW,kBAAkB,IAAI,MAAM,CAEtC;IAED,mDAAmD;IAC5C,eAAe,IAAI,kBAAkB;IAO5C,OAAO,CAAC,MAAM;CAGjB"}

package/dist/runtime.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview The Excel add-in's process-wide state: whether this host serves it, with which
+ * settings, and at which public URL.
+ *
+ * The Server Extension configures it when it mounts; the Remote Operations read it. An operation
+ * running on a host that never configured the extension sees `IsEnabled === false` and reports the
+ * add-in as off, which is how a host with the package installed but not configured behaves.
+ *
+ * @module @memberjunction/excel-addin-server
+ */
+import { BaseSingleton, TrimTrailingSlashes } from '@memberjunction/global';
+/** The Explorer route that runs the add-in's sign-in. */
+export const EXCEL_CONNECT_ROUTE = '/office/connect';
+/** The add-in's pages and files, relative to its base URL. */
+export const EXCEL_ADDIN_PATHS = {
+    Manifest: '/manifest.xml',
+    Config: '/config.json',
+    Taskpane: '/taskpane.html',
+    ConnectStart: '/connect.html',
+    Connected: '/connected.html',
+    Assets: '/assets',
+};
+/** Holds the add-in's settings and public URL once the Server Extension has mounted. */
+export class ExcelAddinRuntime extends BaseSingleton {
+    // Public: BaseSingleton.getInstance is typed `this: new () => T`, which a protected constructor can't satisfy.
+    constructor() {
+        super();
+        this.settings = null;
+        this.addinUrl = '';
+    }
+    static get Instance() {
+        return ExcelAddinRuntime.getInstance();
+    }
+    /** Turns the add-in on with these settings, served at `addinUrl`. */
+    Configure(settings, addinUrl) {
+        this.settings = settings;
+        this.addinUrl = TrimTrailingSlashes(addinUrl);
+    }
+    /** Turns the add-in off. */
+    Reset() {
+        this.settings = null;
+        this.addinUrl = '';
+    }
+    /** True once the Server Extension has mounted. */
+    get IsEnabled() {
+        return this.settings !== null && this.addinUrl !== '';
+    }
+    /** The settings, or null when the add-in is off. */
+    get Settings() {
+        return this.settings;
+    }
+    /** The add-in's public base URL, or `''` when off. */
+    get AddinUrl() {
+        return this.addinUrl;
+    }
+    get ManifestUrl() {
+        return this.urlFor(EXCEL_ADDIN_PATHS.Manifest);
+    }
+    get ConfigUrl() {
+        return this.urlFor(EXCEL_ADDIN_PATHS.Config);
+    }
+    get TaskpaneUrl() {
+        return this.urlFor(EXCEL_ADDIN_PATHS.Taskpane);
+    }
+    /** The add-in page the sign-in window opens first. */
+    get ConnectStartUrl() {
+        return this.urlFor(EXCEL_ADDIN_PATHS.ConnectStart);
+    }
+    /** The add-in page Explorer's connect page returns to. */
+    get ConnectedPageUrl() {
+        return this.urlFor(EXCEL_ADDIN_PATHS.Connected);
+    }
+    /** Explorer's connect page, or `''` when off. */
+    get ExplorerConnectUrl() {
+        return this.settings ? `${TrimTrailingSlashes(this.settings.ExplorerUrl)}${EXCEL_CONNECT_ROUTE}` : '';
+    }
+    /** The settings; throws when the add-in is off. */
+    RequireSettings() {
+        if (!this.settings || !this.IsEnabled) {
+            throw new Error('The Excel add-in is not enabled on this server.');
+        }
+        return this.settings;
+    }
+    urlFor(path) {
+        return this.IsEnabled ? `${this.addinUrl}${path}` : '';
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG5E,yDAAyD;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,gBAAgB;IAC1B,YAAY,EAAE,eAAe;IAC7B,SAAS,EAAE,iBAAiB;IAC5B,MAAM,EAAE,SAAS;CACX,CAAC;AAEX,wFAAwF;AACxF,MAAM,OAAO,iBAAkB,SAAQ,aAAgC;IAInE,+GAA+G;IAC/G;QACI,KAAK,EAAE,CAAC;QALJ,aAAQ,GAA8B,IAAI,CAAC;QAC3C,aAAQ,GAAG,EAAE,CAAC;IAKtB,CAAC;IAEM,MAAM,KAAK,QAAQ;QACtB,OAAO,iBAAiB,CAAC,WAAW,EAAqB,CAAC;IAC9D,CAAC;IAED,qEAAqE;IAC9D,SAAS,CAAC,QAA4B,EAAE,QAAgB;QAC3D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,4BAA4B;IACrB,KAAK;QACR,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,kDAAkD;IAClD,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;IAC1D,CAAC;IAED,oDAAoD;IACpD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,sDAAsD;IACtD,IAAW,eAAe;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;IAED,0DAA0D;IAC1D,IAAW,gBAAgB;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,iDAAiD;IACjD,IAAW,kBAAkB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1G,CAAC;IAED,mDAAmD;IAC5C,eAAe;QAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,CAAC;CACJ"}

package/dist/settings.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The add-in's identity in Office. Every MJ host serves the same add-in, so the default is one fixed
+ * GUID; a host that deploys a second, differently configured copy to the same Microsoft 365 tenant
+ * sets its own `AddinId`.
+ */
+export declare const DEFAULT_EXCEL_ADDIN_ID = "AAEB4761-75CC-4DB1-99BD-7790FAD307C6";
+/** The add-in version written into the manifest and every workbook (Office's four-part form). */
+export declare const DEFAULT_EXCEL_ADDIN_VERSION = "1.0.0.0";
+/** How long a connection key lasts by default, in days. */
+export declare const DEFAULT_EXCEL_KEY_LIFETIME_DAYS = 90;
+/** The most rows the pane writes for one source by default. */
+export declare const DEFAULT_EXCEL_MAX_ROWS = 100000;
+/**
+ * Where the workbook says the add-in is deployed. `EXCatalog` is Microsoft 365 centralized
+ * deployment (the admin center), which this package documents.
+ */
+export declare const DEFAULT_EXCEL_STORE_TYPE = "EXCatalog";
+/** The add-in's settings, after validation and defaults. */
+export interface ExcelAddinSettings {
+    /** Where MJ Explorer runs; the add-in's sign-in window opens its `/office/connect` page. */
+    ExplorerUrl: string;
+    /** The host's name, shown in Excel and on the connect page. */
+    ServerName: string;
+    /** The add-in's GUID in the manifest and in every workbook. */
+    AddinId: string;
+    /** The add-in's version in the manifest and in every workbook. */
+    Version: string;
+    /** How long a connection key lasts. */
+    KeyLifetimeDays: number;
+    /** The `store` a workbook names for the add-in. */
+    Store: string;
+    /** The `storeType` a workbook names for the add-in. */
+    StoreType: string;
+    /** The most rows the pane writes for one source. */
+    MaxRows: number;
+}
+/** The outcome of {@link ParseExcelAddinSettings}. */
+export interface ParseExcelAddinSettingsResult {
+    Success: boolean;
+    Settings?: ExcelAddinSettings;
+    ErrorMessage?: string;
+}
+/**
+ * Validates a host's settings and fills in defaults. Never throws: a problem returns
+ * `Success: false` with a message naming the setting.
+ */
+export declare function ParseExcelAddinSettings(raw: Record<string, unknown> | null | undefined): ParseExcelAddinSettingsResult;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,yCAAyC,CAAC;AAE7E,iGAAiG;AACjG,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD,2DAA2D;AAC3D,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,cAAc,CAAC;AASpD,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IAC/B,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,6BAA6B,CA8BtH"}

package/dist/settings.js

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview The Excel add-in's settings, as a host writes them in `mj.config.cjs`
+ * (`serverExtensions[].Settings`), and their validation.
+ *
+ * @module @memberjunction/excel-addin-server
+ */
+import { IsValidUUID, TrimTrailingSlashes } from '@memberjunction/global';
+/**
+ * The add-in's identity in Office. Every MJ host serves the same add-in, so the default is one fixed
+ * GUID; a host that deploys a second, differently configured copy to the same Microsoft 365 tenant
+ * sets its own `AddinId`.
+ */
+export const DEFAULT_EXCEL_ADDIN_ID = 'AAEB4761-75CC-4DB1-99BD-7790FAD307C6';
+/** The add-in version written into the manifest and every workbook (Office's four-part form). */
+export const DEFAULT_EXCEL_ADDIN_VERSION = '1.0.0.0';
+/** How long a connection key lasts by default, in days. */
+export const DEFAULT_EXCEL_KEY_LIFETIME_DAYS = 90;
+/** The most rows the pane writes for one source by default. */
+export const DEFAULT_EXCEL_MAX_ROWS = 100000;
+/**
+ * Where the workbook says the add-in is deployed. `EXCatalog` is Microsoft 365 centralized
+ * deployment (the admin center), which this package documents.
+ */
+export const DEFAULT_EXCEL_STORE_TYPE = 'EXCatalog';
+const MIN_KEY_LIFETIME_DAYS = 1;
+const MAX_KEY_LIFETIME_DAYS = 365;
+/** Excel holds 1,048,576 rows; one is the heading. */
+const MAX_ROWS_LIMIT = 1048575;
+const MAX_TEXT_LENGTH = 200;
+const VERSION_PATTERN = /^\d{1,5}(\.\d{1,5}){0,3}$/;
+/**
+ * Validates a host's settings and fills in defaults. Never throws: a problem returns
+ * `Success: false` with a message naming the setting.
+ */
+export function ParseExcelAddinSettings(raw) {
+    const settings = raw ?? {};
+    const explorerUrl = parseExplorerUrl(settings.ExplorerUrl);
+    if (!explorerUrl) {
+        return fail('Settings.ExplorerUrl is required: the http(s) address where MJ Explorer runs.');
+    }
+    const addinId = settings.AddinId ?? DEFAULT_EXCEL_ADDIN_ID;
+    if (typeof addinId !== 'string' || !IsValidUUID(addinId)) {
+        return fail('Settings.AddinId must be a GUID.');
+    }
+    const version = settings.Version ?? DEFAULT_EXCEL_ADDIN_VERSION;
+    if (typeof version !== 'string' || !VERSION_PATTERN.test(version)) {
+        return fail('Settings.Version must look like 1.0.0.0.');
+    }
+    const lifetime = parseInteger(settings.KeyLifetimeDays, DEFAULT_EXCEL_KEY_LIFETIME_DAYS, MIN_KEY_LIFETIME_DAYS, MAX_KEY_LIFETIME_DAYS);
+    if (lifetime === null) {
+        return fail(`Settings.KeyLifetimeDays must be a whole number from ${MIN_KEY_LIFETIME_DAYS} to ${MAX_KEY_LIFETIME_DAYS}.`);
+    }
+    const maxRows = parseInteger(settings.MaxRows, DEFAULT_EXCEL_MAX_ROWS, 1, MAX_ROWS_LIMIT);
+    if (maxRows === null) {
+        return fail(`Settings.MaxRows must be a whole number from 1 to ${MAX_ROWS_LIMIT}.`);
+    }
+    const texts = parseTexts(settings);
+    if (typeof texts === 'string') {
+        return fail(texts);
+    }
+    return {
+        Success: true,
+        Settings: { ExplorerUrl: explorerUrl, AddinId: addinId.toUpperCase(), Version: version, KeyLifetimeDays: lifetime, MaxRows: maxRows, ...texts },
+    };
+}
+function parseTexts(settings) {
+    const serverName = parseText(settings.ServerName, 'MemberJunction');
+    const storeType = parseText(settings.StoreType, DEFAULT_EXCEL_STORE_TYPE);
+    const store = parseText(settings.Store, typeof storeType === 'string' ? storeType : DEFAULT_EXCEL_STORE_TYPE);
+    if (serverName === null) {
+        return `Settings.ServerName must be text of 1 to ${MAX_TEXT_LENGTH} characters.`;
+    }
+    if (storeType === null || store === null) {
+        return `Settings.Store and Settings.StoreType must be text of 1 to ${MAX_TEXT_LENGTH} characters.`;
+    }
+    return { ServerName: serverName, Store: store, StoreType: storeType };
+}
+function parseExplorerUrl(value) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return null;
+    }
+    try {
+        const url = new URL(value.trim());
+        if (url.protocol !== 'https:' && url.protocol !== 'http:') {
+            return null;
+        }
+        return TrimTrailingSlashes(url.toString());
+    }
+    catch {
+        return null;
+    }
+}
+function parseInteger(value, fallback, min, max) {
+    if (value === undefined || value === null) {
+        return fallback;
+    }
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < min || value > max) {
+        return null;
+    }
+    return value;
+}
+function parseText(value, fallback) {
+    if (value === undefined || value === null) {
+        return fallback;
+    }
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed && trimmed.length <= MAX_TEXT_LENGTH ? trimmed : null;
+}
+function fail(message) {
+    return { Success: false, ErrorMessage: message };
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/sources.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Resolves the saved views, entities, and saved queries an Open in Excel or in-pane
+ * picker request names into workbook sources: their names, columns and data types, and a query's
+ * checked parameter values.
+ *
+ * Everything is read AS the caller, so a view, entity, or query they can't see is refused here,
+ * before a workbook or sheet exists. This reads metadata only (no rows); the add-in pane fetches
+ * rows later, as whoever opens the file, through GraphQL operations that check permissions again.
+ *
+ * @module @memberjunction/excel-addin-server
+ */
+import { EntityFieldInfo, IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { ExcelColumnDataType, ExcelResolvedWorkbookSource, ExcelWorkbookSource, ExcelWorkbookSourceRequest } from '@memberjunction/excel-addin';
+/** A refusal whose message is safe to show the person who asked. */
+export declare class ExcelSourceError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolves and checks every requested source, in order. Throws {@link ExcelSourceError} for the
+ * first one the caller can't use.
+ */
+export declare function ResolveWorkbookSources(requests: ExcelWorkbookSourceRequest[], provider: IMetadataProvider, user: UserInfo): Promise<ExcelWorkbookSource[]>;
+/**
+ * Resolves and authorizes a single view, entity, or saved query request for `user`.
+ */
+export declare function ResolveSingleWorkbookSource(request: ExcelWorkbookSourceRequest, provider: IMetadataProvider, user: UserInfo): Promise<ExcelResolvedWorkbookSource>;
+/** The data type the pane uses for an entity field's values. */
+export declare function DataTypeForEntityField(field: EntityFieldInfo): ExcelColumnDataType;
+/** The data type the pane uses for a query field, from its SQL base type; `Text` when unknown. */
+export declare function DataTypeForSQLType(sqlType: string | null | undefined): ExcelColumnDataType;
+//# sourceMappingURL=sources.d.ts.map

package/dist/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../src/sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACH,eAAe,EAGf,iBAAiB,EAKjB,QAAQ,EACX,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEH,mBAAmB,EAEnB,2BAA2B,EAE3B,mBAAmB,EACnB,0BAA0B,EAE7B,MAAM,6BAA6B,CAAC;AAErC,oEAAoE;AACpE,qBAAa,gBAAiB,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI9B;AAID;;;GAGG;AACH,wBAAsB,sBAAsB,CACxC,QAAQ,EAAE,0BAA0B,EAAE,EACtC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAWhC;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC7C,OAAO,EAAE,0BAA0B,EACnC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,2BAA2B,CAAC,CAUtC;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,CAWlF;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,mBAAmB,CAe1F"}