@vsaas/remoting 10.0.0

package/dist/lib/shared-method.js

@@ -0,0 +1,469 @@
+"use strict";
+const require_runtime = require("../_virtual/_rolldown/runtime.js");
+const require_lib_messages = require("./messages.js");
+const require_lib_number_checks = require("./number-checks.js");
+require("./context-base.js");
+//#region src/lib/shared-method.ts
+var require_shared_method = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, module) => {
+	const g = require_lib_messages;
+	/*!
+	* Expose `SharedMethod`.
+	*/
+	module.exports = SharedMethod;
+	const debug = require("debug")("strong-remoting:shared-method");
+	require("util");
+	const assert = require("assert");
+	const numberChecks = require_lib_number_checks;
+	const isInteger = numberChecks.isSafeInteger;
+	const isSafeInteger = numberChecks.isSafeInteger;
+	/**
+	* Create a new `SharedMethod` (remote method) with the given `fn`.
+	* See also [Remote methods](http://docs.strongloop.com/display/LB/Remote+methods).
+	*
+	* @property {String} name The method name.
+	* @property {String[]} aliases An array of method aliases.
+	* @property {Boolean} isStatic Whether the method is static; from `options.isStatic`.
+	* Default is `true`.
+	* @property {Array|Object} accepts See `options.accepts`.
+	* @property {Array|Object} returns See `options.returns`.
+	* @property {Array|Object} errors See `options.errors`.
+	* @property {String} description Text description of the method.
+	* @property {String} notes Additional notes, used by API documentation generators like
+	* Swagger.
+	* @property {String} http
+	* @property {Object} rest
+	* @property {Boolean} shared
+	* @property {Boolean} [documented] Default: true. Set to `false` to exclude the method
+	* from Swagger metadata.
+	*
+	* @param {Function} fn The `Function` to be invoked when the method is invoked.
+	* @param {String} name The name of the `SharedMethod`.
+	* @param {SharedClass} sharedClass The `SharedClass` to which the method will be attached.
+	*
+	* @options {Object} options See below.
+	* @property {Array|Object} [accepts] Defines either a single argument as an object or an
+	* ordered set of arguments as an array.
+	* @property {String} [accepts.arg] The name of the argument.
+	* @property {String} [accepts.description] Text description of the argument, used by API
+	* documentation generators like Swagger.
+	* @property {String} [accepts.http] HTTP mapping for the argument. See argument mapping in
+	* [the docs](http://docs.strongloop.com/x/-Yw6#Remotemethods-HTTPmappingofinputarguments).
+	* @property {String} [accepts.http.source] The HTTP source for the  argument. May be one
+	* of the following:
+	*
+	* - `req` - the Express `Request` object.
+	* - `res` - the Express `Response` object.
+	* - `body` - the `req.body` value.
+	* - `form` - `req.body[argumentName]`.
+	* - `query` - `req.query[argumentName]`.
+	* - `path` - `req.params[argumentName]`.
+	* - `header` - `req.headers[argumentName]`.
+	* - `context` - the current `HttpContext`.
+	* @property {Object} [accepts.rest] The REST mapping / settings for the argument.
+	* @property {String} [accepts.type] Argument datatype; must be a
+	* [Loopback type](http://docs.strongloop.com/display/LB/LoopBack+types).
+	* @property {Array} [aliases] A list of aliases for the method.
+	* @property {Array|Object} [errors] Object or `Array` containing error definitions.
+	* @property {Array} [http] HTTP-only options.
+	* @property {Number} [http.errorStatus] Default error status code.
+	* @property {String} [http.path] HTTP path (relative to the model) at which the method is
+	* exposed.
+	* @property {Number} [http.status] Default status code when the callback is called
+	* _without_ an error.
+	* @property {String} [http.verb] HTTP method (verb) at which the method is available.
+	* One of: get, post (default), put, del, or all
+	* @property {Boolean} [isStatic] Whether the method is a static method or a prototype
+	* method.
+	* @property {Array|Object} [returns] Specifies the remote method's callback arguments;
+	* either a single argument as an object or an ordered set of arguments as an array.
+	* The `err` argument is assumed; do not specify.  NOTE: Can have the same properties as
+	* `accepts`, except for `http.target`.
+	*
+	* Additionally, one of the callback arguments can have `type: 'file'` and
+	* `root:true`, in which case this argument is sent in the raw form as
+	* a response body. Allowed values: `String`, `Buffer` or `ReadableStream`
+	* @property {Boolean} [shared] Whether the method is shared.  Default is `true`.
+	* @property {Number} [status] The default status code.
+	* @end
+	*
+	* @class
+	*/
+	function SharedMethod(fn, name, sc, options) {
+		if (typeof options === "boolean") options = { isStatic: options };
+		this.fn = fn;
+		fn = fn || {};
+		this.name = name;
+		assert(typeof name === "string", "The method name must be a string");
+		options = options || {};
+		this.aliases = options.aliases || [];
+		const isStatic = this.isStatic = options.isStatic || false;
+		this.accepts = options.accepts || fn.accepts || [];
+		this.returns = options.returns || fn.returns || [];
+		this.errors = options.errors || fn.errors || [];
+		this.description = options.description || fn.description;
+		this.accessType = options.accessType || fn.accessType;
+		this.notes = options.notes || fn.notes;
+		this.documented = options.documented !== false && fn.documented !== false;
+		this.http = options.http || fn.http || {};
+		this.rest = options.rest || fn.rest || {};
+		this.shared = options.shared;
+		if (this.shared === void 0) this.shared = true;
+		if (fn.shared === false) this.shared = false;
+		this.sharedClass = sc;
+		if (sc) {
+			this.ctor = sc.ctor;
+			this.sharedCtor = sc.sharedCtor;
+		}
+		if (name === "sharedCtor") this.isSharedCtor = true;
+		if (this.accepts && !Array.isArray(this.accepts)) this.accepts = [this.accepts];
+		this.accepts.forEach(normalizeArgumentDescriptor);
+		if (this.returns && !Array.isArray(this.returns)) this.returns = [this.returns];
+		this.returns.forEach(normalizeArgumentDescriptor);
+		const firstReturns = this.returns[0];
+		if (firstReturns && firstReturns.type && [
+			"ReadableStream",
+			"WriteableStream",
+			"DuplexStream"
+		].indexOf(firstReturns.type) > -1) this.streams = { returns: firstReturns };
+		if (this.errors && !Array.isArray(this.errors)) this.errors = [this.errors];
+		if (/^prototype\./.test(name)) throw new Error("Incorrect API usage. Shared methods on prototypes should be created via `new SharedMethod(fn, \"name\", { isStatic: false })`");
+		this.stringName = (sc ? sc.name : "") + (isStatic ? "." : ".prototype.") + name;
+		for (const key in options) {
+			if (this[key]) continue;
+			this[key] = options[key];
+		}
+	}
+	function normalizeArgumentDescriptor(desc) {
+		if (desc.type === "array") desc.type = ["any"];
+	}
+	/**
+	* Create a new `SharedMethod` with the given `fn`. The function should include
+	* all the method options.
+	*
+	* @param {Function} fn
+	* @param {String} name
+	* @param {SharedClass} SharedClass
+	* @param {Boolean} isStatic
+	*/
+	SharedMethod.fromFunction = function(fn, name, sharedClass, isStatic) {
+		return new SharedMethod(fn, name, sharedClass, {
+			isStatic,
+			accepts: fn.accepts,
+			returns: fn.returns,
+			errors: fn.errors,
+			description: fn.description,
+			notes: fn.notes,
+			http: fn.http,
+			rest: fn.rest
+		});
+	};
+	SharedMethod.prototype.getReturnArgDescByName = function(name) {
+		const returns = this.returns;
+		let desc;
+		for (let i = 0; i < returns.length; i++) {
+			desc = returns[i];
+			if (desc && (desc.arg || desc.name) === name) return desc;
+		}
+	};
+	/**
+	* Execute the remote method using the given arg data.
+	*
+	* @param {Object} scope `this` parameter for the invocation
+	* @param {Object} args containing named argument data
+	* @param {Object=} remotingOptions remote-objects options
+	* @param {Function} cb callback `fn(err, result)` containing named result data
+	*/
+	SharedMethod.prototype.invoke = function(scope, args, remotingOptions, ctx, cb) {
+		assert(ctx, "invocation context is required");
+		const accepts = this.accepts;
+		const returns = this.returns;
+		this.errors;
+		const method = this.getFunction();
+		const sharedMethod = this;
+		const argCount = accepts ? accepts.length : 0;
+		const formattedArgs = new Array(argCount + 1);
+		let completed = false;
+		if (accepts) for (let i = 0; i < accepts.length; i++) {
+			const desc = accepts[i];
+			const name = desc.name || desc.arg;
+			let uarg = SharedMethod.convertArg(desc, args[name]);
+			const conversionOptions = SharedMethod.getConversionOptionsForArg(desc);
+			try {
+				uarg = validateInputArgument(uarg, desc, ctx, conversionOptions);
+			} catch (e) {
+				debug("- %s - " + e.message, sharedMethod.name);
+				return cb(e);
+			}
+			formattedArgs[i] = uarg;
+		}
+		function complete(err, rawArgs) {
+			if (completed) return;
+			completed = true;
+			if (err) return cb(err);
+			const result = SharedMethod.toResult(returns, rawArgs, ctx);
+			debug("- %s - result %j", sharedMethod.name, result);
+			cb(null, result);
+		}
+		function callback(err) {
+			const rawArgsLength = arguments.length > 0 ? arguments.length - 1 : 0;
+			const rawArgs = new Array(rawArgsLength);
+			for (let i = 1; i < arguments.length; i++) rawArgs[i - 1] = arguments[i];
+			return complete(err, rawArgs);
+		}
+		formattedArgs[argCount] = callback;
+		debug("- %s - invoke with", this.name, formattedArgs);
+		try {
+			const retval = method.apply(scope, formattedArgs);
+			if (retval && typeof retval.then === "function") return retval.then(function(args) {
+				if (returns.length === 1) args = [args];
+				debug("- %s - promise result %j", sharedMethod.name, args);
+				complete(null, args);
+			}, function(err) {
+				complete(err);
+			});
+			return retval;
+		} catch (err) {
+			debug("error caught during the invocation of %s: %s", this.name, err.stack || err);
+			return cb(err);
+		}
+	};
+	function badArgumentError(msg) {
+		const err = new Error(msg);
+		err.statusCode = 400;
+		return err;
+	}
+	function internalServerError(msg) {
+		const err = new Error(msg);
+		err.statusCode = 500;
+		return err;
+	}
+	/**
+	* Coerce an 'accepts' value into its final type.
+	* If using HTTP, some coercion is already done in http-context.
+	*
+	* This should only do very simple coercion.
+	*
+	* @param  {*} uarg            Argument value.
+	* @param  {Object} desc       Argument description.
+	* @param  {Context} ctx       Remoting request context.
+	* @return {*}                 Coerced argument.
+	*/
+	function validateInputArgument(uarg, desc, ctx, conversionOptions) {
+		const name = desc.name || desc.arg;
+		if (desc.required) {
+			if (uarg === null || uarg === void 0 || uarg === "") throw badArgumentError(g.f("%s is a required argument", name));
+		}
+		const err = ctx.typeRegistry.getConverter(desc.type).validate(ctx, uarg, conversionOptions);
+		if (err) {
+			err.message = g.f("Invalid argument %j. ", name) + err.message;
+			throw err;
+		}
+		return uarg;
+	}
+	/**
+	* Returns an appropriate type based on a type specifier from remoting
+	* metadata.
+	* @param {Object} type A type specifier from remoting metadata,
+	*    e.g. "[Number]" or "MyModel" from `accepts[0].type`.
+	* @returns {String} A type name compatible with the values returned by
+	*   `SharedMethod.getType()`, e.g. "string" or "array".
+	*/
+	function convertToBasicRemotingType(type) {
+		if (Array.isArray(type)) return type.map(convertToBasicRemotingType);
+		if (typeof type === "object") type = type.modelName || type.name;
+		type = String(type).toLowerCase();
+		switch (type) {
+			case "string":
+			case "number":
+			case "integer":
+			case "date":
+			case "boolean":
+			case "buffer":
+			case "object":
+			case "file":
+			case "any": return type;
+			case "array": return ["any"];
+			default: return "object";
+		}
+	}
+	/**
+	* Returns an appropriate type based on `val`.
+	* @param {*} val The value to determine the type for
+	* @returns {String} The type name
+	*/
+	SharedMethod.getType = function(val, targetType) {
+		const type = typeof val;
+		switch (type) {
+			case "undefined":
+			case "boolean":
+			case "function":
+			case "string": return type;
+			case "number": return isInteger(val) && targetType === "integer" ? "integer" : "number";
+			case "object":
+				if (val === null) return "null";
+				if (Buffer.isBuffer(val)) return "buffer";
+				if (Array.isArray(val)) return "array";
+				if (val instanceof Date) return "date";
+				return "object";
+		}
+	};
+	/**
+	* Returns a reformatted Object valid for consumption as remoting function
+	* arguments
+	*/
+	SharedMethod.convertArg = function(accept, raw) {
+		if (accept.http && (typeof accept.http === "function" || accept.http.source === "req" || accept.http.source === "res" || accept.http.source === "context")) return raw;
+		if (raw === null || typeof raw !== "object") return raw;
+		if (typeof raw === "object" && raw.constructor !== Object && raw.constructor !== Array) return raw;
+		return convertSpecialObjects(raw);
+	};
+	function convertSpecialObjects(value) {
+		if (value === null || typeof value !== "object") return value;
+		if (Array.isArray(value)) {
+			const result = new Array(value.length);
+			for (let i = 0; i < value.length; i++) result[i] = convertSpecialObjects(value[i]);
+			return result;
+		}
+		if (value.constructor !== Object) return value;
+		if (value.$type === "base64") return Buffer.from(value.$data, "base64");
+		if (value.$type === "date") return new Date(value.$data);
+		const result = {};
+		for (const key in value) result[key] = convertSpecialObjects(value[key]);
+		return result;
+	}
+	/**
+	* Returns a reformatted Object valid for consumption as JSON from an Array of
+	* results from a remoting function, based on `returns`.
+	*/
+	SharedMethod.toResult = function(returns, raw, ctx) {
+		if (!returns.length) return;
+		let result = {};
+		const rawLength = raw.length;
+		for (let index = 0; index < returns.length && index < rawLength; index++) {
+			const item = returns[index];
+			const name = item.name || item.arg;
+			const value = raw[index];
+			if (ctx && ctx.setReturnArgByName(name, value)) continue;
+			const targetType = convertToBasicRemotingType(item.type);
+			if (item.root) {
+				result = targetType === "file" ? value : convert(value, targetType, item.name);
+				continue;
+			}
+			if (targetType === "file") {
+				g.warn("%s: discarded non-root return argument %s of type \"{{file}}\"", this.stringName, name);
+				continue;
+			}
+			result[name] = convert(value, targetType, name);
+		}
+		return result;
+		function convert(val, targetType, argName) {
+			if (Array.isArray(targetType) && targetType.length === 1 && targetType[0] === "integer" && Array.isArray(val)) {
+				const arrayTargetType = targetType[0];
+				return val.map(function(intVal) {
+					return convert(intVal, arrayTargetType, argName);
+				});
+			}
+			switch (SharedMethod.getType(val, targetType)) {
+				case "date": return {
+					$type: "date",
+					$data: val.toJSON ? val.toJSON() : val.toString()
+				};
+				case "buffer": return {
+					$type: "base64",
+					$data: val.toString("base64")
+				};
+				default:
+					if (targetType === "integer") {
+						let message;
+						if (!isInteger(val)) {
+							message = g.f("Invalid return value for argument '%s' of type '%s': %s. Received type was %s.", argName, targetType, val, typeof val);
+							throw internalServerError(message);
+						}
+						if (!isSafeInteger(val)) {
+							message = g.f("Unsafe integer value returned for argument '%s' of type '%s': %s.", argName, targetType, val);
+							throw internalServerError(message);
+						}
+						return val;
+					}
+					return val;
+			}
+		}
+	};
+	/**
+	* Get the function the `SharedMethod` will `invoke()`.
+	*/
+	SharedMethod.prototype.getFunction = function() {
+		let fn;
+		if (!this.ctor) return this.fn;
+		if (this.isStatic) fn = this.ctor[this.name];
+		else fn = this.ctor.prototype[this.name];
+		return fn || this.fn;
+	};
+	/**
+	* Determine if this shared method invokes the given "suspect" function.
+	*
+	* @example
+	* ```js
+	* sharedMethod.isDelegateFor(myClass.myMethod); // pass a function
+	* sharedMethod.isDelegateFor(myClass.prototype.myInstMethod);
+	* sharedMethod.isDelegateFor('myMethod', true); // check for a static method by name
+	* sharedMethod.isDelegateFor('myInstMethod', false); // instance method by name
+	* ```
+	*
+	* @param {String|Function} suspect The name of the suspected function
+	* or a `Function`.
+	* @returns Boolean True if the shared method invokes the given function; false otherwise.
+	*/
+	SharedMethod.prototype.isDelegateFor = function(suspect, isStatic) {
+		const type = typeof suspect;
+		isStatic = isStatic || false;
+		if (suspect) switch (type) {
+			case "function": return this.getFunction() === suspect;
+			case "string":
+				if (this.isStatic !== isStatic) return false;
+				return this.name === suspect || this.aliases.indexOf(suspect) !== -1;
+		}
+		return false;
+	};
+	/**
+	* Determine if this shared method invokes the given "suspect" function.
+	*
+	* @example
+	* ```js
+	* sharedMethod.isDelegateForName('myMethod'); // check for a static method by name
+	* sharedMethod.isDelegateForName('prototype.myInstMethod'); // instance method by name
+	* ```
+	*
+	* @returns Boolean True if the shared method invokes the given function; false otherwise.
+	*/
+	SharedMethod.prototype.isDelegateForName = function(suspect) {
+		assert(typeof suspect === "string", "argument of isDelegateForName should be string");
+		const m = suspect.match(/^prototype\.(.*)$/);
+		const isStatic = !m;
+		const baseName = isStatic ? suspect : m[1];
+		return this.isDelegateFor(baseName, isStatic);
+	};
+	/**
+	* Add an alias
+	*
+	* @param {String} alias Alias method name.
+	*/
+	SharedMethod.prototype.addAlias = function(alias) {
+		if (this.aliases.indexOf(alias) === -1) this.aliases.push(alias);
+	};
+	/**
+	* build conversion options from remote's' args
+	*
+	* @param {Object} arg Definition of accepts/returns argument.
+	* @returns {Object} Options object to pass to type-converter methods,  e.g `validate` or `fromTypedValue`.
+	*/
+	SharedMethod.getConversionOptionsForArg = function(arg) {
+		const options = {};
+		if (arg.allowArray) options.allowArray = arg.allowArray;
+		return options;
+	};
+}));
+//#endregion
+module.exports = require_shared_method();
+
+//# sourceMappingURL=shared-method.js.map

package/dist/lib/shared-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-method.js","names":[],"sources":["../../src/lib/shared-method.ts"],"sourcesContent":["// Copyright IBM Corp. 2013,2018. All Rights Reserved.\n// Node module: strong-remoting\n// This file is licensed under the Artistic License 2.0.\n// License text available at https://opensource.org/licenses/Artistic-2.0\n\n// @ts-nocheck\n'use strict';\n\nconst g = require('./messages');\n\n/*!\n * Expose `SharedMethod`.\n */\nmodule.exports = SharedMethod;\n\nconst debug = require('debug')('strong-remoting:shared-method');\nconst util = require('util');\nconst assert = require('assert');\nconst Context = require('./context-base');\nconst numberChecks = require('./number-checks');\n\nconst isInteger = numberChecks.isSafeInteger;\nconst isSafeInteger = numberChecks.isSafeInteger;\n\n/**\n * Create a new `SharedMethod` (remote method) with the given `fn`.\n * See also [Remote methods](http://docs.strongloop.com/display/LB/Remote+methods).\n *\n * @property {String} name The method name.\n * @property {String[]} aliases An array of method aliases.\n * @property {Boolean} isStatic Whether the method is static; from `options.isStatic`.\n * Default is `true`.\n * @property {Array|Object} accepts See `options.accepts`.\n * @property {Array|Object} returns See `options.returns`.\n * @property {Array|Object} errors See `options.errors`.\n * @property {String} description Text description of the method.\n * @property {String} notes Additional notes, used by API documentation generators like\n * Swagger.\n * @property {String} http\n * @property {Object} rest\n * @property {Boolean} shared\n * @property {Boolean} [documented] Default: true. Set to `false` to exclude the method\n * from Swagger metadata.\n *\n * @param {Function} fn The `Function` to be invoked when the method is invoked.\n * @param {String} name The name of the `SharedMethod`.\n * @param {SharedClass} sharedClass The `SharedClass` to which the method will be attached.\n *\n * @options {Object} options See below.\n * @property {Array|Object} [accepts] Defines either a single argument as an object or an\n * ordered set of arguments as an array.\n * @property {String} [accepts.arg] The name of the argument.\n * @property {String} [accepts.description] Text description of the argument, used by API\n * documentation generators like Swagger.\n * @property {String} [accepts.http] HTTP mapping for the argument. See argument mapping in\n * [the docs](http://docs.strongloop.com/x/-Yw6#Remotemethods-HTTPmappingofinputarguments).\n * @property {String} [accepts.http.source] The HTTP source for the  argument. May be one\n * of the following:\n *\n * - `req` - the Express `Request` object.\n * - `res` - the Express `Response` object.\n * - `body` - the `req.body` value.\n * - `form` - `req.body[argumentName]`.\n * - `query` - `req.query[argumentName]`.\n * - `path` - `req.params[argumentName]`.\n * - `header` - `req.headers[argumentName]`.\n * - `context` - the current `HttpContext`.\n * @property {Object} [accepts.rest] The REST mapping / settings for the argument.\n * @property {String} [accepts.type] Argument datatype; must be a\n * [Loopback type](http://docs.strongloop.com/display/LB/LoopBack+types).\n * @property {Array} [aliases] A list of aliases for the method.\n * @property {Array|Object} [errors] Object or `Array` containing error definitions.\n * @property {Array} [http] HTTP-only options.\n * @property {Number} [http.errorStatus] Default error status code.\n * @property {String} [http.path] HTTP path (relative to the model) at which the method is\n * exposed.\n * @property {Number} [http.status] Default status code when the callback is called\n * _without_ an error.\n * @property {String} [http.verb] HTTP method (verb) at which the method is available.\n * One of: get, post (default), put, del, or all\n * @property {Boolean} [isStatic] Whether the method is a static method or a prototype\n * method.\n * @property {Array|Object} [returns] Specifies the remote method's callback arguments;\n * either a single argument as an object or an ordered set of arguments as an array.\n * The `err` argument is assumed; do not specify.  NOTE: Can have the same properties as\n * `accepts`, except for `http.target`.\n *\n * Additionally, one of the callback arguments can have `type: 'file'` and\n * `root:true`, in which case this argument is sent in the raw form as\n * a response body. Allowed values: `String`, `Buffer` or `ReadableStream`\n * @property {Boolean} [shared] Whether the method is shared.  Default is `true`.\n * @property {Number} [status] The default status code.\n * @end\n *\n * @class\n */\n\nfunction SharedMethod(fn, name, sc, options) {\n  if (typeof options === 'boolean') {\n    options = { isStatic: options };\n  }\n\n  this.fn = fn;\n  fn = fn || {};\n  this.name = name;\n  assert(typeof name === 'string', 'The method name must be a string');\n  options = options || {};\n  this.aliases = options.aliases || [];\n  const isStatic = (this.isStatic = options.isStatic || false);\n  this.accepts = options.accepts || fn.accepts || [];\n  this.returns = options.returns || fn.returns || [];\n  this.errors = options.errors || fn.errors || [];\n  this.description = options.description || fn.description;\n  this.accessType = options.accessType || fn.accessType;\n  this.notes = options.notes || fn.notes;\n  this.documented = options.documented !== false && fn.documented !== false;\n  this.http = options.http || fn.http || {};\n  this.rest = options.rest || fn.rest || {};\n  this.shared = options.shared;\n  if (this.shared === undefined) {\n    this.shared = true;\n  }\n  if (fn.shared === false) {\n    this.shared = false;\n  }\n  this.sharedClass = sc;\n\n  if (sc) {\n    this.ctor = sc.ctor;\n    this.sharedCtor = sc.sharedCtor;\n  }\n  if (name === 'sharedCtor') {\n    this.isSharedCtor = true;\n  }\n\n  if (this.accepts && !Array.isArray(this.accepts)) {\n    this.accepts = [this.accepts];\n  }\n  this.accepts.forEach(normalizeArgumentDescriptor);\n\n  if (this.returns && !Array.isArray(this.returns)) {\n    this.returns = [this.returns];\n  }\n  this.returns.forEach(normalizeArgumentDescriptor);\n\n  const firstReturns = this.returns[0];\n  const streamTypes = ['ReadableStream', 'WriteableStream', 'DuplexStream'];\n\n  if (firstReturns && firstReturns.type && streamTypes.indexOf(firstReturns.type) > -1) {\n    this.streams = { returns: firstReturns };\n  }\n\n  if (this.errors && !Array.isArray(this.errors)) {\n    this.errors = [this.errors];\n  }\n\n  if (/^prototype\\./.test(name)) {\n    const msg =\n      'Incorrect API usage. Shared methods on prototypes should be ' +\n      'created via `new SharedMethod(fn, \"name\", { isStatic: false })`';\n    throw new Error(msg);\n  }\n\n  this.stringName = (sc ? sc.name : '') + (isStatic ? '.' : '.prototype.') + name;\n\n  // Include any remaining metadata to support custom user-defined extensions\n  for (const key in options) {\n    if (this[key]) continue;\n    this[key] = options[key];\n  }\n}\n\nfunction normalizeArgumentDescriptor(desc) {\n  if (desc.type === 'array') desc.type = ['any'];\n}\n\n/**\n * Create a new `SharedMethod` with the given `fn`. The function should include\n * all the method options.\n *\n * @param {Function} fn\n * @param {String} name\n * @param {SharedClass} SharedClass\n * @param {Boolean} isStatic\n */\n\nSharedMethod.fromFunction = function (fn, name, sharedClass, isStatic) {\n  return new SharedMethod(fn, name, sharedClass, {\n    isStatic: isStatic,\n    accepts: fn.accepts,\n    returns: fn.returns,\n    errors: fn.errors,\n    description: fn.description,\n    notes: fn.notes,\n    http: fn.http,\n    rest: fn.rest,\n  });\n};\n\nSharedMethod.prototype.getReturnArgDescByName = function (name) {\n  const returns = this.returns;\n  let desc;\n  for (let i = 0; i < returns.length; i++) {\n    desc = returns[i];\n    if (desc && (desc.arg || desc.name) === name) {\n      return desc;\n    }\n  }\n};\n\n/**\n * Execute the remote method using the given arg data.\n *\n * @param {Object} scope `this` parameter for the invocation\n * @param {Object} args containing named argument data\n * @param {Object=} remotingOptions remote-objects options\n * @param {Function} cb callback `fn(err, result)` containing named result data\n */\n\nSharedMethod.prototype.invoke = function (scope, args, remotingOptions, ctx, cb) {\n  assert(ctx, 'invocation context is required');\n\n  const accepts = this.accepts;\n  const returns = this.returns;\n  const errors = this.errors;\n  const method = this.getFunction();\n  const sharedMethod = this;\n  const argCount = accepts ? accepts.length : 0;\n  const formattedArgs = new Array(argCount + 1);\n  let completed = false;\n\n  // map the given arg data in order they are expected in\n  if (accepts) {\n    for (let i = 0; i < accepts.length; i++) {\n      const desc = accepts[i];\n      const name = desc.name || desc.arg;\n      let uarg = SharedMethod.convertArg(desc, args[name]);\n      const conversionOptions = SharedMethod.getConversionOptionsForArg(desc);\n\n      try {\n        uarg = validateInputArgument(uarg, desc, ctx, conversionOptions);\n      } catch (e) {\n        debug('- %s - ' + e.message, sharedMethod.name);\n        return cb(e);\n      }\n      // Add the argument even if it's undefined to stick with the accepts\n      formattedArgs[i] = uarg;\n    }\n  }\n\n  // define the callback\n  function complete(err, rawArgs) {\n    if (completed) {\n      return;\n    }\n\n    completed = true;\n\n    if (err) {\n      return cb(err);\n    }\n\n    const result = SharedMethod.toResult(returns, rawArgs, ctx);\n\n    debug('- %s - result %j', sharedMethod.name, result);\n\n    cb(null, result);\n  }\n\n  // define the callback\n  function callback(err) {\n    // args without err\n    const rawArgsLength = arguments.length > 0 ? arguments.length - 1 : 0;\n    const rawArgs = new Array(rawArgsLength);\n    for (let i = 1; i < arguments.length; i++) {\n      rawArgs[i - 1] = arguments[i];\n    }\n    return complete(err, rawArgs);\n  }\n\n  // add in the required callback\n  formattedArgs[argCount] = callback;\n\n  debug('- %s - invoke with', this.name, formattedArgs);\n\n  // invoke\n  try {\n    const retval = method.apply(scope, formattedArgs);\n    if (retval && typeof retval.then === 'function') {\n      return retval.then(\n        function (args) {\n          if (returns.length === 1) args = [args];\n          debug('- %s - promise result %j', sharedMethod.name, args);\n          complete(null, args);\n        },\n        function (err) {\n          complete(err);\n        },\n      );\n    }\n    return retval;\n  } catch (err) {\n    debug('error caught during the invocation of %s: %s', this.name, err.stack || err);\n    return cb(err);\n  }\n};\n\nfunction badArgumentError(msg) {\n  const err = new Error(msg);\n  err.statusCode = 400;\n  return err;\n}\n\nfunction internalServerError(msg) {\n  const err = new Error(msg);\n  err.statusCode = 500;\n  return err;\n}\n\nfunction escapeRegex(d) {\n  // see http://stackoverflow.com/a/6969486/69868\n  return d.replace(/[\\-\\[\\]\\/\\{\\}\\(\\)\\*\\+\\?\\.\\\\\\^\\$\\|]/g, '\\\\$&');\n}\n\n/**\n * Coerce an 'accepts' value into its final type.\n * If using HTTP, some coercion is already done in http-context.\n *\n * This should only do very simple coercion.\n *\n * @param  {*} uarg            Argument value.\n * @param  {Object} desc       Argument description.\n * @param  {Context} ctx       Remoting request context.\n * @return {*}                 Coerced argument.\n */\nfunction validateInputArgument(uarg, desc, ctx, conversionOptions) {\n  const name = desc.name || desc.arg;\n\n  // Verify that a required argument has a value\n  if (desc.required) {\n    const argIsNotSet = uarg === null || uarg === undefined || uarg === '';\n    if (argIsNotSet) {\n      throw badArgumentError(g.f('%s is a required argument', name));\n    }\n  }\n\n  const converter = ctx.typeRegistry.getConverter(desc.type);\n  const err = converter.validate(ctx, uarg, conversionOptions);\n  if (err) {\n    err.message = g.f('Invalid argument %j. ', name) + err.message;\n    throw err;\n  }\n\n  return uarg;\n}\n\n/**\n * Returns an appropriate type based on a type specifier from remoting\n * metadata.\n * @param {Object} type A type specifier from remoting metadata,\n *    e.g. \"[Number]\" or \"MyModel\" from `accepts[0].type`.\n * @returns {String} A type name compatible with the values returned by\n *   `SharedMethod.getType()`, e.g. \"string\" or \"array\".\n */\nfunction convertToBasicRemotingType(type) {\n  if (Array.isArray(type)) {\n    return type.map(convertToBasicRemotingType);\n  }\n\n  if (typeof type === 'object') {\n    type = type.modelName || type.name;\n  }\n\n  type = String(type).toLowerCase();\n\n  switch (type) {\n    case 'string':\n    case 'number':\n    case 'integer':\n    case 'date':\n    case 'boolean':\n    case 'buffer':\n    case 'object':\n    case 'file':\n    case 'any':\n      return type;\n    case 'array':\n      return ['any'];\n    default:\n      // custom types like MyModel\n      return 'object';\n  }\n}\n\n/**\n * Returns an appropriate type based on `val`.\n * @param {*} val The value to determine the type for\n * @returns {String} The type name\n */\n\nSharedMethod.getType = function (val, targetType) {\n  const type = typeof val;\n\n  switch (type) {\n    case 'undefined':\n    case 'boolean':\n    case 'function':\n    case 'string':\n      return type;\n    case 'number':\n      return isInteger(val) && targetType === 'integer' ? 'integer' : 'number';\n    case 'object':\n      // null\n      if (val === null) {\n        return 'null';\n      }\n\n      // buffer\n      if (Buffer.isBuffer(val)) {\n        return 'buffer';\n      }\n\n      // array\n      if (Array.isArray(val)) {\n        return 'array';\n      }\n\n      // date\n      if (val instanceof Date) {\n        return 'date';\n      }\n\n      // object\n      return 'object';\n  }\n};\n\n/**\n * Returns a reformatted Object valid for consumption as remoting function\n * arguments\n */\n\nSharedMethod.convertArg = function (accept, raw) {\n  const isComputedArgument =\n    accept.http &&\n    (typeof accept.http === 'function' ||\n      accept.http.source === 'req' ||\n      accept.http.source === 'res' ||\n      accept.http.source === 'context');\n\n  if (isComputedArgument) {\n    return raw;\n  }\n\n  if (raw === null || typeof raw !== 'object') {\n    return raw;\n  }\n  if (typeof raw === 'object' && raw.constructor !== Object && raw.constructor !== Array) {\n    // raw is not plain\n    return raw;\n  }\n\n  return convertSpecialObjects(raw);\n};\n\nfunction convertSpecialObjects(value) {\n  if (value === null || typeof value !== 'object') {\n    return value;\n  }\n\n  if (Array.isArray(value)) {\n    const result = new Array(value.length);\n    for (let i = 0; i < value.length; i++) {\n      result[i] = convertSpecialObjects(value[i]);\n    }\n    return result;\n  }\n\n  if (value.constructor !== Object) {\n    return value;\n  }\n\n  if (value.$type === 'base64') {\n    return Buffer.from(value.$data, 'base64');\n  }\n\n  if (value.$type === 'date') {\n    return new Date(value.$data);\n  }\n\n  const result = {};\n  for (const key in value) {\n    result[key] = convertSpecialObjects(value[key]);\n  }\n\n  return result;\n}\n\n/**\n * Returns a reformatted Object valid for consumption as JSON from an Array of\n * results from a remoting function, based on `returns`.\n */\n\nSharedMethod.toResult = function (returns, raw, ctx) {\n  if (!returns.length) {\n    return;\n  }\n\n  let result = {};\n  const rawLength = raw.length;\n\n  for (let index = 0; index < returns.length && index < rawLength; index++) {\n    const item = returns[index];\n    const name = item.name || item.arg;\n    const value = raw[index];\n\n    if (ctx && ctx.setReturnArgByName(name, value)) {\n      continue;\n    }\n\n    const targetType = convertToBasicRemotingType(item.type);\n    if (item.root) {\n      const isFile = targetType === 'file';\n      result = isFile ? value : convert(value, targetType, item.name);\n      continue;\n    }\n\n    if (targetType === 'file') {\n      g.warn('%s: discarded non-root return argument %s of type \"{{file}}\"', this.stringName, name);\n      continue;\n    }\n\n    result[name] = convert(value, targetType, name);\n  }\n\n  return result;\n\n  function convert(val, targetType, argName) {\n    const targetTypeIsIntegerArray =\n      Array.isArray(targetType) && targetType.length === 1 && targetType[0] === 'integer';\n\n    if (targetTypeIsIntegerArray && Array.isArray(val)) {\n      const arrayTargetType = targetType[0];\n      return val.map(function (intVal) {\n        return convert(intVal, arrayTargetType, argName);\n      });\n    }\n\n    const actualType = SharedMethod.getType(val, targetType);\n\n    switch (actualType) {\n      case 'date':\n        return {\n          $type: 'date',\n          $data: val.toJSON ? val.toJSON() : val.toString(),\n        };\n      case 'buffer':\n        return {\n          $type: 'base64',\n          $data: val.toString('base64'),\n        };\n      default:\n        if (targetType === 'integer') {\n          let message;\n\n          if (!isInteger(val)) {\n            message = g.f(\n              \"Invalid return value for argument '%s' of type \" + \"'%s': %s. Received type was %s.\",\n              argName,\n              targetType,\n              val,\n              typeof val,\n            );\n            throw internalServerError(message);\n          }\n\n          if (!isSafeInteger(val)) {\n            message = g.f(\n              \"Unsafe integer value returned for argument '%s' of type \" + \"'%s': %s.\",\n              argName,\n              targetType,\n              val,\n            );\n            throw internalServerError(message);\n          }\n          return val;\n        }\n        return val;\n    }\n  }\n};\n\n/**\n * Get the function the `SharedMethod` will `invoke()`.\n */\n\nSharedMethod.prototype.getFunction = function () {\n  let fn;\n\n  if (!this.ctor) return this.fn;\n\n  if (this.isStatic) {\n    fn = this.ctor[this.name];\n  } else {\n    fn = this.ctor.prototype[this.name];\n  }\n\n  return fn || this.fn;\n};\n\n/**\n * Determine if this shared method invokes the given \"suspect\" function.\n *\n * @example\n * ```js\n * sharedMethod.isDelegateFor(myClass.myMethod); // pass a function\n * sharedMethod.isDelegateFor(myClass.prototype.myInstMethod);\n * sharedMethod.isDelegateFor('myMethod', true); // check for a static method by name\n * sharedMethod.isDelegateFor('myInstMethod', false); // instance method by name\n * ```\n *\n * @param {String|Function} suspect The name of the suspected function\n * or a `Function`.\n * @returns Boolean True if the shared method invokes the given function; false otherwise.\n */\n\nSharedMethod.prototype.isDelegateFor = function (suspect, isStatic) {\n  const type = typeof suspect;\n  isStatic = isStatic || false;\n\n  if (suspect) {\n    switch (type) {\n      case 'function':\n        return this.getFunction() === suspect;\n      case 'string':\n        if (this.isStatic !== isStatic) return false;\n        return this.name === suspect || this.aliases.indexOf(suspect) !== -1;\n    }\n  }\n\n  return false;\n};\n\n/**\n * Determine if this shared method invokes the given \"suspect\" function.\n *\n * @example\n * ```js\n * sharedMethod.isDelegateForName('myMethod'); // check for a static method by name\n * sharedMethod.isDelegateForName('prototype.myInstMethod'); // instance method by name\n * ```\n *\n * @returns Boolean True if the shared method invokes the given function; false otherwise.\n */\n\nSharedMethod.prototype.isDelegateForName = function (suspect) {\n  assert(typeof suspect === 'string', 'argument of isDelegateForName should be string');\n\n  const m = suspect.match(/^prototype\\.(.*)$/);\n  const isStatic = !m;\n  const baseName = isStatic ? suspect : m[1];\n  return this.isDelegateFor(baseName, isStatic);\n};\n\n/**\n * Add an alias\n *\n * @param {String} alias Alias method name.\n */\n\nSharedMethod.prototype.addAlias = function (alias) {\n  if (this.aliases.indexOf(alias) === -1) {\n    this.aliases.push(alias);\n  }\n};\n\n/**\n * build conversion options from remote's' args\n *\n * @param {Object} arg Definition of accepts/returns argument.\n * @returns {Object} Options object to pass to type-converter methods,  e.g `validate` or `fromTypedValue`.\n */\nSharedMethod.getConversionOptionsForArg = function (arg) {\n  const options = {};\n\n  // option for object coercion to allow Array of objects as well as objects\n  if (arg.allowArray) {\n    options.allowArray = arg.allowArray;\n  }\n  return options;\n};\n"],"mappings":"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"}

package/dist/lib/socket-io-adapter.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/lib/socket-io-adapter.js

@@ -0,0 +1,93 @@
+"use strict";
+const require_lib_messages = require("./messages.js");
+const require_lib_socket_io_context = require("./socket-io-context.js");
+//#region src/lib/socket-io-adapter.ts
+const g = require_lib_messages;
+/**
+* Expose `SocketIOAdapter`.
+*/
+module.exports = SocketIOAdapter;
+/**
+* Module dependencies.
+*/
+const EventEmitter = require("events").EventEmitter;
+const inherits = require("util").inherits;
+const { Server } = require("socket.io");
+const SocketIOContext = require_lib_socket_io_context;
+/**
+* Create a new `RestAdapter` with the given `options`.
+*
+* @param {Object} options
+* @return {RestAdapter}
+*/
+function SocketIOAdapter(remotes, server) {
+	EventEmitter.apply(this, arguments);
+	this.remotes = remotes;
+	this.server = server;
+	this.Context = SocketIOContext;
+}
+/**
+* Inherit from `EventEmitter`.
+*/
+inherits(SocketIOAdapter, EventEmitter);
+/*!
+* Simplified APIs
+*/
+SocketIOAdapter.create = function(remotes) {
+	return new SocketIOAdapter(remotes);
+};
+SocketIOAdapter.prototype.createHandler = function() {
+	const adapter = this;
+	const remotes = this.remotes;
+	const Context = this.Context;
+	this.remotes.classes();
+	new Server(this.server).on("connection", function(socket) {
+		socket.on("invoke", function(methodString, ctorArgs, args, id) {
+			const method = remotes.findMethod(methodString);
+			if (method) {
+				const ctx = new Context(socket.request, ctorArgs, args);
+				adapter.invoke(ctx, method, args, function(err, result) {
+					socket.emit("result", {
+						data: result,
+						id,
+						methodString,
+						__types__: method.returns
+					});
+				});
+			} else socket.emit("result", {
+				err: g.f("method does not exist"),
+				id,
+				methodString
+			});
+		});
+	});
+};
+SocketIOAdapter.prototype.invoke = function(ctx, method, args, callback) {
+	const remotes = this.remotes;
+	if (method.isStatic) remotes.execHooks("before", method, method.ctor, ctx, function(err) {
+		if (err) return callback(err);
+		ctx.invoke(method.ctor, method, function(err, result) {
+			if (err) return callback(err);
+			ctx.result = result;
+			remotes.execHooks("after", method, method.ctor, ctx, function(err) {
+				callback(err, ctx.result);
+			});
+		});
+	});
+	else ctx.invoke(method, method.sharedCtor, function(err, inst) {
+		if (err) return callback(err);
+		remotes.execHooks("before", method, inst, ctx, function(err) {
+			if (err) callback(err);
+			else ctx.invoke(inst, method, function(err, result) {
+				if (err) return callback(err);
+				ctx.result = result;
+				remotes.execHooks("after", method, inst, ctx, function(err) {
+					callback(err, ctx.result);
+				});
+			});
+		});
+	});
+};
+//#endregion
+
+//# sourceMappingURL=socket-io-adapter.js.map

package/dist/lib/socket-io-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-io-adapter.js","names":[],"sources":["../../src/lib/socket-io-adapter.ts"],"sourcesContent":["// Copyright IBM Corp. 2013,2017. All Rights Reserved.\n// Node module: strong-remoting\n// This file is licensed under the Artistic License 2.0.\n// License text available at https://opensource.org/licenses/Artistic-2.0\n\n// @ts-nocheck\n'use strict';\n\nconst g = require('./messages');\n/**\n * Expose `SocketIOAdapter`.\n */\nmodule.exports = SocketIOAdapter;\n\n/**\n * Module dependencies.\n */\n\nconst EventEmitter = require('events').EventEmitter;\nconst util = require('util');\nconst inherits = util.inherits;\nconst { Server } = require('socket.io');\nconst SocketIOContext = require('./socket-io-context');\n\n/**\n * Create a new `RestAdapter` with the given `options`.\n *\n * @param {Object} options\n * @return {RestAdapter}\n */\n\nfunction SocketIOAdapter(remotes, server) {\n  EventEmitter.apply(this, arguments);\n\n  // throw an error if args are not supplied\n  // assert(typeof options === 'object',\n  //   'RestAdapter requires an options object');\n\n  this.remotes = remotes;\n  this.server = server;\n  this.Context = SocketIOContext;\n}\n\n/**\n * Inherit from `EventEmitter`.\n */\n\ninherits(SocketIOAdapter, EventEmitter);\n\n/*!\n * Simplified APIs\n */\n\nSocketIOAdapter.create = function (remotes) {\n  // add simplified construction / sugar here\n  return new SocketIOAdapter(remotes);\n};\n\nSocketIOAdapter.prototype.createHandler = function () {\n  const adapter = this;\n  const remotes = this.remotes;\n  const Context = this.Context;\n  const classes = this.remotes.classes();\n  const io = new Server(this.server);\n\n  io.on('connection', function (socket) {\n    socket.on('invoke', function (methodString, ctorArgs, args, id) {\n      const method = remotes.findMethod(methodString);\n\n      if (method) {\n        // create context NEED ARGS\n        const ctx = new Context(socket.request, ctorArgs, args);\n\n        adapter.invoke(ctx, method, args, function (err, result) {\n          socket.emit('result', {\n            data: result,\n            id: id,\n            methodString: methodString,\n            __types__: method.returns,\n          });\n        });\n      } else {\n        socket.emit('result', {\n          err: g.f('method does not exist'),\n          id: id,\n          methodString: methodString,\n        });\n      }\n    });\n  });\n};\n\nSocketIOAdapter.prototype.invoke = function (ctx, method, args, callback) {\n  const remotes = this.remotes;\n\n  if (method.isStatic) {\n    remotes.execHooks('before', method, method.ctor, ctx, function (err) {\n      if (err) return callback(err);\n\n      // invoke the static method on the actual constructor\n      ctx.invoke(method.ctor, method, function (err, result) {\n        if (err) return callback(err);\n        ctx.result = result;\n        remotes.execHooks('after', method, method.ctor, ctx, function (err) {\n          // send the result\n          callback(err, ctx.result);\n        });\n      });\n    });\n  } else {\n    // invoke the shared constructor to get an instance\n    ctx.invoke(method, method.sharedCtor, function (err, inst) {\n      if (err) return callback(err);\n      remotes.execHooks('before', method, inst, ctx, function (err) {\n        if (err) {\n          callback(err);\n        } else {\n          // invoke the instance method\n          ctx.invoke(inst, method, function (err, result) {\n            if (err) return callback(err);\n\n            ctx.result = result;\n            remotes.execHooks('after', method, inst, ctx, function (err) {\n              // send the result\n              callback(err, ctx.result);\n            });\n          });\n        }\n      });\n    });\n  }\n};\n"],"mappings":";;;;AAQA,MAAM,IAAA;;;;AAIN,OAAO,UAAU;;;;AAMjB,MAAM,eAAe,QAAQ,SAAS,CAAC;AAEvC,MAAM,WADO,QAAQ,OAAO,CACN;AACtB,MAAM,EAAE,WAAW,QAAQ,YAAY;AACvC,MAAM,kBAAA;;;;;;;AASN,SAAS,gBAAgB,SAAS,QAAQ;AACxC,cAAa,MAAM,MAAM,UAAU;AAMnC,MAAK,UAAU;AACf,MAAK,SAAS;AACd,MAAK,UAAU;;;;;AAOjB,SAAS,iBAAiB,aAAa;;;;AAMvC,gBAAgB,SAAS,SAAU,SAAS;AAE1C,QAAO,IAAI,gBAAgB,QAAQ;;AAGrC,gBAAgB,UAAU,gBAAgB,WAAY;CACpD,MAAM,UAAU;CAChB,MAAM,UAAU,KAAK;CACrB,MAAM,UAAU,KAAK;AACL,MAAK,QAAQ,SAAS;AAC3B,KAAI,OAAO,KAAK,OAAO,CAE/B,GAAG,cAAc,SAAU,QAAQ;AACpC,SAAO,GAAG,UAAU,SAAU,cAAc,UAAU,MAAM,IAAI;GAC9D,MAAM,SAAS,QAAQ,WAAW,aAAa;AAE/C,OAAI,QAAQ;IAEV,MAAM,MAAM,IAAI,QAAQ,OAAO,SAAS,UAAU,KAAK;AAEvD,YAAQ,OAAO,KAAK,QAAQ,MAAM,SAAU,KAAK,QAAQ;AACvD,YAAO,KAAK,UAAU;MACpB,MAAM;MACF;MACU;MACd,WAAW,OAAO;MACnB,CAAC;MACF;SAEF,QAAO,KAAK,UAAU;IACpB,KAAK,EAAE,EAAE,wBAAwB;IAC7B;IACU;IACf,CAAC;IAEJ;GACF;;AAGJ,gBAAgB,UAAU,SAAS,SAAU,KAAK,QAAQ,MAAM,UAAU;CACxE,MAAM,UAAU,KAAK;AAErB,KAAI,OAAO,SACT,SAAQ,UAAU,UAAU,QAAQ,OAAO,MAAM,KAAK,SAAU,KAAK;AACnE,MAAI,IAAK,QAAO,SAAS,IAAI;AAG7B,MAAI,OAAO,OAAO,MAAM,QAAQ,SAAU,KAAK,QAAQ;AACrD,OAAI,IAAK,QAAO,SAAS,IAAI;AAC7B,OAAI,SAAS;AACb,WAAQ,UAAU,SAAS,QAAQ,OAAO,MAAM,KAAK,SAAU,KAAK;AAElE,aAAS,KAAK,IAAI,OAAO;KACzB;IACF;GACF;KAGF,KAAI,OAAO,QAAQ,OAAO,YAAY,SAAU,KAAK,MAAM;AACzD,MAAI,IAAK,QAAO,SAAS,IAAI;AAC7B,UAAQ,UAAU,UAAU,QAAQ,MAAM,KAAK,SAAU,KAAK;AAC5D,OAAI,IACF,UAAS,IAAI;OAGb,KAAI,OAAO,MAAM,QAAQ,SAAU,KAAK,QAAQ;AAC9C,QAAI,IAAK,QAAO,SAAS,IAAI;AAE7B,QAAI,SAAS;AACb,YAAQ,UAAU,SAAS,QAAQ,MAAM,KAAK,SAAU,KAAK;AAE3D,cAAS,KAAK,IAAI,OAAO;MACzB;KACF;IAEJ;GACF"}

package/dist/lib/socket-io-context.d.ts

@@ -0,0 +1 @@
+export { };