Auto-commit 2026-05-02 09:37

This commit is contained in:
2026-05-02 09:37:34 -04:00
parent b7600fa937
commit 35d004cde3
3809 changed files with 2315945 additions and 106 deletions

21
node_modules/@segment/analytics-generic-utils/LICENSE generated vendored Normal file
View File

@@ -0,0 +1,21 @@
The MIT License (MIT)
Copyright © 2023 Segment
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

View File

@@ -0,0 +1,3 @@
# @segment/analytics-generic-utils
This monorepo's version of "lodash". This package contains shared generic utilities that can be used within the ecosystem. This package should not have dependencies, and should not contain any references to the Analytics domain.

View File

@@ -0,0 +1,21 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.createDeferred = void 0;
/**
* Return a promise that can be externally resolved
*/
var createDeferred = function () {
var resolve;
var reject;
var promise = new Promise(function (_resolve, _reject) {
resolve = _resolve;
reject = _reject;
});
return {
resolve: resolve,
reject: reject,
promise: promise,
};
};
exports.createDeferred = createDeferred;
//# sourceMappingURL=create-deferred.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"create-deferred.js","sourceRoot":"","sources":["../../../src/create-deferred/create-deferred.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACI,IAAM,cAAc,GAAG;IAC5B,IAAI,OAA6C,CAAA;IACjD,IAAI,MAA8B,CAAA;IAClC,IAAM,OAAO,GAAG,IAAI,OAAO,CAAI,UAAC,QAAQ,EAAE,OAAO;QAC/C,OAAO,GAAG,QAAQ,CAAA;QAClB,MAAM,GAAG,OAAO,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,OAAO;QACL,OAAO,SAAA;QACP,MAAM,QAAA;QACN,OAAO,SAAA;KACR,CAAA;AACH,CAAC,CAAA;AAZY,QAAA,cAAc,kBAY1B"}

View File

@@ -0,0 +1,5 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
var tslib_1 = require("tslib");
tslib_1.__exportStar(require("./create-deferred"), exports);
//# sourceMappingURL=index.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/create-deferred/index.ts"],"names":[],"mappings":";;;AAAA,4DAAiC"}

View File

@@ -0,0 +1,80 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.Emitter = void 0;
/**
* Event Emitter that takes the expected contract as a generic
* @example
* ```ts
* type Contract = {
* delivery_success: [DeliverySuccessResponse, Metrics],
* delivery_failure: [DeliveryError]
* }
* new Emitter<Contract>()
* .on('delivery_success', (res, metrics) => ...)
* .on('delivery_failure', (err) => ...)
* ```
*/
var Emitter = /** @class */ (function () {
function Emitter(options) {
var _a;
this.callbacks = {};
this.warned = false;
this.maxListeners = (_a = options === null || options === void 0 ? void 0 : options.maxListeners) !== null && _a !== void 0 ? _a : 10;
}
Emitter.prototype.warnIfPossibleMemoryLeak = function (event) {
if (this.warned) {
return;
}
if (this.maxListeners &&
this.callbacks[event].length > this.maxListeners) {
console.warn("Event Emitter: Possible memory leak detected; ".concat(String(event), " has exceeded ").concat(this.maxListeners, " listeners."));
this.warned = true;
}
};
Emitter.prototype.on = function (event, callback) {
if (!this.callbacks[event]) {
this.callbacks[event] = [callback];
}
else {
this.callbacks[event].push(callback);
this.warnIfPossibleMemoryLeak(event);
}
return this;
};
Emitter.prototype.once = function (event, callback) {
var _this = this;
var on = function () {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
_this.off(event, on);
callback.apply(_this, args);
};
this.on(event, on);
return this;
};
Emitter.prototype.off = function (event, callback) {
var _a;
var fns = (_a = this.callbacks[event]) !== null && _a !== void 0 ? _a : [];
var without = fns.filter(function (fn) { return fn !== callback; });
this.callbacks[event] = without;
return this;
};
Emitter.prototype.emit = function (event) {
var _this = this;
var _a;
var args = [];
for (var _i = 1; _i < arguments.length; _i++) {
args[_i - 1] = arguments[_i];
}
var callbacks = (_a = this.callbacks[event]) !== null && _a !== void 0 ? _a : [];
callbacks.forEach(function (callback) {
callback.apply(_this, args);
});
return this;
};
return Emitter;
}());
exports.Emitter = Emitter;
//# sourceMappingURL=emitter.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../../src/emitter/emitter.ts"],"names":[],"mappings":";;;AAWA;;;;;;;;;;;;GAYG;AACH;IAEE,iBAAY,OAAwB;;QAG5B,cAAS,GAAsB,EAAE,CAAA;QACjC,WAAM,GAAG,KAAK,CAAA;QAHpB,IAAI,CAAC,YAAY,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,mCAAI,EAAE,CAAA;IACjD,CAAC;IAIO,0CAAwB,GAAhC,UACE,KAAgB;QAEhB,IAAI,IAAI,CAAC,MAAM,EAAE;YACf,OAAM;SACP;QACD,IACE,IAAI,CAAC,YAAY;YACjB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EACjD;YACA,OAAO,CAAC,IAAI,CACV,wDAAiD,MAAM,CACrD,KAAK,CACN,2BAAiB,IAAI,CAAC,YAAY,gBAAa,CACjD,CAAA;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;SACnB;IACH,CAAC;IAED,oBAAE,GAAF,UACE,KAAgB,EAChB,QAAgD;QAEhD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;YAC1B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAwB,CAAA;SAC1D;aAAM;YACL,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACrC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAA;SACrC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sBAAI,GAAJ,UACE,KAAgB,EAChB,QAAgD;QAFlD,iBAWC;QAPC,IAAM,EAAE,GAAG;YAAC,cAA4B;iBAA5B,UAA4B,EAA5B,qBAA4B,EAA5B,IAA4B;gBAA5B,yBAA4B;;YACtC,KAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YACnB,QAAQ,CAAC,KAAK,CAAC,KAAI,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC,CAAA;QAED,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qBAAG,GAAH,UACE,KAAgB,EAChB,QAAgD;;QAEhD,IAAM,GAAG,GAAG,MAAA,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAA;QACvC,IAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,UAAC,EAAE,IAAK,OAAA,EAAE,KAAK,QAAQ,EAAf,CAAe,CAAwB,CAAA;QAC1E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sBAAI,GAAJ,UACE,KAAgB;QADlB,iBASC;;QAPC,cAA4B;aAA5B,UAA4B,EAA5B,qBAA4B,EAA5B,IAA4B;YAA5B,6BAA4B;;QAE5B,IAAM,SAAS,GAAG,MAAA,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAA;QAC7C,SAAS,CAAC,OAAO,CAAC,UAAC,QAAQ;YACzB,QAAQ,CAAC,KAAK,CAAC,KAAI,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IACH,cAAC;AAAD,CAAC,AAzED,IAyEC;AAzEY,0BAAO"}

View File

@@ -0,0 +1,5 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
var tslib_1 = require("tslib");
tslib_1.__exportStar(require("./emitter"), exports);
//# sourceMappingURL=index.js.map

View File

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

View File

@@ -0,0 +1,6 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
var tslib_1 = require("tslib");
tslib_1.__exportStar(require("./create-deferred"), exports);
tslib_1.__exportStar(require("./emitter"), exports);
//# sourceMappingURL=index.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAiC;AACjC,oDAAyB"}

View File

@@ -0,0 +1,17 @@
/**
* Return a promise that can be externally resolved
*/
export var createDeferred = function () {
var resolve;
var reject;
var promise = new Promise(function (_resolve, _reject) {
resolve = _resolve;
reject = _reject;
});
return {
resolve: resolve,
reject: reject,
promise: promise,
};
};
//# sourceMappingURL=create-deferred.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"create-deferred.js","sourceRoot":"","sources":["../../../src/create-deferred/create-deferred.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,IAAM,cAAc,GAAG;IAC5B,IAAI,OAA6C,CAAA;IACjD,IAAI,MAA8B,CAAA;IAClC,IAAM,OAAO,GAAG,IAAI,OAAO,CAAI,UAAC,QAAQ,EAAE,OAAO;QAC/C,OAAO,GAAG,QAAQ,CAAA;QAClB,MAAM,GAAG,OAAO,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,OAAO;QACL,OAAO,SAAA;QACP,MAAM,QAAA;QACN,OAAO,SAAA;KACR,CAAA;AACH,CAAC,CAAA"}

View File

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

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/create-deferred/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

View File

@@ -0,0 +1,77 @@
/**
* Event Emitter that takes the expected contract as a generic
* @example
* ```ts
* type Contract = {
* delivery_success: [DeliverySuccessResponse, Metrics],
* delivery_failure: [DeliveryError]
* }
* new Emitter<Contract>()
* .on('delivery_success', (res, metrics) => ...)
* .on('delivery_failure', (err) => ...)
* ```
*/
var Emitter = /** @class */ (function () {
function Emitter(options) {
var _a;
this.callbacks = {};
this.warned = false;
this.maxListeners = (_a = options === null || options === void 0 ? void 0 : options.maxListeners) !== null && _a !== void 0 ? _a : 10;
}
Emitter.prototype.warnIfPossibleMemoryLeak = function (event) {
if (this.warned) {
return;
}
if (this.maxListeners &&
this.callbacks[event].length > this.maxListeners) {
console.warn("Event Emitter: Possible memory leak detected; ".concat(String(event), " has exceeded ").concat(this.maxListeners, " listeners."));
this.warned = true;
}
};
Emitter.prototype.on = function (event, callback) {
if (!this.callbacks[event]) {
this.callbacks[event] = [callback];
}
else {
this.callbacks[event].push(callback);
this.warnIfPossibleMemoryLeak(event);
}
return this;
};
Emitter.prototype.once = function (event, callback) {
var _this = this;
var on = function () {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
_this.off(event, on);
callback.apply(_this, args);
};
this.on(event, on);
return this;
};
Emitter.prototype.off = function (event, callback) {
var _a;
var fns = (_a = this.callbacks[event]) !== null && _a !== void 0 ? _a : [];
var without = fns.filter(function (fn) { return fn !== callback; });
this.callbacks[event] = without;
return this;
};
Emitter.prototype.emit = function (event) {
var _this = this;
var _a;
var args = [];
for (var _i = 1; _i < arguments.length; _i++) {
args[_i - 1] = arguments[_i];
}
var callbacks = (_a = this.callbacks[event]) !== null && _a !== void 0 ? _a : [];
callbacks.forEach(function (callback) {
callback.apply(_this, args);
});
return this;
};
return Emitter;
}());
export { Emitter };
//# sourceMappingURL=emitter.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../../src/emitter/emitter.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH;IAEE,iBAAY,OAAwB;;QAG5B,cAAS,GAAsB,EAAE,CAAA;QACjC,WAAM,GAAG,KAAK,CAAA;QAHpB,IAAI,CAAC,YAAY,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,mCAAI,EAAE,CAAA;IACjD,CAAC;IAIO,0CAAwB,GAAhC,UACE,KAAgB;QAEhB,IAAI,IAAI,CAAC,MAAM,EAAE;YACf,OAAM;SACP;QACD,IACE,IAAI,CAAC,YAAY;YACjB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EACjD;YACA,OAAO,CAAC,IAAI,CACV,wDAAiD,MAAM,CACrD,KAAK,CACN,2BAAiB,IAAI,CAAC,YAAY,gBAAa,CACjD,CAAA;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;SACnB;IACH,CAAC;IAED,oBAAE,GAAF,UACE,KAAgB,EAChB,QAAgD;QAEhD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;YAC1B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAwB,CAAA;SAC1D;aAAM;YACL,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACrC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAA;SACrC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sBAAI,GAAJ,UACE,KAAgB,EAChB,QAAgD;QAFlD,iBAWC;QAPC,IAAM,EAAE,GAAG;YAAC,cAA4B;iBAA5B,UAA4B,EAA5B,qBAA4B,EAA5B,IAA4B;gBAA5B,yBAA4B;;YACtC,KAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YACnB,QAAQ,CAAC,KAAK,CAAC,KAAI,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC,CAAA;QAED,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qBAAG,GAAH,UACE,KAAgB,EAChB,QAAgD;;QAEhD,IAAM,GAAG,GAAG,MAAA,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAA;QACvC,IAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,UAAC,EAAE,IAAK,OAAA,EAAE,KAAK,QAAQ,EAAf,CAAe,CAAwB,CAAA;QAC1E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sBAAI,GAAJ,UACE,KAAgB;QADlB,iBASC;;QAPC,cAA4B;aAA5B,UAA4B,EAA5B,qBAA4B,EAA5B,IAA4B;YAA5B,6BAA4B;;QAE5B,IAAM,SAAS,GAAG,MAAA,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAA;QAC7C,SAAS,CAAC,OAAO,CAAC,UAAC,QAAQ;YACzB,QAAQ,CAAC,KAAK,CAAC,KAAI,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IACH,cAAC;AAAD,CAAC,AAzED,IAyEC"}

View File

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

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/emitter/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

View File

@@ -0,0 +1,3 @@
export * from './create-deferred';
export * from './emitter';
//# sourceMappingURL=index.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA"}

View File

@@ -0,0 +1,9 @@
/**
* Return a promise that can be externally resolved
*/
export declare const createDeferred: <T>() => {
resolve: (value: T | PromiseLike<T>) => void;
reject: (reason: any) => void;
promise: Promise<T>;
};
//# sourceMappingURL=create-deferred.d.ts.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"create-deferred.d.ts","sourceRoot":"","sources":["../../../src/create-deferred/create-deferred.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc;4CACoB,IAAI;qBAC3B,GAAG,KAAK,IAAI;;CAUnC,CAAA"}

View File

@@ -0,0 +1,2 @@
export * from './create-deferred';
//# sourceMappingURL=index.d.ts.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/create-deferred/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

View File

@@ -0,0 +1,35 @@
type EventName = string;
type EventFnArgs = any[];
type EmitterContract = Record<EventName, EventFnArgs>;
export interface EmitterOptions {
/** How many event listeners for a particular event before emitting a warning (0 = disabled)
* @default 10
**/
maxListeners?: number;
}
/**
* Event Emitter that takes the expected contract as a generic
* @example
* ```ts
* type Contract = {
* delivery_success: [DeliverySuccessResponse, Metrics],
* delivery_failure: [DeliveryError]
* }
* new Emitter<Contract>()
* .on('delivery_success', (res, metrics) => ...)
* .on('delivery_failure', (err) => ...)
* ```
*/
export declare class Emitter<Contract extends EmitterContract = EmitterContract> {
maxListeners: number;
constructor(options?: EmitterOptions);
private callbacks;
private warned;
private warnIfPossibleMemoryLeak;
on<EventName extends keyof Contract>(event: EventName, callback: (...args: Contract[EventName]) => void): this;
once<EventName extends keyof Contract>(event: EventName, callback: (...args: Contract[EventName]) => void): this;
off<EventName extends keyof Contract>(event: EventName, callback: (...args: Contract[EventName]) => void): this;
emit<EventName extends keyof Contract>(event: EventName, ...args: Contract[EventName]): this;
}
export {};
//# sourceMappingURL=emitter.d.ts.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../../src/emitter/emitter.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,MAAM,CAAA;AACvB,KAAK,WAAW,GAAG,GAAG,EAAE,CAAA;AACxB,KAAK,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B;;QAEI;IACJ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,OAAO,CAAC,QAAQ,SAAS,eAAe,GAAG,eAAe;IACrE,YAAY,EAAE,MAAM,CAAA;gBACR,OAAO,CAAC,EAAE,cAAc;IAGpC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,MAAM,CAAQ;IAEtB,OAAO,CAAC,wBAAwB;IAmBhC,EAAE,CAAC,SAAS,SAAS,MAAM,QAAQ,EACjC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,GAC/C,IAAI;IAUP,IAAI,CAAC,SAAS,SAAS,MAAM,QAAQ,EACnC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,GAC/C,IAAI;IAUP,GAAG,CAAC,SAAS,SAAS,MAAM,QAAQ,EAClC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,GAC/C,IAAI;IAOP,IAAI,CAAC,SAAS,SAAS,MAAM,QAAQ,EACnC,KAAK,EAAE,SAAS,EAChB,GAAG,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC3B,IAAI;CAOR"}

View File

@@ -0,0 +1,2 @@
export * from './emitter';
//# sourceMappingURL=index.d.ts.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/emitter/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

View File

@@ -0,0 +1,3 @@
export * from './create-deferred';
export * from './emitter';
//# sourceMappingURL=index.d.ts.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA"}

View File

@@ -0,0 +1,39 @@
{
"name": "@segment/analytics-generic-utils",
"version": "1.1.1",
"repository": {
"type": "git",
"url": "https://github.com/segmentio/analytics-next",
"directory": "packages/generic-utils"
},
"license": "MIT",
"main": "./dist/cjs/index.js",
"module": "./dist/esm/index.js",
"types": "./dist/types/index.d.ts",
"files": [
"dist/",
"src/",
"!**/__tests__/**",
"!*.tsbuildinfo",
"LICENSE"
],
"sideEffects": false,
"scripts": {
".": "yarn run -T turbo run --filter=@segment/analytics-generic-utils",
"test": "yarn jest",
"lint": "yarn concurrently 'yarn:eslint .' 'yarn:tsc --noEmit'",
"build": "yarn concurrently 'yarn:build:*'",
"build:esm": "yarn tsc -p tsconfig.build.json",
"build:cjs": "yarn tsc -p tsconfig.build.json --outDir ./dist/cjs --module commonjs",
"watch": "yarn build:esm --watch",
"watch:test": "yarn test --watch",
"tsc": "yarn run -T tsc",
"eslint": "yarn run -T eslint",
"concurrently": "yarn run -T concurrently",
"jest": "yarn run -T jest"
},
"packageManager": "yarn@3.4.1",
"dependencies": {
"tslib": "^2.4.1"
}
}

View File

@@ -0,0 +1,16 @@
/**
* Return a promise that can be externally resolved
*/
export const createDeferred = <T>() => {
let resolve!: (value: T | PromiseLike<T>) => void
let reject!: (reason: any) => void
const promise = new Promise<T>((_resolve, _reject) => {
resolve = _resolve
reject = _reject
})
return {
resolve,
reject,
promise,
}
}

View File

@@ -0,0 +1 @@
export * from './create-deferred'

View File

@@ -0,0 +1,98 @@
type EventName = string
type EventFnArgs = any[]
type EmitterContract = Record<EventName, EventFnArgs>
export interface EmitterOptions {
/** How many event listeners for a particular event before emitting a warning (0 = disabled)
* @default 10
**/
maxListeners?: number
}
/**
* Event Emitter that takes the expected contract as a generic
* @example
* ```ts
* type Contract = {
* delivery_success: [DeliverySuccessResponse, Metrics],
* delivery_failure: [DeliveryError]
* }
* new Emitter<Contract>()
* .on('delivery_success', (res, metrics) => ...)
* .on('delivery_failure', (err) => ...)
* ```
*/
export class Emitter<Contract extends EmitterContract = EmitterContract> {
maxListeners: number
constructor(options?: EmitterOptions) {
this.maxListeners = options?.maxListeners ?? 10
}
private callbacks: Partial<Contract> = {}
private warned = false
private warnIfPossibleMemoryLeak<EventName extends keyof Contract>(
event: EventName
) {
if (this.warned) {
return
}
if (
this.maxListeners &&
this.callbacks[event]!.length > this.maxListeners
) {
console.warn(
`Event Emitter: Possible memory leak detected; ${String(
event
)} has exceeded ${this.maxListeners} listeners.`
)
this.warned = true
}
}
on<EventName extends keyof Contract>(
event: EventName,
callback: (...args: Contract[EventName]) => void
): this {
if (!this.callbacks[event]) {
this.callbacks[event] = [callback] as Contract[EventName]
} else {
this.callbacks[event]!.push(callback)
this.warnIfPossibleMemoryLeak(event)
}
return this
}
once<EventName extends keyof Contract>(
event: EventName,
callback: (...args: Contract[EventName]) => void
): this {
const on = (...args: Contract[EventName]): void => {
this.off(event, on)
callback.apply(this, args)
}
this.on(event, on)
return this
}
off<EventName extends keyof Contract>(
event: EventName,
callback: (...args: Contract[EventName]) => void
): this {
const fns = this.callbacks[event] ?? []
const without = fns.filter((fn) => fn !== callback) as Contract[EventName]
this.callbacks[event] = without
return this
}
emit<EventName extends keyof Contract>(
event: EventName,
...args: Contract[EventName]
): this {
const callbacks = this.callbacks[event] ?? []
callbacks.forEach((callback) => {
callback.apply(this, args)
})
return this
}
}

View File

@@ -0,0 +1 @@
export * from './emitter'

View File

@@ -0,0 +1,2 @@
export * from './create-deferred'
export * from './emitter'