@mj-biz-apps/common-server 5.37.0 → 5.39.0

package/dist/custom/graph-transport-factory.d.ts

@@ -0,0 +1,27 @@
+import { GRAPH_COMMUNICATION_PROVIDER, type ActivityMessageTransport, type ActivityTransportContext } from '@mj-biz-apps/common-activity-sync';
+/**
+ * Build a live Graph transport for one connection, or null when this factory cannot serve it.
+ *
+ * NULL IS NOT AN ERROR, and the two cases below are deliberately silent rather than throwing:
+ *
+ *   - a DIFFERENT driver — a fixture or calendar connection is not this factory's business, and
+ *     throwing would break every connection this host runs rather than the one it cannot serve;
+ *   - NO CredentialsRef — the provider already has a specific, better-worded refusal for that
+ *     (`NO_CREDENTIAL_REF_REFUSAL`), and pre-empting it here would replace a precise message with
+ *     a vaguer one.
+ *
+ * Anything else is a wiring fault and is left to throw.
+ */
+export declare function GraphTransportFactory(context: ActivityTransportContext): ActivityMessageTransport | null;
+/**
+ * Register this host's factory. Called once from the package bootstrap.
+ *
+ * Registration alone changes NO behaviour on its own: `AllowLiveFetch` still defaults false, so the
+ * provider still refuses a live read until someone who has confirmed the Exchange Application Access
+ * Policy opts in. What this ends is the state where a correctly configured credential could not be
+ * resolved at all.
+ */
+export declare function LoadGraphTransportFactory(): void;
+/** Exported for tests and for a host that wants the default provider name. */
+export { GRAPH_COMMUNICATION_PROVIDER };
+//# sourceMappingURL=graph-transport-factory.d.ts.map

package/dist/custom/graph-transport-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-transport-factory.d.ts","sourceRoot":"","sources":["../../src/custom/graph-transport-factory.ts"],"names":[],"mappings":"AAoBA,OAAO,EACH,4BAA4B,EAI5B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAEhC,MAAM,mCAAmC,CAAC;AAK3C;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,wBAAwB,GAAG,IAAI,CAiBxG;AAgDD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,8EAA8E;AAC9E,OAAO,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/custom/graph-transport-factory.js

@@ -0,0 +1,105 @@
+/**
+ * The host's answer to "where does a live transport come from?".
+ *
+ * WHY THIS FILE HAD TO EXIST. `ActivityTransportFactory` was declared in the ActivitySync package as
+ * "how a HOST supplies a transport", exported, documented — and NOTHING ANYWHERE BUILT ONE. A
+ * connection could name a credential, the column could be set correctly, and the provider would
+ * still refuse, because the seam that turns a credential name into a transport had no
+ * implementation. That is the last link in the chain between a configured credential and live mail.
+ *
+ * WHY IT LIVES IN THE SERVER PACKAGE. ActivitySync takes MJ's Communication and Credentials engines
+ * as PEER dependencies and injects them deliberately, so a host that syncs only fixtures need
+ * install neither. Building the transport there would have made that impossible. The host is the
+ * layer that legitimately owns both engines, so the wiring belongs here and the seam stays clean.
+ *
+ * @module @mj-biz-apps/common-server
+ */
+import { BaseCommunicationProvider } from '@memberjunction/communication-types';
+import { CredentialEngine } from '@memberjunction/credentials';
+import { MJGlobal } from '@memberjunction/global';
+import { GRAPH_COMMUNICATION_PROVIDER, GraphCommunicationTransport, MJGraphTransportDeps, RegisterActivityTransportFactory, } from '@mj-biz-apps/common-activity-sync';
+/** The `ActivitySyncProviderType.DriverClass` this factory serves. It serves exactly one. */
+const MICROSOFT_365 = 'Microsoft365';
+/**
+ * Build a live Graph transport for one connection, or null when this factory cannot serve it.
+ *
+ * NULL IS NOT AN ERROR, and the two cases below are deliberately silent rather than throwing:
+ *
+ *   - a DIFFERENT driver — a fixture or calendar connection is not this factory's business, and
+ *     throwing would break every connection this host runs rather than the one it cannot serve;
+ *   - NO CredentialsRef — the provider already has a specific, better-worded refusal for that
+ *     (`NO_CREDENTIAL_REF_REFUSAL`), and pre-empting it here would replace a precise message with
+ *     a vaguer one.
+ *
+ * Anything else is a wiring fault and is left to throw.
+ */
+export function GraphTransportFactory(context) {
+    if (context.DriverClass !== MICROSOFT_365) {
+        return null;
+    }
+    const credentialName = (context.CredentialsRef ?? '').trim();
+    if (!credentialName) {
+        return null;
+    }
+    return new GraphCommunicationTransport(MJGraphTransportDeps({
+        CredentialName: credentialName,
+        ContextUser: context.ContextUser,
+        GetCredentialEngine: () => CredentialLoader(context.ContextUser),
+        GetCommunicationProvider: ResolveCommunicationProvider,
+    }));
+}
+/**
+ * The Credentials engine, loaded on first use rather than assumed loaded.
+ *
+ * `getCredential` throws "Metadata not loaded" if the engine has not been configured, and this
+ * factory runs from a scheduled Action that may fire before or after anything else touches
+ * credentials. `EnsureLoaded` is idempotent and joins an in-flight load rather than starting a
+ * second, so paying it per resolution costs nothing after the first.
+ */
+function CredentialLoader(contextUser) {
+    return {
+        async getCredential(name, options) {
+            const user = options?.contextUser ?? contextUser;
+            await CredentialEngine.Instance.EnsureLoaded(user);
+            return CredentialEngine.Instance.getCredential(name, {
+                contextUser: user,
+                subsystem: 'BizApps Common ActivitySync',
+            });
+        },
+    };
+}
+/**
+ * MJ's registered communication provider, by name.
+ *
+ * THE BASE-CLASS CHECK IS LOAD-BEARING and is copied from `CommunicationEngine.GetProvider`:
+ * `ClassFactory.CreateInstance` returns an instance of the BASE class when no registration matches,
+ * so a missing provider comes back as a truthy object that answers no calls usefully. Without this
+ * the transport would be built, reach `GetMessages`, and fail somewhere far less informative than
+ * the registration message the provider already carries.
+ *
+ * WHY NOT CALL `CommunicationEngine.GetProvider` ITSELF. It is this exact resolution and nothing
+ * more — it consults no provider metadata and no Status — but it throws unless the engine's
+ * `Config()` has loaded its five metadata entities first. That is a sending-side prerequisite this
+ * read-only path has no use for, so the two lines are mirrored here rather than paying the load.
+ */
+function ResolveCommunicationProvider(name) {
+    const instance = MJGlobal.Instance.ClassFactory.CreateInstance(BaseCommunicationProvider, name);
+    if (!instance || instance.constructor.name === 'BaseCommunicationProvider') {
+        return null;
+    }
+    return instance;
+}
+/**
+ * Register this host's factory. Called once from the package bootstrap.
+ *
+ * Registration alone changes NO behaviour on its own: `AllowLiveFetch` still defaults false, so the
+ * provider still refuses a live read until someone who has confirmed the Exchange Application Access
+ * Policy opts in. What this ends is the state where a correctly configured credential could not be
+ * resolved at all.
+ */
+export function LoadGraphTransportFactory() {
+    RegisterActivityTransportFactory(GraphTransportFactory);
+}
+/** Exported for tests and for a host that wants the default provider name. */
+export { GRAPH_COMMUNICATION_PROVIDER };
+//# sourceMappingURL=graph-transport-factory.js.map

package/dist/custom/graph-transport-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-transport-factory.js","sourceRoot":"","sources":["../../src/custom/graph-transport-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EACH,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,gCAAgC,GAInC,MAAM,mCAAmC,CAAC;AAE3C,6FAA6F;AAC7F,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAiC;IACnE,IAAI,OAAO,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,CAAC,cAAc,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,2BAA2B,CAClC,oBAAoB,CAAC;QACjB,cAAc,EAAE,cAAc;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,mBAAmB,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC;QAChE,wBAAwB,EAAE,4BAA4B;KACzD,CAAC,CACL,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,WAAsB;IAC5C,OAAO;QACH,KAAK,CAAC,aAAa,CAAI,IAAY,EAAE,OAAiC;YAClE,MAAM,IAAI,GAAI,OAAO,EAAE,WAAoC,IAAI,WAAW,CAAC;YAC3E,MAAM,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACnD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE;gBACjD,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,6BAA6B;aAC3C,CAAsC,CAAC;QAC5C,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,4BAA4B,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAC1D,yBAAyB,EACzB,IAAI,CACP,CAAC;IACF,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,2BAA2B,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,QAAyC,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB;IACrC,gCAAgC,CAAC,qBAAqB,CAAC,CAAC;AAC5D,CAAC;AAED,8EAA8E;AAC9E,OAAO,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/index.d.ts

@@ -20,4 +20,5 @@ export declare const RESOLVER_PATHS: string[];
 export declare function LoadBizAppsCommonServer(): void;
 export { SyncActivitiesAction, LoadSyncActivitiesAction } from './custom/sync-activities.action.js';
 export { LogActivityAction, LoadLogActivityAction } from './custom/log-activity.action.js';
+export { GraphTransportFactory, LoadGraphTransportFactory } from './custom/graph-transport-factory.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,8BAA8B,CAAC;AACtC,OAAO,6BAA6B,CAAC;AAIrC,OAAO,0CAA0C,CAAC;AAMlD,OAAO,0BAA0B,CAAC;AAMlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAOlF,oFAAoF;AACpF,eAAO,MAAM,cAAc,UAAsD,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAM9C;AAED,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,8BAA8B,CAAC;AACtC,OAAO,6BAA6B,CAAC;AAIrC,OAAO,0CAA0C,CAAC;AAOlD,OAAO,0BAA0B,CAAC;AAMlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAOlF,oFAAoF;AACpF,eAAO,MAAM,cAAc,UAAsD,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAS9C;AAED,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/index.js

@@ -14,6 +14,7 @@ import '@mj-biz-apps/common-core-entities-server';
 import { LoadActivitySyncEngine } from '@mj-biz-apps/common-core-entities-server';
 import { LoadSyncActivitiesAction } from './custom/sync-activities.action.js';
 import { LoadLogActivityAction } from './custom/log-activity.action.js';
+import { LoadGraphTransportFactory } from './custom/graph-transport-factory.js';
 // Import generated GraphQL resolvers
 import './generated/generated.js';
 // Re-export the manifest for consumers
@@ -34,7 +35,11 @@ export function LoadBizAppsCommonServer() {
     LoadActivitySyncEngine();
     LoadSyncActivitiesAction();
     LoadLogActivityAction();
+    // Registers the seam that turns a connection's CredentialsRef into a live Graph transport.
+    // Nothing about this enables a live read on its own — AllowLiveFetch still defaults false.
+    LoadGraphTransportFactory();
 }
 export { SyncActivitiesAction, LoadSyncActivitiesAction } from './custom/sync-activities.action.js';
 export { LogActivityAction, LoadLogActivityAction } from './custom/log-activity.action.js';
+export { GraphTransportFactory, LoadGraphTransportFactory } from './custom/graph-transport-factory.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,OAAO,8BAA8B,CAAC;AACtC,OAAO,6BAA6B,CAAC;AAErC,qEAAqE;AACrE,4DAA4D;AAC5D,OAAO,0CAA0C,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,qCAAqC;AACrC,OAAO,0BAA0B,CAAC;AAKlC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC,CAAC;AAElF;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACnC,0DAA0D;IAC1D,kFAAkF;IAClF,sBAAsB,EAAE,CAAC;IACzB,wBAAwB,EAAE,CAAC;IAC3B,qBAAqB,EAAE,CAAC;AAC5B,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,OAAO,8BAA8B,CAAC;AACtC,OAAO,6BAA6B,CAAC;AAErC,qEAAqE;AACrE,4DAA4D;AAC5D,OAAO,0CAA0C,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,qCAAqC;AACrC,OAAO,0BAA0B,CAAC;AAKlC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC,CAAC;AAElF;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACnC,0DAA0D;IAC1D,kFAAkF;IAClF,sBAAsB,EAAE,CAAC;IACzB,wBAAwB,EAAE,CAAC;IAC3B,qBAAqB,EAAE,CAAC;IACxB,2FAA2F;IAC3F,2FAA2F;IAC3F,yBAAyB,EAAE,CAAC;AAChC,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mj-biz-apps/common-server",
   "type": "module",
-  "version": "5.37.0",
+  "version": "5.39.0",
   "description": "BizApps Common server bootstrap - GraphQL resolvers and class registrations for the Common business entities Open App",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,22 +14,25 @@
   "author": "MemberJunction.com",
   "license": "BUSL-1.1",
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@mj-biz-apps/common-activity-sync": "5.37.0",
-    "@mj-biz-apps/common-core-entities-server": "5.37.0",
-    "@mj-biz-apps/common-entities": "5.37.0",
-    "@mj-biz-apps/common-actions": "5.37.0",
+    "@mj-biz-apps/common-activity-sync": "5.39.0",
+    "@mj-biz-apps/common-core-entities-server": "5.39.0",
+    "@mj-biz-apps/common-entities": "5.39.0",
+    "@mj-biz-apps/common-actions": "5.39.0",
     "class-validator": "^0.14.3"
   },
   "peerDependencies": {
-    "@memberjunction/actions": "^6.1.0-edge.3",
-    "@memberjunction/actions-base": "^6.1.0-edge.3",
-    "@memberjunction/core": "^6.1.0-edge.3",
-    "@memberjunction/global": "^6.1.0-edge.3",
-    "@memberjunction/server": "^6.1.0-edge.3",
-    "@memberjunction/sqlserver-dataprovider": "^6.1.0-edge.3"
+    "@memberjunction/actions": "^6.1.0-edge.5",
+    "@memberjunction/actions-base": "^6.1.0-edge.5",
+    "@memberjunction/communication-types": "^6.1.0-edge.5",
+    "@memberjunction/core": "^6.1.0-edge.5",
+    "@memberjunction/credentials": "^6.1.0-edge.5",
+    "@memberjunction/global": "^6.1.0-edge.5",
+    "@memberjunction/server": "^6.1.0-edge.5",
+    "@memberjunction/sqlserver-dataprovider": "^6.1.0-edge.5"
   },
   "repository": {
     "type": "git",
@@ -37,6 +40,6 @@
   },
   "scripts": {
     "build": "tsc && tsc-alias -f",
-    "test": "echo \"No tests configured yet\""
+    "test": "vitest run"
   }
 }