@mj-biz-apps/common-activity-sync 0.0.0 → 5.37.0

package/dist/ActivitySyncEngine.d.ts

@@ -0,0 +1,118 @@
+/**
+ * ActivitySyncEngine — fetch, qualify, resolve, write.
+ *
+ * No model call inside a transaction. No model call before the deterministic filter.
+ * Dry run never advances the watermark (CK_ActivitySyncRun_DryRunNoWatermark).
+ * Synced activities are Visibility=Private. Unmatched addresses stay unresolved links.
+ */
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { BaseActivitySyncProvider } from './BaseActivitySyncProvider.js';
+import { type ExtensionStamp } from './extensions.js';
+import { IdentityResolver } from './identity.js';
+import { type IQualificationStage, type QualificationPolicy } from './qualification.js';
+import { type SyncRunOptions } from './run.js';
+import { ActivityWriter } from './writer.js';
+export interface SyncEngineResult {
+    Success: boolean;
+    RunID: string | null;
+    Fetched: number;
+    Included: number;
+    Excluded: number;
+    Duplicates: number;
+    Failed: number;
+    ExtensionErrors: number;
+    WatermarkAdvancedTo: Date | null;
+    Issues: string[];
+}
+export interface FleetRunResult {
+    Success: boolean;
+    ConnectionsAttempted: number;
+    Results: Array<{
+        ConnectionID: string;
+        Surface: string;
+        Result: SyncEngineResult;
+    }>;
+    Issues: string[];
+}
+/** Hard cap on the fleet query. Unbounded RunView is how a tenant with a burst of mailboxes stalls the hourly job. */
+export declare const MAX_RUNNABLE_CONNECTIONS = 500;
+interface ConnectionRow {
+    ID: string;
+    Status: string;
+    Provider: string | null;
+    Mailbox: string | null;
+    StartAt: Date | string | null;
+    EndAt: Date | string | null;
+    LastSyncAt: Date | string | null;
+    ActivitySyncProviderTypeID: string | null;
+    SkippedContentPolicy: string | null;
+    Settings: string | null;
+}
+interface ProviderTypeRow {
+    ID: string;
+    Code: string;
+    DriverClass: string;
+    DefaultQualificationPolicy: QualificationPolicy;
+    /** Companion calendar ClassFactory key. Null = this type has no second surface. */
+    CalendarDriverClass: string | null;
+}
+interface RunSurfaceOptions {
+    /** Injected provider (tests). When omitted, resolved from the type row. */
+    source?: BaseActivitySyncProvider;
+    /**
+     * Connection health is per-connection, not per-surface. RunConnections stamps once
+     * from the combined outcome so a refused calendar pass cannot clear a message failure.
+     */
+    stampHealth: boolean;
+    /** Skip the ID reload when the fleet already has the row. */
+    connection?: ConnectionRow;
+    /** Skip the type reload when the fleet already loaded it. */
+    typeRow?: ProviderTypeRow | null;
+}
+/**
+ * LastError must name the failure, not whatever happened to be Issues[0].
+ * Mapping warnings ("Event X had no usable start time") sort ahead of the actual miss.
+ */
+export declare function healthErrorFromResults(results: readonly SyncEngineResult[]): string | null;
+/**
+ * One Load+Save per extension row after the batch — not N items × M extensions.
+ *
+ * An error is sticky within the batch on purpose: a later success on a different item must
+ * not clear LastError for a Skip that already happened in this run. Only a later run that
+ * is clean for that row writes null.
+ */
+export declare function collapseExtensionStamps(stamps: readonly ExtensionStamp[]): ExtensionStamp[];
+export declare class ActivitySyncEngine {
+    private readonly resolver;
+    private readonly writer;
+    private readonly stages;
+    constructor(resolver?: IdentityResolver, writer?: ActivityWriter, stages?: IQualificationStage[]);
+    Run(connectionID: string, options: SyncRunOptions, provider: IMetadataProvider, contextUser: UserInfo, source?: BaseActivitySyncProvider, surface?: RunSurfaceOptions): Promise<SyncEngineResult>;
+    /**
+     * Every Active-or-Error connection, once per surface. This is what a scheduled
+     * Action calls. Downstream apps do not wrap this — they register an extension.
+     *
+     * A companion calendar pass is data: ActivitySyncProviderType.CalendarDriverClass.
+     * The engine never keys on the deprecated Connection.Provider column. Calendar Graph
+     * still refuses live fetch. Health is stamped once from the combined outcome so a
+     * refused calendar pass cannot clear a message failure.
+     */
+    RunConnections(options: SyncRunOptions, provider: IMetadataProvider, contextUser: UserInfo): Promise<FleetRunResult>;
+    private resolvePlugin;
+    private failClosed;
+    private resolveExtension;
+    private loadExtensions;
+    private stampExtensions;
+    private stampConnectionHealth;
+    private loadConnection;
+    private loadRunnableConnections;
+    private loadProviderType;
+    private loadBoundSetIds;
+    private loadExclusions;
+    private loadRules;
+    private stampSurfaceWatermark;
+    private persistRun;
+}
+export declare function LoadActivitySyncEngine(): void;
+export {};
+//# sourceMappingURL=ActivitySyncEngine.d.ts.map

package/dist/ActivitySyncEngine.d.ts.map

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