lifecycleion 0.0.20 → 0.0.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/README.md +39 -36
  2. package/dist/lib/event-emitter.cjs +195 -9
  3. package/dist/lib/event-emitter.cjs.map +1 -1
  4. package/dist/lib/event-emitter.js +195 -9
  5. package/dist/lib/event-emitter.js.map +1 -1
  6. package/dist/lib/global-event-target.cjs +217 -0
  7. package/dist/lib/global-event-target.cjs.map +1 -0
  8. package/dist/lib/global-event-target.d.cts +70 -0
  9. package/dist/lib/global-event-target.d.ts +70 -0
  10. package/dist/lib/global-event-target.js +189 -0
  11. package/dist/lib/global-event-target.js.map +1 -0
  12. package/dist/lib/http-client/index.cjs +554 -193
  13. package/dist/lib/http-client/index.cjs.map +1 -1
  14. package/dist/lib/http-client/index.d.cts +9 -3
  15. package/dist/lib/http-client/index.d.ts +9 -3
  16. package/dist/lib/http-client/index.js +554 -193
  17. package/dist/lib/http-client/index.js.map +1 -1
  18. package/dist/lib/http-client-mock/index.cjs +71 -10
  19. package/dist/lib/http-client-mock/index.cjs.map +1 -1
  20. package/dist/lib/http-client-mock/index.d.cts +50 -3
  21. package/dist/lib/http-client-mock/index.d.ts +50 -3
  22. package/dist/lib/http-client-mock/index.js +71 -10
  23. package/dist/lib/http-client-mock/index.js.map +1 -1
  24. package/dist/lib/http-client-node/index.cjs +98 -19
  25. package/dist/lib/http-client-node/index.cjs.map +1 -1
  26. package/dist/lib/http-client-node/index.d.cts +2 -2
  27. package/dist/lib/http-client-node/index.d.ts +2 -2
  28. package/dist/lib/http-client-node/index.js +98 -19
  29. package/dist/lib/http-client-node/index.js.map +1 -1
  30. package/dist/lib/http-client-xhr/index.cjs.map +1 -1
  31. package/dist/lib/http-client-xhr/index.d.cts +2 -2
  32. package/dist/lib/http-client-xhr/index.d.ts +2 -2
  33. package/dist/lib/http-client-xhr/index.js.map +1 -1
  34. package/dist/lib/lifecycle-manager/index.cjs +199 -13
  35. package/dist/lib/lifecycle-manager/index.cjs.map +1 -1
  36. package/dist/lib/lifecycle-manager/index.js +199 -13
  37. package/dist/lib/lifecycle-manager/index.js.map +1 -1
  38. package/dist/lib/logger/index.cjs +203 -21
  39. package/dist/lib/logger/index.cjs.map +1 -1
  40. package/dist/lib/logger/index.d.cts +5 -1
  41. package/dist/lib/logger/index.d.ts +5 -1
  42. package/dist/lib/logger/index.js +203 -21
  43. package/dist/lib/logger/index.js.map +1 -1
  44. package/dist/lib/lru-cache/index.cjs +195 -9
  45. package/dist/lib/lru-cache/index.cjs.map +1 -1
  46. package/dist/lib/lru-cache/index.js +195 -9
  47. package/dist/lib/lru-cache/index.js.map +1 -1
  48. package/dist/lib/process-signal-manager.cjs +199 -13
  49. package/dist/lib/process-signal-manager.cjs.map +1 -1
  50. package/dist/lib/process-signal-manager.js +199 -13
  51. package/dist/lib/process-signal-manager.js.map +1 -1
  52. package/dist/lib/promise-protected-resolver.cjs +195 -9
  53. package/dist/lib/promise-protected-resolver.cjs.map +1 -1
  54. package/dist/lib/promise-protected-resolver.js +195 -9
  55. package/dist/lib/promise-protected-resolver.js.map +1 -1
  56. package/dist/lib/retry-utils/index.cjs +195 -9
  57. package/dist/lib/retry-utils/index.cjs.map +1 -1
  58. package/dist/lib/retry-utils/index.js +195 -9
  59. package/dist/lib/retry-utils/index.js.map +1 -1
  60. package/dist/lib/safe-handle-callback.cjs +196 -18
  61. package/dist/lib/safe-handle-callback.cjs.map +1 -1
  62. package/dist/lib/safe-handle-callback.d.cts +14 -4
  63. package/dist/lib/safe-handle-callback.d.ts +14 -4
  64. package/dist/lib/safe-handle-callback.js +196 -18
  65. package/dist/lib/safe-handle-callback.js.map +1 -1
  66. package/dist/lib/single-event-observer.cjs +195 -9
  67. package/dist/lib/single-event-observer.cjs.map +1 -1
  68. package/dist/lib/single-event-observer.js +195 -9
  69. package/dist/lib/single-event-observer.js.map +1 -1
  70. package/dist/{types-6G59m8U9.d.cts → types-BFvpJPMt.d.cts} +71 -10
  71. package/dist/{types-CG10j6Lc.d.ts → types-BONtIhQ5.d.ts} +71 -10
  72. package/package.json +12 -2
@@ -1179,18 +1179,204 @@ function isFunction(value) {
1179
1179
  return typeof value === "function" || value instanceof Function;
1180
1180
  }
1181
1181
 
1182
+ // src/lib/global-event-target.ts
1183
+ var GLOBAL_KEY = "__lifecycleion_global_event_target__";
1184
+ var METHOD_NAMES = [
1185
+ "addEventListener",
1186
+ "removeEventListener",
1187
+ "dispatchEvent"
1188
+ ];
1189
+ var g = globalThis;
1190
+ function getState() {
1191
+ const value = readGlobal(GLOBAL_KEY);
1192
+ return value === UNREADABLE ? void 0 : asUsableState(value);
1193
+ }
1194
+ function asUsableState(value) {
1195
+ if (typeof value !== "object" || value === null) {
1196
+ return void 0;
1197
+ }
1198
+ return asUsableTarget(readMember(value, "target")) === null ? void 0 : value;
1199
+ }
1200
+ function asUsableTarget(value) {
1201
+ if (typeof value !== "object" || value === null) {
1202
+ return null;
1203
+ }
1204
+ for (const name of METHOD_NAMES) {
1205
+ if (typeof readMember(value, name) !== "function") {
1206
+ return null;
1207
+ }
1208
+ }
1209
+ return value;
1210
+ }
1211
+ function bindTargetMethods(target) {
1212
+ const bound = {};
1213
+ for (const name of METHOD_NAMES) {
1214
+ const method = readMember(target, name);
1215
+ if (typeof method !== "function") {
1216
+ return null;
1217
+ }
1218
+ let boundMethod;
1219
+ try {
1220
+ boundMethod = method.bind(target);
1221
+ } catch {
1222
+ return null;
1223
+ }
1224
+ if (typeof boundMethod !== "function") {
1225
+ return null;
1226
+ }
1227
+ bound[name] = boundMethod;
1228
+ }
1229
+ return bound;
1230
+ }
1231
+ function isStateInstalled(state) {
1232
+ return state !== void 0 && readMember(state, "isInstalled") === true;
1233
+ }
1234
+ function readStateTarget(state) {
1235
+ if (state === void 0) {
1236
+ return null;
1237
+ }
1238
+ return asUsableTarget(readMember(state, "target"));
1239
+ }
1240
+ var UNREADABLE = /* @__PURE__ */ Symbol("lifecycleion.unreadable");
1241
+ function readGlobal(name) {
1242
+ try {
1243
+ return g[name];
1244
+ } catch {
1245
+ return UNREADABLE;
1246
+ }
1247
+ }
1248
+ function readMember(source, key) {
1249
+ try {
1250
+ return source[key];
1251
+ } catch {
1252
+ return UNREADABLE;
1253
+ }
1254
+ }
1255
+ function probeMember(name) {
1256
+ const value = readGlobal(name);
1257
+ if (value === UNREADABLE) {
1258
+ return "hostile";
1259
+ }
1260
+ if (typeof value === "function") {
1261
+ return "usable";
1262
+ }
1263
+ return value === void 0 ? "absent" : "occupied";
1264
+ }
1265
+ function canDefineProperty(key) {
1266
+ const descriptor = Object.getOwnPropertyDescriptor(g, key);
1267
+ if (descriptor === void 0) {
1268
+ return Object.isExtensible(g);
1269
+ }
1270
+ return descriptor.configurable === true;
1271
+ }
1272
+ function installGlobalEventTarget() {
1273
+ const members = METHOD_NAMES.map((name) => probeMember(name));
1274
+ if (members.every((member) => member === "usable")) {
1275
+ return isStateInstalled(getState()) ? "already-installed" : "native";
1276
+ }
1277
+ if (members.some((member) => member !== "absent")) {
1278
+ return "partial";
1279
+ }
1280
+ const eventTargetConstructor = readGlobal("EventTarget");
1281
+ if (typeof eventTargetConstructor !== "function") {
1282
+ return "unsupported";
1283
+ }
1284
+ const isDefinable = [...METHOD_NAMES, GLOBAL_KEY].every(
1285
+ (key) => canDefineProperty(key)
1286
+ );
1287
+ if (!isDefinable) {
1288
+ return "blocked";
1289
+ }
1290
+ const existingState = getState();
1291
+ const defined = [];
1292
+ const priorStateDescriptor = Object.getOwnPropertyDescriptor(g, GLOBAL_KEY);
1293
+ const rollback = () => {
1294
+ for (const key of defined) {
1295
+ if (key === GLOBAL_KEY && priorStateDescriptor !== void 0) {
1296
+ try {
1297
+ Object.defineProperty(g, GLOBAL_KEY, priorStateDescriptor);
1298
+ } catch {
1299
+ }
1300
+ continue;
1301
+ }
1302
+ try {
1303
+ Reflect.deleteProperty(g, key);
1304
+ } catch {
1305
+ }
1306
+ }
1307
+ };
1308
+ const reusableTarget = readStateTarget(existingState);
1309
+ const reusableMethods = reusableTarget === null ? null : bindTargetMethods(reusableTarget);
1310
+ let state;
1311
+ let methods;
1312
+ try {
1313
+ if (existingState === void 0 || reusableMethods === null) {
1314
+ let target;
1315
+ try {
1316
+ target = new eventTargetConstructor();
1317
+ } catch {
1318
+ return "unsupported";
1319
+ }
1320
+ const freshMethods = bindTargetMethods(target);
1321
+ if (freshMethods === null) {
1322
+ return "unsupported";
1323
+ }
1324
+ state = { target, isInstalled: false };
1325
+ methods = freshMethods;
1326
+ Object.defineProperty(g, GLOBAL_KEY, {
1327
+ value: state,
1328
+ enumerable: false,
1329
+ writable: false,
1330
+ configurable: true
1331
+ });
1332
+ defined.push(GLOBAL_KEY);
1333
+ } else {
1334
+ state = existingState;
1335
+ methods = reusableMethods;
1336
+ }
1337
+ for (const name of METHOD_NAMES) {
1338
+ Object.defineProperty(g, name, {
1339
+ value: methods[name],
1340
+ enumerable: false,
1341
+ writable: true,
1342
+ configurable: true
1343
+ });
1344
+ defined.push(name);
1345
+ }
1346
+ if (readMember(state, "isInstalled") !== true) {
1347
+ state.isInstalled = true;
1348
+ }
1349
+ } catch {
1350
+ rollback();
1351
+ return "blocked";
1352
+ }
1353
+ return "installed";
1354
+ }
1355
+ function isGlobalEventTargetAvailable() {
1356
+ return METHOD_NAMES.every((name) => probeMember(name) === "usable") && probeMember("ErrorEvent") === "usable";
1357
+ }
1358
+
1182
1359
  // src/lib/safe-handle-callback.ts
1360
+ installGlobalEventTarget();
1361
+ function reportCallbackError(callbackName, error) {
1362
+ installGlobalEventTarget();
1363
+ if (!isGlobalEventTargetAvailable()) {
1364
+ return;
1365
+ }
1366
+ try {
1367
+ globalThis.dispatchEvent(
1368
+ new ErrorEvent("reportError", {
1369
+ error: new Error(
1370
+ `Error in a callback ${callbackName}: ${DOUBLE_EOL}${errorToString(error)}`
1371
+ )
1372
+ })
1373
+ );
1374
+ } catch {
1375
+ }
1376
+ }
1183
1377
  function safeHandleCallback(callbackName, callback, ...args) {
1184
1378
  const handleError = (error) => {
1185
- if (typeof globalThis.dispatchEvent === "function") {
1186
- globalThis.dispatchEvent(
1187
- new ErrorEvent("reportError", {
1188
- error: new Error(
1189
- `Error in a callback ${callbackName}: ${DOUBLE_EOL}${errorToString(error)}`
1190
- )
1191
- })
1192
- );
1193
- }
1379
+ reportCallbackError(callbackName, error);
1194
1380
  };
1195
1381
  if (isFunction(callback)) {
1196
1382
  try {