@xylabs/events 4.13.15 → 4.13.17

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.
package/README.md CHANGED
@@ -1,63 +1,54 @@
1
- [![logo][]](https://xylabs.com)
2
-
3
1
  # @xylabs/events
4
2
 
3
+ [![logo][]](https://xylabs.com)
4
+
5
+ [![main-build][]][main-build-link]
5
6
  [![npm-badge][]][npm-link]
6
7
  [![npm-downloads-badge][]][npm-link]
7
8
  [![jsdelivr-badge][]][jsdelivr-link]
8
9
  [![npm-license-badge][]](LICENSE)
10
+ [![codacy-badge][]][codacy-link]
11
+ [![codeclimate-badge][]][codeclimate-link]
12
+ [![snyk-badge][]][snyk-link]
9
13
  [![socket-badge][]][socket-link]
10
14
 
11
- > XY Labs generalized Javascript library
12
-
13
- ## Table of Contents
14
-
15
- - [Description](#description)
16
- - [Install](#install)
17
- - [Maintainers](#maintainers)
18
- - [License](#license)
19
- - [Credits](#credits)
20
-
21
- ## Description
15
+ Version: 4.13.15
22
16
 
23
- Common Javascript code that is used throughout XYO projects that use React.
17
+ Primary SDK for using XYO Protocol 2.0
24
18
 
25
- ## Install
26
-
27
- Using npm:
28
-
29
- ```sh
30
- npm i --save @xylabs/events
31
- ```
19
+ ## Documentation
32
20
 
33
- Using yarn:
21
+ Coming Soon!
34
22
 
35
- ```sh
36
- yarn add @xylabs/events
37
- ```
38
-
39
- ## Documentation
40
- [Developer Reference](https://xylabs.github.io/sdk-js)
23
+ Part of [sdk-js](https://www.npmjs.com/package/@xyo-network/sdk-js)
41
24
 
42
25
  ## Maintainers
43
26
 
44
27
  - [Arie Trouw](https://github.com/arietrouw) ([arietrouw.com](https://arietrouw.com))
45
- - [Joel Carter](https://github.com/JoelBCarter)
46
28
  - [Matt Jones](https://github.com/jonesmac)
29
+ - [Joel Carter](https://github.com/JoelBCarter)
47
30
  - [Jordan Trouw](https://github.com/jordantrouw)
48
31
 
49
32
  ## License
50
33
 
51
- See the [LICENSE](LICENSE) file for license details
34
+ > See the [LICENSE](LICENSE) file for license details
52
35
 
53
36
  ## Credits
54
37
 
55
- [Made with 🔥and ❄️ by XY Labs](https://xylabs.com)
38
+ [Made with 🔥 and ❄️ by XYLabs](https://xylabs.com)
56
39
 
57
40
  [logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
58
41
 
42
+ [main-build]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml/badge.svg
43
+ [main-build-link]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml
59
44
  [npm-badge]: https://img.shields.io/npm/v/@xylabs/events.svg
60
45
  [npm-link]: https://www.npmjs.com/package/@xylabs/events
46
+ [codacy-badge]: https://app.codacy.com/project/badge/Grade/c8e15e14f37741c18cfb47ac7245c698
47
+ [codacy-link]: https://www.codacy.com/gh/xylabs/sdk-js/dashboard?utm_source=github.com&utm_medium=referral&utm_content=xylabs/sdk-js&utm_campaign=Badge_Grade
48
+ [codeclimate-badge]: https://api.codeclimate.com/v1/badges/c5eb068f806f0b047ea7/maintainability
49
+ [codeclimate-link]: https://codeclimate.com/github/xylabs/sdk-js/maintainability
50
+ [snyk-badge]: https://snyk.io/test/github/xylabs/sdk-js/badge.svg?targetFile=package.json
51
+ [snyk-link]: https://snyk.io/test/github/xylabs/sdk-js?targetFile=package.json
61
52
 
62
53
  [npm-downloads-badge]: https://img.shields.io/npm/dw/@xylabs/events
63
54
  [npm-license-badge]: https://img.shields.io/npm/l/@xylabs/events
@@ -0,0 +1,2 @@
1
+ import '@xylabs/vitest-extended';
2
+ //# sourceMappingURL=Events.spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Events.spec.d.ts","sourceRoot":"","sources":["../../../../src/Events/spec/Events.spec.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAA"}
@@ -0,0 +1,2 @@
1
+ import '@xylabs/vitest-extended';
2
+ //# sourceMappingURL=GenericEvents.spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GenericEvents.spec.d.ts","sourceRoot":"","sources":["../../../../src/Events/spec/GenericEvents.spec.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAA"}
@@ -1,108 +1,4 @@
1
- import { BaseParams, Base } from '@xylabs/base';
2
- import { EmptyObject } from '@xylabs/object';
3
- import { Promisable } from '@xylabs/promise';
4
-
5
- type EventName = PropertyKey;
6
- type EventArgs = string | number | object;
7
- type EventData = {
8
- [key: EventName]: EventArgs;
9
- };
10
- type EventUnsubscribeFunction = () => void;
11
- type EventAnyListener<TEventArgs extends EventArgs = EventArgs> = (eventName: EventName, eventData: TEventArgs) => Promisable<void>;
12
- type EventListener<TEventArgs extends EventArgs = EventArgs> = (eventData: TEventArgs) => Promisable<void>;
13
-
14
- interface EventEmitter<T extends EventData> {
15
- eventData: T;
16
- clearListeners(eventNames: keyof T | (keyof T)[]): void;
17
- emit<TEventName extends keyof T>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
18
- emitSerial<TEventName extends keyof T>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
19
- listenerCount(eventNames: keyof T | (keyof T)[]): number;
20
- off<TEventName extends keyof T>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): void;
21
- offAny(listener: EventAnyListener | Promise<void>): void;
22
- on<TEventName extends keyof T>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
23
- onAny(listener: EventAnyListener): EventUnsubscribeFunction;
24
- once<TEventName extends keyof T>(eventName: TEventName, listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
25
- }
26
-
27
- interface BaseEmitterParamsFields {
28
- }
29
- type BaseEmitterParams<T extends EmptyObject = EmptyObject> = BaseParams<T & BaseEmitterParamsFields & T>;
30
- declare class BaseEmitter<TParams extends BaseParams = BaseParams, TEventData extends EventData = EventData> extends Base<TParams> implements EventEmitter<TEventData> {
31
- eventData: TEventData;
32
- private events;
33
- constructor(params: BaseParams<TParams>);
34
- clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]): this;
35
- emit<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
36
- emitSerial<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
37
- listenerCount(eventNames: keyof TEventData | (keyof TEventData)[]): number;
38
- off<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): void;
39
- offAny(listener: EventAnyListener): void;
40
- on<TEventName extends keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): () => void;
41
- onAny(listener: EventAnyListener): () => void;
42
- once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): () => void;
43
- }
44
-
45
- /**
46
- Emittery can collect and log debug information.
47
-
48
- To enable this feature set the `DEBUG` environment variable to `emittery` or `*`. Additionally, you can set the static `isDebugEnabled` variable to true
49
- on the Emittery class, or `myEmitter.debug.enabled` on an instance of it for debugging a single instance.
50
-
51
- See API for more information on how debugging works.
52
- */
53
- type DebugLogger = (type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => void;
54
- type EventListenerInfo<TEventArgs extends EventArgs = EventArgs> = {
55
- filter?: TEventArgs;
56
- listener: EventListener<TEventArgs>;
57
- };
58
- /**
59
- Configure debug options of an instance.
60
- */
61
- type DebugOptions = {
62
- enabled?: boolean;
63
- logger?: DebugLogger;
64
- readonly name: string;
65
- };
66
- type MetaEventData<TEventData extends EventData> = {
67
- listenerAdded: {
68
- eventName?: keyof TEventData;
69
- listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>;
70
- };
71
- listenerRemoved: {
72
- eventName?: keyof TEventData;
73
- listener: EventListener<TEventData[keyof TEventData]> | EventAnyListener<TEventData[keyof TEventData]>;
74
- };
75
- };
76
- type EventsParams = BaseParams<{
77
- readonly debug?: DebugOptions;
78
- }>;
79
- declare class Events<TEventData extends EventData = EventData> extends Base<EventsParams> implements EventEmitter<TEventData> {
80
- protected static anyMap: WeakMap<object, Set<EventAnyListener>>;
81
- protected static eventsMap: WeakMap<object, Map<PropertyKey, Set<EventListenerInfo<EventArgs>>>>;
82
- private static canEmitMetaEvents;
83
- private static isGlobalDebugEnabled;
84
- eventData: TEventData;
85
- constructor(params?: EventsParams);
86
- static get isDebugEnabled(): boolean;
87
- static set isDebugEnabled(newValue: boolean);
88
- get debug(): DebugOptions | undefined;
89
- clearListeners(eventNames: keyof TEventData | (keyof TEventData)[]): void;
90
- emit<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
91
- emitMetaEvent<TEventName extends keyof MetaEventData<TEventData>>(eventName: TEventName, eventArgs: MetaEventData<TEventData>[TEventName]): Promise<boolean | undefined>;
92
- emitSerial<TEventName extends keyof TEventData>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
93
- listenerCount(eventNames?: keyof TEventData | (keyof TEventData)[]): number;
94
- logIfDebugEnabled<TEventName extends EventName>(type: string, eventName?: TEventName, eventArgs?: EventArgs): void;
95
- off<TEventName extends keyof TEventData, TEventListener = EventListener<TEventData[TEventName]>>(eventNames: TEventName | TEventName[], listener: TEventListener): void;
96
- offAny(listener: EventAnyListener): void;
97
- on<TEventName extends keyof TEventData = keyof TEventData>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>, filter?: TEventData[TEventName]): () => void;
98
- onAny(listener: EventAnyListener): () => void;
99
- once<TEventName extends keyof TEventData>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): () => void;
100
- private emitInternal;
101
- private emitMetaEventInternal;
102
- private getListeners;
103
- private safeCallAnyListener;
104
- private safeCallListener;
105
- }
106
-
107
- export { BaseEmitter, Events };
108
- export type { BaseEmitterParams, BaseEmitterParamsFields, DebugLogger, DebugOptions, EventAnyListener, EventArgs, EventData, EventEmitter, EventListener, EventListenerInfo, EventName, EventUnsubscribeFunction, EventsParams, MetaEventData };
1
+ export * from './BaseEmitter.ts';
2
+ export * from './Events/index.ts';
3
+ export * from './model/index.ts';
4
+ //# sourceMappingURL=index.d.ts.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xylabs/events",
3
- "version": "4.13.15",
3
+ "version": "4.13.17",
4
4
  "description": "Primary SDK for using XYO Protocol 2.0",
5
5
  "homepage": "https://xyo.network",
6
6
  "bugs": {
@@ -30,19 +30,19 @@
30
30
  "source": "./src/index.ts",
31
31
  "types": "dist/neutral/index.d.ts",
32
32
  "dependencies": {
33
- "@xylabs/assert": "^4.13.15",
34
- "@xylabs/base": "^4.13.15",
35
- "@xylabs/error": "^4.13.15",
36
- "@xylabs/forget": "^4.13.15",
37
- "@xylabs/object": "^4.13.15",
38
- "@xylabs/promise": "^4.13.15",
39
- "@xylabs/typeof": "^4.13.15"
33
+ "@xylabs/assert": "^4.13.17",
34
+ "@xylabs/base": "^4.13.17",
35
+ "@xylabs/error": "^4.13.17",
36
+ "@xylabs/forget": "^4.13.17",
37
+ "@xylabs/object": "^4.13.17",
38
+ "@xylabs/promise": "^4.13.17",
39
+ "@xylabs/typeof": "^4.13.17"
40
40
  },
41
41
  "devDependencies": {
42
- "@xylabs/delay": "^4.13.15",
43
- "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.20",
44
- "@xylabs/tsconfig": "^7.0.0-rc.20",
45
- "@xylabs/vitest-extended": "^4.13.15",
42
+ "@xylabs/delay": "^4.13.17",
43
+ "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.27",
44
+ "@xylabs/tsconfig": "^7.0.0-rc.27",
45
+ "@xylabs/vitest-extended": "^4.13.17",
46
46
  "typescript": "^5.8.3",
47
47
  "vitest": "^3.2.4"
48
48
  },
@@ -1,4 +0,0 @@
1
- export * from './BaseEmitter.ts';
2
- export * from './Events/index.ts';
3
- export * from './model/index.ts';
4
- //# sourceMappingURL=index.d.ts.map
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes