Function objectToStub

apps/sim/connectors/s3/s3.ts:436–456

* Builds a metadata stub for an S3 object. The content hash combines the key * and ETag — S3's ETag changes whenever object content changes, making it an * ideal change indicator. Used by both listDocuments and getDocument to * guarantee identical hashes.

(ctx: S3Context, entry: S3ObjectEntry)

 * guarantee identical hashes.
 */
function objectToStub(ctx: S3Context, entry: S3ObjectEntry): ExternalDocument {
  const title = entry.key.split('/').pop() || entry.key
  const prefix = entry.key.includes('/') ? entry.key.slice(0, entry.key.lastIndexOf('/')) : ''

  return {
    externalId: entry.key,
    title,
    content: '',
    contentDeferred: true,
    mimeType: 'text/plain',
    sourceUrl: buildUrl(ctx, buildObjectPath(ctx, entry.key), ''),
    contentHash: `s3:${entry.key}:${entry.etag}`,
    metadata: {
      key: entry.key,
      prefix,
      etag: entry.etag,
      lastModified: entry.lastModified,
      fileSize: entry.size,
    },
  }
}

/**
 * Performs a single ListObjectsV2 page request and returns the parsed result.