CompRes™ Docs.

CompRes (Compression & Resolution) is a high-efficiency media and document optimization service. It drastically reduces file sizes (up to 99% for documents) by decoupling structural data from content, returning highly compressed "DNA" payloads that are reconstructed dynamically on the client side.

1. SDK Installation

Include the Javascript SDK directly in your HTML. You need both the SDK for API interaction and the Universal Viewer for rendering D-DNA files.

<!-- 1. CompRes API Client SDK -->
<script src="https://connekt.social/static/sdk/compres-service/compres-sdk-v1.js"></script>

<!-- 2. CompRes Universal Viewer (For rendering documents and media) -->
<script src="https://connekt.social/static/sdk/compres-service/compres-viewer-v1.js"></script>
<link rel="stylesheet" href="https://connekt.social/static/sdk/compres-service/compres-viewer-v1.css">

2. Secure Initialization

Instantiate the SDK using your Public API Key. Because CompRes uses strict security, you must perform an RACP (Robust Agent Communication Protocol) handshake. This means your backend must generate an HMAC-SHA256 signature using your Secret Key and pass it to your frontend.

const sdk = new CompResSDK("YOUR_PUBLIC_API_KEY");

// Retrieve these values from your backend
const timestamp = 1712560000; 
const signature = "HMAC_SHA256(payload, 'YOUR_SECRET_KEY')"; 

// Initialize the secure session
const isReady = await sdk.initialize(signature, timestamp);

if (isReady) {
    console.log("CompRes is ready to use!");
}

3. Compressing Files (Upload)

Use the optimize() method to compress a standard file. CompRes automatically detects the file type (Document, Audio, Video) and processes it into a lightweight DNA stream.

// Assuming `file` is obtained from an 
const result = await sdk.optimize(file);

if (result) {
    // The DNA Token you should save to your database
    console.log("Database Token:", result.token); 
    
    // Detailed compression metrics
    console.log("Bandwidth Saved:", result.metrics.savings.toFixed(2) + "%");
    
    // Optional: Raw compressed binary payload
    console.log("Payload:", result.compressedData);
}

4. Resolving & Viewing

When a user wants to view a file, fetch the DNA payload using resolveDNA() and mount it directly into an empty HTML container using the Universal Viewer.

<!-- Your UI Container -->
<div id="document-container" style="height: 600px; width: 100%;"></div>

<script>
// 1. Fetch the DNA package using the stored token
const dnaResult = await sdk.resolveDNA("KUFv3|DOC|abc123xyz...");

if (dnaResult) {
    // 2. Mount it into the UI container
    await sdk.mountViewer('document-container', dnaResult);
}
</script>