@nextad/auction 0.1.2 → 0.1.4

package/dist/index.d.mts

@@ -0,0 +1,50 @@
+import { Bid, BidResponse } from 'iab-openrtb/v26';
+
+interface CurrencyRates {
+    /** ISO 4217 Currency Code (Example: USD, JPY, EUR) */
+    [currency: string]: number;
+}
+interface ConversionRates {
+    /** convert rate of base currency */
+    [baseCurrency: string]: CurrencyRates;
+}
+interface CurrencyConversionData {
+    dataAsOf: string;
+    generatedAt: string;
+    conversions: ConversionRates;
+}
+
+type AuctionType = "open" | "closed";
+type AuctionOptions = {
+    lossProcessing?: boolean;
+    currencyConversionData?: CurrencyConversionData;
+};
+declare class Auction {
+    private losingBids;
+    private bids;
+    private itemIds;
+    private status;
+    private options;
+    private bidInformation;
+    constructor(itemOrImpressionIds: string | string[], options?: AuctionOptions);
+    getStatus(): AuctionType;
+    getLosingBids(): {
+        v26: Bid[];
+    };
+    placeBidResponseV26(bidResponse: BidResponse): this;
+    end(): Bid;
+    private setLosingBids;
+    private handleLossBids;
+    private handleLossBid;
+}
+
+declare class BidNotFoundException {
+    name: string;
+    message: string;
+}
+declare class AlreadyEndedAuctionException {
+    name: string;
+    message: string;
+}
+
+export { AlreadyEndedAuctionException, Auction, BidNotFoundException };

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import { Bid, BidResponse } from 'iab-openrtb/v26';
+
+interface CurrencyRates {
+    /** ISO 4217 Currency Code (Example: USD, JPY, EUR) */
+    [currency: string]: number;
+}
+interface ConversionRates {
+    /** convert rate of base currency */
+    [baseCurrency: string]: CurrencyRates;
+}
+interface CurrencyConversionData {
+    dataAsOf: string;
+    generatedAt: string;
+    conversions: ConversionRates;
+}
+
+type AuctionType = "open" | "closed";
+type AuctionOptions = {
+    lossProcessing?: boolean;
+    currencyConversionData?: CurrencyConversionData;
+};
+declare class Auction {
+    private losingBids;
+    private bids;
+    private itemIds;
+    private status;
+    private options;
+    private bidInformation;
+    constructor(itemOrImpressionIds: string | string[], options?: AuctionOptions);
+    getStatus(): AuctionType;
+    getLosingBids(): {
+        v26: Bid[];
+    };
+    placeBidResponseV26(bidResponse: BidResponse): this;
+    end(): Bid;
+    private setLosingBids;
+    private handleLossBids;
+    private handleLossBid;
+}
+
+declare class BidNotFoundException {
+    name: string;
+    message: string;
+}
+declare class AlreadyEndedAuctionException {
+    name: string;
+    message: string;
+}
+
+export { AlreadyEndedAuctionException, Auction, BidNotFoundException };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var f=(e,i)=>{for(var s in i)u(e,s,{get:i[s],enumerable:!0})},g=(e,i,s,r)=>{if(i&&typeof i=="object"||typeof i=="function")for(let t of l(i))!v.call(e,t)&&t!==s&&u(e,t,{get:()=>i[t],enumerable:!(r=B(i,t))||r.enumerable});return e};var m=e=>g(u({},"__esModule",{value:!0}),e);var y={};f(y,{AlreadyEndedAuctionException:()=>a,Auction:()=>h,BidNotFoundException:()=>n});module.exports=m(y);var d=class{static getHighestBidV26(i,s,r){return r?i.reduce((t,o)=>{let c=this.convertPrice(t,s,r);return this.convertPrice(o,s,r)>c?o:t}):i.reduce((t,o)=>{let c=t.price*100;return o.price*100>c?o:t})}static convertPrice(i,s,r){let t=i.price,o=r.conversions[s.get(i)?.currency||"USD"];if(!o)return t*100;let p=o["USD"];return t*(p||1)*100}};var n=class{name="BidNotFoundException";message="Bid is not found."},a=class{name="AlreadyEndedAuctionException";message="Auction is already ended."};var h=class{losingBids;bids;itemIds=[];status;options;bidInformation;constructor(i,s={}){this.options={lossProcessing:!0,...s},this.bids={v26:[]},this.losingBids={v26:[]},this.status="open",this.bidInformation=new WeakMap,typeof i=="string"?this.itemIds.push(i):this.itemIds.push(...i)}getStatus(){return this.status}getLosingBids(){return this.losingBids}placeBidResponseV26(i){if(i.seatbid){let s=i.seatbid.flatMap(r=>r.bid.map(t=>(this.bidInformation.set(t,{currency:i.cur,version:"2.6",seat:r.seat}),t)));this.bids.v26.push(...s)}return this}end(){if(this.status!=="open")throw new a;if(!this.bids.v26.length)throw new n;let i=d.getHighestBidV26(this.bids.v26,this.bidInformation,this.options.currencyConversionData);return this.setLosingBids(i),this.handleLossBids(),this.status="closed",i}setLosingBids(i){this.losingBids.v26.push(...this.bids.v26.filter(s=>s.id!==i.id))}handleLossBids(){this.losingBids.v26.forEach(i=>{this.handleLossBid(i)})}handleLossBid(i){this.options.lossProcessing&&i.lurl&&fetch(i.lurl,{keepalive:!0})}};0&&(module.exports={AlreadyEndedAuctionException,Auction,BidNotFoundException});

package/dist/index.mjs

@@ -0,0 +1 @@
+var n=class{static getHighestBidV26(i,s,e){return e?i.reduce((t,r)=>{let o=this.convertPrice(t,s,e);return this.convertPrice(r,s,e)>o?r:t}):i.reduce((t,r)=>{let o=t.price*100;return r.price*100>o?r:t})}static convertPrice(i,s,e){let t=i.price,r=e.conversions[s.get(i)?.currency||"USD"];if(!r)return t*100;let p=r["USD"];return t*(p||1)*100}};var a=class{name="BidNotFoundException";message="Bid is not found."},c=class{name="AlreadyEndedAuctionException";message="Auction is already ended."};var u=class{losingBids;bids;itemIds=[];status;options;bidInformation;constructor(i,s={}){this.options={lossProcessing:!0,...s},this.bids={v26:[]},this.losingBids={v26:[]},this.status="open",this.bidInformation=new WeakMap,typeof i=="string"?this.itemIds.push(i):this.itemIds.push(...i)}getStatus(){return this.status}getLosingBids(){return this.losingBids}placeBidResponseV26(i){if(i.seatbid){let s=i.seatbid.flatMap(e=>e.bid.map(t=>(this.bidInformation.set(t,{currency:i.cur,version:"2.6",seat:e.seat}),t)));this.bids.v26.push(...s)}return this}end(){if(this.status!=="open")throw new c;if(!this.bids.v26.length)throw new a;let i=n.getHighestBidV26(this.bids.v26,this.bidInformation,this.options.currencyConversionData);return this.setLosingBids(i),this.handleLossBids(),this.status="closed",i}setLosingBids(i){this.losingBids.v26.push(...this.bids.v26.filter(s=>s.id!==i.id))}handleLossBids(){this.losingBids.v26.forEach(i=>{this.handleLossBid(i)})}handleLossBid(i){this.options.lossProcessing&&i.lurl&&fetch(i.lurl,{keepalive:!0})}};export{c as AlreadyEndedAuctionException,u as Auction,a as BidNotFoundException};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextad/auction",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "",
   "keywords": [],
   "author": "Kai Miyamoto",
@@ -25,6 +25,11 @@
     "import": "./dist/index.mjs",
     "require": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "test": "vitest",
     "build": "tsup"

package/src/Auction.ts

@@ -1,109 +0,0 @@
-import { BidComparator } from "./BidComparator";
-import { BidFactory } from "./BidFactory";
-import {
-  AlreadyEndedAuctionException,
-  BidNotFoundException,
-} from "./exceptions";
-import type { BaseBidResponseV26, BidV26, CurrencyConversionData } from "./types";
-
-type AuctionType = "open" | "closed";
-
-type AuctionOptions = {
-  lossProcessing?: boolean;
-  currencyConversionData?: CurrencyConversionData;
-};
-
-export class Auction {
-  private losingBids: {
-    v26: BidV26[];
-  };
-  private bids: {
-    v26: BidV26[];
-  };
-
-  private itemIds: string[] = [];
-  private currencyConversionData?: CurrencyConversionData;
-  private status: AuctionType;
-  private options: AuctionOptions;
-
-  public constructor(
-    itemOrImpressionIds: string | string[],
-    options: AuctionOptions = {}
-  ) {
-    this.options = {
-      lossProcessing: true,
-      ...options,
-    };
-
-    this.bids = {
-      v26: [],
-    };
-    this.losingBids = {
-      v26: [],
-    };
-    this.currencyConversionData = options.currencyConversionData;
-    this.status = "open";
-
-    if (typeof itemOrImpressionIds === "string") {
-      this.itemIds.push(itemOrImpressionIds);
-    } else {
-      this.itemIds.push(...itemOrImpressionIds);
-    }
-  }
-
-  public getStatus(): AuctionType {
-    return this.status;
-  }
-
-  public getLosingBids(): { v26: BidV26[] } {
-    return this.losingBids;
-  }
-
-  public placeBidResponseV26(bidResponse: BaseBidResponseV26): this {
-    if (bidResponse.seatbid) {
-      this.bids.v26.push(
-        ...BidFactory.createV26Bids(bidResponse, this.itemIds)
-      );
-    }
-
-    return this;
-  }
-
-  public end(): BidV26 {
-    if (this.status !== "open") {
-      throw new AlreadyEndedAuctionException();
-    }
-
-    if (!this.bids.v26.length) {
-      throw new BidNotFoundException();
-    }
-
-    const highestBid = BidComparator.getHighestBidV26(this.bids.v26, this.options.currencyConversionData);
-
-    this.setLosingBids(highestBid);
-    this.handleLossBids();
-    this.status = "closed";
-
-    return highestBid;
-  }
-
-  private setLosingBids(winningBid: BidV26): void {
-    this.losingBids.v26.push(
-      ...this.bids.v26.filter((bid) => bid.id !== winningBid.id)
-    );
-  }
-
-  private handleLossBids(): void {
-    this.losingBids.v26.forEach((bid) => {
-      this.handleLossBid(bid);
-    });
-  }
-
-  private handleLossBid(bid: BidV26): void {
-    if (this.options.lossProcessing && bid.lurl) {
-      fetch(bid.lurl, {
-        keepalive: true,
-      });
-    }
-  }
-}

package/src/BidComparator.ts

@@ -1,38 +0,0 @@
-import type { BidV26, CurrencyConversionData } from "./types";
-
-export class BidComparator {
-  public static getHighestBidV26(
-    bids: BidV26[],
-    currencyConversionData?: CurrencyConversionData
-  ): BidV26 {
-    if (!currencyConversionData) {
-      return bids.reduce((highest, current) => {
-        const highestPrice = highest.price * 100;
-        const currentPrice = current.price * 100;
-        return currentPrice > highestPrice ? current : highest;
-      });
-    }
-
-    return bids.reduce((highest, current) => {
-      const highestPrice = this.convertPrice(highest, currencyConversionData);
-      const currentPrice = this.convertPrice(current, currencyConversionData);
-      return currentPrice > highestPrice ? current : highest;
-    });
-  }
-
-  private static convertPrice(
-    bid: BidV26, 
-    conversionData: CurrencyConversionData
-  ): number {
-    const price = bid.price;
-    const rates = conversionData.conversions[bid.ext.nextadjs.currency];
-    
-    if (!rates) {
-      return price * 100;
-    }
-
-    const targetCurrency = "USD";
-    const rate = rates[targetCurrency];
-    return price * (rate || 1) * 100;
-  }
-}

package/src/BidFactory.ts

@@ -1,32 +0,0 @@
-import type { BaseBidResponseV26, BidV26 } from "./types";
-
-export class BidFactory {
-  public static createV26Bids(
-    bidResponse: BaseBidResponseV26,
-    itemIds: string[]
-  ): BidV26[] {
-    let bids: BidV26[] = [];
-
-    if (bidResponse.seatbid) {
-      bidResponse.seatbid.forEach((seatBid) => {
-        seatBid.bid.forEach((bid) => {
-          if (itemIds.some((itemId) => bid.impid === itemId)) {
-            bids.push({
-              ...bid,
-              ext: {
-                ...bid.ext,
-                nextadjs: {
-                  openrtbVersion: "2.6",
-                  currency: bidResponse.cur || "USD",
-                  seat: seatBid.seat,
-                },
-              },
-            });
-          }
-        });
-      });
-    }
-
-    return bids;
-  }
-}

package/src/exceptions/index.ts

@@ -1,9 +0,0 @@
-export class BidNotFoundException {
-  name = "BidNotFoundException";
-  message = "Bid is not found.";
-}
-
-export class AlreadyEndedAuctionException {
-    name = "AlreadyEndedAuctionException";
-    message = "Auction is already ended.";
-}

package/src/index.ts

@@ -1,2 +0,0 @@
-export * from './Auction';
-export * from '@/exceptions';

package/src/types/index.ts

@@ -1,43 +0,0 @@
-import type {
-  Bid as BaseBidV26,
-  BidResponse as BaseBidResponseV26,
-  SeatBid as BaseSeatBidV26,
-} from "iab-openrtb/v26";
-export type {
-  BidResponse as BaseBidResponseV26,
-  Bid as BaseBidV26,
-} from "iab-openrtb/v26";
-
-export interface BidResponseV26 extends BaseBidResponseV26 {
-  seatbid?: SeatBidV26[];
-}
-export interface SeatBidV26 extends BaseSeatBidV26 {
-  bid: BidV26[];
-}
-
-export interface BidV26 extends BaseBidV26 {
-  ext: {
-    nextadjs: {
-      openrtbVersion: "2.6";
-      seat?: string;
-      currency: string;
-    };
-  };
-}
-
-
-export interface CurrencyRates {
-  /** ISO 4217 Currency Code (Example: USD, JPY, EUR) */
-  [currency: string]: number;
-}
-
-interface ConversionRates {
-  /** convert rate of base currency */
-  [baseCurrency: string]: CurrencyRates;
-}
-
-export interface CurrencyConversionData {
-  dataAsOf: string;
-  generatedAt: string;
-  conversions: ConversionRates;
-}

package/test/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../tsconfig.json",
-  "compilerOptions": {
-    "moduleResolution": "bundler",
-    "types": ["vitest/globals"],
-    "baseUrl": "..",
-    "paths": {
-      "@/*": ["src/*"]
-    }
-  },
-  "include": ["./**/*.ts"]
-}

package/test/units/Auction.test.ts

@@ -1,176 +0,0 @@
-import { openrtbFaker } from "@nextad/faker";
-import { Auction } from "@/Auction";
-import {
-  AlreadyEndedAuctionException,
-  BidNotFoundException,
-} from "@/exceptions";
-
-describe("Auction", () => {
-  it("returns highest bid from bids with specified item(impression) when auction ends", () => {
-    const sut = new Auction("impid-1");
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .addBannerBid({ impid: "impid-1", price: 10 })
-      .make();
-    const bidResponse2 = openrtbFaker.v26.bidResponse
-      .addBannerBid({ impid: "impid-1", price: 20 })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-    sut.placeBidResponseV26(bidResponse2);
-
-    const result = sut.end();
-
-    expect(result.id).toBe(bidResponse2.seatbid![0].bid[0].id);
-  });
-
-  it("returns highest bid from bids with specified items(impressions) when auction ends", () => {
-    const sut = new Auction(["impid-1", "impid-2"]);
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .addBannerBid({ impid: "impid-1", price: 10 })
-      .make();
-    const bidResponse2 = openrtbFaker.v26.bidResponse
-      .addBannerBid({ impid: "impid-1", price: 20 })
-      .addVideoBid({ impid: "impid-2", price: 30 })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-    sut.placeBidResponseV26(bidResponse2);
-
-    const result = sut.end();
-
-    expect(result.id).toBe(bidResponse2.seatbid![0].bid[1].id);
-  });
-
-  it("returns highest bid considering currency when auction ends", () => {
-    const sut = new Auction("impid-1", {
-      currencyConversionData: {
-        dataAsOf: "2021-01-01",
-        generatedAt: "2021-01-01",
-        conversions: {
-          JPY: {
-            USD: 0.09,
-          },
-        },
-      },
-    });
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .withCurrency("JPY")
-      .addBannerBid({ impid: "impid-1", price: 10 })
-      .make();
-    const bidResponse2 = openrtbFaker.v26.bidResponse
-      .withCurrency("USD")
-      .addBannerBid({ impid: "impid-1", price: 5 })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-    sut.placeBidResponseV26(bidResponse2);
-
-    const result = sut.end();
-
-    expect(result.id).toBe(bidResponse2.seatbid![0].bid[0].id);
-  });
-
-  it("throws error when attempting to end auction without bids", () => {
-    const sut = new Auction("impid-1");
-
-    expect(() => sut.end()).toThrow(BidNotFoundException);
-  });
-  it("returns losing bids when auction ends", () => {
-    const sut = new Auction(["impid-1", "impid-2"]);
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .addBannerBid({
-        impid: "impid-1",
-        price: 10,
-      })
-      .addBannerBid({
-        impid: "impid-2",
-        price: 20,
-      })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-
-    sut.end();
-
-    const losingBids = sut.getLosingBids();
-    expect(losingBids.v26.length).toBe(1);
-    expect(losingBids.v26[0].id).toBe(bidResponse.seatbid![0].bid[0].id);
-  });
-
-  it("throws error when attempting to already ended auction", () => {
-    const sut = new Auction("impid-1");
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .addBannerBid({ impid: "impid-1", price: 10 })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-    sut.end();
-
-    expect(() => sut.end()).toThrow(AlreadyEndedAuctionException);
-  });
-
-  it("sends loss notification when bid contains loss notice url", () => {
-    const fetchMock = vi.fn();
-    vi.stubGlobal("fetch", fetchMock);
-    const sut = new Auction(["impid-1", "impid-2"]);
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .addBannerBid({
-        impid: "impid-1",
-        price: 10,
-        lurl: "https://example.com/lurl",
-      })
-      .addBannerBid({
-        impid: "impid-2",
-        price: 20,
-      })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-
-    sut.end();
-
-    expect(fetchMock).toHaveBeenCalledOnce();
-    expect(fetchMock).toHaveBeenCalledWith("https://example.com/lurl", {
-      keepalive: true,
-    });
-  });
-
-  it("does not send loss notification when bid does not contain loss notice url", () => {
-    const fetchMock = vi.fn();
-    vi.stubGlobal("fetch", fetchMock);
-    const sut = new Auction(["impid-1", "impid-2"]);
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .addBannerBid({
-        impid: "impid-1",
-        price: 10,
-      })
-      .addBannerBid({
-        impid: "impid-2",
-        price: 20,
-      })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-
-    sut.end();
-
-    expect(fetchMock).not.toHaveBeenCalled();
-  });
-
-  it("does not send loss notification when loss processing is specified as false", () => {
-    const fetchMock = vi.fn();
-    vi.stubGlobal("fetch", fetchMock);
-    const sut = new Auction(["impid-1", "impid-2"], {
-      lossProcessing: false,
-    });
-    const bidResponse = openrtbFaker.v26.bidResponse
-      .addBannerBid({
-        impid: "impid-1",
-        price: 10,
-        lurl: "https://example.com/lurl",
-      })
-      .addBannerBid({
-        impid: "impid-2",
-        price: 20,
-      })
-      .make();
-    sut.placeBidResponseV26(bidResponse);
-
-    sut.end();
-
-    expect(fetchMock).not.toHaveBeenCalled();
-  });
-});

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es2022",
-    "lib": ["es2022", "esnext.disposable", "dom"],
-
-    "module": "ESNext",
-    "moduleDetection": "force",
-    "allowJs": true,
-
-    "moduleResolution": "Bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true,
-    "preserveConstEnums": true,
-    "noEmit": true,
-
-    "skipLibCheck": true,
-    "strict": true,
-    "noFallthroughCasesInSwitch": true,
-    "forceConsistentCasingInFileNames": true,
-
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"]
-    }
-  },
-  "include": ["**/*.ts"],
-  "exclude": ["node_modules"]
-}

package/tsup.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  format: ["esm", "cjs"],
-  clean: true,
-  minify: true,
-  dts: true,
-  entry: ["src/index.ts"],
-});

package/vitest.config.ts

@@ -1,14 +0,0 @@
-import { fileURLToPath } from "node:url";
-import path from "node:path";
-import { defineConfig } from "vitest/config";
-
-const __dirname = fileURLToPath(new URL(".", import.meta.url));
-
-export default defineConfig({
-  test: {
-    globals: true,
-    alias: {
-      "@": path.resolve(__dirname, "src"),
-    },
-  },
-});