@surfside/ads-core-client 0.1.0 → 0.1.1

package/README.md

@@ -1,15 +1,15 @@
-# @surfside/ads-core-client
-
-To install dependencies:
-
-```bash
-bun install
-```
-
-To run:
-
-```bash
-bun run src/index.ts
-```
-
-This project was created using `bun init` in bun v1.2.10. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+# @surfside/ads-core-client
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run src/index.ts
+```
+
+This project was created using `bun init` in bun v1.2.10. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.

package/lib/cjs/helpers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./response"), exports);
+//# sourceMappingURL=index.js.map

package/lib/cjs/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B"}

package/lib/cjs/helpers/response/Banner.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingProductInfoError = exports.getProductInfoFromDivTag = exports.BuildBannerResponse = void 0;
+const ads_core_1 = require("@surfside/ads-core");
+const BuildBannerResponse = (logger, windowInfo, config, bid) => {
+    const log = (0, ads_core_1.Ctx)(logger)?.with('BuildBannerResponse');
+    log?.info('Building banner response');
+    log?.debug(bid);
+    const adm = bid?.adm;
+    if (adm === undefined || adm === null) {
+        return (0, ads_core_1.Err)(new ads_core_1.MissingAdmError(bid ?? null));
+    }
+    const parser = new DOMParser();
+    const admDoc = parser.parseFromString(adm, 'text/html');
+    const dataTag = admDoc.getElementById('surf-product-info');
+    admDoc.childNodes.forEach(child => log?.debug(child.outerHTML));
+    const productData = (0, exports.getProductInfoFromDivTag)(log, dataTag, bid);
+    const clickthrough = buildBidderClickCallback(log, windowInfo, config, (0, ads_core_1.GetValue)(productData), admDoc);
+    if (!clickthrough.ok) {
+        log?.error('Failed to build banner', clickthrough.error);
+        return clickthrough;
+    }
+    const serializer = new XMLSerializer();
+    const html = serializer.serializeToString(admDoc);
+    return (0, ads_core_1.Ok)({
+        type: 'banner',
+        adm: html,
+        clickthrough: clickthrough.value,
+        bid
+    });
+};
+exports.BuildBannerResponse = BuildBannerResponse;
+const buildBidderClickCallback = (logger, windowInfo, configuration, productData, document) => {
+    const log = (0, ads_core_1.Ctx)(logger)?.with('buildBidderClickCallback');
+    log?.info('Building bidder click callback');
+    const bidderClickCallbackUrlAnchors = document.querySelectorAll('a[href*=\\{SURF_COMMERCE_URL\\}]');
+    if (bidderClickCallbackUrlAnchors.length > 0) {
+        if (productData === undefined) {
+            log?.error('The banner had {SURF_COMMERCE_URL} in its clickthrough link, so it is expecting a rendered ' +
+                'clickthrough URL, but there was no product info provided. Therefore, the banner cannot be rendered, ' +
+                'or else it might redirect to an invalid page');
+            return (0, ads_core_1.Err)(new MissingProductInfoError);
+        }
+        const clickthrough = (0, ads_core_1.BuildClickthroughUrl)(log, windowInfo, configuration, productData // destructure in case it's undefined. ProductInfo has no required fields
+        );
+        if (clickthrough.ok === false) {
+            log?.error('The banner had {SURF_COMMERCE_URL} in its clickthrough link, so it is expecting a rendered ' +
+                'clickthrough URL, but the clickthrough failed to render. Therefore, the banner cannot be rendered, ' +
+                'or else it might redirect to an invalid page', clickthrough.error);
+            return clickthrough; // Error Result
+        }
+        bidderClickCallbackUrlAnchors.forEach(a => {
+            const href = a.getAttribute('href');
+            if (href === null) {
+                return;
+            }
+            const finalClick = href.replace('{SURF_COMMERCE_URL}', clickthrough.value);
+            a.setAttribute('href', finalClick);
+        });
+        return (0, ads_core_1.Ok)(clickthrough.value);
+    }
+    return (0, ads_core_1.Ok)(undefined);
+};
+const getProductInfoFromDivTag = (logger, div, bid) => {
+    const log = (0, ads_core_1.Ctx)(logger)?.with('getProductInfoFromDivTag');
+    log?.info('Getting product info for banner');
+    if (div === null) {
+        log?.warn('No product data for banner in div tag');
+        return (0, ads_core_1.Err)(new MissingProductInfoError);
+    }
+    const { image, price, saleprice, thc, strain, cbd, name, brandname, producttype, details, cta, clickthroughurl, winurl, pixelurl, } = div.dataset;
+    log?.debug('Brand Name:' + brandname + '\nProduct Type' + producttype);
+    if (brandname === undefined) {
+        log?.warn('Missing brand name field in banner creative. The brand name was probably not set on the banner. ' +
+            'Technically, this isn\'t an *error*, but almost all banner creatives rely on brand info, so the ' +
+            'banner probably isn\'t working. CHECK THE CREATIVE. Banner ID is: ' + bid.crid);
+    }
+    const productData = {
+        image,
+        price,
+        salePrice: saleprice,
+        thc,
+        strain,
+        cbd,
+        name,
+        brand_name: brandname,
+        brandName: brandname,
+        productType: producttype,
+        details,
+        cta,
+        clickthroughUrl: clickthroughurl,
+        winurl,
+        pixelurl
+    };
+    if (Object.keys(productData).length === 0) {
+        return (0, ads_core_1.Err)(new MissingProductInfoError());
+    }
+    return (0, ads_core_1.Ok)(productData);
+};
+exports.getProductInfoFromDivTag = getProductInfoFromDivTag;
+class MissingProductInfoError extends Error {
+    constructor() {
+        super('Missing product info in banner');
+    }
+}
+exports.MissingProductInfoError = MissingProductInfoError;
+//# sourceMappingURL=Banner.js.map

package/lib/cjs/helpers/response/Banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Banner.js","sourceRoot":"src/","sources":["helpers/response/Banner.ts"],"names":[],"mappings":"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"}

package/lib/cjs/helpers/response/BuildAll.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateAllResponses = exports.BuildAllResponses = void 0;
+const ads_core_1 = require("@surfside/ads-core");
+const BuildAllResponses = async (logger, buildBannerResponse, buildVideoResponse, buildAllProductCardResponses, request, response) => {
+    const log = (0, ads_core_1.Ctx)(logger)?.with('BuildAllResponses');
+    log?.info('Building all bid responses');
+    log?.debug(request, response);
+    const bannerRequestIds = request.imp.filter(imp => imp.banner !== undefined).map(imp => imp.id);
+    const videoRequestIds = request.imp.filter(imp => imp.video !== undefined).map(imp => imp.id);
+    const nativeRequestIds = request.imp.filter(imp => imp.native !== undefined).map(imp => imp.id);
+    log?.debug(bannerRequestIds, videoRequestIds, nativeRequestIds);
+    const bannerBids = response.seatbid?.[0]?.bid.filter(bid => bannerRequestIds.includes(bid.impid)) ?? [];
+    const videoBids = response.seatbid?.[0]?.bid.filter(bid => videoRequestIds.includes(bid.impid)) ?? [];
+    const nativeBids = response.seatbid?.[0]?.bid.filter(bid => nativeRequestIds.includes(bid.impid)) ?? [];
+    log?.debug(bannerBids, videoBids, nativeBids);
+    return (0, ads_core_1.Ok)({
+        banners: (0, ads_core_1.ValueOr)((0, ads_core_1.AllOrNone)(bannerBids.map(buildBannerResponse)), []),
+        videos: (0, ads_core_1.ValueOr)((0, ads_core_1.AllOrNone)(videoBids.map(buildVideoResponse)), []),
+        productCards: (0, ads_core_1.ValueOr)(await buildAllProductCardResponses(nativeBids), [])
+    });
+};
+exports.BuildAllResponses = BuildAllResponses;
+const GenerateAllResponses = async (logger, buildBannerResponse, buildVideoResponse, buildProductCard, request, response) => {
+    const log = (0, ads_core_1.Ctx)(logger)?.with('GenerateAllResponses');
+    log?.info('Generating all responses');
+    log?.debug(request, response);
+    const bannerRequestIds = request.imp.filter(imp => imp.banner !== undefined).map(imp => imp.id);
+    const videoRequestIds = request.imp.filter(imp => imp.video !== undefined).map(imp => imp.id);
+    const nativeRequestIds = request.imp.filter(imp => imp.native !== undefined).map(imp => imp.id);
+    log?.debug(bannerRequestIds, videoRequestIds, nativeRequestIds);
+    const bannerBids = response.seatbid?.[0]?.bid.filter(bid => bannerRequestIds.includes(bid.impid)) ?? [];
+    const videoBids = response.seatbid?.[0]?.bid.filter(bid => videoRequestIds.includes(bid.impid)) ?? [];
+    const nativeBids = response.seatbid?.[0]?.bid.filter(bid => nativeRequestIds.includes(bid.impid)) ?? [];
+    log?.debug(bannerBids, videoBids, nativeBids);
+    return (0, ads_core_1.Ok)({
+        banners: (0, ads_core_1.ValueOr)((0, ads_core_1.AllOrNone)(bannerBids.map(buildBannerResponse)), []),
+        videos: (0, ads_core_1.ValueOr)((0, ads_core_1.AllOrNone)(videoBids.map(buildVideoResponse)), []),
+        productCards: (0, ads_core_1.GetValue)(await buildProductCard(nativeBids))
+    });
+};
+exports.GenerateAllResponses = GenerateAllResponses;
+//# sourceMappingURL=BuildAll.js.map

package/lib/cjs/helpers/response/BuildAll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildAll.js","sourceRoot":"src/","sources":["helpers/response/BuildAll.ts"],"names":[],"mappings":"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"}

package/lib/cjs/helpers/response/Dynamic.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoDynamicAdsAvailableError = exports.BuildDynamicResponse = void 0;
+const ads_core_1 = require("@surfside/ads-core");
+const BuildDynamicResponse = async (logger, requestBids, buildBannerResponse, buildVideoResponse, buildHybridCarousel, buildSponsoredCarousel, buildRecommendedCarousel, buildAllSponsoredProductCardResponses, dynamicRequest) => {
+    const log = (0, ads_core_1.Ctx)(logger)?.with('BuildDynamicResponse');
+    log?.info('Building dynamic response');
+    log?.debug(dynamicRequest);
+    const bidderResult = await requestBids(dynamicRequest.request);
+    if (!bidderResult.ok) {
+        return bidderResult;
+    }
+    const bids = bidderResult.value.seatbid?.[0]?.bid;
+    log?.debug('bids', bids);
+    if (bids === undefined) {
+        return (0, ads_core_1.Err)(new ads_core_1.MissingBidsError);
+    }
+    for (const id in dynamicRequest.requestIds) {
+        const creative = dynamicRequest.requestIds[id];
+        const bid = bids.filter(bid => bid.impid === id)[0];
+        if (bid === undefined) {
+            log?.debug('No bid for id', id);
+            continue;
+        }
+        const builtCreative = (0, ads_core_1.GetValue)(await (0, ads_core_1.TryDoAsync)(async () => {
+            switch (creative.type) {
+                case 'Banner': {
+                    return {
+                        ...(0, ads_core_1.GetValueOrThrow)(buildBannerResponse(bid)),
+                        dynamicBannerRequest: creative
+                    };
+                }
+                case 'Video': {
+                    return {
+                        ...(0, ads_core_1.GetValueOrThrow)(buildVideoResponse(bid)),
+                        dynamicVideoRequest: creative
+                    };
+                }
+                case 'Carousel': {
+                    const carousel = creative;
+                    switch (carousel.strategy) {
+                        case 'hybrid': {
+                            const hybrid = (0, ads_core_1.GetValueOrThrow)(buildHybridCarousel({
+                                type: carousel.recommendation ?? 'top-products'
+                            }, dynamicRequest.request, bid));
+                            const generator = hybrid.getProduct();
+                            const [product] = await (0, ads_core_1.ConsumeNAsync)(generator, 1);
+                            if (product.length === 1) {
+                                // Success!
+                                return {
+                                    type: 'carousel',
+                                    getProduct: async function* wrappedGenerator() {
+                                        yield product[0];
+                                        yield* generator;
+                                    },
+                                    bid,
+                                    dynamicCarouselRequest: carousel
+                                };
+                            }
+                            throw new Error('No inventory in carousel. Skipping');
+                        }
+                        case 'recommended': {
+                            return {
+                                ...(0, ads_core_1.GetValueOrThrow)(buildRecommendedCarousel({
+                                    type: carousel.recommendation ?? 'top-products'
+                                })),
+                                dynamicCarouselRequest: carousel
+                            };
+                        }
+                        case 'sponsored': {
+                            const sponsored = (0, ads_core_1.GetValueOrThrow)(buildSponsoredCarousel(dynamicRequest.request, bid));
+                            const generator = sponsored.getProduct();
+                            const [product] = await (0, ads_core_1.ConsumeNAsync)(generator, 1);
+                            if (product.length === 1) {
+                                // Success!
+                                return {
+                                    type: 'carousel',
+                                    getProduct: async function* wrappedGenerator() {
+                                        yield product[0];
+                                        yield* generator;
+                                    },
+                                    bid,
+                                    dynamicCarouselRequest: carousel
+                                };
+                            }
+                            throw new Error('No inventory in carousel. Skipping');
+                        }
+                    }
+                    throw new Error('Malformed carousel configuration. Skipping');
+                }
+                case 'ProductCard': {
+                    const value = (0, ads_core_1.GetValueOrThrow)(await buildAllSponsoredProductCardResponses([bid]));
+                    if (value.length === 0) {
+                        throw new Error('No inventory for product card');
+                    }
+                    return {
+                        ...value[0],
+                        dynamicProductCardRequest: creative
+                    };
+                }
+            }
+            throw new Error('Malformed creative. Skipping');
+        }));
+        if (builtCreative === undefined) {
+            log?.debug('No inventory or error on creative. Skipping');
+            continue;
+        }
+        return (0, ads_core_1.Ok)(builtCreative);
+    }
+    return (0, ads_core_1.Err)(new NoDynamicAdsAvailableError(dynamicRequest));
+};
+exports.BuildDynamicResponse = BuildDynamicResponse;
+class NoDynamicAdsAvailableError extends Error {
+    dynamicRequest;
+    constructor(dynamicRequest) {
+        super('No dynamic ads available');
+        this.dynamicRequest = dynamicRequest;
+    }
+}
+exports.NoDynamicAdsAvailableError = NoDynamicAdsAvailableError;
+;
+//# sourceMappingURL=Dynamic.js.map

package/lib/cjs/helpers/response/Dynamic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dynamic.js","sourceRoot":"src/","sources":["helpers/response/Dynamic.ts"],"names":[],"mappings":"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"}