@memberjunction/esignature 0.0.1 → 5.40.0

package/dist/server/SignatureEngine.js

@@ -0,0 +1,464 @@
+import { LogError, LogStatus, Metadata, RunView } from '@memberjunction/core';
+import { BaseSingleton, MJGlobal } from '@memberjunction/global';
+import { BaseSignatureProvider } from '../BaseSignatureProvider.js';
+import { SignatureEngineBase } from '../SignatureEngineBase.js';
+import { initializeDriverWithAccountCredentials } from './util.js';
+import { loadArtifactVersionBytes, writeSignedArtifact } from './artifacts.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Engine
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Server-side eSignature engine. Resolves providers via the ClassFactory, decrypts credentials via
+ * the Credential Engine, persists the envelope lifecycle across the six `MJ: Signature*` entities,
+ * and normalizes inbound webhooks. Wraps {@link SignatureEngineBase} (the metadata cache) using the
+ * same containment pattern as FileStorageEngine.
+ *
+ * Multi-provider rule (CLAUDE.md): every method accepts `contextUser` and an optional
+ * `IMetadataProvider`; the global `Metadata.Provider` is used only as an explicit fallback.
+ */
+export class SignatureEngine extends BaseSingleton {
+    constructor() {
+        super(...arguments);
+        this._loaded = false;
+        this._loading = false;
+        this._loadingPromise = null;
+        /** Initialized drivers keyed by account ID. */
+        this._driverCache = new Map();
+    }
+    static get Instance() {
+        return super.getInstance();
+    }
+    get Base() {
+        return SignatureEngineBase.Instance;
+    }
+    get Loaded() {
+        return this._loaded && this.Base.Loaded;
+    }
+    get Accounts() {
+        return this.Base.Accounts;
+    }
+    get Providers() {
+        return this.Base.Providers;
+    }
+    // ---- Configuration ----------------------------------------------------------------------------
+    /** Load metadata + pre-initialize active drivers. Idempotent unless forceRefresh. */
+    async Config(forceRefresh, contextUser, provider) {
+        if (this._loaded && !forceRefresh) {
+            return;
+        }
+        if (this._loading && this._loadingPromise) {
+            return this._loadingPromise;
+        }
+        this._loading = true;
+        this._loadingPromise = this.innerLoad(forceRefresh, contextUser, provider);
+        try {
+            await this._loadingPromise;
+        }
+        finally {
+            this._loading = false;
+            this._loadingPromise = null;
+        }
+    }
+    async innerLoad(forceRefresh, contextUser, provider) {
+        try {
+            this._contextUser = contextUser;
+            await this.Base.Config(forceRefresh ?? false, contextUser, provider);
+            await this.RefreshDriverCache();
+            this._loaded = true;
+        }
+        catch (error) {
+            LogError(error);
+            throw error;
+        }
+    }
+    /** (Re)initialize drivers for all active accounts. Failures are logged, not thrown. */
+    async RefreshDriverCache() {
+        this._driverCache.clear();
+        const activeAccounts = this.Base.AccountsWithProviders.filter((a) => a.account.IsActive !== false && a.provider.IsActive !== false);
+        if (activeAccounts.length === 0 || !this._contextUser) {
+            return;
+        }
+        const contextUser = this._contextUser;
+        const results = await Promise.allSettled(activeAccounts.map(async ({ account, provider }) => {
+            const driver = await initializeDriverWithAccountCredentials({ accountEntity: account, providerEntity: provider, contextUser });
+            this._driverCache.set(account.ID, driver);
+        }));
+        results.forEach((r, i) => {
+            if (r.status === 'rejected') {
+                LogError(`SignatureEngine: failed to pre-initialize driver for account "${activeAccounts[i].account.Name}": ${r.reason}`);
+            }
+        });
+    }
+    /** Resolve (and cache) an initialized driver for an account. */
+    async GetDriver(accountId, contextUser) {
+        const cached = this._driverCache.get(accountId);
+        if (cached) {
+            return cached;
+        }
+        const resolved = this.Base.GetAccountWithProvider(accountId);
+        if (!resolved) {
+            throw new Error(`SignatureEngine.GetDriver: account '${accountId}' not found in cached metadata. Did you call Config()?`);
+        }
+        const driver = await initializeDriverWithAccountCredentials({
+            accountEntity: resolved.account,
+            providerEntity: resolved.provider,
+            contextUser,
+        });
+        this._driverCache.set(accountId, driver);
+        return driver;
+    }
+    // ---- Send -------------------------------------------------------------------------------------
+    /**
+     * Create the lifecycle records, send the envelope through the provider, and persist the outcome.
+     */
+    async SendForSignature(options) {
+        const { contextUser } = options;
+        const account = this.Base.GetAccountWithProvider(options.signatureAccountId);
+        if (!account) {
+            return { Success: false, ErrorMessage: `Signature account '${options.signatureAccountId}' not found.` };
+        }
+        // Resolve documents: prefer caller-supplied bytes; otherwise pull from a referenced Artifact
+        // Version (so a document already in MJ — e.g. produced by an agent run — can be sent by
+        // reference instead of re-uploading base64).
+        const documents = await this.resolveDocuments(options);
+        if (!documents.length) {
+            return {
+                Success: false,
+                ErrorMessage: 'No documents supplied. Provide `documents`, or an `artifactVersionId` (or `artifactId`) to send.',
+            };
+        }
+        options = { ...options, documents };
+        const request = await this.createRequestRecord(options, account);
+        if (!request) {
+            return { Success: false, ErrorMessage: 'Failed to create signature request record.' };
+        }
+        try {
+            const driver = await this.GetDriver(options.signatureAccountId, contextUser);
+            const result = await driver.CreateEnvelope({
+                title: options.title,
+                message: options.message,
+                documents: options.documents,
+                recipients: options.recipients,
+                sendImmediately: options.sendImmediately,
+                metadata: options.metadata,
+            });
+            await this.logOperation(request.ID, 'CreateEnvelope', result.Success, 'Draft', result.status ?? null, result.ErrorMessage ?? null, contextUser, options.provider);
+            if (!result.Success) {
+                return { Success: false, signatureRequestId: request.ID, ErrorMessage: result.ErrorMessage };
+            }
+            await this.persistSentRequest(request, result.externalEnvelopeId ?? null, result.status, contextUser);
+            await this.persistRecipients(request.ID, options.recipients, contextUser, options.provider);
+            return {
+                Success: true,
+                signatureRequestId: request.ID,
+                externalEnvelopeId: result.externalEnvelopeId,
+                status: request.Status,
+            };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            await this.logOperation(request.ID, 'CreateEnvelope', false, 'Draft', null, message, contextUser, options.provider);
+            return { Success: false, signatureRequestId: request.ID, ErrorMessage: message };
+        }
+    }
+    // ---- Refresh ----------------------------------------------------------------------------------
+    /** Poll the provider for current status and persist it (plus recipient statuses). */
+    async RefreshStatus(requestId, contextUser, provider) {
+        const request = await this.loadRequest(requestId, contextUser, provider);
+        if (!request) {
+            return { Success: false, ErrorMessage: `Signature request '${requestId}' not found.` };
+        }
+        if (!request.ExternalEnvelopeID) {
+            return { Success: false, ErrorMessage: 'Signature request has not been sent yet.' };
+        }
+        const before = request.Status;
+        try {
+            const driver = await this.GetDriver(request.SignatureAccountID, contextUser);
+            const result = await driver.GetEnvelopeStatus(request.ExternalEnvelopeID);
+            await this.logOperation(request.ID, 'GetEnvelopeStatus', result.Success, before, result.status ?? null, result.ErrorMessage ?? null, contextUser, provider);
+            if (!result.Success) {
+                return { Success: false, ErrorMessage: result.ErrorMessage };
+            }
+            await this.applyStatus(request, result.status, contextUser);
+            return { Success: true, status: result.status };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            await this.logOperation(request.ID, 'GetEnvelopeStatus', false, before, null, message, contextUser, provider);
+            return { Success: false, ErrorMessage: message };
+        }
+    }
+    // ---- Download ---------------------------------------------------------------------------------
+    /** Download the executed document for a completed envelope. */
+    async DownloadSigned(requestId, contextUser, provider) {
+        const request = await this.loadRequest(requestId, contextUser, provider);
+        if (!request) {
+            return { Success: false, ErrorMessage: `Signature request '${requestId}' not found.` };
+        }
+        if (!request.ExternalEnvelopeID) {
+            return { Success: false, ErrorMessage: 'Signature request has not been sent yet.' };
+        }
+        try {
+            const driver = await this.GetDriver(request.SignatureAccountID, contextUser);
+            const result = await driver.DownloadSignedDocument(request.ExternalEnvelopeID);
+            await this.logOperation(request.ID, 'DownloadSignedDocument', result.Success, request.Status, request.Status, result.ErrorMessage ?? null, contextUser, provider);
+            if (!result.Success || !result.document) {
+                return { Success: false, ErrorMessage: result.ErrorMessage ?? 'Provider returned no document.' };
+            }
+            await this.recordSignedDocument(request, result.document, contextUser, provider);
+            return { Success: true, document: result.document };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            await this.logOperation(request.ID, 'DownloadSignedDocument', false, request.Status, null, message, contextUser, provider);
+            return { Success: false, ErrorMessage: message };
+        }
+    }
+    // ---- Void -------------------------------------------------------------------------------------
+    /** Void/cancel an in-flight envelope. */
+    async Void(requestId, reason, contextUser, provider) {
+        const request = await this.loadRequest(requestId, contextUser, provider);
+        if (!request) {
+            return { Success: false, ErrorMessage: `Signature request '${requestId}' not found.` };
+        }
+        if (!request.ExternalEnvelopeID) {
+            return { Success: false, ErrorMessage: 'Signature request has not been sent yet.' };
+        }
+        const before = request.Status;
+        try {
+            const driver = await this.GetDriver(request.SignatureAccountID, contextUser);
+            const result = await driver.VoidEnvelope(request.ExternalEnvelopeID, reason);
+            await this.logOperation(request.ID, 'VoidEnvelope', result.Success, before, result.Success ? 'Voided' : before, result.ErrorMessage ?? null, contextUser, provider);
+            if (!result.Success) {
+                return result;
+            }
+            request.Status = 'Voided';
+            request.VoidReason = reason;
+            await this.saveOrThrow(request, 'void signature request');
+            return { Success: true };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            await this.logOperation(request.ID, 'VoidEnvelope', false, before, null, message, contextUser, provider);
+            return { Success: false, ErrorMessage: message };
+        }
+    }
+    // ---- Webhook ----------------------------------------------------------------------------------
+    /**
+     * Normalize an inbound provider webhook and apply the status — fail-closed on authenticity.
+     *
+     * Flow (no env vars; HMAC secret lives in the account credential):
+     *  1. Parse the payload on a bare driver (parsing needs no secret) to discover the envelope.
+     *  2. Find the owning MJ: Signature Request, hence its account.
+     *  3. Resolve the account's *credential-initialized* driver and require
+     *     {@link BaseSignatureProvider.VerifyWebhookSignature} to pass over the raw bytes.
+     *  4. Only then apply the status.
+     *
+     * @param rawBody The exact request bytes, required for byte-accurate HMAC verification.
+     */
+    async RecordWebhookEvent(driverKey, payload, headers, contextUser, rawBody, provider) {
+        const parser = this.resolveDriverByKey(driverKey, contextUser);
+        if (!parser) {
+            return { Success: false, ErrorMessage: `No signature provider registered for driver key '${driverKey}'.` };
+        }
+        const event = parser.ParseWebhookEvent(payload, headers);
+        if (!event) {
+            return { Success: false, ErrorMessage: 'Webhook payload was not handled by the provider.' };
+        }
+        const request = await this.findRequestByEnvelopeId(event.externalEnvelopeId, contextUser, provider);
+        if (!request) {
+            await this.logOperation(null, 'Webhook', false, null, event.status, `No request for envelope '${event.externalEnvelopeId}'.`, contextUser, provider);
+            return { Success: false, event, ErrorMessage: 'No matching signature request for the webhook envelope.' };
+        }
+        // Authenticity: verify on the credential-initialized driver for the owning account, under a
+        // verify-if-configured policy. A configured-but-invalid signature is rejected; an account
+        // with no HMAC secret configured is accepted (logged) so the endpoint works pre-setup.
+        const verifier = await this.GetDriver(request.SignatureAccountID, contextUser);
+        const verification = verifier.VerifyWebhookSignature(rawBody, headers, payload);
+        if (verification === 'Failed') {
+            await this.logOperation(request.ID, 'Webhook', false, request.Status, event.status, 'Webhook signature verification failed.', contextUser, provider);
+            return { Success: false, event, ErrorMessage: 'Webhook signature verification failed.' };
+        }
+        if (verification === 'NotConfigured') {
+            LogStatus(`[eSignature] Webhook for envelope '${event.externalEnvelopeId}' accepted WITHOUT signature verification ` +
+                `(no HMAC key configured on account '${request.SignatureAccountID}'). Configure a webhook secret to enforce authenticity.`);
+        }
+        const before = request.Status;
+        await this.applyStatus(request, event.status, contextUser);
+        await this.logOperation(request.ID, 'Webhook', true, before, event.status, JSON.stringify(event), contextUser, provider);
+        return { Success: true, event };
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Persistence helpers
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Resolve the documents to send. Caller-supplied `documents` win; if none are given and an
+     * `artifactVersionId` is provided, load that version's bytes from the Artifacts subsystem.
+     * (`artifactId` without a version is recorded as provenance only — we don't guess a version.)
+     */
+    async resolveDocuments(options) {
+        if (options.documents?.length) {
+            return options.documents;
+        }
+        if (options.artifactVersionId) {
+            const doc = await loadArtifactVersionBytes(options.artifactVersionId, options.contextUser, options.provider);
+            return doc ? [doc] : [];
+        }
+        return [];
+    }
+    async createRequestRecord(options, account) {
+        const md = options.provider ?? Metadata.Provider;
+        const request = await md.GetEntityObject('MJ: Signature Requests', options.contextUser);
+        request.SignatureAccountID = account.account.ID;
+        request.Name = options.title;
+        if (options.message != null)
+            request.Message = options.message;
+        request.Status = 'Draft';
+        if (options.entityId != null)
+            request.EntityID = options.entityId;
+        if (options.recordId != null)
+            request.RecordID = options.recordId;
+        if (!(await request.Save())) {
+            LogError(`SignatureEngine: failed to create request: ${request.LatestResult?.CompleteMessage}`);
+            return null;
+        }
+        await this.persistDocuments(request.ID, options, options.contextUser, options.provider);
+        return request;
+    }
+    async persistDocuments(requestId, options, contextUser, provider) {
+        const md = provider ?? Metadata.Provider;
+        for (let i = 0; i < options.documents.length; i++) {
+            const doc = options.documents[i];
+            const row = await md.GetEntityObject('MJ: Signature Request Documents', contextUser);
+            row.SignatureRequestID = requestId;
+            row.Name = doc.filename;
+            row.Sequence = i + 1;
+            row.Role = 'Source';
+            // Record the Artifact provenance on the first document only (caller-supplied).
+            if (i === 0 && options.artifactId != null)
+                row.ArtifactID = options.artifactId;
+            if (i === 0 && options.artifactVersionId != null)
+                row.ArtifactVersionID = options.artifactVersionId;
+            await this.saveOrThrow(row, 'create signature request document');
+        }
+    }
+    async persistRecipients(requestId, recipients, contextUser, provider) {
+        const md = provider ?? Metadata.Provider;
+        for (const r of recipients) {
+            const row = await md.GetEntityObject('MJ: Signature Request Recipients', contextUser);
+            row.SignatureRequestID = requestId;
+            row.Email = r.email;
+            if (r.name != null)
+                row.Name = r.name;
+            row.RoutingOrder = r.routingOrder ?? 1;
+            if (r.role != null)
+                row.Role = r.role;
+            row.Status = 'Sent';
+            await this.saveOrThrow(row, 'create signature request recipient');
+        }
+    }
+    async persistSentRequest(request, externalEnvelopeId, status, contextUser) {
+        if (externalEnvelopeId)
+            request.ExternalEnvelopeID = externalEnvelopeId;
+        request.Status = this.persistableStatus(status, 'Sent');
+        request.SentAt = new Date();
+        await this.saveOrThrow(request, 'persist sent signature request');
+    }
+    /**
+     * Record the executed document: write the bytes back into the Artifacts subsystem (new Artifact
+     * + Version) and add a `Role='Signed'` document row linked to that version. If no File Storage
+     * Account is configured, fall back to recording the row without an artifact link (the caller
+     * still receives the bytes) — a successful download is never lost over missing storage setup.
+     */
+    async recordSignedDocument(request, document, contextUser, provider) {
+        let artifactVersionId;
+        try {
+            const written = await writeSignedArtifact({
+                filename: document.filename,
+                bytes: document.bytes,
+                contentType: document.contentType,
+                title: `${request.Name} (signed)`,
+                contextUser,
+                provider,
+            });
+            artifactVersionId = written?.artifactVersionId;
+        }
+        catch (e) {
+            // Artifact write-back is best-effort; log and still record the document row.
+            LogError(`SignatureEngine: failed to write signed document to Artifacts: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        const md = provider ?? Metadata.Provider;
+        const row = await md.GetEntityObject('MJ: Signature Request Documents', contextUser);
+        row.SignatureRequestID = request.ID;
+        row.Name = document.filename;
+        row.Sequence = 1;
+        row.Role = 'Signed';
+        if (artifactVersionId) {
+            row.ArtifactVersionID = artifactVersionId;
+        }
+        await this.saveOrThrow(row, 'record signed document');
+    }
+    /** Apply a normalized status to a request, stamping CompletedAt on terminal completion. */
+    async applyStatus(request, status, contextUser) {
+        const persistable = this.persistableStatus(status, request.Status);
+        request.Status = persistable;
+        if (persistable === 'Completed' && !request.CompletedAt) {
+            request.CompletedAt = new Date();
+        }
+        await this.saveOrThrow(request, 'apply signature status');
+    }
+    async logOperation(requestId, operation, success, statusBefore, statusAfter, detail, contextUser, provider) {
+        try {
+            const md = provider ?? Metadata.Provider;
+            const log = await md.GetEntityObject('MJ: Signature Request Logs', contextUser);
+            if (requestId)
+                log.SignatureRequestID = requestId;
+            log.Operation = operation;
+            log.Success = success;
+            if (statusBefore)
+                log.StatusBefore = statusBefore;
+            if (statusAfter)
+                log.StatusAfter = statusAfter;
+            if (detail != null)
+                log.Detail = detail;
+            await log.Save();
+        }
+        catch (e) {
+            // Logging must never break the operation it records.
+            LogError(`SignatureEngine: failed to write log for '${operation}': ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Lookups / small helpers
+    // ─────────────────────────────────────────────────────────────────────────
+    async loadRequest(requestId, contextUser, provider) {
+        const md = provider ?? Metadata.Provider;
+        const request = await md.GetEntityObject('MJ: Signature Requests', contextUser);
+        const loaded = await request.Load(requestId);
+        return loaded ? request : null;
+    }
+    async findRequestByEnvelopeId(externalEnvelopeId, contextUser, provider) {
+        const rv = provider ? RunView.FromMetadataProvider(provider) : new RunView();
+        const result = await rv.RunView({
+            EntityName: 'MJ: Signature Requests',
+            ExtraFilter: `ExternalEnvelopeID = '${externalEnvelopeId.replace(/'/g, "''")}'`,
+            ResultType: 'entity_object',
+            MaxRows: 1,
+        }, contextUser);
+        return result.Success && result.Results.length > 0 ? result.Results[0] : null;
+    }
+    resolveDriverByKey(driverKey, _contextUser) {
+        return MJGlobal.Instance.ClassFactory.CreateInstance(BaseSignatureProvider, driverKey) ?? null;
+    }
+    /** Coerce a normalized status (which may be 'Unknown') into a DB-persistable status. */
+    persistableStatus(status, fallback) {
+        const candidate = !status || status === 'Unknown' ? fallback : status;
+        return candidate === 'Unknown' ? 'Sent' : candidate;
+    }
+    async saveOrThrow(entity, action) {
+        if (!(await entity.Save())) {
+            throw new Error(`SignatureEngine: failed to ${action}: ${entity.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=SignatureEngine.js.map

package/dist/server/SignatureEngine.js.map

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

package/dist/server/artifacts.d.ts

@@ -0,0 +1,44 @@
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { SignatureDocumentInput } from '../types.js';
+/**
+ * Artifact <-> eSignature glue. Two server-side flows:
+ *   - {@link loadArtifactVersionBytes}: read the bytes of an existing Artifact Version so a caller
+ *     can send a document already in MJ for signature (instead of re-uploading base64).
+ *   - {@link writeSignedArtifact}: persist a downloaded, executed PDF back into the Artifacts
+ *     subsystem as a new Artifact + Version, so the signed document is first-class (agents,
+ *     viewers, downstream automation can consume it).
+ *
+ * Both use @memberjunction/storage for the File-mode byte transfer — the same path the file
+ * resolvers use — so there's no bespoke storage handling here.
+ */
+/** Outcome of writing a signed document back to the Artifacts subsystem. */
+export interface WriteSignedArtifactResult {
+    /** New Artifact created to hold the signed document. */
+    artifactId: string;
+    /** New Artifact Version holding the signed PDF bytes. */
+    artifactVersionId: string;
+    /** Backing File row. */
+    fileId: string;
+}
+/**
+ * Resolve the raw bytes of an Artifact Version. Supports both content modes:
+ *   - `Text`  — bytes come from the inline `Content` column.
+ *   - `File`  — bytes are fetched from the backing storage provider via the File's ProviderKey.
+ * Returns null if the version can't be loaded or yields no content.
+ */
+export declare function loadArtifactVersionBytes(artifactVersionId: string, contextUser: UserInfo, provider?: IMetadataProvider): Promise<SignatureDocumentInput | null>;
+/**
+ * Write an executed document back into the Artifacts subsystem as a new Artifact + Version.
+ * Returns null (and logs) when no File Storage Account is configured — callers treat this as a
+ * soft failure so a successful download is never lost just because artifact storage isn't set up.
+ */
+export declare function writeSignedArtifact(options: {
+    filename: string;
+    bytes: Buffer;
+    contentType: string;
+    /** Names the new Artifact; defaults to the filename. */
+    title?: string;
+    contextUser: UserInfo;
+    provider?: IMetadataProvider;
+}): Promise<WriteSignedArtifactResult | null>;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/server/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/server/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAuB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AASxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;;;;;GAUG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACtC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC1C,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,QAAQ,EACrB,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAuBxC;AAqBD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAChC,GACF,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAiC3C"}

package/dist/server/artifacts.js

@@ -0,0 +1,107 @@
+import { LogStatus, Metadata } from '@memberjunction/core';
+import { ArtifactMetadataEngine, MJEnvironmentEntityExtended, } from '@memberjunction/core-entities';
+import { FileStorageEngine } from '@memberjunction/storage';
+/**
+ * Resolve the raw bytes of an Artifact Version. Supports both content modes:
+ *   - `Text`  — bytes come from the inline `Content` column.
+ *   - `File`  — bytes are fetched from the backing storage provider via the File's ProviderKey.
+ * Returns null if the version can't be loaded or yields no content.
+ */
+export async function loadArtifactVersionBytes(artifactVersionId, contextUser, provider) {
+    const md = provider ?? Metadata.Provider;
+    const version = await md.GetEntityObject('MJ: Artifact Versions', contextUser);
+    if (!(await version.Load(artifactVersionId))) {
+        return null;
+    }
+    const filename = version.FileName || version.Name || `${artifactVersionId}.bin`;
+    const contentType = version.MimeType || 'application/octet-stream';
+    if (version.ContentMode === 'Text') {
+        if (version.Content == null) {
+            return null;
+        }
+        return { bytes: Buffer.from(version.Content, 'utf8'), filename, contentType };
+    }
+    // File mode — pull the bytes from storage.
+    if (!version.FileID) {
+        return null;
+    }
+    const bytes = await readFileBytes(version.FileID, contextUser, provider);
+    return bytes ? { bytes, filename, contentType } : null;
+}
+/** Read a File row's bytes from its storage provider. Null if the file/account can't be resolved. */
+async function readFileBytes(fileId, contextUser, provider) {
+    const md = provider ?? Metadata.Provider;
+    const file = await md.GetEntityObject('MJ: Files', contextUser);
+    if (!(await file.Load(fileId))) {
+        return null;
+    }
+    await FileStorageEngine.Instance.Config(false, contextUser, provider);
+    const accounts = FileStorageEngine.Instance.GetAccountsByProviderID(file.ProviderID);
+    if (accounts.length === 0) {
+        LogStatus(`[eSignature] No storage account for provider '${file.ProviderID}'; cannot read file '${fileId}'.`);
+        return null;
+    }
+    const driver = await FileStorageEngine.Instance.GetDriver(accounts[0].ID, contextUser);
+    return driver.GetObject({ fullPath: file.ProviderKey ?? file.Name });
+}
+/**
+ * Write an executed document back into the Artifacts subsystem as a new Artifact + Version.
+ * Returns null (and logs) when no File Storage Account is configured — callers treat this as a
+ * soft failure so a successful download is never lost just because artifact storage isn't set up.
+ */
+export async function writeSignedArtifact(options) {
+    const { filename, bytes, contentType, contextUser, provider } = options;
+    const md = provider ?? Metadata.Provider;
+    await FileStorageEngine.Instance.Config(false, contextUser, provider);
+    if (!FileStorageEngine.Instance.ResolveStorageAccount()) {
+        LogStatus('[eSignature] No File Storage Account configured; skipping signed-document artifact write-back.');
+        return null;
+    }
+    const upload = await FileStorageEngine.Instance.UploadFile({
+        content: bytes,
+        fileName: filename,
+        mimeType: contentType,
+        contextUser,
+        provider,
+    });
+    const artifact = await createArtifact(options.title ?? filename, contentType, filename, contextUser, provider);
+    const version = await md.GetEntityObject('MJ: Artifact Versions', contextUser);
+    version.ArtifactID = artifact.ID;
+    version.VersionNumber = 1;
+    version.ContentMode = 'File';
+    version.FileID = upload.FileID;
+    version.MimeType = contentType;
+    version.FileName = filename;
+    version.ContentSizeBytes = bytes.length;
+    version.UserID = contextUser.ID;
+    if (!(await version.Save())) {
+        throw new Error(`writeSignedArtifact: failed to save Artifact Version: ${version.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+    }
+    return { artifactId: artifact.ID, artifactVersionId: version.ID, fileId: upload.FileID };
+}
+/** Create the parent Artifact row, typed from the document MIME (falls back to Generic Binary). */
+async function createArtifact(name, contentType, filename, contextUser, provider) {
+    const md = provider ?? Metadata.Provider;
+    const artifact = await md.GetEntityObject('MJ: Artifacts', contextUser);
+    artifact.Name = name;
+    artifact.TypeID = await resolveArtifactTypeId(contentType, filename, contextUser, provider);
+    artifact.EnvironmentID = MJEnvironmentEntityExtended.DefaultEnvironmentID;
+    artifact.UserID = contextUser.ID;
+    if (!(await artifact.Save())) {
+        throw new Error(`writeSignedArtifact: failed to save Artifact: ${artifact.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+    }
+    return artifact;
+}
+/** Resolve an Artifact Type for the document, preferring a MIME match, then a Generic Binary fallback. */
+async function resolveArtifactTypeId(contentType, filename, contextUser, provider) {
+    await ArtifactMetadataEngine.Instance.Config(false, contextUser, provider);
+    const ext = filename.split('.').pop();
+    const byMime = ArtifactMetadataEngine.Instance.GetArtifactTypeByMimeType(contentType, ext);
+    const fallback = ArtifactMetadataEngine.Instance.FindArtifactType('Generic Binary');
+    const type = byMime ?? fallback;
+    if (!type) {
+        throw new Error("writeSignedArtifact: no Artifact Type resolved (neither a MIME match nor 'Generic Binary').");
+    }
+    return type.ID;
+}
+//# sourceMappingURL=artifacts.js.map