WordPress Plugin

superseeded-upload/
├── superseeded-upload.php    # Main plugin file
├── embed.min.js              # SuperSeeded embed SDK
├── js/
│   ├── init.js               # Widget initializer
│   └── block.js              # Gutenberg block
└── readme.txt                # Plugin readme

[superseeded_upload]

[superseeded_upload theme="dark" class="custom-uploader"]

// Get the upload container
const container = document.querySelector('.superseeded-upload-container');

// File added
container.addEventListener('superseeded:file-added', (e) => {
  console.log('File selected:', e.detail.name);
});

// Upload progress
container.addEventListener('superseeded:progress', (e) => {
  console.log(`Progress: ${e.detail.percentage}%`);
});

// Upload complete
container.addEventListener('superseeded:complete', (e) => {
  console.log('Upload complete:', e.detail.id);
  console.log('TUS URL:', e.detail.uploadURL);
  console.log('File URL:', e.detail.fileUrl);
});

// Upload error
container.addEventListener('superseeded:error', (e) => {
  console.error('Upload failed:', e.detail.error);
});

// Specs resolved (JSON files only) - enrichment data ready
container.addEventListener('superseeded:specs-resolved', (e) => {
  console.log('Enrichment complete:', e.detail.specsData);
  // Access enriched items, usage info, etc.
});

// Individual route completed
container.addEventListener('superseeded:route-complete', (e) => {
  console.log(`Route ${e.detail.route.name} completed:`, e.detail.result);
});

// Individual route failed (other routes continue)
container.addEventListener('superseeded:route-error', (e) => {
  console.error(`Route ${e.detail.route.name} failed:`, e.detail.error);
});

// All routes finished processing
container.addEventListener('superseeded:routes-complete', (e) => {
  console.log(`Routes complete: ${e.detail.successful} succeeded, ${e.detail.failed} failed`);
  console.log('All results:', e.detail.results);
});

.superseeded-upload-container {
  --superseeded-primary: #4f46e5;
  --superseeded-primary-hover: #4338ca;
  --superseeded-background: #ffffff;
  --superseeded-surface: #f5f5f5;
  --superseeded-text: #1a1a1a;
  --superseeded-text-muted: #666666;
  --superseeded-border: #e0e0e0;
  --superseeded-border-radius: 8px;
}

/* Style only dark-themed widgets */
.superseeded-upload-container[data-theme="dark"] {
  --superseeded-background: #0a0a0a;
  --superseeded-surface: #1a1a1a;
}

// After dynamic content is loaded
if (window.SuperSeededWordPress) {
  window.SuperSeededWordPress.init();
}

POST /wp-json/superseeded/v1/token

{}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "tusEndpoint": "https://secure.superseeded.ai/files/"
}

POST /wp-json/superseeded/v1/upload-complete

{
  "upload_id": "abc123",
  "tus_url": "https://secure.superseeded.ai/files/abc123",
  "file_name": "products.csv",
  "file_size": 102400,
  "file_type": "text/csv",
  "merchant_id": "acme-corp"
}

POST /wp-json/superseeded/v1/verify/pot-sizes

{
  "items": ["400mm AS", "20L Planter Bag"]
}

{
  "results": [
    {
      "input_label": "400mm AS",
      "match_confidence": "Medium",
      "standard_data": {
        "id": "3.2",
        "type": "Pot - Square",
        "stage_name": "Retail & Small Production"
      }
    }
  ]
}

add_action( 'superseeded_upload_complete', function( $upload_data ) {
    // $upload_data contains:
    // - upload_id: Unique upload identifier
    // - tus_url: Full TUS upload URL
    // - file_name: Original filename
    // - file_size: Size in bytes
    // - file_type: MIME type
    // - merchant_id: Merchant identifier
    // - timestamp: Upload completion time
    // - user_id: WordPress user ID (0 if guest)

    // Example: Store in custom table
    global $wpdb;
    $wpdb->insert(
        $wpdb->prefix . 'superseeded_uploads',
        $upload_data
    );

    // Example: Send notification
    wp_mail(
        get_option( 'admin_email' ),
        'New SuperSeeded Upload',
        'File uploaded: ' . $upload_data['file_name']
    );
}, 10, 1 );

add_action( 'superseeded_specs_resolved', function( $response, $items ) {
    // $response: The resolved specs response from SuperSeeded API
    // $items: The original items array that was submitted

    // Example: Cache the results
    set_transient(
        'superseeded_specs_' . md5( serialize( $items ) ),
        $response,
        HOUR_IN_SECONDS
    );
}, 10, 2 );

// Initialize all widgets (useful after AJAX content loads)
SuperSeededWordPress.init();

// Initialize a specific container
const container = document.getElementById('my-upload-container');
SuperSeededWordPress.initializeWidget(container);

// Fetch a new delegation token
SuperSeededWordPress.fetchDelegationToken().then(function(tokenData) {
    console.log('Token:', tokenData.token);
    console.log('TUS Endpoint:', tokenData.tusEndpoint);
});

// Call verify-pot-sizes via WordPress proxy (for manual item arrays)
SuperSeededWordPress.resolveSpecs(['400mm AS', '20L Planter Bag']).then(function(result) {
    console.log('Results:', result.results);
}).catch(function(error) {
    console.error('Failed to resolve specs:', error);
});

// Call verify-pot-sizes directly using delegation token and file URL
// (This is what the widget uses internally after upload)
SuperSeededWordPress.resolveSpecsFromUpload(fileUrl, token).then(function(result) {
    console.log('Results:', result.results);
});

// Notify WordPress of upload completion
SuperSeededWordPress.notifyUploadComplete(result, fileName, fileSize, fileType);

// Execute enabled routes manually (called automatically after upload)
SuperSeededWordPress.executeEnabledRoutes(fileUrl, token, file, fileId, container, fileElement)
    .then(function(results) {
        console.log('All routes processed:', results);
    });

// Execute a single route
SuperSeededWordPress.executeRoute(routeConfig, fileUrl, token, apiBaseUrl, fileName)
    .then(function(data) {
        console.log('Route result:', data);
    });

document.addEventListener('superseeded:server-notified', function(e) {
    console.log('Server recorded upload:', e.detail);
    // e.detail contains the response from upload-complete endpoint
});

<!-- In your page content -->
[superseeded_upload]

<div id="upload-status" style="display: none; margin-top: 20px;">
  <p id="status-message"></p>
</div>

<script>
document.addEventListener('DOMContentLoaded', function() {
  const container = document.querySelector('.superseeded-upload-container');
  const status = document.getElementById('upload-status');
  const message = document.getElementById('status-message');

  container.addEventListener('superseeded:complete', function(e) {
    status.style.display = 'block';
    message.textContent = 'Thank you! Your file has been uploaded successfully.';
    message.style.color = 'green';
  });

  container.addEventListener('superseeded:error', function(e) {
    status.style.display = 'block';
    message.textContent = 'Upload failed: ' + e.detail.message;
    message.style.color = 'red';
  });
});
</script>

<?php
/**
 * Handle SuperSeeded upload completion
 */
add_action( 'superseeded_upload_complete', function( $upload_data ) {
    // Log the upload
    error_log( sprintf(
        'SuperSeeded upload: %s (%s bytes) by user %d',
        $upload_data['file_name'],
        $upload_data['file_size'],
        $upload_data['user_id']
    ) );

    // Store in database for tracking
    update_user_meta(
        $upload_data['user_id'],
        'last_superseeded_upload',
        $upload_data
    );

    // Trigger WooCommerce order note (if applicable)
    if ( class_exists( 'WooCommerce' ) ) {
        // Your WooCommerce integration logic
    }
}, 10, 1 );

/**
 * Handle resolved specs from processed request
 */
add_action( 'superseeded_specs_resolved', function( $response, $items ) {
    // Cache resolved specs data
    foreach ( $response['results'] ?? [] as $result ) {
        set_transient(
            'product_specs_' . sanitize_key( $result['input_label'] ),
            $result,
            DAY_IN_SECONDS
        );
    }

    // Log processing
    error_log( sprintf(
        'SuperSeeded resolved %d items',
        count( $response['results'] ?? [] )
    ) );
}, 10, 2 );