@cardog/api 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.3.0 (2026-04-03)
+
+### Added
+- `vin.corgiV3(vin)` - High-performance VIN decoding using binary indexes (~3x faster)
+- `vin.batchCorgi(vins)` - Ultra high-throughput batch decoding (~6000 VINs/sec)
+- `vin.batchNano(vins)` - Batch nano lookups for variant data
+- New types: `CorgiV3Result`, `BatchDecodeResponse`
+- Query keys for React Query: `vinKeys.corgiV3`, `vinKeys.batchCorgi`, `vinKeys.batchNano`
+
 ## 0.2.1 (2026-03-31)
 
 ### Fixed

package/dist/index.d.mts

@@ -9,7 +9,7 @@ interface ClientConfig {
 }
 interface RequestOptions {
     headers?: Record<string, string>;
-    params?: Record<string, any>;
+    params?: Record<string, any> | URLSearchParams;
 }
 declare class APIError extends Error {
     status: number;
@@ -34,14 +34,91 @@ declare class BaseClient {
     }): Promise<T>;
 }
 
+/** Corgi v3 decode result */
+interface CorgiV3Result {
+    vin: string;
+    valid: boolean;
+    components: {
+        wmi: string;
+        vds: string;
+        vis: string;
+        modelYear: number;
+        checkDigit: string;
+        serialNumber: string;
+    };
+    vehicle?: {
+        make: string;
+        model: string;
+        year: number;
+        series?: string;
+        trim?: string;
+        bodyType?: string;
+        driveWheelConfiguration?: string;
+        fuelType?: string;
+        vehicleTransmission?: string;
+        numberOfDoors?: number;
+    };
+    engine?: {
+        model?: string;
+        cylinders?: number;
+        displacement?: number;
+        fuelType?: string;
+        power?: number;
+    };
+    plant?: {
+        code: string;
+        country?: string;
+        city?: string;
+        state?: string;
+    };
+    confidence: number;
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+/** Batch decode response */
+interface BatchDecodeResponse {
+    success: boolean;
+    count: number;
+    successful: number;
+    failed: number;
+    processingTime: string;
+    avgTimePerVin: string;
+    results: Array<{
+        vin: string;
+        result?: CorgiV3Result;
+        error?: string;
+    }>;
+}
 declare const vinKeys: {
     readonly all: readonly ["vin"];
     readonly image: (base64: string) => readonly ["vin", "image", string];
     readonly decode: (vin: string) => readonly ["vin", "decode", string];
+    readonly corgiV3: (vin: string) => readonly ["vin", "corgi-v3", string];
+    readonly batchCorgi: (vins: string[]) => readonly ["vin", "batch-corgi", string[]];
+    readonly batchNano: (vins: string[]) => readonly ["vin", "batch-nano", string[]];
 };
 declare class VinAPI extends BaseClient {
     decode(vin: string): Promise<VinDecodeResponse>;
     corgi(vin: string): Promise<Partial<VinCorgiResponse>>;
+    /**
+     * Decode VIN using Corgi v3 binary indexes (high-performance, fully offline)
+     * ~3x faster than v2, no database calls required
+     */
+    corgiV3(vin: string): Promise<CorgiV3Result>;
+    /**
+     * Batch decode VINs using Corgi v3 (up to 1000 VINs, ~6000 VINs/sec)
+     */
+    batchCorgi(vins: string[]): Promise<BatchDecodeResponse>;
+    /**
+     * Batch lookup VINs using nano database
+     */
+    batchNano(vins: string[]): Promise<BatchDecodeResponse>;
     image(base64: string): Promise<VinImageResponse>;
 }
 
@@ -1276,6 +1353,9 @@ declare const queryKeys: {
         readonly all: readonly ["vin"];
         readonly image: (base64: string) => readonly ["vin", "image", string];
         readonly decode: (vin: string) => readonly ["vin", "decode", string];
+        readonly corgiV3: (vin: string) => readonly ["vin", "corgi-v3", string];
+        readonly batchCorgi: (vins: string[]) => readonly ["vin", "batch-corgi", string[]];
+        readonly batchNano: (vins: string[]) => readonly ["vin", "batch-nano", string[]];
     };
     readonly market: {
         readonly all: readonly ["market"];
@@ -1591,4 +1671,4 @@ declare class CardogClient {
     setConfig(config: ClientConfig): void;
 }
 
-export { APIError, CardogClient, ChargingAPI, type ClientConfig, type Complaint, ComplaintsAPI, type ComplaintsResponse, type ComplaintsSearchParams, EfficiencyAPI, type EfficiencyResponse, type EfficiencyStatsResponse, FuelAPI, type FuelSearchParams, type LineupParams, type Listing, ListingsAPI, type ListingsCountResponse, type ListingsFacetsResponse, type ListingsFilters, type ListingsResponse, type ListingsSearchParams, type LocationDetailResponse, LocationsAPI, type LocationsSearchParams, type LocationsSearchResponse, MarketAPI, RecallsAPI, type RequestOptions, ResearchAPI, type Seller, VinAPI, chargingKeys, complaintSchema, complaintsKeys, complaintsResponseSchema, CardogClient as default, efficiencyKeys, efficiencyResponseSchema, efficiencyStatsResponseSchema, fuelKeys, listingsKeys, locationsKeys, marketKeys, queryKeys, recallKeys, researchKeys, vinKeys };
+export { APIError, type BatchDecodeResponse, CardogClient, ChargingAPI, type ClientConfig, type Complaint, ComplaintsAPI, type ComplaintsResponse, type ComplaintsSearchParams, type CorgiV3Result, EfficiencyAPI, type EfficiencyResponse, type EfficiencyStatsResponse, FuelAPI, type FuelSearchParams, type LineupParams, type Listing, ListingsAPI, type ListingsCountResponse, type ListingsFacetsResponse, type ListingsFilters, type ListingsResponse, type ListingsSearchParams, type LocationDetailResponse, LocationsAPI, type LocationsSearchParams, type LocationsSearchResponse, MarketAPI, RecallsAPI, type RequestOptions, ResearchAPI, type Seller, VinAPI, chargingKeys, complaintSchema, complaintsKeys, complaintsResponseSchema, CardogClient as default, efficiencyKeys, efficiencyResponseSchema, efficiencyStatsResponseSchema, fuelKeys, listingsKeys, locationsKeys, marketKeys, queryKeys, recallKeys, researchKeys, vinKeys };

package/dist/index.d.ts

@@ -9,7 +9,7 @@ interface ClientConfig {
 }
 interface RequestOptions {
     headers?: Record<string, string>;
-    params?: Record<string, any>;
+    params?: Record<string, any> | URLSearchParams;
 }
 declare class APIError extends Error {
     status: number;
@@ -34,14 +34,91 @@ declare class BaseClient {
     }): Promise<T>;
 }
 
+/** Corgi v3 decode result */
+interface CorgiV3Result {
+    vin: string;
+    valid: boolean;
+    components: {
+        wmi: string;
+        vds: string;
+        vis: string;
+        modelYear: number;
+        checkDigit: string;
+        serialNumber: string;
+    };
+    vehicle?: {
+        make: string;
+        model: string;
+        year: number;
+        series?: string;
+        trim?: string;
+        bodyType?: string;
+        driveWheelConfiguration?: string;
+        fuelType?: string;
+        vehicleTransmission?: string;
+        numberOfDoors?: number;
+    };
+    engine?: {
+        model?: string;
+        cylinders?: number;
+        displacement?: number;
+        fuelType?: string;
+        power?: number;
+    };
+    plant?: {
+        code: string;
+        country?: string;
+        city?: string;
+        state?: string;
+    };
+    confidence: number;
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+/** Batch decode response */
+interface BatchDecodeResponse {
+    success: boolean;
+    count: number;
+    successful: number;
+    failed: number;
+    processingTime: string;
+    avgTimePerVin: string;
+    results: Array<{
+        vin: string;
+        result?: CorgiV3Result;
+        error?: string;
+    }>;
+}
 declare const vinKeys: {
     readonly all: readonly ["vin"];
     readonly image: (base64: string) => readonly ["vin", "image", string];
     readonly decode: (vin: string) => readonly ["vin", "decode", string];
+    readonly corgiV3: (vin: string) => readonly ["vin", "corgi-v3", string];
+    readonly batchCorgi: (vins: string[]) => readonly ["vin", "batch-corgi", string[]];
+    readonly batchNano: (vins: string[]) => readonly ["vin", "batch-nano", string[]];
 };
 declare class VinAPI extends BaseClient {
     decode(vin: string): Promise<VinDecodeResponse>;
     corgi(vin: string): Promise<Partial<VinCorgiResponse>>;
+    /**
+     * Decode VIN using Corgi v3 binary indexes (high-performance, fully offline)
+     * ~3x faster than v2, no database calls required
+     */
+    corgiV3(vin: string): Promise<CorgiV3Result>;
+    /**
+     * Batch decode VINs using Corgi v3 (up to 1000 VINs, ~6000 VINs/sec)
+     */
+    batchCorgi(vins: string[]): Promise<BatchDecodeResponse>;
+    /**
+     * Batch lookup VINs using nano database
+     */
+    batchNano(vins: string[]): Promise<BatchDecodeResponse>;
     image(base64: string): Promise<VinImageResponse>;
 }
 
@@ -1276,6 +1353,9 @@ declare const queryKeys: {
         readonly all: readonly ["vin"];
         readonly image: (base64: string) => readonly ["vin", "image", string];
         readonly decode: (vin: string) => readonly ["vin", "decode", string];
+        readonly corgiV3: (vin: string) => readonly ["vin", "corgi-v3", string];
+        readonly batchCorgi: (vins: string[]) => readonly ["vin", "batch-corgi", string[]];
+        readonly batchNano: (vins: string[]) => readonly ["vin", "batch-nano", string[]];
     };
     readonly market: {
         readonly all: readonly ["market"];
@@ -1591,4 +1671,4 @@ declare class CardogClient {
     setConfig(config: ClientConfig): void;
 }
 
-export { APIError, CardogClient, ChargingAPI, type ClientConfig, type Complaint, ComplaintsAPI, type ComplaintsResponse, type ComplaintsSearchParams, EfficiencyAPI, type EfficiencyResponse, type EfficiencyStatsResponse, FuelAPI, type FuelSearchParams, type LineupParams, type Listing, ListingsAPI, type ListingsCountResponse, type ListingsFacetsResponse, type ListingsFilters, type ListingsResponse, type ListingsSearchParams, type LocationDetailResponse, LocationsAPI, type LocationsSearchParams, type LocationsSearchResponse, MarketAPI, RecallsAPI, type RequestOptions, ResearchAPI, type Seller, VinAPI, chargingKeys, complaintSchema, complaintsKeys, complaintsResponseSchema, CardogClient as default, efficiencyKeys, efficiencyResponseSchema, efficiencyStatsResponseSchema, fuelKeys, listingsKeys, locationsKeys, marketKeys, queryKeys, recallKeys, researchKeys, vinKeys };
+export { APIError, type BatchDecodeResponse, CardogClient, ChargingAPI, type ClientConfig, type Complaint, ComplaintsAPI, type ComplaintsResponse, type ComplaintsSearchParams, type CorgiV3Result, EfficiencyAPI, type EfficiencyResponse, type EfficiencyStatsResponse, FuelAPI, type FuelSearchParams, type LineupParams, type Listing, ListingsAPI, type ListingsCountResponse, type ListingsFacetsResponse, type ListingsFilters, type ListingsResponse, type ListingsSearchParams, type LocationDetailResponse, LocationsAPI, type LocationsSearchParams, type LocationsSearchResponse, MarketAPI, RecallsAPI, type RequestOptions, ResearchAPI, type Seller, VinAPI, chargingKeys, complaintSchema, complaintsKeys, complaintsResponseSchema, CardogClient as default, efficiencyKeys, efficiencyResponseSchema, efficiencyStatsResponseSchema, fuelKeys, listingsKeys, locationsKeys, marketKeys, queryKeys, recallKeys, researchKeys, vinKeys };

package/dist/index.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var zod = require('zod');
 
 // src/base.ts
-var CLIENT_VERSION = "0.2.1";
+var CLIENT_VERSION = "0.3.0";
 var DEFAULT_BASE_URL = "https://api.cardog.app/v1";
 var APIError = class extends Error {
   constructor(message, status, code, data) {
@@ -38,7 +38,8 @@ var BaseClient = class {
   buildUrl(path, params) {
     const url = new URL(path, this.baseUrl);
     if (params) {
-      for (const [key, value] of Object.entries(params)) {
+      const entries = params instanceof URLSearchParams ? params.entries() : Object.entries(params);
+      for (const [key, value] of entries) {
         if (value !== void 0 && value !== null) {
           url.searchParams.set(key, String(value));
         }
@@ -1651,7 +1652,10 @@ var listingQueryCodec = new ListingQueryCodec();
 var vinKeys = {
   all: ["vin"],
   image: (base64) => [...vinKeys.all, "image", base64],
-  decode: (vin) => [...vinKeys.all, "decode", vin]
+  decode: (vin) => [...vinKeys.all, "decode", vin],
+  corgiV3: (vin) => [...vinKeys.all, "corgi-v3", vin],
+  batchCorgi: (vins) => [...vinKeys.all, "batch-corgi", vins],
+  batchNano: (vins) => [...vinKeys.all, "batch-nano", vins]
 };
 var VinAPI = class extends BaseClient {
   async decode(vin) {
@@ -1662,6 +1666,25 @@ var VinAPI = class extends BaseClient {
     const response = await this.get(`/vin/corgi/${vin}`);
     return response;
   }
+  /**
+   * Decode VIN using Corgi v3 binary indexes (high-performance, fully offline)
+   * ~3x faster than v2, no database calls required
+   */
+  async corgiV3(vin) {
+    return this.get(`/vin/corgi/v3/${vin}`);
+  }
+  /**
+   * Batch decode VINs using Corgi v3 (up to 1000 VINs, ~6000 VINs/sec)
+   */
+  async batchCorgi(vins) {
+    return this.post(`/vin/batch/corgi`, { vins });
+  }
+  /**
+   * Batch lookup VINs using nano database
+   */
+  async batchNano(vins) {
+    return this.post(`/vin/batch/nano`, { vins });
+  }
   async image(base64) {
     const response = await this.post(`/vin/image`, {
       image: base64

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 // src/base.ts
-var CLIENT_VERSION = "0.2.1";
+var CLIENT_VERSION = "0.3.0";
 var DEFAULT_BASE_URL = "https://api.cardog.app/v1";
 var APIError = class extends Error {
   constructor(message, status, code, data) {
@@ -34,7 +34,8 @@ var BaseClient = class {
   buildUrl(path, params) {
     const url = new URL(path, this.baseUrl);
     if (params) {
-      for (const [key, value] of Object.entries(params)) {
+      const entries = params instanceof URLSearchParams ? params.entries() : Object.entries(params);
+      for (const [key, value] of entries) {
         if (value !== void 0 && value !== null) {
           url.searchParams.set(key, String(value));
         }
@@ -1647,7 +1648,10 @@ var listingQueryCodec = new ListingQueryCodec();
 var vinKeys = {
   all: ["vin"],
   image: (base64) => [...vinKeys.all, "image", base64],
-  decode: (vin) => [...vinKeys.all, "decode", vin]
+  decode: (vin) => [...vinKeys.all, "decode", vin],
+  corgiV3: (vin) => [...vinKeys.all, "corgi-v3", vin],
+  batchCorgi: (vins) => [...vinKeys.all, "batch-corgi", vins],
+  batchNano: (vins) => [...vinKeys.all, "batch-nano", vins]
 };
 var VinAPI = class extends BaseClient {
   async decode(vin) {
@@ -1658,6 +1662,25 @@ var VinAPI = class extends BaseClient {
     const response = await this.get(`/vin/corgi/${vin}`);
     return response;
   }
+  /**
+   * Decode VIN using Corgi v3 binary indexes (high-performance, fully offline)
+   * ~3x faster than v2, no database calls required
+   */
+  async corgiV3(vin) {
+    return this.get(`/vin/corgi/v3/${vin}`);
+  }
+  /**
+   * Batch decode VINs using Corgi v3 (up to 1000 VINs, ~6000 VINs/sec)
+   */
+  async batchCorgi(vins) {
+    return this.post(`/vin/batch/corgi`, { vins });
+  }
+  /**
+   * Batch lookup VINs using nano database
+   */
+  async batchNano(vins) {
+    return this.post(`/vin/batch/nano`, { vins });
+  }
   async image(base64) {
     const response = await this.post(`/vin/image`, {
       image: base64

package/dist/react/index.js

@@ -1573,7 +1573,10 @@ createSchemaWithCodec(
 var vinKeys = {
   all: ["vin"],
   image: (base64) => [...vinKeys.all, "image", base64],
-  decode: (vin) => [...vinKeys.all, "decode", vin]
+  decode: (vin) => [...vinKeys.all, "decode", vin],
+  corgiV3: (vin) => [...vinKeys.all, "corgi-v3", vin],
+  batchCorgi: (vins) => [...vinKeys.all, "batch-corgi", vins],
+  batchNano: (vins) => [...vinKeys.all, "batch-nano", vins]
 };
 
 // src/routes/market.ts

package/dist/react/index.mjs

@@ -1571,7 +1571,10 @@ createSchemaWithCodec(
 var vinKeys = {
   all: ["vin"],
   image: (base64) => [...vinKeys.all, "image", base64],
-  decode: (vin) => [...vinKeys.all, "decode", vin]
+  decode: (vin) => [...vinKeys.all, "decode", vin],
+  corgiV3: (vin) => [...vinKeys.all, "corgi-v3", vin],
+  batchCorgi: (vins) => [...vinKeys.all, "batch-corgi", vins],
+  batchNano: (vins) => [...vinKeys.all, "batch-nano", vins]
 };
 
 // src/routes/market.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardog/api",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Official Cardog API client library for vehicle data, market analysis, and VIN decoding",
   "license": "MIT",
   "homepage": "https://docs.cardog.app",
@@ -44,15 +44,6 @@
     "CHANGELOG.md",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "zod": "^3.24.3"
   },
@@ -73,16 +64,24 @@
     }
   },
   "devDependencies": {
-    "@cardog/contracts": "workspace:*",
     "@tanstack/react-query": "^5.0.0",
     "@types/node": "^20.11.24",
     "@types/react": "^18.2.0",
     "react": "^18.2.0",
     "tsup": "^8.0.2",
     "typescript": "^5.3.3",
-    "vitest": "^1.3.1"
+    "vitest": "^1.3.1",
+    "@cardog/contracts": "0.1.0"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   }
-}
+}