@memberjunction/server 5.39.0 → 5.40.1

package/dist/resolvers/RunClusterAnalysisResolver.js

@@ -0,0 +1,243 @@
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Resolver, Mutation, Arg, Ctx, ObjectType, InputType, Field, Float, Int } from 'type-graphql';
+import { LogError, LogStatus } from '@memberjunction/core';
+import { ResolverBase } from '../generic/ResolverBase.js';
+import { GetReadWriteProvider } from '../util.js';
+import { ClusteringEngine, EntityDocumentVectorSource, } from '@memberjunction/clustering-engine';
+/* ───── GraphQL input ───── */
+let RunClusterAnalysisInput = class RunClusterAnalysisInput {
+};
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "EntityName", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "EntityID", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "EntityDocumentID", void 0);
+__decorate([
+    Field(() => [String], { nullable: true }),
+    __metadata("design:type", Array)
+], RunClusterAnalysisInput.prototype, "EntityDocumentIDs", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "ColorBy", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "Algorithm", void 0);
+__decorate([
+    Field(() => Int, { nullable: true }),
+    __metadata("design:type", Number)
+], RunClusterAnalysisInput.prototype, "K", void 0);
+__decorate([
+    Field(() => Float, { nullable: true }),
+    __metadata("design:type", Number)
+], RunClusterAnalysisInput.prototype, "Epsilon", void 0);
+__decorate([
+    Field(() => Int, { nullable: true }),
+    __metadata("design:type", Number)
+], RunClusterAnalysisInput.prototype, "MinPoints", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "DistanceMetric", void 0);
+__decorate([
+    Field(() => Int, { nullable: true }),
+    __metadata("design:type", Number)
+], RunClusterAnalysisInput.prototype, "MaxRecords", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "Filter", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", Boolean)
+], RunClusterAnalysisInput.prototype, "NameClusters", void 0);
+__decorate([
+    Field(() => Int, { nullable: true }),
+    __metadata("design:type", Number)
+], RunClusterAnalysisInput.prototype, "Dimensions", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisInput.prototype, "PersistName", void 0);
+RunClusterAnalysisInput = __decorate([
+    InputType()
+], RunClusterAnalysisInput);
+export { RunClusterAnalysisInput };
+/* ───── GraphQL output ───── */
+let RunClusterAnalysisResult = class RunClusterAnalysisResult {
+};
+__decorate([
+    Field(),
+    __metadata("design:type", Boolean)
+], RunClusterAnalysisResult.prototype, "Success", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisResult.prototype, "ErrorMessage", void 0);
+__decorate([
+    Field(() => Int),
+    __metadata("design:type", Number)
+], RunClusterAnalysisResult.prototype, "ClusterCount", void 0);
+__decorate([
+    Field(() => Int),
+    __metadata("design:type", Number)
+], RunClusterAnalysisResult.prototype, "RecordCount", void 0);
+__decorate([
+    Field(() => Int),
+    __metadata("design:type", Number)
+], RunClusterAnalysisResult.prototype, "OutlierCount", void 0);
+__decorate([
+    Field(() => Float),
+    __metadata("design:type", Number)
+], RunClusterAnalysisResult.prototype, "SilhouetteScore", void 0);
+__decorate([
+    Field(() => Float),
+    __metadata("design:type", Number)
+], RunClusterAnalysisResult.prototype, "ComputationTimeMs", void 0);
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], RunClusterAnalysisResult.prototype, "MetricsJSON", void 0);
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], RunClusterAnalysisResult.prototype, "ClustersJSON", void 0);
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], RunClusterAnalysisResult.prototype, "PointsJSON", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], RunClusterAnalysisResult.prototype, "AnalysisID", void 0);
+RunClusterAnalysisResult = __decorate([
+    ObjectType()
+], RunClusterAnalysisResult);
+export { RunClusterAnalysisResult };
+/* ───── Resolver ───── */
+let RunClusterAnalysisResolver = class RunClusterAnalysisResolver extends ResolverBase {
+    async RunClusterAnalysis(input, context = {}) {
+        try {
+            const currentUser = this.GetUserFromPayload(context.userPayload);
+            if (!currentUser) {
+                return this.errorResult('Unable to determine current user');
+            }
+            // Per-request provider so reads/writes use this user's connection +
+            // security context (multi-user safe), not the process global.
+            const provider = GetReadWriteProvider(context.providers);
+            const config = this.buildConfig(input);
+            const engine = new ClusteringEngine();
+            const vectorSource = new EntityDocumentVectorSource(currentUser, provider);
+            LogStatus(`RunClusterAnalysis: algorithm=${config.Algorithm} entity=${config.EntityName ?? config.EntityID ?? config.EntityDocumentID}`);
+            const result = await engine.RunPipeline(config, vectorSource, currentUser);
+            let analysisID;
+            if (input.PersistName && input.PersistName.trim().length > 0) {
+                analysisID = await this.persistAnalysis(engine, result, config, input.PersistName.trim(), currentUser, provider);
+            }
+            return {
+                Success: true,
+                ClusterCount: result.Metrics.ClusterCount,
+                RecordCount: result.Metrics.RecordCount,
+                OutlierCount: result.Metrics.OutlierCount,
+                SilhouetteScore: result.Metrics.SilhouetteScore,
+                ComputationTimeMs: result.Metrics.ComputationTimeMs,
+                MetricsJSON: JSON.stringify(result.Metrics),
+                ClustersJSON: JSON.stringify(result.Clusters),
+                PointsJSON: JSON.stringify(result.Points),
+                AnalysisID: analysisID,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`RunClusterAnalysis mutation failed: ${msg}`);
+            return this.errorResult(msg);
+        }
+    }
+    /** Build a {@link ClusterConfig} from the GraphQL input, applying defaults. */
+    buildConfig(input) {
+        return {
+            EntityName: input.EntityName ?? '',
+            EntityID: input.EntityID ?? '',
+            EntityDocumentID: input.EntityDocumentID ?? '',
+            EntityDocumentIDs: (input.EntityDocumentIDs ?? []).filter((id) => !!id && id.trim().length > 0),
+            ColorBy: input.ColorBy === 'entity' ? 'entity' : 'cluster',
+            Algorithm: this.normalizeAlgorithm(input.Algorithm),
+            K: input.K ?? 4,
+            Epsilon: input.Epsilon ?? 0.3,
+            MinPoints: input.MinPoints ?? 3,
+            DistanceMetric: this.normalizeMetric(input.DistanceMetric),
+            MaxRecords: input.MaxRecords ?? 500,
+            Filter: input.Filter ?? '',
+            NameClusters: input.NameClusters ?? false,
+            Dimensions: input.Dimensions === 3 ? 3 : 2,
+        };
+    }
+    /** Coerce a raw algorithm string to a supported {@link ClusterAlgorithm}. */
+    normalizeAlgorithm(value) {
+        return value?.toLowerCase() === 'dbscan' ? 'dbscan' : 'kmeans';
+    }
+    /** Coerce a raw metric string to a supported {@link ClusterDistanceMetric}. */
+    normalizeMetric(value) {
+        const v = value?.toLowerCase();
+        if (v === 'euclidean' || v === 'dotproduct') {
+            return v;
+        }
+        return 'cosine';
+    }
+    /** Persist the result and return the new analysis ID (or undefined on failure). */
+    async persistAnalysis(engine, result, config, persistName, currentUser, provider) {
+        const owner = { Name: persistName, UserID: currentUser.ID };
+        const savedID = await engine.SaveAnalysis(result, config, owner, currentUser, provider);
+        if (!savedID) {
+            LogError(`RunClusterAnalysis: failed to persist analysis "${persistName}".`);
+            return undefined;
+        }
+        return savedID;
+    }
+    errorResult(message) {
+        return {
+            Success: false,
+            ErrorMessage: message,
+            ClusterCount: 0,
+            RecordCount: 0,
+            OutlierCount: 0,
+            SilhouetteScore: 0,
+            ComputationTimeMs: 0,
+            MetricsJSON: '{}',
+            ClustersJSON: '[]',
+            PointsJSON: '[]',
+        };
+    }
+};
+__decorate([
+    Mutation(() => RunClusterAnalysisResult),
+    __param(0, Arg('input', () => RunClusterAnalysisInput)),
+    __param(1, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [RunClusterAnalysisInput, Object]),
+    __metadata("design:returntype", Promise)
+], RunClusterAnalysisResolver.prototype, "RunClusterAnalysis", null);
+RunClusterAnalysisResolver = __decorate([
+    Resolver()
+], RunClusterAnalysisResolver);
+export { RunClusterAnalysisResolver };
+//# sourceMappingURL=RunClusterAnalysisResolver.js.map

package/dist/resolvers/RunClusterAnalysisResolver.js.map

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

package/dist/resolvers/UserResolver.d.ts

@@ -1,6 +1,20 @@
-import { AppContext } from '@memberjunction/server';
-import { MJUserResolverBase } from '../generated/generated.js';
+import { AppContext, PubSubEngine } from '@memberjunction/server';
+import { MJUser_, MJUserResolverBase } from '../generated/generated.js';
 export declare class UserResolver extends MJUserResolverBase {
+    /**
+     * Roles for the current user row.
+     *
+     * Overrides the generated field resolver to support ANONYMOUS magic-link sessions: those
+     * resolve to a shared Anonymous principal that holds NO roles in the database (by design —
+     * persisting them would let anonymous sessions accrete privileges across links). The roles
+     * are synthesized per-request in {@link buildMagicLinkSessionUser} and live only on the
+     * request's `UserInfo`. For the session's OWN user row we serve those synthesized roles
+     * directly, skipping the generated DB query (which returns empty) and its `MJ: User Roles`
+     * read-permission check (which the restricted anon role wouldn't pass). Every other case —
+     * named users, named magic-link users, listing other users' roles — falls through to the
+     * generated resolver unchanged, so there is no behavioral or security change off this path.
+     */
+    MJUserRoles_UserIDArray(mjuser_: MJUser_, context: AppContext, pubSub: PubSubEngine): Promise<any[]>;
     CurrentUser(context: AppContext): Promise<any>;
     UserByID(ID: number, { providers, userPayload }: AppContext): Promise<any>;
     UserByEmployeeID(EmployeeID: number, { providers, userPayload }: AppContext): Promise<any>;

package/dist/resolvers/UserResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/UserResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkC,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAW,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGxE,qBACa,YAAa,SAAQ,kBAAkB;IAE5C,WAAW,CAAQ,OAAO,EAAE,UAAU;IA8CtC,QAAQ,CAAuB,EAAE,EAAE,MAAM,EAAS,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,UAAU;IAUxF,gBAAgB,CAA+B,UAAU,EAAE,MAAM,EAAS,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,UAAU;IAUhH,WAAW,CAA6B,KAAK,EAAE,MAAM,EAAS,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,UAAU;CAU3G;AACD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"UserResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/UserResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwC,YAAY,EAAyB,MAAM,wBAAwB,CAAC;AAE/H,OAAO,EAAE,OAAO,EAAe,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGrF,qBACa,YAAa,SAAQ,kBAAkB;IAElD;;;;;;;;;;;;OAYG;IAEG,uBAAuB,CAAS,OAAO,EAAE,OAAO,EAAS,OAAO,EAAE,UAAU,EAAY,MAAM,EAAE,YAAY;IAqB5G,WAAW,CAAQ,OAAO,EAAE,UAAU;IA8CtC,QAAQ,CAAuB,EAAE,EAAE,MAAM,EAAS,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,UAAU;IAUxF,gBAAgB,CAA+B,UAAU,EAAE,MAAM,EAAS,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,UAAU;IAUhH,WAAW,CAA6B,KAAK,EAAE,MAAM,EAAS,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,UAAU;CAU3G;AACD,eAAe,YAAY,CAAC"}

package/dist/resolvers/UserResolver.js

@@ -10,10 +10,44 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { Arg, Ctx, Int, Query, Resolver } from '@memberjunction/server';
-import { MJUser_, MJUserResolverBase } from '../generated/generated.js';
+import { Arg, Ctx, FieldResolver, Int, PubSub, PubSubEngine, Query, Resolver, Root } from '@memberjunction/server';
+import { UUIDsEqual } from '@memberjunction/global';
+import { MJUser_, MJUserRole_, MJUserResolverBase } from '../generated/generated.js';
 import { GetReadOnlyProvider } from '../util.js';
 let UserResolver = class UserResolver extends MJUserResolverBase {
+    /**
+     * Roles for the current user row.
+     *
+     * Overrides the generated field resolver to support ANONYMOUS magic-link sessions: those
+     * resolve to a shared Anonymous principal that holds NO roles in the database (by design —
+     * persisting them would let anonymous sessions accrete privileges across links). The roles
+     * are synthesized per-request in {@link buildMagicLinkSessionUser} and live only on the
+     * request's `UserInfo`. For the session's OWN user row we serve those synthesized roles
+     * directly, skipping the generated DB query (which returns empty) and its `MJ: User Roles`
+     * read-permission check (which the restricted anon role wouldn't pass). Every other case —
+     * named users, named magic-link users, listing other users' roles — falls through to the
+     * generated resolver unchanged, so there is no behavioral or security change off this path.
+     */
+    async MJUserRoles_UserIDArray(mjuser_, context, pubSub) {
+        const sessionUser = context.userPayload?.userRecord;
+        if (sessionUser?.IsMagicLinkAnonymous && UUIDsEqual(mjuser_.ID, sessionUser.ID)) {
+            const now = new Date();
+            // Build rows with the entity's RAW field names, then run them through the same
+            // name→code-name mapping the generated resolver uses (e.g. __mj_CreatedAt →
+            // _mj__CreatedAt). Returning raw names directly trips GraphQL's non-nullable check.
+            const rows = (sessionUser.UserRoles ?? []).map((r) => ({
+                ID: sessionUser.ID,
+                UserID: r.UserID,
+                RoleID: r.RoleID,
+                User: sessionUser.Name,
+                Role: r.RoleName ?? r.Role,
+                __mj_CreatedAt: now,
+                __mj_UpdatedAt: now,
+            }));
+            return this.ArrayMapFieldNamesToCodeNames('MJ: User Roles', rows, sessionUser);
+        }
+        return super.MJUserRoles_UserIDArray(mjuser_, context, pubSub);
+    }
     async CurrentUser(context) {
         // Check API key scope authorization for user read (self)
         await this.CheckAPIKeyScopeAuthorization('user:read', '*', context.userPayload);
@@ -80,6 +114,15 @@ let UserResolver = class UserResolver extends MJUserResolverBase {
         return this.MapFieldNamesToCodeNames('MJ: Users', returnVal);
     }
 };
+__decorate([
+    FieldResolver(() => [MJUserRole_]),
+    __param(0, Root()),
+    __param(1, Ctx()),
+    __param(2, PubSub()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [MJUser_, Object, PubSubEngine]),
+    __metadata("design:returntype", Promise)
+], UserResolver.prototype, "MJUserRoles_UserIDArray", null);
 __decorate([
     Query(() => MJUser_),
     __param(0, Ctx()),

package/dist/resolvers/UserResolver.js.map

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

package/dist/rest/SignatureWebhookHandler.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Inbound eSignature webhook handler (DocuSign Connect, Adobe events, …).
+ *
+ * Unauthenticated by design — external signature providers call this endpoint without an MJ bearer
+ * token. Payload authenticity is verified by the provider DRIVER's `ParseWebhookEvent` (HMAC /
+ * signature), not by MJ auth. Must be registered BEFORE the unified auth middleware.
+ *
+ * Endpoint:
+ *   - POST /esignature/webhook/:driverKey
+ *
+ * @module @memberjunction/server/rest/SignatureWebhookHandler
+ */
+import express from 'express';
+/**
+ * Build an Express router exposing the eSignature webhook. Mount it unauthenticated:
+ * `app.use('/esignature', createSignatureWebhookHandler())`.
+ */
+export declare function createSignatureWebhookHandler(): express.Router;
+//# sourceMappingURL=SignatureWebhookHandler.d.ts.map

package/dist/rest/SignatureWebhookHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignatureWebhookHandler.d.ts","sourceRoot":"","sources":["../../src/rest/SignatureWebhookHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,MAAM,CAa9D"}

package/dist/rest/SignatureWebhookHandler.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Inbound eSignature webhook handler (DocuSign Connect, Adobe events, …).
+ *
+ * Unauthenticated by design — external signature providers call this endpoint without an MJ bearer
+ * token. Payload authenticity is verified by the provider DRIVER's `ParseWebhookEvent` (HMAC /
+ * signature), not by MJ auth. Must be registered BEFORE the unified auth middleware.
+ *
+ * Endpoint:
+ *   - POST /esignature/webhook/:driverKey
+ *
+ * @module @memberjunction/server/rest/SignatureWebhookHandler
+ */
+import express from 'express';
+import BodyParser from 'body-parser';
+import { LogError, LogStatus } from '@memberjunction/core';
+import { UserCache } from '@memberjunction/sqlserver-dataprovider';
+import { SignatureEngine } from '@memberjunction/esignature/server';
+/**
+ * Build an Express router exposing the eSignature webhook. Mount it unauthenticated:
+ * `app.use('/esignature', createSignatureWebhookHandler())`.
+ */
+export function createSignatureWebhookHandler() {
+    const router = express.Router();
+    // Capture the raw body so drivers that HMAC-verify over the exact bytes can do so.
+    router.post('/webhook/:driverKey', BodyParser.json({ limit: '25mb', verify: captureRawBody }), async (req, res) => {
+        await handleWebhook(req, res);
+    });
+    return router;
+}
+/** Stash the raw request bytes on the request for signature verification by the driver. */
+function captureRawBody(req, _res, buf) {
+    req.rawBody = buf;
+}
+async function handleWebhook(req, res) {
+    const driverKey = req.params.driverKey;
+    if (!driverKey) {
+        res.status(400).json({ error: 'Missing driver key in path.' });
+        return;
+    }
+    const contextUser = getSystemUser();
+    if (!contextUser) {
+        LogError('[eSignature webhook] No system user available; cannot process webhook.');
+        res.status(503).json({ error: 'Server not ready to process webhooks.' });
+        return;
+    }
+    try {
+        await SignatureEngine.Instance.Config(false, contextUser);
+        const headers = normalizeHeaders(req.headers);
+        const rawBody = req.rawBody;
+        const result = await SignatureEngine.Instance.RecordWebhookEvent(driverKey, req.body, headers, contextUser, rawBody);
+        if (!result.Success) {
+            // 202: we received it but couldn't act (e.g. unrecognized payload / no matching envelope).
+            // Returning 2xx prevents most providers from aggressively retrying a payload we'll never match.
+            LogStatus(`[eSignature webhook] ${driverKey}: not actioned — ${result.ErrorMessage}`);
+            res.status(202).json({ received: true, actioned: false, message: result.ErrorMessage });
+            return;
+        }
+        res.status(200).json({ received: true, actioned: true, status: result.event?.status });
+    }
+    catch (e) {
+        LogError(`[eSignature webhook] ${driverKey}: ${e instanceof Error ? e.message : String(e)}`);
+        res.status(500).json({ error: 'Failed to process webhook.' });
+    }
+}
+/** Flatten Express header values to a simple string map for the driver. */
+function normalizeHeaders(headers) {
+    const out = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (typeof value === 'string') {
+            out[key] = value;
+        }
+        else if (Array.isArray(value)) {
+            out[key] = value.join(', ');
+        }
+    }
+    return out;
+}
+function getSystemUser() {
+    try {
+        return UserCache.Instance.GetSystemUser() ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=SignatureWebhookHandler.js.map

package/dist/rest/SignatureWebhookHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignatureWebhookHandler.js","sourceRoot":"","sources":["../../src/rest/SignatureWebhookHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAY,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,6BAA6B;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,mFAAmF;IACnF,MAAM,CAAC,IAAI,CACP,qBAAqB,EACrB,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,EAC1D,KAAK,EAAE,GAAoB,EAAE,GAAqB,EAAE,EAAE;QAClD,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC,CACJ,CAAC;IAEF,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,2FAA2F;AAC3F,SAAS,cAAc,CAAC,GAAoB,EAAE,IAAsB,EAAE,GAAW;IAC5E,GAAsB,CAAC,OAAO,GAAG,GAAG,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAoB,EAAE,GAAqB;IACpE,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;IACvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;QAC/D,OAAO;IACX,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,EAAE,CAAC;IACpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,QAAQ,CAAC,wEAAwE,CAAC,CAAC;QACnF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAC;QACzE,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAI,GAAsB,CAAC,OAAO,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,kBAAkB,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAErH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,2FAA2F;YAC3F,gGAAgG;YAChG,SAAS,CAAC,wBAAwB,SAAS,oBAAoB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACxF,OAAO;QACX,CAAC;QAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3F,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,QAAQ,CAAC,wBAAwB,SAAS,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7F,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;IAClE,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,SAAS,gBAAgB,CAAC,OAAmC;IACzD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,aAAa;IAClB,IAAI,CAAC;QACD,OAAO,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,IAAI,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}