@onlineapps/content-resolver 1.1.2 → 1.1.3

package/README.md

@@ -41,6 +41,7 @@ const content = await resolver.resolve('minio://workflow/path/to/file.txt');
 // Store large content - returns Content Descriptor
 const descriptor = await resolver.store(largeText, { workflow_id: 'wf-123' }, 'document.html');
 // → {
+//     _descriptor: true,
 //     type: 'file',
 //     storage_ref: 'minio://workflow/...',
 //     filename: 'document.html',
@@ -122,6 +123,7 @@ Stores large content fields as Descriptors (returns Descriptors, not plain strin
 ```javascript
 // Inline content (small)
 {
+  _descriptor: true,
   type: 'inline',
   content: 'actual text content',
   encoding: 'utf-8',
@@ -133,6 +135,7 @@ Stores large content fields as Descriptors (returns Descriptors, not plain strin
 
 // File content (large or binary)
 {
+  _descriptor: true,
   type: 'file',
   storage_ref: 'minio://workflow/path/to/file',
   filename: 'invoice.pdf',
@@ -142,6 +145,10 @@ Stores large content fields as Descriptors (returns Descriptors, not plain strin
 }
 ```
 
+**Descriptor Identification:**
+- `_descriptor: true` - Explicit identifier that value is a Content Descriptor
+- `type: "inline"|"file"` - Distinguishes inline text from file reference
+
 ### Usage Example
 
 ```javascript

package/package.json

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

package/src/index.js

@@ -28,7 +28,8 @@ function isDescriptor(value) {
   if (!value || typeof value !== 'object' || Array.isArray(value)) {
     return false;
   }
-  return value.type === 'inline' || value.type === 'file';
+  // Check explicit identifier first, then fallback to type check for backward compatibility
+  return value._descriptor === true || (value.type === 'inline' || value.type === 'file');
 }
 
 /**
@@ -196,6 +197,7 @@ class ContentResolver {
   async store(content, context = {}, filename = null, content_type = null) {
     if (!content) {
       return {
+        _descriptor: true,
         type: 'inline',
         content: '',
         encoding: 'utf-8',
@@ -417,6 +419,7 @@ class ContentResolver {
       const finalContentType = content_type || getContentType(finalFilename, buffer);
       
       return {
+        _descriptor: true,
         type: 'file',
         storage_ref: `minio://workflow/${result.path}`,
         filename: finalFilename,
@@ -450,6 +453,7 @@ class ContentResolver {
       const finalFilename = filename || `${result.fingerprint.slice(0, 8)}.${ext}`;
       
       return {
+        _descriptor: true,
         type: 'file',
         storage_ref: `minio://workflow/${result.path}`,
         filename: finalFilename,
@@ -464,6 +468,7 @@ class ContentResolver {
     const fingerprint = crypto.createHash('sha256').update(contentString).digest('hex');
     
     return {
+      _descriptor: true,
       type: 'inline',
       content: contentString,
       encoding: 'utf-8',
@@ -481,8 +486,12 @@ class ContentResolver {
    * @returns {Promise<Object>} Content Descriptor
    */
   async normalizeToDescriptor(value, options = {}) {
-    // Already a Descriptor
+    // Already a Descriptor - ensure it has _descriptor flag
     if (isDescriptor(value)) {
+      // Ensure _descriptor flag is present
+      if (value._descriptor !== true) {
+        return { ...value, _descriptor: true };
+      }
       return value;
     }