Prefetch for Faster Response

# 1. As soon as the email field validates, fire a prefetch.
curl -X POST https://api.context.dev/v1/utility/prefetch \
  -H "Authorization: Bearer $CONTEXT_DEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "brand",
    "identifier": { "email": "[email protected]" }
  }'

# 2. On submit, the real call hits a warm cache.
curl -X POST https://api.context.dev/v1/brand/retrieve \
  -H "Authorization: Bearer $CONTEXT_DEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"by_domain","domain":"acme.com"}'

import ContextDev from "context.dev";

const client = new ContextDev({ apiKey: process.env.CONTEXT_DEV_API_KEY });

// 1. As soon as the email field validates, fire a prefetch.
async function onEmailEntered(email: string) {
  // Fire-and-forget. Ignore errors (disposable email, etc.).
  client.utility
    .prefetch({ type: "brand", identifier: { email } })
    .catch(() => {});
}

// 2. On submit, the real call hits a warm cache.
async function onSignupComplete(email: string) {
  const domain = email.split("@")[1];
  const { brand } = await client.brand.retrieve({ type: "by_domain", domain });
  return brand;
}

import os
from context.dev import ContextDev

client = ContextDev(api_key=os.environ["CONTEXT_DEV_API_KEY"])

# 1. As soon as the email field validates, fire a prefetch.
def on_email_entered(email: str) -> None:
    try:
        client.utility.prefetch(type="brand", identifier={"email": email})
    except Exception:
        pass  # disposable / personal email; safe to ignore

# 2. On submit, the real call hits a warm cache.
def on_signup_complete(email: str):
    domain = email.split("@", 1)[1]
    return client.brand.retrieve(type="by_domain", domain=domain).brand

require "context_dev"

client = ContextDev::Client.new(api_key: ENV.fetch("CONTEXT_DEV_API_KEY"))

# 1. Fire a prefetch the moment the email validates.
def on_email_entered(client, email)
  client.utility.prefetch(type: "brand", identifier: { email: email })
rescue StandardError
  # disposable / personal email; safe to ignore
end

# 2. On submit, the real call hits a warm cache.
def on_signup_complete(client, email)
  domain = email.split("@", 2).last
  client.brand.retrieve(body: { type: :by_domain, domain: domain }).brand
end

package main

import (
    "context"
    "os"
    "strings"

    contextdev "github.com/context-dot-dev/context-go-sdk"
    "github.com/context-dot-dev/context-go-sdk/option"
)

func main() {
    client := contextdev.NewClient(
        option.WithAPIKey(os.Getenv("CONTEXT_DEV_API_KEY")),
    )
    ctx := context.TODO()

    // 1. Fire a prefetch on email entry. Ignore errors.
    _, _ = client.Utility.Prefetch(ctx, contextdev.UtilityPrefetchParams{
        Type: "brand",
        Identifier: contextdev.UtilityPrefetchParamsIdentifier{
            Email: "[email protected]",
        },
    })

    // 2. On submit, the user-facing call lands warm.
    domain := strings.Split("[email protected]", "@")[1]
    _, _ = client.Brand.Get(ctx, contextdev.BrandGetParams{
        OfByDomain: &contextdev.BrandGetParamsBodyByDomain{Domain: domain},
    })
}

<?php

use ContextDev\Client;

$client = new Client(apiKey: getenv('CONTEXT_DEV_API_KEY'));

// 1. As soon as the email field validates, fire a prefetch.
function onEmailEntered(string $email): void
{
    global $client;
    try {
        $client->utility->prefetch(type: 'brand', identifier: ['email' => $email]);
    } catch (Throwable) {
        // disposable / personal email; safe to ignore
    }
}

// 2. On submit, the real call hits a warm cache.
function onSignupComplete(string $email)
{
    global $client;
    $domain = explode('@', $email, 2)[1];
    return $client->brand->retrieve(type: 'by_domain', domain: $domain)->brand;
}