detect_then_analyze.php

<?php

/**
 * Routing a mixed inbox.
 *
 * The pattern is detect (1 credit per 10 calls, amortised) → analyze with the chosen preset
 * (normal price). Worth it when the *type* is the decision: you can refuse to spend 40
 * credits on a 40-page PDF that turns out to be a scanned fax cover sheet.
 *
 * If you just want the data and don't care which preset produced it, skip this and pass
 * 'preset' => 'auto' — classification bundled into an extraction is free.
 *
 *   php examples/detect_then_analyze.php ./inbox
 */

declare(strict_types=1);

require __DIR__ . '/../vendor/autoload.php';

use VisionApi\Client;
use VisionApi\Result;

$inbox = $argv[1] ?? './inbox';
$vision = new Client();

// What we are willing to spend extraction credits on, and what to do otherwise.
$handled = ['invoice', 'receipt', 'purchase_order', 'packing_slip'];
$supported = ['pdf', 'png', 'jpg', 'jpeg', 'webp', 'tif', 'tiff'];

foreach (scandir($inbox) ?: [] as $name) {
    if (!in_array(strtolower(pathinfo($name, PATHINFO_EXTENSION)), $supported, true)) {
        continue;
    }

    $path = $inbox . '/' . $name;
    $guess = $vision->detect(['file' => $path]);

    // fallback means nothing matched confidently and the generic preset was substituted.
    // That is "shape unknown", not a match — check what was rejected.
    if ($guess['fallback']) {
        $closest = $guess['detections'][0] ?? null;
        $extra = $closest ? " (closest: {$closest['preset']} — {$closest['reason']})" : '';
        echo "{$name}: unrecognised{$extra}\n";
        continue;
    }

    if (!in_array($guess['recommended'], $handled, true)) {
        echo "{$name}: {$guess['recommended']} — not a type we process, skipping\n";
        continue;
    }

    // `recommended` is exactly what 'preset' => 'auto' would have run, so it is safe to commit.
    $res = $vision->analyze(['file' => $path, 'preset' => $guess['recommended']]);
    $summary = substr(json_encode(Result::unwrap($res['result'], dropNull: true)), 0, 160);
    echo "{$name}: {$guess['recommended']} → {$res['credits_used']} credit(s)  {$summary}\n";
}

echo "\n", $vision->credits()['balance'], " credits remaining\n";