@eleven-am/pondsocket-nest 0.0.133 → 0.0.135

package/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const channelKey: unique symbol;
+export declare const endpointKey: unique symbol;
+export declare const channelInstanceKey: unique symbol;
+export declare const endpointInstanceKey: unique symbol;
+export declare const onConnectionHandlerKey: unique symbol;
+export declare const onJoinHandlerKey: unique symbol;
+export declare const onLeaveHandlerKey: unique symbol;
+export declare const onEventHandlerKey: unique symbol;
+export declare const pondGuardsKey: unique symbol;
+export declare const parametersKey: unique symbol;
+export declare const onOutgoingEventHandlerKey: unique symbol;
+export declare const pondValidatorsKey: unique symbol;

package/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pondValidatorsKey = exports.parametersKey = exports.pondGuardsKey = exports.onEventHandlerKey = exports.onLeaveHandlerKey = exports.onJoinHandlerKey = exports.onConnectionHandlerKey = exports.endpointInstanceKey = exports.channelInstanceKey = exports.endpointKey = exports.channelKey = void 0;
+exports.pondValidatorsKey = exports.onOutgoingEventHandlerKey = exports.parametersKey = exports.pondGuardsKey = exports.onEventHandlerKey = exports.onLeaveHandlerKey = exports.onJoinHandlerKey = exports.onConnectionHandlerKey = exports.endpointInstanceKey = exports.channelInstanceKey = exports.endpointKey = exports.channelKey = void 0;
 exports.channelKey = Symbol('NEST_POND-SOCKET_CHANNEL');
 exports.endpointKey = Symbol('NEST_POND-SOCKET_ENDPOINT');
 exports.channelInstanceKey = Symbol('NEST_POND-SOCKET_CHANNEL_INSTANCE');
@@ -11,4 +11,5 @@ exports.onLeaveHandlerKey = Symbol('NEST_POND-SOCKET_ON-LEAVE');
 exports.onEventHandlerKey = Symbol('NEST_POND-SOCKET_ON-EVENT');
 exports.pondGuardsKey = Symbol('NEST_POND-SOCKET_GUARDS');
 exports.parametersKey = Symbol('NEST_POND-SOCKET_PARAMETERS');
+exports.onOutgoingEventHandlerKey = Symbol('NEST_POND-SOCKET_ON-OUTGOING-EVENT');
 exports.pondValidatorsKey = Symbol('NEST_POND-SOCKET_VALIDATORS');

package/context/context.d.ts

@@ -0,0 +1,21 @@
+import type { PondEvent, UserData } from '@eleven-am/pondsocket-common';
+import { NestContext } from '../types';
+export declare class Context {
+    #private;
+    constructor(context: NestContext, instance: any, propertyKey: string);
+    get joinContext(): import("@eleven-am/pondsocket").JoinContext<string> | null;
+    get eventContext(): import("@eleven-am/pondsocket").EventContext<string> | null;
+    get connectionContext(): import("@eleven-am/pondsocket").ConnectionContext<string> | null;
+    get leaveEvent(): import("@eleven-am/pondsocket").LeaveEvent | null;
+    get presence(): import("@eleven-am/pondsocket-common").PondObject;
+    get assigns(): import("@eleven-am/pondsocket-common").PondObject;
+    get user(): UserData<import("@eleven-am/pondsocket-common").PondObject, import("@eleven-am/pondsocket-common").PondObject>;
+    get channel(): import("@eleven-am/pondsocket").Channel | null;
+    get event(): PondEvent<string> | null;
+    getClass(): any;
+    getHandler(): any;
+    getInstance(): any;
+    getMethod(): string;
+    addData(key: string, value: unknown): void;
+    getData(key: string): {} | null;
+}

package/decorators/channel.d.ts

@@ -0,0 +1 @@
+export declare function Channel(path?: string): ClassDecorator;

package/decorators/channelInstance.d.ts

@@ -0,0 +1 @@
+export declare function ChannelInstance(channel?: string): PropertyDecorator;

package/decorators/endpoint.d.ts

@@ -0,0 +1 @@
+export declare function Endpoint(path?: string): ClassDecorator;

package/decorators/endpointInstance.d.ts

@@ -0,0 +1 @@
+export declare function EndpointInstance(): PropertyDecorator;

package/decorators/getChannel.d.ts

@@ -0,0 +1 @@
+export declare const GetChannel: (data: void) => ParameterDecorator;

package/decorators/getChannel.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetChannel = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetChannel = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const channel = context.channel;
-    if (!channel) {
-        throw new Error('Invalid decorator usage: GetChannel');
-    }
-    return channel;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetChannel = (0, createContextParamDecorator_1.createContextParamDecorator)('channel', 'GetChannel');

package/decorators/getConnectionContext.d.ts

@@ -0,0 +1 @@
+export declare const GetConnectionContext: (data: void) => ParameterDecorator;

package/decorators/getConnectionContext.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetConnectionContext = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetConnectionContext = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const connection = context.connectionContext;
-    if (!connection) {
-        throw new Error('Invalid decorator usage: GetConnectionContext');
-    }
-    return connection;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetConnectionContext = (0, createContextParamDecorator_1.createContextParamDecorator)('connectionContext', 'GetConnectionContext');

package/decorators/getConnectionHeaders.d.ts

@@ -0,0 +1 @@
+export declare const GetConnectionHeaders: (data: void) => ParameterDecorator;

package/decorators/getConnectionHeaders.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetConnectionHeaders = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetConnectionHeaders = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const connection = context.connectionContext;
-    if (!connection) {
-        throw new Error('Invalid decorator usage: GetConnectionHeaders');
-    }
-    return connection.headers;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetConnectionHeaders = (0, createContextParamDecorator_1.createContextParamDecorator)('connectionContext', 'GetConnectionHeaders', (connection) => connection.headers);

package/decorators/getContext.d.ts

@@ -0,0 +1 @@
+export declare const GetContext: (data: void) => ParameterDecorator;

package/decorators/getEventContext.d.ts

@@ -0,0 +1 @@
+export declare const GetEventContext: (data: void) => ParameterDecorator;

package/decorators/getEventContext.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetEventContext = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetEventContext = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const joinContext = context.joinContext;
-    if (!joinContext) {
-        throw new Error('Invalid decorator usage: GetEventContext');
-    }
-    return joinContext;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetEventContext = (0, createContextParamDecorator_1.createContextParamDecorator)('eventContext', 'GetEventContext');

package/decorators/getEventParams.d.ts

@@ -0,0 +1 @@
+export declare const GetEventParams: (data: void) => ParameterDecorator;

package/decorators/getEventParams.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetEventParams = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetEventParams = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const event = context.event;
-    if (!event) {
-        throw new Error('Invalid decorator usage: GetEventParams');
-    }
-    return event.params;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetEventParams = (0, createContextParamDecorator_1.createContextParamDecorator)('event', 'GetEventParams', (event) => event.params);

package/decorators/getEventPayload.d.ts

@@ -0,0 +1 @@
+export declare const GetEventPayload: (data: void) => ParameterDecorator;

package/decorators/getEventPayload.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetEventPayload = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetEventPayload = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const event = context.event;
-    if (!event) {
-        throw new Error('Invalid decorator usage: GetEventPayload');
-    }
-    return event.payload;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetEventPayload = (0, createContextParamDecorator_1.createContextParamDecorator)('event', 'GetEventPayload', (event) => event.payload);

package/decorators/getEventQuery.d.ts

@@ -0,0 +1 @@
+export declare const GetEventQuery: (data: void) => ParameterDecorator;

package/decorators/getEventQuery.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetEventQuery = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetEventQuery = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const event = context.event;
-    if (!event) {
-        throw new Error('Invalid decorator usage: GetEventQuery');
-    }
-    return event.query;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetEventQuery = (0, createContextParamDecorator_1.createContextParamDecorator)('event', 'GetEventQuery', (event) => event.query);

package/decorators/getJoinContext.d.ts

@@ -0,0 +1 @@
+export declare const GetJoinContext: (data: void) => ParameterDecorator;

package/decorators/getJoinContext.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetJoinContext = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetJoinContext = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const joinRequest = context.joinContext;
-    if (!joinRequest) {
-        throw new Error('Invalid decorator usage: GetJoinContext');
-    }
-    return joinRequest;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetJoinContext = (0, createContextParamDecorator_1.createContextParamDecorator)('joinContext', 'GetJoinContext');

package/decorators/getJoinParams.d.ts

@@ -0,0 +1 @@
+export declare const GetJoinParams: (data: void) => ParameterDecorator;

package/decorators/getJoinParams.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetJoinParams = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetJoinParams = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const joinRequest = context.joinContext;
-    if (!joinRequest) {
-        throw new Error('Invalid decorator usage: GetJoinParams');
-    }
-    return joinRequest.joinParams;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetJoinParams = (0, createContextParamDecorator_1.createContextParamDecorator)('joinContext', 'GetJoinParams', (joinRequest) => joinRequest.joinParams);

package/decorators/getLeaveEvent.d.ts

@@ -0,0 +1 @@
+export declare const GetLeaveEvent: (data: void) => ParameterDecorator;

package/decorators/getLeaveEvent.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetLeaveEvent = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetLeaveEvent = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const leaveEvent = context.leaveEvent;
-    if (!leaveEvent) {
-        throw new Error('Invalid decorator usage: GetLeaveEvent');
-    }
-    return leaveEvent;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetLeaveEvent = (0, createContextParamDecorator_1.createContextParamDecorator)('leaveEvent', 'GetLeaveEvent');

package/decorators/getUserAssigns.d.ts

@@ -0,0 +1 @@
+export declare const GetUserAssigns: (data: void) => ParameterDecorator;

package/decorators/getUserAssigns.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserAssigns = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetUserAssigns = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const userAssigns = context.assigns;
-    if (!userAssigns) {
-        throw new Error('Invalid decorator usage: GetUserPresences');
-    }
-    return userAssigns;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetUserAssigns = (0, createContextParamDecorator_1.createContextParamDecorator)('assigns', 'GetUserAssigns');

package/decorators/getUserData.d.ts

@@ -0,0 +1 @@
+export declare const GetUserData: (data: void) => ParameterDecorator;

package/decorators/getUserData.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserData = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetUserData = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const userData = context.user;
-    if (!userData) {
-        throw new Error('Invalid decorator usage: GetUserData');
-    }
-    return userData;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetUserData = (0, createContextParamDecorator_1.createContextParamDecorator)('user', 'GetUserData');

package/decorators/getUserPresence.d.ts

@@ -0,0 +1 @@
+export declare const GetUserPresence: (data: void) => ParameterDecorator;

package/decorators/getUserPresence.js

@@ -1,11 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserPresence = void 0;
-const createParamDecorator_1 = require("../helpers/createParamDecorator");
-exports.GetUserPresence = (0, createParamDecorator_1.createParamDecorator)((data, context) => {
-    const userPresences = context.presence;
-    if (!userPresences) {
-        throw new Error('Invalid decorator usage: GetUserPresences');
-    }
-    return userPresences;
-});
+const createContextParamDecorator_1 = require("../helpers/createContextParamDecorator");
+exports.GetUserPresence = (0, createContextParamDecorator_1.createContextParamDecorator)('presence', 'GetUserPresences');

package/decorators/index.d.ts

@@ -0,0 +1,25 @@
+export * from './channel';
+export * from './channelInstance';
+export * from './endpoint';
+export * from './endpointInstance';
+export * from './getChannel';
+export * from './getConnectionHeaders';
+export * from './getConnectionContext';
+export * from './getContext';
+export * from './getEventParams';
+export * from './getEventPayload';
+export * from './getEventQuery';
+export * from './getEventContext';
+export * from './getJoinParams';
+export * from './getJoinContext';
+export * from './getLeaveEvent';
+export * from './getUserAssigns';
+export * from './getUserData';
+export * from './getUserPresence';
+export * from './onConnectionRequest';
+export * from './onJoinRequest';
+export * from './onLeave';
+export * from './onEvent';
+export * from './onOutgoingEvent';
+export * from './useGuards';
+export * from './usePipes';

package/decorators/index.js

@@ -36,5 +36,6 @@ __exportStar(require("./onConnectionRequest"), exports);
 __exportStar(require("./onJoinRequest"), exports);
 __exportStar(require("./onLeave"), exports);
 __exportStar(require("./onEvent"), exports);
+__exportStar(require("./onOutgoingEvent"), exports);
 __exportStar(require("./useGuards"), exports);
 __exportStar(require("./usePipes"), exports);

package/decorators/onConnectionRequest.d.ts

@@ -0,0 +1 @@
+export declare function OnConnectionRequest(): MethodDecorator;

package/decorators/onEvent.d.ts

@@ -0,0 +1 @@
+export declare function OnEvent(event?: string): MethodDecorator;

package/decorators/onJoinRequest.d.ts

@@ -0,0 +1 @@
+export declare function OnJoinRequest(): MethodDecorator;

package/decorators/onLeave.d.ts

@@ -0,0 +1 @@
+export declare function OnLeave(): MethodDecorator;

package/decorators/onLeave.js

@@ -10,8 +10,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OnLeave = OnLeave;
+const common_1 = require("@nestjs/common");
 const leave_1 = require("../managers/leave");
 const action_1 = require("../performers/action");
+const logger = new common_1.Logger('OnLeave');
 function OnLeave() {
     return (target, propertyKey, descriptor) => {
         const originalMethod = descriptor.value;
@@ -21,7 +23,7 @@ function OnLeave() {
                 yield (0, action_1.performAction)(instance, moduleRef, globalGuards, globalPipes, originalMethod, propertyKey, leaveEvent);
             }
             catch (err) {
-                // no-op
+                logger.error(`Error in OnLeave handler "${String(propertyKey)}": ${err instanceof Error ? err.message : err}`);
             }
         }));
     };

package/decorators/onOutgoingEvent.d.ts

@@ -0,0 +1 @@
+export declare function OnOutgoingEvent(event?: string): MethodDecorator;

package/decorators/onOutgoingEvent.js

@@ -0,0 +1,22 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnOutgoingEvent = OnOutgoingEvent;
+const outgoingEvent_1 = require("../managers/outgoingEvent");
+function OnOutgoingEvent(event = '*') {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        const { set } = (0, outgoingEvent_1.manageOutgoingEvent)(target);
+        set(event, (instance, _moduleRef, _globalGuards, _globalPipes, ctx) => __awaiter(this, void 0, void 0, function* () {
+            yield originalMethod.call(instance, ctx);
+        }));
+    };
+}

package/decorators/useGuards.d.ts

@@ -0,0 +1,2 @@
+import { CanActivate, Constructor } from '../types';
+export declare function UseGuards(...guards: Constructor<CanActivate>[]): ClassDecorator | MethodDecorator;

package/decorators/usePipes.d.ts

@@ -0,0 +1,3 @@
+import type { PipeTransform } from '@nestjs/common';
+import { Constructor } from '../types';
+export declare function UsePipes(...validators: Constructor<PipeTransform>[]): ClassDecorator | MethodDecorator;

package/helpers/createContextParamDecorator.d.ts

@@ -0,0 +1,2 @@
+import { Context } from '../context/context';
+export declare function createContextParamDecorator<K extends keyof Context>(key: K, decoratorName: string, transform?: (value: NonNullable<Context[K]>) => unknown): (data: void) => ParameterDecorator;

package/helpers/createContextParamDecorator.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextParamDecorator = createContextParamDecorator;
+const createParamDecorator_1 = require("./createParamDecorator");
+function createContextParamDecorator(key, decoratorName, transform) {
+    return (0, createParamDecorator_1.createParamDecorator)((data, context) => {
+        const value = context[key];
+        if (value === null || value === undefined) {
+            throw new Error(`Invalid decorator usage: ${decoratorName}`);
+        }
+        return transform ? transform(value) : value;
+    });
+}

package/helpers/createParamDecorator.d.ts

@@ -0,0 +1,3 @@
+import 'reflect-metadata';
+import { ParamDecoratorCallback } from '../types';
+export declare function createParamDecorator<Input>(callback: ParamDecoratorCallback<Input>): (data: Input) => ParameterDecorator;

package/helpers/misc.d.ts

@@ -0,0 +1,3 @@
+import type { ModuleRef } from '@nestjs/core';
+import { Constructor } from '../types';
+export declare function retrieveInstance<Interface>(moduleRef: ModuleRef, Guard: Constructor<Interface>): Interface;

package/helpers/misc.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.retrieveInstance = retrieveInstance;
+const common_1 = require("@nestjs/common");
 function retrieveInstance(moduleRef, Guard) {
     try {
         return moduleRef.get(Guard, { strict: false });
     }
     catch (e) {
-        console.warn(`Unable to resolve instance: ${Guard.name}, creating new instance, WARNING: this will not inject dependencies. To fix this, add the instance to the providers array of the PondSocketModule.`);
+        common_1.Logger.warn(`Unable to resolve instance: ${Guard.name}, creating new instance, WARNING: this will not inject dependencies. To fix this, add the instance to the providers array of the PondSocketModule.`);
         return new Guard();
     }
 }