@surfside/ads-core 2.0.1 → 2.0.3

package/lib/esm/services/Recommender.js

@@ -0,0 +1,78 @@
+import { Ctx } from './Logger';
+import { Err, Ok } from './Result';
+export async function* GenerateTopProducts(logger, productFeed, url, accountId, siteId, locationId) {
+    const log = Ctx(logger)?.with('GenerateTopProducts').with(accountId).with(siteId).with(locationId);
+    log?.info('Generating top products');
+    yield* generateProductRecommendation(logger, productFeed, url, accountId, siteId, locationId, undefined, 'top-products');
+}
+export async function* GenerateForYou(logger, productFeed, url, accountId, siteId, locationId, userId) {
+    const log = Ctx(logger)?.with('GenerateForYou').with(accountId).with(siteId).with(locationId).with(userId);
+    log?.info('Generating for you');
+    yield* generateProductRecommendation(logger, productFeed, url, accountId, siteId, locationId, userId, 'for-you');
+}
+export async function* GeneratePreviousPurchases(logger, productFeed, url, accountId, siteId, locationId, userId) {
+    const log = Ctx(logger)
+        ?.with('GeneratePreviousPurchases')
+        .with(accountId)
+        .with(siteId)
+        .with(locationId)
+        .with(userId);
+    log?.info('Generating previous purchases');
+    yield* generateProductRecommendation(log, productFeed, url, accountId, siteId, locationId, userId, 'buy-again');
+}
+async function* generateProductRecommendation(logger, productFeed, url, accountId, siteId, locationId, userId, type) {
+    const log = Ctx(logger)?.with('generatreProductRecommendation');
+    log?.debug('Generating product recommendation');
+    const recommendations = await fetchRecommendations(log, url, accountId, siteId, locationId, userId, type);
+    if (!recommendations.ok) {
+        log?.error(recommendations.error);
+        return;
+    }
+    yield* generateProduct(log, productFeed, accountId, locationId, recommendations.value);
+    log?.debug('out of recommendations');
+}
+const fetchRecommendations = async (logger, url, accountId, siteId, locationId, userId, type) => {
+    const log = Ctx(logger)?.with('fetchRecommendations');
+    log?.debug('Fetching recommendations');
+    const key = `accountId=${accountId}&siteId=${siteId}&locationId=${locationId}&userId=${userId ?? 'null'}`;
+    try {
+        const results = await fetch(`${url}/r/${type}?${key}&limit=100`);
+        if (!results.ok) {
+            return Err(new Error('Failed to load recommendations. Service returned ' + results.status));
+        }
+        /* On error, the result will be IRecommenderResponse.
+         * On success, it will just be a set of recommended products */
+        const recommendations = await results.json();
+        const error = recommendations.error;
+        if (error !== undefined) {
+            return Err(new Error(error));
+        }
+        return Ok(recommendations);
+    }
+    catch (err) {
+        return Err(err);
+    }
+};
+async function* generateProduct(logger, productFeed, accountId, locationId, results) {
+    const log = Ctx(logger)?.with('generateProduct');
+    log?.debug('generating product info');
+    for (const item of results) {
+        const itemId = item.item_id;
+        try {
+            log?.debug('itemId', itemId);
+            const product = await productFeed(itemId);
+            log?.debug('product', itemId, product);
+            if (product.ok) {
+                yield product.value;
+            }
+            else {
+                log?.warn('item was missing from product feed', itemId);
+            }
+        }
+        catch (err) {
+            log?.warn('couldn\'t get product', err);
+        }
+    }
+    log?.info('no more products. Exiting');
+}
+//# sourceMappingURL=Recommender.js.map

package/lib/esm/services/Recommender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Recommender.js","sourceRoot":"src/","sources":["services/Recommender.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAgB,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,GAAG,EAAE,EAAE,EAAoB,MAAM,UAAU,CAAC;AAKrD,MAAM,CAAC,KAAK,SAAU,CAAC,CAAA,mBAAmB,CACtC,MAA2B,EAC3B,WAAiD,EACjD,GAAW,EACX,SAAiB,EACjB,MAAc,EACd,UAAkB;IAElB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnG,GAAG,EAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAErC,KAAK,CAAC,CAAC,6BAA6B,CAChC,MAAM,EACN,WAAW,EACX,GAAG,EACH,SAAS,EACT,MAAM,EACN,UAAU,EACV,SAAS,EACT,cAAc,CACjB,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,SAAU,CAAC,CAAA,cAAc,CACjC,MAA2B,EAC3B,WAAiD,EACjD,GAAW,EACX,SAAiB,EACjB,MAAc,EACd,UAAkB,EAClB,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3G,GAAG,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAEhC,KAAK,CAAC,CAAC,6BAA6B,CAChC,MAAM,EACN,WAAW,EACX,GAAG,EACH,SAAS,EACT,MAAM,EACN,UAAU,EACV,MAAM,EACN,SAAS,CACZ,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,SAAU,CAAC,CAAA,yBAAyB,CAC5C,MAA2B,EAC3B,WAAiD,EACjD,GAAW,EACX,SAAiB,EACjB,MAAc,EACd,UAAkB,EAClB,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;QACnB,EAAE,IAAI,CAAC,2BAA2B,CAAC;SAClC,IAAI,CAAC,SAAS,CAAC;SACf,IAAI,CAAC,MAAM,CAAC;SACZ,IAAI,CAAC,UAAU,CAAC;SAChB,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,GAAG,EAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAE3C,KAAK,CAAC,CAAC,6BAA6B,CAChC,GAAG,EACH,WAAW,EACX,GAAG,EAAE,SAAS,EACd,MAAM,EACN,UAAU,EACV,MAAM,EACN,WAAW,CACd,CAAC;AACN,CAAC;AAED,KAAK,SAAU,CAAC,CAAA,6BAA6B,CACzC,MAA2B,EAC3B,WAAiD,EACjD,GAAW,EACX,SAAiB,EACjB,MAAc,EACd,UAAkB,EAClB,MAA0B,EAC1B,IAAY;IAEZ,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAChE,GAAG,EAAE,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,MAAM,oBAAoB,CAC9C,GAAG,EACH,GAAG,EACH,SAAS,EACT,MAAM,EACN,UAAU,EACV,MAAM,EACN,IAAI,CACP,CAAC;IACF,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;QACtB,GAAG,EAAE,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO;IACX,CAAC;IAED,KAAK,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IACvF,GAAG,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,oBAAoB,GAAG,KAAK,EAC9B,MAA2B,EAC3B,GAAW,EACX,SAAiB,EACjB,MAAc,EACd,UAAkB,EAClB,MAA0B,EAC1B,IAAY,EACsB,EAAE;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtD,GAAG,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,aAAa,SAAS,WAAW,MAAM,eAAe,UAAU,WAAW,MAAM,IAAI,MAAM,EAAE,CAAC;IAC1G,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,MAAM,IAAI,IAAI,GAAG,YAAY,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,mDAAmD,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAChG,CAAC;QACD;uEAC+D;QAC/D,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,EAAoD,CAAC;QAC/F,MAAM,KAAK,GAAI,eAAwC,CAAC,KAAK,CAAC;QAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,EAAE,CAAC,eAAwC,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,GAAY,CAAC,CAAC;IAC7B,CAAC;AACL,CAAC,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,eAAe,CAC3B,MAA2B,EAC3B,WAAiD,EACjD,SAAiB,EACjB,UAAkB,EAClB,OAA8B;IAE9B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjD,GAAG,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC;YACD,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;YAC1C,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACvC,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,OAAO,CAAC,KAAK,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACJ,GAAG,EAAE,IAAI,CAAC,oCAAoC,EAAE,MAAM,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,EAAE,IAAI,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED,GAAG,EAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;AAC3C,CAAC"}

package/lib/esm/services/Result.js

@@ -0,0 +1,199 @@
+export const Ok = (t) => ({
+    ok: true,
+    value: t
+});
+export const Err = (e) => ({
+    ok: false,
+    error: e
+});
+export const TryDo = (fn) => {
+    try {
+        return Ok(fn());
+    }
+    catch (err) {
+        return Err(err);
+    }
+};
+export const TryDoFlat = (fn) => {
+    try {
+        return fn();
+    }
+    catch (err) {
+        return Err(err);
+    }
+};
+export const TryDoAsync = async (fn) => {
+    try {
+        return Ok(await fn());
+    }
+    catch (err) {
+        return Err(err);
+    }
+};
+export const GetValue = (result) => result?.ok === true ? result.value : undefined;
+export const ValueOr = (result, or) => result?.ok === true ? result.value : or;
+export const GetValueOrThrow = (result) => {
+    if (result.ok) {
+        return result.value;
+    }
+    throw result.error;
+};
+export const WrapValue = (value) => {
+    if (value === undefined || value === null) {
+        return Err(new NoValueError(value));
+    }
+    return Ok(value);
+};
+export const AssertValue = GetValueOrThrow;
+export const AllOrNone = (results) => {
+    const failed = results.filter(res => !res.ok).map(res => res.error);
+    if (failed.length > 0) {
+        return Err(new MultipleErrorsError(failed));
+    }
+    const success = results.filter(res => res.ok).map(res => res.value);
+    return Ok(success);
+};
+export const Some = (results) => {
+    const success = results.filter(res => res.ok).map(res => res.value);
+    return Ok(success);
+};
+export const Filter = (...results) => {
+    const success = Some(results).value.map(val => Ok(val));
+    const failed = results.filter(res => !res.ok);
+    return [success, failed];
+};
+export const AnyFailed = (...results) => {
+    const errors = results.filter(res => !res.ok).map(res => res.error);
+    if (errors.length > 0) {
+        return [true, errors];
+    }
+    return [false];
+};
+export class MultipleErrorsError extends Error {
+    errors;
+    constructor(errors) {
+        super('Got multiple errors:\n' +
+            errors.map(err => '\t' + err.message.substring(0, 32).padEnd(35, '.')).join('\n'));
+        this.errors = errors;
+    }
+}
+export const Pipe = (result) => ({
+    then: pipeThen(result),
+    result: pipeResult(result),
+    value: pipeValue(result),
+    valueOr: pipeValueOr(result),
+    valueOrThrow: pipeValueOrThrow(result)
+});
+const pipeThen = (result) => (fn) => {
+    if (!result.ok) {
+        return Pipe(result);
+    }
+    return Pipe(Ok(fn(result.value)));
+};
+const pipeResult = (result) => () => result;
+const pipeValue = (result) => () => GetValue(result);
+const pipeValueOr = (result) => (or) => GetValue(result) ?? or;
+const pipeValueOrThrow = (result) => () => {
+    if (result.ok) {
+        return result.value;
+    }
+    throw result.error;
+};
+export const AsyncPipe = (result) => ({
+    then: asyncPipeThen(result),
+    result: asyncPipeResult(result),
+    value: asyncPipeValue(result),
+    valueOr: asyncPipeValueOr(result),
+    valueOrThrow: asyncPipeValueOrThrow(result)
+});
+const asyncPipeThen = (result) => (fn) => {
+    const asyncResult = result;
+    const wrappedPromiseResult = asyncResult.then(unwrappedResult => {
+        if (unwrappedResult.ok) {
+            try {
+                const fnRes = fn(unwrappedResult.value);
+                return Promise.resolve(fnRes)
+                    .catch(Err);
+            }
+            catch (err) {
+                return Err(err);
+            }
+        }
+        else {
+            return unwrappedResult;
+        }
+    });
+    return AsyncPipe(wrappedPromiseResult);
+};
+const asyncPipeResult = (result) => () => result;
+const asyncPipeValue = (result) => async () => {
+    try {
+        const res = await result;
+        if (res.ok) {
+            return res.value;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+const asyncPipeValueOr = (result) => async (or) => {
+    try {
+        const res = await result;
+        if (res.ok) {
+            return res.value;
+        }
+        return or;
+    }
+    catch {
+        return or;
+    }
+};
+const asyncPipeValueOrThrow = (result) => async () => {
+    const res = await result;
+    if (res.ok) {
+        return res.value;
+    }
+    throw res.error;
+};
+export const ResultStream = (results) => ({
+    map: streamMap(results),
+    filter: streamFilter(results),
+    results: streamResults(results),
+    value: streamValue(results),
+    valueOr: streamValueOr(results),
+    valueOrThrow: streamValueOrThrow(results)
+});
+const streamMap = (results) => (fn) => {
+    if (!results.ok) {
+        return ResultStream(results);
+    }
+    return ResultStream(Ok(results.value.map(fn)));
+};
+const streamFilter = (results) => (fn) => {
+    if (!results.ok) {
+        return ResultStream(results);
+    }
+    return ResultStream(Ok(results.value.filter(fn)));
+};
+const streamResults = (results) => () => results;
+const streamValue = (results) => () => results.ok ? results.value : undefined;
+const streamValueOr = (results) => (or) => results.ok ? results.value : or;
+const streamValueOrThrow = (results) => () => {
+    if (results.ok) {
+        return results.value;
+    }
+    else {
+        throw results.error;
+    }
+};
+export class NoValueError extends Error {
+    value;
+    constructor(value) {
+        super('Value was undefined or null');
+        this.value = value;
+    }
+}
+;
+//# sourceMappingURL=Result.js.map

package/lib/esm/services/Result.js.map

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

package/lib/esm/services/Template.js

@@ -0,0 +1,38 @@
+import { Ctx } from './Logger';
+import { Err, GetValueOrThrow, Ok } from './Result';
+export const EvaluateHandlebarsProductCardTemplate = (logger, windowInfo, publisher, product, clickthrough) => {
+    const log = Ctx(logger)?.with('EvaluateHandlebarsProductCardTemplate');
+    log?.info('Evaluating handlebars product card template', product);
+    try {
+        const renderedClickthrough = clickthrough ?? GetValueOrThrow(EvaluateHandlebarsClickthroughTemplate(log, windowInfo, publisher, product));
+        log?.debug('Got clickthrough URL', renderedClickthrough);
+        return Ok(publisher.templates.productCardTemplate({
+            ...product,
+            product,
+            window: windowInfo,
+            publisher,
+            catalog: product,
+            clickthrough: renderedClickthrough
+        }));
+    }
+    catch (error) {
+        return Err(error);
+    }
+};
+export const EvaluateHandlebarsClickthroughTemplate = (logger, windowInfo, publisher, product) => {
+    const log = Ctx(logger)?.with('EvaluateHandlebarsClickthroughTemplate');
+    log?.info('Evaluating handlebars clickthrough URL template', product);
+    try {
+        return Ok(publisher.templates.clickThroughUrlTemplate({
+            product,
+            catalog: product,
+            window: windowInfo,
+            publisher,
+            ...product
+        }));
+    }
+    catch (error) {
+        return Err(error);
+    }
+};
+//# sourceMappingURL=Template.js.map

package/lib/esm/services/Template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.js","sourceRoot":"src/","sources":["services/Template.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAgB,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,EAAe,MAAM,UAAU,CAAC;AAWjE,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,MAA2B,EAC7E,UAAyC,EACzC,SAA0C,EAC1C,OAA4B,EAC5B,YAAqB,EACP,EAAE;IAChB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvE,GAAG,EAAE,IAAI,CAAC,6CAA6C,EAAE,OAAO,CAAC,CAAC;IAElE,IAAI,CAAC;QACD,MAAM,oBAAoB,GAAG,YAAY,IAAI,eAAe,CACxD,sCAAsC,CAAC,GAAG,EACtC,UAAU,EACV,SAAS,EACT,OAAO,CACV,CACJ,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;QAEzD,OAAO,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,mBAAmB,CAAC;YAC9C,GAAG,OAAO;YACV,OAAO;YACP,MAAM,EAAE,UAAU;YAClB,SAAS;YACT,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,oBAAoB;SACrC,CAAC,CAAC,CAAC;IACR,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,KAAc,CAAC,CAAC;IAC/B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,MAA2B,EAC9E,UAAyC,EACzC,SAA0C,EAC1C,OAA4B,EACd,EAAE;IAChB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACxE,GAAG,EAAE,IAAI,CAAC,iDAAiD,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC;QACD,OAAO,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,uBAAuB,CAAC;YAClD,OAAO;YACP,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,UAAU;YAClB,SAAS;YACT,GAAG,OAAO;SACb,CAAC,CAAC,CAAC;IACR,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,KAAc,CAAC,CAAC;IAC/B,CAAC;AACL,CAAC,CAAC"}

package/lib/esm/services/index.js

@@ -0,0 +1,12 @@
+export * from './Geo';
+export * from './Logger';
+export * from './Result';
+export * from './Device';
+export * from './Configuration';
+export * from './Bidder';
+export * from './Product';
+export * from './Recommender';
+export * from './mock';
+export * from './Template';
+export * from './Dynamic';
+//# sourceMappingURL=index.js.map

package/lib/esm/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["services/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/lib/esm/services/mock/Bidder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Bidder.js.map

package/lib/esm/services/mock/Bidder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bidder.js","sourceRoot":"src/","sources":["services/mock/Bidder.ts"],"names":[],"mappings":""}

package/lib/esm/services/mock/index.js

@@ -0,0 +1,2 @@
+export * from './Bidder';
+//# sourceMappingURL=index.js.map

package/lib/esm/services/mock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["services/mock/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/lib/types/Api.d.ts

@@ -1,11 +1,11 @@
 import type { INativeTemplateDelegateWindow, ICompiledPublisherConfiguration, IDevice, IGeoContext } from './models';
-import { AsyncResult, INavigator, type IScreen, RequestBidsFn, ILogger, GetSponsoredProductFromNativeIdFn, PersonalRecommenderFn, NonPersonalRecommenderFn, GetConfigurationFn, GetGeoFn, GetDeviceFn, GetRecommendedProductFromProductIdFn, GetAllSponsoredProductFromNativeIdFn } from './services';
-import { BuildAllSponsoredProductCardResponsesFn, GenerateSponsoredProductCardResponseFn, NativeRequestBuilderFn, RequestBuilderFn } from './helpers';
+import { type AsyncResult, type INavigator, type IScreen, type RequestBidsFn, type ILogger, type GetSponsoredProductFromNativeIdFn, type PersonalRecommenderFn, type NonPersonalRecommenderFn, type GetConfigurationFn, type GetGeoFn, type GetDeviceFn, type GetRecommendedProductFromProductIdFn, type GetAllSponsoredProductFromNativeIdFn } from './services';
+import { type BuildAllSponsoredProductCardResponsesFn, type GenerateSponsoredProductCardResponseFn, type NativeRequestBuilderFn, type RequestBuilderFn } from './helpers';
 import Handlebars from 'handlebars/runtime';
-import { BuildHybridCarouselFn, BuildHybridCarouselFromInitialBidFn, BuildRecommendedCarouselFn, BuildSponsoredCarouselFn, BuildSponsoredCarouselFromInitialBidFn } from './helpers/response/Carousel';
+import { type BuildHybridCarouselFn, type BuildHybridCarouselFromInitialBidFn, type BuildRecommendedCarouselFn, type BuildSponsoredCarouselFn, type BuildSponsoredCarouselFromInitialBidFn } from './helpers/response/Carousel';
 import { type EvaluateClickthroughTemplateFn, type EvaluateProductCardTemplateFn } from './services/Template';
-import { BuildDynamicZoneRequestFn, GetDynamicZoneFn } from './services/Dynamic';
-export declare const PROD_BIDDER = "//rtb.surfside.io/rtb/bids/surfside";
+import { type BuildDynamicZoneRequestFn, type GetDynamicZoneFn } from './services/Dynamic';
+export declare const PROD_BIDDER = "//bid.surfside.io/rtb/bids/surfside";
 export declare const PROD_CONFIGURATION_SERVICE = "//r.surfside.io";
 export declare const PROD_SPONSORED_PRODUCT_FEED = "//creative.surfside.io";
 export declare const PROD_RECOMMENDED_PRODUCT_FEED = "//creative.surfside.io";

package/lib/types/helpers/Handlebars.d.ts

@@ -14,7 +14,7 @@
  * 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.
- *
+ * @group TemplateHelpers
  * @param name The string to be slugified
  * @param options The options object. Can take "hypenate", "drop", and "length" options.
  * @returns The slugified string
@@ -30,7 +30,7 @@ export declare function slug(name: string, options: {
 }): string;
 /**
  * Converts the passed string to lowercase. For example, {{lower "My Product Name"}} will return "my product name".
- *
+ * @group TemplateHelpers
  * @param name The string to be converted to lowercase
  * @returns A lowercase version of the passed string
  */
@@ -39,17 +39,60 @@ export declare function upper(name: string): string;
 /**
  * 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".
- *
+ * @group TemplateHelpers
  * @param position The position of the path component to return, 1-indexed
  * @returns The path component at the specified position
  */
 export declare function path(position: number): string | undefined;
+/**
+ * A general-purpose string replacement tool - meant to behave like the Unix sed tool. Accepts a regex for
+ * search, and a replacement string. for example, if the input string is "hello world" and the search is
+ * ".*(world)" and the replacement string is "goodbye \1", the replaced string will be "goodbye world".
+ *
+ * Supports back references with numbered groups. i.e, \1, \2, \3 will insert the 1st, 2nd, and 3rd capture
+ * groups.
+ *
+ * There are also 3 transforms you can apply to the back references: \U, \L, and \I:
+ *
+ * \U{n} will replace the capture group with an uppercase version. For example \U1
+ *
+ * \L{n} will replace the capture group with a lowercase version. For example \L3
+ *
+ * \I{n} will replace the capture group with the first character of the capture group. For example \I5
+ * @group TemplateHelpers
+ * @param input The input string
+ * @param searchRegex The search pattern for the regular expression
+ * @param replacement The replacement string
+ * @returns
+ */
 export declare function sed(input: string, searchRegex: string, replacement: string): string;
+/**
+ * Searches the input string for a simple string and replaces it with the replacement string. For example
+ * ```
+ * {{replace "hello world hello" "hello" "goodbye"}}
+ * ```
+ *
+ * returns "goodbye world goodbye"
+ *
+ * Optionally, you can pass `false` for the last parameter to only replace to first instance. i.e:
+ *
+ * ```
+ * {{replace "hello world hello" "hello" "goodbye" false}}
+ * ```
+ *
+ * Returns "goodbye world goodbye".
+ * @group TemplateHelpers
+ * @param input The string to be searched
+ * @param search The substring to replace
+ * @param replacement The string to replace it with
+ * @param all Whether or not to replace all matches of the string
+ * @returns
+ */
 export declare function replace(input: string, search: string, replacement: string, all?: boolean): string;
 /**
  * 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".
- *
+ * @group TemplateHelpers
  * @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
  */
@@ -58,30 +101,30 @@ export declare function search(name: string): string;
  * 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.
- *
+ * @group TemplateHelpers
  * @returns The first truthy argument, or an empty string if all arguments are falsy
  */
-export declare function coalesce(): string;
+export declare function coalesce(...args: any[]): string;
 /**
  * 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".
- *
+ * @group TemplateHelpers
  * @returns The joined string
  */
-export declare function join(): string;
+export declare function join(...args: any[]): string;
 /**
  * Encodes the passed string for use in a URI component.
- *
+ * @group TemplateHelpers
  * @param component The string to encode
  * @returns The encoded string, or an empty string if the component is falsy
  */
 export declare function uri(component: string): string;
 /**
  * Returns true if the two passed arguments are equal (using javascript ===), false otherwise.
- *
+ * @group TemplateHelpers
  * @param a The first argument
  * @param b The second argument
  * @returns True if the two arguments are equal, false otherwise
@@ -89,7 +132,7 @@ export declare function uri(component: string): string;
 export declare function eq(a: any, b: any): boolean;
 /**
  * Returns true if either of the passed arguments are truthy, false otherwise.
- *
+ * @group TemplateHelpers
  * @param a The first argument
  * @param b The second argument
  * @returns True if either of the arguments are truthy, false otherwise
@@ -97,7 +140,7 @@ export declare function eq(a: any, b: any): boolean;
 export declare function or(a: any, b: any): boolean;
 /**
  * Returns true if both of the passed arguments are truthy, false otherwise.
- *
+ * @group TemplateHelpers
  * @param a The first argument
  * @param b The second argument
  * @returns True if both of the arguments are truthy, false otherwise
@@ -108,7 +151,7 @@ export declare function and(a: any, b: any): boolean;
  * 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.
- *
+ * @group TemplateHelpers
  * @param a The value to check
  * @param b The array to check against
  * @returns True if the value is in the array, false otherwise
@@ -116,9 +159,9 @@ export declare function and(a: any, b: any): boolean;
 export declare function isIn(a: any, b: any[]): boolean;
 /**
  * Returns an array of the passed arguments. Useful with the "in" helper
- *
+ * @group TemplateHelpers
  * @returns An array of the passed arguments
  */
-export declare function array(): any[];
+export declare function array(...args: any[]): any[];
 export type HandlebarsHelpers = Record<string, Function>;
 export declare const GetHelpers: () => HandlebarsHelpers;

package/lib/types/helpers/NativeRequestBuilder.d.ts

@@ -1,5 +1,5 @@
 import { type INativeRequest } from '../models';
-import { ILogger } from '../services';
+import { type ILogger } from '../services';
 export type NativeRequestBuilderFn = () => NativeRequestBuilder;
 export type NativeRequestBuilder = {
     withVer: (ver: string) => NativeRequestBuilder;

package/lib/types/helpers/RequestBuilder.d.ts

@@ -1,5 +1,5 @@
 import { type IApp, type IBanner, type IBidRequest, type IDevice, type IGeoContext, type IImp, type INative, type INativeRequest, type IRegs, type ISite, type IUser, type IVideo } from '../models';
-import { ILogger } from '../services';
+import { type ILogger } from '../services';
 export type RequestBuilderFn = (zoneId: string, id?: string) => RequestBuilder;
 export type RequestWith<T> = (t: T) => RequestBuilder;
 export type RequestBuilder = {

package/lib/types/helpers/TryGet.d.ts

@@ -1,2 +1,2 @@
-import { Result } from '../services';
+import { type Result } from '../services';
 export declare const TryGet: <T>(get: () => T) => Result<T>;

package/lib/types/helpers/Window.d.ts

@@ -1,3 +1,3 @@
-import { INativeTemplateDelegateWindow } from '../models';
-import { Result } from '../services';
+import { type INativeTemplateDelegateWindow } from '../models';
+import { type Result } from '../services';
 export declare const GetWindowInfo: () => Result<INativeTemplateDelegateWindow>;

package/lib/types/helpers/response/Banner.d.ts

@@ -1,4 +1,4 @@
-import { IBuiltResponse } from './BuiltResponse';
+import { type IBuiltResponse } from './BuiltResponse';
 /**
  * A built banner response - includes the `adm` field for the banner as well as the rendered commerce media
  * clickthrough URL template, if applicable.

package/lib/types/helpers/response/BuiltResponse.d.ts

@@ -1,4 +1,4 @@
-import { IBid } from '../../models';
+import { type IBid } from '../../models';
 export declare const CreativeType: {
     readonly Banner: 0;
     readonly Video: 1;

package/lib/types/helpers/response/Carousel.d.ts

@@ -1,6 +1,6 @@
 import type { IBid, IBidRequest } from '../../models';
 import { type ILogger, type NonPersonalRecommenderFn, type PersonalRecommenderFn, type RequestBidsFn, type Result } from '../../services';
-import { EvaluateClickthroughTemplateFn } from '../../services/Template';
+import { type EvaluateClickthroughTemplateFn } from '../../services/Template';
 import type { GenerateSponsoredProductCardResponseFn, IBuiltProductCardResponse } from './ProductCard';
 export type BuildSponsoredCarouselFn = (request: IBidRequest) => Result<IBuiltCarousel>;
 export type BuildSponsoredCarouselFromInitialBidFn = (request: IBidRequest, initialBid: IBid) => Result<IBuiltCarousel>;

package/lib/types/helpers/response/Clickthrough.d.ts

@@ -1,3 +1,3 @@
 import type { ICompiledPublisherConfiguration, INativeTemplateDelegateWindow, IProductInformation } from '../../models';
-import { ILogger, Result } from '../../services';
+import { type ILogger, type Result } from '../../services';
 export declare const BuildClickthroughUrl: (logger: ILogger | undefined, windowInfo: INativeTemplateDelegateWindow, configuration: ICompiledPublisherConfiguration, product: IProductInformation) => Result<string>;

package/lib/types/helpers/response/ProductCard.d.ts

@@ -1,6 +1,6 @@
-import { IBid, ICompiledPublisherConfiguration, INativeResponse, INativeTemplateDelegateWindow, IProductInformation } from '../../models';
-import { AsyncResult, GetAllSponsoredProductFromNativeIdFn, ILogger } from '../../services';
-import { IBuiltResponse } from './BuiltResponse';
+import { type IBid, type ICompiledPublisherConfiguration, type INativeResponse, type INativeTemplateDelegateWindow, type IProductInformation } from '../../models';
+import { type AsyncResult, type GetAllSponsoredProductFromNativeIdFn, type ILogger } from '../../services';
+import { type IBuiltResponse } from './BuiltResponse';
 export type BuildAllSponsoredProductCardResponsesFn = (bids: IBid[]) => AsyncResult<IBuiltProductCardBidResponse[]>;
 export type GenerateSponsoredProductCardResponseFn = (bids: IBid[]) => AsyncGenerator<IBuiltProductCardBidResponse>;
 export interface ITracker {

package/lib/types/helpers/response/Video.d.ts

@@ -1,5 +1,5 @@
-import { IVast } from '../../models';
-import { IBuiltResponse } from './BuiltResponse';
+import type { IVast } from '../../models';
+import type { IBuiltResponse } from './BuiltResponse';
 /**
  * A built video response. The raw Vast XML response from the bidder has been parsed out into a structure object here.
  * @expandType IBuiltResponse

package/lib/types/services/Bidder.d.ts

@@ -1,6 +1,6 @@
-import { IBidRequest, IBidResponse } from '../models';
-import { ILogger } from './Logger';
-import { AsyncResult } from './Result';
+import type { IBidRequest, IBidResponse } from '../models';
+import { type ILogger } from './Logger';
+import { type AsyncResult } from './Result';
 export type RequestBidsFn = (request: IBidRequest) => AsyncResult<IBidResponse>;
 export declare const RequestBids: (logger: ILogger | undefined, url: string, accountId: string, siteId: string, locationId: string, channelId: string, bidRequest: IBidRequest) => AsyncResult<IBidResponse>;
 export declare class NoBidsError extends Error {