@surfside/ads-core 1.0.6 → 2.0.2

package/README.md

@@ -1,64 +1,15 @@
-# Surfside Ads Core
-
-Surfside Ads Core is a headless SDK designed to seamlessly integrate ad-serving capabilities into your web applications. Unlike Surfside Ads, this SDK focuses solely on the backend processes related to advertising, without including any code for rendering banners, videos, or products on the frontend. It gives you complete control over how ads are displayed while handling the communication with Surfside's ad-serving and data services.
-
-## Key Features
-* **Ad Requests**: Fetch relevant ads for your users by sending requests to Surfside's ad services.
-* **Product Information**: Retrieve detailed information on products linked to ads.
-* **Logging & Event Tracking**: Integrate with built-in services to log important events and track user interactions, ensuring you're capturing engagement metrics.
-* **Enhanced Data Requests**: Use additional services for IP-geolocation, user identification, and cookie management to enrich your ad targeting capabilities.
-
-## Usage
-Surfside Ads Core exposes a set of service classes for communicating with Surfside's backend services. For example, to send a bid request to the Surfside bidder, instantiate a SurfsideBidder and send an [OpenRTB 2.6](https://iabtechlab.com/blog/openrtb-2-6-is-ready-for-implementation/) bid request:
-
-```ts
-const bidder = new SurfsideBidder;
-const response = await bidder.requestBids(new BannerRequest(800, 600, 'abcdefg'));
-/* Bid responses can contain multiple bids */
-document.querySelector('#my-ad').innerHTML = response.seatbid[0].bids[0].adm;
-```
-
-SurfsideBidder will automatically look up Geo information, User ID information, and surfside Context (account ID, location ID, etc) from the Surfside Digital SDK and append it to the bid request. The `adm` field contains all the HTML required for a renderable ad creative, including tracking pixels.
-
-More complicated requests can be built using the Request builder:
-
-```ts
-const response = await bidder.requestBids((new RequestBuilder)
-    .addBanner(800, 600, 'abcdefg')
-    .addBanner(728, 90, '123456', { /* Add multiple banners to the request */
-        keywords: ['Auto parts'],   /* Optional keywords for targeting */
-        bcat: [AdProduct2.Gambling] /* Other OpenRTB fields, like blocked categories */
-    })
-    .build());
-```
-
-The bidder also supports native ads requests:
-
-```ts
-const response = await bidder.requestBid(
-    new NativeRequest()  /* Default native request includes all default OpenRTB asset fields,
-                          * such as title and image */
-);
-```
-
-Which can be customized as well:
-
-```ts
-const response = await bidder.requestBid(
-    (new RequestBuilder)
-        .addNative(
-            (new NativeBuilder)
-                .withTitle(120, true)         /* Optional "length" and "required" fields */
-                .withDescription(300, false)
-                .withImage(
-                    200, 200,                 /* Width, Height */
-                    64, 64                    /* min width, min height */
-                )
-                .build()
-        )
-    )
-    .build()
-);
-
-console.log(JSON.parse(response.seatbid[0].bid[0].adm)); /* Adm for a native response is JSON */
-```
+# @surfside/ads-core
+
+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/Api.js

@@ -0,0 +1,195 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotABrowserError = exports.MissingConfigurationError = exports.InitSurfAdsCore = exports.InitSurfAdsCoreSSR = exports.InitSurfAdsCoreServices = exports.PROD_DYNAMIC_ZONE_SERVICE = exports.PROD_RECOMMENDER_SERVICE = exports.PROD_RECOMMENDED_PRODUCT_FEED = exports.PROD_SPONSORED_PRODUCT_FEED = exports.PROD_CONFIGURATION_SERVICE = exports.PROD_BIDDER = void 0;
+exports.InitSurfAdsCoreInternal = InitSurfAdsCoreInternal;
+const services_1 = require("./services");
+const helpers_1 = require("./helpers");
+const runtime_1 = __importDefault(require("handlebars/runtime"));
+const Carousel_1 = require("./helpers/response/Carousel");
+const Window_1 = require("./helpers/Window");
+const Template_1 = require("./services/Template");
+const Dynamic_1 = require("./services/Dynamic");
+exports.PROD_BIDDER = '//bid.surfside.io/rtb/bids/surfside';
+exports.PROD_CONFIGURATION_SERVICE = '//r.surfside.io';
+exports.PROD_SPONSORED_PRODUCT_FEED = '//creative.surfside.io';
+exports.PROD_RECOMMENDED_PRODUCT_FEED = '//creative.surfside.io';
+exports.PROD_RECOMMENDER_SERVICE = '//t.surfside.io';
+exports.PROD_DYNAMIC_ZONE_SERVICE = '//r.surfside.io/';
+const TLS = (url) => 'http:' + url;
+/**
+ * Initializes the API with the services explicitly passed to it. This function is used by the framework for overloading
+ * mock services. It should not be used in an application
+ * @param internalApiDto The list of services and helpers to inject
+ * @returns An initialized Surfside API
+ */
+async function InitSurfAdsCoreInternal(internalApiDto) {
+    const { getDevice, mobile, navigator, ip, getGeo, geoProviderToken, getConfiguration, accountId, siteId, logger, channelId, locationId, userId, handlebars, windowInfo, screenInfo, requestBids, getSponsoredProduct, getAllSponsoredProducts, getRecommendedProduct, generateTopProducts, generateForYou, generatePreviousPurchases, getDynamicZone, buildAllSponsoredProductCardResponses, generateSponsoredProductCardResponse, evaluateProductCardTemplate, evaluateClickthroughTemplate, } = internalApiDto;
+    const device = getDevice(screenInfo, navigator, mobile);
+    const geo = await getGeo(geoProviderToken, ip);
+    const configuration = await getConfiguration();
+    if (!configuration.ok) {
+        return (0, services_1.Err)(new MissingConfigurationError(accountId, siteId));
+    }
+    const startRequestBound = helpers_1.StartRequest.bind(undefined, logger, accountId, siteId, channelId, locationId, (0, services_1.GetValue)(device), (0, services_1.GetValue)(geo), userId);
+    const startRequest = (zoneId, id) => startRequestBound(zoneId, id)
+        .withApp({
+        bundle: windowInfo.host,
+        name: windowInfo.host,
+        id: siteId,
+        domain: windowInfo.host,
+        publisher: {
+            domain: windowInfo.host,
+        }
+    })
+        .withSite({
+        name: windowInfo.host,
+        id: siteId,
+        kwarray: [],
+        mobile: isMobile() ? 1 : 0,
+        page: windowInfo.href,
+        domain: windowInfo.host,
+        publisher: {
+            id: siteId,
+            name: windowInfo.host,
+            domain: windowInfo.host,
+        },
+        ref: '',
+        search: windowInfo.search
+    });
+    const startNative = helpers_1.StartNative.bind(undefined, logger);
+    const defaultNative = helpers_1.DefaultNative.bind(undefined, logger);
+    return (0, services_1.Ok)({
+        logger,
+        getDevice,
+        device: (0, services_1.GetValue)(device),
+        getGeo,
+        geo: (0, services_1.GetValue)(geo),
+        configuration: configuration.value,
+        getConfiguration,
+        handlebars,
+        requestBids,
+        startRequest,
+        startNative,
+        defaultNative,
+        getSponsoredProduct,
+        getAllSponsoredProducts,
+        getRecommendedProduct,
+        generateTopProducts,
+        generateForYou,
+        generatePreviousPurchases,
+        buildAllSponsoredProductCardResponses,
+        generateSponsoredProductCardResponse,
+        evaluateProductCardTemplate,
+        evaluateClickthroughTemplate,
+        buildSponsoredCarousel: Carousel_1.BuildSponsoredCarousel.bind(undefined, logger, requestBids, generateSponsoredProductCardResponse),
+        buildSponsoredCarouselFromInitialBid: Carousel_1.BuildSponsoredCarouselFromInitialBid.bind(undefined, logger, requestBids, generateSponsoredProductCardResponse),
+        buildHybridCarouselFromInitialBid: Carousel_1.BuildHybridCarouselFromInitialBid.bind(undefined, logger, evaluateClickthroughTemplate, requestBids, generateSponsoredProductCardResponse, generateTopProducts, generatePreviousPurchases, generateForYou, userId),
+        buildRecommendedCarousel: Carousel_1.BuildRecommendedCarousel.bind(undefined, logger, evaluateClickthroughTemplate, generateTopProducts, generatePreviousPurchases, generateForYou, userId),
+        buildHybridCarousel: Carousel_1.BuildHybridCarousel.bind(undefined, logger, evaluateClickthroughTemplate, requestBids, generateSponsoredProductCardResponse, generateTopProducts, generatePreviousPurchases, generateForYou, userId),
+        getDynamicZone,
+        buildDynamicZoneRequest: Dynamic_1.BuildDynamicZoneRequest.bind(undefined, logger, startRequest, defaultNative, screenInfo)
+    });
+}
+const InitSurfAdsCoreServices = async (logger, bidderServiceUrl, configurationServiceUrl, productFeedUrl, recommendedProductFeedUrl, recommenderServiceUrl, dynamicZoneServiceUrl, windowInfo, screenInfo, navigator, mobile, ip, geoProviderToken, accountId, siteId, channelId, locationId, userId) => {
+    const handlebars = runtime_1.default.create();
+    const helpers = (0, helpers_1.GetHelpers)();
+    const recommendedProductFeed = services_1.GetRecommendedProduct.bind(undefined, logger, recommendedProductFeedUrl, accountId, locationId);
+    const configurationService = services_1.GetConfiguration.bind(undefined, logger, configurationServiceUrl, handlebars, helpers, accountId, siteId);
+    const configuration = await configurationService();
+    if (!configuration.ok) {
+        return configuration;
+    }
+    const getAllSponsoredProducts = services_1.GetAllSponsoredProducts.bind(undefined, logger, productFeedUrl, accountId, locationId);
+    const generateProductCardResponse = helpers_1.GenerateSponsoredProductCardResponse.bind(undefined, logger, getAllSponsoredProducts, windowInfo, configuration.value);
+    const evaluateClickthroughTemplate = Template_1.EvaluateHandlebarsClickthroughTemplate.bind(undefined, logger, windowInfo, configuration.value);
+    const evaluateProductCardTemplate = Template_1.EvaluateHandlebarsProductCardTemplate.bind(undefined, logger, windowInfo, configuration.value);
+    return await InitSurfAdsCoreInternal({
+        logger,
+        requestBids: services_1.RequestBids.bind(undefined, logger, bidderServiceUrl, accountId, siteId, locationId, channelId),
+        getConfiguration: configurationService,
+        getGeo: services_1.GetGeo.bind(undefined, logger),
+        getDevice: services_1.GetDevice.bind(undefined, logger),
+        getSponsoredProduct: services_1.GetSponsoredProduct.bind(undefined, logger, productFeedUrl, accountId, locationId),
+        getAllSponsoredProducts,
+        getRecommendedProduct: services_1.GetRecommendedProduct.bind(undefined, logger, recommendedProductFeedUrl, accountId, locationId),
+        generateTopProducts: services_1.GenerateTopProducts.bind(undefined, logger, recommendedProductFeed, recommenderServiceUrl, accountId, siteId, locationId),
+        generateForYou: services_1.GenerateForYou.bind(undefined, logger, recommendedProductFeed, recommenderServiceUrl, accountId, siteId, locationId, userId ?? 'undefined'),
+        generatePreviousPurchases: services_1.GeneratePreviousPurchases.bind(undefined, logger, recommendedProductFeed, recommenderServiceUrl, accountId, siteId, locationId, userId ?? 'undefined'),
+        buildAllSponsoredProductCardResponses: helpers_1.BuildAllSponsoredProductCardResponses.bind(undefined, logger, getAllSponsoredProducts, windowInfo, configuration.value),
+        generateSponsoredProductCardResponse: generateProductCardResponse,
+        evaluateProductCardTemplate,
+        evaluateClickthroughTemplate,
+        handlebars,
+        windowInfo,
+        screenInfo,
+        navigator,
+        mobile,
+        ip,
+        geoProviderToken,
+        accountId,
+        siteId,
+        channelId,
+        locationId,
+        userId,
+        getDynamicZone: Dynamic_1.GetDynamicZone.bind(undefined, logger, configuration.value)
+    });
+};
+exports.InitSurfAdsCoreServices = InitSurfAdsCoreServices;
+/* For use in serverside rendering */
+// TODO: Rename this?
+const InitSurfAdsCoreSSR = async (windowInfo, screen, navigator, mobile, ip, geoProviderToken, accountId, siteId, channelId, locationId, userId, logger) => (0, exports.InitSurfAdsCoreServices)(logger, TLS(exports.PROD_BIDDER), TLS(exports.PROD_CONFIGURATION_SERVICE), TLS(exports.PROD_SPONSORED_PRODUCT_FEED), TLS(exports.PROD_RECOMMENDED_PRODUCT_FEED), TLS(exports.PROD_RECOMMENDER_SERVICE), TLS(exports.PROD_DYNAMIC_ZONE_SERVICE), windowInfo, screen, navigator, mobile, ip, geoProviderToken, accountId, siteId, channelId, locationId, userId);
+exports.InitSurfAdsCoreSSR = InitSurfAdsCoreSSR;
+/* For use in web browsers */
+const InitSurfAdsCore = async (channelId, accountId, siteId, locationId, userId, logger) => {
+    /* Not in a browser */
+    const windowInfo = (0, Window_1.GetWindowInfo)();
+    if (!windowInfo.ok) {
+        return windowInfo;
+    }
+    return (0, exports.InitSurfAdsCoreServices)(logger, TLS(exports.PROD_BIDDER), TLS(exports.PROD_CONFIGURATION_SERVICE), TLS(exports.PROD_SPONSORED_PRODUCT_FEED), TLS(exports.PROD_RECOMMENDED_PRODUCT_FEED), TLS(exports.PROD_RECOMMENDER_SERVICE), TLS(exports.PROD_DYNAMIC_ZONE_SERVICE), windowInfo.value, window.screen, window.navigator, isMobile(), undefined, undefined, accountId, siteId, channelId, locationId, userId);
+};
+exports.InitSurfAdsCore = InitSurfAdsCore;
+class MissingConfigurationError extends Error {
+    constructor(accountId, siteId) {
+        super('Missing configuration for\n' +
+            `    accountId: ${accountId}\n` +
+            `    siteId: ${siteId}\n` +
+            '1. Check to make sure that these are the correct values for each field' +
+            '2. Check your publisher configuration at ' +
+            `https://app.surfside.io/inventory/sites/publisher/${accountId}/${siteId}`);
+    }
+}
+exports.MissingConfigurationError = MissingConfigurationError;
+;
+class NotABrowserError extends Error {
+    constructor() {
+        super('You are not running Surfside Ads Core in a Web browser, so you cannot use "InitSurfAdsCore". ' +
+            'Instead, use InitSurfAdsCoreSSR, and pass the user\'s screen, navigator, and IP address explicitly ' +
+            'so that Surfside Ads Core can initialize geo and device information services. e.g: \n' +
+            '    InitSurfAdsCoreSSR(\n' +
+            '        /* width and height of the user\'s screen: */\n' +
+            '      { width: screenWidth, height: screenHeight },\n' +
+            '        /* userAgent string and language of the user: */\n' +
+            '      { userAgent: userAgent, language: userLanguage },\n' +
+            '        /* whether the user is on mobile or not: */\n' +
+            '      true,\n' +
+            '        /* the requesting User\'s IP */\n' +
+            '      request.ipAddress,\n' +
+            '        /* Your API Token for the Surfside Geo Service: */\n' +
+            '      geoProviderToken,\n' +
+            '      accountId,\n' +
+            '      siteId,\n' +
+            '      channelId,\n' +
+            '      locationId,\n' +
+            '      userId,\n' +
+            '        /* Optional logger: */\n' +
+            '      logger\n' +
+            '    )');
+    }
+}
+exports.NotABrowserError = NotABrowserError;
+const isMobile = () => typeof window !== 'undefined' ? (window.ontouchstart !== undefined) : false;
+//# sourceMappingURL=Api.js.map

package/lib/cjs/Api.js.map

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

package/lib/cjs/helpers/Generator.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsumeAllAsync = exports.ConsumeNAsync = exports.ConsumeAll = exports.ConsumeN = void 0;
+exports.GenerateArray = GenerateArray;
+const ConsumeN = (generator, n) => {
+    const consumed = [];
+    for (let i = 0; i < n; i++) {
+        const value = generator.next();
+        if (value.done === true) {
+            break;
+        }
+        consumed.push(value.value);
+    }
+    return consumed;
+};
+exports.ConsumeN = ConsumeN;
+const ConsumeAll = (generator) => {
+    const consumed = [];
+    for (const value of generator) {
+        consumed.push(value);
+    }
+    return consumed;
+};
+exports.ConsumeAll = ConsumeAll;
+const ConsumeNAsync = async (generator, n) => {
+    const consumed = [];
+    while (consumed.length < n) {
+        const result = await generator.next();
+        if (result.done === true) {
+            return [consumed, true];
+        }
+        consumed.push(result.value);
+    }
+    return [consumed, false];
+};
+exports.ConsumeNAsync = ConsumeNAsync;
+const ConsumeAllAsync = async (generator) => {
+    const consumed = [];
+    for await (const value of generator) {
+        consumed.push(value);
+    }
+    return consumed;
+};
+exports.ConsumeAllAsync = ConsumeAllAsync;
+function* GenerateArray(data) {
+    for (const t of data) {
+        yield t;
+    }
+}
+//# sourceMappingURL=Generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Generator.js","sourceRoot":"src/","sources":["helpers/Generator.ts"],"names":[],"mappings":";;;AA2CA,sCAIC;AA/CM,MAAM,QAAQ,GAAG,CAAI,SAAuB,EAAE,CAAS,EAAO,EAAE;IACnE,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM;QACV,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAVW,QAAA,QAAQ,YAUnB;AAEK,MAAM,UAAU,GAAG,CAAI,SAAuB,EAAO,EAAE;IAC1D,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AANW,QAAA,UAAU,cAMrB;AAEK,MAAM,aAAa,GAAG,KAAK,EAC9B,SAA4B,EAC5B,CAAS,EAC8B,EAAE;IACzC,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC,CAAC;AAbW,QAAA,aAAa,iBAaxB;AAEK,MAAM,eAAe,GAAG,KAAK,EAAK,SAA4B,EAAgB,EAAE;IACnF,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AANW,QAAA,eAAe,mBAM1B;AAEF,QAAe,CAAC,CAAC,aAAa,CAAI,IAAS;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,CAAC;IACZ,CAAC;AACL,CAAC"}

package/lib/cjs/helpers/Handlebars.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetHelpers = void 0;
+exports.slug = slug;
+exports.lower = lower;
+exports.upper = upper;
+exports.path = path;
+exports.sed = sed;
+exports.replace = replace;
+exports.search = search;
+exports.coalesce = coalesce;
+exports.join = join;
+exports.uri = uri;
+exports.eq = eq;
+exports.or = or;
+exports.and = and;
+exports.isIn = isIn;
+exports.array = array;
+const DEFAULT_MAX_SLUG = 5;
+/**
+ * Converts the passed string to a slug with the specified options. By default, the slug is hyphenated and only
+ * contains alphanumeric characters. You can pass a different hyphenation regex and a different drop regex to
+ * customize the slug. For example, {{slug "My Product Name"}} will return "my-product-name".
+ *
+ * To change which characters are converted to hyphens, you can pass a regular expression to the hyphenate option.
+ * For example, {{slug "My Product's Name" hyphenate="[\s']"}} will return "my-product-s-name".
+ * The default hyphenate regex is /[\s_\-,]/ig.
+ *
+ * To remove characters instead of hyphenate them, you can pass a regular expression to the drop option.
+ * For example, {{slug "My Product's Name" drop="[^A-Za-z0-9\s']"}} will return "my-product's-name".
+ * The default drop regex is /[^A-Za-z0-9\-]/ig.
+ *
+ * To limit the max number of hyphenated slug components returned, you can pass a length option.
+ * For example, {{slug "My Product's Name" length=2}} will return "my-product".
+ * The default length is 5.
+ *
+ * @param name The string to be slugified
+ * @param options The options object. Can take "hypenate", "drop", and "length" options.
+ * @returns The slugified string
+ */
+function slug(name, options) {
+    if (name === undefined || name === null || typeof (name) !== 'string') {
+        return '';
+    }
+    const hyphenate = options.hash.hyphenate !== undefined
+        ? new RegExp(options.hash.hyphenate, 'ig')
+        : /[\s_\-,]/ig;
+    const drop = options.hash.drop !== undefined
+        ? new RegExp(options.hash.drop, 'ig')
+        : /[^A-Za-z0-9-]/ig;
+    const dropBefore = options.hash.dropBefore !== undefined
+        ? new RegExp(options.hash.dropBefore)
+        : undefined;
+    const maxSlug = options.hash.length ?? DEFAULT_MAX_SLUG;
+    const separator = options.hash.separator ?? '-';
+    if (dropBefore !== undefined) {
+        name = name.replace(dropBefore, '');
+    }
+    return name
+        .replace(hyphenate, separator)
+        .replace(drop, '')
+        .toLowerCase()
+        .split(separator)
+        .slice(0, maxSlug)
+        .join(separator);
+}
+/**
+ * Converts the passed string to lowercase. For example, {{lower "My Product Name"}} will return "my product name".
+ *
+ * @param name The string to be converted to lowercase
+ * @returns A lowercase version of the passed string
+ */
+function lower(name) {
+    if (name === undefined || name === null || typeof (name) !== 'string') {
+        return '';
+    }
+    return name.toLowerCase();
+}
+function upper(name) {
+    if (name === undefined || name === null || typeof (name) !== 'string') {
+        return '';
+    }
+    return name.toUpperCase();
+}
+/**
+ * Returns the path component of the URL at the specified position, 1-indexed
+ * For example, if the URL is "https://example.com/foo/bar", {{path 1}} will return "foo".
+ *
+ * @param position The position of the path component to return, 1-indexed
+ * @returns The path component at the specified position
+ */
+function path(position) {
+    if (position === 0 || position === undefined || position === null) {
+        return '';
+    }
+    const paths = window.location.pathname.split('/');
+    if (paths.length <= position) {
+        return '';
+    }
+    return paths[position];
+}
+function sed(input, searchRegex, replacement) {
+    return input.replace(new RegExp(searchRegex), (...args) => {
+        const END = -2;
+        const groups = args.slice(1, END); // Extract capture groups
+        let result = replacement;
+        // Replace backreferences (\1, \2, etc.)
+        result = result.replace(/\\(\d+)/g, (_, groupIndex) => groups[groupIndex - 1] ?? '');
+        // Support for \U (uppercase transformation)
+        result = result.replace(/\\U(\d+)/g, (_, groupIndex) => (groups[groupIndex - 1] ?? '').toUpperCase());
+        result = sedCommand(result, 'U', groups, str => str?.toUpperCase());
+        result = sedCommand(result, 'L', groups, str => str?.toLowerCase());
+        result = sedCommand(result, 'I', groups, str => str?.[0]);
+        return result ?? '';
+    });
+}
+function replace(input, search, replacement, all = true) {
+    if (input === null || input === undefined) {
+        return '';
+    }
+    if (search === null || search === undefined || replacement === null || replacement === undefined) {
+        return input;
+    }
+    if (all) {
+        return input.replaceAll(search, replacement);
+    }
+    return input.replace(search, replacement);
+}
+function sedCommand(input, char, groups, transform) {
+    if (input === undefined) {
+        return undefined;
+    }
+    return input.replace(new RegExp(`\\\\${char}(\\d+)`, 'g'), (_, groupIndex) => transform(groups[groupIndex - 1] ?? '') ?? '');
+}
+/**
+ * Returns the value of the specified query parameter from the URL, specified by key.
+ * For example, if the URL is "https://example.com?foo=bar", {{search "foo"}} will return "bar".
+ *
+ * @param name The name of the query parameter to return
+ * @returns The value of the query parameter, or an empty string if the parameter is not found
+ */
+function search(name) {
+    if (name?.length === undefined || name.length === 0) {
+        return '';
+    }
+    const search = window.location.search;
+    if (search.length === 0) {
+        return '';
+    }
+    const params = new URLSearchParams(search);
+    return params.get(name) ?? '';
+}
+/**
+ * Returns the first truthy argument, or an empty string if all arguments are falsy. Returns false for empty strings
+ * For example, {{coalesce false (eq "b" "d") c}} will return "c", because false is falsy, "b" is not equal to "d",
+ * and c is truthy.
+ *
+ * @returns The first truthy argument, or an empty string if all arguments are falsy
+ */
+function coalesce(...args) {
+    for (let i = 0; i < args.length - 1; i++) {
+        const arg = args[i];
+        if (arg !== null && arg !== undefined && arg !== '' && arg !== false) {
+            return arg;
+        }
+    }
+    return '';
+}
+/**
+ * Joins the passed arguments with the specified separator.
+ * For example, {{join "foo" "bar" "baz"}} will return "foo/bar/baz"..
+ *
+ * There is an optional "separator" argument that can be passed to change the separator. For example,
+ * {{join "foo" "bar" "baz" separator=","}} will return "foo,bar,baz".
+ *
+ * @returns The joined string
+ */
+function join(...args) {
+    const pargs = [...args].slice(0, args.length - 1);
+    const options = args[args.length - 1]; /* options is always the last argument */
+    const separator = options.hash.separator ?? '/';
+    return pargs
+        .filter(arg => arg !== undefined && arg !== null && arg !== '') /* filter out nulls and empties */
+        .join(separator);
+}
+/**
+ * Encodes the passed string for use in a URI component.
+ *
+ * @param component The string to encode
+ * @returns The encoded string, or an empty string if the component is falsy
+ */
+function uri(component) {
+    if (component?.length === undefined || component.length === 0) {
+        return '';
+    }
+    const encoded = encodeURIComponent(component);
+    return encoded.replaceAll('\'', '%27');
+}
+/**
+ * Returns true if the two passed arguments are equal (using javascript ===), false otherwise.
+ *
+ * @param a The first argument
+ * @param b The second argument
+ * @returns True if the two arguments are equal, false otherwise
+ */
+function eq(a, b) {
+    return a === b;
+}
+/**
+ * Returns true if either of the passed arguments are truthy, false otherwise.
+ *
+ * @param a The first argument
+ * @param b The second argument
+ * @returns True if either of the arguments are truthy, false otherwise
+ */
+function or(a, b) {
+    return Boolean(a) || Boolean(b);
+}
+/**
+ * Returns true if both of the passed arguments are truthy, false otherwise.
+ *
+ * @param a The first argument
+ * @param b The second argument
+ * @returns True if both of the arguments are truthy, false otherwise
+ */
+function and(a, b) {
+    return Boolean(a) && Boolean(b);
+}
+/**
+ * Returns true if the first argument is in the second argument (an array). Otherwise, returns false.
+ * If the second argument is not an array, or the array is empty, this will return false.
+ *
+ * The name of the helper is "in" but the name of the function is "isIn" because "in" is a reserved word in javascript.
+ *
+ * @param a The value to check
+ * @param b The array to check against
+ * @returns True if the value is in the array, false otherwise
+ */
+function isIn(a, b) {
+    if (b?.length === undefined || b.length === 0) {
+        return false;
+    }
+    return b.includes(a);
+}
+/**
+ * Returns an array of the passed arguments. Useful with the "in" helper
+ *
+ * @returns An array of the passed arguments
+ */
+function array(...args) {
+    return Array.from(args).slice(0, -1);
+}
+const GetHelpers = () => ({
+    slug,
+    lower,
+    path,
+    sed,
+    replace,
+    search,
+    coalesce,
+    join,
+    get_first: coalesce,
+    uri,
+    or,
+    and,
+    isIn,
+    array
+});
+exports.GetHelpers = GetHelpers;
+//# sourceMappingURL=Handlebars.js.map

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

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