@acorex-platform/extension-ai-document-client 0.0.21

package/fesm2022/acorex-platform-extension-ai-document-client-contracts.mjs

@@ -0,0 +1,22 @@
+/**
+ * Tenant settings for optional OCR-based metadata prefill on image uploads (AI Document extension).
+ */
+var AXEDocumentMetadataOcrSettings;
+(function (AXEDocumentMetadataOcrSettings) {
+    /** When true, eligible attachment dialogs may offer OCR after an image is chosen. */
+    AXEDocumentMetadataOcrSettings["Enabled"] = "AiDocument:Setting:MetadataOcr.Enabled";
+    /**
+     * Optional assist primary key (`Assist.id`). Metadata OCR uses ExtractDocumentText (assist chat model).
+     */
+    AXEDocumentMetadataOcrSettings["AssistId"] = "AiDocument:Setting:MetadataOcr.AssistId";
+})(AXEDocumentMetadataOcrSettings || (AXEDocumentMetadataOcrSettings = {}));
+
+//#region ---- Contracts barrel ----
+//#endregion
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AXEDocumentMetadataOcrSettings };
+//# sourceMappingURL=acorex-platform-extension-ai-document-client-contracts.mjs.map

package/fesm2022/acorex-platform-extension-ai-document-client-contracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-platform-extension-ai-document-client-contracts.mjs","sources":["../../../../libs/extensions/ai/document/contracts/src/document-metadata-ocr.settings.keys.ts","../../../../libs/extensions/ai/document/contracts/src/index.ts","../../../../libs/extensions/ai/document/contracts/src/acorex-platform-extension-ai-document-client-contracts.ts"],"sourcesContent":["/**\r\n * Tenant settings for optional OCR-based metadata prefill on image uploads (AI Document extension).\r\n */\r\nexport enum AXEDocumentMetadataOcrSettings {\r\n  /** When true, eligible attachment dialogs may offer OCR after an image is chosen. */\r\n  Enabled = 'AiDocument:Setting:MetadataOcr.Enabled',\r\n\r\n  /**\r\n   * Optional assist primary key (`Assist.id`). Metadata OCR uses ExtractDocumentText (assist chat model).\r\n   */\r\n  AssistId = 'AiDocument:Setting:MetadataOcr.AssistId',\r\n}\r\n","//#region ---- Contracts barrel ----\n\nexport * from './document-metadata-ocr.settings.keys';\n\n//#endregion\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"AAAA;;AAEG;IACS;AAAZ,CAAA,UAAY,8BAA8B,EAAA;;AAExC,IAAA,8BAAA,CAAA,SAAA,CAAA,GAAA,wCAAkD;AAElD;;AAEG;AACH,IAAA,8BAAA,CAAA,UAAA,CAAA,GAAA,yCAAoD;AACtD,CAAC,EARW,8BAA8B,KAA9B,8BAA8B,GAAA,EAAA,CAAA,CAAA;;ACH1C;AAIA;;ACJA;;AAEG;;;;"}

package/fesm2022/acorex-platform-extension-ai-document-client.mjs

@@ -0,0 +1,840 @@
+import * as i0 from '@angular/core';
+import { Injectable, inject, NgModule } from '@angular/core';
+import { AXMAiManagementModule } from '@acorex-platform/module-ai-management-client';
+import { AXMDocumentManagementModule } from '@acorex-platform/module-document-management-client';
+import { AXPFileStorageService, AXPSettingsService, AXPDebugService, extractRequestErrorInfo, AXP_SETTING_DEFINITION_PROVIDER } from '@acorex-platform/framework-client/common';
+import { objectKeyValueTransforms, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER } from '@acorex-platform/framework-client/core';
+import { RootConfig, canAiExtractDocument, AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY } from '@acorex-platform/module-ai-management-client/contracts';
+import { AXPWidgetsCatalog, AXPFileStorageStatus, runtimeCommandPayloadData } from '@acorex-platform/framework-shared/core';
+import { AXEDocumentMetadataOcrSettings } from '@acorex-platform/extension-ai-document-client/contracts';
+import { AXP_LAYOUT_BUILDER_DIALOG_CONTEXT_CHANGED_HOOK_KEY } from '@acorex-platform/framework-client/layout/builder';
+import { AXDialogService } from '@acorex/components/dialog';
+import { AXLoadingDialogService } from '@acorex/components/loading-dialog';
+import { AXTranslationService } from '@acorex/core/translation';
+import { AXPCommandService } from '@acorex-platform/framework-client/runtime';
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Settings provider ----
+const METADATA_OCR_I18N = '@extensions-ai-document:settings.metadata-ocr';
+/** Must match the settings group `name` from the document-management module (`AXPDocumentManagementSettingProvider`). */
+const DOCUMENT_MANAGEMENT_SETTINGS_GROUP = 'document-management';
+class AXEDocumentAiSettingProvider {
+    async provide(context) {
+        if (!context.hasGroup(DOCUMENT_MANAGEMENT_SETTINGS_GROUP)) {
+            return;
+        }
+        const assistVisibility = `{{ context.eval('${AXEDocumentMetadataOcrSettings.Enabled}') }}`;
+        const documentManagement = context.group(DOCUMENT_MANAGEMENT_SETTINGS_GROUP);
+        if (!documentManagement) {
+            return;
+        }
+        documentManagement
+            .addSection('metadata-ocr', `${METADATA_OCR_I18N}.section-title`, `${METADATA_OCR_I18N}.section-description`)
+            .addSetting({
+            key: AXEDocumentMetadataOcrSettings.Enabled,
+            title: `${METADATA_OCR_I18N}.enabled-title`,
+            scope: 'T',
+            overridableAt: [],
+            isInherited: true,
+            defaultValue: true,
+            searchTagKeys: [`${METADATA_OCR_I18N}.enabled-search-tags`],
+            widget: {
+                type: AXPWidgetsCatalog.toggle,
+            },
+            description: `${METADATA_OCR_I18N}.enabled-description`,
+        })
+            .addSetting({
+            key: AXEDocumentMetadataOcrSettings.AssistId,
+            title: `${METADATA_OCR_I18N}.assist-id-title`,
+            scope: 'T',
+            overridableAt: [],
+            isInherited: true,
+            // Persist assist primary key (`id`); demo defaults come from settings seed/overrides.
+            searchTagKeys: [`${METADATA_OCR_I18N}.assist-search-tags`],
+            valueTransforms: objectKeyValueTransforms('id'),
+            widget: {
+                type: AXPWidgetsCatalog.lookup,
+                options: {
+                    entity: `${RootConfig.module.name}.${RootConfig.entities.assist.name}`,
+                    look: 'select',
+                    multiple: false,
+                    textField: 'title',
+                    valueField: 'id',
+                    hasClearButton: true,
+                    visibility: assistVisibility,
+                },
+            },
+            description: `${METADATA_OCR_I18N}.assist-id-description`,
+        })
+            .endSection();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentAiSettingProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentAiSettingProvider }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentAiSettingProvider, decorators: [{
+            type: Injectable
+        }] });
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Constants ----
+/**
+ * Synthetic mapping key for the document-level Expire Date control
+ * (`file-*.expirationDate` when the document type has `enableExpiration`).
+ * Not part of `metaDataForm`.
+ */
+const DOCUMENT_EXPIRATION_DATE_FIELD_NAME = 'expirationDate';
+//#endregion
+//#region ---- Field collection ----
+/**
+ * Flattens metadata selector value into field descriptors for LLM mapping prompts.
+ */
+function collectMetadataFieldDescriptors(meta) {
+    if (!meta?.groups?.length) {
+        return [];
+    }
+    const out = [];
+    for (const g of meta.groups) {
+        for (const f of g.fields ?? []) {
+            out.push({
+                name: f.name,
+                title: f.title ?? f.name,
+                interfaceType: f.interface,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Appends the platform document expire-date field used by attachment dialogs.
+ */
+function withDocumentExpirationField(fields, include) {
+    if (!include) {
+        return fields;
+    }
+    if (fields.some((f) => f.name === DOCUMENT_EXPIRATION_DATE_FIELD_NAME)) {
+        return fields;
+    }
+    return [
+        ...fields,
+        {
+            name: DOCUMENT_EXPIRATION_DATE_FIELD_NAME,
+            title: 'Expire Date',
+            interfaceType: 'date-time-editor',
+        },
+    ];
+}
+//#endregion
+//#region ---- JSON parsing ----
+/**
+ * Coerces common OCR / LLM date strings into YYYY-MM-DD (or leaves non-dates unchanged).
+ */
+function normalizePrefillDateValue(value) {
+    if (value == null || value === '') {
+        return value;
+    }
+    if (value instanceof Date && !Number.isNaN(value.getTime())) {
+        return toIsoDateOnly(value);
+    }
+    if (typeof value !== 'string') {
+        return value;
+    }
+    const raw = value.trim();
+    if (!raw) {
+        return value;
+    }
+    const iso = /^(\d{4})-(\d{2})-(\d{2})/.exec(raw);
+    if (iso) {
+        return `${iso[1]}-${iso[2]}-${iso[3]}`;
+    }
+    // US-style MM/DD/YYYY (common on driver licences).
+    const us = /^(\d{1,2})\/(\d{1,2})\/(\d{4})$/.exec(raw);
+    if (us) {
+        const month = Number(us[1]);
+        const day = Number(us[2]);
+        const year = Number(us[3]);
+        if (month >= 1 && month <= 12 && day >= 1 && day <= 31) {
+            return `${year}-${pad2(month)}-${pad2(day)}`;
+        }
+    }
+    const parsed = new Date(raw);
+    if (!Number.isNaN(parsed.getTime())) {
+        return toIsoDateOnly(parsed);
+    }
+    return value;
+}
+function pad2(n) {
+    return n < 10 ? `0${n}` : String(n);
+}
+function toIsoDateOnly(d) {
+    return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
+}
+/**
+ * Normalizes date-like mapped values for date widgets; strips the synthetic expiration key from meta.
+ */
+function splitMappedPrefill(parsed, fields) {
+    const dateNames = new Set(fields
+        .filter((f) => {
+        const t = String(f.interfaceType ?? '').toLowerCase();
+        return t.includes('date-time') || t.includes('date');
+    })
+        .map((f) => f.name));
+    const meta = {};
+    let expirationDate;
+    for (const [k, v] of Object.entries(parsed)) {
+        const normalized = dateNames.has(k) ? normalizePrefillDateValue(v) : v;
+        if (k === DOCUMENT_EXPIRATION_DATE_FIELD_NAME) {
+            if (typeof normalized === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(normalized)) {
+                expirationDate = normalized;
+            }
+            else if (normalized instanceof Date && !Number.isNaN(normalized.getTime())) {
+                expirationDate = toIsoDateOnly(normalized);
+            }
+            continue;
+        }
+        meta[k] = normalized;
+    }
+    return expirationDate ? { meta, expirationDate } : { meta };
+}
+/**
+ * Parses a JSON object from an assistant reply (strips optional ```json fences).
+ */
+function parseMetadataMappingJson(text) {
+    const trimmed = text.trim();
+    const fence = /^```(?:json)?\s*([\s\S]*?)```$/m.exec(trimmed);
+    const raw = fence ? fence[1].trim() : trimmed;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed != null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return {};
+}
+/**
+ * Shallow merge: only fills keys that are empty in `existing`.
+ */
+function mergeMetadataPrefill(existing, partial) {
+    const base = { ...(existing ?? {}) };
+    for (const [k, v] of Object.entries(partial)) {
+        const cur = base[k];
+        const empty = cur === undefined || cur === null || cur === '';
+        if (empty && v !== undefined && v !== null && v !== '') {
+            base[k] = v;
+        }
+    }
+    return base;
+}
+/**
+ * Returns true when the file list item is supported for AI document text extraction.
+ */
+function isAiExtractableFileListItem(item) {
+    if (!item) {
+        return false;
+    }
+    const t = typeof item.type === 'string' ? item.type : '';
+    const name = String(item.name ?? '');
+    if (canAiExtractDocument(t, name)) {
+        return true;
+    }
+    const src = item.source?.value;
+    if (src instanceof Blob) {
+        const blobType = typeof src.type === 'string' ? src.type : '';
+        if (canAiExtractDocument(blobType, name)) {
+            return true;
+        }
+    }
+    if (src instanceof File) {
+        if (canAiExtractDocument(src.type, src.name || name)) {
+            return true;
+        }
+    }
+    return false;
+}
+//#endregion
+
+//#region ----- Imports -----
+//#endregion
+//#region ----- Constants -----
+const DOCUMENT_MODULE_REF_TYPE = 'DocumentManagement.Document';
+const SINGLE_DOCUMENT_PROGRESS_SCOPE = { documentIndex: 1, documentCount: 1 };
+//#endregion
+//#region ----- Local helpers -----
+const OCR_FAILED_I18N = '@extensions-ai-document:widgets.metadata-ai-fill.ocr-failed';
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new DOMException('Aborted', 'AbortError');
+    }
+}
+function stringifyErrorDetails(details) {
+    if (typeof details === 'string' && details.trim()) {
+        return details.trim();
+    }
+    if (details == null) {
+        return '';
+    }
+    try {
+        return JSON.stringify(details);
+    }
+    catch {
+        return String(details);
+    }
+}
+//#endregion
+//#region ----- Service -----
+/**
+ * Runs AI document text extraction for metadata prefill (images, PDF, simple text files).
+ * ExtractDocumentText command; when field names are passed it returns a key/value object.
+ */
+class AXEDocumentMetadataAiPrefillService {
+    constructor() {
+        //#region ----- Services & Dependencies -----
+        this.fileStorage = inject(AXPFileStorageService);
+        this.commandService = inject(AXPCommandService);
+        this.settings = inject(AXPSettingsService);
+        this.debug = inject(AXPDebugService);
+    }
+    //#endregion
+    /**
+     * Whether OCR metadata prefill is enabled in tenant settings.
+     * Defaults to true when the setting has never been stored (opt-out via settings UI).
+     */
+    async isMetadataOcrEnabled() {
+        const v = await this.settings.get(AXEDocumentMetadataOcrSettings.Enabled);
+        if (v == null) {
+            return true;
+        }
+        return v;
+    }
+    /**
+     * Whether {@link applyDialogContextMetadataAiFillFromDocuments} would extract at least one document
+     * (caller can safely show an indeterminate loading dialog).
+     */
+    willApplyMetadataAiFillFromDocuments(dialogRef, integration) {
+        if (!dialogRef.patchContext) {
+            return false;
+        }
+        const documentType = integration['documentType'];
+        const metaDataList = documentType?.metaDataList;
+        const fields = withDocumentExpirationField(collectMetadataFieldDescriptors(metaDataList ?? undefined), !!documentType?.enableExpiration);
+        if (fields.length === 0) {
+            return false;
+        }
+        const ctx = dialogRef.context();
+        const files = ctx['files'];
+        const n = files?.length ?? 0;
+        for (let i = 0; i < n; i++) {
+            const slot = files[i]?.file;
+            const first = Array.isArray(slot) ? slot[0] : undefined;
+            if (first && isAiExtractableFileListItem(first)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Uploads a blob-backed file item to storage for vision APIs that require {@link fileId}.
+     */
+    async ensureStoredFileId(fileItem, folderId) {
+        // Only trust an explicit storage fileId. Chooser items use a client UUID on `id` with `source.kind === 'blob'`.
+        if (fileItem.source?.kind === 'fileId' && typeof fileItem.source.value === 'string') {
+            const storedId = fileItem.source.value.trim();
+            if (storedId) {
+                return storedId;
+            }
+        }
+        const file = this.resolveFileForUpload(fileItem);
+        if (!file) {
+            return null;
+        }
+        const refId = folderId?.trim() || 'document-metadata-ocr-prefill';
+        const saved = await this.fileStorage.save({
+            file,
+            name: fileItem.name,
+            refId,
+            refType: DOCUMENT_MODULE_REF_TYPE,
+            category: 'document',
+            status: AXPFileStorageStatus.Temporary,
+        });
+        return saved.fileId?.trim() || null;
+    }
+    /**
+     * OCR + field extraction in one vision call; returns merged metadata (only fills empty keys in {@link existingMeta}).
+     */
+    async prefillFromDocumentExtract(options) {
+        const signal = options.signal;
+        const notify = (phase, scope = options.progressScope ??
+            SINGLE_DOCUMENT_PROGRESS_SCOPE) => options.signalProgress?.({ phase, ...scope });
+        throwIfAborted(signal);
+        const fields = withDocumentExpirationField(collectMetadataFieldDescriptors(options.metaDataList ?? undefined), !!options.includeDocumentExpiration);
+        if (fields.length === 0) {
+            return { extractText: '', merged: { ...(options.existingMeta ?? {}) } };
+        }
+        notify('uploading');
+        const fileId = await this.ensureStoredFileId(options.fileItem, options.folderId);
+        throwIfAborted(signal);
+        if (!fileId) {
+            throw new Error('Could not upload the file for document extraction.');
+        }
+        notify('extracting');
+        const extractResult = await this.commandService.execute(AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY, {
+            fileId,
+            fields: fields.map((field) => field.name),
+        });
+        throwIfAborted(signal);
+        if (extractResult?.success === false) {
+            throw this.extractCommandFailure(extractResult);
+        }
+        const extractData = runtimeCommandPayloadData(extractResult);
+        const extractText = typeof extractData?.text === 'string' ? extractData.text : '';
+        const parsed = extractData?.values && typeof extractData.values === 'object' && !Array.isArray(extractData.values)
+            ? extractData.values
+            : parseMetadataMappingJson(extractText);
+        if (Object.keys(parsed).length === 0 && !extractText.trim()) {
+            throw this.extractCommandFailure(extractResult);
+        }
+        const { meta, expirationDate } = splitMappedPrefill(parsed, fields);
+        const merged = mergeMetadataPrefill(options.existingMeta, meta);
+        const existingExpEmpty = options.existingExpirationDate === undefined ||
+            options.existingExpirationDate === null ||
+            options.existingExpirationDate === '';
+        return {
+            extractText,
+            merged,
+            ...(existingExpEmpty && expirationDate ? { expirationDate } : {}),
+        };
+    }
+    /**
+     * For each extractable document slot in `context.files`, merges extraction + AI metadata into `file-{i}.metaDataForm`.
+     */
+    async applyDialogContextMetadataAiFillFromDocuments(dialogRef, integration, options) {
+        if (!dialogRef.patchContext) {
+            return;
+        }
+        const folderId = String(integration['parentId'] ?? '').trim();
+        const documentType = integration['documentType'];
+        const metaDataList = documentType?.metaDataList;
+        const includeDocumentExpiration = !!documentType?.enableExpiration;
+        const ctx = dialogRef.context();
+        const files = ctx['files'];
+        const n = files?.length ?? 0;
+        const patch = {};
+        const documentIndices = [];
+        for (let i = 0; i < n; i++) {
+            const slot = files[i]?.file;
+            const first = Array.isArray(slot) ? slot[0] : undefined;
+            if (first && isAiExtractableFileListItem(first)) {
+                documentIndices.push(i);
+            }
+        }
+        const signal = options?.signal;
+        const documentCount = documentIndices.length;
+        if (documentCount > 0) {
+            options?.signalProgress?.({
+                phase: 'preparing',
+                documentIndex: 1,
+                documentCount,
+            });
+            throwIfAborted(signal);
+        }
+        let processed = 0;
+        for (const i of documentIndices) {
+            throwIfAborted(signal);
+            processed += 1;
+            const slot = files[i]?.file;
+            const first = Array.isArray(slot) ? slot[0] : undefined;
+            if (!first) {
+                continue;
+            }
+            const fileBlock = ctx[`file-${i}`];
+            const existingMeta = fileBlock?.['metaDataForm'];
+            const { merged, expirationDate } = await this.prefillFromDocumentExtract({
+                fileItem: first,
+                folderId,
+                metaDataList,
+                existingMeta,
+                includeDocumentExpiration,
+                existingExpirationDate: fileBlock?.['expirationDate'],
+                progressScope: { documentIndex: processed, documentCount },
+                signal,
+                signalProgress: options?.signalProgress,
+            });
+            patch[`file-${i}`] = {
+                ...(typeof fileBlock === 'object' && fileBlock ? fileBlock : {}),
+                metaDataForm: merged,
+                ...(expirationDate ? { expirationDate } : {}),
+            };
+        }
+        if (Object.keys(patch).length > 0) {
+            dialogRef.patchContext(patch);
+        }
+    }
+    //#region ----- Utility Methods -----
+    extractCommandFailure(extractResult) {
+        const info = extractRequestErrorInfo(extractResult);
+        const details = stringifyErrorDetails(info?.details);
+        this.debug.error('ai-document', 'extract-document-text', 'ExtractDocumentText failed', () => ({
+            message: info?.message,
+            details: info?.details,
+        }));
+        if (this.debug.isDebugMode() && details) {
+            return new Error(details);
+        }
+        const text = typeof info?.message === 'string' ? info.message.trim() : '';
+        if (text.startsWith('@')) {
+            return new Error(text);
+        }
+        return new Error(OCR_FAILED_I18N);
+    }
+    resolveFileForUpload(item) {
+        const v = item.source?.value;
+        if (v instanceof File) {
+            return v;
+        }
+        if (item.source?.kind === 'blob' && v instanceof Blob) {
+            return new File([v], item.name, { type: item.type ?? v.type ?? 'application/octet-stream' });
+        }
+        return null;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentMetadataAiPrefillService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentMetadataAiPrefillService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentMetadataAiPrefillService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+//#region ---- Imports ----
+//#endregion
+const METADATA_AI_CONFIRM_I18N = '@extensions-ai-document:widgets.metadata-ai-fill.confirm';
+const METADATA_AI_LOADING_I18N = '@extensions-ai-document:widgets.metadata-ai-fill.loading';
+/** Smoother dismiss after work completes. */
+const LOADING_DIALOG_CLOSE_DELAY_MS = 400;
+//#region ---- Orchestrator ----
+/**
+ * Shared OCR + AI metadata prefill UX: confirm after image choose, then indeterminate loading dialog.
+ */
+class AXEDocumentMetadataAiFillOrchestrator {
+    constructor() {
+        //#region ---- Dependencies ----
+        this.prefill = inject(AXEDocumentMetadataAiPrefillService);
+        this.dialogService = inject(AXDialogService);
+        this.loadingDialog = inject(AXLoadingDialogService);
+        this.translation = inject(AXTranslationService);
+        this.debug = inject(AXPDebugService);
+    }
+    //#endregion
+    //#region ---- Public API ----
+    /**
+     * Asks whether to run OCR; on Yes runs {@link run}, on No returns {@link AXEDocumentMetadataAiFillRunResult.declined}.
+     */
+    async confirmAndRun(dialogTarget, integration) {
+        if (!this.prefill.willApplyMetadataAiFillFromDocuments(dialogTarget, integration)) {
+            return { success: true };
+        }
+        const [title, message] = await Promise.all([
+            this.translation.translateAsync(`${METADATA_AI_CONFIRM_I18N}.title`),
+            this.translation.translateAsync(`${METADATA_AI_CONFIRM_I18N}.message`),
+        ]);
+        const dialogResult = await this.dialogService.confirm(title, message, 'primary', 'horizontal', false, 'cancel');
+        if (!dialogResult.result) {
+            return { success: true, declined: true };
+        }
+        return this.run(dialogTarget, integration);
+    }
+    /**
+     * Runs metadata AI fill when eligible; shows an indeterminate loading dialog while work is in progress.
+     */
+    async run(dialogTarget, integration) {
+        const showLoading = this.prefill.willApplyMetadataAiFillFromDocuments(dialogTarget, integration);
+        const abortController = new AbortController();
+        let loadingDismissedEarly = false;
+        let progressDialog;
+        if (showLoading) {
+            const [title, initial, skipLabel] = await Promise.all([
+                this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.title`),
+                this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.initial`),
+                this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.skip-button`),
+            ]);
+            progressDialog = this.loadingDialog.show({
+                title,
+                mode: 'indeterminate',
+                progressColor: 'primary',
+                text: initial,
+                buttons: [
+                    {
+                        text: skipLabel,
+                        onClick: () => {
+                            loadingDismissedEarly = true;
+                            abortController.abort();
+                            progressDialog?.close();
+                        },
+                    },
+                ],
+            });
+        }
+        try {
+            await this.prefill.applyDialogContextMetadataAiFillFromDocuments(dialogTarget, integration, {
+                signal: showLoading ? abortController.signal : undefined,
+                signalProgress: (event) => {
+                    if (!progressDialog) {
+                        return;
+                    }
+                    void this.applyProgressText(progressDialog, event);
+                },
+            });
+            if (progressDialog && !loadingDismissedEarly) {
+                await this.markProgressComplete(progressDialog);
+            }
+            return { success: true };
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === 'AbortError') {
+                return { success: false, cancelled: true };
+            }
+            const errorMessage = await this.resolveFailureMessage(err);
+            if (progressDialog && !loadingDismissedEarly) {
+                try {
+                    progressDialog.setProgressColor('danger');
+                    progressDialog.setProgressText(errorMessage);
+                }
+                catch {
+                    // Ignore dialog update failures.
+                }
+            }
+            if (this.debug.isDebugMode() && progressDialog && !loadingDismissedEarly) {
+                loadingDismissedEarly = true;
+            }
+            return { success: false, errorMessage };
+        }
+        finally {
+            if (progressDialog !== undefined && !loadingDismissedEarly) {
+                const dlg = progressDialog;
+                setTimeout(() => dlg.close(), LOADING_DIALOG_CLOSE_DELAY_MS);
+            }
+        }
+    }
+    //#endregion
+    //#region ---- Progress ----
+    async applyProgressText(dialog, event) {
+        try {
+            dialog.setProgressColor('primary');
+            const line = await this.formatProgressLine(event);
+            dialog.setProgressText(line);
+        }
+        catch {
+            // Ignore translation / dialog failures; keep the previous UI state.
+        }
+    }
+    async markProgressComplete(dialog) {
+        try {
+            dialog.setProgressColor('success');
+            dialog.setProgressText(await this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.complete`));
+        }
+        catch {
+            dialog.setProgressColor('success');
+        }
+    }
+    async resolveFailureMessage(err) {
+        const raw = err instanceof Error ? err.message.trim() : '';
+        if (this.debug.isDebugMode() && raw && !raw.startsWith('@')) {
+            const prefix = await this.translation.translateAsync('@extensions-ai-document:widgets.metadata-ai-fill.ocr-failed-prefix');
+            return `${prefix} ${raw}`;
+        }
+        const key = raw.startsWith('@') ? raw : '@extensions-ai-document:widgets.metadata-ai-fill.ocr-failed';
+        return this.translation.translateAsync(key);
+    }
+    async formatProgressLine(event) {
+        const phaseKey = `${METADATA_AI_LOADING_I18N}.thinking.${event.phase}`;
+        const phaseText = await this.translation.translateAsync(phaseKey);
+        if (event.documentCount > 1) {
+            return this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.step-prefix`, {
+                params: {
+                    current: event.documentIndex,
+                    total: event.documentCount,
+                    phase: phaseText,
+                },
+            });
+        }
+        return phaseText;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentMetadataAiFillOrchestrator, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentMetadataAiFillOrchestrator, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEDocumentMetadataAiFillOrchestrator, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+//#region ---- Imports ----
+const promptSessions = new Map();
+function sessionState(sessionKey) {
+    let s = promptSessions.get(sessionKey);
+    if (!s) {
+        s = {};
+        promptSessions.set(sessionKey, s);
+    }
+    return s;
+}
+//#endregion
+//#region ---- Helpers ----
+/**
+ * Document Management attachment dialogs expose this metadata so extensions can scope integration-only hooks.
+ */
+function isDocumentAttachmentDialogIntegration(metadata) {
+    return metadata['showMeta'] === true && metadata['hasMetaFields'] === true && metadata['documentType'] != null;
+}
+/**
+ * Stable fingerprint for extractable document slots — ignores metadata field edits so we do not re-prompt on every keystroke.
+ */
+function extractableAttachmentSlotsSignature(context) {
+    const files = context['files'];
+    if (!Array.isArray(files) || files.length === 0) {
+        return '';
+    }
+    const parts = [];
+    for (let i = 0; i < files.length; i++) {
+        const slot = files[i]?.file;
+        const first = Array.isArray(slot) ? slot[0] : undefined;
+        if (!first || !isAiExtractableFileListItem(first)) {
+            continue;
+        }
+        const name = String(first['name'] ?? '');
+        const size = typeof first['size'] === 'number' ? first['size'] : '';
+        const mime = String(first['type'] ?? '');
+        const src = first['source'];
+        const kind = String(src?.kind ?? '');
+        let sourceFingerprint = '';
+        if (kind === 'fileId' && typeof src?.value === 'string') {
+            sourceFingerprint = `fileId:${src.value}`;
+        }
+        else if (kind === 'blob' && src?.value instanceof Blob) {
+            sourceFingerprint = `blob:${src.value.size}:${src.value.type}`;
+        }
+        else if (src?.value instanceof File) {
+            const f = src.value;
+            sourceFingerprint = `file:${f.size}:${f.type}`;
+        }
+        else {
+            sourceFingerprint = `${kind}:${typeof src?.value}`;
+        }
+        parts.push(`${i}:${name}:${size}:${mime}:${sourceFingerprint}`);
+    }
+    return parts.join('|');
+}
+//#endregion
+//#region ---- Hook provider ----
+/**
+ * When document extraction is enabled and the attachment dialog has metadata + extractable files, prompts the user
+ * after files appear. Yes → loading dialog + AI prefill; No → leave metadata form empty for manual entry.
+ * Dedupes by attachment-slot signature so field edits do not re-prompt.
+ */
+const AXEDocumentLayoutBuilderDialogContextChangedHookProvider = {
+    key: AXP_LAYOUT_BUILDER_DIALOG_CONTEXT_CHANGED_HOOK_KEY,
+    priority: 50,
+    async execute(data) {
+        const integration = data.metadata ?? {};
+        if (!isDocumentAttachmentDialogIntegration(integration)) {
+            return data;
+        }
+        const prefill = inject(AXEDocumentMetadataAiPrefillService);
+        const orchestrator = inject(AXEDocumentMetadataAiFillOrchestrator);
+        if (!(await prefill.isMetadataOcrEnabled())) {
+            return data;
+        }
+        const ctx = data.getContext();
+        const sig = extractableAttachmentSlotsSignature(ctx);
+        if (!sig) {
+            return data;
+        }
+        const st = sessionState(data.sessionKey);
+        if (st.busy) {
+            return data;
+        }
+        if (st.lastProcessedSig === sig) {
+            return data;
+        }
+        const dialogTarget = {
+            context: () => data.getContext(),
+            patchContext: (partial) => data.patchContext(partial),
+        };
+        if (!prefill.willApplyMetadataAiFillFromDocuments(dialogTarget, integration)) {
+            return data;
+        }
+        st.busy = true;
+        try {
+            await orchestrator.confirmAndRun(dialogTarget, integration);
+            st.lastProcessedSig = sig;
+        }
+        catch {
+            st.lastProcessedSig = sig;
+        }
+        finally {
+            st.busy = false;
+        }
+        return data;
+    },
+};
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Module ----
+/**
+ * Optional AI + OCR metadata helpers for document flows.
+ * Register in the app next to {@link AXMDocumentManagementModule} and {@link AXMAiManagementModule}.
+ */
+class AXEAIDocumentExtensionModule {
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEAIDocumentExtensionModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AXEAIDocumentExtensionModule, imports: [AXMAiManagementModule, AXMDocumentManagementModule] }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEAIDocumentExtensionModule, providers: [
+            {
+                provide: AXP_SETTING_DEFINITION_PROVIDER,
+                useClass: AXEDocumentAiSettingProvider,
+                multi: true,
+            },
+            {
+                provide: AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER,
+                useValue: AXEDocumentLayoutBuilderDialogContextChangedHookProvider,
+                multi: true,
+            },
+        ], imports: [AXMAiManagementModule, AXMDocumentManagementModule] }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEAIDocumentExtensionModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    imports: [AXMAiManagementModule, AXMDocumentManagementModule],
+                    providers: [
+                        {
+                            provide: AXP_SETTING_DEFINITION_PROVIDER,
+                            useClass: AXEDocumentAiSettingProvider,
+                            multi: true,
+                        },
+                        {
+                            provide: AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER,
+                            useValue: AXEDocumentLayoutBuilderDialogContextChangedHookProvider,
+                            multi: true,
+                        },
+                    ],
+                }]
+        }] });
+
+//#region ---- Hook contract ----
+/**
+ * Hook key for document attachment dialog integrations (caller wires `AXPHookService.runAsync` / listeners).
+ * Payload carries the same dialog `context` object by reference so hooks can read or update nested paths
+ * (for example `file-0.metaDataForm`, `files`) before the dialog is shown.
+ */
+const AXE_DOCUMENT_ATTACHMENT_DIALOG_HOOK_KEY = 'document-management.attachment-dialog.configure';
+//#endregion
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AXEAIDocumentExtensionModule, AXEDocumentAiSettingProvider, AXEDocumentLayoutBuilderDialogContextChangedHookProvider, AXEDocumentMetadataAiFillOrchestrator, AXEDocumentMetadataAiPrefillService, AXE_DOCUMENT_ATTACHMENT_DIALOG_HOOK_KEY, DOCUMENT_EXPIRATION_DATE_FIELD_NAME, collectMetadataFieldDescriptors, isAiExtractableFileListItem, mergeMetadataPrefill, normalizePrefillDateValue, parseMetadataMappingJson, splitMappedPrefill, withDocumentExpirationField };
+//# sourceMappingURL=acorex-platform-extension-ai-document-client.mjs.map

package/fesm2022/acorex-platform-extension-ai-document-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-platform-extension-ai-document-client.mjs","sources":["../../../../libs/extensions/ai/document/client/src/lib/document-metadata-ocr.settings.provider.ts","../../../../libs/extensions/ai/document/client/src/lib/document-metadata-schema.util.ts","../../../../libs/extensions/ai/document/client/src/lib/document-metadata-ai-prefill.service.ts","../../../../libs/extensions/ai/document/client/src/lib/document-metadata-ai-fill.orchestrator.ts","../../../../libs/extensions/ai/document/client/src/lib/document-layout-builder-dialog-context-changed.hook.ts","../../../../libs/extensions/ai/document/client/src/lib/ai-document-extension.module.ts","../../../../libs/extensions/ai/document/client/src/lib/document-attachment-dialog.hooks.ts","../../../../libs/extensions/ai/document/client/src/acorex-platform-extension-ai-document-client.ts"],"sourcesContent":["//#region ---- Imports ----\n\nimport { RootConfig } from '@acorex-platform/module-ai-management-client/contracts';\nimport { AXPSettingDefinitionProvider, AXPSettingDefinitionProviderContext } from '@acorex-platform/framework-client/common';\nimport { objectKeyValueTransforms } from '@acorex-platform/framework-client/core';\nimport { AXPWidgetsCatalog } from '@acorex-platform/framework-shared/core';\nimport { Injectable } from '@angular/core';\nimport { AXEDocumentMetadataOcrSettings } from '@acorex-platform/extension-ai-document-client/contracts';\n\n//#endregion\n\n//#region ---- Settings provider ----\n\nconst METADATA_OCR_I18N = '@extensions-ai-document:settings.metadata-ocr';\n\n/** Must match the settings group `name` from the document-management module (`AXPDocumentManagementSettingProvider`). */\nconst DOCUMENT_MANAGEMENT_SETTINGS_GROUP = 'document-management';\n\n@Injectable()\nexport class AXEDocumentAiSettingProvider implements AXPSettingDefinitionProvider {\n  async provide(context: AXPSettingDefinitionProviderContext): Promise<void> {\n    if (!context.hasGroup(DOCUMENT_MANAGEMENT_SETTINGS_GROUP)) {\n      return;\n    }\n\n    const assistVisibility = `{{ context.eval('${AXEDocumentMetadataOcrSettings.Enabled}') }}`;\n\n    const documentManagement = context.group(DOCUMENT_MANAGEMENT_SETTINGS_GROUP);\n    if (!documentManagement) {\n      return;\n    }\n\n    documentManagement\n      .addSection('metadata-ocr', `${METADATA_OCR_I18N}.section-title`, `${METADATA_OCR_I18N}.section-description`)\n      .addSetting({\n        key: AXEDocumentMetadataOcrSettings.Enabled,\n        title: `${METADATA_OCR_I18N}.enabled-title`,\n        scope: 'T',\n        overridableAt: [],\n        isInherited: true,\n        defaultValue: true,\n        searchTagKeys: [`${METADATA_OCR_I18N}.enabled-search-tags`],\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n        },\n        description: `${METADATA_OCR_I18N}.enabled-description`,\n      })\n      .addSetting({\n        key: AXEDocumentMetadataOcrSettings.AssistId,\n        title: `${METADATA_OCR_I18N}.assist-id-title`,\n        scope: 'T',\n        overridableAt: [],\n        isInherited: true,\n        // Persist assist primary key (`id`); demo defaults come from settings seed/overrides.\n        searchTagKeys: [`${METADATA_OCR_I18N}.assist-search-tags`],\n        valueTransforms: objectKeyValueTransforms('id'),\n        widget: {\n          type: AXPWidgetsCatalog.lookup,\n          options: {\n            entity: `${RootConfig.module.name}.${RootConfig.entities.assist.name}`,\n            look: 'select',\n            multiple: false,\n            textField: 'title',\n            valueField: 'id',\n            hasClearButton: true,\n            visibility: assistVisibility,\n          },\n        },\n        description: `${METADATA_OCR_I18N}.assist-id-description`,\n      })\n      .endSection();\n  }\n}\n\n//#endregion\n","//#region ---- Imports ----\n\nimport type { AXMMetaDataBuilderValue, AXMMetaDataLocalizedString } from '@acorex-platform/module-data-management-client/contracts';\nimport { canAiExtractDocument } from '@acorex-platform/module-ai-management-client/contracts';\n\n//#endregion\n\n//#region ---- Types ----\n\nexport interface DocumentMetadataFieldDescriptor {\n  name: string;\n  title: AXMMetaDataLocalizedString;\n  interfaceType: string;\n}\n\n//#endregion\n\n//#region ---- Constants ----\n\n/**\n * Synthetic mapping key for the document-level Expire Date control\n * (`file-*.expirationDate` when the document type has `enableExpiration`).\n * Not part of `metaDataForm`.\n */\nexport const DOCUMENT_EXPIRATION_DATE_FIELD_NAME = 'expirationDate';\n\n//#endregion\n\n//#region ---- Field collection ----\n\n/**\n * Flattens metadata selector value into field descriptors for LLM mapping prompts.\n */\nexport function collectMetadataFieldDescriptors(\n  meta: AXMMetaDataBuilderValue | undefined | null,\n): DocumentMetadataFieldDescriptor[] {\n  if (!meta?.groups?.length) {\n    return [];\n  }\n  const out: DocumentMetadataFieldDescriptor[] = [];\n  for (const g of meta.groups) {\n    for (const f of g.fields ?? []) {\n      out.push({\n        name: f.name,\n        title: f.title ?? f.name,\n        interfaceType: f.interface,\n      });\n    }\n  }\n  return out;\n}\n\n/**\n * Appends the platform document expire-date field used by attachment dialogs.\n */\nexport function withDocumentExpirationField(\n  fields: DocumentMetadataFieldDescriptor[],\n  include: boolean,\n): DocumentMetadataFieldDescriptor[] {\n  if (!include) {\n    return fields;\n  }\n  if (fields.some((f) => f.name === DOCUMENT_EXPIRATION_DATE_FIELD_NAME)) {\n    return fields;\n  }\n  return [\n    ...fields,\n    {\n      name: DOCUMENT_EXPIRATION_DATE_FIELD_NAME,\n      title: 'Expire Date',\n      interfaceType: 'date-time-editor',\n    },\n  ];\n}\n\n//#endregion\n\n//#region ---- JSON parsing ----\n\n/**\n * Coerces common OCR / LLM date strings into YYYY-MM-DD (or leaves non-dates unchanged).\n */\nexport function normalizePrefillDateValue(value: unknown): unknown {\n  if (value == null || value === '') {\n    return value;\n  }\n  if (value instanceof Date && !Number.isNaN(value.getTime())) {\n    return toIsoDateOnly(value);\n  }\n  if (typeof value !== 'string') {\n    return value;\n  }\n  const raw = value.trim();\n  if (!raw) {\n    return value;\n  }\n\n  const iso = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(raw);\n  if (iso) {\n    return `${iso[1]}-${iso[2]}-${iso[3]}`;\n  }\n\n  // US-style MM/DD/YYYY (common on driver licences).\n  const us = /^(\\d{1,2})\\/(\\d{1,2})\\/(\\d{4})$/.exec(raw);\n  if (us) {\n    const month = Number(us[1]);\n    const day = Number(us[2]);\n    const year = Number(us[3]);\n    if (month >= 1 && month <= 12 && day >= 1 && day <= 31) {\n      return `${year}-${pad2(month)}-${pad2(day)}`;\n    }\n  }\n\n  const parsed = new Date(raw);\n  if (!Number.isNaN(parsed.getTime())) {\n    return toIsoDateOnly(parsed);\n  }\n  return value;\n}\n\nfunction pad2(n: number): string {\n  return n < 10 ? `0${n}` : String(n);\n}\n\nfunction toIsoDateOnly(d: Date): string {\n  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;\n}\n\n/**\n * Normalizes date-like mapped values for date widgets; strips the synthetic expiration key from meta.\n */\nexport function splitMappedPrefill(\n  parsed: Record<string, unknown>,\n  fields: DocumentMetadataFieldDescriptor[],\n): { meta: Record<string, unknown>; expirationDate?: string } {\n  const dateNames = new Set(\n    fields\n      .filter((f) => {\n        const t = String(f.interfaceType ?? '').toLowerCase();\n        return t.includes('date-time') || t.includes('date');\n      })\n      .map((f) => f.name),\n  );\n\n  const meta: Record<string, unknown> = {};\n  let expirationDate: string | undefined;\n\n  for (const [k, v] of Object.entries(parsed)) {\n    const normalized = dateNames.has(k) ? normalizePrefillDateValue(v) : v;\n    if (k === DOCUMENT_EXPIRATION_DATE_FIELD_NAME) {\n      if (typeof normalized === 'string' && /^\\d{4}-\\d{2}-\\d{2}$/.test(normalized)) {\n        expirationDate = normalized;\n      } else if (normalized instanceof Date && !Number.isNaN(normalized.getTime())) {\n        expirationDate = toIsoDateOnly(normalized);\n      }\n      continue;\n    }\n    meta[k] = normalized;\n  }\n\n  return expirationDate ? { meta, expirationDate } : { meta };\n}\n\n/**\n * Parses a JSON object from an assistant reply (strips optional ```json fences).\n */\nexport function parseMetadataMappingJson(text: string): Record<string, unknown> {\n  const trimmed = text.trim();\n  const fence = /^```(?:json)?\\s*([\\s\\S]*?)```$/m.exec(trimmed);\n  const raw = fence ? fence[1]!.trim() : trimmed;\n  try {\n    const parsed = JSON.parse(raw) as unknown;\n    if (parsed != null && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      return parsed as Record<string, unknown>;\n    }\n  } catch {\n    // ignore\n  }\n  return {};\n}\n\n/**\n * Shallow merge: only fills keys that are empty in `existing`.\n */\nexport function mergeMetadataPrefill(\n  existing: Record<string, unknown> | undefined,\n  partial: Record<string, unknown>,\n): Record<string, unknown> {\n  const base = { ...(existing ?? {}) };\n  for (const [k, v] of Object.entries(partial)) {\n    const cur = base[k];\n    const empty = cur === undefined || cur === null || cur === '';\n    if (empty && v !== undefined && v !== null && v !== '') {\n      base[k] = v;\n    }\n  }\n  return base;\n}\n\n//#endregion\n\n//#region ---- File kind ----\n\ntype FileListItemLike = {\n  name?: string;\n  type?: string;\n  source?: { kind?: string; value?: unknown };\n};\n\n/**\n * Returns true when the file list item is supported for AI document text extraction.\n */\nexport function isAiExtractableFileListItem(item: FileListItemLike | undefined): boolean {\n  if (!item) {\n    return false;\n  }\n  const t = typeof item.type === 'string' ? item.type : '';\n  const name = String(item.name ?? '');\n  if (canAiExtractDocument(t, name)) {\n    return true;\n  }\n  const src = item.source?.value;\n  if (src instanceof Blob) {\n    const blobType = typeof src.type === 'string' ? src.type : '';\n    if (canAiExtractDocument(blobType, name)) {\n      return true;\n    }\n  }\n  if (src instanceof File) {\n    if (canAiExtractDocument(src.type, src.name || name)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n//#endregion\n","//#region ----- Imports -----\r\n\r\nimport { AXPFileListItem, AXPFileStorageStatus, runtimeCommandPayloadData } from '@acorex-platform/framework-shared/core';\r\nimport {\r\n  AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY,\r\n} from '@acorex-platform/module-ai-management-client/contracts';\r\nimport type { AXMMetaDataBuilderValue } from '@acorex-platform/module-data-management-client/contracts';\r\n\r\nimport {\r\n  AXPDebugService,\r\n  AXPFileStorageService,\r\n  AXPSettingsService,\r\n  extractRequestErrorInfo,\r\n} from '@acorex-platform/framework-client/common';\r\n\r\nimport { AXPCommandService } from '@acorex-platform/framework-client/runtime';\r\nimport { Injectable, inject } from '@angular/core';\r\nimport { AXEDocumentMetadataOcrSettings } from '@acorex-platform/extension-ai-document-client/contracts';\r\nimport {\r\n  collectMetadataFieldDescriptors,\r\n  isAiExtractableFileListItem,\r\n  mergeMetadataPrefill,\r\n  parseMetadataMappingJson,\r\n  splitMappedPrefill,\r\n  withDocumentExpirationField,\r\n} from './document-metadata-schema.util';\r\n\r\n/** Payload shape for ExtractDocumentText command `data`. */\r\ntype AiExtractCommandData = { text?: string; values?: Record<string, unknown> };\r\n\r\n//#endregion\r\n\r\n//#region ----- Constants -----\r\n\r\nconst DOCUMENT_MODULE_REF_TYPE = 'DocumentManagement.Document';\r\n\r\nconst SINGLE_DOCUMENT_PROGRESS_SCOPE = { documentIndex: 1, documentCount: 1 } as const;\r\n\r\n/** Phases surfaced to UI (loading dialog thinking text). */\r\nexport type AXEDocumentMetadataAiPrefillPhase =\r\n  | 'preparing'\r\n  | 'uploading'\r\n  | 'extracting';\r\n\r\n/** Progress event for optional UI updates during metadata AI fill. */\r\nexport interface AXEDocumentMetadataAiPrefillProgressEvent {\r\n  phase: AXEDocumentMetadataAiPrefillPhase;\r\n  /** 1-based slot among documents processed in this run. */\r\n  documentIndex: number;\r\n  /** Total extractable document slots queued in this run. */\r\n  documentCount: number;\r\n}\r\n\r\n//#endregion\r\n\r\n//#region ----- Local helpers -----\r\n\r\nconst OCR_FAILED_I18N = '@extensions-ai-document:widgets.metadata-ai-fill.ocr-failed';\r\n\r\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\r\n  if (signal?.aborted) {\r\n    throw new DOMException('Aborted', 'AbortError');\r\n  }\r\n}\r\n\r\nfunction stringifyErrorDetails(details: unknown): string {\r\n  if (typeof details === 'string' && details.trim()) {\r\n    return details.trim();\r\n  }\r\n  if (details == null) {\r\n    return '';\r\n  }\r\n  try {\r\n    return JSON.stringify(details);\r\n  } catch {\r\n    return String(details);\r\n  }\r\n}\r\n\r\n//#endregion\r\n\r\n//#region ----- Service -----\r\n\r\n/**\r\n * Runs AI document text extraction for metadata prefill (images, PDF, simple text files).\r\n * ExtractDocumentText command; when field names are passed it returns a key/value object.\r\n */\r\n@Injectable({ providedIn: 'root' })\r\nexport class AXEDocumentMetadataAiPrefillService {\r\n  //#region ----- Services & Dependencies -----\r\n\r\n  private readonly fileStorage = inject(AXPFileStorageService);\r\n  private readonly commandService = inject(AXPCommandService);\r\n  private readonly settings = inject(AXPSettingsService);\r\n  private readonly debug = inject(AXPDebugService);\r\n\r\n  //#endregion\r\n\r\n  /**\r\n   * Whether OCR metadata prefill is enabled in tenant settings.\r\n   * Defaults to true when the setting has never been stored (opt-out via settings UI).\r\n   */\r\n  async isMetadataOcrEnabled(): Promise<boolean> {\r\n    const v = await this.settings.get<boolean>(AXEDocumentMetadataOcrSettings.Enabled);\r\n    if (v == null) {\r\n      return true;\r\n    }\r\n    return v;\r\n  }\r\n\r\n  /**\r\n   * Whether {@link applyDialogContextMetadataAiFillFromDocuments} would extract at least one document\r\n   * (caller can safely show an indeterminate loading dialog).\r\n   */\r\n  willApplyMetadataAiFillFromDocuments(\r\n    dialogRef: {\r\n      context: () => Record<string, unknown>;\r\n      patchContext?: (partial: Record<string, unknown>) => void;\r\n    },\r\n    integration: Record<string, unknown>,\r\n  ): boolean {\r\n    if (!dialogRef.patchContext) {\r\n      return false;\r\n    }\r\n    const documentType = integration['documentType'] as {\r\n      metaDataList?: AXMMetaDataBuilderValue | null;\r\n      enableExpiration?: boolean;\r\n    } | undefined;\r\n    const metaDataList = documentType?.metaDataList;\r\n    const fields = withDocumentExpirationField(\r\n      collectMetadataFieldDescriptors(metaDataList ?? undefined),\r\n      !!documentType?.enableExpiration,\r\n    );\r\n    if (fields.length === 0) {\r\n      return false;\r\n    }\r\n    const ctx = dialogRef.context();\r\n    const files = ctx['files'] as Array<{ file?: unknown[] }> | undefined;\r\n    const n = files?.length ?? 0;\r\n    for (let i = 0; i < n; i++) {\r\n      const slot = files![i]?.file;\r\n      const first = Array.isArray(slot) ? (slot[0] as (AXPFileListItem & { type?: string }) | undefined) : undefined;\r\n      if (first && isAiExtractableFileListItem(first)) {\r\n        return true;\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Uploads a blob-backed file item to storage for vision APIs that require {@link fileId}.\r\n   */\r\n  async ensureStoredFileId(fileItem: AXPFileListItem & { type?: string }, folderId: string): Promise<string | null> {\r\n    // Only trust an explicit storage fileId. Chooser items use a client UUID on `id` with `source.kind === 'blob'`.\r\n    if (fileItem.source?.kind === 'fileId' && typeof fileItem.source.value === 'string') {\r\n      const storedId = fileItem.source.value.trim();\r\n      if (storedId) {\r\n        return storedId;\r\n      }\r\n    }\r\n\r\n    const file = this.resolveFileForUpload(fileItem);\r\n    if (!file) {\r\n      return null;\r\n    }\r\n\r\n    const refId = folderId?.trim() || 'document-metadata-ocr-prefill';\r\n    const saved = await this.fileStorage.save({\r\n      file,\r\n      name: fileItem.name,\r\n      refId,\r\n      refType: DOCUMENT_MODULE_REF_TYPE,\r\n      category: 'document',\r\n      status: AXPFileStorageStatus.Temporary,\r\n    });\r\n    return saved.fileId?.trim() || null;\r\n  }\r\n\r\n  /**\r\n   * OCR + field extraction in one vision call; returns merged metadata (only fills empty keys in {@link existingMeta}).\r\n   */\r\n  async prefillFromDocumentExtract(options: {\r\n    fileItem: AXPFileListItem & { type?: string };\r\n    folderId: string;\r\n    metaDataList: AXMMetaDataBuilderValue | undefined | null;\r\n    existingMeta: Record<string, unknown> | undefined;\r\n    /** When true, also map OCR EXP/expiry into document `expirationDate`. */\r\n    includeDocumentExpiration?: boolean;\r\n    existingExpirationDate?: unknown;\r\n    /** When set with {@link signalProgress}, scopes step copy to multi-document dialogs. */\r\n    progressScope?: { documentIndex: number; documentCount: number };\r\n    /** When aborted, throws {@link DOMException} with name `AbortError`. */\r\n    signal?: AbortSignal;\r\n    /** Optional UI wiring (loading dialog thinking lines). */\r\n    signalProgress?: (event: AXEDocumentMetadataAiPrefillProgressEvent) => void;\r\n  }): Promise<{ extractText: string; merged: Record<string, unknown>; expirationDate?: string }> {\r\n    const signal = options.signal;\r\n    const notify = (\r\n      phase: AXEDocumentMetadataAiPrefillPhase,\r\n      scope: { documentIndex: number; documentCount: number } = options.progressScope ??\r\n        SINGLE_DOCUMENT_PROGRESS_SCOPE,\r\n    ) => options.signalProgress?.({ phase, ...scope });\r\n\r\n    throwIfAborted(signal);\r\n\r\n    const fields = withDocumentExpirationField(\r\n      collectMetadataFieldDescriptors(options.metaDataList ?? undefined),\r\n      !!options.includeDocumentExpiration,\r\n    );\r\n    if (fields.length === 0) {\r\n      return { extractText: '', merged: { ...(options.existingMeta ?? {}) } };\r\n    }\r\n\r\n    notify('uploading');\r\n    const fileId = await this.ensureStoredFileId(options.fileItem, options.folderId);\r\n    throwIfAborted(signal);\r\n    if (!fileId) {\r\n      throw new Error('Could not upload the file for document extraction.');\r\n    }\r\n\r\n    notify('extracting');\r\n    const extractResult = await this.commandService.execute(AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY, {\r\n      fileId,\r\n      fields: fields.map((field) => field.name),\r\n    });\r\n    throwIfAborted(signal);\r\n    if (extractResult?.success === false) {\r\n      throw this.extractCommandFailure(extractResult);\r\n    }\r\n    const extractData = runtimeCommandPayloadData(extractResult) as AiExtractCommandData | undefined;\r\n    const extractText = typeof extractData?.text === 'string' ? extractData.text : '';\r\n    const parsed =\r\n      extractData?.values && typeof extractData.values === 'object' && !Array.isArray(extractData.values)\r\n        ? extractData.values\r\n        : parseMetadataMappingJson(extractText);\r\n    if (Object.keys(parsed).length === 0 && !extractText.trim()) {\r\n      throw this.extractCommandFailure(extractResult);\r\n    }\r\n    const { meta, expirationDate } = splitMappedPrefill(parsed, fields);\r\n    const merged = mergeMetadataPrefill(options.existingMeta, meta);\r\n\r\n    const existingExpEmpty =\r\n      options.existingExpirationDate === undefined ||\r\n      options.existingExpirationDate === null ||\r\n      options.existingExpirationDate === '';\r\n    return {\r\n      extractText,\r\n      merged,\r\n      ...(existingExpEmpty && expirationDate ? { expirationDate } : {}),\r\n    };\r\n  }\r\n\r\n  /**\r\n   * For each extractable document slot in `context.files`, merges extraction + AI metadata into `file-{i}.metaDataForm`.\r\n   */\r\n  async applyDialogContextMetadataAiFillFromDocuments(\r\n    dialogRef: {\r\n      context: () => Record<string, unknown>;\r\n      patchContext?: (partial: Record<string, unknown>) => void;\r\n    },\r\n    integration: Record<string, unknown>,\r\n    options?: {\r\n      signal?: AbortSignal;\r\n      signalProgress?: (event: AXEDocumentMetadataAiPrefillProgressEvent) => void;\r\n    },\r\n  ): Promise<void> {\r\n    if (!dialogRef.patchContext) {\r\n      return;\r\n    }\r\n    const folderId = String(integration['parentId'] ?? '').trim();\r\n    const documentType = integration['documentType'] as {\r\n      metaDataList?: AXMMetaDataBuilderValue | null;\r\n      enableExpiration?: boolean;\r\n    } | undefined;\r\n    const metaDataList = documentType?.metaDataList;\r\n    const includeDocumentExpiration = !!documentType?.enableExpiration;\r\n    const ctx = dialogRef.context();\r\n    const files = ctx['files'] as Array<{ file?: unknown[] }> | undefined;\r\n    const n = files?.length ?? 0;\r\n    const patch: Record<string, unknown> = {};\r\n\r\n    const documentIndices: number[] = [];\r\n    for (let i = 0; i < n; i++) {\r\n      const slot = files![i]?.file;\r\n      const first = Array.isArray(slot) ? (slot[0] as (AXPFileListItem & { type?: string }) | undefined) : undefined;\r\n      if (first && isAiExtractableFileListItem(first)) {\r\n        documentIndices.push(i);\r\n      }\r\n    }\r\n    const signal = options?.signal;\r\n    const documentCount = documentIndices.length;\r\n    if (documentCount > 0) {\r\n      options?.signalProgress?.({\r\n        phase: 'preparing',\r\n        documentIndex: 1,\r\n        documentCount,\r\n      });\r\n      throwIfAborted(signal);\r\n    }\r\n\r\n    let processed = 0;\r\n    for (const i of documentIndices) {\r\n      throwIfAborted(signal);\r\n      processed += 1;\r\n      const slot = files![i]?.file;\r\n      const first = Array.isArray(slot) ? (slot[0] as (AXPFileListItem & { type?: string }) | undefined) : undefined;\r\n      if (!first) {\r\n        continue;\r\n      }\r\n      const fileBlock = ctx[`file-${i}`] as Record<string, unknown> | undefined;\r\n      const existingMeta = fileBlock?.['metaDataForm'] as Record<string, unknown> | undefined;\r\n      const { merged, expirationDate } = await this.prefillFromDocumentExtract({\r\n        fileItem: first,\r\n        folderId,\r\n        metaDataList,\r\n        existingMeta,\r\n        includeDocumentExpiration,\r\n        existingExpirationDate: fileBlock?.['expirationDate'],\r\n        progressScope: { documentIndex: processed, documentCount },\r\n        signal,\r\n        signalProgress: options?.signalProgress,\r\n      });\r\n      patch[`file-${i}`] = {\r\n        ...(typeof fileBlock === 'object' && fileBlock ? fileBlock : {}),\r\n        metaDataForm: merged,\r\n        ...(expirationDate ? { expirationDate } : {}),\r\n      };\r\n    }\r\n\r\n    if (Object.keys(patch).length > 0) {\r\n      dialogRef.patchContext(patch);\r\n    }\r\n  }\r\n\r\n  //#region ----- Utility Methods -----\r\n\r\n  private extractCommandFailure(extractResult: unknown): Error {\r\n    const info = extractRequestErrorInfo(extractResult);\r\n    const details = stringifyErrorDetails(info?.details);\r\n    this.debug.error('ai-document', 'extract-document-text', 'ExtractDocumentText failed', () => ({\r\n      message: info?.message,\r\n      details: info?.details,\r\n    }));\r\n    if (this.debug.isDebugMode() && details) {\r\n      return new Error(details);\r\n    }\r\n    const text = typeof info?.message === 'string' ? info.message.trim() : '';\r\n    if (text.startsWith('@')) {\r\n      return new Error(text);\r\n    }\r\n    return new Error(OCR_FAILED_I18N);\r\n  }\r\n\r\n  private resolveFileForUpload(item: AXPFileListItem & { type?: string }): File | null {\r\n    const v = item.source?.value;\r\n    if (v instanceof File) {\r\n      return v;\r\n    }\r\n    if (item.source?.kind === 'blob' && v instanceof Blob) {\r\n      return new File([v], item.name, { type: item.type ?? v.type ?? 'application/octet-stream' });\r\n    }\r\n    return null;\r\n  }\r\n\r\n  //#endregion\r\n}\r\n\r\n//#endregion\r\n","//#region ---- Imports ----\n\nimport { AXDialogService } from '@acorex/components/dialog';\nimport { AXLoadingDialogService } from '@acorex/components/loading-dialog';\nimport { AXTranslationService } from '@acorex/core/translation';\nimport { AXPDebugService } from '@acorex-platform/framework-client/common';\nimport { Injectable, inject } from '@angular/core';\nimport {\n  AXEDocumentMetadataAiPrefillProgressEvent,\n  AXEDocumentMetadataAiPrefillService,\n} from './document-metadata-ai-prefill.service';\n\n//#endregion\n\n//#region ---- Types ----\n\n/** Dialog surface that supports context patch (layout attachment dialog). */\nexport interface AXEDocumentMetadataAiFillDialogTarget {\n  context: () => Record<string, unknown>;\n  patchContext?: (partial: Record<string, unknown>) => void;\n}\n\nexport interface AXEDocumentMetadataAiFillRunResult {\n  success: boolean;\n  errorMessage?: string;\n  /** User chose Skip on the loading dialog; treat as neutral (no failure toast) where applicable. */\n  cancelled?: boolean;\n  /** User declined OCR on the confirm dialog. */\n  declined?: boolean;\n}\n\ntype MetadataAiProgressColor = 'primary' | 'danger' | 'success';\n\n/** Indeterminate loading dialog surface (see {@link AXLoadingDialogService.show}). */\ninterface MetadataAiLoadingDialogRef {\n  close: () => void;\n  setProgressText: (text: string) => void;\n  setProgressColor: (color: MetadataAiProgressColor) => void;\n}\n\n//#endregion\n\nconst METADATA_AI_CONFIRM_I18N = '@extensions-ai-document:widgets.metadata-ai-fill.confirm';\nconst METADATA_AI_LOADING_I18N = '@extensions-ai-document:widgets.metadata-ai-fill.loading';\n\n/** Smoother dismiss after work completes. */\nconst LOADING_DIALOG_CLOSE_DELAY_MS = 400;\n\n//#region ---- Orchestrator ----\n\n/**\n * Shared OCR + AI metadata prefill UX: confirm after image choose, then indeterminate loading dialog.\n */\n@Injectable({ providedIn: 'root' })\nexport class AXEDocumentMetadataAiFillOrchestrator {\n  //#region ---- Dependencies ----\n\n  private readonly prefill = inject(AXEDocumentMetadataAiPrefillService);\n  private readonly dialogService = inject(AXDialogService);\n  private readonly loadingDialog = inject(AXLoadingDialogService);\n  private readonly translation = inject(AXTranslationService);\n  private readonly debug = inject(AXPDebugService);\n\n  //#endregion\n\n  //#region ---- Public API ----\n\n  /**\n   * Asks whether to run OCR; on Yes runs {@link run}, on No returns {@link AXEDocumentMetadataAiFillRunResult.declined}.\n   */\n  async confirmAndRun(\n    dialogTarget: AXEDocumentMetadataAiFillDialogTarget,\n    integration: Record<string, unknown>,\n  ): Promise<AXEDocumentMetadataAiFillRunResult> {\n    if (!this.prefill.willApplyMetadataAiFillFromDocuments(dialogTarget, integration)) {\n      return { success: true };\n    }\n\n    const [title, message] = await Promise.all([\n      this.translation.translateAsync(`${METADATA_AI_CONFIRM_I18N}.title`),\n      this.translation.translateAsync(`${METADATA_AI_CONFIRM_I18N}.message`),\n    ]);\n    const dialogResult = await this.dialogService.confirm(title, message, 'primary', 'horizontal', false, 'cancel');\n    if (!dialogResult.result) {\n      return { success: true, declined: true };\n    }\n\n    return this.run(dialogTarget, integration);\n  }\n\n  /**\n   * Runs metadata AI fill when eligible; shows an indeterminate loading dialog while work is in progress.\n   */\n  async run(\n    dialogTarget: AXEDocumentMetadataAiFillDialogTarget,\n    integration: Record<string, unknown>,\n  ): Promise<AXEDocumentMetadataAiFillRunResult> {\n    const showLoading = this.prefill.willApplyMetadataAiFillFromDocuments(dialogTarget, integration);\n\n    const abortController = new AbortController();\n    let loadingDismissedEarly = false;\n\n    let progressDialog: MetadataAiLoadingDialogRef | undefined;\n\n    if (showLoading) {\n      const [title, initial, skipLabel] = await Promise.all([\n        this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.title`),\n        this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.initial`),\n        this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.skip-button`),\n      ]);\n      progressDialog = this.loadingDialog.show({\n        title,\n        mode: 'indeterminate',\n        progressColor: 'primary',\n        text: initial,\n        buttons: [\n          {\n            text: skipLabel,\n            onClick: () => {\n              loadingDismissedEarly = true;\n              abortController.abort();\n              progressDialog?.close();\n            },\n          },\n        ],\n      }) as MetadataAiLoadingDialogRef;\n    }\n\n    try {\n      await this.prefill.applyDialogContextMetadataAiFillFromDocuments(dialogTarget, integration, {\n        signal: showLoading ? abortController.signal : undefined,\n        signalProgress: (event) => {\n          if (!progressDialog) {\n            return;\n          }\n          void this.applyProgressText(progressDialog, event);\n        },\n      });\n      if (progressDialog && !loadingDismissedEarly) {\n        await this.markProgressComplete(progressDialog);\n      }\n      return { success: true };\n    } catch (err) {\n      if (err instanceof DOMException && err.name === 'AbortError') {\n        return { success: false, cancelled: true };\n      }\n      const errorMessage = await this.resolveFailureMessage(err);\n      if (progressDialog && !loadingDismissedEarly) {\n        try {\n          progressDialog.setProgressColor('danger');\n          progressDialog.setProgressText(errorMessage);\n        } catch {\n          // Ignore dialog update failures.\n        }\n      }\n      if (this.debug.isDebugMode() && progressDialog && !loadingDismissedEarly) {\n        loadingDismissedEarly = true;\n      }\n      return { success: false, errorMessage };\n    } finally {\n      if (progressDialog !== undefined && !loadingDismissedEarly) {\n        const dlg = progressDialog;\n        setTimeout(() => dlg.close(), LOADING_DIALOG_CLOSE_DELAY_MS);\n      }\n    }\n  }\n\n  //#endregion\n\n  //#region ---- Progress ----\n\n  private async applyProgressText(\n    dialog: MetadataAiLoadingDialogRef,\n    event: AXEDocumentMetadataAiPrefillProgressEvent,\n  ): Promise<void> {\n    try {\n      dialog.setProgressColor('primary');\n      const line = await this.formatProgressLine(event);\n      dialog.setProgressText(line);\n    } catch {\n      // Ignore translation / dialog failures; keep the previous UI state.\n    }\n  }\n\n  private async markProgressComplete(dialog: MetadataAiLoadingDialogRef): Promise<void> {\n    try {\n      dialog.setProgressColor('success');\n      dialog.setProgressText(await this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.complete`));\n    } catch {\n      dialog.setProgressColor('success');\n    }\n  }\n\n  private async resolveFailureMessage(err: unknown): Promise<string> {\n    const raw = err instanceof Error ? err.message.trim() : '';\n    if (this.debug.isDebugMode() && raw && !raw.startsWith('@')) {\n      const prefix = await this.translation.translateAsync(\n        '@extensions-ai-document:widgets.metadata-ai-fill.ocr-failed-prefix',\n      );\n      return `${prefix} ${raw}`;\n    }\n    const key = raw.startsWith('@') ? raw : '@extensions-ai-document:widgets.metadata-ai-fill.ocr-failed';\n    return this.translation.translateAsync(key);\n  }\n\n  private async formatProgressLine(event: AXEDocumentMetadataAiPrefillProgressEvent): Promise<string> {\n    const phaseKey = `${METADATA_AI_LOADING_I18N}.thinking.${event.phase}`;\n    const phaseText = await this.translation.translateAsync(phaseKey);\n    if (event.documentCount > 1) {\n      return this.translation.translateAsync(`${METADATA_AI_LOADING_I18N}.step-prefix`, {\n        params: {\n          current: event.documentIndex,\n          total: event.documentCount,\n          phase: phaseText,\n        },\n      });\n    }\n    return phaseText;\n  }\n\n  //#endregion\n}\n\n//#endregion\n","//#region ---- Imports ----\n\nimport type { AXPDistributedEventListenerProvider } from '@acorex-platform/framework-client/core';\nimport {\n  AXP_LAYOUT_BUILDER_DIALOG_CONTEXT_CHANGED_HOOK_KEY,\n  type AXPLayoutBuilderDialogContextChangedPayload,\n} from '@acorex-platform/framework-client/layout/builder';\nimport { inject } from '@angular/core';\nimport { AXEDocumentMetadataAiFillOrchestrator } from './document-metadata-ai-fill.orchestrator';\nimport { AXEDocumentMetadataAiPrefillService } from './document-metadata-ai-prefill.service';\nimport { isAiExtractableFileListItem } from './document-metadata-schema.util';\n\n//#endregion\n\n//#region ---- Local state (per-popup session keys from dialog renderer) ----\n\ntype AiPromptSessionState = {\n  busy?: boolean;\n  lastProcessedSig?: string;\n};\n\nconst promptSessions = new Map<string, AiPromptSessionState>();\n\nfunction sessionState(sessionKey: string): AiPromptSessionState {\n  let s = promptSessions.get(sessionKey);\n  if (!s) {\n    s = {};\n    promptSessions.set(sessionKey, s);\n  }\n  return s;\n}\n\n//#endregion\n\n//#region ---- Helpers ----\n\n/**\n * Document Management attachment dialogs expose this metadata so extensions can scope integration-only hooks.\n */\nfunction isDocumentAttachmentDialogIntegration(metadata: Record<string, unknown>): boolean {\n  return metadata['showMeta'] === true && metadata['hasMetaFields'] === true && metadata['documentType'] != null;\n}\n\n/**\n * Stable fingerprint for extractable document slots — ignores metadata field edits so we do not re-prompt on every keystroke.\n */\nfunction extractableAttachmentSlotsSignature(context: Record<string, unknown>): string {\n  const files = context['files'] as Array<{ file?: unknown[] }> | undefined;\n  if (!Array.isArray(files) || files.length === 0) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (let i = 0; i < files.length; i++) {\n    const slot = files[i]?.file;\n    const first = Array.isArray(slot) ? (slot[0] as Record<string, unknown> | undefined) : undefined;\n    if (!first || !isAiExtractableFileListItem(first as { name?: string; type?: string })) {\n      continue;\n    }\n    const name = String(first['name'] ?? '');\n    const size = typeof first['size'] === 'number' ? first['size'] : '';\n    const mime = String(first['type'] ?? '');\n    const src = first['source'] as { kind?: string; value?: unknown } | undefined;\n    const kind = String(src?.kind ?? '');\n    let sourceFingerprint = '';\n    if (kind === 'fileId' && typeof src?.value === 'string') {\n      sourceFingerprint = `fileId:${src.value}`;\n    } else if (kind === 'blob' && src?.value instanceof Blob) {\n      sourceFingerprint = `blob:${src.value.size}:${src.value.type}`;\n    } else if (src?.value instanceof File) {\n      const f = src.value;\n      sourceFingerprint = `file:${f.size}:${f.type}`;\n    } else {\n      sourceFingerprint = `${kind}:${typeof src?.value}`;\n    }\n    parts.push(`${i}:${name}:${size}:${mime}:${sourceFingerprint}`);\n  }\n  return parts.join('|');\n}\n\n//#endregion\n\n//#region ---- Hook provider ----\n\n/**\n * When document extraction is enabled and the attachment dialog has metadata + extractable files, prompts the user\n * after files appear. Yes → loading dialog + AI prefill; No → leave metadata form empty for manual entry.\n * Dedupes by attachment-slot signature so field edits do not re-prompt.\n */\nexport const AXEDocumentLayoutBuilderDialogContextChangedHookProvider: AXPDistributedEventListenerProvider<\n  AXPLayoutBuilderDialogContextChangedPayload,\n  AXPLayoutBuilderDialogContextChangedPayload\n> = {\n  key: AXP_LAYOUT_BUILDER_DIALOG_CONTEXT_CHANGED_HOOK_KEY,\n  priority: 50,\n  async execute(\n    data: AXPLayoutBuilderDialogContextChangedPayload,\n  ): Promise<AXPLayoutBuilderDialogContextChangedPayload> {\n    const integration = data.metadata ?? {};\n\n    if (!isDocumentAttachmentDialogIntegration(integration)) {\n      return data;\n    }\n\n    const prefill = inject(AXEDocumentMetadataAiPrefillService);\n    const orchestrator = inject(AXEDocumentMetadataAiFillOrchestrator);\n\n    if (!(await prefill.isMetadataOcrEnabled())) {\n      return data;\n    }\n\n    const ctx = data.getContext();\n    const sig = extractableAttachmentSlotsSignature(ctx);\n    if (!sig) {\n      return data;\n    }\n\n    const st = sessionState(data.sessionKey);\n    if (st.busy) {\n      return data;\n    }\n    if (st.lastProcessedSig === sig) {\n      return data;\n    }\n\n    const dialogTarget = {\n      context: () => data.getContext(),\n      patchContext: (partial: Record<string, unknown>) => data.patchContext(partial),\n    };\n\n    if (!prefill.willApplyMetadataAiFillFromDocuments(dialogTarget, integration)) {\n      return data;\n    }\n\n    st.busy = true;\n    try {\n      await orchestrator.confirmAndRun(dialogTarget, integration);\n      st.lastProcessedSig = sig;\n    } catch {\n      st.lastProcessedSig = sig;\n    } finally {\n      st.busy = false;\n    }\n\n    return data;\n  },\n};\n\n//#endregion\n","//#region ---- Imports ----\n\nimport { NgModule } from '@angular/core';\nimport { AXMAiManagementModule } from '@acorex-platform/module-ai-management-client';\nimport { AXMDocumentManagementModule } from '@acorex-platform/module-document-management-client';\nimport { AXP_SETTING_DEFINITION_PROVIDER } from '@acorex-platform/framework-client/common';\nimport { AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER } from '@acorex-platform/framework-client/core';\n\nimport { AXEDocumentAiSettingProvider } from './document-metadata-ocr.settings.provider';\nimport { AXEDocumentLayoutBuilderDialogContextChangedHookProvider } from './document-layout-builder-dialog-context-changed.hook';\n\n//#endregion\n\n//#region ---- Module ----\n\n/**\n * Optional AI + OCR metadata helpers for document flows.\n * Register in the app next to {@link AXMDocumentManagementModule} and {@link AXMAiManagementModule}.\n */\n@NgModule({\n  imports: [AXMAiManagementModule, AXMDocumentManagementModule],\n  providers: [\n    {\n      provide: AXP_SETTING_DEFINITION_PROVIDER,\n      useClass: AXEDocumentAiSettingProvider,\n      multi: true,\n    },\n    {\n      provide: AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER,\n      useValue: AXEDocumentLayoutBuilderDialogContextChangedHookProvider,\n      multi: true,\n    },\n  ],\n})\nexport class AXEAIDocumentExtensionModule {}\n\n//#endregion\n","//#region ---- Hook contract ----\n\n/**\n * Hook key for document attachment dialog integrations (caller wires `AXPHookService.runAsync` / listeners).\n * Payload carries the same dialog `context` object by reference so hooks can read or update nested paths\n * (for example `file-0.metaDataForm`, `files`) before the dialog is shown.\n */\nexport const AXE_DOCUMENT_ATTACHMENT_DIALOG_HOOK_KEY = 'document-management.attachment-dialog.configure';\n\n/**\n * Eligibility flags supplied by the caller (e.g. Document Management).\n */\nexport interface AXEDocumentAttachmentDialogEligibility {\n  showMeta: boolean;\n  hasMetaFields: boolean;\n  hasImage: boolean;\n  parentId: string;\n  documentType: unknown;\n}\n\n/**\n * Payload for {@link AXE_DOCUMENT_ATTACHMENT_DIALOG_HOOK_KEY}.\n *\n * **Context by reference:** `context` must be the object that will be passed to the dialog (e.g. `setContext(context)`).\n * Hook providers may mutate or shallow-merge into this object so updates are visible when the dialog opens.\n */\nexport interface AXEDocumentAttachmentDialogHookPayload {\n  context: Record<string, unknown>;\n  eligibility: AXEDocumentAttachmentDialogEligibility;\n}\n\n//#endregion\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@acorex-platform/extension-ai-document-client",
+  "version": "0.0.21",
+  "sideEffects": false,
+  "peerDependencies": {
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "module": "fesm2022/acorex-platform-extension-ai-document-client.mjs",
+  "typings": "types/acorex-platform-extension-ai-document-client.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/acorex-platform-extension-ai-document-client.d.ts",
+      "default": "./fesm2022/acorex-platform-extension-ai-document-client.mjs"
+    },
+    "./contracts": {
+      "types": "./types/acorex-platform-extension-ai-document-client-contracts.d.ts",
+      "default": "./fesm2022/acorex-platform-extension-ai-document-client-contracts.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/acorex-platform-extension-ai-document-client-contracts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tenant settings for optional OCR-based metadata prefill on image uploads (AI Document extension).
+ */
+declare enum AXEDocumentMetadataOcrSettings {
+    /** When true, eligible attachment dialogs may offer OCR after an image is chosen. */
+    Enabled = "AiDocument:Setting:MetadataOcr.Enabled",
+    /**
+     * Optional assist primary key (`Assist.id`). Metadata OCR uses ExtractDocumentText (assist chat model).
+     */
+    AssistId = "AiDocument:Setting:MetadataOcr.AssistId"
+}
+
+export { AXEDocumentMetadataOcrSettings };

package/types/acorex-platform-extension-ai-document-client.d.ts

@@ -0,0 +1,231 @@
+import * as i0 from '@angular/core';
+import * as i1 from '@acorex-platform/module-ai-management-client';
+import * as i2 from '@acorex-platform/module-document-management-client';
+import { AXPFileListItem } from '@acorex-platform/framework-shared/core';
+import { AXMMetaDataBuilderValue, AXMMetaDataLocalizedString } from '@acorex-platform/module-data-management-client/contracts';
+import { AXPSettingDefinitionProvider, AXPSettingDefinitionProviderContext } from '@acorex-platform/framework-client/common';
+import { AXPDistributedEventListenerProvider } from '@acorex-platform/framework-client/core';
+import { AXPLayoutBuilderDialogContextChangedPayload } from '@acorex-platform/framework-client/layout/builder';
+
+/**
+ * Optional AI + OCR metadata helpers for document flows.
+ * Register in the app next to {@link AXMDocumentManagementModule} and {@link AXMAiManagementModule}.
+ */
+declare class AXEAIDocumentExtensionModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXEAIDocumentExtensionModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AXEAIDocumentExtensionModule, never, [typeof i1.AXMAiManagementModule, typeof i2.AXMDocumentManagementModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AXEAIDocumentExtensionModule>;
+}
+
+/** Phases surfaced to UI (loading dialog thinking text). */
+type AXEDocumentMetadataAiPrefillPhase = 'preparing' | 'uploading' | 'extracting';
+/** Progress event for optional UI updates during metadata AI fill. */
+interface AXEDocumentMetadataAiPrefillProgressEvent {
+    phase: AXEDocumentMetadataAiPrefillPhase;
+    /** 1-based slot among documents processed in this run. */
+    documentIndex: number;
+    /** Total extractable document slots queued in this run. */
+    documentCount: number;
+}
+/**
+ * Runs AI document text extraction for metadata prefill (images, PDF, simple text files).
+ * ExtractDocumentText command; when field names are passed it returns a key/value object.
+ */
+declare class AXEDocumentMetadataAiPrefillService {
+    private readonly fileStorage;
+    private readonly commandService;
+    private readonly settings;
+    private readonly debug;
+    /**
+     * Whether OCR metadata prefill is enabled in tenant settings.
+     * Defaults to true when the setting has never been stored (opt-out via settings UI).
+     */
+    isMetadataOcrEnabled(): Promise<boolean>;
+    /**
+     * Whether {@link applyDialogContextMetadataAiFillFromDocuments} would extract at least one document
+     * (caller can safely show an indeterminate loading dialog).
+     */
+    willApplyMetadataAiFillFromDocuments(dialogRef: {
+        context: () => Record<string, unknown>;
+        patchContext?: (partial: Record<string, unknown>) => void;
+    }, integration: Record<string, unknown>): boolean;
+    /**
+     * Uploads a blob-backed file item to storage for vision APIs that require {@link fileId}.
+     */
+    ensureStoredFileId(fileItem: AXPFileListItem & {
+        type?: string;
+    }, folderId: string): Promise<string | null>;
+    /**
+     * OCR + field extraction in one vision call; returns merged metadata (only fills empty keys in {@link existingMeta}).
+     */
+    prefillFromDocumentExtract(options: {
+        fileItem: AXPFileListItem & {
+            type?: string;
+        };
+        folderId: string;
+        metaDataList: AXMMetaDataBuilderValue | undefined | null;
+        existingMeta: Record<string, unknown> | undefined;
+        /** When true, also map OCR EXP/expiry into document `expirationDate`. */
+        includeDocumentExpiration?: boolean;
+        existingExpirationDate?: unknown;
+        /** When set with {@link signalProgress}, scopes step copy to multi-document dialogs. */
+        progressScope?: {
+            documentIndex: number;
+            documentCount: number;
+        };
+        /** When aborted, throws {@link DOMException} with name `AbortError`. */
+        signal?: AbortSignal;
+        /** Optional UI wiring (loading dialog thinking lines). */
+        signalProgress?: (event: AXEDocumentMetadataAiPrefillProgressEvent) => void;
+    }): Promise<{
+        extractText: string;
+        merged: Record<string, unknown>;
+        expirationDate?: string;
+    }>;
+    /**
+     * For each extractable document slot in `context.files`, merges extraction + AI metadata into `file-{i}.metaDataForm`.
+     */
+    applyDialogContextMetadataAiFillFromDocuments(dialogRef: {
+        context: () => Record<string, unknown>;
+        patchContext?: (partial: Record<string, unknown>) => void;
+    }, integration: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+        signalProgress?: (event: AXEDocumentMetadataAiPrefillProgressEvent) => void;
+    }): Promise<void>;
+    private extractCommandFailure;
+    private resolveFileForUpload;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXEDocumentMetadataAiPrefillService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXEDocumentMetadataAiPrefillService>;
+}
+
+interface DocumentMetadataFieldDescriptor {
+    name: string;
+    title: AXMMetaDataLocalizedString;
+    interfaceType: string;
+}
+/**
+ * Synthetic mapping key for the document-level Expire Date control
+ * (`file-*.expirationDate` when the document type has `enableExpiration`).
+ * Not part of `metaDataForm`.
+ */
+declare const DOCUMENT_EXPIRATION_DATE_FIELD_NAME = "expirationDate";
+/**
+ * Flattens metadata selector value into field descriptors for LLM mapping prompts.
+ */
+declare function collectMetadataFieldDescriptors(meta: AXMMetaDataBuilderValue | undefined | null): DocumentMetadataFieldDescriptor[];
+/**
+ * Appends the platform document expire-date field used by attachment dialogs.
+ */
+declare function withDocumentExpirationField(fields: DocumentMetadataFieldDescriptor[], include: boolean): DocumentMetadataFieldDescriptor[];
+/**
+ * Coerces common OCR / LLM date strings into YYYY-MM-DD (or leaves non-dates unchanged).
+ */
+declare function normalizePrefillDateValue(value: unknown): unknown;
+/**
+ * Normalizes date-like mapped values for date widgets; strips the synthetic expiration key from meta.
+ */
+declare function splitMappedPrefill(parsed: Record<string, unknown>, fields: DocumentMetadataFieldDescriptor[]): {
+    meta: Record<string, unknown>;
+    expirationDate?: string;
+};
+/**
+ * Parses a JSON object from an assistant reply (strips optional ```json fences).
+ */
+declare function parseMetadataMappingJson(text: string): Record<string, unknown>;
+/**
+ * Shallow merge: only fills keys that are empty in `existing`.
+ */
+declare function mergeMetadataPrefill(existing: Record<string, unknown> | undefined, partial: Record<string, unknown>): Record<string, unknown>;
+type FileListItemLike = {
+    name?: string;
+    type?: string;
+    source?: {
+        kind?: string;
+        value?: unknown;
+    };
+};
+/**
+ * Returns true when the file list item is supported for AI document text extraction.
+ */
+declare function isAiExtractableFileListItem(item: FileListItemLike | undefined): boolean;
+
+/**
+ * Hook key for document attachment dialog integrations (caller wires `AXPHookService.runAsync` / listeners).
+ * Payload carries the same dialog `context` object by reference so hooks can read or update nested paths
+ * (for example `file-0.metaDataForm`, `files`) before the dialog is shown.
+ */
+declare const AXE_DOCUMENT_ATTACHMENT_DIALOG_HOOK_KEY = "document-management.attachment-dialog.configure";
+/**
+ * Eligibility flags supplied by the caller (e.g. Document Management).
+ */
+interface AXEDocumentAttachmentDialogEligibility {
+    showMeta: boolean;
+    hasMetaFields: boolean;
+    hasImage: boolean;
+    parentId: string;
+    documentType: unknown;
+}
+/**
+ * Payload for {@link AXE_DOCUMENT_ATTACHMENT_DIALOG_HOOK_KEY}.
+ *
+ * **Context by reference:** `context` must be the object that will be passed to the dialog (e.g. `setContext(context)`).
+ * Hook providers may mutate or shallow-merge into this object so updates are visible when the dialog opens.
+ */
+interface AXEDocumentAttachmentDialogHookPayload {
+    context: Record<string, unknown>;
+    eligibility: AXEDocumentAttachmentDialogEligibility;
+}
+
+declare class AXEDocumentAiSettingProvider implements AXPSettingDefinitionProvider {
+    provide(context: AXPSettingDefinitionProviderContext): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXEDocumentAiSettingProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXEDocumentAiSettingProvider>;
+}
+
+/** Dialog surface that supports context patch (layout attachment dialog). */
+interface AXEDocumentMetadataAiFillDialogTarget {
+    context: () => Record<string, unknown>;
+    patchContext?: (partial: Record<string, unknown>) => void;
+}
+interface AXEDocumentMetadataAiFillRunResult {
+    success: boolean;
+    errorMessage?: string;
+    /** User chose Skip on the loading dialog; treat as neutral (no failure toast) where applicable. */
+    cancelled?: boolean;
+    /** User declined OCR on the confirm dialog. */
+    declined?: boolean;
+}
+/**
+ * Shared OCR + AI metadata prefill UX: confirm after image choose, then indeterminate loading dialog.
+ */
+declare class AXEDocumentMetadataAiFillOrchestrator {
+    private readonly prefill;
+    private readonly dialogService;
+    private readonly loadingDialog;
+    private readonly translation;
+    private readonly debug;
+    /**
+     * Asks whether to run OCR; on Yes runs {@link run}, on No returns {@link AXEDocumentMetadataAiFillRunResult.declined}.
+     */
+    confirmAndRun(dialogTarget: AXEDocumentMetadataAiFillDialogTarget, integration: Record<string, unknown>): Promise<AXEDocumentMetadataAiFillRunResult>;
+    /**
+     * Runs metadata AI fill when eligible; shows an indeterminate loading dialog while work is in progress.
+     */
+    run(dialogTarget: AXEDocumentMetadataAiFillDialogTarget, integration: Record<string, unknown>): Promise<AXEDocumentMetadataAiFillRunResult>;
+    private applyProgressText;
+    private markProgressComplete;
+    private resolveFailureMessage;
+    private formatProgressLine;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXEDocumentMetadataAiFillOrchestrator, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXEDocumentMetadataAiFillOrchestrator>;
+}
+
+/**
+ * When document extraction is enabled and the attachment dialog has metadata + extractable files, prompts the user
+ * after files appear. Yes → loading dialog + AI prefill; No → leave metadata form empty for manual entry.
+ * Dedupes by attachment-slot signature so field edits do not re-prompt.
+ */
+declare const AXEDocumentLayoutBuilderDialogContextChangedHookProvider: AXPDistributedEventListenerProvider<AXPLayoutBuilderDialogContextChangedPayload, AXPLayoutBuilderDialogContextChangedPayload>;
+
+export { AXEAIDocumentExtensionModule, AXEDocumentAiSettingProvider, AXEDocumentLayoutBuilderDialogContextChangedHookProvider, AXEDocumentMetadataAiFillOrchestrator, AXEDocumentMetadataAiPrefillService, AXE_DOCUMENT_ATTACHMENT_DIALOG_HOOK_KEY, DOCUMENT_EXPIRATION_DATE_FIELD_NAME, collectMetadataFieldDescriptors, isAiExtractableFileListItem, mergeMetadataPrefill, normalizePrefillDateValue, parseMetadataMappingJson, splitMappedPrefill, withDocumentExpirationField };
+export type { AXEDocumentAttachmentDialogEligibility, AXEDocumentAttachmentDialogHookPayload, AXEDocumentMetadataAiFillDialogTarget, AXEDocumentMetadataAiFillRunResult, AXEDocumentMetadataAiPrefillPhase, AXEDocumentMetadataAiPrefillProgressEvent, DocumentMetadataFieldDescriptor };