mtgjson-sdk 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,1043 @@
+import { DuckDBInstance } from '@duckdb/node-api';
+
+type ProgressCallback = (filename: string, bytesDownloaded: number, totalBytes: number | null) => void;
+declare class CacheManager {
+    readonly cacheDir: string;
+    readonly offline: boolean;
+    readonly timeout: number;
+    private _remoteVersion;
+    private _onProgress;
+    constructor(options?: {
+        cacheDir?: string;
+        offline?: boolean;
+        timeout?: number;
+        onProgress?: ProgressCallback;
+    });
+    init(): Promise<void>;
+    close(): void;
+    private _localVersion;
+    private _saveVersion;
+    remoteVersion(): Promise<string | null>;
+    isStale(): Promise<boolean>;
+    private _downloadFile;
+    private _handleDownloadResponse;
+    ensureParquet(viewName: string): Promise<string>;
+    ensureJson(name: string): Promise<string>;
+    loadJson(name: string): Promise<Record<string, unknown>>;
+    clear(): Promise<void>;
+}
+
+type DuckDBConnection = Awaited<ReturnType<DuckDBInstance["connect"]>>;
+declare class Connection {
+    private _conn;
+    private _instance;
+    _registeredViews: Set<string>;
+    cache: CacheManager;
+    private constructor();
+    static create(cache: CacheManager): Promise<Connection>;
+    close(): Promise<void>;
+    private _ensureView;
+    private _buildCsvReplace;
+    private _registerLegalitiesView;
+    registerTableFromData(tableName: string, data: Record<string, unknown>[]): Promise<void>;
+    registerTableFromNdjson(tableName: string, ndjsonPath: string): Promise<void>;
+    ensureViews(...viewNames: string[]): Promise<void>;
+    execute(sql: string, params?: unknown[]): Promise<Record<string, unknown>[]>;
+    executeJson(sql: string, params?: unknown[]): Promise<string>;
+    executeScalar(sql: string, params?: unknown[]): Promise<unknown>;
+    get raw(): DuckDBConnection;
+    private _run;
+    private _runWithParams;
+}
+
+type ForeignDataIdentifiers = {
+    multiverseId?: string;
+    scryfallId?: string;
+};
+type ForeignData = {
+    faceName?: string;
+    flavorText?: string;
+    identifiers?: ForeignDataIdentifiers;
+    language: string;
+    multiverseId?: number;
+    name: string;
+    text?: string;
+    type?: string;
+    uuid?: string;
+};
+type Identifiers = {
+    abuId?: string;
+    cardKingdomEtchedId?: string;
+    cardKingdomFoilId?: string;
+    cardKingdomId?: string;
+    cardsphereFoilId?: string;
+    cardsphereId?: string;
+    cardtraderId?: string;
+    csiId?: string;
+    deckboxId?: string;
+    mcmId?: string;
+    mcmMetaId?: string;
+    miniaturemarketId?: string;
+    mtgArenaId?: string;
+    mtgjsonFoilVersionId?: string;
+    mtgjsonNonFoilVersionId?: string;
+    mtgjsonV4Id?: string;
+    mtgoFoilId?: string;
+    mtgoId?: string;
+    multiverseId?: string;
+    mvpId?: string;
+    scgId?: string;
+    scryfallCardBackId?: string;
+    scryfallId?: string;
+    scryfallIllustrationId?: string;
+    scryfallOracleId?: string;
+    tcgplayerEtchedProductId?: string;
+    tcgplayerProductId?: string;
+    tntId?: string;
+};
+type LeadershipSkills = {
+    brawl: boolean;
+    commander: boolean;
+    oathbreaker: boolean;
+};
+type Legalities = {
+    alchemy?: string;
+    brawl?: string;
+    commander?: string;
+    duel?: string;
+    explorer?: string;
+    future?: string;
+    gladiator?: string;
+    historic?: string;
+    historicbrawl?: string;
+    legacy?: string;
+    modern?: string;
+    oathbreaker?: string;
+    oldschool?: string;
+    pauper?: string;
+    paupercommander?: string;
+    penny?: string;
+    pioneer?: string;
+    predh?: string;
+    premodern?: string;
+    standard?: string;
+    standardbrawl?: string;
+    timeless?: string;
+    vintage?: string;
+};
+type PurchaseUrls = {
+    cardKingdom?: string;
+    cardKingdomEtched?: string;
+    cardKingdomFoil?: string;
+    cardmarket?: string;
+    tcgplayer?: string;
+    tcgplayerEtched?: string;
+};
+type RelatedCards = {
+    reverseRelated?: string[];
+    spellbook?: string[];
+    tokens?: string[];
+};
+type Rulings = {
+    date: string;
+    text: string;
+};
+type SourceProducts = {
+    etched?: string[];
+    foil?: string[];
+    nonfoil?: string[];
+};
+type Meta = {
+    date: string;
+    version: string;
+};
+type Translations = {
+    "Ancient Greek"?: string;
+    Arabic?: string;
+    "Chinese Simplified"?: string;
+    "Chinese Traditional"?: string;
+    French?: string;
+    German?: string;
+    Hebrew?: string;
+    Italian?: string;
+    Japanese?: string;
+    Korean?: string;
+    Latin?: string;
+    Phyrexian?: string;
+    "Portuguese (Brazil)"?: string;
+    Russian?: string;
+    Sanskrit?: string;
+    Spanish?: string;
+};
+type TcgplayerSkus = {
+    condition: string;
+    finish?: string;
+    language: string;
+    printing: string;
+    productId: number;
+    skuId: number;
+};
+type BoosterSheet = {
+    allowDuplicates?: boolean;
+    balanceColors?: boolean;
+    cards: Record<string, number>;
+    fixed?: boolean;
+    foil: boolean;
+    totalWeight: number;
+};
+type BoosterPack = {
+    contents: Record<string, number>;
+    weight: number;
+};
+type BoosterConfig = {
+    boosters: BoosterPack[];
+    boostersTotalWeight: number;
+    name?: string;
+    sheets: Record<string, BoosterSheet>;
+    sourceSetCodes: string[];
+};
+type PricePoints = {
+    etched?: Record<string, number>;
+    foil?: Record<string, number>;
+    normal?: Record<string, number>;
+};
+type PriceList = {
+    buylist?: PricePoints;
+    currency: string;
+    retail?: PricePoints;
+};
+type PriceFormats = {
+    mtgo?: Record<string, PriceList>;
+    paper?: Record<string, PriceList>;
+};
+type SealedProductCard = {
+    finishes?: string[];
+    foil?: boolean;
+    name: string;
+    number: string;
+    set: string;
+    uuid: string;
+};
+type SealedProductDeck = {
+    name: string;
+    set: string;
+};
+type SealedProductOther = {
+    name: string;
+};
+type SealedProductPack = {
+    code: string;
+    set: string;
+};
+type SealedProductSealed = {
+    count: number;
+    name: string;
+    set: string;
+    uuid?: string;
+};
+type SealedProductVariableConfig = {
+    chance?: number;
+    weight?: number;
+};
+type SealedProductVariableItem = {
+    card?: SealedProductCard[];
+    deck?: SealedProductDeck[];
+    other?: SealedProductOther[];
+    pack?: SealedProductPack[];
+    sealed?: SealedProductSealed[];
+    variable_config?: SealedProductVariableConfig[];
+};
+type SealedProductVariableEntry = {
+    configs?: SealedProductVariableItem[];
+};
+type SealedProductContents = {
+    card?: SealedProductCard[];
+    deck?: SealedProductDeck[];
+    other?: SealedProductOther[];
+    pack?: SealedProductPack[];
+    sealed?: SealedProductSealed[];
+    variable?: SealedProductVariableEntry[];
+};
+type Keywords = {
+    abilityWords: string[];
+    keywordAbilities: string[];
+    keywordActions: string[];
+};
+type CardType = {
+    subTypes: string[];
+    superTypes: string[];
+};
+type CardTypes = {
+    artifact: CardType;
+    battle: CardType;
+    conspiracy: CardType;
+    creature: CardType;
+    enchantment: CardType;
+    instant: CardType;
+    land: CardType;
+    phenomenon: CardType;
+    plane: CardType;
+    planeswalker: CardType;
+    scheme: CardType;
+    sorcery: CardType;
+    tribal: CardType;
+    vanguard: CardType;
+};
+type CardSetDeck = {
+    count: number;
+    isFoil?: boolean;
+    uuid: string;
+};
+type CardToken = {
+    artist?: string;
+    artistIds?: string[];
+    asciiName?: string;
+    attractionLights?: number[];
+    availability: string[];
+    boosterTypes?: string[];
+    borderColor: string;
+    cardParts?: string[];
+    colorIdentity: string[];
+    colorIndicator?: string[];
+    colors: string[];
+    edhrecSaltiness?: number;
+    faceFlavorName?: string;
+    faceName?: string;
+    facePrintedName?: string;
+    finishes: string[];
+    flavorName?: string;
+    flavorText?: string;
+    frameEffects?: string[];
+    frameVersion: string;
+    identifiers: Identifiers;
+    isFullArt?: boolean;
+    isFunny?: boolean;
+    isOnlineOnly?: boolean;
+    isOversized?: boolean;
+    isPromo?: boolean;
+    isReprint?: boolean;
+    isTextless?: boolean;
+    keywords?: string[];
+    language: string;
+    layout: string;
+    loyalty?: string;
+    manaCost?: string;
+    name: string;
+    number: string;
+    orientation?: string;
+    originalText?: string;
+    originalType?: string;
+    otherFaceIds?: string[];
+    power?: string;
+    printedName?: string;
+    printedText?: string;
+    printedType?: string;
+    producedMana?: string[];
+    promoTypes?: string[];
+    relatedCards?: RelatedCards;
+    reverseRelated?: string[];
+    securityStamp?: string;
+    setCode: string;
+    side?: string;
+    signature?: string;
+    sourceProducts?: SourceProducts;
+    subsets?: string[];
+    subtypes: string[];
+    supertypes: string[];
+    text?: string;
+    tokenProducts?: unknown[];
+    toughness?: string;
+    type: string;
+    types: string[];
+    uuid: string;
+    watermark?: string;
+};
+type CardAtomic = {
+    asciiName?: string;
+    colorIdentity: string[];
+    colorIndicator?: string[];
+    colors: string[];
+    convertedManaCost: number;
+    defense?: string;
+    edhrecRank?: number;
+    edhrecSaltiness?: number;
+    faceConvertedManaCost?: number;
+    faceManaValue?: number;
+    faceName?: string;
+    firstPrinting?: string;
+    foreignData?: ForeignData[];
+    hand?: string;
+    hasAlternativeDeckLimit?: boolean;
+    identifiers: Identifiers;
+    isFunny?: boolean;
+    isGameChanger?: boolean;
+    isReserved?: boolean;
+    keywords?: string[];
+    layout: string;
+    leadershipSkills?: LeadershipSkills;
+    legalities: Legalities;
+    life?: string;
+    loyalty?: string;
+    manaCost?: string;
+    manaValue: number;
+    name: string;
+    power?: string;
+    printings?: string[];
+    producedMana?: string[];
+    purchaseUrls: PurchaseUrls;
+    relatedCards?: RelatedCards;
+    rulings?: Rulings[];
+    side?: string;
+    subsets?: string[];
+    subtypes: string[];
+    supertypes: string[];
+    text?: string;
+    toughness?: string;
+    type: string;
+    types: string[];
+};
+type CardSet = {
+    artist?: string;
+    artistIds?: string[];
+    asciiName?: string;
+    attractionLights?: number[];
+    availability: string[];
+    boosterTypes?: string[];
+    borderColor: string;
+    cardParts?: string[];
+    colorIdentity: string[];
+    colorIndicator?: string[];
+    colors: string[];
+    convertedManaCost: number;
+    defense?: string;
+    duelDeck?: string;
+    edhrecRank?: number;
+    edhrecSaltiness?: number;
+    faceConvertedManaCost?: number;
+    faceFlavorName?: string;
+    faceManaValue?: number;
+    faceName?: string;
+    facePrintedName?: string;
+    finishes: string[];
+    flavorName?: string;
+    flavorText?: string;
+    foreignData?: ForeignData[];
+    frameEffects?: string[];
+    frameVersion: string;
+    hand?: string;
+    hasAlternativeDeckLimit?: boolean;
+    hasContentWarning?: boolean;
+    identifiers: Identifiers;
+    isAlternative?: boolean;
+    isFullArt?: boolean;
+    isFunny?: boolean;
+    isGameChanger?: boolean;
+    isOnlineOnly?: boolean;
+    isOversized?: boolean;
+    isPromo?: boolean;
+    isRebalanced?: boolean;
+    isReprint?: boolean;
+    isReserved?: boolean;
+    isStorySpotlight?: boolean;
+    isTextless?: boolean;
+    isTimeshifted?: boolean;
+    keywords?: string[];
+    language: string;
+    layout: string;
+    leadershipSkills?: LeadershipSkills;
+    legalities: Legalities;
+    life?: string;
+    loyalty?: string;
+    manaCost?: string;
+    manaValue: number;
+    name: string;
+    number: string;
+    originalPrintings?: string[];
+    originalReleaseDate?: string;
+    originalText?: string;
+    originalType?: string;
+    otherFaceIds?: string[];
+    power?: string;
+    printedName?: string;
+    printedText?: string;
+    printedType?: string;
+    printings?: string[];
+    producedMana?: string[];
+    promoTypes?: string[];
+    purchaseUrls: PurchaseUrls;
+    rarity: string;
+    rebalancedPrintings?: string[];
+    relatedCards?: RelatedCards;
+    rulings?: Rulings[];
+    securityStamp?: string;
+    setCode: string;
+    side?: string;
+    signature?: string;
+    sourceProducts?: SourceProducts;
+    subsets?: string[];
+    subtypes: string[];
+    supertypes: string[];
+    text?: string;
+    toughness?: string;
+    type: string;
+    types: string[];
+    uuid: string;
+    variations?: string[];
+    watermark?: string;
+};
+type CardDeck = {
+    artist?: string;
+    artistIds?: string[];
+    asciiName?: string;
+    attractionLights?: number[];
+    availability: string[];
+    boosterTypes?: string[];
+    borderColor: string;
+    cardParts?: string[];
+    colorIdentity: string[];
+    colorIndicator?: string[];
+    colors: string[];
+    convertedManaCost: number;
+    count: number;
+    defense?: string;
+    duelDeck?: string;
+    edhrecRank?: number;
+    edhrecSaltiness?: number;
+    faceConvertedManaCost?: number;
+    faceFlavorName?: string;
+    faceManaValue?: number;
+    faceName?: string;
+    facePrintedName?: string;
+    finishes: string[];
+    flavorName?: string;
+    flavorText?: string;
+    foreignData?: ForeignData[];
+    frameEffects?: string[];
+    frameVersion: string;
+    hand?: string;
+    hasAlternativeDeckLimit?: boolean;
+    hasContentWarning?: boolean;
+    identifiers: Identifiers;
+    isAlternative?: boolean;
+    isEtched?: boolean;
+    isFoil: boolean;
+    isFullArt?: boolean;
+    isFunny?: boolean;
+    isGameChanger?: boolean;
+    isOnlineOnly?: boolean;
+    isOversized?: boolean;
+    isPromo?: boolean;
+    isRebalanced?: boolean;
+    isReprint?: boolean;
+    isReserved?: boolean;
+    isStorySpotlight?: boolean;
+    isTextless?: boolean;
+    isTimeshifted?: boolean;
+    keywords?: string[];
+    language: string;
+    layout: string;
+    leadershipSkills?: LeadershipSkills;
+    legalities: Legalities;
+    life?: string;
+    loyalty?: string;
+    manaCost?: string;
+    manaValue: number;
+    name: string;
+    number: string;
+    originalPrintings?: string[];
+    originalReleaseDate?: string;
+    originalText?: string;
+    originalType?: string;
+    otherFaceIds?: string[];
+    power?: string;
+    printedName?: string;
+    printedText?: string;
+    printedType?: string;
+    printings?: string[];
+    producedMana?: string[];
+    promoTypes?: string[];
+    purchaseUrls: PurchaseUrls;
+    rarity: string;
+    rebalancedPrintings?: string[];
+    relatedCards?: RelatedCards;
+    rulings?: Rulings[];
+    securityStamp?: string;
+    setCode: string;
+    side?: string;
+    signature?: string;
+    sourceProducts?: SourceProducts;
+    subsets?: string[];
+    subtypes: string[];
+    supertypes: string[];
+    text?: string;
+    toughness?: string;
+    type: string;
+    types: string[];
+    uuid: string;
+    variations?: string[];
+    watermark?: string;
+};
+type DeckSet = {
+    code: string;
+    commander?: CardSetDeck[];
+    displayCommander?: CardSetDeck[];
+    mainBoard: CardSetDeck[];
+    name: string;
+    planes?: CardSetDeck[];
+    releaseDate: string;
+    schemes?: CardSetDeck[];
+    sealedProductUuids: string[] | null;
+    sideBoard: CardSetDeck[];
+    sourceSetCodes?: string[];
+    tokens?: CardSetDeck[];
+    type: string;
+};
+type SetList = {
+    baseSetSize: number;
+    block?: string;
+    cardsphereSetId?: number;
+    code: string;
+    decks?: DeckSet[];
+    isFoilOnly: boolean;
+    isForeignOnly?: boolean;
+    isNonFoilOnly?: boolean;
+    isOnlineOnly: boolean;
+    isPaperOnly?: boolean;
+    isPartialPreview?: boolean;
+    keyruneCode: string;
+    languages?: string[];
+    mcmId?: number;
+    mcmIdExtras?: number;
+    mcmName?: string;
+    mtgoCode?: string;
+    name: string;
+    parentCode?: string;
+    releaseDate: string;
+    sealedProduct?: SealedProduct[];
+    tcgplayerGroupId?: number;
+    tokenSetCode?: string;
+    totalSetSize: number;
+    translations: Translations;
+    type: string;
+};
+type MtgSet = {
+    baseSetSize: number;
+    block?: string;
+    booster?: Record<string, BoosterConfig>;
+    cards: CardSet[];
+    cardsphereSetId?: number;
+    code: string;
+    decks?: DeckSet[];
+    isFoilOnly: boolean;
+    isForeignOnly?: boolean;
+    isNonFoilOnly?: boolean;
+    isOnlineOnly: boolean;
+    isPaperOnly?: boolean;
+    isPartialPreview?: boolean;
+    keyruneCode: string;
+    languages?: string[];
+    mcmId?: number;
+    mcmIdExtras?: number;
+    mcmName?: string;
+    mtgoCode?: string;
+    name: string;
+    parentCode?: string;
+    releaseDate: string;
+    sealedProduct?: SealedProduct[];
+    tcgplayerGroupId?: number;
+    tokenSetCode?: string;
+    tokens: CardToken[];
+    totalSetSize: number;
+    translations: Translations;
+    type: string;
+};
+type SealedProduct = {
+    cardCount?: number;
+    category?: string;
+    contents?: SealedProductContents;
+    identifiers: Identifiers;
+    language?: string;
+    name: string;
+    productSize?: number;
+    purchaseUrls: PurchaseUrls;
+    releaseDate?: string;
+    setCode?: string;
+    subtype?: string;
+    uuid: string;
+};
+type DeckList = {
+    code: string;
+    fileName: string;
+    name: string;
+    releaseDate: string;
+    type: string;
+};
+type Deck = {
+    code: string;
+    commander?: CardDeck[];
+    displayCommander?: CardDeck[];
+    mainBoard: CardDeck[];
+    name: string;
+    planes?: CardDeck[];
+    releaseDate: string;
+    schemes?: CardDeck[];
+    sealedProductUuids: string[] | null;
+    sideBoard: CardDeck[];
+    sourceSetCodes?: string[];
+    tokens?: CardToken[];
+    type: string;
+};
+type AllPricesFile = {
+    meta: Meta;
+    data: Record<string, PriceFormats>;
+};
+type AllPrintingsFile = {
+    meta: Meta;
+    data: Record<string, MtgSet>;
+};
+type CardTypesFile = {
+    meta: Meta;
+    data: CardTypes;
+};
+type DeckListFile = {
+    meta: Meta;
+    data: DeckList[];
+};
+type KeywordsFile = {
+    meta: Meta;
+    data: Keywords;
+};
+type SetListFile = {
+    meta: Meta;
+    data: SetList[];
+};
+type TcgplayerSkusFile = {
+    meta: Meta;
+    data: Record<string, TcgplayerSkus[]>;
+};
+
+declare class BoosterSimulator {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    private _getBoosterConfig;
+    availableTypes(setCode: string): Promise<string[]>;
+    openPack(setCode: string, boosterType?: string): Promise<CardSet[]>;
+    openBox(setCode: string, boosterType?: string, packs?: number): Promise<CardSet[][]>;
+    sheetContents(setCode: string, boosterType: string, sheetName: string): Promise<Record<string, number> | null>;
+}
+
+declare class CardQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    getByUuid(uuid: string): Promise<CardSet | null>;
+    getByUuids(uuids: string[]): Promise<CardSet[]>;
+    getByName(name: string, options?: {
+        setCode?: string;
+    }): Promise<CardSet[]>;
+    search(options?: {
+        name?: string;
+        fuzzyName?: string;
+        localizedName?: string;
+        setCode?: string;
+        colors?: string[];
+        colorIdentity?: string[];
+        types?: string;
+        rarity?: string;
+        legalIn?: string;
+        manaValue?: number;
+        manaValueLte?: number;
+        manaValueGte?: number;
+        text?: string;
+        textRegex?: string;
+        power?: string;
+        toughness?: string;
+        artist?: string;
+        keyword?: string;
+        isPromo?: boolean;
+        availability?: string;
+        language?: string;
+        layout?: string;
+        setType?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<CardSet[]>;
+    getPrintings(name: string): Promise<CardSet[]>;
+    getAtomic(name: string): Promise<CardAtomic[]>;
+    findByScryfallId(scryfallId: string): Promise<CardSet[]>;
+    random(count?: number): Promise<CardSet[]>;
+    count(filters?: Record<string, unknown>): Promise<number>;
+}
+
+declare class SetQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    get(code: string): Promise<SetList | null>;
+    list(options?: {
+        setType?: string;
+        name?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<SetList[]>;
+    search(options?: {
+        name?: string;
+        setType?: string;
+        block?: string;
+        releaseYear?: number;
+        limit?: number;
+    }): Promise<SetList[]>;
+    getFinancialSummary(setCode: string, options?: {
+        provider?: string;
+        currency?: string;
+        finish?: string;
+        priceType?: string;
+    }): Promise<Record<string, unknown> | null>;
+    count(): Promise<number>;
+}
+
+declare class TokenQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    getByUuid(uuid: string): Promise<CardToken | null>;
+    getByUuids(uuids: string[]): Promise<CardToken[]>;
+    getByName(name: string, options?: {
+        setCode?: string;
+    }): Promise<CardToken[]>;
+    search(options?: {
+        name?: string;
+        setCode?: string;
+        colors?: string[];
+        types?: string;
+        artist?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<CardToken[]>;
+    forSet(setCode: string): Promise<CardToken[]>;
+    count(filters?: Record<string, unknown>): Promise<number>;
+}
+
+declare class PriceQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    get(uuid: string): Promise<Record<string, unknown> | null>;
+    today(uuid: string, options?: {
+        provider?: string;
+        finish?: string;
+        priceType?: string;
+    }): Promise<Record<string, unknown>[]>;
+    history(uuid: string, options?: {
+        provider?: string;
+        finish?: string;
+        priceType?: string;
+        dateFrom?: string;
+        dateTo?: string;
+    }): Promise<Record<string, unknown>[]>;
+    priceTrend(uuid: string, options?: {
+        provider?: string;
+        finish?: string;
+        priceType?: string;
+    }): Promise<Record<string, unknown> | null>;
+    cheapestPrinting(name: string, options?: {
+        provider?: string;
+        finish?: string;
+        priceType?: string;
+    }): Promise<Record<string, unknown> | null>;
+    cheapestPrintings(options?: {
+        provider?: string;
+        finish?: string;
+        priceType?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    mostExpensivePrintings(options?: {
+        provider?: string;
+        finish?: string;
+        priceType?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+}
+
+declare class LegalityQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    private _cardsByStatus;
+    formatsForCard(uuid: string): Promise<Record<string, string>>;
+    legalIn(formatName: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<CardSet[]>;
+    isLegal(uuid: string, formatName: string): Promise<boolean>;
+    bannedIn(formatName: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    restrictedIn(formatName: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    suspendedIn(formatName: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    notLegalIn(formatName: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+}
+
+declare class IdentifierQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    private _findBy;
+    findBy(idType: string, value: string): Promise<CardSet[]>;
+    findByScryfallId(scryfallId: string): Promise<CardSet[]>;
+    findByScryfallOracleId(oracleId: string): Promise<CardSet[]>;
+    findByScryfallIllustrationId(illustrationId: string): Promise<CardSet[]>;
+    findByTcgplayerId(tcgplayerId: string): Promise<CardSet[]>;
+    findByTcgplayerEtchedId(tcgplayerEtchedId: string): Promise<CardSet[]>;
+    findByMtgoId(mtgoId: string): Promise<CardSet[]>;
+    findByMtgoFoilId(mtgoFoilId: string): Promise<CardSet[]>;
+    findByMtgArenaId(arenaId: string): Promise<CardSet[]>;
+    findByMultiverseId(multiverseId: string): Promise<CardSet[]>;
+    findByMcmId(mcmId: string): Promise<CardSet[]>;
+    findByMcmMetaId(mcmMetaId: string): Promise<CardSet[]>;
+    findByCardKingdomId(ckId: string): Promise<CardSet[]>;
+    findByCardKingdomFoilId(ckFoilId: string): Promise<CardSet[]>;
+    findByCardKingdomEtchedId(ckEtchedId: string): Promise<CardSet[]>;
+    findByCardsphereId(csId: string): Promise<CardSet[]>;
+    findByCardsphereFoilId(csFoilId: string): Promise<CardSet[]>;
+    getIdentifiers(uuid: string): Promise<Record<string, unknown> | null>;
+}
+
+declare class DeckQuery {
+    private _cache;
+    private _data;
+    constructor(cache: CacheManager);
+    private _ensure;
+    list(options?: {
+        setCode?: string;
+        deckType?: string;
+    }): Promise<DeckList[]>;
+    search(options?: {
+        name?: string;
+        setCode?: string;
+    }): Promise<DeckList[]>;
+    count(): Promise<number>;
+}
+
+declare class SealedQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    list(options?: {
+        setCode?: string;
+        category?: string;
+        limit?: number;
+    }): Promise<Record<string, unknown>[]>;
+    get(uuid: string): Promise<Record<string, unknown> | null>;
+}
+
+declare class SkuQuery {
+    private _conn;
+    constructor(conn: Connection);
+    private _ensure;
+    get(uuid: string): Promise<TcgplayerSkus[]>;
+    findBySkuId(skuId: number): Promise<Record<string, unknown> | null>;
+    findByProductId(productId: number): Promise<Record<string, unknown>[]>;
+}
+
+declare class EnumQuery {
+    private _cache;
+    constructor(cache: CacheManager);
+    keywords(): Promise<Keywords>;
+    cardTypes(): Promise<CardTypes>;
+    enumValues(): Promise<Record<string, unknown>>;
+}
+
+interface MtgjsonSDKOptions {
+    cacheDir?: string;
+    offline?: boolean;
+    timeout?: number;
+    onProgress?: ProgressCallback;
+}
+declare class MtgjsonSDK {
+    private _cache;
+    private _conn;
+    private _cards;
+    private _sets;
+    private _prices;
+    private _decks;
+    private _sealed;
+    private _skus;
+    private _identifiers;
+    private _legalities;
+    private _tokens;
+    private _enums;
+    private _booster;
+    private constructor();
+    static create(options?: MtgjsonSDKOptions): Promise<MtgjsonSDK>;
+    get cards(): CardQuery;
+    get sets(): SetQuery;
+    get prices(): PriceQuery;
+    get decks(): DeckQuery;
+    get sealed(): SealedQuery;
+    get skus(): SkuQuery;
+    get identifiers(): IdentifierQuery;
+    get legalities(): LegalityQuery;
+    get tokens(): TokenQuery;
+    get enums(): EnumQuery;
+    get booster(): BoosterSimulator;
+    get meta(): Promise<Record<string, unknown>>;
+    get views(): string[];
+    sql(query: string, params?: unknown[]): Promise<Record<string, unknown>[]>;
+    refresh(): Promise<boolean>;
+    exportDb(path: string): Promise<string>;
+    close(): Promise<void>;
+    /** For `await using sdk = await MtgjsonSDK.create()` */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
+/** SQL builder with parameterized query construction. */
+declare class SQLBuilder {
+    private _select;
+    private _distinct;
+    private _from;
+    private _joins;
+    /** WHERE clauses (public for direct manipulation by query modules). */
+    _where: string[];
+    /** Bound parameter values (public for direct manipulation by query modules). */
+    _params: unknown[];
+    private _groupBy;
+    private _having;
+    private _orderBy;
+    private _limit;
+    private _offset;
+    constructor(baseTable: string);
+    select(...columns: string[]): this;
+    distinct(): this;
+    join(clause: string): this;
+    where(condition: string, ...params: unknown[]): this;
+    whereLike(column: string, value: string): this;
+    whereIn(column: string, values: unknown[]): this;
+    whereEq(column: string, value: unknown): this;
+    whereGte(column: string, value: unknown): this;
+    whereLte(column: string, value: unknown): this;
+    whereRegex(column: string, pattern: string): this;
+    whereFuzzy(column: string, value: string, threshold?: number): this;
+    whereOr(...conditions: [string, unknown][]): this;
+    groupBy(...columns: string[]): this;
+    having(condition: string, ...params: unknown[]): this;
+    orderBy(...clauses: string[]): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    build(): [string, unknown[]];
+}
+
+export { type AllPricesFile, type AllPrintingsFile, type BoosterConfig, type BoosterPack, type BoosterSheet, BoosterSimulator, CacheManager, type CardAtomic, type CardDeck, CardQuery, type CardSet, type CardSetDeck, type CardToken, type CardType, type CardTypes, type CardTypesFile, Connection, type Deck, type DeckList, type DeckListFile, DeckQuery, type DeckSet, EnumQuery, type ForeignData, type ForeignDataIdentifiers, IdentifierQuery, type Identifiers, type Keywords, type KeywordsFile, type LeadershipSkills, type Legalities, LegalityQuery, type Meta, type MtgSet, MtgjsonSDK, type MtgjsonSDKOptions, type PriceFormats, type PriceList, type PricePoints, PriceQuery, type ProgressCallback, type PurchaseUrls, type RelatedCards, type Rulings, SQLBuilder, type SealedProduct, type SealedProductCard, type SealedProductContents, type SealedProductDeck, type SealedProductOther, type SealedProductPack, type SealedProductSealed, SealedQuery, type SetList, type SetListFile, SetQuery, SkuQuery, type SourceProducts, type TcgplayerSkus, type TcgplayerSkusFile, TokenQuery, type Translations };