conjureing

Official SDK for Conjure — AI on-command delivery. Describe what you need; Conjure finds it, buys it, and delivers it in under an hour.

Install

npm install conjureing

Quick Start

import Conjure from "conjureing";

const conjure = new Conjure("ck_...");

// 1. Build a binding quote (places a payment hold, valid 15 min)
const quote = await conjure.request({
  items: [
    { name: "oat milk", quantity: 2 },
    { name: "sourdough loaf" },
  ],
  delivery_address: {
    street: "1 Market St",
    city: "San Francisco",
    state: "CA",
    zip: "94105",
  },
});
// { quote_id, total_cents, eta_minutes, expires_at, ... }

// 2. Confirm to place the order
const order = await conjure.confirm({ quote_id: quote.quote_id });
// { order_id, status: "placed", eta_minutes }

// 3. Track it
const status = await conjure.track({ order_id: order.order_id });
// { status: "in_transit", eta_minutes, ... }

Authentication

Every request needs a Conjure key (ck_...). Generate one from your account at conjure.ing.

const conjure = new Conjure("ck_...");

// Or with options:
const conjure = new Conjure({
  apiKey: "ck_...",
  baseUrl: "https://conjure.ing", // default
});

API

All methods are async and return typed results.

| Method | What it does | |---|---| | check({ items, delivery_address }) | Availability + estimated prices. No commitment, no charge. | | request({ items, delivery_address, deliver_by? }) | Binding quote with a payment hold. Returns a quote_id valid 15 minutes. | | confirm({ quote_id }) | Accept a quote and place the order. | | track({ order_id }) | Real-time status, ETA, and delivery details. | | cancel({ order_id }) | Cancel before pickup. | | issue({ order_id, type, description?, affected_items? }) | Report a problem with a delivered order. Auto-resolves most cases with a refund or credit. |

Check before you buy

const availability = await conjure.check({
  items: [{ name: "ice cream" }],
  delivery_address: { street: "1 Market St", city: "San Francisco", state: "CA", zip: "94105" },
});
// { available, estimated_total_cents, estimated_eta_minutes, items: [...] }

Report an issue

await conjure.issue({
  order_id: "ord_...",
  type: "missing_items",
  affected_items: ["sourdough loaf"],
});
// { resolution: "refund", refund_cents, message }

Errors

Failed calls throw a ConjureError with the message and HTTP status:

import Conjure, { ConjureError } from "conjureing";

try {
  await conjure.confirm({ quote_id: "expired" });
} catch (err) {
  if (err instanceof ConjureError) {
    console.error(err.status, err.message);
  }
}

License

MIT