@onlineapps/content-resolver 1.1.3 → 1.1.4

package/README.md

@@ -110,6 +110,30 @@ Create Content Descriptor from raw content. Automatically decides inline vs file
 #### `normalizeToDescriptor(value, options): Promise<Object>`
 Normalize any value (string, reference, Buffer) to Content Descriptor.
 
+#### `createDescriptorFromFile(tempPath, options): Promise<Object>`
+Create Content Descriptor from a temp file. **Used by ApiMapper for file outputs.**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `filename` | string | basename | Output filename |
+| `content_type` | string | auto-detect | MIME type |
+| `context` | Object | {} | `{ workflow_id, step_id }` |
+| `deleteAfterUpload` | boolean | true | Delete temp file after upload |
+
+```javascript
+// Handler returns temp file path
+const handlerOutput = { temp_path: '/tmp/output.pdf', filename: 'report.pdf', content_type: 'application/pdf' };
+
+// ApiMapper calls createDescriptorFromFile
+const descriptor = await resolver.createDescriptorFromFile(handlerOutput.temp_path, {
+  filename: handlerOutput.filename,
+  content_type: handlerOutput.content_type,
+  context: { workflow_id: 'wf-123', step_id: 'pdf_gen' },
+  deleteAfterUpload: true  // Cleanup temp file
+});
+// → Content Descriptor with _descriptor: true, type: 'file', storage_ref, etc.
+```
+
 #### `resolveInput(input, fields?): Promise<Object>`
 Resolves all reference fields in input object (legacy method).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlineapps/content-resolver",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Automatic conversion between text content and storage references with Content Descriptor pattern",
   "main": "src/index.js",
   "scripts": {
@@ -22,4 +22,3 @@
     "@onlineapps/conn-base-storage": "^1.0.0"
   }
 }
-

package/src/index.js

@@ -511,6 +511,110 @@ class ContentResolver {
     // Fallback
     return await this.createDescriptor(String(value), options);
   }
+
+  /**
+   * Create Content Descriptor from a temp file path
+   * Reads file, uploads to MinIO, returns Descriptor, DELETES temp file
+   * 
+   * @param {string} tempPath - Path to temp file
+   * @param {Object} options - Options
+   * @param {string} options.filename - Output filename
+   * @param {string} options.content_type - MIME type
+   * @param {Object} options.context - Workflow context { workflow_id, step_id }
+   * @param {boolean} options.deleteAfterUpload - Delete temp file after upload (default: true)
+   * @returns {Promise<Object>} Content Descriptor
+   */
+  async createDescriptorFromFile(tempPath, options = {}) {
+    const fs = require('fs');
+    const path = require('path');
+    
+    const { 
+      filename, 
+      content_type, 
+      context = {}, 
+      deleteAfterUpload = true 
+    } = options;
+    
+    // Validate temp file exists
+    if (!fs.existsSync(tempPath)) {
+      throw new Error(`[ContentResolver:FAIL] Temp file not found: ${tempPath}`);
+    }
+    
+    // Read file into buffer
+    const buffer = fs.readFileSync(tempPath);
+    const size = buffer.length;
+    
+    // Determine filename and content_type
+    const finalFilename = filename || path.basename(tempPath);
+    const finalContentType = content_type || getContentType(finalFilename, buffer);
+    
+    // Log start
+    const logContext = {
+      workflow_id: context.workflow_id || 'standalone',
+      step_id: context.step_id || 'content-resolver'
+    };
+    console.log(`[${logContext.workflow_id}:${logContext.step_id}:ContentResolver:STORE_START] ${JSON.stringify({
+      temp_path: tempPath,
+      filename: finalFilename,
+      content_type: finalContentType,
+      size: size
+    })}`);
+    
+    try {
+      // Upload to MinIO
+      const storage = await this.getStorage();
+      const workflowId = context.workflow_id || 'standalone';
+      const stepId = context.step_id || 'content';
+      const pathPrefix = `outputs/${workflowId}/${stepId}`;
+      const ext = finalFilename.split('.').pop() || 'bin';
+      
+      const result = await storage.uploadWithFingerprint(
+        'workflow',
+        buffer,
+        pathPrefix,
+        ext
+      );
+      
+      // Build Descriptor
+      const descriptor = {
+        _descriptor: true,
+        type: 'file',
+        storage_ref: `minio://workflow/${result.path}`,
+        filename: finalFilename,
+        content_type: finalContentType,
+        size: size,
+        fingerprint: result.fingerprint
+      };
+      
+      // Delete temp file if requested
+      if (deleteAfterUpload) {
+        try {
+          fs.unlinkSync(tempPath);
+        } catch (unlinkErr) {
+          console.warn(`[${logContext.workflow_id}:${logContext.step_id}:ContentResolver:WARN] Failed to delete temp file: ${unlinkErr.message}`);
+        }
+      }
+      
+      // Log success
+      console.log(`[${logContext.workflow_id}:${logContext.step_id}:ContentResolver:STORE_SUCCESS] ${JSON.stringify({
+        storage_ref: descriptor.storage_ref,
+        filename: descriptor.filename,
+        size: descriptor.size,
+        fingerprint: descriptor.fingerprint.substring(0, 16) + '...'
+      })}`);
+      
+      return descriptor;
+      
+    } catch (error) {
+      // Log failure
+      console.error(`[${logContext.workflow_id}:${logContext.step_id}:ContentResolver:STORE_FAIL] ${JSON.stringify({
+        error: error.message,
+        temp_path: tempPath,
+        filename: finalFilename
+      })}`);
+      throw error;
+    }
+  }
 }
 
 // Export class and utilities